agentfootprint 7.28.0 → 8.1.0

package/dist/doors/observe.js

@@ -0,0 +1,52 @@
+"use strict";
+/**
+ * agentfootprint/observe — everything that watches.
+ *
+ * One door for the whole watching story, which used to be nine:
+ *
+ *   • Recorders          — the Tier 1/2/3 observers, `recordRun`, the
+ *                          offline `Trace`, the context ledger.
+ *   • Diagnosis          — influence scoring, trace toolpack, context-bisect,
+ *                          tool lint, and the pluggable context-error finders.
+ *   • Vendor sinks       — AgentCore / CloudWatch / X-Ray / OTel strategies,
+ *                          plus the tamper-evident audit export.
+ *   • Strategy ports     — the observability / cost / live-status / lens
+ *                          interfaces and their `attach*` helpers.
+ *   • Delivery           — `toSSE` and friends, for streaming a run to a
+ *                          browser.
+ *   • Status + words     — the chat-bubble state machine AND the message
+ *                          catalogs it renders with. The logic and the prose
+ *                          are one story, so they are one door.
+ *
+ * The typed event stream those observers consume is its own door,
+ * `agentfootprint/events` — it is the wire vocabulary, not a watching tool.
+ *
+ * @example
+ * ```ts
+ * import { recordRun, toolChoiceRecorder, selectStatus } from 'agentfootprint/observe';
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../observe.js"), exports);
+__exportStar(require("../observability-providers.js"), exports);
+__exportStar(require("../strategies/index.js"), exports);
+__exportStar(require("../stream.js"), exports);
+__exportStar(require("../status.js"), exports);
+__exportStar(require("../debug.js"), exports);
+__exportStar(require("../debug/finders.js"), exports);
+__exportStar(require("../locales/index.js"), exports);
+//# sourceMappingURL=observe.js.map

package/dist/doors/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../src/doors/observe.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;;;;;;;;;;;;;;;;AAEH,gDAA8B;AAC9B,gEAA8C;AAC9C,yDAAuC;AACvC,+CAA6B;AAC7B,+CAA6B;AAC7B,8CAA4B;AAC5B,sDAAoC;AACpC,sDAAoC"}

package/dist/doors/providers.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * agentfootprint/providers — everything you plug a backend into.
+ *
+ * One door for every "here is the thing that actually does the work":
+ *
+ *   • LLM providers      — `mock`, `anthropic`, `openai`, `bedrock`, the
+ *                          browser variants, `createProvider`, and the
+ *                          `LLMProvider` port you implement for your own.
+ *   • Embedders          — `openaiEmbedder`, `localEmbedder`, `staticEmbedder`.
+ *   • Tool providers     — `staticTools`, `gatedTools`, `skillScopedTools`,
+ *                          plus the MCP client/server bridge.
+ *   • Thinking handlers  — per-vendor parsing of extended-thinking blocks,
+ *                          which is a provider concern wearing another hat.
+ *
+ * Each vendor SDK is lazy-required, so importing this door loads no vendor
+ * code — only calling a factory does.
+ *
+ * @example
+ * ```ts
+ * import { anthropic, staticTools, openaiEmbedder } from 'agentfootprint/providers';
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../llm-providers.js"), exports);
+__exportStar(require("../embedders/index.js"), exports);
+__exportStar(require("../tool-providers/index.js"), exports);
+__exportStar(require("../thinking/index.js"), exports);
+//# sourceMappingURL=providers.js.map

package/dist/doors/providers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.js","sourceRoot":"","sources":["../../src/doors/providers.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,wDAAsC;AACtC,6DAA2C;AAC3C,uDAAqC"}

package/dist/doors/resilience.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * agentfootprint/resilience — what happens when the call fails.
+ *
+ * Both halves of staying up, behind one name:
+ *
+ *   • Provider decorators — `withRetry`, `withFallback`, `fallbackProvider`,
+ *     `withCircuitBreaker`. Each preserves the `LLMProvider` interface, so
+ *     they stack freely around any provider.
+ *   • The rules engine — `.reliability({ postDecide: [...] })`'s typed rule
+ *     shapes, the fail-fast error, the pure breaker state machine, and the
+ *     schema-retry helpers.
+ *
+ * ## One name that exists twice, said out loud
+ *
+ * `CircuitOpenError` is TWO different classes: the decorator throws one
+ * (`src/resilience/withCircuitBreaker.ts`), the reliability gate throws
+ * another (`src/reliability/CircuitBreaker.ts`), and they differ in
+ * constructor and in `instanceof`. This door carries the DECORATOR's — the
+ * one a consumer catches, since it is the one that escapes a provider call.
+ *
+ * The gate's stays reachable at `agentfootprint/reliability` for all of 8.x.
+ * If you `instanceof`-check the error thrown by the reliability gate, keep
+ * importing it from there. Merging them would have changed the message text
+ * on one path, and this release changes packaging only.
+ *
+ * `CircuitState` also exists twice, but the two are byte-identical
+ * (`'closed' | 'open' | 'half-open'`), so the one re-exported here satisfies
+ * both and no consumer can tell the difference.
+ *
+ * @example
+ * ```ts
+ * import { withRetry, withFallback, type ReliabilityRule } from 'agentfootprint/resilience';
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationFailure = exports.ReliabilityFailFastError = exports.lastNValidationErrorsMatch = exports.initialBreakerState = exports.defaultStuckLoopRule = void 0;
+// The decorators, whole. This is also where the door's `CircuitOpenError`
+// and `CircuitState` come from — see the note above.
+__exportStar(require("../resilience/index.js"), exports);
+var index_js_1 = require("../reliability/index.js");
+Object.defineProperty(exports, "defaultStuckLoopRule", { enumerable: true, get: function () { return index_js_1.defaultStuckLoopRule; } });
+Object.defineProperty(exports, "initialBreakerState", { enumerable: true, get: function () { return index_js_1.initialBreakerState; } });
+Object.defineProperty(exports, "lastNValidationErrorsMatch", { enumerable: true, get: function () { return index_js_1.lastNValidationErrorsMatch; } });
+Object.defineProperty(exports, "ReliabilityFailFastError", { enumerable: true, get: function () { return index_js_1.ReliabilityFailFastError; } });
+Object.defineProperty(exports, "ValidationFailure", { enumerable: true, get: function () { return index_js_1.ValidationFailure; } });
+//# sourceMappingURL=resilience.js.map

package/dist/doors/resilience.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilience.js","sourceRoot":"","sources":["../../src/doors/resilience.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;;;;;;;;;;;;;;;;;AAEH,0EAA0E;AAC1E,qDAAqD;AACrD,yDAAuC;AAgBvC,oDAMiC;AAL/B,gHAAA,oBAAoB,OAAA;AACpB,+GAAA,mBAAmB,OAAA;AACnB,sHAAA,0BAA0B,OAAA;AAC1B,oHAAA,wBAAwB,OAAA;AACxB,6GAAA,iBAAiB,OAAA"}

package/dist/doors/security.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * agentfootprint/security — who may do what, and with whose credentials.
+ *
+ * Two halves of the same question:
+ *
+ *   • Authorization — `PermissionPolicy`, `PolicyHaltError`, the
+ *     `PermissionChecker` port, the remote `agentCorePolicy` engine, and
+ *     thinking-block redaction.
+ *   • Identity — the `CredentialProvider` port, the credential kinds
+ *     (`bearer`, `apiKey`, `basic`, `headers`), `staticTokens`,
+ *     `withCredentialRetry`, and `agentCoreIdentity`.
+ *
+ * A vended credential is a secret: use it locally inside a tool's `execute`
+ * and never write it to tracked scope.
+ *
+ * @example
+ * ```ts
+ * import { PermissionPolicy, agentCoreIdentity } from 'agentfootprint/security';
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("../security/index.js"), exports);
+__exportStar(require("../identity.js"), exports);
+//# sourceMappingURL=security.js.map

package/dist/doors/security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/doors/security.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;;;;;;;;;;;;AAEH,uDAAqC;AACrC,iDAA+B"}

package/dist/embedders/index.js.map

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

package/dist/esm/adapters/llm/OllamaProvider.d.ts

@@ -0,0 +1,182 @@
+/**
+ * OllamaProvider — local models over Ollama's native `/api/chat`.
+ *
+ * Pattern: Adapter (GoF) + Ports-and-Adapters (Cockburn 2005).
+ * Role:    Outer ring — translates `LLMRequest`/`LLMResponse` to/from
+ *          Ollama's native chat wire. Knows nothing about agents,
+ *          recorders, or compositions.
+ * Emits:   N/A.
+ *
+ * ─── Why this exists, and why it talks the native wire ───────────────
+ *
+ * The adapter ladder is `mock()` → a local model → a paid API, and the
+ * strongest version of "the test run and the production run are the same
+ * code path" is one where the middle step costs nothing and needs no API
+ * key. Through 8.0.0 the middle step needed BOTH a competitor's SDK
+ * (`npm install openai`, because `ollama()` was a thin wrapper over
+ * `openai({ baseURL })`) and a tolerance for failures labelled `[openai]`.
+ * That is not a free rung.
+ *
+ * So this file owns the wire:
+ *
+ *   • ZERO dependencies — one `fetch` POST and NDJSON. Nothing to install
+ *     beyond Ollama itself. (Same choice, same reasons, as the two
+ *     `Browser*Provider` adapters.)
+ *   • HONEST REFUSALS — a typed {@link OllamaUnavailableError} that names
+ *     the address it tried and the command to run. Owning the fetch and
+ *     the status code is what makes that possible; through an SDK you get
+ *     whatever the SDK decided to throw.
+ *   • REAL TOKEN COUNTS — `/api/chat` returns `prompt_eval_count` /
+ *     `eval_count` on every response, streaming or not, with no opt-in
+ *     flag. Through the OpenAI-compatible endpoint a streamed local call
+ *     reported ZERO tokens, which silently disarmed `.compaction()` and
+ *     `costBudget` (see `CompactionUnmeasurableError`, whose message names
+ *     this exact case).
+ *   • STRUCTURED THINKING — `message.thinking` is a first-class field on
+ *     this wire; the OpenAI-compatible layer renames it to a non-standard
+ *     `reasoning` key that no OpenAI adapter reads. See
+ *     `OllamaThinkingHandler`.
+ *
+ * Want the SDK path instead? It is still there and still supported:
+ * `openai({ baseURL: 'http://localhost:11434/v1', apiKey: 'ollama' })`.
+ *
+ * ─── Ceilings (stated, not worked around) ────────────────────────────
+ *
+ * • TOOL CALLING IS MODEL-DEPENDENT. Ollama forwards a `tools` array to
+ *   any model; a model that was not trained for tools simply answers in
+ *   prose and no tool call ever arrives. This adapter does not preflight
+ *   `/api/show` capabilities to refuse first — a wrong refusal is worse
+ *   than a weak answer, and the metadata is less reliable than the
+ *   ceiling being written down. Pick a tool-capable model.
+ * • NO FORCED TOOL CHOICE. Ollama does not support `tool_choice` on
+ *   either wire, so `carriesForcedToolChoice` is `false` and an agent
+ *   using `.outputSchema(parser, { strategy: 'tool-forced' })` refuses at
+ *   run start, naming this provider.
+ * • NO MULTI-MODAL. The wire carries `images`; `LLMMessage.content` is a
+ *   string. Same ceiling as every other adapter here.
+ * • NO PROMPT CACHING — resolves to the NoOp cache strategy.
+ * • NO `providerRef`. The native wire returns no response id, and a
+ *   fabricated one would point at nothing.
+ */
+import type { LLMCallHooks, LLMChunk, LLMProvider, LLMRequest, LLMResponse, WireRole } from '../types.js';
+/** How hard a thinking model should think. Ollama's own vocabulary. */
+export type ThinkLevel = 'low' | 'medium' | 'high' | 'max';
+/**
+ * The two failures a local runtime actually has, told in words that
+ * contain the fix.
+ *
+ * Both are things the person at the keyboard can resolve in one command,
+ * which is exactly why they get a type instead of a wrapped
+ * `ECONNREFUSED` or a bare `404`. `reason` is the discriminator; the
+ * message already reads as instructions.
+ */
+export declare class OllamaUnavailableError extends Error {
+    readonly name = "OllamaUnavailableError";
+    /** Which of the two situations this is. */
+    readonly reason: 'daemon-unreachable' | 'model-not-pulled';
+    /** The address that was tried — the thing to check or change. */
+    readonly baseUrl: string;
+    /** The model asked for. Absent when the daemon never answered at all. */
+    readonly model?: string;
+    /** Models this machine DOES have, when the daemon could tell us. */
+    readonly availableModels?: readonly string[];
+    constructor(init: {
+        reason: 'daemon-unreachable' | 'model-not-pulled';
+        baseUrl: string;
+        model?: string;
+        availableModels?: readonly string[];
+        cause?: unknown;
+    });
+}
+export interface OllamaProviderOptions {
+    /**
+     * Where Ollama is listening. Defaults to `OLLAMA_HOST` when set,
+     * otherwise `http://localhost:11434`. A bare `host:port` gets `http://`.
+     *
+     * Point it at the ROOT, not at a path — this adapter talks to
+     * `/api/chat` and `/api/tags` itself. A URL ending in `/v1` (the
+     * OpenAI-compatible path) is accepted and trimmed, so a config written
+     * for the 8.0.0 factory keeps working.
+     */
+    readonly baseUrl?: string;
+    /** Shipped-in-8.0.0 spelling of {@link baseUrl}. Still honored. */
+    readonly host?: string;
+    /** Shipped-in-8.0.0 spelling of {@link baseUrl}. Still honored. */
+    readonly baseURL?: string;
+    /**
+     * Model used when `LLMRequest.model` is the `'ollama'` shorthand.
+     * Prefer the positional form: `ollama('qwen3')`.
+     */
+    readonly defaultModel?: string;
+    /** Default token cap when the request doesn't set one. Maps to `num_predict`. */
+    readonly defaultMaxTokens?: number;
+    /**
+     * Ask a thinking model to reason before answering. `true` turns it on;
+     * `'low' | 'medium' | 'high' | 'max'` sets how hard.
+     *
+     * Worth setting on reasoning models (deepseek-r1, qwen3, gpt-oss, …):
+     * with `think` on, Ollama lifts the reasoning OUT of the answer into
+     * `message.thinking`, where `ollamaThinkingHandler` normalizes it.
+     * With it off, the same model leaves `<think>…</think>` sitting in the
+     * answer text.
+     *
+     * A per-request `LLMRequest.thinking` (what `AgentBuilder.thinking()`
+     * sets) also turns it on; this option is the always-on default and the
+     * only way to name a level.
+     */
+    readonly think?: boolean | ThinkLevel;
+    /** How long Ollama keeps the model in memory after a call, e.g. `'5m'`. */
+    readonly keepAlive?: string | number;
+    /**
+     * How long to wait for the daemon to ANSWER, in ms. Default 10000.
+     *
+     * This bounds the wait for response headers, NOT generation: a laptop
+     * model may take minutes to finish a long answer and that is fine. What
+     * it prevents is the failure this whole file exists to avoid — a run
+     * that hangs because nothing is listening.
+     */
+    readonly timeoutMs?: number;
+    /** Accepted and ignored — Ollama needs no key. Kept so 8.0.0 configs still typecheck. */
+    readonly apiKey?: string;
+    /** @internal Custom fetch implementation for tests. */
+    readonly _fetch?: typeof fetch;
+}
+/**
+ * Build an `LLMProvider` backed by a local Ollama runtime.
+ *
+ * Free, offline, no API key. The rung between `mock()` and a paid API —
+ * and the agent code above it does not change between the three.
+ *
+ * @example
+ *   import { Agent } from 'agentfootprint';
+ *   import { ollama } from 'agentfootprint/providers';
+ *
+ *   const agent = Agent.create({
+ *     provider: ollama('qwen3'),
+ *     model: 'qwen3',
+ *   }).build();
+ *
+ * @example  // reasoning model, thinking lifted out of the answer
+ *   ollama('deepseek-r1', { think: 'high' });
+ *
+ * @example  // a runtime on another machine
+ *   ollama('llama3.2', { baseUrl: 'http://192.168.1.20:11434' });
+ */
+export declare function ollama(model: string, options?: OllamaProviderOptions): LLMProvider;
+/**
+ * Object form, as shipped in 8.0.0. Still supported — `host` / `baseURL` /
+ * `defaultModel` / `apiKey` all keep their meaning.
+ */
+export declare function ollama(options?: OllamaProviderOptions): LLMProvider;
+/**
+ * Class form for consumers who prefer `new OllamaProvider(...)`.
+ */
+export declare class OllamaProvider implements LLMProvider {
+    readonly name = "ollama";
+    readonly carriesInMessages: readonly WireRole[];
+    readonly carriesForcedToolChoice = false;
+    private readonly inner;
+    constructor(model?: string | OllamaProviderOptions, options?: OllamaProviderOptions);
+    complete(req: LLMRequest, hooks?: LLMCallHooks): Promise<LLMResponse>;
+    stream(req: LLMRequest, hooks?: LLMCallHooks): AsyncIterable<LLMChunk>;
+}