oc-metricboard 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-metricboard",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "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

@@ -1,6 +1,6 @@
 import type { TuiPluginApi } from "@opencode-ai/plugin/tui"
 import type { BarConfig, CacheReadCompleteness, MetricsAggregate, MetricsScope, ModelMetrics, RequestMetrics } from "./types"
-import { getDisplayInputTokens, getDisplayOutputTokens, gateTtft, getTtft } from "./metrics"
+import { getDisplayInputTokens, getDisplayOutputTokens, getTtft } from "./metrics"
 import { registerEventHandlers } from "./event-handlers"
 import type { CollectorState } from "./collector-state"
 import type { MetricsEventApi } from "./event-bus"
@@ -352,7 +352,15 @@ export function createCollector(
 
       const cacheReadCompleteness: CacheReadCompleteness =
         exactCacheCount === 0 ? "unknown" : exactCacheCount === metrics.length ? "exact" : "partial"
-      const ttft = firstTokenTime === null ? null : gateTtft(firstTokenTime - requestStartTime)
+      // Model rows use the same turn-level TTFT as the main aggregate: the
+      // earliest gated turn TTFT across the group's sessions, falling back to
+      // per-request TTFT when no turn timing exists (e.g. sub-agent sessions
+      // whose turn start coincides with their first request).
+      let ttft: number | null = null
+      for (const m of metrics) {
+        const candidate = getTurnTtft(state.turns.get(m.sessionID), getTtft(m))
+        if (candidate !== null && (ttft === null || candidate < ttft)) ttft = candidate
+      }
 
       // Live TPS for this model group
       let liveTps = 0
@@ -546,7 +554,12 @@ 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 ttft = getTurnTtft(foregroundTurn, 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

@@ -1,10 +1,11 @@
-import { getDisplayInputTokens, getDisplayOutputTokens } from "./metrics"
+import { gateTtft, getDisplayInputTokens, getDisplayOutputTokens } from "./metrics"
 import type { RequestMetrics, TurnMetrics } from "./types"
 
 export function createTurnMetrics(sessionID: string, now: number): TurnMetrics {
   return {
     sessionID,
     turnStartTime: now,
+    firstTokenTime: null,
     completeTime: null,
     finalizedOutputTokens: 0,
     finalizedSteps: new Map(),
@@ -83,3 +84,27 @@ 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
+}
+
+/**
+ * Turn-level TTFT (user message → first token), gated. Falls back to the
+ * supplied per-request TTFT when the turn has no first-token timing. This is
+ * the ONLY meaningful TTFT observable from opencode's event stream for
+ * intra-turn steps, so every TTFT display path should prefer it.
+ */
+export function getTurnTtft(turn: TurnMetrics | undefined, fallback: number | null = null): number | null {
+  if (turn?.firstTokenTime != null) {
+    const gated = gateTtft(turn.firstTokenTime - turn.turnStartTime)
+    if (gated !== null) return gated
+  }
+  return fallback
+}

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>