agentfootprint 10.0.0 → 10.1.1

package/dist/types/thinking/dispatch.d.ts

@@ -0,0 +1,10 @@
+/** One raw-thinking envelope for a provider choice, shared by both routing paths. */
+import type { LLMProvider, LLMResponse } from '../adapters/types.js';
+import type { ThinkingHandler } from './types.js';
+/** Plain data only; handler functions stay in the chart's build-time closure. */
+export declare function tagThinkingResponse(response: LLMResponse, answeredBy: string): LLMResponse;
+/** Decode only with the handler belonging to the transport that answered. */
+export declare function dispatchThinkingHandler(id: string, handlers: Readonly<Record<string, ThinkingHandler | undefined>>, untagged?: ThinkingHandler): ThinkingHandler;
+/** Keep explicit override/null intent while routing declared handlers by list index. */
+export declare function thinkingForProviders(provider: LLMProvider, providers?: readonly LLMProvider[], override?: ThinkingHandler | null): ThinkingHandler | undefined;
+//# sourceMappingURL=dispatch.d.ts.map

package/dist/types/thinking/dispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../../src/thinking/dispatch.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAO1F;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAAC,CAAC,EAC/D,QAAQ,CAAC,EAAE,eAAe,GACzB,eAAe,CAoBjB;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,WAAW,EACrB,SAAS,GAAE,SAAS,WAAW,EAAO,EACtC,QAAQ,CAAC,EAAE,eAAe,GAAG,IAAI,GAChC,eAAe,GAAG,SAAS,CAgB7B"}

package/dist/types/thinking/errors.d.ts

@@ -1,5 +1,5 @@
 /**
- * UnsupportedThinkingError — a request to think that the model cannot take,
+ * UnsupportedThinkingError — a thinking request the provider/model pair cannot honor,
  * refused by name BEFORE anything is sent.
  *
  * Models on one wire disagree about thinking (see `ThinkingMode`), and the
@@ -8,7 +8,7 @@
  * refusal happens here instead, with the fix in the message:
  *
  * - at `Agent.build()`, when the provider DECLARES (`LLMProvider.thinkingMode`)
- *   that a model the agent will call cannot think (`reason: 'no-thinking'`);
+ *   that thinking is unsupported for a model the agent will call (`reason: 'no-thinking'`);
  * - in the adapter, before the request leaves, for a model chosen at run time
  *   and for the combinations the wire rejects whenever thinking is on
  *   (`'budget'`, `'temperature'`, `'forced-tool-choice'`).
@@ -36,7 +36,7 @@ export declare class UnsupportedThinkingError extends Error {
     readonly model: string;
     /**
      * Why the request cannot be sent:
-     * - `'no-thinking'` — the model cannot think at all;
+     * - `'no-thinking'` — thinking is unsupported by the provider/model pair;
      * - `'budget'` — the budget is not one the model's `budget_tokens` accepts;
      * - `'temperature'` — a temperature other than the default, which the wire
      *   rejects while thinking is on;

package/dist/types/thinking/replay.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Replay evidence and reports. JSON data only: no second copy of conversation
+ * text, tool arguments, signatures or credentials. The concrete wire owns
+ * capture and comparison; the run owns persistence and observation.
+ */
+import type { LLMRequest } from '../adapters/types.js';
+/** The order of already-stored content and its supported inert wire metadata. */
+export type ReplayPart = {
+    readonly type: 'text';
+    readonly length: number;
+    readonly citations?: null | readonly [];
+} | {
+    readonly type: 'thinking';
+    readonly index: number;
+} | {
+    readonly type: 'tool';
+    readonly index: number;
+    readonly caller?: {
+        readonly type: 'direct';
+    };
+    readonly toolset_name?: null;
+};
+/** Versioned, serializable evidence for an assistant message's wire replay. */
+export interface MessageReplay {
+    readonly version: 1;
+    readonly protocol: 'anthropic-messages';
+    /** Provider response identity; not a cryptographic authenticity claim. */
+    readonly id: string;
+    readonly layout: readonly ReplayPart[];
+    readonly stopReason: string;
+    readonly contentDigest: string;
+    /** The adapter observed content it could not preserve; never a fidelity proof. */
+    readonly lossy?: true;
+    readonly binding?: {
+        readonly model: string;
+        readonly salt: string;
+        readonly system: string;
+        readonly tools: string;
+        readonly messages: string;
+        readonly priorThinking: readonly string[];
+    };
+    /** A permitted omission is durable, not a request-local hiding flag. */
+    readonly thinkingRetired?: true;
+}
+/** A library-known replay inconsistency, never a decoded signature verdict. */
+export type ThinkingReplayReason = 'prefix-changed' | 'content-changed' | 'sequence-changed' | 'thinking-retired' | 'missing-signature';
+/** One removed block. Deliberately contains no reasoning or signed material. */
+export interface ThinkingReplayOmission {
+    readonly messageIndex: number;
+    readonly blockIndex: number;
+    readonly reason: ThinkingReplayReason;
+    readonly replayId?: string;
+    /** Matches an unstamped caller-owned message without retaining its values. */
+    readonly messageFingerprint: string;
+}
+/** A leaf adapter's actual request adjustment, reported before transport. */
+export interface ReplayPreparation {
+    readonly provider: string;
+    readonly model: string;
+    readonly request: LLMRequest;
+    readonly omissions: readonly ThinkingReplayOmission[];
+}
+/** Required active-turn thinking cannot be replayed safely. Not retryable. */
+export declare class UnsafeThinkingReplayError extends Error {
+    readonly provider: string;
+    readonly model: string;
+    readonly messageIndex: number;
+    readonly reason: ThinkingReplayReason;
+    readonly code = "UNSAFE_THINKING_REPLAY";
+    readonly retryable = false;
+    constructor(provider: string, model: string, messageIndex: number, reason: ThinkingReplayReason);
+}
+//# sourceMappingURL=replay.d.ts.map

package/dist/types/thinking/replay.d.ts.map

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

package/dist/types/thinking/replayHistory.d.ts

@@ -0,0 +1,19 @@
+/** Pure message matching for durable omissions; no second conversation store. */
+import type { LLMMessage } from '../adapters/types.js';
+import type { ReplayPreparation } from './replay.js';
+/** Only an approved thinking edit, never a replacement conversation or tool result. */
+export interface ReplayRetirement {
+    readonly replayId?: string;
+    readonly messageFingerprint: string;
+    readonly thinkingBlocks: LLMMessage['thinkingBlocks'];
+    readonly replay?: LLMMessage['replay'];
+}
+/** Narrow a transport report before a checkpoint owner retains it. */
+export declare function replayRetirements(preparation: ReplayPreparation): readonly ReplayRetirement[];
+/** A local matching key, not a signature validator or public authentication. */
+export declare function replayMessageFingerprint(message: LLMMessage): string;
+/** Apply only reported thinking omissions, retaining all host-owned metadata. */
+export declare function retireReplayHistory(history: readonly LLMMessage[], preparation: ReplayPreparation): readonly LLMMessage[];
+/** One identity rule for live history, retries and both checkpoint doors. */
+export declare function applyReplayRetirements(history: readonly LLMMessage[], retirements: readonly ReplayRetirement[]): readonly LLMMessage[];
+//# sourceMappingURL=replayHistory.d.ts.map

package/dist/types/thinking/replayHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replayHistory.d.ts","sourceRoot":"","sources":["../../../src/thinking/replayHistory.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAIrD,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,sEAAsE;AACtE,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,iBAAiB,GAAG,SAAS,gBAAgB,EAAE,CAiB7F;AAED,gFAAgF;AAChF,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,UAAU,GAAG,MAAM,CASpE;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,WAAW,EAAE,iBAAiB,GAC7B,SAAS,UAAU,EAAE,CAEvB;AAED,6EAA6E;AAC7E,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,WAAW,EAAE,SAAS,gBAAgB,EAAE,GACvC,SAAS,UAAU,EAAE,CAkBvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "10.0.0",
+  "version": "10.1.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",
@@ -483,7 +483,7 @@
     "esbuild": "^0.28.0",
     "eslint": "^8.44.0",
     "eslint-config-prettier": "^6.15.0",
-    "footprintjs": "^9.47.0",
+    "footprintjs": "^10.0.0",
     "google-auth-library": "^11.0.1",
     "jose": "^6.2.7",
     "ldapts": "^9.2.0",