AgentTelemetryEvent class final

One lifecycle record. Pure data — sinks format it however their backend wants (the io file sink writes fa.log lines, an in-memory ring keeps the objects, a host UI renders them live).

Constructors

AgentTelemetryEvent({required AgentTelemetryEventKind kind, required DateTime timestamp, required Duration sinceRunStart, String? toolCallId, String? toolName, bool? isError, String? stopReason, int? httpStatus, int? outputBytes, int? attempt, String? detail})
const

Properties

attempt → int?
The stuck-supervision attempt number (toolHeartbeat/toolStuck only).
final
detail → String?
Free-form detail: model id on requestStart/firstToken, the formatted provider error on error, the stuck action label on toolStuck.
final
hashCode → int
The hash code for this object.
no setterinherited
httpStatus → int?
The provider HTTP status of the FAILED request, on the error kind: typed ProviderHttpError when the harness has it, else parsed from the error formatter's own <status>: shape. Null on every other kind — success statuses are not observable through the event surface (a streamed token implies 2xx, but the code never crosses it), so runEnd carries the duration and stop outcome only.
final
isError → bool?
Whether the tool finished with an error result (toolEnd).
final
kind → AgentTelemetryEventKind
The phase that produced the record.
final
outputBytes → int?
The heartbeat's captured-output size in bytes (toolHeartbeat only).
final
runtimeType → Type
A representation of the runtime type of the object.
no setterinherited
sinceRunStart → Duration
Time since the current run started (zero for AgentTelemetryEventKind.runStart).
final
stopReason → String?
The assistant stop reason, for turnEnd (stop, toolUse, error, aborted, …).
final
timestamp → DateTime
Wall-clock time of the record.
final
toolCallId → String?
The tool call id, for the tool_* kinds.
final
toolName → String?
The tool name, for the tool_* kinds.
final

Methods

noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toString() → String
A string representation of this object.
override

Operators

operator ==(Object other) → bool
The equality operator.
inherited