AgentRunTelemetryStore class

A durable ledger of agent runs.

Records run-level facts only — identity, origin, status, timing, and model-call count. Token totals come from usage_records, joined on the run id that AgentRunScope stamps onto each usage row.

Constructors

AgentRunTelemetryStore(RecordStore _records)
Creates an AgentRunTelemetryStore over records.

Properties

hashCode int
The hash code for this object.
no setterinherited
runtimeType Type
A representation of the runtime type of the object.
no setterinherited

Methods

begin({required String agentId, required String agentName, required AgentRunOrigin origin, String? modelId, String? modelName, String? sourceId, String? sourceName, String? conversationId, String? taskId}) Future<AgentRunHandle>
Starts a run and returns a handle for finishing it.
list({DateTime? since, String? agentId, int? limit}) Future<List<AgentRunRecord>>
Loads runs, newest first.
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
recoverInterrupted() Future<int>
Rewrites rows left running by a previous launch as interrupted.
toString() String
A string representation of this object.
inherited
trimBefore(DateTime cutoff) Future<void>
Deletes runs that started before cutoff.
watch() Stream<List<AgentRunRecord>>
Watches every run, newest first.

Operators

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

Static Methods

newRunId() String
Generates a time-ordered, collision-resistant run id.