agentfootprint 10.3.0 → 10.3.1

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

@@ -0,0 +1,83 @@
+/**
+ * traceToolpack — footprintjs trace evidence exposed as TOOLS an LLM calls
+ * (RFC-003 Part C: the introspection toolpack).
+ *
+ * "The framework's internal tool for itself": after a run completes, a
+ * debugging LLM (a cheap model in a SEPARATE session) navigates the run's
+ * evidence by ids instead of reading dumps — the same just-in-time,
+ * token-efficient loading pattern as `read_skill`. Feed the slice, not the
+ * trace; the LLM ranks by navigating, so no embedder is needed.
+ *
+ * Pattern: Factory over frozen artifacts. `traceToolpack(artifacts)` returns
+ *          plain `Tool[]` — mount them on any Agent, or drive them scripted
+ *          via `callTraceTool` (the offline auditor pattern, like
+ *          examples/features/20). Nothing re-runs; every tool is a bounded
+ *          read-only VIEW over a COMPLETED run's snapshot + commit log.
+ *
+ * The toolpack's three contracts (B13 posture):
+ *
+ *   1. BOUNDED BY DEFAULT — every output is capped (previews, slice
+ *      depth/nodes, value chars, narrative lines). Per-call params raise
+ *      the budget only up to hard caps the LLM cannot exceed.
+ *   2. HONEST — truncation and incompleteness are ALWAYS marked (⚠), never
+ *      silent: truncated slices, untracked sources (args/env/silent reads),
+ *      missing read tracking, missing control-dependence lookup, values the
+ *      commit log cannot see (pre-run state, closures).
+ *   3. REDACTION-RESPECTING — the commit log already carries redacted
+ *      payloads (footprintjs scrubs at commit time); the toolpack passes
+ *      placeholders through verbatim and flags redacted keys. It never
+ *      reconstructs around a redaction.
+ *
+ * Why ids: every view names steps by `runtimeStageId`
+ * (`stageId#executionIndex`) — the universal key linking the commit log,
+ * the execution tree, and recorder events. The LLM drills like a debugger:
+ * overview → slice → node → value, paying only for what it opens.
+ */
+import { type Tool } from '../tools/tools.js';
+import { type TraceToolpackArtifacts, type TraceToolpackOptions } from './types.js';
+/**
+ * Build the introspection toolpack over a COMPLETED run's artifacts.
+ *
+ * Returns plain `Tool[]`:
+ *
+ * | Tool                | Question it answers                                    |
+ * |---------------------|--------------------------------------------------------|
+ * | `run_overview`      | What happened, broadly? (the entry point)              |
+ * | `find_context_errors` | What did this run contradict itself about, and why?  |
+ * | `find_in_trace`     | WHERE in this run does "…" appear? (free text → ids)   |
+ * | `trace_node`        | What did step X read/write, and where did its inputs come from? |
+ * | `trace_slice`       | Which chain of steps produced the data at X? (causal slice) |
+ * | `backtrack`         | Why is VARIABLE K what it is? (+ `element`: who made K[i]?) — variable-first |
+ * | `who_wrote`         | Which step last wrote key K?                           |
+ * | `get_value`         | The full value of K as of step X (capped, truncation-marked) |
+ * | `inspect_tool_call` | One tool call end to end: proposed args → ran-with args → result → outcome |
+ * | `inspect_tool_run`  | INSIDE one tool call — the chart it ran, when that tool kept its record |
+ * | `inspect_subflow`   | INSIDE one subflow mount — the subflow's own log, one level at a time |
+ * | `read_narrative`    | The human-readable story, paginated (only when narrative provided) |
+ *
+ * Mount on an Agent (`Agent.create({...}).tool(...tools)`) or drive scripted
+ * via {@link callTraceTool}. The tools NEVER throw on bad ids/keys — they
+ * return corrective, model-visible messages (the #9 philosophy), and their
+ * strict input schemas give Agent-dispatched calls free arg validation.
+ *
+ * Security note (B13 posture): trace content can carry adversarial text from
+ * the original run (tool results, user input). Serve these tools to a
+ * SEPARATE debugging session over completed runs — not to the production
+ * agent mid-run — and treat tool outputs as data, not instructions.
+ */
+export declare function traceToolpack(artifacts: TraceToolpackArtifacts, options?: TraceToolpackOptions): Tool[];
+/**
+ * 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 { TRACE_TOOL_NAMES } from '../lib/traceToolNames.js';
+/**
+ * Invoke a toolpack tool OUTSIDE an Agent (scripted debug sessions, tests,
+ * offline auditors). Mirrors the Agent's #9 boundary: args are validated
+ * against the tool's inputSchema first, and an invalid call returns the same
+ * model-visible correction string instead of executing.
+ */
+export declare function callTraceTool(tools: readonly Tool[], name: string, args?: Record<string, unknown>): Promise<string>;
+//# sourceMappingURL=traceToolpack.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traceToolpack.d.ts","sourceRoot":"","sources":["../../../src/trace-toolpack/traceToolpack.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAmBH,OAAO,EAAc,KAAK,IAAI,EAA6B,MAAM,mBAAmB,CAAC;AAwBrF,OAAO,EAIL,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC1B,MAAM,YAAY,CAAC;AA4VpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,sBAAsB,EACjC,OAAO,CAAC,EAAE,oBAAoB,GAC7B,IAAI,EAAE,CA2BR;AAED;;;;;GAKG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAwiF5D;;;;;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/dist/types/trace-toolpack/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Trace toolpack types — RFC-003 Part C (the introspection toolpack).
+ *
+ * Pattern: artifact bag — everything a debugging LLM needs to navigate a
+ *          COMPLETED run, captured once and handed to `traceToolpack()`.
+ * Role:    Input contract. The toolpack never re-runs anything; it serves
+ *          bounded, id-addressed views over these frozen artifacts.
+ */
+import type { RuntimeSnapshot } from 'footprintjs';
+import type { ControlDepLookup } from 'foottrace';
+import type { AgentfootprintEvent } from '../events/registry.js';
+import type { InnerRunLookup } from '../core/innerRunRecords.js';
+/**
+ * The frozen evidence of one completed run.
+ *
+ * - `snapshot` — `executor.getSnapshot()`. Carries the commit log (what every
+ *   step wrote, with verbs + redaction + `untrackedSources` honesty markers),
+ *   the execution tree (per-step name/description/reads/errors), the final
+ *   shared state, and the `commitValues` mode discriminant.
+ * - `controlDeps` — OPTIONAL `controlDepRecorder().asLookup()` from the run.
+ *   With it, causal slices include `[control: <rule label>]` edges to the
+ *   decider that routed execution. Without it, slices say so explicitly.
+ * - `narrative` — OPTIONAL narrative lines (e.g. rendered from
+ *   `executor.getNarrativeEntries()`). When present, a `read_narrative` tool
+ *   is added for bounded, paginated access to the human-readable story.
+ * - `events` — OPTIONAL tail of the run's typed agentfootprint events. The
+ *   commit log records what each step WROTE; it has no clock and no notion
+ *   of a tool call as a thing with a duration. `inspect_tool_call` reads
+ *   timings and outcomes from here, and says ⚠ when the tail is absent
+ *   rather than inventing them. It is ALSO the only home of the Context
+ *   Integrity channel (`agentfootprint.integrity.context_error` and the
+ *   per-run `…disposition` accounting) — what `find_context_errors` reads,
+ *   and what it reports as ABSENT rather than green when the tail is gone.
+ * - `innerRuns` — OPTIONAL lookup of the records TOOLS kept of their own
+ *   runs, keyed by `toolCallId`. Present when the agent mounts a
+ *   `flowchartAsTool({ keepRecord: true })`. With it, `inspect_tool_run`
+ *   descends THROUGH the tool boundary into the chart that ran; without it,
+ *   that tool names the switch instead of answering emptily.
+ */
+export interface TraceToolpackArtifacts {
+    readonly snapshot: RuntimeSnapshot;
+    readonly controlDeps?: ControlDepLookup;
+    readonly narrative?: readonly string[];
+    readonly events?: readonly AgentfootprintEvent[];
+    readonly innerRuns?: InnerRunLookup;
+}
+/**
+ * Bounding dials. Every output is bounded BY DEFAULT — these set the
+ * defaults; per-call params (`maxDepth`, `maxNodes`, `maxChars`, `maxLines`)
+ * let the LLM ask for more up to hard caps the consumer cannot exceed.
+ */
+export interface TraceToolpackOptions {
+    /** Value-preview length in chars (trace_node / who_wrote). Default 160. */
+    readonly previewChars?: number;
+    /** Default causal-slice depth for trace_slice. Default 6 (hard cap 20). */
+    readonly sliceMaxDepth?: number;
+    /** Default causal-slice node budget for trace_slice. Default 25 (hard cap 100). */
+    readonly sliceMaxNodes?: number;
+    /** Default char budget for get_value. Default 2000 (hard cap 8000). */
+    readonly valueMaxChars?: number;
+}
+/** Resolved options with defaults applied (internal). */
+export interface ResolvedToolpackOptions {
+    readonly previewChars: number;
+    readonly sliceMaxDepth: number;
+    readonly sliceMaxNodes: number;
+    readonly valueMaxChars: number;
+}
+/** Hard caps — per-call params clamp to these regardless of what the LLM asks for. */
+export declare const TOOLPACK_HARD_CAPS: {
+    readonly sliceMaxDepth: 20;
+    readonly sliceMaxNodes: 100;
+    readonly valueMaxChars: 8000;
+    readonly narrativeMaxLines: 200;
+    /** `find_in_trace` hits per call — a search is a pointer list, not a dump. */
+    readonly findMaxHits: 25;
+    /**
+     * `find_context_errors` findings per call. Findings are deduplicated at
+     * filing time, so a run rarely has many — and a run that does has a
+     * systemic problem the first page already shows.
+     */
+    readonly contextErrorsMax: 25;
+};
+export declare function resolveToolpackOptions(options?: TraceToolpackOptions): ResolvedToolpackOptions;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/trace-toolpack/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;IACjD,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,2EAA2E;IAC3E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mFAAmF;IACnF,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,uEAAuE;IACvE,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,yDAAyD;AACzD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,sFAAsF;AACtF,eAAO,MAAM,kBAAkB;;;;;IAK7B,8EAA8E;;IAE9E;;;;OAIG;;CAEK,CAAC;AAEX,wBAAgB,sBAAsB,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,uBAAuB,CAO9F"}

package/dist/types/trust-boundaries/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/trust-boundaries/capture.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAGV,qBAAqB,EACrB,4BAA4B,EAC7B,MAAM,YAAY,CAAC;AA4EpB;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,GAAE,4BAAiC,GACzC,qBAAqB,CAgFvB"}

package/dist/types/trust-boundaries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/trust-boundaries/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,wBAAwB,EACxB,sBAAsB,EACtB,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/types/trust-boundaries/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../src/trust-boundaries/project.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,iBAAiB,EAA0B,MAAM,YAAY,CAAC;AAuF5E,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAA;CAAE,GAC9B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAElE,wFAAwF;AACxF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,MAAM,MAAM,GAAG,SAAS,GAChC,UAAU,CAqEZ"}

package/dist/types/trust-boundaries/types.d.ts

@@ -0,0 +1,82 @@
+import type { AgentfootprintEvent } from '../events/registry.js';
+import type { EventSourcePosition } from '../events/types.js';
+import type { Unsubscribe } from '../events/dispatcher.js';
+import type { MiddlewareDecisionPayload, PermissionCheckPayload, PermissionHaltPayload, CredentialRequestedPayload, CredentialAcquiredPayload, CredentialFailedPayload } from '../events/payloads.js';
+/** Only events that the runtime actually produces; no inferred gate events. */
+export type TrustBoundaryEventType = 'agentfootprint.middleware.decision' | 'agentfootprint.permission.check' | 'agentfootprint.permission.halt' | 'agentfootprint.credential.requested' | 'agentfootprint.credential.acquired' | 'agentfootprint.credential.authorization_required' | 'agentfootprint.credential.failed';
+interface FactOrigin {
+    readonly seq: number;
+    /** AgentFootprint run namespace, distinct from sourcePosition.engineRunId. */
+    readonly runId: string;
+    readonly runtimeStageId: string;
+    /** Emission time supplied by the typed event; never replaced by arrival time. */
+    readonly wallClockMs: number;
+    readonly sourcePosition?: EventSourcePosition;
+    readonly toolCallId?: string;
+    readonly iteration?: number;
+}
+/** Observed metadata, not an authorization, execution, coverage or redaction guarantee. */
+export type TrustBoundaryFact = FactOrigin & (({
+    readonly eventType: 'agentfootprint.middleware.decision';
+} & Pick<MiddlewareDecisionPayload, 'middleware' | 'moment' | 'outcome' | 'changed' | 'iteration'>) | ({
+    readonly eventType: 'agentfootprint.permission.check';
+} & Pick<PermissionCheckPayload, 'capability' | 'result' | 'target' | 'policyRuleId'>) | ({
+    readonly eventType: 'agentfootprint.permission.halt';
+} & Pick<PermissionHaltPayload, 'target' | 'checkerId' | 'iteration'>) | ({
+    readonly eventType: 'agentfootprint.credential.requested';
+} & Pick<CredentialRequestedPayload, 'service' | 'mode'>) | ({
+    readonly eventType: 'agentfootprint.credential.acquired';
+} & Pick<CredentialAcquiredPayload, 'service' | 'kind'>) | {
+    readonly eventType: 'agentfootprint.credential.authorization_required';
+    readonly service: string;
+} | ({
+    readonly eventType: 'agentfootprint.credential.failed';
+} & Pick<CredentialFailedPayload, 'service' | 'errorClass'>));
+/** Disjoint capture accounting, including a currently inspected selected observation. */
+export interface TrustBoundaryCounters {
+    readonly observed: number;
+    readonly retained: number;
+    readonly evicted: number;
+    readonly invalid: number;
+    readonly oversized: number;
+    /** Selected observations whose metadata projection has not returned yet. */
+    readonly pending: number;
+}
+export interface TrustBoundarySnapshot {
+    readonly name: 'TrustBoundaries';
+    readonly description: string;
+    readonly meta: {
+        readonly version: 1;
+    };
+    readonly data: {
+        readonly captureId: string;
+        readonly facts: readonly TrustBoundaryFact[];
+        readonly counters: TrustBoundaryCounters;
+        readonly firstObservedSeq: number | null;
+        readonly lastObservedSeq: number | null;
+        readonly firstRetainedSeq: number | null;
+        readonly lastRetainedSeq: number | null;
+    };
+}
+/** Runner and EventDispatcher both provide this narrow typed subscription port. */
+export interface TrustBoundaryEventSource {
+    on(type: '*', listener: (event: AgentfootprintEvent) => void): Unsubscribe;
+}
+export interface TrustBoundaryRecorderOptions {
+    readonly id?: string;
+    /** Bounded tail capacity: default 1,000; integer 1–10,000. */
+    readonly maxFacts?: number;
+}
+/** A typed observer, deliberately not a raw engine/CombinedRecorder. */
+export interface TrustBoundaryRecorder {
+    readonly id: string;
+    readonly counters: TrustBoundaryCounters;
+    /** One active subscription. Capture continues across run/resume/composition IDs. */
+    subscribe(source: TrustBoundaryEventSource): Unsubscribe;
+    /** One canonical recorder bundle; rows are owned/frozen and the array is detached. */
+    toSnapshot(): TrustBoundarySnapshot;
+    /** Start a new capture ID and reset counts/sequence, without changing the subscription. */
+    resetCapture(): void;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types/trust-boundaries/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/trust-boundaries/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "10.3.0",
+  "version": "10.3.1",
   "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",
@@ -94,7 +94,8 @@
     "changes:preview": "node scripts/changes.mjs preview",
     "coverage:badge": "npm run test:coverage; node scripts/coverage-badge.mjs",
     "docs:truth:report": "node scripts/docs-truth-check.mjs --report-only",
-    "test:context-package": "node scripts/check-context-package.mjs"
+    "test:context-package": "node scripts/check-context-package.mjs",
+    "check:layering": "node scripts/check-layering.mjs"
   },
   "files": [
     "dist/**/*",
@@ -357,8 +358,9 @@
     }
   },
   "sideEffects": [
-    "**/lib/injection-engine/index.js",
-    "**/lib/injection-engine/devWarnHost.js"
+    "**/injection-engine/index.js",
+    "**/injection-engine/devWarnHost.js",
+    "**/trace-toolpack/selfExplainHost.js"
   ],
   "peerDependencies": {
     "@anthropic-ai/sdk": "*",
@@ -484,6 +486,7 @@
     "esbuild": "^0.28.0",
     "eslint": "^8.44.0",
     "eslint-config-prettier": "^6.15.0",
+    "eslint-plugin-import": "^2.32.0",
     "footprintjs": "^10.0.0",
     "google-auth-library": "^11.0.1",
     "jose": "^6.2.7",

package/dist/adapters/forcedToolChoice.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"forcedToolChoice.js","sourceRoot":"","sources":["../../src/adapters/forcedToolChoice.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AAIH;;;;GAIG;AACH,SAAgB,mBAAmB,CACjC,QAAmF,EACnF,KAAa;IAEb,OAAO,CACL,QAAQ,CAAC,uBAAuB,KAAK,IAAI;QACzC,CAAC,QAAQ,CAAC,wBAAwB,KAAK,SAAS;YAC9C,QAAQ,CAAC,wBAAwB,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CACrD,CAAC;AACJ,CAAC;AATD,kDASC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,0BAA2B,SAAQ,KAAK;IACnD,+EAA+E;IACtE,QAAQ,CAAS;IAC1B,mCAAmC;IAC1B,KAAK,CAAS;IACvB,6EAA6E;IACpE,SAAS,GAAG,KAAK,CAAC;IAE3B,YAAY,IAA2D;QACrE,KAAK,CACH,IAAI,IAAI,CAAC,QAAQ,MAAM,IAAI,CAAC,KAAK,yDAAyD;YACxF,iEAAiE;YACjE,gFAAgF,CACnF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;QACzC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAlBD,gEAkBC"}

package/dist/adapters/llm/contextWindow.js

@@ -1,304 +0,0 @@
-"use strict";
-/**
- * ContextWindowExceededError — "the request did not fit" as a typed error
- * that names the fixes (9.6.0).
- *
- * Every vendor refuses an over-long request in its own words, and until now
- * every one of them reached the caller as an opaque provider error:
- *
- *   [openai] 400 Input tokens exceed the configured limit of 272000 tokens.
- *   Your messages resulted in 879073 tokens.
- *
- * That is the message a production field deployment spent a day on. It is a
- * true sentence and a useless one: it does not say which of the framework's
- * dials moves that number, and it looks exactly like a transient 400 — so the
- * natural next move is to retry, which re-sends the same oversized history and
- * fails identically, forever.
- *
- * So the adapters translate it, ONCE, into an error whose message contains the
- * three fixes in the order they are worth trying, and which carries the two
- * numbers (limit, actual) when the vendor stated them.
- *
- * **Detection is deliberately conservative.** Only unmistakable phrases and
- * vendor codes translate; everything else passes through untouched as the
- * provider error it always was. In particular a RATE limit ("rate limit
- * reached … tokens per min") is a different failure with a different fix and
- * must never land here — which is why no pattern matches on "too many tokens".
- *
- * @see ../../core/runCheckpoint.ts  where this class makes `resumeOnError`
- *                                   stop advertising a resume that cannot work
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.asContextWindowExceeded = exports.looksLikeContextWindowExceeded = exports.isContextWindowExceeded = exports.ContextWindowExceededError = exports.ERR_CONTEXT_WINDOW_EXCEEDED = void 0;
-/** Discriminator carried on the error — stable across releases. */
-exports.ERR_CONTEXT_WINDOW_EXCEEDED = 'ERR_CONTEXT_WINDOW_EXCEEDED';
-/**
- * Thrown by an LLM adapter when the provider refused the request because the
- * prompt did not fit the model's context window.
- *
- * A refusal, not a failure of the model: nothing was generated and nothing was
- * charged for output. Retrying the identical request is deterministic — it
- * fails the same way — so this is one of the classes
- * {@link canResume} reports as not resumable.
- *
- * @example
- * ```ts
- * import { ContextWindowExceededError } from 'agentfootprint';
- *
- * try {
- *   await agent.run({ message: 'summarise the fabric inventory' });
- * } catch (err) {
- *   if (err instanceof ContextWindowExceededError) {
- *     console.error(`sent ${err.actualTokens} against ${err.limitTokens}`);
- *     // …cap the tool result, or add .window(slidingWindow({ keepRecentTurns: 2 }))
- *   }
- * }
- * ```
- */
-class ContextWindowExceededError extends Error {
-    code = exports.ERR_CONTEXT_WINDOW_EXCEEDED;
-    /** Which adapter refused — `'openai'`, `'anthropic'`, `'bedrock'`, … */
-    provider;
-    /** The model's (or gateway's) ceiling in tokens, when the vendor said it. */
-    limitTokens;
-    /** What the request actually came to in tokens, when the vendor said it. */
-    actualTokens;
-    /** HTTP status, when there was one. Kept so retry policies still see a 4xx. */
-    status;
-    /** The provider's own error, unchanged. */
-    cause;
-    constructor(args) {
-        super(buildMessage(args));
-        this.name = 'ContextWindowExceededError';
-        this.provider = args.provider;
-        if (args.limitTokens !== undefined)
-            this.limitTokens = args.limitTokens;
-        if (args.actualTokens !== undefined)
-            this.actualTokens = args.actualTokens;
-        if (args.status !== undefined)
-            this.status = args.status;
-        if (args.cause !== undefined)
-            this.cause = args.cause;
-    }
-}
-exports.ContextWindowExceededError = ContextWindowExceededError;
-/** `true` for the typed error, including across a `structuredClone`-free
- *  boundary where `instanceof` still holds. Kept as a function so callers do
- *  not have to import the class to ask the question. */
-function isContextWindowExceeded(err) {
-    return (err instanceof ContextWindowExceededError ||
-        (err instanceof Error && err.code === exports.ERR_CONTEXT_WINDOW_EXCEEDED));
-}
-exports.isContextWindowExceeded = isContextWindowExceeded;
-// ─── Detection ───────────────────────────────────────────────────────
-/**
- * The phrases that mean "your request was too big for the context window",
- * as the four shipped wire vendors actually word them. Every one of these is
- * unambiguous on its own — which is the bar for being on this list, because a
- * pattern that also matches a rate limit or a `max_tokens` validation error
- * would send callers to the wrong fix.
- *
- *   openai        This model's maximum context length is 8192 tokens. However,
- *                 your messages resulted in 9000 tokens.
- *   openai (code) context_length_exceeded
- *   gateways      Input tokens exceed the configured limit of 272000 tokens.
- *                 Your messages resulted in 879073 tokens.
- *   anthropic     prompt is too long: 250000 tokens > 200000 maximum
- *   anthropic     input length and `max_tokens` exceed context limit:
- *                 195000 + 8192 > 200000
- *   bedrock       Input is too long for requested model.
- *   bedrock       (ValidationException carrying either anthropic phrase)
- *   gemini        The input token count (1200293) exceeds the maximum number
- *                 of tokens allowed (1048576).
- */
-const CONTEXT_PHRASES = [
-    /context_length_exceeded/i,
-    /maximum context length/i,
-    /prompt is too long/i,
-    /exceed(?:s)? context limit/i,
-    /input (?:is )?too long for (?:the )?requested model/i,
-    /input tokens exceed the configured limit/i,
-    // "input tokens" spelled out on purpose. A gateway saying "exceeds the
-    // maximum allowed number of tokens" with no side named could equally be an
-    // OUTPUT `max_tokens` cap, which has a different fix — and a pattern that
-    // cannot tell those apart sends callers to the wrong one.
-    /exceeds? the maximum (?:allowed )?(?:number of )?input tokens/i,
-    // gemini (9.13.0) — the same claim with the words in the other order, which
-    // is why the pattern above does not catch it. "INPUT token count" is what
-    // keeps it off a `max_tokens` validation error, and Google spells a rate
-    // limit "quota exceeded", so there is no overlap with throttling either.
-    /input token count[^.]{0,80}exceeds the maximum number of tokens allowed/i,
-];
-/** `"272,000"` → `272000`; anything unparseable → undefined. */
-function num(raw) {
-    if (raw === undefined)
-        return undefined;
-    const value = Number(raw.replace(/[,_\s]/g, ''));
-    return Number.isFinite(value) && value > 0 ? value : undefined;
-}
-/** Pull `{ limit, actual }` out of the vendor's sentence when it stated them. */
-function readNumbers(text) {
-    // anthropic: "prompt is too long: 250000 tokens > 200000 maximum"
-    const tooLong = /prompt is too long:\s*([\d,_]+)\s*tokens?\s*>\s*([\d,_]+)/i.exec(text);
-    if (tooLong) {
-        return { actualTokens: num(tooLong[1]), limitTokens: num(tooLong[2]) };
-    }
-    // anthropic / bedrock: "input length and `max_tokens` exceed context limit:
-    //                       195000 + 8192 > 200000"
-    const sum = /exceed(?:s)? context limit:\s*([\d,_]+)\s*\+\s*([\d,_]+)\s*>\s*([\d,_]+)/i.exec(text);
-    if (sum) {
-        const input = num(sum[1]);
-        const output = num(sum[2]);
-        return {
-            ...(input !== undefined && output !== undefined && { actualTokens: input + output }),
-            ...(num(sum[3]) !== undefined && { limitTokens: num(sum[3]) }),
-        };
-    }
-    // gemini: "The input token count (1200293) exceeds the maximum number of
-    // tokens allowed (1048576)." Both parentheses are matched loosely because
-    // Google sometimes ships the first one EMPTY — `num('')` is undefined, so a
-    // half-stated sentence yields the half it stated rather than nothing.
-    const geminiPair = /input token count\s*\(([\d,_]*)\)\s*exceeds the maximum number of tokens allowed\s*\(([\d,_]*)\)/i.exec(text);
-    if (geminiPair) {
-        const actual = num(geminiPair[1]);
-        const limit = num(geminiPair[2]);
-        return {
-            ...(actual !== undefined && { actualTokens: actual }),
-            ...(limit !== undefined && { limitTokens: limit }),
-        };
-    }
-    const limit = num(/maximum context length is\s*([\d,_]+)/i.exec(text)?.[1]) ??
-        num(/configured limit of\s*([\d,_]+)/i.exec(text)?.[1]) ??
-        num(/limit of\s*([\d,_]+)\s*tokens/i.exec(text)?.[1]);
-    const actual = num(/resulted in\s*([\d,_]+)\s*tokens/i.exec(text)?.[1]) ??
-        num(/requested\s*([\d,_]+)\s*tokens/i.exec(text)?.[1]) ??
-        num(/you (?:sent|submitted|provided)\s*([\d,_]+)\s*tokens/i.exec(text)?.[1]);
-    return {
-        ...(limit !== undefined && { limitTokens: limit }),
-        ...(actual !== undefined && { actualTokens: actual }),
-    };
-}
-/** Every place a vendor hides its sentence, flattened into one string. */
-function textOf(err, extraText) {
-    const parts = [];
-    if (typeof extraText === 'string')
-        parts.push(extraText);
-    const seen = new Set();
-    let node = err;
-    for (let depth = 0; depth < 4 && node !== undefined && node !== null; depth++) {
-        if (seen.has(node))
-            break;
-        seen.add(node);
-        const record = node;
-        for (const value of [record.message, record.code, record.type, record.name]) {
-            if (typeof value === 'string')
-                parts.push(value);
-        }
-        node = record.error ?? record.cause;
-    }
-    return parts.join(' • ');
-}
-/** HTTP status from wherever the SDK put it. */
-function statusOf(err) {
-    const record = err;
-    for (const value of [
-        record?.status,
-        record?.statusCode,
-        record?.$metadata?.httpStatusCode,
-        record?.response?.status,
-    ]) {
-        if (typeof value === 'number' && Number.isFinite(value))
-            return value;
-    }
-    return undefined;
-}
-/**
- * Does this error SAY it is a context overflow, whoever produced it?
- *
- * The same conservative phrase test the adapters translate on, asked without
- * building anything — for code that has to classify an error it did not
- * catch at an adapter boundary. A custom `LLMProvider`, a gateway wrapper or
- * a proxy in front of a vendor produces the vendor's sentence without ever
- * passing through `wrapError`, and a caller reading that error deserves the
- * same answer an adapter would have given.
- *
- * @see ../../core/runCheckpoint.ts — the caller this exists for
- */
-function looksLikeContextWindowExceeded(err, bodyText) {
-    if (isContextWindowExceeded(err))
-        return true;
-    const text = textOf(err, bodyText);
-    return text.length > 0 && CONTEXT_PHRASES.some((pattern) => pattern.test(text));
-}
-exports.looksLikeContextWindowExceeded = looksLikeContextWindowExceeded;
-/**
- * Translate a provider error into {@link ContextWindowExceededError} — or
- * return `undefined`, which means "not this failure, leave it alone".
- *
- * Already-translated errors are returned as they are, so an adapter that
- * wraps another adapter cannot double-wrap.
- */
-function asContextWindowExceeded(err, options) {
-    if (isContextWindowExceeded(err))
-        return err;
-    if (!looksLikeContextWindowExceeded(err, options.bodyText))
-        return undefined;
-    const text = textOf(err, options.bodyText);
-    const numbers = readNumbers(text);
-    // The status the SDK attached, else the one the adapter read off the
-    // response, else a leading `400` the vendor put in the message itself
-    // (several gateways do). Kept because retry policies classify on it, and a
-    // context overflow must never look retryable.
-    const status = statusOf(err) ?? options.status ?? num(/^\s*(4\d\d)\b/.exec(messageOf(err))?.[1]);
-    return new ContextWindowExceededError({
-        provider: options.provider,
-        providerMessage: messageOf(err) || options.bodyText || text,
-        ...numbers,
-        ...(status !== undefined && { status }),
-        ...(err instanceof Error && { cause: err }),
-    });
-}
-exports.asContextWindowExceeded = asContextWindowExceeded;
-function messageOf(err) {
-    if (err instanceof Error)
-        return err.message;
-    if (typeof err === 'string')
-        return err;
-    return '';
-}
-// ─── The message ─────────────────────────────────────────────────────
-function tokens(value) {
-    return value === undefined ? undefined : `${value.toLocaleString('en-US')} tokens`;
-}
-/**
- * The teaching half. Three fixes, cheapest first, and the one thing about
- * `.compaction()` that is not obvious until it fails: folding a span means
- * SENDING that span to the summarizer, so compaction cannot rescue a single
- * round that is already bigger than the window.
- */
-function buildMessage(args) {
-    const sent = tokens(args.actualTokens);
-    const limit = tokens(args.limitTokens);
-    const size = sent && limit
-        ? ` — ${sent} sent against a limit of ${limit}`
-        : limit
-            ? ` — the limit is ${limit}`
-            : sent
-                ? ` — the request came to ${sent}`
-                : '';
-    return (`[${args.provider}] the request did not fit the context window${size}. ` +
-        `The provider refused it before the model saw it, so nothing was generated ` +
-        `and re-sending the same conversation fails the same way.\n` +
-        `  Fix 1 — cap oversized TOOL RESULTS where they are produced. One raw ` +
-        `database dump returned to the model is the usual whole overrun: return a ` +
-        `summary plus an id the model can ask about, not every row.\n` +
-        `  Fix 2 — .window(slidingWindow({ keepRecentTurns: 2 })) drops older ` +
-        `rounds before the request is assembled, so the conversation stops growing ` +
-        `without bound.\n` +
-        `  Fix 3 — .compaction() keeps a LONG conversation small, but it cannot ` +
-        `fold a span that is already bigger than the window: the summarizer call ` +
-        `sends that span, so it fails exactly as this call did. Fix the oversized ` +
-        `round first, then compact.\n` +
-        `  Provider said: ${args.providerMessage}`);
-}
-//# sourceMappingURL=contextWindow.js.map

package/dist/adapters/llm/contextWindow.js.map

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