From 6db12ff70acb3333d05a5020ab66da4172a5225a Mon Sep 17 00:00:00 2001 From: Adam Malczewski Date: Wed, 10 Jun 2026 08:29:59 +0900 Subject: feat(metrics): durable per-turn/step token+timing metrics (observability spans + persisted replay) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two-part token-data improvement: #2 Observability spans (kernel run-turn): turn & step span-close now stamp ALL four Usage fields — added usage.cacheReadTokens/cacheWriteTokens (were silently dropped) and normalized usage_* -> usage.* to match the provider.request span (consistent D9 GROUP BY). No contract change. #3 Persisted replay metrics (conversation-store + read endpoint): new StepMetrics/TurnMetrics wire types; conversation-store persists per-turn metrics in a separate key space (appendMetrics/loadMetrics, turn-append order); session-orchestrator accumulates per-step+turn metrics from the event stream (pure metrics.ts) and persists after seal; transport-http serves GET /conversations/:id/metrics -> ConversationMetricsResponse. Contracts: @dispatch/wire + @dispatch/transport-contract bumped 0.3.0->0.4.0 (additive). GLOSSARY: turn metrics / step metrics. typecheck EXIT 0, biome clean, 546 vitest + 89 bun = 635 tests. --- packages/kernel/src/contracts/conversation.ts | 2 ++ packages/kernel/src/contracts/index.ts | 2 ++ 2 files changed, 4 insertions(+) (limited to 'packages/kernel/src/contracts') diff --git a/packages/kernel/src/contracts/conversation.ts b/packages/kernel/src/contracts/conversation.ts index 0080964..f4a342d 100644 --- a/packages/kernel/src/contracts/conversation.ts +++ b/packages/kernel/src/contracts/conversation.ts @@ -11,6 +11,7 @@ export type { ErrorChunk, Role, StepId, + StepMetrics, StoredChunk, SystemChunk, TextChunk, @@ -18,4 +19,5 @@ export type { ToolCallChunk, ToolResultChunk, TurnId, + TurnMetrics, } from "@dispatch/wire"; diff --git a/packages/kernel/src/contracts/index.ts b/packages/kernel/src/contracts/index.ts index 38f1442..b5802f3 100644 --- a/packages/kernel/src/contracts/index.ts +++ b/packages/kernel/src/contracts/index.ts @@ -18,6 +18,7 @@ export type { ErrorChunk, Role, StepId, + StepMetrics, StoredChunk, SystemChunk, TextChunk, @@ -25,6 +26,7 @@ export type { ToolCallChunk, ToolResultChunk, TurnId, + TurnMetrics, } from "./conversation.js"; export type { ToolDispatchPolicy } from "./dispatch.js"; export type { -- cgit v1.2.3