agentfootprint 8.0.0 → 8.2.0

package/dist/core/agent/window/folded.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * window/folded — join a summary sitting in a conversation back to what it
+ * stands for.
+ *
+ * Pattern: Pure lookup over recorded facts. No I/O, no inference.
+ * Role:    core/ layer, and the ONE public door onto retained originals.
+ * Emits:   N/A.
+ *
+ * ── Why a fingerprint and not an index ──────────────────────────────────────
+ * The obvious join key is "the summary is at `history[3]`". It is also wrong.
+ * A later fold swallows the span that CONTAINS an earlier summary, and every
+ * index after it moves; a conversation that folded four times would need its
+ * stored indices rewritten on every fold, and any reader holding an old one
+ * would silently be pointing at somebody else's message.
+ *
+ * So the join key is a fingerprint of the summary message's full content —
+ * authored frame included. Three things follow, and all three are the point:
+ *
+ *   • it costs NO extra bytes on the wire (no id token planted in the frame);
+ *   • it survives JSON, storage, and being read by a runtime that has never
+ *     heard of this function;
+ *   • it cannot be FORGED. A model that writes a message opening with the
+ *     frame's own words produces different content, therefore a different
+ *     fingerprint, therefore no match — `isCompactedSummary` alone says "this
+ *     LOOKS like a frame", and this says "this IS the frame of a fold that was
+ *     recorded". The two answers are different questions and the gap between
+ *     them is exactly where a forgery would live.
+ *
+ * ── Absent is an answer ─────────────────────────────────────────────────────
+ * `undefined` means "no fold was recorded for this message" and never "there
+ * were no originals". A conversation stored by 8.1 has summaries and no spans
+ * at all; one folded under `retain: 'discard'` has a span whose `messages` is
+ * absent. Those are three different facts and the caller can tell them apart:
+ * no span, a span with no messages, a span with messages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.foldedMessages = exports.foldedSpanFor = exports.summaryFingerprint = void 0;
+const helpers_js_1 = require("../../slots/helpers.js");
+/**
+ * The join key for one summary message: a fingerprint of its whole content.
+ *
+ * @internal Consumers join through {@link foldedSpanFor}; this is exported for
+ *   the strategy that stamps the span and for tests that pin the two agree.
+ */
+function summaryFingerprint(content) {
+    return (0, helpers_js_1.fnv1a)(content);
+}
+exports.summaryFingerprint = summaryFingerprint;
+/**
+ * What one summary message in a conversation stands for.
+ *
+ * Hand it the conversation you stored and a message out of its `history`; get
+ * back the fold that produced that message, with the original messages when
+ * the policy retained them.
+ *
+ * @returns the span, or `undefined` when this conversation recorded no fold
+ *   for this message — see "Absent is an answer" above.
+ *
+ * @example  Show a user what the agent actually saw last week
+ * ```ts
+ * import { foldedSpanFor, isCompactedSummary } from 'agentfootprint';
+ *
+ * const conversation = readEnvelope(await sessions.hydrate(sessionId));
+ * for (const message of conversation.history) {
+ *   if (!isCompactedSummary(message)) continue;
+ *   const span = foldedSpanFor(conversation, message);
+ *   console.log(`summary of ${span?.messageCount ?? '?'} messages`);
+ *   for (const original of span?.messages ?? []) {
+ *     console.log(`  ${original.role}: ${original.content}`);
+ *   }
+ * }
+ * ```
+ */
+function foldedSpanFor(conversation, message) {
+    const spans = conversation.folded;
+    if (spans === undefined || spans.length === 0)
+        return undefined;
+    const fingerprint = summaryFingerprint(message.content);
+    return spans.find((span) => span.summaryFingerprint === fingerprint);
+}
+exports.foldedSpanFor = foldedSpanFor;
+/**
+ * Every message this conversation ever folded, oldest fold first, flattened.
+ *
+ * The transcript-shaped answer to `foldedSpanFor`'s message-shaped one: what
+ * a support view prints when somebody asks what the agent was told before the
+ * summaries. Spans that were discarded contribute nothing — they have nothing
+ * to contribute, and `foldedSpanFor` is where you find out that they existed.
+ */
+function foldedMessages(conversation) {
+    const out = [];
+    for (const span of conversation.folded ?? [])
+        out.push(...(span.messages ?? []));
+    return out;
+}
+exports.foldedMessages = foldedMessages;
+//# sourceMappingURL=folded.js.map

package/dist/core/agent/window/folded.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folded.js","sourceRoot":"","sources":["../../../../src/core/agent/window/folded.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;;;AAEH,uDAA+C;AAI/C;;;;;GAKG;AACH,SAAgB,kBAAkB,CAAC,OAAe;IAChD,OAAO,IAAA,kBAAK,EAAC,OAAO,CAAC,CAAC;AACxB,CAAC;AAFD,gDAEC;AAcD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,SAAgB,aAAa,CAC3B,YAAgC,EAChC,OAAmB;IAEnB,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAChE,MAAM,WAAW,GAAG,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,KAAK,WAAW,CAAC,CAAC;AACvE,CAAC;AARD,sCAQC;AAED;;;;;;;GAOG;AACH,SAAgB,cAAc,CAAC,YAAgC;IAC7D,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,MAAM,IAAI,EAAE;QAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC;IACjF,OAAO,GAAG,CAAC;AACb,CAAC;AAJD,wCAIC"}

package/dist/core/agent/window/index.js

@@ -9,6 +9,11 @@
  * is a claim about the past, so this library files it as a claim — not as the
  * past. A drop is an absence, and it is named the same way.
  *
+ * A commit log lives as long as the process. A conversation lives longer, so
+ * `.compaction({ retain })` also carries the folded originals on the
+ * conversation checkpoint — `foldedSpanFor(conversation, message)` is the door
+ * back to them, in this process or the one after the deploy.
+ *
  * Three strategies ship, all sharing one turn segmentation and one refusal
  * engine:
  *   `summarizeOldest`  fold the oldest span into a summary (`.compaction()`)
@@ -18,9 +23,12 @@
  * Public surface (re-exported from the package root).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.tokenBudget = exports.slidingWindow = exports.summarizeOldest = exports.isDropNotice = exports.DROP_NOTICE_PREFIX = exports.isCompactedSummary = exports.COMPACTED_FRAME_PREFIX = exports.CompactionUnmeasurableError = void 0;
+exports.tokenBudget = exports.slidingWindow = exports.summarizeOldest = exports.isDropNotice = exports.DROP_NOTICE_PREFIX = exports.isCompactedSummary = exports.COMPACTED_FRAME_PREFIX = exports.foldedSpanFor = exports.foldedMessages = exports.CompactionUnmeasurableError = void 0;
 var errors_js_1 = require("./errors.js");
 Object.defineProperty(exports, "CompactionUnmeasurableError", { enumerable: true, get: function () { return errors_js_1.CompactionUnmeasurableError; } });
+var folded_js_1 = require("./folded.js");
+Object.defineProperty(exports, "foldedMessages", { enumerable: true, get: function () { return folded_js_1.foldedMessages; } });
+Object.defineProperty(exports, "foldedSpanFor", { enumerable: true, get: function () { return folded_js_1.foldedSpanFor; } });
 var summarize_js_1 = require("./summarize.js");
 Object.defineProperty(exports, "COMPACTED_FRAME_PREFIX", { enumerable: true, get: function () { return summarize_js_1.COMPACTED_FRAME_PREFIX; } });
 Object.defineProperty(exports, "isCompactedSummary", { enumerable: true, get: function () { return summarize_js_1.isCompactedSummary; } });

package/dist/core/agent/window/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/agent/window/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,yCAA0D;AAAjD,wHAAA,2BAA2B,OAAA;AAuBpC,+CAA4E;AAAnE,sHAAA,sBAAsB,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AACnD,yCAA+D;AAAtD,+GAAA,kBAAkB,OAAA;AAAE,yGAAA,YAAY,OAAA;AACzC,sEAAkE;AAAzD,qHAAA,eAAe,OAAA;AACxB,kEAA8D;AAArD,iHAAA,aAAa,OAAA;AACtB,8DAA0D;AAAjD,6GAAA,WAAW,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/agent/window/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,yCAA0D;AAAjD,wHAAA,2BAA2B,OAAA;AAiBpC,yCAAqF;AAA5E,2GAAA,cAAc,OAAA;AAAE,0GAAA,aAAa,OAAA;AAStC,+CAA4E;AAAnE,sHAAA,sBAAsB,OAAA;AAAE,kHAAA,kBAAkB,OAAA;AACnD,yCAA+D;AAAtD,+GAAA,kBAAkB,OAAA;AAAE,yGAAA,YAAY,OAAA;AACzC,sEAAkE;AAAzD,qHAAA,eAAe,OAAA;AACxB,kEAA8D;AAArD,iHAAA,aAAa,OAAA;AACtB,8DAA0D;AAAjD,6GAAA,WAAW,OAAA"}

package/dist/core/agent/window/options.js

@@ -15,9 +15,16 @@
  * money to discover.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolveTokenBudgetOptions = exports.resolveSlidingWindowOptions = exports.resolveCompactionOptions = exports.DEFAULT_KEEP_RECENT_TURNS = void 0;
+exports.resolveTokenBudgetOptions = exports.resolveSlidingWindowOptions = exports.resolveCompactionOptions = exports.DEFAULT_RETENTION = exports.DEFAULT_KEEP_RECENT_TURNS = void 0;
 /** Default depth of the "never touch this" recent window. */
 exports.DEFAULT_KEEP_RECENT_TURNS = 6;
+/**
+ * What happens to folded messages when nobody said. The originals ride with
+ * the conversation: losing them has to be a choice somebody typed, not a
+ * default they inherited.
+ */
+exports.DEFAULT_RETENTION = 'conversation';
+const RETENTIONS = ['conversation', 'discard'];
 function requireObject(options, label, shape) {
     if (options === null || typeof options !== 'object') {
         throw new Error(`${label}: expected an options object (${shape}), got ${typeof options}.`);
@@ -46,7 +53,7 @@ function requireKeepRecentTurns(keepRecentTurns, label) {
  */
 function resolveCompactionOptions(options, label) {
     requireObject(options, label, '{ thresholdTokens, summarizer, ... }');
-    const { thresholdTokens, summarizer, keepRecentTurns, model } = options;
+    const { thresholdTokens, summarizer, keepRecentTurns, model, retain } = options;
     requireThreshold(thresholdTokens, label);
     if (summarizer === null ||
         typeof summarizer !== 'object' ||
@@ -60,11 +67,20 @@ function resolveCompactionOptions(options, label) {
     if (model !== undefined && (typeof model !== 'string' || model.length === 0)) {
         throw new Error(`${label}: model must be a non-empty model id, got ${String(model)}.`);
     }
+    if (retain !== undefined && !RETENTIONS.includes(retain)) {
+        throw new Error(`${label}: retain must be ${RETENTIONS.map((r) => `'${r}'`).join(' or ')}, got ` +
+            `${String(retain)}. It decides what happens to the messages a fold removes: ` +
+            `'conversation' (the default) carries them on the conversation checkpoint so a ` +
+            `restart can still produce them, and 'discard' does not. A value this library does ` +
+            `not recognise is refused rather than treated as one of them — guessing here would ` +
+            `mean guessing whether to keep somebody's transcript.`);
+    }
     return {
         thresholdTokens,
         keepRecentTurns: keepRecentTurns ?? exports.DEFAULT_KEEP_RECENT_TURNS,
         summarizer,
         model,
+        retain: retain ?? exports.DEFAULT_RETENTION,
     };
 }
 exports.resolveCompactionOptions = resolveCompactionOptions;

package/dist/core/agent/window/options.js.map

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

package/dist/core/agent/window/strategies/slidingWindow.js

@@ -40,10 +40,10 @@ exports.SLIDING_WINDOW = 'sliding-window';
  * @example
  * ```ts
  * import { Agent, slidingWindow } from 'agentfootprint';
- * import { ollama } from 'agentfootprint/llm-providers';
+ * import { ollama } from 'agentfootprint/providers';
  *
  * // Works on a provider that reports no usage at all: the trigger is turns.
- * const agent = Agent.create({ provider: ollama(), model: 'llama3' })
+ * const agent = Agent.create({ provider: ollama('llama3.2'), model: 'llama3.2' })
  *   .window(slidingWindow({ keepRecentTurns: 12 }))
  *   .build();
  * ```

package/dist/core/agent/window/strategies/summarizeOldest.js

@@ -11,8 +11,10 @@
  * This is what `.compaction({...})` configures, and the market's familiar
  * move (Claude Code / the Claude Agent SDK call it compaction). What is
  * different here is not the fold — it is that the fold is filed as a claim:
- * a summary is a claim ABOUT the past, and the past itself stays in the
- * commit log, byte for byte.
+ * a summary is a claim ABOUT the past, and the past itself stays. In the
+ * commit log for as long as the process lives, and — since 8.2, under
+ * `retain: 'conversation'` — on the conversation checkpoint for as long as
+ * the conversation does, which is the half a standing agent actually needs.
  *
  * Everything it decides, it explains. Every engaged path returns a record —
  * including the paths that change nothing, which are the ones a person
@@ -21,6 +23,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.summarizeOldest = exports.SUMMARIZE_OLDEST = void 0;
 const errors_js_1 = require("../errors.js");
+const folded_js_1 = require("../folded.js");
 const options_js_1 = require("../options.js");
 const removal_js_1 = require("../removal.js");
 const summarize_js_1 = require("../summarize.js");
@@ -125,6 +128,7 @@ function summarizeOldest(options) {
                 foldedMessageCount: span.length,
                 iteration,
                 model,
+                retain: config.retain,
             });
             const spend = { model, usage: summary.usage };
             // Would the fold actually help? A summary plus its authored frame can be
@@ -143,6 +147,24 @@ function summarizeOldest(options) {
             const foldedAtMs = input.now();
             const facts = input.removalFacts((0, removal_js_1.indexRange)(spanStart, spanEnd), foldedAtMs);
             const window = [...head, summaryMessage, ...tail];
+            // The durable half. It rides the SAME result the window change rides,
+            // so the stage commits both together — there is no ordering in which
+            // the messages leave and the record of what they were does not follow.
+            // Under 'discard' the span is still filed: a discard is an absence, and
+            // this family files absences the same way it files claims.
+            const foldedSpan = {
+                summaryFingerprint: (0, folded_js_1.summaryFingerprint)(summaryMessage.content),
+                runId: input.runId,
+                iteration,
+                foldedAtMs,
+                model,
+                messageCount: span.length,
+                removedStageIds: facts.removedStageIds,
+                retained: config.retain,
+                // Detached before it is handed on: `history` came off a live scope and
+                // a stored conversation must never hold a reference into the heap.
+                ...(config.retain === 'conversation' && { messages: span.map((m) => ({ ...m })) }),
+            };
             const record = {
                 ...base,
                 removedStageIds: facts.removedStageIds,
@@ -164,6 +186,7 @@ function summarizeOldest(options) {
                 },
                 record,
                 evictions: facts.evictions,
+                folded: [foldedSpan],
                 budgetPressure: {
                     capTokens: config.thresholdTokens,
                     projectedTokens: measured.input,

package/dist/core/agent/window/strategies/summarizeOldest.js.map

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

package/dist/core/agent/window/summarize.js

@@ -18,6 +18,11 @@
  *
  *          The frame is authored. The summary is data. Neither can become
  *          the other.
+ *
+ *          A third rule joined them in 8.2: the frame may only claim what is
+ *          true. It names where the folded messages went, and it reads that
+ *          from the resolved retention policy rather than asserting a
+ *          constant — see {@link retentionSentence}.
  * Emits:   N/A (the stage emits; this file only builds and calls).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
@@ -60,6 +65,23 @@ function renderTranscript(messages) {
     return [TRANSCRIPT_OPEN, ...messages.map(renderMessage), TRANSCRIPT_CLOSE].join('\n');
 }
 exports.renderTranscript = renderTranscript;
+/**
+ * Where the folded messages went, said in the frame itself.
+ *
+ * Through 8.1 this sentence was a constant: *"The folded messages are retained
+ * verbatim in this run's commit log."* True inside the process, and false the
+ * moment the run ended — which is exactly when a standing agent reads it back
+ * out of storage. A library asserting something false inside the model's own
+ * context is worse than saying nothing, so the sentence is now written FROM
+ * the resolved retention policy and can only say what actually happened.
+ */
+function retentionSentence(retain) {
+    return retain === 'conversation'
+        ? `The folded messages are retained verbatim with this conversation and can be produced ` +
+            `on request.`
+        : `The folded messages were not retained beyond the run that folded them; only this ` +
+            `summary carries them forward.`;
+}
 /**
  * Build the message that replaces the folded span IN THE WINDOW.
  *
@@ -69,12 +91,16 @@ exports.renderTranscript = renderTranscript;
  * The label is written by this function and always comes first. `summary` is
  * appended to it verbatim: the library never edits model output, and it never
  * lets model output speak in the library's voice either.
+ *
+ * The label states the retention policy, and states it truthfully — see
+ * {@link retentionSentence}. `COMPACTED_FRAME_PREFIX` is unchanged: it is what
+ * every reader and every test matches on, and it stays put.
  */
 function buildSummaryMessage(summary, facts) {
     const label = `${exports.COMPACTED_FRAME_PREFIX} — ${facts.foldedMessageCount} earlier message(s) were folded ` +
         `out of this window at iteration ${facts.iteration}. The text after this line is a SUMMARY ` +
         `written by ${facts.model}; it is a claim about the conversation, not the conversation. ` +
-        `The folded messages are retained verbatim in this run's commit log.]`;
+        `${retentionSentence(facts.retain)}]`;
     return { role: 'user', content: `${label}\n\n${summary}` };
 }
 exports.buildSummaryMessage = buildSummaryMessage;

package/dist/core/agent/window/summarize.js.map

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

package/dist/core/agent/window/types.js

@@ -18,6 +18,12 @@
  * filed as a claim — its own recorded step, naming every `runtimeStageId` it
  * folded. A drop is an ABSENCE, and it is filed the same way: the record and
  * the eviction events name what left, by id.
+ *
+ * That law holds for as long as the PROCESS holds — a commit log is memory.
+ * A conversation outlives its process, so the durable half of the same law
+ * lives on the conversation checkpoint: `.compaction({ retain })` carries the
+ * folded originals there, beside the summary that stands for them. See
+ * {@link CompactionRetention} and {@link FoldedSpan}.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=types.js.map

package/dist/core/agent/window/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/agent/window/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/core/agent/window/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG"}

package/dist/core/runCheckpoint.js

@@ -107,7 +107,14 @@ exports.RunCheckpointError = RunCheckpointError;
  *
  * @internal
  */
-function buildCheckpoint(tracker, failurePoint) {
+function buildCheckpoint(tracker, failurePoint, 
+/**
+ * Spans this run folded, read from committed state by the caller. Passed in
+ * rather than tracked, because the tracker follows `history` through events
+ * and a fold's span is committed state — and because the same reader then
+ * serves both checkpoint carriers, so neither can lose what the other keeps.
+ */
+folded) {
     return {
         version: 1,
         runId: tracker.runId,
@@ -116,6 +123,7 @@ function buildCheckpoint(tracker, failurePoint) {
         originalInput: tracker.originalInput,
         checkpointedAt: Date.now(),
         ...(failurePoint && { failurePoint }),
+        ...(folded !== undefined && folded.length > 0 && { folded }),
     };
 }
 exports.buildCheckpoint = buildCheckpoint;

package/dist/core/runCheckpoint.js.map

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