Interface: UniversalStepTelemetry<TCustomMetrics, TAbortMeta>

Defined in: ports/universal-step-telemetry.ts:10

Universal step execution telemetry record passed to .replaceWith() mappers and persisted in LedgerStore.

Aggregates turn count, USD cost, wall-clock duration, domain-specific custom metrics from TelemetryCollectorASTNode, and optional abortMeta from AbortHookASTNode.

Type Parameters

Type Parameter	Default type	Description
TCustomMetrics extends Record<string, unknown>	Record<string, unknown>	Domain-specific custom telemetry metrics record shape.
TAbortMeta extends Record<string, unknown>	Record<string, unknown>	Optional abort hook metadata record shape.

Properties

Property	Modifier	Type	Description	Defined in
abortMeta?	readonly	TAbortMeta	Optional metadata returned by the step's AbortHookASTNode upon step replacement.	ports/universal-step-telemetry.ts:23
costUsd	readonly	number	Cumulative model invocation cost in USD for the step execution.	ports/universal-step-telemetry.ts:17
custom	readonly	TCustomMetrics	Domain-specific telemetry metrics collected from observedEffects.	ports/universal-step-telemetry.ts:21
durationMs	readonly	number	Cumulative elapsed execution duration in milliseconds.	ports/universal-step-telemetry.ts:19
turnsTaken	readonly	number	Cumulative number of LLM turns taken during the step execution.	ports/universal-step-telemetry.ts:15