oc-metricboard 0.1.6 → 0.1.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-metricboard",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "OpenCode TUI sidebar plugin showing real-time LLM metrics (TPS, TTFT, tokens) with sub-agent × model breakdown",
   "keywords": [
     "opencode",

package/src/assistant-progress.ts

@@ -4,6 +4,7 @@ import { currentRequest } from "./request-state"
 import { eventAggregateID, eventID, eventProperties, stringEventProperty } from "./event-bus"
 import type { EventHandlerContext } from "./collector-state"
 import { recordLiveTokens } from "./live-speed"
+import { ensureTurn, recordTurnFirstToken } from "./turn-state"
 
 export interface AssistantProgressPart {
   readonly partID: string
@@ -26,6 +27,7 @@ function applyTokenDelta(
   if (state.turns.get(sessionID)?.finalizedSteps.has(messageID)) return
   const current = currentRequest({ state, actions, sessionID, messageID, now })
   if (current.firstTokenTime === null) current.firstTokenTime = now
+  recordTurnFirstToken(ensureTurn(state.turns, sessionID, now), now)
   if (deltaTokens > 0) {
     current.estimatedOutputTokens += deltaTokens
     current.lastDeltaTime = now

package/src/collector.ts

@@ -546,7 +546,15 @@ export function createCollector(
 
       // NEW: Build per-model breakdown for tree scope
       const modelBreakdown = scope === "tree" ? aggregateByModel(ids, now, scope) : []
-      const ttft = foregroundRequest ? getTtft(foregroundRequest) : null
+      // Turn-level TTFT: opencode stamps step.started at the first token, so
+      // intra-turn steps cannot measure their own request start (they would
+      // collapse to ~0). Anchor TTFT to the turn's user message instead —
+      // stable across all steps within a turn, refreshed on each new turn.
+      // Falls back to the per-request measurement when no turn timing exists.
+      const turnTtft = foregroundTurn?.firstTokenTime != null
+        ? gateTtft(foregroundTurn.firstTokenTime - foregroundTurn.turnStartTime)
+        : null
+      const ttft = turnTtft ?? (foregroundRequest ? getTtft(foregroundRequest) : null)
 
       const result: MetricsAggregate = {
         sessionIDs: contributingSessionIDs.length > 0 ? contributingSessionIDs : [rootID],

package/src/session-hydration.ts

@@ -233,6 +233,11 @@ export async function hydrateSession(input: HydrateSessionInput): Promise<boolea
     input.now,
   ) ?? requestStartTime
   const turn = createTurnMetrics(input.sessionID, turnStartTime)
+  // Turn-level TTFT anchor: the first trailing assistant's createdTime is
+  // stamped at its first token, so turnStart → that instant is the hydrated
+  // turn's time-to-first-token. Fall back to the live request's first token.
+  turn.firstTokenTime = toPerformanceTime(trailingAssistants[0]?.createdTime, input.now)
+    ?? current.firstTokenTime
   for (const step of trailingAssistants) {
     if (!step.tokens || !hasPositiveAssistantTokens(step.tokens)) continue
     const stepStart = toPerformanceTime(step.createdTime, input.now) ?? turnStartTime

package/src/turn-state.ts

@@ -5,6 +5,7 @@ export function createTurnMetrics(sessionID: string, now: number): TurnMetrics {
   return {
     sessionID,
     turnStartTime: now,
+    firstTokenTime: null,
     completeTime: null,
     finalizedOutputTokens: 0,
     finalizedSteps: new Map(),
@@ -83,3 +84,13 @@ export function completeTurn(turn: TurnMetrics, now: number): void {
   turn.isComplete = true
   turn.completeTime = now
 }
+
+/**
+ * Record the turn's first token instant (once). opencode stamps step.started
+ * at the first token, so intra-turn steps cannot measure their own request
+ * start; the turn-level anchor (user message → first delta) is the only
+ * meaningful TTFT observable from the event stream.
+ */
+export function recordTurnFirstToken(turn: TurnMetrics, now: number): void {
+  if (turn.firstTokenTime === null) turn.firstTokenTime = now
+}

package/src/types.ts

@@ -37,6 +37,7 @@ export interface FinalizedStepUsage {
 export interface TurnMetrics {
   sessionID: string
   turnStartTime: number
+  firstTokenTime: number | null        // First token of the turn (user message → first delta)
   completeTime: number | null
   finalizedOutputTokens: number
   finalizedSteps: Map<string, FinalizedStepUsage>