agentfootprint/dist/trace-toolpack/index.js

The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.

"use strict";
/**
 * trace-toolpack — RFC-003 Part C: the introspection toolpack.
 *
 * footprintjs trace evidence exposed as TOOLS an LLM calls: a debugging
 * model navigates a COMPLETED run's evidence by runtimeStageIds instead of
 * reading dumps. Bounded, honest (⚠ markers), redaction-respecting.
 *
 * Three doors over the same evidence:
 *   - `traceToolpack`     the raw Tool[] (mount anywhere / drive scripted)
 *   - `traceDebugAgent`   the DEDICATED conversational debugger (separate
 *                         session, any provider — cheap models welcome)
 *   - `.selfExplain()`    the IN-CONVERSATION door on the Agent builder
 *                         (skill-gated, late-bound to the agent's own
 *                         previous completed run; inline or delegate mode)
 *
 * …and one way IN for a run that already finished: `openRecording` turns a
 * saved `recordRun` bundle back into artifacts, so last Tuesday's run is
 * as navigable as this one.
 */
Object.defineProperty(exports, "__esModule", { value: true });
exports.TOOLPACK_HARD_CAPS = exports.SELF_EXPLAIN_MAX_EVENTS = exports.SelfExplainBinding = exports.buildSelfExplainToolProvider = exports.buildSelfExplainSkill = exports.traceDebugAgent = exports.mergeInnerRuns = exports.innerRunsOf = exports.innerRunStore = exports.INNER_RUN_RECORDS = exports.DEFAULT_INNER_RUN_LIMIT = exports.readStoredCauseArtifacts = exports.traceCauseTools = exports.openRecording = exports.NO_COMPLETED_RUN_MESSAGE = exports.lazyTraceToolpack = exports.TRACE_TOOL_NAMES = exports.traceToolpack = exports.callTraceTool = void 0;
var traceToolpack_js_1 = require("./traceToolpack.js");
Object.defineProperty(exports, "callTraceTool", { enumerable: true, get: function () { return traceToolpack_js_1.callTraceTool; } });
Object.defineProperty(exports, "traceToolpack", { enumerable: true, get: function () { return traceToolpack_js_1.traceToolpack; } });
Object.defineProperty(exports, "TRACE_TOOL_NAMES", { enumerable: true, get: function () { return traceToolpack_js_1.TRACE_TOOL_NAMES; } });
// `missingArtifactMessage` is deliberately NOT re-exported: it is the lazy
// pack's own answer for a tool whose optional evidence this run lacks, and a
// consumer has no call to construct one.
var lazyToolpack_js_1 = require("./lazyToolpack.js");
Object.defineProperty(exports, "lazyTraceToolpack", { enumerable: true, get: function () { return lazyToolpack_js_1.lazyTraceToolpack; } });
Object.defineProperty(exports, "NO_COMPLETED_RUN_MESSAGE", { enumerable: true, get: function () { return lazyToolpack_js_1.NO_COMPLETED_RUN_MESSAGE; } });
var openRecording_js_1 = require("./openRecording.js");
Object.defineProperty(exports, "openRecording", { enumerable: true, get: function () { return openRecording_js_1.openRecording; } });
var causeTools_js_1 = require("./causeTools.js");
Object.defineProperty(exports, "traceCauseTools", { enumerable: true, get: function () { return causeTools_js_1.traceCauseTools; } });
var storedCause_js_1 = require("./storedCause.js");
Object.defineProperty(exports, "readStoredCauseArtifacts", { enumerable: true, get: function () { return storedCause_js_1.readStoredCauseArtifacts; } });
// The record a TOOL keeps of its own run — what `inspect_tool_run` opens.
// `INNER_RUN_RECORDS` / `innerRunsOf` are the join key between a Tool and
// its store; `innerRunStore` / `mergeInnerRuns` exist for consumers wiring
// a chart tool into artifacts by hand (the Agent builder does it for you).
var innerRunRecords_js_1 = require("../core/innerRunRecords.js");
Object.defineProperty(exports, "DEFAULT_INNER_RUN_LIMIT", { enumerable: true, get: function () { return innerRunRecords_js_1.DEFAULT_INNER_RUN_LIMIT; } });
Object.defineProperty(exports, "INNER_RUN_RECORDS", { enumerable: true, get: function () { return innerRunRecords_js_1.INNER_RUN_RECORDS; } });
Object.defineProperty(exports, "innerRunStore", { enumerable: true, get: function () { return innerRunRecords_js_1.innerRunStore; } });
Object.defineProperty(exports, "innerRunsOf", { enumerable: true, get: function () { return innerRunRecords_js_1.innerRunsOf; } });
Object.defineProperty(exports, "mergeInnerRuns", { enumerable: true, get: function () { return innerRunRecords_js_1.mergeInnerRuns; } });
var traceDebugAgent_js_1 = require("./traceDebugAgent.js");
Object.defineProperty(exports, "traceDebugAgent", { enumerable: true, get: function () { return traceDebugAgent_js_1.traceDebugAgent; } });
var selfExplain_js_1 = require("./selfExplain.js");
Object.defineProperty(exports, "buildSelfExplainSkill", { enumerable: true, get: function () { return selfExplain_js_1.buildSelfExplainSkill; } });
Object.defineProperty(exports, "buildSelfExplainToolProvider", { enumerable: true, get: function () { return selfExplain_js_1.buildSelfExplainToolProvider; } });
Object.defineProperty(exports, "SelfExplainBinding", { enumerable: true, get: function () { return selfExplain_js_1.SelfExplainBinding; } });
Object.defineProperty(exports, "SELF_EXPLAIN_MAX_EVENTS", { enumerable: true, get: function () { return selfExplain_js_1.SELF_EXPLAIN_MAX_EVENTS; } });
var types_js_1 = require("./types.js");
Object.defineProperty(exports, "TOOLPACK_HARD_CAPS", { enumerable: true, get: function () { return types_js_1.TOOLPACK_HARD_CAPS; } });
//# sourceMappingURL=index.js.map