agentfootprint 13.0.0 → 14.0.0

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

@@ -0,0 +1,133 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTraceNode = void 0;
+const tools_js_1 = require("../../tools/tools.js");
+const parameterSchemas_js_1 = require("./parameterSchemas.js");
+const navigationHints_js_1 = require("./navigationHints.js");
+const packIndex_js_1 = require("./packIndex.js");
+const structuralLimits_js_1 = require("./structuralLimits.js");
+const bounded_js_1 = require("../bounded.js");
+const foottrace_1 = require("foottrace");
+const valueLines_js_1 = require("./valueLines.js");
+// ── trace_node ─────────────────────────────────────────────────────────────
+function buildTraceNode(artifacts, index, opts) {
+    return (0, tools_js_1.defineTool)({
+        name: 'trace_node',
+        description: 'Inspect ONE execution step by runtimeStageId: name + description, what it wrote ' +
+            '(bounded previews + true sizes), what it read, its parents (which step provided each ' +
+            'input, plus the decision that routed to it when known), errors, and ⚠ honesty markers. ' +
+            'The drill-down primitive — use ids from run_overview, trace_slice, or who_wrote.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                runtimeStageId: (0, parameterSchemas_js_1.idProperty)(index, "The step to inspect, e.g. 'normalize#0'."),
+            },
+            required: ['runtimeStageId'],
+            additionalProperties: false,
+        },
+        execute: ({ runtimeStageId }) => {
+            const node = index.nodes.get(runtimeStageId);
+            const bundles = index.bundlesOf.get(runtimeStageId);
+            if (!node && !bundles)
+                return (0, navigationHints_js_1.unknownIdMessage)(runtimeStageId, index);
+            const lines = [];
+            const flags = [
+                node?.isDecider ? ' [decision]' : '',
+                node?.subflowId ? ' [subflow]' : '',
+            ].join('');
+            const name = node?.name ?? bundles?.[0]?.stage ?? (0, packIndex_js_1.stagePartOf)(runtimeStageId);
+            lines.push(`STEP ${runtimeStageId} — "${name}"${flags}`);
+            if (node?.description)
+                lines.push(`description: ${node.description}`);
+            if (node?.subflowId && index.subflowDoor)
+                lines.push((0, navigationHints_js_1.mountLine)(index, runtimeStageId));
+            // Writes — verb-aware values via commitValueAt (delta-mode safe).
+            const writes = new Map(); // path → verb (last wins)
+            for (const bundle of bundles ?? []) {
+                for (const entry of bundle.trace)
+                    writes.set(entry.path, entry.verb);
+            }
+            if (writes.size === 0) {
+                lines.push('wrote: nothing committed');
+            }
+            else {
+                lines.push(`wrote (${writes.size}):`);
+                const lastIdx = index.lastIdxOf.get(runtimeStageId) ?? index.commitLog.length - 1;
+                let shown = 0;
+                for (const [path, verb] of writes) {
+                    if (shown >= structuralLimits_js_1.NODE_WRITE_CAP) {
+                        lines.push(`…and ${writes.size - structuralLimits_js_1.NODE_WRITE_CAP} more keys (output capped)`);
+                        break;
+                    }
+                    const preview = (0, bounded_js_1.boundedPreview)((0, foottrace_1.commitValueAt)(index.commitLog, lastIdx, path), opts.previewChars);
+                    const dotted = (0, bounded_js_1.displayKey)(path);
+                    lines.push(`- ${dotted} (${verb}): ${(0, bounded_js_1.displayText)((0, bounded_js_1.renderPreview)(preview, `get_value('${runtimeStageId}', '${dotted}') for full`))}${(0, valueLines_js_1.redactionNote)(bundles, path)}`);
+                    shown++;
+                }
+            }
+            // Reads + parents.
+            const reads = node?.stageReads ? Object.keys(node.stageReads) : [];
+            if (reads.length === 0) {
+                lines.push(index.hasReadTracking
+                    ? 'read: no tracked reads recorded'
+                    : 'read: no tracked reads recorded ⚠ (artifacts carry no read tracking)');
+            }
+            else {
+                const shownReads = reads.slice(0, structuralLimits_js_1.NODE_READ_CAP).map(bounded_js_1.displayKey).join(', ');
+                lines.push(`read (${reads.length}): ${shownReads}${reads.length > structuralLimits_js_1.NODE_READ_CAP ? ', … (output capped)' : ''}`);
+            }
+            const parentLines = [];
+            const parentCodes = [];
+            const anchorIdx = (0, packIndex_js_1.anchorIdxFor)(runtimeStageId, index);
+            for (const key of reads.slice(0, structuralLimits_js_1.NODE_READ_CAP)) {
+                const { writer, basis } = (0, foottrace_1.findLastWriterWithBasis)(index.commitLog, key, anchorIdx);
+                parentLines.push(writer
+                    ? `- data: ${(0, bounded_js_1.displayKey)(key)} ← ${writer.runtimeStageId} "${writer.stage}"` +
+                        (basis.length > 0 ? ` ⚠ ${basis.join(', ')}` : '')
+                    : `- data: ${(0, bounded_js_1.displayKey)(key)} ← (no tracked writer ⚠ ${basis.join(', ')})`);
+                parentCodes.push(...basis);
+            }
+            const controlDep = artifacts.controlDeps?.(runtimeStageId);
+            if (controlDep) {
+                parentLines.push(`- control: routed here by ${controlDep.deciderId}` +
+                    (controlDep.label ? ` — rule "${controlDep.label}"` : ''));
+            }
+            if (parentLines.length > 0) {
+                lines.push('parents:');
+                lines.push(...parentLines);
+                for (const code of new Set(parentCodes))
+                    lines.push((0, valueLines_js_1.honestyLine)(index, code));
+            }
+            if (!artifacts.controlDeps) {
+                lines.push('⚠ control-dependence lookup not provided — the decision that routed here is unknown.');
+            }
+            const untracked = (0, valueLines_js_1.untrackedSourcesOf)(bundles);
+            if (untracked.length > 0) {
+                lines.push(`⚠ this step also consumed ${untracked.join('/')} — NOT in the parents list. ` +
+                    (0, valueLines_js_1.honestyLine)(index, 'incomplete-sources'));
+            }
+            // The tool boundary, named honestly: the agent chart's tool-execution
+            // stage runs CONSUMER code (DB calls, services). The trace records the
+            // envelope — args in, results out — never the internals. Gated on the
+            // agent-chart signature (a call-llm stage exists) so a generic chart
+            // with a coincidental 'tool-calls' stage gets no false marker.
+            const isAgentChart = [...index.idsByStagePart.keys()].some((part) => part.split('/').pop() === 'call-llm');
+            if (isAgentChart && (0, packIndex_js_1.stagePartOf)(runtimeStageId).split('/').pop() === 'tool-calls') {
+                lines.push('⚠ boundary: tool execution happens in consumer systems — the trace records ' +
+                    'arguments in / results out; tool internals are not traced unless the tool ' +
+                    'returns its own diagnostic refs.');
+            }
+            const errorKeys = Object.keys(node?.errors ?? {});
+            if (errorKeys.length > 0) {
+                lines.push(`errors (${errorKeys.length}):`);
+                for (const key of errorKeys.slice(0, structuralLimits_js_1.OVERVIEW_ERROR_CAP)) {
+                    const preview = (0, bounded_js_1.boundedPreview)((node?.errors ?? {})[key], opts.previewChars);
+                    lines.push(`- ⚠ ${key}: ${(0, bounded_js_1.displayText)((0, bounded_js_1.renderPreview)(preview))}`);
+                }
+            }
+            return lines.join('\n');
+        },
+    });
+}
+exports.buildTraceNode = buildTraceNode;
+//# sourceMappingURL=nodeView.js.map

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

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

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

@@ -0,0 +1,160 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.anchorIdxFor = exports.buildIndex = exports.stagePartOf = void 0;
+const artifactFacts_js_1 = require("./artifactFacts.js");
+const subflowRecords_js_1 = require("../subflowRecords.js");
+function stagePartOf(runtimeStageId) {
+    const hash = runtimeStageId.lastIndexOf('#');
+    return hash > 0 ? runtimeStageId.slice(0, hash) : runtimeStageId;
+}
+exports.stagePartOf = stagePartOf;
+function buildIndex(artifacts) {
+    const commitLog = artifacts.snapshot.commitLog ?? [];
+    const firstIdxOf = new Map();
+    const lastIdxOf = new Map();
+    const bundlesOf = new Map();
+    const knownPaths = new Set();
+    let untrackedStepCount = 0;
+    for (let i = 0; i < commitLog.length; i++) {
+        const bundle = commitLog[i];
+        const id = bundle.runtimeStageId;
+        if (!firstIdxOf.has(id))
+            firstIdxOf.set(id, i);
+        lastIdxOf.set(id, i);
+        const list = bundlesOf.get(id);
+        if (list)
+            list.push(bundle);
+        else {
+            bundlesOf.set(id, [bundle]);
+            if (bundle.untrackedSources && bundle.untrackedSources.length > 0)
+                untrackedStepCount++;
+        }
+        for (const entry of bundle.trace)
+            knownPaths.add(entry.path);
+    }
+    const subflowDoor = !artifactFacts_js_1.WITHOUT_SUBFLOW_DOOR.has(artifacts);
+    const subflowResults = subflowDoor ? (0, subflowRecords_js_1.subflowResultsOf)(artifacts.snapshot) : undefined;
+    const homes = new Map();
+    // Walk the execution tree: node → children → next (≈ execution order).
+    const nodes = new Map();
+    const orderedIds = [];
+    const errorSteps = [];
+    let hasReadTracking = false;
+    const visit = (node) => {
+        if (!node)
+            return;
+        const id = node.runtimeStageId;
+        if (id && !nodes.has(id)) {
+            nodes.set(id, node);
+            orderedIds.push(id);
+            if (node.stageReads && Object.keys(node.stageReads).length > 0)
+                hasReadTracking = true;
+            const errorKeys = Object.keys(node.errors ?? {});
+            if (errorKeys.length > 0)
+                errorSteps.push({ id, keys: errorKeys });
+        }
+        for (const child of node.children ?? [])
+            visit(child);
+        visit(node.next);
+    };
+    visit(artifacts.snapshot.executionTree);
+    // Steps present in the commit log but missing from the tree. A subflow's own
+    // log opens with its MOUNT's seed commit, which its tree does not hold — so
+    // an id that committed before the tree's first step goes FIRST, not last.
+    const treeFirstIdx = firstIdxOf.get(orderedIds[0] ?? '') ?? Infinity;
+    const before = [];
+    for (const id of bundlesOf.keys()) {
+        if (nodes.has(id))
+            continue;
+        if ((firstIdxOf.get(id) ?? Infinity) < treeFirstIdx)
+            before.push(id);
+        else
+            orderedIds.push(id);
+    }
+    orderedIds.unshift(...before);
+    const idsByStagePart = new Map();
+    const groupsByStagePart = new Map();
+    const groups = [];
+    for (const id of orderedIds) {
+        const stagePart = stagePartOf(id);
+        const ids = idsByStagePart.get(stagePart);
+        if (ids)
+            ids.push(id);
+        else
+            idsByStagePart.set(stagePart, [id]);
+        let group = groupsByStagePart.get(stagePart);
+        if (!group) {
+            group = { stagePart, ids: [], isDecider: false, isSubflow: false, errorIds: [] };
+            groupsByStagePart.set(stagePart, group);
+            groups.push(group);
+        }
+        group.ids.push(id);
+        const node = nodes.get(id);
+        if (node) {
+            if (group.name === undefined && node.name !== undefined)
+                group.name = node.name;
+            if (group.description === undefined && node.description !== undefined) {
+                group.description = node.description;
+            }
+            if (node.isDecider)
+                group.isDecider = true;
+            if (node.subflowId !== undefined)
+                group.isSubflow = true;
+            if (Object.keys(node.errors ?? {}).length > 0)
+                group.errorIds.push(id);
+        }
+        else {
+            const bundle = bundlesOf.get(id)?.[0];
+            if (group.name === undefined && bundle)
+                group.name = bundle.stage;
+        }
+    }
+    return {
+        commitLog,
+        firstIdxOf,
+        lastIdxOf,
+        bundlesOf,
+        nodes,
+        orderedIds,
+        idsByStagePart,
+        knownPaths,
+        groups,
+        hasReadTracking,
+        errorSteps,
+        untrackedStepCount,
+        initialState: artifacts.snapshot.initialState,
+        explained: new Set(),
+        subflowResults,
+        subflowDoor,
+        homeMountOf: (id) => {
+            if (subflowResults === undefined)
+                return undefined;
+            if (!homes.has(id))
+                homes.set(id, (0, subflowRecords_js_1.homeMountOf)(subflowResults, id));
+            return homes.get(id);
+        },
+    };
+}
+exports.buildIndex = buildIndex;
+/**
+ * Commit-log anchor for "strictly before this step" lookups. Committed steps
+ * anchor at their own first bundle. A step with no commit (defensive — every
+ * executed stage normally records at least an empty bundle) anchors at the
+ * next committed step in execution order.
+ */
+function anchorIdxFor(runtimeStageId, index) {
+    const own = index.firstIdxOf.get(runtimeStageId);
+    if (own !== undefined)
+        return own;
+    const position = index.orderedIds.indexOf(runtimeStageId);
+    if (position >= 0) {
+        for (let i = position + 1; i < index.orderedIds.length; i++) {
+            const idx = index.firstIdxOf.get(index.orderedIds[i]);
+            if (idx !== undefined)
+                return idx;
+        }
+    }
+    return index.commitLog.length;
+}
+exports.anchorIdxFor = anchorIdxFor;
+//# sourceMappingURL=packIndex.js.map

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

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

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

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.keyProperty = exports.idProperty = void 0;
+const structuralLimits_js_1 = require("./structuralLimits.js");
+const subflowRecords_js_1 = require("../subflowRecords.js");
+const bounded_js_1 = require("../bounded.js");
+// ── Schema fragments ───────────────────────────────────────────────────────
+function idProperty(index, description) {
+    const property = { type: 'string', description };
+    // No enum when subflows kept their own logs: the model may then hold an
+    // INNER id, and it is owed the correction toward `inspect_subflow` that only
+    // `execute` can give — a schema refusal would read as "no such step".
+    if (index.orderedIds.length > 0 &&
+        index.orderedIds.length <= structuralLimits_js_1.SCHEMA_ENUM_CAP &&
+        !hasMountLogs(index)) {
+        property.enum = index.orderedIds;
+    }
+    return property;
+}
+exports.idProperty = idProperty;
+/** True when at least one subflow mount kept its own log in this snapshot. */
+function hasMountLogs(index) {
+    const results = index.subflowResults;
+    return (results !== undefined && Object.keys(results).some((key) => (0, subflowRecords_js_1.innerCommitCount)(results, key) > 0));
+}
+/**
+ * Key params get guidance (known keys in the description) but NO enum:
+ * unlike step ids — whose universe is complete — a key OUTSIDE the commit
+ * log is a legitimate question with an honest answer ("args/env/pre-run
+ * values never enter the commit log ⚠"), and an enum would block that path.
+ */
+function keyProperty(index, description) {
+    let hint = '';
+    if (index.knownPaths.size > 0 && index.knownPaths.size <= structuralLimits_js_1.SCHEMA_ENUM_CAP) {
+        hint = ` Tracked keys: ${[...index.knownPaths].map(bounded_js_1.displayKey).join(', ')}.`;
+    }
+    return { type: 'string', description: `${description}${hint}` };
+}
+exports.keyProperty = keyProperty;
+//# sourceMappingURL=parameterSchemas.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parameterSchemas.js","sourceRoot":"","sources":["../../../src/trace-toolpack/traceToolpack/parameterSchemas.ts"],"names":[],"mappings":";;;AACA,+DAAwD;AACxD,4DAAwD;AACxD,8CAA2C;AAE3C,8EAA8E;AAE9E,SAAS,UAAU,CAAC,KAAoB,EAAE,WAAmB;IAC3D,MAAM,QAAQ,GAA4B,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;IAC1E,wEAAwE;IACxE,6EAA6E;IAC7E,sEAAsE;IACtE,IACE,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC;QAC3B,KAAK,CAAC,UAAU,CAAC,MAAM,IAAI,qCAAe;QAC1C,CAAC,YAAY,CAAC,KAAK,CAAC,EACpB,CAAC;QACD,QAAQ,CAAC,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAwBQ,gCAAU;AAtBnB,8EAA8E;AAC9E,SAAS,YAAY,CAAC,KAAoB;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,cAAc,CAAC;IACrC,OAAO,CACL,OAAO,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oCAAgB,EAAC,OAAO,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAChG,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAS,WAAW,CAAC,KAAoB,EAAE,WAAmB;IAC5D,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,IAAI,qCAAe,EAAE,CAAC;QAC1E,IAAI,GAAG,kBAAkB,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,uBAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC/E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,GAAG,IAAI,EAAE,EAAE,CAAC;AAClE,CAAC;AAEoB,kCAAW"}