@cat-factory/orchestration 0.159.2 → 0.161.0

package/dist/modules/debug/debug.logic.js

@@ -0,0 +1,403 @@
+import { foldRollupTotals, foldRollupsByAgentKind, foldRollupsByPhase } from '@cat-factory/kernel';
+import { cacheHitRate, classifyCall, isWarningFinishReason, outputHeadroomRatio, transportOverheadRatio, } from '../observability/observability.logic.js';
+// Pure projections + derivations behind the remote debugging surface. Everything here is a
+// total function of already-fetched data — no clock, no repository, no I/O — so the shapes an
+// external client depends on are unit-testable without a store, and the service above stays a
+// thin "fetch the bounded things, hand them to these" layer.
+/** Cap on the container post-mortem inlined on a step (it is a log tail, not a document). */
+export const MAX_EVICTION_DETAIL_CHARS = 4_000;
+/**
+ * Count Unicode CODE POINTS — the unit the stores measure in. SQL `length()`/`substr()` count
+ * code points on both SQLite and Postgres, while JS `.length` counts UTF-16 units, so an
+ * astral-plane character (an emoji) is one to the store and two to `.length`. Every `chars`/
+ * `totalChars` on this surface is in code points; mixing the units made `truncated` lie on
+ * exactly the boundary case it exists for (a body cut by SQL whose UTF-16 length happened to
+ * equal the code-point total read as untruncated).
+ */
+function codePointLength(text) {
+    let count = 0;
+    for (let i = 0; i < text.length; i += 1) {
+        count += 1;
+        const unit = text.charCodeAt(i);
+        // A high surrogate leads a two-unit pair encoding one code point; skip its partner.
+        if (unit >= 0xd800 && unit <= 0xdbff)
+            i += 1;
+    }
+    return count;
+}
+/** Advance a UTF-16 index by `count` code points (never landing inside a surrogate pair). */
+function advanceCodePoints(text, from, count) {
+    let index = from;
+    for (let taken = 0; taken < count && index < text.length; taken += 1) {
+        const unit = text.charCodeAt(index);
+        index += unit >= 0xd800 && unit <= 0xdbff ? 2 : 1;
+    }
+    return index;
+}
+/**
+ * Slice a stored body to a caller's window and SAY SO. The metadata matters more than the
+ * text: a bare truncated string reads exactly like a short one, so a model handed the first
+ * 2 kB of a 40 kB reply would confidently report that the agent said almost nothing.
+ *
+ * `budget` of 0 returns no text at all while still reporting the full size — that is the
+ * shape a sweep uses, and the reason a size-only page is still worth reading. `offset`
+ * starts the window later, which is how the tail of a large body is reached; past the end
+ * it returns an empty slice whose `offset` is clamped to the total, so
+ * `offset + chars <= totalChars` always holds.
+ *
+ * Budgets, offsets and sizes are CODE POINTS (see {@link codePointLength}), matching the
+ * SQL-sliced bodies — and the cut walks whole code points, so it can never split a
+ * surrogate pair and hand the caller a lone half of one.
+ */
+export function sliceText(text, budget, offset = 0) {
+    const total = codePointLength(text);
+    const start = Math.max(0, Math.min(offset, total));
+    const chars = Math.max(0, Math.min(budget, total - start));
+    let sliced = text;
+    if (start > 0 || chars < total) {
+        const begin = advanceCodePoints(text, 0, start);
+        const end = advanceCodePoints(text, begin, chars);
+        sliced = text.slice(begin, end);
+    }
+    return {
+        text: sliced,
+        chars,
+        offset: start,
+        totalChars: total,
+        truncated: chars < total,
+    };
+}
+/**
+ * Project a body the STORE already sliced. The repository returns `{ text, totalChars }`
+ * because it cut the body in SQL (so the untaken bytes never left the database); this only
+ * re-derives the fields the wire shape adds. Deliberately does NOT re-slice: `text` is
+ * already within the window, and slicing again would silently disagree with `totalChars`.
+ *
+ * `offset` is the window start the caller asked the store for (0 for a list slice), clamped
+ * to the total so an ask past the end reports where the body actually stops. A search's
+ * per-body `matchOffset` rides through untouched — null (no match in this body) and absent
+ * (no search ran) stay distinct on the wire.
+ *
+ * `chars` and the truncation check count CODE POINTS, because `totalChars` came from SQL
+ * `length()` which counts the same — a JS `.length` here reads a SQL-cut emoji-bearing body
+ * as untruncated (see {@link codePointLength}).
+ */
+export function toDebugText(slice, offset = 0) {
+    const chars = codePointLength(slice.text);
+    return {
+        text: slice.text,
+        chars,
+        offset: Math.max(0, Math.min(offset, slice.totalChars)),
+        totalChars: slice.totalChars,
+        truncated: chars < slice.totalChars,
+        ...(slice.matchOffset !== undefined ? { matchOffset: slice.matchOffset } : {}),
+    };
+}
+/** Project a persisted run onto the lean summary every debug list and overview leads with. */
+export function toDebugRunSummary(execution) {
+    return {
+        runId: execution.id,
+        blockId: execution.blockId,
+        pipelineId: execution.pipelineId,
+        pipelineName: execution.pipelineName,
+        status: execution.status,
+        createdAt: execution.createdAt ?? 0,
+        currentStep: execution.currentStep,
+        stepCount: execution.steps.length,
+        failure: execution.failure ?? null,
+    };
+}
+/** Project one pipeline step onto the debug view (identity + clocks + container mortality). */
+export function toDebugRunStep(step, index) {
+    const detail = step.firstEvictionDetail;
+    return {
+        index,
+        agentKind: step.agentKind,
+        state: step.state,
+        progress: step.progress,
+        model: step.model ?? null,
+        skipped: step.skipped ?? false,
+        startedAt: step.startedAt ?? null,
+        finishedAt: step.finishedAt ?? null,
+        lastActivityAt: step.lastActivityAt ?? null,
+        subtasks: step.subtasks
+            ? {
+                completed: step.subtasks.completed,
+                inProgress: step.subtasks.inProgress,
+                total: step.subtasks.total,
+            }
+            : null,
+        outputChars: (step.output ?? '').length,
+        hasStructuredResult: step.custom != null,
+        evictionRecoveries: step.evictionRecoveries ?? 0,
+        firstEvictionDetail: detail ? sliceText(detail, MAX_EVICTION_DETAIL_CHARS) : null,
+    };
+}
+/**
+ * Project a bounded call-page row onto the wire shape. `bodyOffset` is the window start the
+ * store's slices were taken at (a point read's `?bodyOffset=`; always 0 on a list row).
+ */
+export function toDebugLlmCall(call, bodyOffset = 0) {
+    return {
+        callId: call.id,
+        runId: call.executionId,
+        agentKind: call.agentKind,
+        provider: call.provider,
+        model: call.model,
+        createdAt: call.createdAt,
+        outcome: classifyCall(call),
+        ok: call.ok,
+        httpStatus: call.httpStatus,
+        errorMessage: call.errorMessage,
+        finishReason: call.finishReason,
+        streaming: call.streaming,
+        phase: call.phase,
+        turnIndex: call.turnIndex,
+        messageCount: call.messageCount,
+        toolCount: call.toolCount,
+        requestMaxTokens: call.requestMaxTokens,
+        promptTokens: call.promptTokens,
+        cacheReadTokens: call.cacheReadTokens,
+        cacheWriteTokens: call.cacheWriteTokens,
+        completionTokens: call.completionTokens,
+        totalTokens: call.totalTokens,
+        upstreamMs: call.upstreamMs,
+        overheadMs: call.overheadMs,
+        totalMs: call.totalMs,
+        elidedLeadingMessages: call.promptPrefixCount,
+        prompt: toDebugText(call.prompt, bodyOffset),
+        response: toDebugText(call.response, bodyOffset),
+        reasoning: toDebugText(call.reasoning, bodyOffset),
+    };
+}
+/** Project a snapshot index row onto the wire shape. */
+export function toDebugAgentContextEntry(row) {
+    return {
+        snapshotId: row.id,
+        agentKind: row.agentKind,
+        stepIndex: row.stepIndex,
+        createdAt: row.createdAt,
+        model: row.model,
+        harness: row.harness,
+        systemPromptChars: row.systemPromptChars,
+        userPromptChars: row.userPromptChars,
+        fragmentsChars: row.fragmentsChars,
+        contextFilesChars: row.contextFilesChars,
+    };
+}
+/**
+ * Project a whole snapshot onto the wire shape, budgeting EVERY body INDEPENDENTLY rather
+ * than against one shared allowance. A snapshot routinely holds one enormous injected file
+ * next to the prompts, and a shared budget spent in array order would leave the prompts — the
+ * thing a reader almost always came for — empty because a README came first.
+ */
+export function toDebugAgentContextDetail(snapshot, bodyChars, bodyOffset = 0) {
+    return {
+        snapshotId: snapshot.id,
+        runId: snapshot.executionId,
+        agentKind: snapshot.agentKind,
+        stepIndex: snapshot.stepIndex,
+        createdAt: snapshot.createdAt,
+        model: snapshot.model,
+        harness: snapshot.harness,
+        systemPrompt: sliceText(snapshot.systemPrompt, bodyChars, bodyOffset),
+        userPrompt: sliceText(snapshot.userPrompt, bodyChars, bodyOffset),
+        fragments: snapshot.fragments.map((f) => ({
+            id: f.id,
+            body: sliceText(f.body, bodyChars, bodyOffset),
+        })),
+        contextFiles: snapshot.contextFiles.map((f) => ({
+            path: f.path,
+            title: f.title,
+            url: f.url,
+            content: sliceText(f.content, bodyChars, bodyOffset),
+        })),
+        extras: snapshot.extras,
+    };
+}
+/**
+ * Fold the store's `(agentKind, phase)` rollup cells into the run-level totals + the two
+ * breakdowns the overview reports. Built from {@link LlmCallMetricSummary} — the aggregate the
+ * store computes without touching a text column — rather than from the calls themselves, so a
+ * 3,000-call run costs one GROUP BY here instead of reading 3,000 rows to add them up in
+ * JavaScript.
+ *
+ * Both breakdowns are folds over the SAME cells (kernel's `foldRollupsBy*`), so they total
+ * identically to each other and to `totals` by construction — the alternative, one aggregate
+ * per axis, could only ever produce two answers to the same question.
+ *
+ * The per-kind output reuses the metrics EXPORT's shapes on purpose: both describe the same
+ * run's model activity, and two independently-derived totals would eventually disagree.
+ */
+export function foldLlmRollup(summaries) {
+    const byAgentKind = foldRollupsByAgentKind(summaries).map((s) => ({
+        agentKind: s.agentKind,
+        calls: s.calls,
+        promptTokens: s.promptTokens,
+        cacheReadTokens: s.cacheReadTokens,
+        cacheWriteTokens: s.cacheWriteTokens,
+        cacheHitRate: cacheHitRate(s.cacheReadTokens, s.cacheWriteTokens, s.promptTokens),
+        completionTokens: s.completionTokens,
+        peakCompletionTokens: s.peakCompletionTokens,
+        maxOutputTokens: s.maxOutputTokens,
+        outputHeadroomRatio: outputHeadroomRatio(s.peakCompletionTokens, s.maxOutputTokens),
+        truncatedCalls: s.truncatedCalls,
+        upstreamMs: s.upstreamMs,
+        overheadMs: s.overheadMs,
+        transportOverheadRatio: transportOverheadRatio(s.upstreamMs, s.overheadMs),
+        errors: s.errors,
+        warnings: s.warnings,
+    }));
+    const phases = foldRollupsByPhase(summaries);
+    // Denominator for each phase's share of the carry cost. Folded from the phase rows
+    // themselves rather than re-summed off `summaries`, so the shares provably sum to 1.
+    const runCarryCost = phases.reduce((acc, p) => acc + p.carryCostTokens, 0);
+    const byPhase = phases
+        .map((p) => ({
+        phase: p.phase,
+        calls: p.calls,
+        promptTokens: p.promptTokens,
+        cacheReadTokens: p.cacheReadTokens,
+        cacheWriteTokens: p.cacheWriteTokens,
+        cacheHitRate: cacheHitRate(p.cacheReadTokens, p.cacheWriteTokens, p.promptTokens),
+        completionTokens: p.completionTokens,
+        carryCostTokens: p.carryCostTokens,
+        carryCostShare: runCarryCost > 0 ? p.carryCostTokens / runCarryCost : null,
+        upstreamMs: p.upstreamMs,
+        overheadMs: p.overheadMs,
+        errors: p.errors,
+        warnings: p.warnings,
+        truncatedCalls: p.truncatedCalls,
+    }))
+        // Expensive slice first: the caller reading this is asking which phase to attack, and a
+        // store-order list buries the answer behind whichever phase happened to run first.
+        .sort((a, b) => b.carryCostTokens - a.carryCostTokens || b.calls - a.calls);
+    const runTotals = foldRollupTotals(summaries);
+    return {
+        totals: {
+            calls: runTotals.calls,
+            promptTokens: runTotals.promptTokens,
+            cacheReadTokens: runTotals.cacheReadTokens,
+            cacheWriteTokens: runTotals.cacheWriteTokens,
+            cacheHitRate: cacheHitRate(runTotals.cacheReadTokens, runTotals.cacheWriteTokens, runTotals.promptTokens),
+            completionTokens: runTotals.completionTokens,
+            upstreamMs: runTotals.upstreamMs,
+            overheadMs: runTotals.overheadMs,
+            transportOverheadRatio: transportOverheadRatio(runTotals.upstreamMs, runTotals.overheadMs),
+            errors: runTotals.errors,
+            warnings: runTotals.warnings,
+            truncatedCalls: runTotals.truncatedCalls,
+        },
+        byAgentKind,
+        byPhase,
+    };
+}
+/** A cache hit rate below this on a substantial prompt volume is worth flagging. */
+const COLD_CACHE_RATE = 0.1;
+/** Only flag a cold cache once the run has actually sent enough prompt to benefit from one. */
+const COLD_CACHE_MIN_PROMPT_TOKENS = 50_000;
+/** Above this share of latency spent in transport, the proxy is the story, not the model. */
+const HIGH_TRANSPORT_OVERHEAD = 0.5;
+/**
+ * Precompute the diagnostic hints the overview publishes. Every one of these is derivable by
+ * the caller from the same payload — which is exactly the point: a model that has to
+ * rediscover "13 of 40 calls were truncated" by arithmetic over a JSON blob will sometimes get
+ * it wrong and will always spend context getting it right. Ordered most-severe first, so a
+ * reader that truncates the list keeps what matters.
+ *
+ * Deliberately NOT a verdict. Each signal names one observation and its magnitude; nothing
+ * here claims to know why the run failed, because a wrong confident cause is worse for a
+ * debugging client than an ordered list of facts.
+ */
+export function deriveSignals(input) {
+    const { execution, steps, totals, byAgentKind, sinks, provisioningFailures } = input;
+    const signals = [];
+    const push = (code, severity, message, extra = {}) => {
+        signals.push({
+            code,
+            severity,
+            message,
+            count: extra.count ?? null,
+            agentKind: extra.agentKind ?? null,
+            stepIndex: extra.stepIndex ?? null,
+        });
+    };
+    if (execution.status === 'failed') {
+        const failure = execution.failure;
+        push('run_failed', 'error', failure
+            ? `The run failed with '${failure.kind}': ${failure.message}`
+            : 'The run failed without recording a structured failure.', { stepIndex: execution.currentStep });
+    }
+    if (provisioningFailures > 0) {
+        push('provisioning_failed', 'error', `${provisioningFailures} provisioning attempt(s) for this run failed. Read GET /debug/runs/:runId/logs for the verbatim provider error — a run whose infrastructure never came up records no model calls at all.`, { count: provisioningFailures });
+    }
+    if (totals.errors > 0) {
+        push('llm_calls_failed', 'error', `${totals.errors} model call(s) failed.`, {
+            count: totals.errors,
+        });
+    }
+    for (const step of steps) {
+        if (step.evictionRecoveries > 0) {
+            push('container_evicted', 'warning', `Step ${step.index} (${step.agentKind}) lost its container ${step.evictionRecoveries} time(s) and was re-dispatched.`, { count: step.evictionRecoveries, agentKind: step.agentKind, stepIndex: step.index });
+        }
+    }
+    for (const insight of byAgentKind) {
+        if (insight.truncatedCalls > 0) {
+            push('output_truncated', 'warning', `${insight.truncatedCalls} of ${insight.agentKind}'s ${insight.calls} call(s) hit the output limit, so the model's reply was cut mid-answer.`, { count: insight.truncatedCalls, agentKind: insight.agentKind });
+        }
+    }
+    // The most common hard diagnosis has NO row of its own: a run that failed while every model
+    // call looks healthy. Tool-EXECUTION errors (malformed arguments, a stuck edit loop) happen
+    // inside the container and are recorded only as text inside the prompt deltas — each call
+    // still reports `ok` with a clean finish reason, so without this pointer the overview reads
+    // like a healthy run that inexplicably died and the caller has nothing to follow.
+    if (execution.status === 'failed' &&
+        sinks.llmCalls.available &&
+        totals.calls > 0 &&
+        totals.errors === 0 &&
+        totals.truncatedCalls === 0) {
+        push('failure_outside_model_calls', 'warning', `The run failed but none of its ${totals.calls} model call(s) failed or was truncated — the model side looks healthy, so the cause most likely sits in tool execution inside the container or in the engine, neither of which records calls here. Search the bodies for tool errors (GET /debug/runs/:runId/llm-calls?contains=...), read the newest calls' deltas, and check each step's firstEvictionDetail plus /logs.`, { count: totals.calls });
+    }
+    if (totals.transportOverheadRatio != null &&
+        totals.transportOverheadRatio > HIGH_TRANSPORT_OVERHEAD) {
+        push('transport_overhead_high', 'warning', `${Math.round(totals.transportOverheadRatio * 100)}% of the run's model latency was transport/proxy overhead rather than model execution.`);
+    }
+    if (totals.promptTokens >= COLD_CACHE_MIN_PROMPT_TOKENS &&
+        totals.cacheHitRate != null &&
+        totals.cacheHitRate < COLD_CACHE_RATE) {
+        push('prompt_cache_cold', 'info', `Only ${Math.round(totals.cacheHitRate * 100)}% of ${totals.promptTokens} prompt tokens were served from the provider's prefix cache, so the conversation was re-billed almost in full every turn.`);
+    }
+    if (execution.status === 'blocked') {
+        push('run_parked', 'info', 'The run is parked awaiting a human decision; it will wait indefinitely by design.', { stepIndex: execution.currentStep });
+    }
+    if (execution.status === 'paused') {
+        push('run_paused', 'info', 'The run is paused by the spend safeguard.', {
+            stepIndex: execution.currentStep,
+        });
+    }
+    // A sink that is not wired and a sink that is wired but empty need DIFFERENT follow-up
+    // actions from the caller — "turn capture on / this deployment does not keep it" versus
+    // "nothing happened here, look elsewhere" — so they are never collapsed into one hint.
+    for (const [name, sink, what] of [
+        ['llmCalls', sinks.llmCalls, 'model calls'],
+        ['agentContext', sinks.agentContext, 'agent-context snapshots'],
+        ['searchQueries', sinks.searchQueries, 'web searches'],
+        ['provisioningLog', sinks.provisioningLog, 'provisioning events'],
+    ]) {
+        if (!sink.available) {
+            // Availability is REPOSITORY presence only. A workspace that turned capture off (or a
+            // deployment without LLM_RECORD_PROMPTS) still reads `available: true, count: 0` — the
+            // capture gates act at record time, and this reader cannot see them.
+            push('telemetry_unavailable', 'info', `No ${what} are retained: the '${name}' sink is not wired on this deployment. Its count of 0 does not mean none happened.`);
+        }
+    }
+    // Skipped for a `done` run on purpose: a completed run with no model calls is a legitimate
+    // shape (a gate-only or pass-through pipeline), not a diagnosis.
+    if (sinks.llmCalls.available && sinks.llmCalls.count === 0 && execution.status !== 'done') {
+        push('no_model_calls', 'warning', 'The run recorded no model calls at all, so it failed or stalled before (or outside of) any agent work.');
+    }
+    return signals;
+}
+/** Re-exported so the service and its tests classify a call exactly as the SPA does. */
+export { classifyCall, isWarningFinishReason };
+//# sourceMappingURL=debug.logic.js.map

package/dist/modules/debug/debug.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.logic.js","sourceRoot":"","sources":["../../../src/modules/debug/debug.logic.ts"],"names":[],"mappings":"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"}

package/dist/modules/debug/promptMessages.d.ts

@@ -0,0 +1,27 @@
+import type { LlmCallMetricPage } from '@cat-factory/kernel';
+import type { DebugLlmCall, DebugPromptMessage } from '@cat-factory/contracts';
+/**
+ * Parse a stored prompt delta into per-message rows, or null when it is not a JSON array —
+ * the caller degrades the view to raw and SAYS so, rather than serving a guess.
+ *
+ * `elided` is the call's `promptPrefixCount`: each row's `index` is its position in the
+ * FULL conversation, so two calls' parsed views line up without the reader doing delta
+ * arithmetic. `budget` bounds each message's content (and each tool call's arguments)
+ * independently.
+ */
+export declare function parsePromptMessages(promptJson: string, elided: number, budget: number): DebugPromptMessage[] | null;
+/**
+ * Project a WHOLE-BODY row onto the wire shape as the parsed messages view. Takes the row
+ * unsliced (the parse needs the complete delta — a truncated JSON array parses as nothing),
+ * so the raw/messages split is decided here, in one place:
+ *
+ *  - parsed: `prompt` carries sizes only (its text is the same bytes re-presented as
+ *    `promptMessages`, and sending both would double the payload), each message budgeted
+ *    independently.
+ *  - unparseable: `promptMessages: null` and the raw window served exactly as `view=raw`
+ *    would have — the view DEGRADES, it never returns less than the raw read.
+ *
+ * `response`/`reasoning` are plain text either way and take the same window raw view does.
+ */
+export declare function toDebugLlmCallMessagesView(call: LlmCallMetricPage, bodyChars: number, bodyOffset: number): DebugLlmCall;
+//# sourceMappingURL=promptMessages.d.ts.map

package/dist/modules/debug/promptMessages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptMessages.d.ts","sourceRoot":"","sources":["../../../src/modules/debug/promptMessages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAsG9E;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,GACb,kBAAkB,EAAE,GAAG,IAAI,CAyB7B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GACjB,YAAY,CAoBd"}

package/dist/modules/debug/promptMessages.js

@@ -0,0 +1,165 @@
+import { sliceText, toDebugLlmCall } from './debug.logic.js';
+// The `?view=messages` half of the single-call point read: parse the stored prompt delta —
+// `JSON.stringify` of a `{ role, content }` array on BOTH telemetry producers (the proxy
+// stores the OpenAI-shaped request messages; the harness stores its reconstructed
+// transcript) — into per-message rows, each with its OWN content budget.
+//
+// Independent budgets are the reason this exists rather than leaving the parse to the
+// caller: in the raw view the delta is one string, so a 100 kB leading tool result must be
+// paid for in full before anything after it is visible, while here every message shows its
+// head. The response stays computable before the request — its worst case is
+// `(messageCount − elidedLeadingMessages) × budget`, and both factors ride the list row.
+//
+// The parse is LENIENT BY CONTRACT. The two producers agree on the array-of-role-content
+// envelope but not on content shapes (strings, OpenAI content parts + `tool_calls`, vendor
+// tool_use/tool_result blocks), and the text is model-adjacent data that can be anything.
+// So: an unparseable delta degrades the whole view to raw (`promptMessages: null`, stated,
+// never guessed at), and inside a parsed array every unrecognised shape degrades to a
+// placeholder or a JSON dump rather than failing the message — a reader locating a tool
+// error must never lose the whole view to one exotic content block.
+/** Read a string property leniently off an untrusted parsed object. */
+function stringField(value, key) {
+    const field = value[key];
+    return typeof field === 'string' ? field : null;
+}
+/**
+ * Flatten one message's `content` to text. Handles the shapes the two producers actually
+ * store — a plain string, an array of parts (OpenAI `{type:'text',text}` and vendor
+ * `{type:'tool_use'|'tool_result',…}` blocks), a bare object — and stands in a `[type]`
+ * placeholder for a part with no text, so the message's SHAPE survives even when its
+ * content is not textual.
+ */
+function contentToText(content) {
+    if (content == null)
+        return '';
+    if (typeof content === 'string')
+        return content;
+    if (Array.isArray(content)) {
+        return content
+            .map((part) => {
+            if (typeof part === 'string')
+                return part;
+            if (part && typeof part === 'object') {
+                const record = part;
+                const text = stringField(record, 'text');
+                if (text != null)
+                    return text;
+                // A vendor tool_result block nests its payload under `content`.
+                if ('content' in record && stringField(record, 'type') === 'tool_result') {
+                    return contentToText(record['content']);
+                }
+                return `[${stringField(record, 'type') ?? 'part'}]`;
+            }
+            return `[${typeof part}]`;
+        })
+            .join('\n');
+    }
+    if (typeof content === 'object')
+        return JSON.stringify(content);
+    return String(content);
+}
+/**
+ * Collect the tool invocations an assistant turn requested, across both producers' shapes:
+ * OpenAI `tool_calls: [{function:{name,arguments}}]` and vendor content blocks
+ * `{type:'tool_use', name, input}`. Arguments are serialized and budgeted like content.
+ */
+function collectToolCalls(message, budget) {
+    const calls = [];
+    const openAi = message['tool_calls'];
+    if (Array.isArray(openAi)) {
+        for (const entry of openAi) {
+            if (!entry || typeof entry !== 'object')
+                continue;
+            const fn = entry['function'];
+            const record = fn && typeof fn === 'object' ? fn : {};
+            const args = record['arguments'];
+            calls.push({
+                name: stringField(record, 'name') ?? 'unknown',
+                args: sliceText(typeof args === 'string' ? args : args == null ? '' : JSON.stringify(args), budget),
+            });
+        }
+    }
+    const content = message['content'];
+    if (Array.isArray(content)) {
+        for (const part of content) {
+            if (!part || typeof part !== 'object')
+                continue;
+            const record = part;
+            if (stringField(record, 'type') !== 'tool_use')
+                continue;
+            const input = record['input'];
+            calls.push({
+                name: stringField(record, 'name') ?? 'unknown',
+                args: sliceText(input == null ? '' : JSON.stringify(input), budget),
+            });
+        }
+    }
+    return calls;
+}
+/**
+ * Parse a stored prompt delta into per-message rows, or null when it is not a JSON array —
+ * the caller degrades the view to raw and SAYS so, rather than serving a guess.
+ *
+ * `elided` is the call's `promptPrefixCount`: each row's `index` is its position in the
+ * FULL conversation, so two calls' parsed views line up without the reader doing delta
+ * arithmetic. `budget` bounds each message's content (and each tool call's arguments)
+ * independently.
+ */
+export function parsePromptMessages(promptJson, elided, budget) {
+    let parsed;
+    try {
+        parsed = JSON.parse(promptJson);
+    }
+    catch {
+        return null;
+    }
+    if (!Array.isArray(parsed))
+        return null;
+    return parsed.map((entry, position) => {
+        const message = entry && typeof entry === 'object' && !Array.isArray(entry)
+            ? entry
+            : null;
+        return {
+            index: elided + position,
+            role: message ? (stringField(message, 'role') ?? 'unknown') : 'unknown',
+            name: message ? stringField(message, 'name') : null,
+            toolCallId: message ? stringField(message, 'tool_call_id') : null,
+            toolCalls: message ? collectToolCalls(message, budget) : [],
+            content: sliceText(message ? contentToText(message['content']) : JSON.stringify(entry), budget),
+        };
+    });
+}
+/**
+ * Project a WHOLE-BODY row onto the wire shape as the parsed messages view. Takes the row
+ * unsliced (the parse needs the complete delta — a truncated JSON array parses as nothing),
+ * so the raw/messages split is decided here, in one place:
+ *
+ *  - parsed: `prompt` carries sizes only (its text is the same bytes re-presented as
+ *    `promptMessages`, and sending both would double the payload), each message budgeted
+ *    independently.
+ *  - unparseable: `promptMessages: null` and the raw window served exactly as `view=raw`
+ *    would have — the view DEGRADES, it never returns less than the raw read.
+ *
+ * `response`/`reasoning` are plain text either way and take the same window raw view does.
+ */
+export function toDebugLlmCallMessagesView(call, bodyChars, bodyOffset) {
+    const messages = parsePromptMessages(call.prompt.text, call.promptPrefixCount, bodyChars);
+    // Project the metadata off body-less slices (the three bodies are replaced below), so the
+    // full texts are not walked a second time just to produce fields that get overwritten.
+    const projected = toDebugLlmCall({
+        ...call,
+        prompt: { text: '', totalChars: call.prompt.totalChars },
+        response: { text: '', totalChars: call.response.totalChars },
+        reasoning: { text: '', totalChars: call.reasoning.totalChars },
+    });
+    return {
+        ...projected,
+        prompt: messages == null
+            ? sliceText(call.prompt.text, bodyChars, bodyOffset)
+            : sliceText(call.prompt.text, 0),
+        response: sliceText(call.response.text, bodyChars, bodyOffset),
+        reasoning: sliceText(call.reasoning.text, bodyChars, bodyOffset),
+        promptMessages: messages,
+    };
+}
+//# sourceMappingURL=promptMessages.js.map

package/dist/modules/debug/promptMessages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"promptMessages.js","sourceRoot":"","sources":["../../../src/modules/debug/promptMessages.ts"],"names":[],"mappings":"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"}

package/dist/modules/execution/RunStateMachine.d.ts

@@ -120,6 +120,10 @@ export declare class RunStateMachine {
      * (not step index), so the aggregate is per-agent-kind within the run; steps
      * sharing a kind get the same rollup. Best-effort and a no-op when the sink is
      * not wired, so it never blocks an emit.
+     *
+     * The store returns the finer `(agentKind, phase)` grain, so the step's headline numbers
+     * are a fold up to the kind and its `byPhase` breakdown is the same cells re-cut — ONE
+     * aggregate for both, since an emit runs this on every step settlement.
      */
     private attachStepMetrics;
     /** Set the block's in-progress/blocked status and step-completion progress. */