@threadcrumbs/common 0.1.3 → 0.1.4

package/lib/claude-transcript.mjs

@@ -10,6 +10,7 @@ import {
   clipBlock,
   diffHunk,
   emptyActivity,
+  emptySample,
   endCall,
   fileList,
   firstChange,
@@ -20,6 +21,7 @@ import {
   openTool,
   patchLines,
   planItems,
+  samplePoint,
   settleCalls,
   startCall,
   textList,
@@ -176,6 +178,7 @@ function emptyState(sidechain, detail, words, sizes) {
     cost: null,
     plan: null,
     prompts: 0,
+    contextSample: emptySample(),
     uuids: new Set(),
   }
 }
@@ -440,6 +443,7 @@ function applyAssistant(state, record, at) {
     for (const key of Object.keys(next)) state.tokens[key] += next[key] - (previous?.[key] || 0)
     state.usageById.set(message.id, next)
     state.context = next.input + next.cacheRead + next.cacheWrite + next.output
+    samplePoint(state.contextSample, state.context, { update: Boolean(previous) })
     const cost = requestCost(message.model, usage)
     let added = null
     if (cost != null) {

package/lib/opencode-store.mjs

@@ -10,6 +10,7 @@ import {
   clip,
   clipBlock,
   emptyActivity,
+  emptySample,
   endCall,
   fileList,
   joinedText,
@@ -19,6 +20,8 @@ import {
   openTool,
   planItems,
   planSummary,
+  sampleList,
+  samplePoint,
   settleCalls,
   startCall,
   text,
@@ -458,6 +461,7 @@ function session(context, row, turn, extra) {
     tool: turn.open && turn.tool ? toolNow(turn.tool) : null,
     tokens: turn.tokens ? { ...turn.tokens } : null,
     context: turn.context ? { used: turn.context, limit: context.byModel.get(`${turn.provider}/${turn.model}`) || 0 } : null,
+    contextHistory: sampleList(turn.contextSample, turn.context),
     costUsd: turn.cost,
     lines: extra.lines,
     plan: planSummary(extra.plan),
@@ -504,7 +508,7 @@ function legacySessions(db, tables, context) {
 }
 
 function legacyTurn(db, row, context) {
-  const turn = { busy: false, failed: false, prompts: 0, firstPrompt: '', model: '', provider: '', effort: '', tokens: null, cost: null, context: 0, lines: null, tool: null, turnStartedAt: 0 }
+  const turn = { busy: false, failed: false, prompts: 0, firstPrompt: '', model: '', provider: '', effort: '', tokens: null, cost: null, context: 0, contextSample: emptySample(), lines: null, tool: null, turnStartedAt: 0 }
   const typed = new Set(
     db
       .prepare(`SELECT message_id FROM part WHERE session_id = ? AND data LIKE '%"type":"text"%' AND data NOT LIKE '%"synthetic":true%'`)
@@ -537,7 +541,10 @@ function legacyTurn(db, row, context) {
     if (data.providerID) turn.provider = text(data.providerID)
     if (data.variant) turn.effort = text(data.variant)
     if (data.cost != null) turn.cost = (turn.cost || 0) + number(data.cost)
-    if (number(data.tokens?.output) > 0) turn.context = windowOf(data.tokens)
+    if (number(data.tokens?.output) > 0) {
+      turn.context = windowOf(data.tokens)
+      samplePoint(turn.contextSample, turn.context)
+    }
   }
   const usage = usageFromColumns(row)
   if (usage) {
@@ -605,8 +612,28 @@ function currentSessions(db, tables, context) {
   return out
 }
 
+function currentSample(db, sessionId, before) {
+  let { contextSample: sample, contextSeq: seq = -1, contextCount: count = 0 } = before || {}
+  const kept = sample && db.prepare(`SELECT COUNT(*) AS n, MAX(seq) AS top FROM session_message WHERE session_id = ? AND type = 'assistant' AND seq <= ?`).get(sessionId, seq)
+  if (!kept || number(kept.n) !== count || (count && number(kept.top) !== seq)) {
+    sample = emptySample()
+    seq = -1
+    count = 0
+  }
+  const newer = db.prepare(`SELECT seq, data FROM session_message WHERE session_id = ? AND type = 'assistant' AND seq > ? ORDER BY seq`).all(sessionId, seq)
+  for (const [i, message] of newer.entries()) {
+    const data = parse(message.data)
+    if (i === newer.length - 1 && !data.time?.completed) break
+    if (number(data.tokens?.output) > 0) samplePoint(sample, windowOf(data.tokens))
+    seq = number(message.seq)
+    count++
+  }
+  return { contextSample: sample, contextSeq: seq, contextCount: count }
+}
+
 function currentTurn(db, row, parts, context) {
-  const turn = { busy: false, failed: false, prompts: 0, firstPrompt: '', model: '', provider: '', effort: '', tokens: null, cost: null, context: 0, tool: null, plan: null, turnStartedAt: 0 }
+  const before = context.facts.get(`v2:${row.id}`)?.value
+  const turn = { busy: false, failed: false, prompts: 0, firstPrompt: '', model: '', provider: '', effort: '', tokens: null, cost: null, context: 0, tool: null, plan: null, turnStartedAt: 0, ...currentSample(db, row.id, before) }
   turn.prompts = number(db.prepare(`SELECT COUNT(*) AS n FROM session_message WHERE session_id = ? AND type = 'user'`).get(row.id)?.n)
   const lastUser = db.prepare(`SELECT time_created FROM session_message WHERE session_id = ? AND type = 'user' ORDER BY seq DESC LIMIT 1`).get(row.id)
   turn.turnStartedAt = number(row.time_busy) || number(lastUser?.time_created)

package/lib/telemetry-fields.mjs

@@ -316,3 +316,37 @@ export function nextPlan(plan, tool, input) {
   }
   return next
 }
+
+export const CONTEXT_POINTS = 24
+
+export const emptySample = () => ({ stride: 1, seen: 0, points: [], newest: null, newestKept: false })
+
+export function samplePoint(sample, value, { update = false } = {}) {
+  const point = Math.round(number(value))
+  if (point <= 0) return
+  if (update && sample.newest != null) {
+    if (sample.newestKept) sample.points[sample.points.length - 1] = point
+    sample.newest = point
+    return
+  }
+  sample.newestKept = sample.seen % sample.stride === 0
+  if (sample.newestKept) {
+    sample.points.push(point)
+    if (sample.points.length >= CONTEXT_POINTS * 2) {
+      sample.points = sample.points.filter((_, i) => i % 2 === 0)
+      sample.stride *= 2
+      sample.newestKept = false
+    }
+  }
+  sample.seen++
+  sample.newest = point
+}
+
+export function sampleList(sample, current) {
+  if (!sample || !(current > 0)) return null
+  const now = Math.round(current)
+  const older = sample.newestKept && sample.newest === now ? sample.points.slice(0, -1) : sample.points
+  const room = CONTEXT_POINTS - 1
+  const picked = older.length <= room ? older : Array.from({ length: room }, (_, i) => older[Math.round((i * (older.length - 1)) / (room - 1))])
+  return [...picked, now]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@threadcrumbs/common",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "type": "module",
   "description": "Code the Threadcrumbs apps share, starting with the readers for each coding-agent harness.",
   "license": "SEE LICENSE IN LICENSE.md",

package/telemetry/README.md

@@ -59,6 +59,7 @@ adapter in `../harnesses/`, so a session has the same id in both apps. Add the h
 | `tool` | `{ name, startedAt, target, kind }` or `null` | The tool running right now, only while working or delegating. `target` is its short file path, command, or search, as in `Detail.activity`, or `''` when the harness doesn't record one. `kind` is one of the [tool kinds](#tool-kinds) |
 | `tokens` | `{ input, output, cacheRead, cacheWrite }` or `null` | Totals for the session's own thread. `input` leaves out cache reads and writes |
 | `context` | `{ used, limit }` or `null` | Tokens in the window after the last reply; `limit` is `0` when unknown |
+| `contextHistory` | number[] or `null` | The context after each reply, oldest first, for a sparkline: at most 24 whole numbers, evenly spaced across the session and always ending at `context.used`. A reply written twice counts once. Each reader keeps a running sample as it reads, never the whole history; OpenCode 2.x reads only the replies newer than the last one it saw, once the session changes, leaves the newest for the next read while it has no `time.completed`, and starts over if replies were removed. `null` for Cursor, Antigravity, and Hermes, whose session scan sees no per-reply counts, and before the first reply |
 | `costUsd` | number or `null` | Spend as the harness records it; `null` when it doesn't |
 | `lines` | `{ added, removed }` or `null` | Lines changed, as the harness records it |
 | `plan` | `{ total, done, current }` or `null` | Plan progress, if the agent keeps one |

package/telemetry/antigravity.mjs

@@ -233,6 +233,7 @@ export function antigravity({
         tool: null,
         tokens: null,
         context: null,
+        contextHistory: null,
         costUsd: null,
         lines: null,
         plan: planSummary(plan),

package/telemetry/claude-code.mjs

@@ -6,7 +6,7 @@ import { awaitedPeers, readLiveSessions, transcriptDetail, transcriptReader, tur
 import { exists, listDirs, listFiles, num } from '../lib/fsutil.mjs'
 import { contextBreakdown } from '../lib/context-breakdown.mjs'
 import { recentReaders } from '../lib/jsonl-follower.mjs'
-import { DETAIL_LIMITS, RECENT_MS, askOf, number, planSummary, text, titleFromPrompt, toolNow } from '../lib/telemetry-fields.mjs'
+import { DETAIL_LIMITS, RECENT_MS, askOf, number, planSummary, sampleList, text, titleFromPrompt, toolNow } from '../lib/telemetry-fields.mjs'
 
 export { nextPlan } from '../lib/telemetry-fields.mjs'
 
@@ -388,6 +388,7 @@ function toSession({ id, state, stat, running, subagents, workingSubagents, awai
     tool: status === 'working' || status === 'delegating' ? currentTool(state.open) : null,
     tokens: { ...state.tokens },
     context: state.context ? { used: state.context, limit } : null,
+    contextHistory: sampleList(state.contextSample, state.context),
     costUsd: state.unpriced || totals.unpriced ? (state.cost ? state.cost.usd : null) : state.spend + totals.spend,
     lines: { added: state.lines.added + totals.added, removed: state.lines.removed + totals.removed },
     plan: planSummary(state.plan),

package/telemetry/codex.mjs

@@ -16,6 +16,7 @@ import {
   clipBlock,
   diffHunk,
   emptyActivity,
+  emptySample,
   endCall,
   fileList,
   inputKind,
@@ -27,6 +28,8 @@ import {
   planItems,
   planSummary,
   relativePath,
+  sampleList,
+  samplePoint,
   settleCalls,
   startCall,
   text,
@@ -147,6 +150,7 @@ function emptyRollout() {
     lines: { added: 0, removed: 0 },
     tokens: null,
     context: null,
+    contextSample: emptySample(),
     plan: null,
     history: [],
     contextParts: null,
@@ -451,6 +455,7 @@ function applyTokens(state, info, at) {
   const sum = number(total?.total_tokens)
   if (sum === state.lastTotal) return
   state.lastTotal = sum
+  samplePoint(state.contextSample, last.total_tokens)
   keepNewest(state.history, { at, context: number(last.total_tokens), output: number(last.output_tokens) }, DETAIL_LIMITS.history)
 }
 
@@ -668,6 +673,7 @@ function toSession({ id, state, names, live, turnLive, fresh, locking, unread, s
     tool,
     tokens: state.tokens ? { ...state.tokens } : null,
     context: state.context && state.context.used ? { ...state.context } : null,
+    contextHistory: sampleList(state.contextSample, state.context?.used),
     costUsd: null,
     lines: { ...state.lines },
     plan: planSummary(state.plan),

package/telemetry/cursor.mjs

@@ -273,6 +273,7 @@ export function cursor({
         tool: open && state.tool ? { ...toolNow(state.tool), target: clip(relativePath(state.tool.target, projectPath)) } : null,
         tokens: null,
         context: null,
+        contextHistory: null,
         costUsd: null,
         lines: null,
         plan: planSummary(state.plan),

package/telemetry/hermes.mjs

@@ -423,6 +423,7 @@ function toSession({ db, profile, tip, root, chain, ids, open, errands, workingS
       ? { input: tokens[0] || 0, output: tokens[1] || 0, cacheRead: tokens[2] || 0, cacheWrite: tokens[3] || 0 }
       : null,
     context: used ? { used, limit: contextLimit(lengths, text(tip.model), tip.billing_base_url) } : null,
+    contextHistory: null,
     costUsd: costs.some((c) => c != null) ? costs.reduce((total, c) => total + number(c), 0) : null,
     lines: null,
     plan: planSummary(latestPlan(db, ids, messages)),