@openrouter/agent 0.8.0 → 0.9.0

package/esm/lib/tool.js

@@ -1,10 +1,24 @@
-import { SHARED_CONTEXT_KEY, ToolType } from './tool-types.js';
+import { agentToolBuilder } from './agent-tool.js';
+import { TASK_TOOL_NAME } from './tool-check.js';
+import { isClientTool, SHARED_CONTEXT_KEY, ToolType } from './tool-types.js';
 // Implementation
 export function tool(config) {
     // 'shared' is reserved for shared context — forbid it as a tool name
     if (config.name === SHARED_CONTEXT_KEY) {
         throw new Error(`Tool name "${SHARED_CONTEXT_KEY}" is reserved for shared context. Choose a different name.`);
     }
+    // 'task' is reserved for the universal task-interaction tool the engine
+    // registers alongside long-running tools.
+    if (config.name === TASK_TOOL_NAME) {
+        throw new Error(`Tool name "${TASK_TOOL_NAME}" is reserved for the built-in task-interaction tool. Choose a different name.`);
+    }
+    // Unified run tool (new kind). Checked before the legacy branches so a
+    // config carrying `run` never routes through execute-keyed logic —
+    // but AFTER the name guard, keeping every released path on its exact
+    // current control flow.
+    if ('run' in config && typeof config.run === 'function') {
+        return buildUnifiedTool(config);
+    }
     // Check for HITL tool (has onToolCalled hook)
     if ('onToolCalled' in config && typeof config.onToolCalled === 'function') {
         // outputSchema is required at the type level for HITL configs, but
@@ -33,6 +47,18 @@ export function tool(config) {
         if (config.requireApproval !== undefined) {
             fn.requireApproval = config.requireApproval;
         }
+        if (config.loopKey !== undefined) {
+            fn.loopKey = config.loopKey;
+        }
+        if (config.timeoutMs !== undefined) {
+            fn.timeoutMs = config.timeoutMs;
+        }
+        if (config.maxConcurrency !== undefined) {
+            fn.maxConcurrency = config.maxConcurrency;
+        }
+        if (config.strict !== undefined) {
+            fn.strict = config.strict;
+        }
         if (config.onResponseReceived !== undefined) {
             fn.onResponseReceived = config.onResponseReceived;
         }
@@ -64,6 +90,18 @@ export function tool(config) {
         if (config.requireApproval !== undefined) {
             fn.requireApproval = config.requireApproval;
         }
+        if (config.loopKey !== undefined) {
+            fn.loopKey = config.loopKey;
+        }
+        if (config.timeoutMs !== undefined) {
+            fn.timeoutMs = config.timeoutMs;
+        }
+        if (config.maxConcurrency !== undefined) {
+            fn.maxConcurrency = config.maxConcurrency;
+        }
+        if (config.strict !== undefined) {
+            fn.strict = config.strict;
+        }
         return {
             type: ToolType.Function,
             function: fn,
@@ -92,9 +130,21 @@ export function tool(config) {
         if (config.requireApproval !== undefined) {
             fn.requireApproval = config.requireApproval;
         }
+        if (config.loopKey !== undefined) {
+            fn.loopKey = config.loopKey;
+        }
+        if (config.timeoutMs !== undefined) {
+            fn.timeoutMs = config.timeoutMs;
+        }
+        if (config.maxConcurrency !== undefined) {
+            fn.maxConcurrency = config.maxConcurrency;
+        }
         if ('toModelOutput' in config && config.toModelOutput !== undefined) {
             fn.toModelOutput = config.toModelOutput;
         }
+        if (config.strict !== undefined) {
+            fn.strict = config.strict;
+        }
         return {
             type: ToolType.Function,
             function: fn,
@@ -120,6 +170,18 @@ export function tool(config) {
         ...(config.requireApproval !== undefined && {
             requireApproval: config.requireApproval,
         }),
+        ...(config.loopKey !== undefined && {
+            loopKey: config.loopKey,
+        }),
+        ...(config.timeoutMs !== undefined && {
+            timeoutMs: config.timeoutMs,
+        }),
+        ...(config.maxConcurrency !== undefined && {
+            maxConcurrency: config.maxConcurrency,
+        }),
+        ...(config.strict !== undefined && {
+            strict: config.strict,
+        }),
         ...('toModelOutput' in config &&
             config.toModelOutput !== undefined && {
             toModelOutput: config.toModelOutput,
@@ -130,6 +192,122 @@ export function tool(config) {
         function: functionObj,
     };
 }
+/** Copy shared config fields onto a function object when present. */
+function assignCommonToolFields(fn, config) {
+    const fields = [
+        'description',
+        'strict',
+        'contextSchema',
+        'nextTurnParams',
+        'requireApproval',
+        'loopKey',
+        'timeoutMs',
+        'maxConcurrency',
+        'toModelOutput',
+        'eventSchema',
+        'ack',
+        'graceMs',
+        'pollAfterMs',
+        'check',
+        'logLimits',
+    ];
+    for (const field of fields) {
+        if (config[field] !== undefined) {
+            fn[field] = config[field];
+        }
+    }
+}
+/**
+ * Bind one deferred completion method: resolve the entry shape, prepend the
+ * tool itself to any `run` tools, and dispatch through `resumeToolResults`.
+ * The resume module is imported lazily to avoid a static
+ * tool.ts → call-model.ts → model-result.ts import cycle.
+ */
+function bindDeferredCompletion(toolValue, toEntry) {
+    return async (client, request, options) => {
+        const { resumeToolResults } = await import('../inner-loop/resume-tool-results.js');
+        const run = request.run;
+        return resumeToolResults(client, {
+            state: request.state,
+            tools: [
+                toolValue,
+            ],
+            // Ownership guard: a taskId handed to an external system must not
+            // settle a DIFFERENT tool's task through this tool's methods.
+            ...(isClientTool(toolValue) && {
+                expectToolName: toolValue.function.name,
+            }),
+            results: [
+                {
+                    taskId: request.taskId,
+                    ...toEntry(request),
+                },
+            ],
+            ...(request.ifSettled !== undefined && {
+                ifSettled: request.ifSettled,
+            }),
+            ...(run !== undefined && {
+                run: {
+                    ...run,
+                    tools: [
+                        toolValue,
+                        ...(run.tools ?? []).filter((t) => t !== toolValue),
+                    ],
+                },
+            }),
+        }, options);
+    };
+}
+/**
+ * Build a unified `run` tool from a config. Deferred tools additionally get
+ * the typed `.resolve()/.fail()/.cancel()` completion methods.
+ */
+function buildUnifiedTool(config) {
+    const lifecycle = ('lifecycle' in config ? config.lifecycle : undefined) ?? 'sync';
+    // Long-running lifecycles require an outputSchema: the result settles
+    // after the round (possibly in another process) and must be validatable
+    // without the run's return-type inference. Type level enforces this too;
+    // JavaScript callers can bypass types.
+    if (lifecycle !== 'sync' && config.outputSchema === undefined) {
+        throw new Error(`Tool "${config.name}" (lifecycle: '${lifecycle}') must declare an outputSchema. Long-running results are validated when they settle — possibly long after the round that started them.`);
+    }
+    const fn = {
+        lifecycle,
+        name: config.name,
+        inputSchema: config.inputSchema,
+        run: config.run,
+    };
+    if (config.outputSchema !== undefined) {
+        fn['outputSchema'] = config.outputSchema;
+    }
+    assignCommonToolFields(fn, config);
+    const toolValue = {
+        type: ToolType.Function,
+        function: fn,
+    };
+    if (lifecycle !== 'deferred') {
+        return toolValue;
+    }
+    return Object.assign(toolValue, {
+        resolve: bindDeferredCompletion(toolValue, (request) => ({
+            output: request['output'],
+        })),
+        fail: bindDeferredCompletion(toolValue, (request) => ({
+            error: request['error'] instanceof Error
+                ? request['error'].message
+                : String(request['error'] ?? 'Task failed'),
+        })),
+        cancel: bindDeferredCompletion(toolValue, (request) => ({
+            error: typeof request['reason'] === 'string' ? request['reason'] : 'Task cancelled',
+            status: 'cancelled',
+        })),
+    });
+}
+// Attach the agent builder as a namespaced property (expando properties on a
+// function declaration merge into its type). `tool.agent()` keeps a
+// dedicated builder because its config shape genuinely differs (an `agent`
+// run-spec factory + `result` mapper instead of `run`).
+tool.agent = agentToolBuilder;
 //#endregion
 //#region serverTool() Factory
 /**
@@ -164,12 +342,24 @@ export function serverTool(config) {
  * the tool's runtime behavior and wire shape are unchanged — only its type (and
  * the runtime {@link isMcpTool} check) now identify it as MCP-originated. Used
  * by `@openrouter/mcp` to mark wrapped remote tools.
+ *
+ * `options.loopKey` attaches a doom-loop identity to the wrapped tool —
+ * the only injection point for MCP tools, whose remote definitions cannot
+ * carry client-side functions. Like every other tool hook it is a computed
+ * function over the call's arguments (or `false` to exempt).
  */
-export function markMcp(toolToMark) {
-    return {
+export function markMcp(toolToMark, options) {
+    const marked = {
         ...toolToMark,
         _mcp: true,
     };
+    if (options?.loopKey !== undefined && isClientTool(marked)) {
+        marked.function = {
+            ...marked.function,
+            loopKey: options.loopKey,
+        };
+    }
+    return marked;
 }
 //#endregion
 //# sourceMappingURL=tool.js.map

package/esm/lib/tool.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/agent",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "author": "OpenRouter",
   "description": "Agent toolkit for building AI applications with OpenRouter — tool orchestration, streaming, multi-turn conversations, and format compatibility.",
   "keywords": [
@@ -44,6 +44,10 @@
       "types": "./esm/lib/stop-conditions.d.ts",
       "default": "./esm/lib/stop-conditions.js"
     },
+    "./doom-loop": {
+      "types": "./esm/lib/doom-loop.d.ts",
+      "default": "./esm/lib/doom-loop.js"
+    },
     "./tool": {
       "types": "./esm/lib/tool.d.ts",
       "default": "./esm/lib/tool.js"
@@ -92,7 +96,31 @@
       "types": "./esm/openrouter.d.ts",
       "default": "./esm/openrouter.js"
     },
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./tool-concurrency": {
+      "types": "./esm/lib/tool-concurrency.d.ts",
+      "default": "./esm/lib/tool-concurrency.js"
+    },
+    "./async-tool-registry": {
+      "types": "./esm/lib/async-tool-registry.d.ts",
+      "default": "./esm/lib/async-tool-registry.js"
+    },
+    "./resume-tool-results": {
+      "types": "./esm/inner-loop/resume-tool-results.d.ts",
+      "default": "./esm/inner-loop/resume-tool-results.js"
+    },
+    "./tool-task": {
+      "types": "./esm/lib/tool-task.d.ts",
+      "default": "./esm/lib/tool-task.js"
+    },
+    "./tool-check": {
+      "types": "./esm/lib/tool-check.d.ts",
+      "default": "./esm/lib/tool-check.js"
+    },
+    "./agent-tool": {
+      "types": "./esm/lib/agent-tool.d.ts",
+      "default": "./esm/lib/agent-tool.js"
+    }
   },
   "sideEffects": false,
   "repository": {