Interface TraceWriter

Sink for structured trace events emitted by the agent runtime

Implementations receive every TraceEvent produced during agent execution. The runtime reads the active writer from the Trace Effection context (set by initAgents).

All methods must be synchronous and must not throw — tracing is best-effort and must never disrupt agent execution.

interface TraceWriter {
    flush(): void;
    nextId(): number;
    write(event: TraceEvent): void;
}

Implemented by

JsonlTraceWriter
NullTraceWriter

Index

Methods

flush nextId write

Methods

flush

flush(): void
Flush pending writes. Called at scope boundaries.

Returns void
- Defined in agents/src/trace-writer.ts:21

nextId

nextId(): number
Allocate a new trace ID. Monotonically increasing.

Returns number
- Defined in agents/src/trace-writer.ts:19

write

write(event: TraceEvent): void
Write a trace event. Must not throw.
Parameters
- event: TraceEvent
Returns void
- Defined in agents/src/trace-writer.ts:17

Interface TraceWriter

Implemented by

Index

Methods

Methods

flush

Returns void

nextId

Returns number

write

Parameters

Returns void

Settings

On This Page