agentfootprint 8.0.0 → 8.1.0

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

@@ -0,0 +1,61 @@
+/**
+ * OllamaThinkingHandler — normalizes a local reasoning model's thinking
+ * into the framework's `ThinkingBlock[]` contract.
+ *
+ * Local reasoning models (deepseek-r1, qwen3, gpt-oss, …) reason in the
+ * open, and where that reasoning LANDS depends on how they were asked:
+ *
+ *   1. ASKED (`ollama('qwen3', { think: true })`, or the agent's
+ *      `.thinking({ budget })`) — Ollama lifts the reasoning out of the
+ *      answer into `message.thinking`. The adapter forwards it as
+ *      `{ kind: 'field', thinking }`. This is the good path.
+ *
+ *   2. NOT ASKED — the same model writes `<think>…</think>` straight into
+ *      the answer text. The adapter recognizes the shape and forwards the
+ *      whole answer as `{ kind: 'inline', content }`.
+ *
+ * **The library recognizes the inline shape; it never rewrites the
+ * answer.** Blocks produced from case 2 describe text that is STILL
+ * present, verbatim, in `LLMResponse.content` — because silently editing
+ * a model's answer is a meaning change, and that is the application's
+ * decision to make, not this library's. If you want the reasoning out of
+ * the answer, ask for it: turn `think` on, and the model stops putting it
+ * there.
+ *
+ * **No signature** — nothing on this wire is signed, so there is no
+ * round-trip integrity invariant (unlike Anthropic). `signature` stays
+ * undefined.
+ *
+ * **No `summary` flag** — this is raw reasoning, not a structured summary
+ * (unlike OpenAI's `reasoning_summary`).
+ *
+ * **`parseChunk`** — the adapter already emits `LLMChunk.thinkingDelta`
+ * directly while streaming (Ollama sends `message.thinking` deltas frame
+ * by frame), so the framework does not need this to see live reasoning.
+ * It is implemented anyway for consumers driving the handler themselves.
+ */
+import type { ThinkingHandler } from './types.js';
+/**
+ * What `OllamaProvider` puts on `LLMResponse.rawThinking`.
+ *
+ * Tagged rather than a bare string so the handler never has to GUESS which
+ * of the two situations it is looking at — and so a consumer reading the
+ * raw value can tell whether the reasoning is also sitting in the answer.
+ */
+export type OllamaRawThinking = {
+    readonly kind: 'field';
+    readonly thinking: string;
+} | {
+    readonly kind: 'inline';
+    readonly content: string;
+};
+/**
+ * Pull the reasoning out of text that carries `<think>` tags.
+ *
+ * All tag PARSING lives here, in the handler — the adapter only notices
+ * that a `<think` substring is present and tags the payload accordingly.
+ * Exported so a consumer driving normalization by hand can reuse it.
+ */
+export declare function extractInlineThinking(text: string): readonly string[];
+export declare const ollamaThinkingHandler: ThinkingHandler;
+//# sourceMappingURL=OllamaThinkingHandler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OllamaThinkingHandler.d.ts","sourceRoot":"","sources":["../../../src/thinking/OllamaThinkingHandler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAiB,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAK1D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAUrE;AAMD,eAAO,MAAM,qBAAqB,EAAE,eAkCnC,CAAC"}

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

@@ -52,5 +52,6 @@ export type { ThinkingBlock, ThinkingHandler } from './types.js';
 export { mockThinkingHandler, mockAnthropicRaw, mockOpenAIRaw } from './MockThinkingHandler.js';
 export { anthropicThinkingHandler } from './AnthropicThinkingHandler.js';
 export { openAIThinkingHandler } from './OpenAIThinkingHandler.js';
+export { ollamaThinkingHandler, extractInlineThinking, type OllamaRawThinking, } from './OllamaThinkingHandler.js';
 export { SHIPPED_THINKING_HANDLERS, findThinkingHandler } from './registry.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/thinking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEhG,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/thinking/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AAEH,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEhG,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,KAAK,iBAAiB,GACvB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/thinking/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,eAAe,EAI/D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAKrF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/thinking/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,SAAS,eAAe,EAK/D,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAKrF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentfootprint",
-  "version": "8.0.0",
+  "version": "8.1.0",
   "description": "The explainable agent framework — backtrack a wrong answer to the exact context that caused it (evidence, not guesses). Built on footprintjs.",
   "license": "MIT",
   "type": "commonjs",
@@ -38,6 +38,8 @@
     "claude",
     "openai",
     "bedrock",
+    "ollama",
+    "local-llm",
     "mcp",
     "a2a",
     "human-in-the-loop",