agentfootprint 13.0.0 → 14.0.0

package/dist/trace-toolpack/traceToolpack/sliceView.js.map

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

package/dist/trace-toolpack/traceToolpack/structuralLimits.js

@@ -0,0 +1,71 @@
+"use strict";
+// ── Display caps that are structural (not consumer-tunable) ───────────────
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MOUNT_SUGGESTION_CAP = exports.SCHEMA_ENUM_CAP = exports.TOOL_RESULT_PREVIEW_CHARS = exports.SILENT_CHECK_NAME_CAP = exports.DISPOSITION_ROW_CAP = exports.FINDING_WITNESS_CAP = exports.FINDING_SUBJECT_CAP = exports.FINDING_MESSAGE_CHARS = exports.FINDINGS_DEFAULT = exports.INNER_RUN_SUGGESTION_CAP = exports.TOOL_CALL_SUGGESTION_CAP = exports.FIND_SCAN_BUDGET = exports.FIND_CONTEXT_RADIUS = exports.FIND_QUERY_MAX_CHARS = exports.FIND_QUERY_MIN_CHARS = exports.FIND_HITS_DEFAULT = exports.KEY_SUGGESTION_CAP = exports.UNKNOWN_ID_SUGGESTION_CAP = exports.NARRATIVE_LINE_CHAR_CAP = exports.NODE_READ_CAP = exports.NODE_WRITE_CAP = exports.OVERVIEW_DESCRIPTION_CAP = exports.OVERVIEW_ERROR_CAP = exports.OVERVIEW_KEY_CAP = exports.OVERVIEW_STAGE_CAP = void 0;
+const OVERVIEW_STAGE_CAP = 40;
+exports.OVERVIEW_STAGE_CAP = OVERVIEW_STAGE_CAP;
+const OVERVIEW_KEY_CAP = 40;
+exports.OVERVIEW_KEY_CAP = OVERVIEW_KEY_CAP;
+const OVERVIEW_ERROR_CAP = 10;
+exports.OVERVIEW_ERROR_CAP = OVERVIEW_ERROR_CAP;
+const OVERVIEW_DESCRIPTION_CAP = 140;
+exports.OVERVIEW_DESCRIPTION_CAP = OVERVIEW_DESCRIPTION_CAP;
+const NODE_WRITE_CAP = 20;
+exports.NODE_WRITE_CAP = NODE_WRITE_CAP;
+const NODE_READ_CAP = 30;
+exports.NODE_READ_CAP = NODE_READ_CAP;
+const NARRATIVE_LINE_CHAR_CAP = 400;
+exports.NARRATIVE_LINE_CHAR_CAP = NARRATIVE_LINE_CHAR_CAP;
+const UNKNOWN_ID_SUGGESTION_CAP = 8;
+exports.UNKNOWN_ID_SUGGESTION_CAP = UNKNOWN_ID_SUGGESTION_CAP;
+const KEY_SUGGESTION_CAP = 12;
+exports.KEY_SUGGESTION_CAP = KEY_SUGGESTION_CAP;
+/** `find_in_trace` — default hits, query bounds, and per-hit context window. */
+const FIND_HITS_DEFAULT = 10;
+exports.FIND_HITS_DEFAULT = FIND_HITS_DEFAULT;
+const FIND_QUERY_MIN_CHARS = 2;
+exports.FIND_QUERY_MIN_CHARS = FIND_QUERY_MIN_CHARS;
+const FIND_QUERY_MAX_CHARS = 200;
+exports.FIND_QUERY_MAX_CHARS = FIND_QUERY_MAX_CHARS;
+const FIND_CONTEXT_RADIUS = 55;
+exports.FIND_CONTEXT_RADIUS = FIND_CONTEXT_RADIUS;
+/**
+ * How many committed writes one search may open before it stops. A search
+ * is a pointer list, not a scan of the whole run — and a search that ran
+ * out of budget SAYS so rather than reporting "no match".
+ */
+const FIND_SCAN_BUDGET = 1500;
+exports.FIND_SCAN_BUDGET = FIND_SCAN_BUDGET;
+/** `inspect_tool_call` — how many real ids an unknown-id correction names. */
+const TOOL_CALL_SUGGESTION_CAP = 12;
+exports.TOOL_CALL_SUGGESTION_CAP = TOOL_CALL_SUGGESTION_CAP;
+/** `inspect_tool_run` — how many RETAINED inner runs a correction names. */
+const INNER_RUN_SUGGESTION_CAP = 12;
+exports.INNER_RUN_SUGGESTION_CAP = INNER_RUN_SUGGESTION_CAP;
+/** `find_context_errors` — findings per call by default, and the display caps. */
+const FINDINGS_DEFAULT = 10;
+exports.FINDINGS_DEFAULT = FINDINGS_DEFAULT;
+const FINDING_MESSAGE_CHARS = 300;
+exports.FINDING_MESSAGE_CHARS = FINDING_MESSAGE_CHARS;
+const FINDING_SUBJECT_CAP = 6;
+exports.FINDING_SUBJECT_CAP = FINDING_SUBJECT_CAP;
+const FINDING_WITNESS_CAP = 6;
+exports.FINDING_WITNESS_CAP = FINDING_WITNESS_CAP;
+/** Disposition rows printed. Real packs register ~3; the cap is a fence. */
+const DISPOSITION_ROW_CAP = 12;
+exports.DISPOSITION_ROW_CAP = DISPOSITION_ROW_CAP;
+/** Checks named in the partial-coverage headline before it says "and N more". */
+const SILENT_CHECK_NAME_CAP = 4;
+exports.SILENT_CHECK_NAME_CAP = SILENT_CHECK_NAME_CAP;
+/** Result preview for `inspect_tool_call` (its own dial: results are the answer). */
+const TOOL_RESULT_PREVIEW_CHARS = 400;
+exports.TOOL_RESULT_PREVIEW_CHARS = TOOL_RESULT_PREVIEW_CHARS;
+/** Schemas embed an `enum` of valid ids/keys only when the set is small —
+ *  free #9 validation without bloating the tools block on long runs. */
+const SCHEMA_ENUM_CAP = 48;
+exports.SCHEMA_ENUM_CAP = SCHEMA_ENUM_CAP;
+// ── inspect_subflow ────────────────────────────────────────────────────────
+/** How many mounts a correction names. */
+const MOUNT_SUGGESTION_CAP = 8;
+exports.MOUNT_SUGGESTION_CAP = MOUNT_SUGGESTION_CAP;
+//# sourceMappingURL=structuralLimits.js.map

package/dist/trace-toolpack/traceToolpack/structuralLimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuralLimits.js","sourceRoot":"","sources":["../../../src/trace-toolpack/traceToolpack/structuralLimits.ts"],"names":[],"mappings":";AAAA,6EAA6E;;;AAE7E,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAoE5B,gDAAkB;AAlEpB,MAAM,gBAAgB,GAAG,EAAE,CAAC;AAmE1B,4CAAgB;AAjElB,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAkE5B,gDAAkB;AAhEpB,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAiEnC,4DAAwB;AA/D1B,MAAM,cAAc,GAAG,EAAE,CAAC;AAgExB,wCAAc;AA9DhB,MAAM,aAAa,GAAG,EAAE,CAAC;AA+DvB,sCAAa;AA7Df,MAAM,uBAAuB,GAAG,GAAG,CAAC;AA8DlC,0DAAuB;AA5DzB,MAAM,yBAAyB,GAAG,CAAC,CAAC;AA6DlC,8DAAyB;AA3D3B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AA4D5B,gDAAkB;AA1DpB,gFAAgF;AAChF,MAAM,iBAAiB,GAAG,EAAE,CAAC;AA0D3B,8CAAiB;AAxDnB,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAyD7B,oDAAoB;AAvDtB,MAAM,oBAAoB,GAAG,GAAG,CAAC;AAwD/B,oDAAoB;AAtDtB,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAuD7B,kDAAmB;AArDrB;;;;GAIG;AACH,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAiD5B,4CAAgB;AA/ClB,8EAA8E;AAC9E,MAAM,wBAAwB,GAAG,EAAE,CAAC;AA+ClC,4DAAwB;AA7C1B,4EAA4E;AAC5E,MAAM,wBAAwB,GAAG,EAAE,CAAC;AA6ClC,4DAAwB;AA3C1B,kFAAkF;AAClF,MAAM,gBAAgB,GAAG,EAAE,CAAC;AA2C1B,4CAAgB;AAzClB,MAAM,qBAAqB,GAAG,GAAG,CAAC;AA0ChC,sDAAqB;AAxCvB,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAyC5B,kDAAmB;AAvCrB,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAwC5B,kDAAmB;AAtCrB,4EAA4E;AAC5E,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAsC7B,kDAAmB;AApCrB,iFAAiF;AACjF,MAAM,qBAAqB,GAAG,CAAC,CAAC;AAoC9B,sDAAqB;AAlCvB,qFAAqF;AACrF,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAkCpC,8DAAyB;AAhC3B;wEACwE;AACxE,MAAM,eAAe,GAAG,EAAE,CAAC;AA+BzB,0CAAe;AA7BjB,8EAA8E;AAE9E,0CAA0C;AAC1C,MAAM,oBAAoB,GAAG,CAAC,CAAC;AA2B7B,oDAAoB"}

package/dist/trace-toolpack/traceToolpack/toolCallJournal.js

@@ -0,0 +1,388 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildInspectToolCall = exports.buildToolCallReader = void 0;
+const valueLines_js_1 = require("./valueLines.js");
+const foottrace_1 = require("foottrace");
+const tools_js_1 = require("../../tools/tools.js");
+const structuralLimits_js_1 = require("./structuralLimits.js");
+const bounded_js_1 = require("../bounded.js");
+/** A recorded `notDispatched` value read as the marker — `undefined` unless it is an object. */
+function markerOf(found) {
+    return typeof found === 'object' && found !== null ? found : undefined;
+}
+/**
+ * Resolve ONE tool call across the four places its evidence lives.
+ *
+ * A tool call is the most-asked-about thing in an agent run and the most
+ * scattered: the model's PROPOSED args are on an assistant turn, the args
+ * it actually RAN with are in the middleware ledger (and only when a rule
+ * changed them), the result is a `role:'tool'` turn, and the timing exists
+ * only in the event stream. Four lookups, one id — so this reader does the
+ * join rather than making the model do it in four calls.
+ *
+ * The proposed/ran-with split is the point. A governance rule that
+ * rewrites args is invisible in the conversation: the model reads its own
+ * proposal in history and the tool ran on something else. That difference
+ * is exactly what "why did it do that?" is often asking about.
+ */
+function buildToolCallReader(artifacts, index) {
+    // All four readers are lazy + memoized: a toolpack that never inspects a
+    // tool call pays nothing, and one that inspects five pays once.
+    let historyMemo;
+    const history = () => {
+        if (historyMemo === undefined) {
+            const value = (0, valueLines_js_1.committedFinal)(index, 'history');
+            historyMemo = Array.isArray(value) ? value : [];
+        }
+        return historyMemo;
+    };
+    let ledgerMemo;
+    const ledger = () => {
+        if (ledgerMemo === undefined) {
+            const value = (0, valueLines_js_1.committedFinal)(index, 'middlewareDecisions');
+            ledgerMemo = Array.isArray(value) ? value : [];
+        }
+        return ledgerMemo;
+    };
+    const eventsOf = (type) => (artifacts.events ?? [])
+        .filter((event) => event.type === type)
+        .map((event) => ({
+        payload: (event.payload ?? {}),
+        meta: (event.meta ?? {}),
+    }));
+    /**
+     * One call's brackets of one kind, those of a call that RAN first (9.113.0).
+     * A settled bracket (`notDispatched`) is no record of a run, so when a
+     * provider reused a settled call's id for a call that did run, the STEP is
+     * read off the call that ran — never off the settlement's bracket, which
+     * stands on the resume step. Tail order within each group, so a tail with
+     * no settled bracket reads exactly as it always did. (The outcome and the
+     * duration read the LAST `tool_end` for the id instead — see
+     * `buildInspectToolCall`.)
+     */
+    const bracketsFor = (type, toolCallId) => {
+        const mine = eventsOf(type).filter((event) => event.payload.toolCallId === toolCallId);
+        const settled = (event) => markerOf(event.payload.notDispatched) !== undefined;
+        return [...mine.filter((event) => !settled(event)), ...mine.filter(settled)];
+    };
+    /** Every tool call id this run recorded, in call order, with its name. */
+    let idsMemo;
+    const knownCalls = () => {
+        if (idsMemo !== undefined)
+            return idsMemo;
+        const byId = new Map();
+        for (const start of eventsOf('agentfootprint.stream.tool_start')) {
+            const id = start.payload.toolCallId;
+            if (typeof id === 'string')
+                byId.set(id, String(start.payload.toolName ?? '?'));
+        }
+        for (const turn of history()) {
+            for (const call of turn.toolCalls ?? []) {
+                if (typeof call.id === 'string' && !byId.has(call.id)) {
+                    byId.set(call.id, call.name ?? '?');
+                }
+            }
+            if (typeof turn.toolCallId === 'string' && !byId.has(turn.toolCallId)) {
+                byId.set(turn.toolCallId, turn.toolName ?? '?');
+            }
+        }
+        idsMemo = [...byId].map(([id, name]) => ({ id, name }));
+        return idsMemo;
+    };
+    /**
+     * Which STEP ran this call. The event tail knows exactly (every event is
+     * stamped with its `runtimeStageId`) — a call that RAN before a settlement
+     * under the same id (`bracketsFor`); without it, fall back to the first
+     * committed step whose `history` carries the call's result — that is the
+     * tool-execution step by construction.
+     */
+    const stepFor = (toolCallId) => {
+        for (const start of bracketsFor('agentfootprint.stream.tool_start', toolCallId)) {
+            const id = start.meta.runtimeStageId;
+            if (typeof id === 'string')
+                return { id, inferred: false };
+        }
+        for (let i = 0; i < index.commitLog.length; i++) {
+            const bundle = index.commitLog[i];
+            if (!bundle.trace.some((entry) => entry.path === 'history'))
+                continue;
+            const value = (0, foottrace_1.commitValueAt)(index.commitLog, i, 'history');
+            if (!Array.isArray(value))
+                continue;
+            const landed = value.some((turn) => turn.role === 'tool' && turn.toolCallId === toolCallId);
+            if (landed)
+                return { id: bundle.runtimeStageId, inferred: true };
+        }
+        return { inferred: true };
+    };
+    /**
+     * The settlement marker on the LATEST `role: 'tool'` message for the id in
+     * `turns` — `undefined` when that message carries none — and whether any
+     * message answered the id at all. The latest decides, as it decides the
+     * result: a provider may reuse an id across turns.
+     */
+    const settledIn = (turns, toolCallId) => {
+        let answered = false;
+        let marker;
+        for (const turn of turns) {
+            if (turn.role !== 'tool' || turn.toolCallId !== toolCallId)
+                continue;
+            answered = true;
+            marker = markerOf(turn.notDispatched);
+        }
+        return { answered, ...(marker !== undefined && { marker }) };
+    };
+    /**
+     * The marker on the LATEST bracket for the id on the event tail — the
+     * stream's own owner of the fact (`ToolStartPayload.notDispatched`,
+     * `ToolEndPayload.notDispatched`, 9.113.0). `undefined` when the tail holds
+     * no bracket for the id or the latest one carries no marker: the latest
+     * decides, as it does in history, because a provider may reuse an id.
+     */
+    const settledOnStream = (toolCallId) => {
+        let marker;
+        for (const event of artifacts.events ?? []) {
+            if (event.type !== 'agentfootprint.stream.tool_start' &&
+                event.type !== 'agentfootprint.stream.tool_end') {
+                continue;
+            }
+            const payload = (event.payload ?? {});
+            if (payload.toolCallId !== toolCallId)
+                continue;
+            marker = markerOf(payload.notDispatched);
+        }
+        return marker;
+    };
+    /**
+     * The history's answer: the final history decides when it still holds a
+     * message for the id. When a window has evicted it, the history the call's
+     * OWN step committed still does — that step appended it — so that is where
+     * the marker is read; with no step to read, nothing is said.
+     */
+    const settledInHistory = (toolCallId, stepId) => {
+        const final = settledIn(history(), toolCallId);
+        if (final.answered || stepId === undefined)
+            return final.marker;
+        const at = index.lastIdxOf.get(stepId);
+        if (at === undefined)
+            return undefined;
+        const committed = (0, foottrace_1.commitValueAt)(index.commitLog, at, 'history');
+        return Array.isArray(committed)
+            ? settledIn(committed, toolCallId).marker
+            : undefined;
+    };
+    /**
+     * Was the call NEVER DISPATCHED (9.113.0)? Read off a marker, never the
+     * sentence and never the bracket's `durationMs: 0`. The
+     * bracket's own field first — the event tail answers alone, even for a
+     * history that no longer holds the message — and the history's marker when
+     * the tail is absent or its bracket carries none (a bracket without the
+     * field is silence, not a denial).
+     */
+    const notDispatchedOf = (toolCallId, stepId) => settledOnStream(toolCallId) ?? settledInHistory(toolCallId, stepId);
+    const factsFor = (toolCallId) => {
+        let toolName;
+        let proposedArgs;
+        let result;
+        for (const turn of history()) {
+            for (const call of turn.toolCalls ?? []) {
+                if (call.id === toolCallId) {
+                    toolName = call.name ?? toolName;
+                    proposedArgs = call.args;
+                }
+            }
+            if (turn.role === 'tool' && turn.toolCallId === toolCallId) {
+                toolName = turn.toolName ?? toolName;
+                result = turn.content;
+            }
+        }
+        if (toolName === undefined) {
+            toolName = knownCalls().find((call) => call.id === toolCallId)?.name;
+        }
+        const step = stepFor(toolCallId);
+        const notDispatched = notDispatchedOf(toolCallId, step.id);
+        return {
+            ...(toolName !== undefined && { toolName }),
+            ...(proposedArgs !== undefined && { proposedArgs }),
+            ...(result !== undefined && { result }),
+            ...(step.id !== undefined && { runtimeStageId: step.id }),
+            ...(notDispatched !== undefined && { notDispatched }),
+        };
+    };
+    return {
+        knownCalls,
+        factsFor,
+        history,
+        rowsFor: (toolCallId) => ledger().filter((row) => row.toolCallId === toolCallId),
+        eventsOf,
+    };
+}
+exports.buildToolCallReader = buildToolCallReader;
+/**
+ * The tool over {@link buildToolCallReader}'s join.
+ *
+ * The `toolCallId` param deliberately carries NO schema enum (unlike step
+ * ids): building one would mean reconstructing the whole committed history
+ * at factory time for every toolpack, including the runs that never open
+ * this tool. The corrective message does the same job, on demand.
+ */
+function buildInspectToolCall(artifacts, reader) {
+    const { knownCalls, factsFor, history, rowsFor, eventsOf } = reader;
+    return (0, tools_js_1.defineTool)({
+        name: 'inspect_tool_call',
+        description: 'Resolve ONE tool call end to end: which tool, the arguments the model proposed, the ' +
+            'arguments it actually ran with (they differ when a governance rule rewrote them), the ' +
+            'bounded result, the outcome (ok / error / denied / paused), how long it took, and the ' +
+            'step id that ran it. Use it whenever the question is about something a tool did — it ' +
+            'joins four records that otherwise take four calls to read.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                toolCallId: {
+                    type: 'string',
+                    description: "The tool call's id, e.g. 'call_01'. Ids appear in trace_node on the tool step, " +
+                        'in the narrative, and in find_in_trace hits.',
+                },
+            },
+            required: ['toolCallId'],
+            additionalProperties: false,
+        },
+        execute: ({ toolCallId }) => {
+            const calls = knownCalls();
+            if (!calls.some((call) => call.id === toolCallId)) {
+                if (calls.length === 0) {
+                    return (`unknown toolCallId '${toolCallId}' — this run recorded NO tool calls at all. ` +
+                        (artifacts.events === undefined && history().length === 0
+                            ? '⚠ it also carries no committed conversation history and no event tail, so a ' +
+                                'tool call could not be seen even if one happened. '
+                            : '') +
+                        'Call run_overview to see what the run did do.');
+                }
+                const sample = calls
+                    .slice(0, structuralLimits_js_1.TOOL_CALL_SUGGESTION_CAP)
+                    .map((call) => `${call.id} (${call.name})`)
+                    .join(', ');
+                return (`unknown toolCallId '${toolCallId}'. This run recorded ${calls.length} tool call(s): ` +
+                    `${sample}${calls.length > structuralLimits_js_1.TOOL_CALL_SUGGESTION_CAP ? ', …' : ''}. Retry with one of ` +
+                    `those ids.`);
+            }
+            const facts = factsFor(toolCallId);
+            const lines = [`TOOL CALL ${toolCallId} — ${facts.toolName ?? '(unnamed tool)'}`];
+            lines.push(facts.runtimeStageId !== undefined
+                ? `step: ${facts.runtimeStageId} — drill with trace_node('${facts.runtimeStageId}')`
+                : `step: ⚠ not resolvable — no event tail, and no committed step carries the result ` +
+                    `of call '${toolCallId}' (the turn may have ended before it landed).`);
+            lines.push(facts.proposedArgs !== undefined
+                ? `proposed by the model: ${(0, bounded_js_1.displayText)((0, bounded_js_1.renderPreview)((0, bounded_js_1.boundedPreview)(facts.proposedArgs, structuralLimits_js_1.TOOL_RESULT_PREVIEW_CHARS)))}`
+                : `proposed by the model: ⚠ not recorded — the assistant turn carrying call ` +
+                    `'${toolCallId}' is not in the committed history (a window strategy may have ` +
+                    `folded it away).`);
+            // A call the paused batch never dispatched (9.113.0) ran with nothing,
+            // has no outcome of its own, no duration and no inside. Read off the
+            // settlement marker (`notDispatchedOf`), each line a past fact anchored
+            // to the call by id. Its `tool_end` is the settlement's bracket
+            // (`durationMs: 0`, the sentence as `result`), never the record of a
+            // tool that ran — read as one, it would be an `ok` in 0ms.
+            const settled = facts.notDispatched;
+            // Ran-with args: the ledger is the ONLY record of a rule rewriting
+            // them. No ledger row means no rule changed anything — say that
+            // plainly rather than leaving the reader to assume it.
+            const rows = rowsFor(toolCallId);
+            const rewrite = [...rows]
+                .reverse()
+                .find((row) => row.changed === true && row.moment === 'before-tool');
+            if (settled !== undefined) {
+                lines.push(`ran with: nothing — call '${toolCallId}' was never executed.`);
+            }
+            else if (rewrite) {
+                lines.push(`ran with: ${(0, bounded_js_1.displayText)((0, bounded_js_1.renderPreview)((0, bounded_js_1.boundedPreview)(rewrite.after, structuralLimits_js_1.TOOL_RESULT_PREVIEW_CHARS)))} — CHANGED at before-tool by '${rewrite.middleware ?? '?'}'` +
+                    (rewrite.why ? `: "${rewrite.why}"` : '') +
+                    '. The model proposed the line above; the tool ran on this one.');
+            }
+            else if (rows.length > 0) {
+                lines.push('ran with: the proposed arguments, unchanged (rules looked and allowed them).');
+            }
+            else {
+                lines.push(`ran with: the proposed arguments — no governance rule filed a row for call ` +
+                    `'${toolCallId}'.`);
+            }
+            lines.push(facts.result !== undefined
+                ? `result: ${(0, bounded_js_1.displayText)((0, bounded_js_1.renderPreview)((0, bounded_js_1.boundedPreview)(facts.result, structuralLimits_js_1.TOOL_RESULT_PREVIEW_CHARS), `get_value('${facts.runtimeStageId ?? '<step>'}', 'history') for the full turn`))}`
+                : `result: ⚠ no result recorded for call '${toolCallId}' in the committed history — ` +
+                    `it may have been denied before it ran, or the turn ended (paused/failed) before ` +
+                    `it landed.`);
+            // Outcome + duration: the event tail is the only clock a run has. Read
+            // off the LAST `tool_end` for the id — the call the result line shows,
+            // since a provider may reuse an id and the latest message decides the
+            // result. After a settlement that is the call that ran under the id
+            // again; a settled call itself never reaches these lines (`settled`).
+            const denial = rows.find((row) => row.outcome === 'deny');
+            const end = eventsOf('agentfootprint.stream.tool_end')
+                .reverse()
+                .find((event) => event.payload.toolCallId === toolCallId);
+            const checkIn = eventsOf('agentfootprint.checkin.request').some((event) => event.payload.toolCallId === toolCallId);
+            const invalid = eventsOf('agentfootprint.validation.args_invalid').some((event) => event.payload.toolCallId === toolCallId);
+            let outcome;
+            if (settled !== undefined) {
+                outcome =
+                    `not dispatched — the run paused on call '${settled.pausedCall?.toolCallId ?? '?'}' ` +
+                        `to '${settled.pausedCall?.toolName ?? '?'}', earlier in the same batch, and resumed ` +
+                        `without executing call '${toolCallId}'`;
+            }
+            else if (denial) {
+                outcome = `denied by '${denial.middleware ?? '?'}'${denial.why ? `: "${denial.why}"` : ''}`;
+            }
+            else if (end?.payload.error === true) {
+                outcome = 'error — the tool threw or returned a failure';
+            }
+            else if (checkIn && end === undefined) {
+                outcome = `paused — a check-in asked a human and call '${toolCallId}' has no recorded end`;
+            }
+            else if (facts.result !== undefined) {
+                outcome = 'ok';
+            }
+            else {
+                outcome = '⚠ unknown — no ledger row, no result, no end event';
+            }
+            lines.push(`outcome: ${outcome}`);
+            if (invalid) {
+                // Anchored to the call by ID, not by "this call" (9.86.0): the line
+                // lands in a tool result, and a model re-reading it three calls later
+                // resolves "this call" to whichever call it is answering then.
+                lines.push(`⚠ the arguments failed schema validation on call '${toolCallId}' — see the ` +
+                    `validation event / the tool result, which carries the correction the model was ` +
+                    `given.`);
+            }
+            if (settled !== undefined) {
+                lines.push(`duration: none — call '${toolCallId}' was never executed.`);
+            }
+            else if (artifacts.events === undefined) {
+                lines.push(`duration: ⚠ unavailable — these artifacts carry no event tail. The commit log records ` +
+                    `what each step WROTE and has no clock; timings live only in the event stream.`);
+            }
+            else if (end !== undefined && typeof end.payload.durationMs === 'number') {
+                lines.push(`duration: ${end.payload.durationMs}ms`);
+            }
+            else {
+                lines.push(`duration: ⚠ no tool_end event for call '${toolCallId}' in the retained tail (it may ` +
+                    `have been dropped by the tail cap, or the call never finished).`);
+            }
+            // THE DESCENT RUNG. The boundary marker below is honest for a tool
+            // that called someone else's system, and needlessly honest for one
+            // that kept its own record — so when a record exists the line that
+            // says "not traced" is replaced by the call that opens it. One line,
+            // and it teaches the id it takes: the SAME toolCallId, one level down.
+            const inner = artifacts.innerRuns?.get(toolCallId);
+            lines.push(settled !== undefined
+                ? `inside: nothing — call '${toolCallId}' never reached the tool.`
+                : inner !== undefined
+                    ? `inside: this tool kept its own record of the run — ${inner.steps} step(s), ` +
+                        `${inner.outcome}. Descend with inspect_tool_run({ toolCallId: '${toolCallId}' }).`
+                    : '⚠ boundary: what happened INSIDE the tool is not traced — this is the envelope ' +
+                        '(arguments in, result out) plus what the run itself decided about it.');
+            return lines.join('\n');
+        },
+    });
+}
+exports.buildInspectToolCall = buildInspectToolCall;
+//# sourceMappingURL=toolCallJournal.js.map

package/dist/trace-toolpack/traceToolpack/toolCallJournal.js.map

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

package/dist/trace-toolpack/traceToolpack/valueLines.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.committedFinal = exports.truncateText = exports.untrackedSourcesOf = exports.basisLines = exports.honestyLine = exports.redactionNote = void 0;
+const foottrace_1 = require("foottrace");
+/** Is `path` redacted in any bundle of this step (or, keyless, of the writer)? */
+function redactionNote(bundles, path) {
+    const redacted = (bundles ?? []).some((b) => b.redactedPaths.includes(path));
+    return redacted ? ' (redacted by policy)' : '';
+}
+exports.redactionNote = redactionNote;
+/**
+ * A footprintjs reason code as the toolpack prints it. The FIRST time a code appears in this
+ * toolpack instance it is `⚠ <code>: <sentence>` — the sentence is footprintjs's own
+ * (`HONESTY_CODES` on `foottrace`), this pack keeps no copy — and every later time the
+ * bare `⚠ <code>`: the sentence is already in the model's context, and repeating it on every
+ * answer is pure token cost.
+ */
+function honestyLine(index, code) {
+    if (index.explained.has(code))
+        return `⚠ ${code}`;
+    index.explained.add(code);
+    return `⚠ ${code}: ${foottrace_1.HONESTY_CODES[code]}`;
+}
+exports.honestyLine = honestyLine;
+/** One `honestyLine` per distinct code, each on its own line after `\n`; '' when exact. */
+function basisLines(index, codes) {
+    return [...new Set(codes)].map((code) => `\n${honestyLine(index, code)}`).join('');
+}
+exports.basisLines = basisLines;
+/** Union of untracked sources across a step's bundles. */
+function untrackedSourcesOf(bundles) {
+    const set = new Set();
+    for (const bundle of bundles ?? []) {
+        for (const source of bundle.untrackedSources ?? [])
+            set.add(source);
+    }
+    return [...set];
+}
+exports.untrackedSourcesOf = untrackedSourcesOf;
+function truncateText(text, cap) {
+    return text.length > cap ? `${text.slice(0, cap)}…` : text;
+}
+exports.truncateText = truncateText;
+/**
+ * The final COMMITTED view of a key — reconstructed from the commit log,
+ * never read off `snapshot.sharedState`.
+ *
+ * That distinction is the whole redaction contract: `sharedState` is the
+ * run's LIVE state (unredacted by construction), while the commit log
+ * carries what footprintjs scrubbed at commit time. Everything in this
+ * file that serves a VALUE goes through here or through `commitValueAt`
+ * directly; `sharedState` is read for key NAMES only.
+ */
+function committedFinal(index, path) {
+    if (index.commitLog.length === 0)
+        return undefined;
+    return (0, foottrace_1.commitValueAt)(index.commitLog, index.commitLog.length - 1, path);
+}
+exports.committedFinal = committedFinal;
+//# sourceMappingURL=valueLines.js.map

package/dist/trace-toolpack/traceToolpack/valueLines.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueLines.js","sourceRoot":"","sources":["../../../src/trace-toolpack/traceToolpack/valueLines.ts"],"names":[],"mappings":";;;AAEA,yCAAyD;AAEzD,kFAAkF;AAClF,SAAS,aAAa,CAAC,OAA4C,EAAE,IAAY;IAC/E,MAAM,QAAQ,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,OAAO,QAAQ,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAgDQ,sCAAa;AA9CtB;;;;;;GAMG;AACH,SAAS,WAAW,CAAC,KAAoB,EAAE,IAAiB;IAC1D,IAAI,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,IAAI,EAAE,CAAC;IAClD,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,KAAK,IAAI,KAAK,yBAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AAC7C,CAAC;AAmCuB,kCAAW;AAjCnC,2FAA2F;AAC3F,SAAS,UAAU,CAAC,KAAoB,EAAE,KAA6B;IACrE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACrF,CAAC;AA8BoC,gCAAU;AA5B/C,0DAA0D;AAC1D,SAAS,kBAAkB,CAAC,OAA4C;IACtE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,OAAO,IAAI,EAAE,EAAE,CAAC;QACnC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,gBAAgB,IAAI,EAAE;YAAE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC;AAClB,CAAC;AAqBgD,gDAAkB;AAnBnE,SAAS,YAAY,CAAC,IAAY,EAAE,GAAW;IAC7C,OAAO,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAiBoE,oCAAY;AAfjF;;;;;;;;;GASG;AACH,SAAS,cAAc,CAAC,KAAoB,EAAE,IAAY;IACxD,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACnD,OAAO,IAAA,yBAAa,EAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC;AAC1E,CAAC;AAEkF,wCAAc"}