@molecule/api-ai-agents-llm 1.0.3 → 1.0.4

package/README.md

@@ -3,7 +3,7 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-16T23:28:05.760Z
+Generated: 2026-10-26T04:27:09.169Z
 -->
 
 # @molecule/api-ai-agents-llm
@@ -173,6 +173,11 @@ prefix on each of up to `maxSteps` turns. Note `onEvent` is only an
 INCREMENTAL live hook while streaming — with `stream: false` it fires once
 per turn with the whole response.
 
+`input.thinking` forwards the core chat contract's native thinking settings
+on every turn. Streamed reasoning is retained in `ChatMessage.reasoning`
+across tool calls, separately from assistant text and tool arguments.
+Omitting the option does not enable thinking or manufacture reasoning.
+
 Failure semantics (how to tell failure modes apart):
 
 - **Tool failure** (throwing `execute()`, unknown tool name) — NON-fatal:

package/dist/index.d.ts

@@ -62,6 +62,11 @@
  * INCREMENTAL live hook while streaming — with `stream: false` it fires once
  * per turn with the whole response.
  *
+ * `input.thinking` forwards the core chat contract's native thinking settings
+ * on every turn. Streamed reasoning is retained in `ChatMessage.reasoning`
+ * across tool calls, separately from assistant text and tool arguments.
+ * Omitting the option does not enable thinking or manufacture reasoning.
+ *
  * Failure semantics (how to tell failure modes apart):
  * - **Tool failure** (throwing `execute()`, unknown tool name) — NON-fatal:
  *   recorded on the step with `isError: true` and fed back to the model.

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmFG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwFG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA"}

package/dist/index.js

@@ -62,6 +62,11 @@
  * INCREMENTAL live hook while streaming — with `stream: false` it fires once
  * per turn with the whole response.
  *
+ * `input.thinking` forwards the core chat contract's native thinking settings
+ * on every turn. Streamed reasoning is retained in `ChatMessage.reasoning`
+ * across tool calls, separately from assistant text and tool arguments.
+ * Omitting the option does not enable thinking or manufacture reasoning.
+ *
  * Failure semantics (how to tell failure modes apart):
  * - **Tool failure** (throwing `execute()`, unknown tool name) — NON-fatal:
  *   recorded on the step with `isError: true` and fed back to the model.

package/dist/provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,YAAY,CAAA;AAOnB,OAAO,KAAK,EAKV,gBAAgB,EACjB,MAAM,yBAAyB,CAAA;AAkHhC;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,gBA2KtB,CAAA"}
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,YAAY,CAAA;AAOnB,OAAO,KAAK,EAKV,gBAAgB,EACjB,MAAM,yBAAyB,CAAA;AAuHhC;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,EAAE,gBAiLtB,CAAA"}

package/dist/provider.js

@@ -11,9 +11,8 @@
  *
  * @module
  */
-// Side-effect import: registers the `stream`/`cacheControl` module
-// augmentation on `AgentRunInput` (see types.ts) so `input.stream` and
-// `input.cacheControl` below are typed, not `any`.
+// Side-effect import: augments AgentRunInput with this bond's typed request
+// options (see types.ts).
 import './types.js';
 import { getProviderByName as getAiProviderByName, requireProvider as requireAiProvider, } from '@molecule/api-ai';
 import { t } from '@molecule/api-i18n';
@@ -66,6 +65,7 @@ function stringifyResult(result) {
  */
 async function drainStream(stream, onEvent) {
     let text = '';
+    let reasoning;
     const toolUses = [];
     const usage = { inputTokens: 0, outputTokens: 0 };
     let errorMessage;
@@ -77,6 +77,9 @@ async function drainStream(stream, onEvent) {
             case 'text':
                 text += event.content;
                 break;
+            case 'thinking':
+                reasoning = (reasoning ?? '') + event.content;
+                break;
             case 'tool_use':
                 toolUses.push({ id: event.id, name: event.name, input: event.input });
                 break;
@@ -103,7 +106,7 @@ async function drainStream(stream, onEvent) {
     if (!sawDone && lastSnapshot) {
         addUsage(usage, lastSnapshot);
     }
-    return { text, toolUses, usage, errorMessage };
+    return { text, reasoning, toolUses, usage, errorMessage };
 }
 /**
  * The LLM-backed AI agents provider: a tool-calling loop over the bonded `ai`
@@ -158,6 +161,8 @@ export const provider = {
                     model: input.model,
                     maxTokens: input.maxTokens,
                     temperature: input.temperature,
+                    // Keep the caller's native thinking settings on every tool turn.
+                    ...(input.thinking === undefined ? {} : { thinking: input.thinking }),
                     // Defaults to streaming (see the `stream` augmentation in
                     // types.ts): onEvent is a LIVE hook, and non-streaming requests
                     // with large outputs (a big tool input at a raised maxTokens) are
@@ -194,7 +199,11 @@ export const provider = {
                 for (const tu of turn.toolUses) {
                     assistantContent.push({ type: 'tool_use', id: tu.id, name: tu.name, input: tu.input });
                 }
-                messages.push({ role: 'assistant', content: assistantContent });
+                messages.push({
+                    role: 'assistant',
+                    content: assistantContent,
+                    ...(turn.reasoning === undefined ? {} : { reasoning: turn.reasoning }),
+                });
                 if (turn.toolUses.length === 0) {
                     // No tools requested — the model is done.
                     return { output: turn.text, steps, usage };

package/dist/types.d.ts

@@ -1,21 +1,29 @@
 /**
  * Module augmentation: extends the core `@molecule/api-ai-agents` contract's
- * `AgentRunInput` with two options this bond's `run()` honors.
+ * `AgentRunInput` with options this bond's `run()` honors.
  *
  * @remarks
- * Both fields are ADDITIVE ONLY — they never widen or erase an existing
+ * These fields are ADDITIVE ONLY — they never widen or erase an existing
  * `AgentRunInput` field — and are consumed exclusively by this bond's `run()`
  * implementation; a different `AIAgentsProvider` bond is free to ignore them.
  * Any file that imports `@molecule/api-ai-agents-llm` (directly, or
  * transitively by bonding its `provider`) sees the merged `AgentRunInput`
  * type, matching the shape `@molecule/api-ai`'s `ChatParams` already accepts
- * for `stream` and `cacheControl`.
+ * for `stream`, `cacheControl`, and `thinking`.
  *
  * @module
  */
 import '@molecule/api-ai-agents';
+import type { ChatParams } from '@molecule/api-ai';
 declare module '@molecule/api-ai-agents' {
     interface AgentRunInput {
+        /**
+         * Native thinking settings forwarded unchanged on every model turn.
+         * Streamed thinking is retained as `ChatMessage.reasoning` when a tool
+         * call continues, so providers that replay reasoning receive it intact.
+         * Omitting this option does not enable thinking.
+         */
+        thinking?: ChatParams['thinking'];
         /**
          * Whether each model turn streams its response (default `true`).
          *

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,yBAAyB,CAAA;AAEhC,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,aAAa;QACrB;;;;;;;;;;;;;;WAcG;QACH,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB;;;;;;WAMG;QACH,YAAY,CAAC,EAAE;YAAE,IAAI,EAAE,WAAW,CAAA;SAAE,CAAA;KACrC;CACF"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAElD,OAAO,QAAQ,yBAAyB,CAAC;IACvC,UAAU,aAAa;QACrB;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,UAAU,CAAC,UAAU,CAAC,CAAA;QACjC;;;;;;;;;;;;;;WAcG;QACH,MAAM,CAAC,EAAE,OAAO,CAAA;QAChB;;;;;;WAMG;QACH,YAAY,CAAC,EAAE;YAAE,IAAI,EAAE,WAAW,CAAA;SAAE,CAAA;KACrC;CACF"}

package/dist/types.js

@@ -1,15 +1,15 @@
 /**
  * Module augmentation: extends the core `@molecule/api-ai-agents` contract's
- * `AgentRunInput` with two options this bond's `run()` honors.
+ * `AgentRunInput` with options this bond's `run()` honors.
  *
  * @remarks
- * Both fields are ADDITIVE ONLY — they never widen or erase an existing
+ * These fields are ADDITIVE ONLY — they never widen or erase an existing
  * `AgentRunInput` field — and are consumed exclusively by this bond's `run()`
  * implementation; a different `AIAgentsProvider` bond is free to ignore them.
  * Any file that imports `@molecule/api-ai-agents-llm` (directly, or
  * transitively by bonding its `provider`) sees the merged `AgentRunInput`
  * type, matching the shape `@molecule/api-ai`'s `ChatParams` already accepts
- * for `stream` and `cacheControl`.
+ * for `stream`, `cacheControl`, and `thinking`.
  *
  * @module
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-agents-llm",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "LLM-backed AI agents provider for molecule.dev — a tool-calling loop over the swappable @molecule/api-ai chat bond",
   "homepage": "https://www.molecule.dev/packages/api-ai-agents-llm",
   "type": "module",
@@ -41,10 +41,10 @@
     "@molecule/api-i18n": "^1.0.1"
   },
   "devDependencies": {
-    "@molecule/api-ai": "1.3.5",
+    "@molecule/api-ai": "1.4.0",
     "@molecule/api-ai-agents": "1.0.3",
-    "@molecule/api-bond": "1.0.3",
-    "@molecule/api-i18n": "1.0.4",
+    "@molecule/api-bond": "1.0.4",
+    "@molecule/api-i18n": "1.0.5",
     "@types/node": "26.6.5",
     "typescript": "6.0.3",
     "vitest": "4.1.12"