@openrouter/agent 0.8.0 → 0.9.0

package/esm/index.js

@@ -5,14 +5,18 @@ export { SDKHooks } from '@openrouter/sdk/hooks/hooks';
 // Message format compatibility helpers
 // High-level model calling
 export { callModel } from './inner-loop/call-model.js';
+export { resumeToolResults, ToolTaskAlreadySettledError, } from './inner-loop/resume-tool-results.js';
+export { AgentTranscriptSource } from './lib/agent-tool.js';
 export { fromClaudeMessages, toClaudeMessage } from './lib/anthropic-compat.js';
 export { hasAsyncFunctions, resolveAsyncFunctions } from './lib/async-params.js';
+export { AsyncToolRegistry } from './lib/async-tool-registry.js';
 export { fromChatMessages, toChatMessage } from './lib/chat-compat.js';
 // Claude constants and type guards
 export { ClaudeContentBlockType, NonClaudeMessageRole } from './lib/claude-constants.js';
 export { isClaudeStyleMessages } from './lib/claude-type-guards.js';
 // Conversation state helpers
 export { appendToMessages, CONVERSATION_STATE_VERSION, createInitialState, createRejectedResult, createUnsentResult, deserializeConversationState, generateConversationId, InvalidStateError, partitionToolCalls, serializeConversationState, toolRequiresApproval, UnsupportedStateVersionError, updateState, } from './lib/conversation-state.js';
+export { canonicalizeKeyMaterial, DEFAULT_DOOM_LOOP_LADDER, DEFAULT_MAX_ESCALATIONS, DoomLoopMonitor, detectTextRepetition, fingerprintKeyMaterial, fingerprintToolCall, MAX_CANONICALIZE_DEPTH, resolveDoomLoopOption, resolveLoopKeyMaterial, } from './lib/doom-loop.js';
 // Lifecycle hooks system (PreToolUse, PostToolUse, Stop, SessionStart, ...).
 // Distinct from the SDK transport hooks re-exported above (SDKHooks,
 // BeforeRequestHook, HookContext, ...), which intercept HTTP requests.
@@ -27,13 +31,16 @@ export { applyNextTurnParamsToRequest, buildNextTurnParamsContext, executeNextTu
 // Stop condition helpers
 export { finishReasonIs, hasToolCall, isStopConditionMet, maxCost, maxTokensUsed, stepCountIs, } from './lib/stop-conditions.js';
 export { extractUnsupportedContent, getUnsupportedContentSummary, hasUnsupportedContent, } from './lib/stream-transformers.js';
-// Tool creation helpers
+// Tool creation helpers (tool also carries tool.background / tool.deferred)
 export { markMcp, serverTool, tool } from './lib/tool.js';
+export { TASK_TOOL_NAME, TaskToolInputSchema } from './lib/tool-check.js';
+export { acquireAll, Semaphore } from './lib/tool-concurrency.js';
 // Tool context helpers
 export { buildToolExecuteContext, ToolContextStore } from './lib/tool-context.js';
 // Real-time tool event broadcasting
 export { ToolEventBroadcaster } from './lib/tool-event-broadcaster.js';
-export { hasApprovalRequiredTools, hasExecuteFunction, isAutoResolvableTool, isClientTool, isGeneratorTool, isHITLTool, isManualTool, isMcpTool, isRegularExecuteTool, isServerTool, isToolCallOutputEvent, isToolPreliminaryResultEvent, isToolResultEvent, isTurnEndEvent, isTurnStartEvent, ToolType, toolHasApprovalConfigured, } from './lib/tool-types.js';
+export { DEFAULT_TASK_LOG_LIMITS, ToolTask } from './lib/tool-task.js';
+export { hasApprovalRequiredTools, hasExecuteFunction, isAgentTool, isAutoResolvableTool, isClientTool, isDeferredHandle, isGeneratorTool, isHITLTool, isLongRunningTool, isManualTool, isMcpTool, isRegularExecuteTool, isServerTool, isToolAsyncSettledEvent, isToolAsyncStartedEvent, isToolCallOutputEvent, isToolPreliminaryResultEvent, isToolResultEvent, isTurnEndEvent, isTurnStartEvent, isUnifiedTool, ToolType, toolHasApprovalConfigured, } from './lib/tool-types.js';
 // Turn context helpers
 export { buildTurnContext, normalizeInputToArray } from './lib/turn-context.js';
 export { OpenRouter } from './openrouter.js';

package/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,iEAAiE;AAEjE,yDAAyD;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AA2EvD,uCAAuC;AAEvC,2BAA2B;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAMhF,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvE,mCAAmC;AACnC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACzF,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACpE,6BAA6B;AAC7B,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,EAClB,oBAAoB,EACpB,kBAAkB,EAClB,4BAA4B,EAC5B,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,oBAAoB,EACpB,4BAA4B,EAC5B,WAAW,GACZ,MAAM,6BAA6B,CAAC;AACrC,6EAA6E;AAC7E,qEAAqE;AACrE,uEAAuE;AACvE,6EAA6E;AAC7E,4EAA4E;AAC5E,8BAA8B;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AA8BtD,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAE,gCAAgC,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACtF,2BAA2B;AAC3B,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,yBAAyB;AACzB,OAAO,EACL,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,OAAO,EACP,aAAa,EACb,WAAW,GACZ,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,yBAAyB,EACzB,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,8BAA8B,CAAC;AACtC,wBAAwB;AACxB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAE1D,uBAAuB;AACvB,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAClF,oCAAoC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAqDvE,OAAO,EACL,wBAAwB,EACxB,kBAAkB,EAClB,oBAAoB,EACpB,YAAY,EACZ,eAAe,EACf,UAAU,EACV,YAAY,EACZ,SAAS,EACT,oBAAoB,EACpB,YAAY,EACZ,qBAAqB,EACrB,4BAA4B,EAC5B,iBAAiB,EACjB,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACR,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,uBAAuB;AACvB,OAAO,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/esm/inner-loop/call-model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"call-model.d.ts","sourceRoot":"","sources":["../../src/inner-loop/call-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,SAAS,IAAI,EAAE,EAC9B,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,EACnE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GACjF,QAAQ,CAAC,aAAa,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACzC,mBAAmB,CAAC,EAAE,aAAa,CAAC;CACrC,EACD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CAuF9B"}
+{"version":3,"file":"call-model.d.ts","sourceRoot":"","sources":["../../src/inner-loop/call-model.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,IAAI,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAGjD,YAAY,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,wBAAgB,SAAS,CACvB,MAAM,SAAS,SAAS,IAAI,EAAE,EAC9B,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GAAG,SAAS,GAAG,SAAS,EACnE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,aAAa,SAAS,UAAU,CAAC,SAAS,CAAC,GACjF,QAAQ,CAAC,aAAa,CAAC,GACvB,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,EAEzB,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACzC,mBAAmB,CAAC,EAAE,aAAa,CAAC;CACrC,EACD,OAAO,CAAC,EAAE,cAAc,GACvB,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,CA8F9B"}

package/esm/inner-loop/call-model.js

@@ -1,6 +1,7 @@
 import { resolveHooks } from '../lib/hooks-resolve.js';
 import { ModelResult } from '../lib/model-result.js';
-import { convertToolsToAPIFormat } from '../lib/tool-executor.js';
+import { buildTaskToolApiDefinition, needsTaskTool } from '../lib/tool-check.js';
+import { convertToolsToAPIFormat, convertZodToJsonSchema } from '../lib/tool-executor.js';
 /**
  * Get a response with multiple consumption patterns
  *
@@ -71,9 +72,18 @@ import { convertToolsToAPIFormat } from '../lib/tool-executor.js';
  */
 export function callModel(client, request, options) {
     // Destructure state management options along with tools and stopWhen
-    const { tools, stopWhen, state, requireApproval, approveToolCalls, rejectToolCalls, context, sharedContextSchema, onTurnStart, onTurnEnd, allowFinalResponse, strictFinalResponse, hooks, ...apiRequest } = request;
+    const { tools, stopWhen, state, requireApproval, approveToolCalls, rejectToolCalls, context, sharedContextSchema, onTurnStart, onTurnEnd, allowFinalResponse, strictFinalResponse, hooks, doomLoop, signal, toolTimeoutMs, toolConcurrency, asyncTools, ...apiRequest } = request;
     // Convert tools to API format - no cast needed now that convertToolsToAPIFormat accepts readonly
     const apiTools = tools ? convertToolsToAPIFormat(tools) : undefined;
+    // Append the single universal `task` tool when any long-running tool is
+    // registered (and check-ins aren't disabled): ONE static wire definition
+    // for check/steer/result/cancel across every async tool — per-tool
+    // context cost stays constant regardless of the tool count. Appended
+    // here (not per-request in ModelResult) so `resolvedRequest.tools` stays
+    // stable across turns. Calls to it are engine-intercepted.
+    if (apiTools && tools && asyncTools?.checkins !== false && needsTaskTool(tools)) {
+        apiTools.push(buildTaskToolApiDefinition(convertZodToJsonSchema));
+    }
     // Build the request with converted tools
     // Note: async functions are resolved later in ModelResult.executeToolsIfNeeded()
     // The request can have async fields (functions) or sync fields, and the tools are converted to API format
@@ -91,48 +101,37 @@ export function callModel(client, request, options) {
             'x-openrouter-callmodel': 'true',
         },
     };
-    return new ModelResult({
+    // Assemble engine options, then drop undefined entries so optional keys
+    // are ABSENT (not present-as-undefined) — same semantics as the previous
+    // per-key conditional spreads without a branch per option.
+    const engineOptions = {
         client,
         request: finalRequest,
         options: callModelOptions,
         tools,
-        ...(stopWhen !== undefined && {
-            stopWhen,
-        }),
-        // Pass state management options
-        ...(state !== undefined && {
-            state,
-        }),
-        ...(requireApproval !== undefined && {
-            requireApproval,
-        }),
-        ...(approveToolCalls !== undefined && {
-            approveToolCalls,
-        }),
-        ...(rejectToolCalls !== undefined && {
-            rejectToolCalls,
-        }),
-        ...(context !== undefined && {
-            context,
-        }),
-        ...(sharedContextSchema !== undefined && {
-            sharedContextSchema,
-        }),
-        ...(onTurnStart !== undefined && {
-            onTurnStart,
-        }),
-        ...(onTurnEnd !== undefined && {
-            onTurnEnd,
-        }),
-        ...(allowFinalResponse !== undefined && {
-            allowFinalResponse,
-        }),
-        ...(strictFinalResponse !== undefined && {
-            strictFinalResponse,
-        }),
-        ...(hooks !== undefined && {
-            hooks: resolveHooks(hooks),
-        }),
-    });
+        stopWhen,
+        state,
+        requireApproval,
+        approveToolCalls,
+        rejectToolCalls,
+        context,
+        sharedContextSchema,
+        onTurnStart,
+        onTurnEnd,
+        allowFinalResponse,
+        strictFinalResponse,
+        hooks: hooks !== undefined ? resolveHooks(hooks) : undefined,
+        doomLoop,
+        signal,
+        toolTimeoutMs,
+        toolConcurrency,
+        asyncTools,
+    };
+    for (const key of Object.keys(engineOptions)) {
+        if (engineOptions[key] === undefined) {
+            delete engineOptions[key];
+        }
+    }
+    return new ModelResult(engineOptions);
 }
 //# sourceMappingURL=call-model.js.map

package/esm/inner-loop/call-model.js.map

@@ -1 +1 @@
-{"version":3,"file":"call-model.js","sourceRoot":"","sources":["../../src/inner-loop/call-model.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAMlE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,MAAM,UAAU,SAAS,CAOvB,MAAsB,EACtB,OAEC,EACD,OAAwB;IAExB,qEAAqE;IACrE,MAAM,EACJ,KAAK,EACL,QAAQ,EACR,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,GAAG,UAAU,EACd,GAAG,OAAO,CAAC;IAEZ,iGAAiG;IACjG,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpE,yCAAyC;IACzC,iFAAiF;IACjF,0GAA0G;IAC1G,MAAM,YAAY,GAA4B;QAC5C,GAAG,UAAU;KACd,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,YAAY,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,oEAAoE;IACpE,MAAM,gBAAgB,GAAmB;QACvC,GAAG,OAAO;QACV,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,WAAW,CACnB,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,SAAS,CAAC,CAC7E;YACD,wBAAwB,EAAE,MAAM;SACjC;KACF,CAAC;IAEF,OAAO,IAAI,WAAW,CAAkB;QACtC,MAAM;QACN,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,gBAAgB;QACzB,KAAK;QACL,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI;YAC5B,QAAQ;SACT,CAAC;QACF,gCAAgC;QAChC,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI;YACzB,KAAK;SACN,CAAC;QACF,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI;YACnC,eAAe;SAChB,CAAC;QACF,GAAG,CAAC,gBAAgB,KAAK,SAAS,IAAI;YACpC,gBAAgB;SACjB,CAAC;QACF,GAAG,CAAC,eAAe,KAAK,SAAS,IAAI;YACnC,eAAe;SAChB,CAAC;QACF,GAAG,CAAC,OAAO,KAAK,SAAS,IAAI;YAC3B,OAAO;SACR,CAAC;QACF,GAAG,CAAC,mBAAmB,KAAK,SAAS,IAAI;YACvC,mBAAmB;SACpB,CAAC;QACF,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI;YAC/B,WAAW;SACZ,CAAC;QACF,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI;YAC7B,SAAS;SACV,CAAC;QACF,GAAG,CAAC,kBAAkB,KAAK,SAAS,IAAI;YACtC,kBAAkB;SACnB,CAAC;QACF,GAAG,CAAC,mBAAmB,KAAK,SAAS,IAAI;YACvC,mBAAmB;SACpB,CAAC;QACF,GAAG,CAAC,KAAK,KAAK,SAAS,IAAI;YACzB,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC;SAC3B,CAAC;KACoC,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"call-model.js","sourceRoot":"","sources":["../../src/inner-loop/call-model.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAM1F;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AACH,MAAM,UAAU,SAAS,CAOvB,MAAsB,EACtB,OAEC,EACD,OAAwB;IAExB,qEAAqE;IACrE,MAAM,EACJ,KAAK,EACL,QAAQ,EACR,KAAK,EACL,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,OAAO,EACP,mBAAmB,EACnB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,aAAa,EACb,eAAe,EACf,UAAU,EACV,GAAG,UAAU,EACd,GAAG,OAAO,CAAC;IAEZ,iGAAiG;IACjG,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAEpE,wEAAwE;IACxE,yEAAyE;IACzE,mEAAmE;IACnE,qEAAqE;IACrE,yEAAyE;IACzE,2DAA2D;IAC3D,IAAI,QAAQ,IAAI,KAAK,IAAI,UAAU,EAAE,QAAQ,KAAK,KAAK,IAAI,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAChF,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,sBAAsB,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,yCAAyC;IACzC,iFAAiF;IACjF,0GAA0G;IAC1G,MAAM,YAAY,GAA4B;QAC5C,GAAG,UAAU;KACd,CAAC;IAEF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,YAAY,CAAC,OAAO,CAAC,GAAG,QAAQ,CAAC;IACnC,CAAC;IAED,oEAAoE;IACpE,MAAM,gBAAgB,GAAmB;QACvC,GAAG,OAAO;QACV,OAAO,EAAE;YACP,GAAG,MAAM,CAAC,WAAW,CACnB,IAAI,OAAO,CAAC,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,YAAY,EAAE,OAAO,IAAI,SAAS,CAAC,CAC7E;YACD,wBAAwB,EAAE,MAAM;SACjC;KACF,CAAC;IAEF,wEAAwE;IACxE,yEAAyE;IACzE,2DAA2D;IAC3D,MAAM,aAAa,GAA4B;QAC7C,MAAM;QACN,OAAO,EAAE,YAAY;QACrB,OAAO,EAAE,gBAAgB;QACzB,KAAK;QACL,QAAQ;QACR,KAAK;QACL,eAAe;QACf,gBAAgB;QAChB,eAAe;QACf,OAAO;QACP,mBAAmB;QACnB,WAAW;QACX,SAAS;QACT,kBAAkB;QAClB,mBAAmB;QACnB,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;QAC5D,QAAQ;QACR,MAAM;QACN,aAAa;QACb,eAAe;QACf,UAAU;KACX,CAAC;IACF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC;QAC7C,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,IAAI,WAAW,CACpB,aAA+D,CAChE,CAAC;AACJ,CAAC"}

package/esm/inner-loop/resume-tool-results.d.ts

@@ -0,0 +1,128 @@
+import type { OpenRouterCore } from '@openrouter/sdk/core';
+import type { RequestOptions } from '@openrouter/sdk/lib/sdks';
+import type * as models from '@openrouter/sdk/models';
+import type { CallModelInput } from '../lib/async-params.js';
+import type { ModelResult } from '../lib/model-result.js';
+import type { StateAccessor, Tool } from '../lib/tool-types.js';
+/**
+ * Thrown by {@link resumeToolResults} (and the deferred tool `.resolve()` /
+ * `.fail()` / `.cancel()` methods) when the target task was already settled —
+ * the at-most-once guard against double resolution and replayed webhooks.
+ * Opt out per call with `ifSettled: 'ignore'`.
+ */
+export declare class ToolTaskAlreadySettledError extends Error {
+    readonly taskId: string;
+    readonly callId: string;
+    constructor(taskId: string, callId: string);
+}
+/**
+ * One task resolution: identified by `taskId` (typical — it's what the
+ * external system knows) or `callId`, carrying either a successful `output`
+ * or an `error`. `status` refines error deliveries (default `'failed'`).
+ */
+export type ResumeToolResultEntry = ({
+    taskId: string;
+    callId?: never;
+} | {
+    callId: string;
+    taskId?: never;
+}) & ({
+    output: unknown;
+    error?: never;
+} | {
+    error: string;
+    output?: never;
+    status?: 'failed' | 'cancelled' | 'expired';
+});
+/**
+ * Run configuration for continuing the conversation immediately after
+ * recording the results. Any `CallModelInput` field except `state` / `input`
+ * (the SDK supplies both — the resumed history already carries everything).
+ */
+export type ResumeRunConfig<TTools extends readonly Tool[]> = Omit<CallModelInput<TTools>, 'state' | 'input' | 'approveToolCalls' | 'rejectToolCalls'>;
+/**
+ * The `tool_task_result` envelope injected as a user-role message when an
+ * async tool's result arrives. Never a second `function_call_output` — the
+ * pending placeholder already paired the original `function_call` in
+ * history, and providers reject duplicate outputs for one callId.
+ */
+export interface ToolTaskResultEnvelope {
+    type: 'tool_task_result';
+    tool: string;
+    taskId: string;
+    callId: string;
+    status: 'completed' | 'failed' | 'cancelled' | 'timed_out' | 'expired';
+    result?: unknown;
+    error?: string;
+}
+/** Build the user-role message carrying a task-result envelope. */
+export declare function buildTaskResultMessage(envelope: ToolTaskResultEnvelope): models.BaseInputsUnion;
+/**
+ * Deliver results for pending async tool tasks (started by `tool.deferred`,
+ * or background tasks orphaned across a run boundary) into a persisted
+ * conversation — typically from a different process than the one that
+ * started them (a webhook handler, a queue worker).
+ *
+ * This is the low-level, untyped entry point; prefer the typed `.resolve()`
+ * / `.fail()` / `.cancel()` methods on the deferred tool itself, which
+ * check `output` against the tool's `outputSchema` at compile time.
+ *
+ * Behavior:
+ * 1. Loads the conversation via `state`, resolves each entry to a pending
+ *    task (by `taskId` or `callId`).
+ * 2. Enforces at-most-once settlement: an already-settled task throws
+ *    {@link ToolTaskAlreadySettledError} (or is skipped with
+ *    `ifSettled: 'ignore'`).
+ * 3. Validates each `output` against the named tool's `outputSchema` when
+ *    the tool is present in `tools` — an invalid payload throws before
+ *    anything is persisted or dispatched.
+ * 4. Appends a `tool_task_result` envelope (user-role message) per entry,
+ *    marks the tasks settled, and persists the state. The conversation
+ *    status becomes `'in_progress'` (or stays `'awaiting_async_tools'` when
+ *    other tasks are still pending).
+ * 5. With `run` config: continues the conversation immediately and returns
+ *    the `ModelResult`. Without: returns `null` — the recorded results ride
+ *    along on the next `callModel({ state })`. When every entry was skipped
+ *    under `ifSettled: 'ignore'` there is nothing new to deliver, so the
+ *    function returns `null` WITHOUT running — a replayed webhook never
+ *    triggers a duplicate continuation.
+ *
+ * SECURITY: this call injects a value the model will treat as a tool
+ * result. Authenticate the webhook/caller BEFORE invoking it — the SDK
+ * cannot do that for you. And PASS `tools`: without it the output is
+ * appended UNVALIDATED (no outputSchema to check against) — prefer the
+ * typed `.resolve()` methods, which always carry the tool's schema.
+ *
+ * CONCURRENCY: this is a read-modify-write over the StateAccessor. Two
+ * concurrent calls for the SAME conversation (e.g. two webhooks resolving
+ * two different tasks) can interleave load/save and the later save wins,
+ * silently dropping the earlier envelope. Serialize calls per conversation
+ * — a per-conversation lock or queue in your StateAccessor, or batch
+ * concurrent completions into one call via `results: [...]` (which settles
+ * any number of tasks atomically).
+ *
+ * HOOKS: PostToolUse / PostToolUseFailure do NOT fire here — hooks are
+ * run-scoped (a HooksManager passed to `callModel`), and this entry point
+ * runs outside any run, typically in another process. Deployments that
+ * audit tool outputs via hooks should scan webhook payloads in the webhook
+ * handler itself. In-process settlements (background tasks) DO fire these
+ * hooks at delivery.
+ */
+export declare function resumeToolResults<TTools extends readonly Tool[]>(client: OpenRouterCore, request: {
+    state: StateAccessor<TTools>;
+    /** Tools list — used to validate outputs against each tool's outputSchema. */
+    tools?: TTools;
+    results: ReadonlyArray<ResumeToolResultEntry>;
+    /** Behavior when a task is already settled. Default 'throw'. */
+    ifSettled?: 'throw' | 'ignore';
+    /** Continue the conversation immediately with this run configuration. */
+    run?: ResumeRunConfig<TTools>;
+    /**
+     * Ownership guard: every resolved task must belong to this tool (by
+     * name) or the call throws BEFORE anything is persisted. Set by the
+     * typed `.resolve()`/`.fail()`/`.cancel()` methods — a taskId from a
+     * webhook cannot settle a different tool's task through them.
+     */
+    expectToolName?: string;
+}, options?: RequestOptions): Promise<ModelResult<TTools> | null>;
+//# sourceMappingURL=resume-tool-results.d.ts.map

package/esm/inner-loop/resume-tool-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-tool-results.d.ts","sourceRoot":"","sources":["../../src/inner-loop/resume-tool-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,KAAK,MAAM,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAG1D,OAAO,KAAK,EAAoB,aAAa,EAAE,IAAI,EAAkB,MAAM,sBAAsB,CAAC;AAIlG;;;;;GAKG;AACH,qBAAa,2BAA4B,SAAQ,KAAK;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAM3C;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,CAChC;IACE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,GACD;IACE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB,CACJ,GACC,CACI;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf,GACD;IACE,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,MAAM,CAAC,EAAE,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAC;CAC7C,CACJ,CAAC;AAEJ;;;;GAIG;AACH,MAAM,MAAM,eAAe,CAAC,MAAM,SAAS,SAAS,IAAI,EAAE,IAAI,IAAI,CAChE,cAAc,CAAC,MAAM,CAAC,EACtB,OAAO,GAAG,OAAO,GAAG,kBAAkB,GAAG,iBAAiB,CAC3D,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,mEAAmE;AACnE,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,MAAM,CAAC,eAAe,CAK/F;AAqDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkDG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,SAAS,SAAS,IAAI,EAAE,EACpE,MAAM,EAAE,cAAc,EACtB,OAAO,EAAE;IACP,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7B,8EAA8E;IAC9E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAC9C,gEAAgE;IAChE,SAAS,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC/B,yEAAyE;IACzE,GAAG,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,EACD,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAkHrC"}

package/esm/inner-loop/resume-tool-results.js

@@ -0,0 +1,244 @@
+import { appendToMessages, updateState } from '../lib/conversation-state.js';
+import { validateToolOutput } from '../lib/tool-executor.js';
+import { TASK_RESULT_BOUNDARY } from '../lib/tool-task.js';
+import { isClientTool, isUnifiedTool } from '../lib/tool-types.js';
+import { callModel } from './call-model.js';
+/**
+ * Thrown by {@link resumeToolResults} (and the deferred tool `.resolve()` /
+ * `.fail()` / `.cancel()` methods) when the target task was already settled —
+ * the at-most-once guard against double resolution and replayed webhooks.
+ * Opt out per call with `ifSettled: 'ignore'`.
+ */
+export class ToolTaskAlreadySettledError extends Error {
+    constructor(taskId, callId) {
+        super(`Tool task "${taskId}" (call ${callId}) has already been settled`);
+        this.name = 'ToolTaskAlreadySettledError';
+        this.taskId = taskId;
+        this.callId = callId;
+    }
+}
+/** Build the user-role message carrying a task-result envelope. */
+export function buildTaskResultMessage(envelope) {
+    return {
+        role: 'user',
+        content: `${TASK_RESULT_BOUNDARY}\n${JSON.stringify(envelope)}`,
+    };
+}
+/**
+ * Find the pending task an incoming result belongs to, or `null` when the entry
+ * is already settled and the caller asked to ignore that.
+ *
+ * Settled tasks deliberately STAY in `pendingAsyncTools` with a terminal
+ * status, so a replayed webhook resolves to `ToolTaskAlreadySettledError`
+ * rather than "not found".
+ *
+ * @throws ToolTaskAlreadySettledError when the task already settled and
+ * `ifSettled` is `'throw'` (the default).
+ * @throws Error when no pending task matches the entry at all.
+ */
+function resolvePendingTask({ entry, pending, settledIds, ifSettled, }) {
+    const task = pending.find((t) => 'taskId' in entry && entry.taskId !== undefined
+        ? t.taskId === entry.taskId
+        : t.callId === entry.callId);
+    if (!task) {
+        // The callId fallback covers states persisted by older SDK versions whose
+        // in-process delivery REMOVED the entry, leaving only the callId on
+        // settledAsyncCallIds.
+        if (entry.callId !== undefined && settledIds.has(entry.callId)) {
+            if (ifSettled === 'ignore') {
+                return null;
+            }
+            throw new ToolTaskAlreadySettledError(entry.taskId ?? entry.callId, entry.callId);
+        }
+        throw new Error(`resumeToolResults: no pending async tool task found for "${entry.taskId ?? entry.callId}"`);
+    }
+    if (settledIds.has(task.callId) || task.status !== 'working') {
+        if (ifSettled === 'ignore') {
+            return null;
+        }
+        throw new ToolTaskAlreadySettledError(task.taskId, task.callId);
+    }
+    return task;
+}
+/**
+ * Deliver results for pending async tool tasks (started by `tool.deferred`,
+ * or background tasks orphaned across a run boundary) into a persisted
+ * conversation — typically from a different process than the one that
+ * started them (a webhook handler, a queue worker).
+ *
+ * This is the low-level, untyped entry point; prefer the typed `.resolve()`
+ * / `.fail()` / `.cancel()` methods on the deferred tool itself, which
+ * check `output` against the tool's `outputSchema` at compile time.
+ *
+ * Behavior:
+ * 1. Loads the conversation via `state`, resolves each entry to a pending
+ *    task (by `taskId` or `callId`).
+ * 2. Enforces at-most-once settlement: an already-settled task throws
+ *    {@link ToolTaskAlreadySettledError} (or is skipped with
+ *    `ifSettled: 'ignore'`).
+ * 3. Validates each `output` against the named tool's `outputSchema` when
+ *    the tool is present in `tools` — an invalid payload throws before
+ *    anything is persisted or dispatched.
+ * 4. Appends a `tool_task_result` envelope (user-role message) per entry,
+ *    marks the tasks settled, and persists the state. The conversation
+ *    status becomes `'in_progress'` (or stays `'awaiting_async_tools'` when
+ *    other tasks are still pending).
+ * 5. With `run` config: continues the conversation immediately and returns
+ *    the `ModelResult`. Without: returns `null` — the recorded results ride
+ *    along on the next `callModel({ state })`. When every entry was skipped
+ *    under `ifSettled: 'ignore'` there is nothing new to deliver, so the
+ *    function returns `null` WITHOUT running — a replayed webhook never
+ *    triggers a duplicate continuation.
+ *
+ * SECURITY: this call injects a value the model will treat as a tool
+ * result. Authenticate the webhook/caller BEFORE invoking it — the SDK
+ * cannot do that for you. And PASS `tools`: without it the output is
+ * appended UNVALIDATED (no outputSchema to check against) — prefer the
+ * typed `.resolve()` methods, which always carry the tool's schema.
+ *
+ * CONCURRENCY: this is a read-modify-write over the StateAccessor. Two
+ * concurrent calls for the SAME conversation (e.g. two webhooks resolving
+ * two different tasks) can interleave load/save and the later save wins,
+ * silently dropping the earlier envelope. Serialize calls per conversation
+ * — a per-conversation lock or queue in your StateAccessor, or batch
+ * concurrent completions into one call via `results: [...]` (which settles
+ * any number of tasks atomically).
+ *
+ * HOOKS: PostToolUse / PostToolUseFailure do NOT fire here — hooks are
+ * run-scoped (a HooksManager passed to `callModel`), and this entry point
+ * runs outside any run, typically in another process. Deployments that
+ * audit tool outputs via hooks should scan webhook payloads in the webhook
+ * handler itself. In-process settlements (background tasks) DO fire these
+ * hooks at delivery.
+ */
+export async function resumeToolResults(client, request, options) {
+    const state = await request.state.load();
+    if (!state) {
+        throw new Error('resumeToolResults: no conversation state found for the given StateAccessor');
+    }
+    const pending = state.pendingAsyncTools ?? [];
+    const settledIds = new Set(state.settledAsyncCallIds ?? []);
+    const envelopes = [];
+    /** callId → the terminal lifecycle status persisted for that entry. */
+    const settledNow = new Map();
+    for (const entry of request.results) {
+        const task = resolvePendingTask({
+            entry,
+            pending,
+            settledIds,
+            ifSettled: request.ifSettled,
+        });
+        if (!task) {
+            continue; // already settled and the caller asked to ignore it
+        }
+        // Ownership guard: a taskId is an external identifier handed to
+        // third-party systems — a lower-trust webhook must not be able to
+        // settle a DIFFERENT tool's task through a tool-bound completion
+        // method (confused deputy; it would also skip that tool's
+        // outputSchema validation).
+        if (request.expectToolName !== undefined && task.name !== request.expectToolName) {
+            throw new Error(`resumeToolResults: task "${task.taskId}" belongs to tool "${task.name}", not "${request.expectToolName}" — use the owning tool's completion methods (or the untyped resumeToolResults entry point).`);
+        }
+        const envelope = buildResumeEnvelope(entry, task, request.tools);
+        envelopes.push(buildTaskResultMessage(envelope));
+        // Persist the entry's real terminal status. 'expired' / 'timed_out'
+        // have no ToolTaskStatus member — they persist as 'failed'.
+        settledNow.set(task.callId, envelope.status === 'completed' || envelope.status === 'cancelled'
+            ? envelope.status
+            : 'failed');
+        settledIds.add(task.callId);
+    }
+    if (envelopes.length === 0) {
+        // Every entry was already settled and ignored — nothing to record.
+        return null;
+    }
+    // Keep settled entries with a terminal status (rather than dropping them)
+    // so a replayed resolution surfaces as ToolTaskAlreadySettledError.
+    const nextPending = pending.map((t) => {
+        const terminalStatus = settledNow.get(t.callId);
+        return terminalStatus !== undefined
+            ? {
+                ...t,
+                status: terminalStatus,
+            }
+            : t;
+    });
+    // Status transition rules:
+    // - Orphaned (detached) tasks never settle — counting them as working
+    //   would leave the conversation reporting 'awaiting_async_tools' forever.
+    // - Only advance a status this delivery OWNS. A conversation can hold a
+    //   non-async pause (awaiting_approval / awaiting_hitl /
+    //   awaiting_client_tools) while async tasks are outstanding; clobbering
+    //   it to 'in_progress' would make the engine skip the decision-resume
+    //   path and drop the caller's approvals.
+    // - A 'complete' conversation is only reopened when the caller asked to
+    //   continue (`run` config). Record-only delivery on a finished
+    //   conversation keeps it finished — the envelope rides along if the
+    //   caller ever resumes it.
+    const stillWorking = nextPending.some((t) => t.status === 'working' && t.orphaned !== true);
+    const statusOwnedByAsyncDelivery = state.status === 'awaiting_async_tools' ||
+        state.status === 'in_progress' ||
+        (state.status === 'complete' && request.run !== undefined) ||
+        state.status === undefined;
+    const updated = updateState(state, {
+        messages: appendToMessages(state.messages, envelopes),
+        settledAsyncCallIds: [
+            ...(state.settledAsyncCallIds ?? []),
+            ...settledNow.keys(),
+        ],
+        ...(statusOwnedByAsyncDelivery && {
+            status: stillWorking ? 'awaiting_async_tools' : 'in_progress',
+        }),
+        pendingAsyncTools: nextPending,
+    });
+    await request.state.save(updated);
+    if (!request.run) {
+        return null;
+    }
+    // Continue the conversation: the envelopes are already in persisted
+    // history, so no fresh input is supplied.
+    return callModel(client, {
+        ...request.run,
+        input: [],
+        tools: request.run.tools ?? request.tools,
+        state: request.state,
+    }, options);
+}
+/**
+ * Build the `tool_task_result` envelope for one resume entry. Successful
+ * outputs are validated against the owning tool's `outputSchema` when the
+ * tool is available; error entries carry the caller's refined status
+ * (default `'failed'`).
+ */
+function buildResumeEnvelope(entry, task, tools) {
+    if ('output' in entry && entry.error === undefined) {
+        const tool = tools?.find((t) => isClientTool(t) && t.function.name === task.name);
+        // Fail closed: when a tools list was supplied but the owning tool is
+        // not in it, the caller expected validation — appending the output
+        // unvalidated would silently void that expectation.
+        if (tools !== undefined && tool === undefined) {
+            throw new Error(`resumeToolResults: task "${task.taskId}" belongs to tool "${task.name}", which is not in the supplied tools list — its output cannot be validated. Include the tool, or omit \`tools\` to skip validation explicitly.`);
+        }
+        let output = entry.output;
+        if (tool && isUnifiedTool(tool) && tool.function.outputSchema !== undefined) {
+            output = validateToolOutput(tool.function.outputSchema, output);
+        }
+        return {
+            type: 'tool_task_result',
+            tool: task.name,
+            taskId: task.taskId,
+            callId: task.callId,
+            status: 'completed',
+            result: output,
+        };
+    }
+    return {
+        type: 'tool_task_result',
+        tool: task.name,
+        taskId: task.taskId,
+        callId: task.callId,
+        status: entry.status ?? 'failed',
+        error: entry.error ?? 'Task failed',
+    };
+}
+//# sourceMappingURL=resume-tool-results.js.map

package/esm/inner-loop/resume-tool-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resume-tool-results.js","sourceRoot":"","sources":["../../src/inner-loop/resume-tool-results.ts"],"names":[],"mappings":"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"}