parse-run.mjs 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464
  1. #!/usr/bin/env node
  2. // Parse Claude Code stream-json run log(s): tool-call sequence, token usage, and
  3. // RESIDUAL CONTEXT OCCUPANCY — how many tokens of the context window each tool
  4. // family's responses still occupy when the run ends.
  5. //
  6. // Usage: parse-run.mjs <run.jsonl> [run.t2.jsonl ...]
  7. // Multiple files = one multi-turn session's segments, IN ORDER (run-all.sh
  8. // writes run-<label>.jsonl, run-<label>.t2.jsonl, … for a `Q1||Q2||Q3` set).
  9. // `--resume` does not replay prior messages, so the segments concatenate
  10. // cleanly and token accounting carries across the boundary.
  11. //
  12. // ---------------------------------------------------------------------------
  13. // Why occupancy, and how it's measured
  14. // ---------------------------------------------------------------------------
  15. // A single-question A/B reports cost/tokens/time/tool-calls for ONE answer. It
  16. // cannot see what issue #1500 measured: a tool response stays in the window for
  17. // everything that follows, so it is charged against every later turn's headroom.
  18. // That is a per-session cost our single-question runs structurally miss.
  19. //
  20. // Tokens are MEASURED, not estimated at bytes/4. For assistant request k,
  21. // ctx_k = usage.input_tokens + cache_read_input_tokens + cache_creation_input_tokens
  22. // is the exact token count of that request's whole prompt. So
  23. // gap_k = ctx_k - ctx_{k-1}
  24. // is exactly the tokens appended since the previous request: the previous
  25. // assistant output (thinking + text + tool_use JSON) plus the tool_results and
  26. // user text that followed it. We split gap_k across those blocks in proportion
  27. // to their characters, which attributes each tool_result its measured share.
  28. // (Measured on real runs, explore output lands near 2.3 chars/token — bytes/4
  29. // under-counts it by ~40%, which is why the estimate isn't good enough.)
  30. //
  31. // Two traps this file works around, both verified against real logs:
  32. // * Claude Code emits ONE assistant event PER CONTENT BLOCK, all carrying the
  33. // same message.id and the same `usage`. Summing usage per event double-counts
  34. // every turn that emits both thinking and a tool_use — dedupe by message.id.
  35. // * The streamed `output_tokens` is a partial snapshot (observed `out=2` on a
  36. // turn that really generated ~1100). Never trust it; the char-proportional
  37. // split doesn't need it.
  38. //
  39. // Residual ≠ contributed. Content leaves the window two ways, and both are
  40. // tracked: a `compact_boundary` system event (everything prior is replaced by a
  41. // summary) and micro-compaction (ctx drops mid-run — oldest tool results are
  42. // dropped first, so eviction is applied FIFO).
  43. import { readFileSync } from 'fs';
  44. import { pathToFileURL } from 'url';
  45. // Nominal window for the share-of-window column. Override for a [1m] context.
  46. const WINDOW_TOKENS = Number(process.env.CG_WINDOW_TOKENS || 200_000);
  47. const CHARS_PER_TOKEN_FALLBACK = 3.0;
  48. /** Which tool family a tool_use belongs to. */
  49. function familyOf(name) {
  50. if (/codegraph/.test(name)) return 'codegraph';
  51. if (name === 'Read' || name === 'NotebookRead') return 'read';
  52. if (name === 'Grep' || name === 'Glob') return 'search';
  53. if (name === 'Bash' || name === 'BashOutput') return 'bash';
  54. return 'other';
  55. }
  56. const FAMILIES = ['codegraph', 'read', 'search', 'bash', 'other'];
  57. // The without-arm's way of getting the same bytes: reading and searching files.
  58. const FILE_ACCESS = ['read', 'search', 'bash'];
  59. const textOf = (content) =>
  60. Array.isArray(content) ? content.map((c) => c.text ?? (typeof c === 'string' ? c : JSON.stringify(c))).join('')
  61. : typeof content === 'string' ? content
  62. : content == null ? '' : JSON.stringify(content);
  63. /** Characters an assistant content block occupies once it is back in the prompt. */
  64. function assistantBlockChars(b) {
  65. if (b.type === 'text') return (b.text || '').length;
  66. if (b.type === 'thinking') return (b.thinking || '').length;
  67. if (b.type === 'tool_use') return JSON.stringify(b.input ?? {}).length + (b.name || '').length;
  68. return JSON.stringify(b).length;
  69. }
  70. /**
  71. * Parse one session (its segment files, in order) into tool + occupancy stats.
  72. * Exported so parse-bench-readme.mjs can aggregate without duplicating any of
  73. * this — deliberately NOT a separate module file: a new scripts/agent-eval/*.mjs
  74. * scores into the self-query eval fixture's own corpus and moves its numbers.
  75. */
  76. export function parseSession(files) {
  77. const events = [];
  78. for (const f of files) {
  79. for (const line of readFileSync(f, 'utf8').split('\n')) {
  80. if (!line) continue;
  81. try { events.push(JSON.parse(line)); } catch { /* partial line */ }
  82. }
  83. }
  84. const toolCalls = []; // display sequence
  85. const nameById = new Map(); // tool_use_id -> tool name
  86. const counts = {}; // tool name -> calls
  87. let initTools = null, result = null, raced = false;
  88. const results = []; // one `result` event per session segment (multi-turn)
  89. let compactions = 0;
  90. // A timeline of everything appended to the context, in order. `req` entries
  91. // are assistant requests (carrying that request's ctx); `add` entries are
  92. // characters appended (assistant output blocks, tool results, user text).
  93. const timeline = [];
  94. const seenMsgIds = new Set();
  95. for (const ev of events) {
  96. if (ev.type === 'system' && ev.subtype === 'init') {
  97. initTools = (ev.tools || []).filter((t) => /codegraph/.test(t));
  98. }
  99. if (ev.type === 'system' && (ev.subtype === 'compact_boundary' || ev.subtype === 'compaction')) {
  100. compactions++;
  101. timeline.push({ kind: 'compact' });
  102. }
  103. if (ev.type === 'assistant' && ev.message) {
  104. const id = ev.message.id;
  105. // One event per content block, same id + same usage: count usage once,
  106. // but take the content blocks from every event that carries the id.
  107. if (id && !seenMsgIds.has(id)) {
  108. seenMsgIds.add(id);
  109. const u = ev.message.usage || {};
  110. const ctx = (u.input_tokens || 0) + (u.cache_read_input_tokens || 0) + (u.cache_creation_input_tokens || 0);
  111. timeline.push({ kind: 'req', ctx, out: u.output_tokens || 0 });
  112. }
  113. for (const b of ev.message.content || []) {
  114. timeline.push({ kind: 'add', family: null, chars: assistantBlockChars(b) });
  115. if (b.type === 'tool_use') {
  116. nameById.set(b.id, b.name);
  117. counts[b.name] = (counts[b.name] || 0) + 1;
  118. let detail = '';
  119. if (b.name === 'Task') detail = ` [subagent_type=${b.input?.subagent_type ?? '?'}] ${(b.input?.description ?? '').slice(0, 40)}`;
  120. else if (/codegraph/.test(b.name)) detail = ` ${JSON.stringify(b.input?.query ?? b.input?.task ?? b.input?.symbol ?? '').slice(0, 60)}`;
  121. else if (b.name === 'Bash') detail = ` ${(b.input?.command ?? '').slice(0, 50)}`;
  122. else if (b.name === 'Read') detail = ` ${(b.input?.file_path ?? '').split('/').slice(-1)[0]}`;
  123. toolCalls.push(`${b.name}${detail}`);
  124. }
  125. }
  126. }
  127. if (ev.type === 'user' && ev.message) {
  128. const content = ev.message.content;
  129. if (Array.isArray(content)) {
  130. for (const b of content) {
  131. if (b.type === 'tool_result') {
  132. const t = textOf(b.content);
  133. // MCP cold-start race: the agent fired before `serve --mcp` had
  134. // registered its tools, so it floundered into grep/Read. That
  135. // measures startup latency, not steady-state value — flag it.
  136. if (/No such tool available/.test(t)) raced = true;
  137. const name = nameById.get(b.tool_use_id) || '';
  138. timeline.push({ kind: 'add', family: familyOf(name), chars: t.length, tool: name });
  139. } else {
  140. timeline.push({ kind: 'add', family: null, chars: textOf([b]).length });
  141. }
  142. }
  143. } else if (typeof content === 'string') {
  144. timeline.push({ kind: 'add', family: null, chars: content.length });
  145. }
  146. }
  147. if (ev.type === 'result') { result = ev; results.push(ev); }
  148. }
  149. // ---- Pass 1: chars/token, calibrated on tool-result-dominated gaps. ------
  150. // Splitting a gap in proportion to characters over-attributes to tool results
  151. // whenever the assistant's own output is under-represented in the transcript
  152. // (redacted/empty thinking blocks are the common case — a gap whose only
  153. // visible chars were a 73-char tool_result charged it the whole 830-token
  154. // delta, 5.5 tok/char). So calibrate the ratio on gaps that are ≥80% tool
  155. // result by characters, then price every result at that ratio.
  156. const reqIdx = timeline.map((t, i) => (t.kind === 'req' ? i : -1)).filter((i) => i >= 0);
  157. const gaps = [];
  158. for (let k = 1; k < reqIdx.length; k++) {
  159. const prev = timeline[reqIdx[k - 1]], cur = timeline[reqIdx[k]];
  160. let chars = 0, toolChars = 0, compacted = false;
  161. const byFamily = {};
  162. for (let i = reqIdx[k - 1] + 1; i < reqIdx[k]; i++) {
  163. const t = timeline[i];
  164. if (t.kind === 'compact') { compacted = true; continue; }
  165. if (t.kind !== 'add') continue;
  166. chars += t.chars;
  167. if (t.family) { toolChars += t.chars; byFamily[t.family] = (byFamily[t.family] || 0) + t.chars; }
  168. }
  169. gaps.push({ delta: cur.ctx - prev.ctx, chars, toolChars, byFamily, compacted });
  170. }
  171. const clean = gaps.filter((g) => !g.compacted && g.delta > 0 && g.chars > 500 && g.toolChars / g.chars >= 0.8);
  172. // A gap where the window also SHED content has a delta far below what was
  173. // added, which reads as absurdly dense text and would drag the whole run's
  174. // ratio with it. Shedding can only push a gap's chars/token UP, so take the
  175. // lower median as the honest centre and drop anything well above it, then
  176. // pool the survivors. (On runs that never shed, every ratio is within a few
  177. // percent of the others and this changes nothing.)
  178. const ratios = clean.map((g) => g.toolChars / g.delta).sort((a, b) => a - b);
  179. const lowerMedian = ratios.length ? ratios[Math.floor((ratios.length - 1) / 2)] : 0;
  180. let sumD = 0, sumC = 0;
  181. for (const g of clean) {
  182. if (lowerMedian > 0 && g.toolChars / g.delta > lowerMedian * 1.5) continue; // shed
  183. sumD += g.delta; sumC += g.toolChars;
  184. }
  185. if (sumD === 0) { // no clean gap — fall back to every growing gap, all chars
  186. for (const g of gaps) if (!g.compacted && g.delta > 0 && g.chars > 0) { sumD += g.delta; sumC += g.chars; }
  187. }
  188. const charsPerToken = sumD > 0 ? sumC / sumD : CHARS_PER_TOKEN_FALLBACK;
  189. const calibrated = sumD > 0;
  190. // How far a single result's token density strays from the run-level ratio.
  191. // On a gap that is almost entirely one tool result, `delta` IS that result's
  192. // token count, so |chars/ratio - delta| / delta is the attribution error for
  193. // that result. The median over such gaps is the metric's real error bar.
  194. const errs = [];
  195. for (const g of gaps) {
  196. if (g.compacted || g.delta <= 0 || g.chars <= 500) continue;
  197. if (g.toolChars / g.chars < 0.95) continue;
  198. errs.push(Math.abs(g.toolChars / charsPerToken - g.delta) / g.delta);
  199. }
  200. errs.sort((a, b) => a - b);
  201. const dispersion = errs.length ? errs[(errs.length - 1) >> 1] : null;
  202. // ---- Pass 2: attribute gap tokens, then apply evictions FIFO. ------------
  203. const contributed = Object.fromEntries(FAMILIES.map((f) => [f, 0]));
  204. const resultChars = Object.fromEntries(FAMILIES.map((f) => [f, 0]));
  205. const resultCount = Object.fromEntries(FAMILIES.map((f) => [f, 0]));
  206. for (const t of timeline) if (t.kind === 'add' && t.family) { resultChars[t.family] += t.chars; resultCount[t.family]++; }
  207. let queue = []; // resident contributions, oldest first
  208. let evicted = 0;
  209. const evict = (tokens) => {
  210. let left = tokens;
  211. while (left > 0 && queue.length) {
  212. const head = queue[0];
  213. if (head.tokens <= left) { left -= head.tokens; evicted += head.tokens; queue.shift(); }
  214. else { head.tokens -= left; evicted += left; left = 0; }
  215. }
  216. };
  217. for (const g of gaps) {
  218. if (g.compacted) {
  219. // Everything before the boundary is gone; the summary replaces it.
  220. evicted += queue.reduce((s, q) => s + q.tokens, 0);
  221. queue = [];
  222. }
  223. let toolTokens = 0;
  224. for (const [fam, ch] of Object.entries(g.byFamily)) {
  225. const tok = ch / charsPerToken;
  226. toolTokens += tok;
  227. contributed[fam] += tok;
  228. queue.push({ family: fam, tokens: tok });
  229. }
  230. // The gap grew by `delta`; the tool results account for `toolTokens` of it.
  231. // A shortfall means the window also shed content — micro-compaction drops
  232. // the OLDEST tool results first, so evict FIFO. The tolerance keeps
  233. // attribution noise (a run-level ratio priced against one gap's delta,
  234. // typically ±2%) from reading as an eviction; real shedding is thousands.
  235. const shortfall = toolTokens - g.delta;
  236. if (!g.compacted && shortfall > Math.max(200, toolTokens * 0.05)) evict(shortfall);
  237. }
  238. const residual = Object.fromEntries(FAMILIES.map((f) => [f, 0]));
  239. for (const q of queue) residual[q.family] += q.tokens;
  240. const ctxFinal = reqIdx.length ? timeline[reqIdx[reqIdx.length - 1]].ctx : 0;
  241. // The FIRST request's prompt is system + tool schemas + the question, before
  242. // any tool has answered. Differencing the arms' ctxBase prices codegraph's
  243. // FIXED occupancy — its tool schema and MCP `initialize` instructions — which
  244. // it pays whether or not the agent ever calls it.
  245. const ctxBase = reqIdx.length ? timeline[reqIdx[0]].ctx : 0;
  246. // Multi-turn: duration/cost/tokens are per-segment, so sum them. `result.usage`
  247. // is cumulative WITHIN a segment (verified: its in+cache+out equals the sum of
  248. // that segment's per-request prompts), so summing segments is correct and does
  249. // NOT double-count. It is a "tokens processed" figure — every request re-counts
  250. // the whole prefix — which is exactly why it can't answer the occupancy question.
  251. const sumUsage = (k) => results.reduce((s, r) => s + (r.usage?.[k] || 0), 0);
  252. const processed = sumUsage('input_tokens') + sumUsage('cache_read_input_tokens')
  253. + sumUsage('cache_creation_input_tokens') + sumUsage('output_tokens');
  254. return {
  255. files, toolCalls, counts, initTools, result, results, raced,
  256. ok: results.length > 0 && results.every((r) => r.subtype === 'success'),
  257. turns: reqIdx.length,
  258. tools: toolCalls.filter((t) => !t.startsWith('ToolSearch')).length,
  259. reads: counts.Read || 0,
  260. grep: (counts.Grep || 0) + (counts.Glob || 0),
  261. cg: Object.entries(counts).filter(([n]) => /codegraph/.test(n)).reduce((s, [, v]) => s + v, 0),
  262. dur: results.reduce((s, r) => s + (r.duration_ms || 0), 0) / 1000,
  263. cost: results.reduce((s, r) => s + (r.total_cost_usd || 0), 0),
  264. processed,
  265. occupancy: {
  266. ctxFinal, ctxBase, windowTokens: WINDOW_TOKENS,
  267. charsPerToken, calibrated, compactions, dispersion, evicted: Math.round(evicted),
  268. residual: Object.fromEntries(FAMILIES.map((f) => [f, Math.round(residual[f])])),
  269. contributed: Object.fromEntries(FAMILIES.map((f) => [f, Math.round(contributed[f])])),
  270. chars: resultChars, results: resultCount,
  271. residualFileAccess: Math.round(FILE_ACCESS.reduce((s, f) => s + residual[f], 0)),
  272. contributedFileAccess: Math.round(FILE_ACCESS.reduce((s, f) => s + contributed[f], 0)),
  273. charsFileAccess: FILE_ACCESS.reduce((s, f) => s + resultChars[f], 0),
  274. },
  275. };
  276. }
  277. /** The occupancy block, as printed under a run and reused by the aggregator. */
  278. export function formatOccupancy(s, indent = ' ') {
  279. const o = s.occupancy;
  280. const n = (x) => x.toLocaleString('en-US');
  281. const pctCtx = (t) => (o.ctxFinal > 0 ? ((t / o.ctxFinal) * 100).toFixed(1) : '0.0');
  282. const pctWin = (t) => ((t / o.windowTokens) * 100).toFixed(1);
  283. const rows = [];
  284. const row = (label, tok, chars, results) => rows.push(
  285. `${indent} ${label.padEnd(18)}${(n(tok) + ' tok').padStart(12)} ${(pctCtx(tok) + '%').padStart(6)} of ctx ` +
  286. `${(pctWin(tok) + '%').padStart(6)} of ${Math.round(o.windowTokens / 1000)}k win` +
  287. (chars !== undefined ? ` (${n(chars)} chars, ${results} result${results === 1 ? '' : 's'})` : '')
  288. );
  289. const out = [`${indent}Residual context occupancy at end of run:`];
  290. out.push(`${indent} ${'final context'.padEnd(18)}${(n(o.ctxFinal) + ' tok').padStart(12)} ${(pctWin(o.ctxFinal) + '%').padStart(6)} of ${Math.round(o.windowTokens / 1000)}k window`);
  291. row('codegraph', o.residual.codegraph, o.chars.codegraph, o.results.codegraph);
  292. row('Read', o.residual.read, o.chars.read, o.results.read);
  293. row('Grep/Glob', o.residual.search, o.chars.search, o.results.search);
  294. row('Bash', o.residual.bash, o.chars.bash, o.results.bash);
  295. row('→ file-access', o.residualFileAccess, o.charsFileAccess,
  296. o.results.read + o.results.search + o.results.bash);
  297. row('other tools', o.residual.other, o.chars.other, o.results.other);
  298. const toolTotal = Object.values(o.residual).reduce((a, b) => a + b, 0);
  299. row('base (prompt+prose)', Math.max(0, o.ctxFinal - toolTotal));
  300. out.push(`${indent} ${' of which fixed'.padEnd(18)}${(n(o.ctxBase) + ' tok').padStart(12)} system + tool schemas + question, before any tool answered`);
  301. out.push(...rows);
  302. const dropped = o.contributed.codegraph + o.contributedFileAccess + o.contributed.other
  303. - (o.residual.codegraph + o.residualFileAccess + o.residual.other);
  304. out.push(
  305. `${indent} measure: ${o.charsPerToken.toFixed(2)} chars/tok ${o.calibrated ? 'measured' : '(FALLBACK — no clean gap to calibrate on)'}` +
  306. (o.dispersion !== null ? ` ±${(o.dispersion * 100).toFixed(1)}%` : '') +
  307. ` · turns ${s.turns} · compactions ${o.compactions}` +
  308. (o.evicted > 0 || dropped > 1 ? ` · evicted ${n(o.evicted)} tok` : '')
  309. );
  310. return out.join('\n');
  311. }
  312. // ---------------------------------------------------------------------------
  313. // `--selftest`: the occupancy math over synthetic transcripts with known
  314. // answers. It lives here rather than in a test file on purpose — a new
  315. // scripts/agent-eval/*.mjs scores into the self-query eval fixture's corpus.
  316. function selftest() {
  317. const { writeFileSync, mkdtempSync } = require0('fs');
  318. const { join } = require0('path');
  319. const { tmpdir } = require0('os');
  320. const dir = mkdtempSync(join(tmpdir(), 'cg-occ-'));
  321. let n = 0, failures = 0;
  322. const check = (name, got, want, tol) => {
  323. n++;
  324. const ok = Math.abs(got - want) <= tol;
  325. if (!ok) failures++;
  326. console.log(`${ok ? ' ok ' : ' FAIL'} ${name}: got ${Math.round(got)}, want ${want} ±${tol}`);
  327. };
  328. // Builders for the event shapes Claude Code actually emits.
  329. const req = (ctx, id, blocks) => blocks.map((b) => JSON.stringify({
  330. type: 'assistant',
  331. message: { id, content: [b], usage: { input_tokens: ctx, cache_read_input_tokens: 0, cache_creation_input_tokens: 0, output_tokens: 2 } },
  332. }));
  333. const use = (id, name) => ({ type: 'tool_use', id, name, input: {} });
  334. const res = (id, chars) => JSON.stringify({
  335. type: 'user', message: { content: [{ type: 'tool_result', tool_use_id: id, content: [{ type: 'text', text: 'x'.repeat(chars) }] }] },
  336. });
  337. const done = () => JSON.stringify({ type: 'result', subtype: 'success', duration_ms: 1000, total_cost_usd: 0.1, usage: {} });
  338. const write = (name, lines) => { const f = join(dir, name); writeFileSync(f, lines.join('\n') + '\n'); return f; };
  339. // 1. Attribution: ratio 2.5 chars/tok, two families, no shedding.
  340. // 10,000 explore chars over a 4,000-tok gap; 5,000 Read chars over 2,000.
  341. let f = write('basic.jsonl', [
  342. ...req(10000, 'm1', [use('t1', 'mcp__codegraph__codegraph_explore')]),
  343. res('t1', 10000),
  344. ...req(14000, 'm2', [use('t2', 'Read')]),
  345. res('t2', 5000),
  346. ...req(16000, 'm3', [{ type: 'text', text: 'done' }]),
  347. done(),
  348. ]);
  349. let o = parseSession([f]).occupancy;
  350. check('chars/token', o.charsPerToken * 1000, 2500, 30);
  351. check('codegraph residual', o.residual.codegraph, 4000, 60);
  352. check('Read residual', o.residual.read, 2000, 40);
  353. check('file-access residual', o.residualFileAccess, 2000, 40);
  354. check('final context', o.ctxFinal, 16000, 0);
  355. check('fixed base', o.ctxBase, 10000, 0);
  356. check('nothing evicted', o.evicted, 0, 1);
  357. // 2. Dedupe: thinking + tool_use are two events sharing one id and one usage.
  358. // Counting usage per event would report 5 requests instead of 3.
  359. f = write('dupe.jsonl', [
  360. ...req(10000, 'm1', [{ type: 'thinking', thinking: '' }, use('t1', 'mcp__codegraph__codegraph_explore')]),
  361. res('t1', 10000),
  362. ...req(14000, 'm2', [{ type: 'thinking', thinking: '' }, use('t2', 'Read')]),
  363. res('t2', 5000),
  364. ...req(16000, 'm3', [{ type: 'text', text: 'done' }]),
  365. done(),
  366. ]);
  367. let s = parseSession([f]);
  368. check('turns deduped by message.id', s.turns, 3, 0);
  369. check('codegraph residual (deduped)', s.occupancy.residual.codegraph, 4000, 60);
  370. // 3. Compaction: the boundary clears everything resident before it.
  371. f = write('compact.jsonl', [
  372. ...req(10000, 'm1', [use('t1', 'mcp__codegraph__codegraph_explore')]),
  373. res('t1', 10000),
  374. ...req(14000, 'm2', [use('t2', 'mcp__codegraph__codegraph_explore')]),
  375. JSON.stringify({ type: 'system', subtype: 'compact_boundary' }),
  376. res('t2', 5000),
  377. ...req(8000, 'm3', [{ type: 'text', text: 'done' }]),
  378. done(),
  379. ]);
  380. o = parseSession([f]).occupancy;
  381. check('post-compaction residual = last result only', o.residual.codegraph, 2000, 40);
  382. check('contributed still counts both', o.contributed.codegraph, 6000, 80);
  383. // 4. Micro-compaction: context grows less than the results added, so the
  384. // oldest result is shed first (FIFO) — here explore, leaving Read.
  385. f = write('micro.jsonl', [
  386. ...req(10000, 'm1', [use('t1', 'mcp__codegraph__codegraph_explore')]),
  387. res('t1', 10000),
  388. ...req(14000, 'm2', [use('t2', 'Read')]),
  389. res('t2', 10000),
  390. ...req(14500, 'm3', [{ type: 'text', text: 'done' }]), // +500 for 4,000 tok of Read
  391. done(),
  392. ]);
  393. o = parseSession([f]).occupancy;
  394. check('FIFO evicted the older codegraph result', o.residual.codegraph, 500, 60);
  395. check('newer Read result survives', o.residual.read, 4000, 60);
  396. check('eviction recorded', o.evicted, 3500, 60);
  397. // 5. Multi-turn stitching: a resumed segment continues the same context, and
  398. // a turn that calls no tool leaves the earlier residual in place.
  399. const a = write('seg1.jsonl', [
  400. ...req(10000, 'm1', [use('t1', 'mcp__codegraph__codegraph_explore')]),
  401. res('t1', 10000),
  402. ...req(14000, 'm2', [{ type: 'text', text: 'answer one' }]),
  403. done(),
  404. ]);
  405. const b = write('seg2.jsonl', [
  406. ...req(14600, 'm3', [{ type: 'text', text: 'answer two, from what is already here' }]),
  407. done(),
  408. ]);
  409. s = parseSession([a, b]);
  410. check('stitched turns', s.turns, 3, 0);
  411. check('residual carries into turn 2', s.occupancy.residual.codegraph, 4000, 60);
  412. check('stitched final context', s.occupancy.ctxFinal, 14600, 0);
  413. check('stitched cost sums segments', s.cost * 100, 20, 0.1);
  414. console.log(`\n${n - failures}/${n} checks passed`);
  415. return failures;
  416. }
  417. // `--selftest` needs sync fs helpers the module path doesn't import at top level.
  418. function require0(m) { return process.getBuiltinModule(m); }
  419. const isMain = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href;
  420. if (isMain && process.argv.includes('--selftest')) process.exit(selftest() ? 1 : 0);
  421. if (isMain) {
  422. const files = process.argv.slice(2).filter((a) => !a.startsWith('--'));
  423. if (!files.length) { console.error('usage: parse-run.mjs <run.jsonl> [run.t2.jsonl ...] | --selftest'); process.exit(1); }
  424. const s = parseSession(files);
  425. console.log(`\n=== ${files.map((f) => f.split('/').pop()).join(' + ')} ===`);
  426. console.log(`codegraph tools exposed: ${s.initTools ? s.initTools.length : '?'}${s.raced ? ' [MCP COLD-START RACE — tool call hit "No such tool available"]' : ''}`);
  427. console.log(`\nTool calls (${s.toolCalls.length}):`);
  428. console.log(' by type:', JSON.stringify(s.counts));
  429. s.toolCalls.forEach((tc, i) => console.log(` ${i + 1}. ${tc}`));
  430. if (s.result) {
  431. const seg = s.results.length > 1 ? ` | ${s.results.length} segments (${s.results.map((r) => r.subtype).join(',')})` : '';
  432. console.log(`\nResult: ${s.result.subtype} | duration ${s.dur.toFixed(0)}s | turns ${s.turns}${seg}`);
  433. console.log(` tokens processed: ${s.processed.toLocaleString('en-US')} | cost $${s.cost.toFixed(3)}`);
  434. }
  435. console.log('');
  436. console.log(formatOccupancy(s));
  437. }