agentfootprint 9.93.0 → 9.94.0

package/dist/types/lib/trace-toolpack/selfExplain.d.ts

@@ -178,6 +178,23 @@ export declare function buildSelfExplainSkill(options: SelfExplainOptions): Inje
  * when they set one. The iteration after activation, `ctx.activeSkillId`
  * matches and the catalog gains the trace tools (inline) or the single
  * `explain_run` tool (delegate).
+ *
+ * INLINE MODE LOADS THE PACK LAZILY (9.94.0). The toolpack module is the
+ * largest single module on the library's default graph, and until this
+ * release every consumer who imported `Agent` carried it — `.selfExplain()`
+ * or not — because this function reached it statically. Now the pack is
+ * `import()`ed the first time the self-explain skill is ACTIVE on an
+ * iteration, and never before: not at `build()`, not on a turn where the
+ * model never opened the skill, not at all for an agent that did not enable
+ * `.selfExplain()`. A bundler splits it into its own chunk; Node loads it
+ * through the same `require` it always did, one microtask later.
+ *
+ * What the consumer sees: `list(ctx)` still answers `[]` synchronously when
+ * the skill is not active (the sync fast path the tools slot skips the await
+ * for), and a Promise of the same eleven tools when it is — the shape
+ * `ToolProvider.list` has always allowed, and the one the composed provider
+ * below already used. The provider id is unchanged, so `.watch()` output and
+ * the `skill-scoped:` refusal in the builder read exactly as before.
  */
 export declare function buildSelfExplainToolProvider(binding: SelfExplainBinding, options: SelfExplainOptions, existing?: ToolProvider): ToolProvider;
 //# sourceMappingURL=selfExplain.d.ts.map

package/dist/types/lib/trace-toolpack/selfExplain.d.ts.map

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

package/dist/types/lib/trace-toolpack/traceToolNames.d.ts

@@ -0,0 +1,38 @@
+/**
+ * traceToolNames — the two facts about the trace toolpack that are needed
+ * BEFORE the pack is loaded.
+ *
+ * `.selfExplain()` mounts the pack lazily (9.94.0): the toolpack module —
+ * eleven tools over a finished trace, the largest single module on the
+ * library's default graph — is reached through `import()` the first time
+ * the self-explain skill is active on an iteration, never at build time and
+ * never for an agent that did not enable it (see `selfExplain.ts` ·
+ * `buildSelfExplainToolProvider`). Two things the builder needs cannot wait
+ * for that load, and they live here so that reading them costs nothing:
+ *
+ *   - `TRACE_TOOL_NAMES` — the names the pack can mount, which `build()`
+ *     reserves synchronously (a consumer tool sharing a name would silently
+ *     shadow the trace tool);
+ *   - `NO_COMPLETED_RUN_MESSAGE` — the model-visible answer every trace tool
+ *     gives before a turn has finished, which the delegate-mode `explain_run`
+ *     tool returns without loading the pack at all.
+ *
+ * `traceToolpack.ts` re-exports `TRACE_TOOL_NAMES` and `lazyToolpack.ts`
+ * re-exports `NO_COMPLETED_RUN_MESSAGE`, so every existing import path still
+ * resolves — this module only changes what a static import of them COSTS.
+ */
+/**
+ * The tool names this pack can mount. The Agent builder reserves these at
+ * `.selfExplain()` build time — the tools slot dedupes by name with
+ * first-occurrence-wins, so a consumer tool sharing a name would silently
+ * shadow the trace tool AND the skill body would instruct the model into
+ * the wrong one. Exported so the reservation list is DERIVED from the pack
+ * rather than typed out beside it (a second list is a list that drifts).
+ *
+ * The pack itself asserts, at test time, that what it mounts is exactly
+ * this list (test/lib/trace-toolpack/selfExplainAgent.test.ts).
+ */
+export declare const TRACE_TOOL_NAMES: readonly ["run_overview", "find_context_errors", "find_in_trace", "trace_node", "trace_slice", "backtrack", "who_wrote", "get_value", "inspect_tool_call", "inspect_tool_run", "read_narrative"];
+/** Model-visible answer when no completed run is available yet. */
+export declare const NO_COMPLETED_RUN_MESSAGE: string;
+//# sourceMappingURL=traceToolNames.d.ts.map

package/dist/types/lib/trace-toolpack/traceToolNames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceToolNames.d.ts","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/traceToolNames.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,kMAYnB,CAAC;AAEX,mEAAmE;AACnE,eAAO,MAAM,wBAAwB,QAEa,CAAC"}

package/dist/types/lib/trace-toolpack/traceToolpack.d.ts

@@ -66,14 +66,12 @@ import { type TraceToolpackArtifacts, type TraceToolpackOptions } from './types.
  */
 export declare function traceToolpack(artifacts: TraceToolpackArtifacts, options?: TraceToolpackOptions): Tool[];
 /**
- * The tool names this pack can mount. The Agent builder reserves these at
- * `.selfExplain()` build time — the tools slot dedupes by name with
- * first-occurrence-wins, so a consumer tool sharing a name would silently
- * shadow the trace tool AND the skill body would instruct the model into
- * the wrong one. Exported so the reservation list is DERIVED from the pack
- * rather than typed out beside it (a second list is a list that drifts).
+ * The tool names this pack can mount — declared in `traceToolNames.ts` so the
+ * Agent builder can reserve them WITHOUT loading this module (the pack is
+ * mounted lazily since 9.94.0); re-exported here so the list still reads as
+ * the pack's own.
  */
-export declare const TRACE_TOOL_NAMES: readonly ["run_overview", "find_context_errors", "find_in_trace", "trace_node", "trace_slice", "backtrack", "who_wrote", "get_value", "inspect_tool_call", "inspect_tool_run", "read_narrative"];
+export { TRACE_TOOL_NAMES } from './traceToolNames.js';
 /**
  * Invoke a toolpack tool OUTSIDE an Agent (scripted debug sessions, tests,
  * offline auditors). Mirrors the Agent's #9 boundary: args are validated

package/dist/types/lib/trace-toolpack/traceToolpack.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"traceToolpack.d.ts","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/traceToolpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,OAAO,EAAc,KAAK,IAAI,EAA6B,MAAM,qBAAqB,CAAC;AAcvF,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AA4QpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,sBAAsB,EACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,EAAE,CA0BR;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,kMAYnB,CAAC;AAsqEX;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,MAAM,CAAC,CASjB"}
+{"version":3,"file":"traceToolpack.d.ts","sourceRoot":"","sources":["../../../../src/lib/trace-toolpack/traceToolpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AASH,OAAO,EAAc,KAAK,IAAI,EAA6B,MAAM,qBAAqB,CAAC;AAcvF,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AA4QpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,sBAAsB,EACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,EAAE,CA0BR;AAED;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAsqEvD;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,MAAM,CAAC,CASjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "9.93.0",
+  "version": "9.94.0",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "type": "commonjs",
@@ -304,8 +304,11 @@
     }
   },
   "sideEffects": [
+    "./dist/index.js",
+    "./dist/esm/index.js",
     "**/cache/strategies/*.js",
     "**/cache/index.js",
+    "**/lib/injection-engine/index.js",
     "**/lib/injection-engine/devWarnHost.js"
   ],
   "peerDependencies": {