@openrouter/agent 0.8.0 → 0.10.0

package/esm/lib/tool-orchestrator.js

@@ -1,8 +1,8 @@
 import { applyNextTurnParamsToRequest, executeNextTurnParamsFunctions, } from './next-turn-params.js';
 import { extractToolCallsFromResponse, responseHasToolCalls } from './stream-transformers.js';
 import { isFunctionCallItem } from './stream-type-guards.js';
-import { executeTool, findToolByName } from './tool-executor.js';
-import { isAutoResolvableTool, isMcpTool } from './tool-types.js';
+import { executeTool, findToolByName, isAsyncToolInvocation } from './tool-executor.js';
+import { isAutoResolvableTool, isMcpTool, isUnifiedTool } from './tool-types.js';
 import { buildTurnContext } from './turn-context.js';
 /**
  * Execute tool calls and manage multi-turn conversations
@@ -48,45 +48,13 @@ export async function executeToolLoop(sendRequest, initialInput, initialRequest,
             break;
         }
         // Execute all tool calls in parallel (parallel tool calling)
-        const toolCallPromises = toolCalls.map(async (toolCall) => {
-            const tool = findToolByName(tools, toolCall.name);
-            if (!tool) {
-                // Tool not found in definitions
-                return {
-                    toolCallId: toolCall.id,
-                    toolName: toolCall.name,
-                    source: 'client',
-                    result: null,
-                    error: new Error(`Tool "${toolCall.name}" not found in tool definitions`),
-                };
-            }
-            if (!isAutoResolvableTool(tool)) {
-                // Tool has no execute/onToolCalled - return null to filter out
-                return null;
-            }
-            // Find the raw tool call from the response output
-            const rawToolCall = currentResponse.output.find((item) => isFunctionCallItem(item) && item.callId === toolCall.id);
-            if (!rawToolCall) {
-                throw new Error(`Could not find raw tool call for ${toolCall.id}`);
-            }
-            // Convert to FunctionCallItem format
-            const openResponsesToolCall = {
-                type: 'function_call',
-                callId: rawToolCall.callId,
-                name: rawToolCall.name,
-                arguments: rawToolCall.arguments,
-                id: rawToolCall.callId,
-                status: rawToolCall.status,
-            };
-            // Build turn context with full information
-            const turnContext = buildTurnContext({
-                numberOfTurns: currentRound,
-                toolCall: openResponsesToolCall,
-                turnRequest: currentRequest,
-            });
-            // Execute the tool
-            return executeTool(tool, toolCall, turnContext, onPreliminaryResult);
-        });
+        const toolCallPromises = toolCalls.map((toolCall) => executeOrchestratedCall(toolCall, {
+            tools,
+            response: currentResponse,
+            request: currentRequest,
+            round: currentRound,
+            onPreliminaryResult,
+        }));
         // Wait for all tool executions to complete in parallel
         const settledResults = await Promise.allSettled(toolCallPromises);
         // Process settled results, handling both fulfilled and rejected promises
@@ -96,21 +64,32 @@ export async function executeToolLoop(sendRequest, initialInput, initialRequest,
             if (!toolCall) {
                 return;
             }
+            const errorResult = (error) => {
+                const failedTool = findToolByName(tools, toolCall.name);
+                return {
+                    toolCallId: toolCall.id,
+                    toolName: toolCall.name,
+                    source: failedTool !== undefined && isMcpTool(failedTool) ? 'mcp' : 'client',
+                    result: null,
+                    error,
+                };
+            };
             if (settled.status === 'fulfilled') {
-                if (settled.value !== null) {
+                // This legacy loop predates async tools and only understands
+                // synchronous execution results (background/deferred invocations
+                // are handled by ModelResult's live loop). Surface an explicit
+                // error rather than silently dropping the call — an unpaired
+                // function_call would poison any history built from these results.
+                if (settled.value !== null && isAsyncToolInvocation(settled.value)) {
+                    roundResults.push(errorResult(new Error(`Tool "${toolCall.name}" uses an async lifecycle (background/deferred), which executeToolLoop does not support — run it through callModel instead.`)));
+                }
+                else if (settled.value !== null) {
                     roundResults.push(settled.value);
                 }
             }
             else {
                 // Promise rejected - create error result
-                const rejectedTool = findToolByName(tools, toolCall.name);
-                roundResults.push({
-                    toolCallId: toolCall.id,
-                    toolName: toolCall.name,
-                    source: rejectedTool !== undefined && isMcpTool(rejectedTool) ? 'mcp' : 'client',
-                    result: null,
-                    error: settled.reason instanceof Error ? settled.reason : new Error(String(settled.reason)),
-                });
+                roundResults.push(errorResult(settled.reason instanceof Error ? settled.reason : new Error(String(settled.reason))));
             }
         });
         toolExecutionResults.push(...roundResults);
@@ -182,4 +161,62 @@ export function getToolExecutionErrors(results) {
         .filter((result) => result.error !== undefined)
         .map((result) => result.error);
 }
+/**
+ * Execute one orchestrated tool call: resolve the tool, rebuild the raw
+ * `function_call` item, build the turn context, and run the tool. Returns
+ * `null` for calls with nothing to execute (manual tools), an error-shaped
+ * result for unknown tools.
+ */
+async function executeOrchestratedCall(toolCall, round) {
+    const tool = findToolByName(round.tools, toolCall.name);
+    if (!tool) {
+        // Tool not found in definitions
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            source: 'client',
+            result: null,
+            error: new Error(`Tool "${toolCall.name}" not found in tool definitions`),
+        };
+    }
+    if (!isAutoResolvableTool(tool)) {
+        // Tool has no execute/onToolCalled - return null to filter out
+        return null;
+    }
+    // Async lifecycles are unsupported here — short-circuit BEFORE running
+    // the body. This matters for deferred tools especially: their run()
+    // executes in-round and would open an external ticket that this loop can
+    // never resolve (an orphan external task).
+    if (isUnifiedTool(tool) && tool.function.lifecycle && tool.function.lifecycle !== 'sync') {
+        return {
+            toolCallId: toolCall.id,
+            toolName: toolCall.name,
+            source: isMcpTool(tool) ? 'mcp' : 'client',
+            result: null,
+            error: new Error(`Tool "${toolCall.name}" uses an async lifecycle ('${tool.function.lifecycle}'), which executeToolLoop does not support — run it through callModel instead.`),
+        };
+    }
+    // Find the raw tool call from the response output
+    const rawToolCall = round.response.output.find((item) => isFunctionCallItem(item) && item.callId === toolCall.id);
+    if (!rawToolCall) {
+        throw new Error(`Could not find raw tool call for ${toolCall.id}`);
+    }
+    // Convert to FunctionCallItem format
+    const openResponsesToolCall = {
+        type: 'function_call',
+        callId: rawToolCall.callId,
+        name: rawToolCall.name,
+        arguments: rawToolCall.arguments,
+        id: rawToolCall.callId,
+        status: rawToolCall.status,
+    };
+    // Build turn context with full information
+    const turnContext = buildTurnContext({
+        numberOfTurns: round.round,
+        toolCall: openResponsesToolCall,
+        turnRequest: round.request,
+    });
+    // Execute the tool
+    return executeTool(tool, toolCall, turnContext, round.onPreliminaryResult);
+}
 //# sourceMappingURL=tool-orchestrator.js.map

package/esm/lib/tool-orchestrator.js.map

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

package/esm/lib/tool-set-types.d.ts

@@ -0,0 +1,298 @@
+import { TOOL_SET_SNAPSHOT } from './async-params.js';
+import type { ClientTool, ConversationState, CorrelatedToolEventUnion, ServerToolBase, Tool } from './tool-types.js';
+/** Client tool: `function.name` literal. */
+export type ClientToolName<T> = T extends {
+    function: {
+        name: infer N extends string;
+    };
+} ? N : never;
+/**
+ * Server-tool stable ID.
+ * Prefixed so it can never collide with a client function name.
+ * Prefers an explicit `id` on the tool; falls back to `server:${config.type}`.
+ *
+ * When `T`'s `id` has been widened to plain `string` (e.g. a custom-ID
+ * `ServerTool<T, TId>` value erased to the exported `ServerToolBase`
+ * interface), the concrete literal is no longer visible at the type level.
+ * Synthesizing `` `server:${config.type}` `` in that case would be unsound:
+ * the runtime `id` could be anything, and the synthesized literal would
+ * both reject the real id and falsely claim a default that may not hold.
+ * Widening to `string` here is the sound choice — it accepts any runtime id.
+ * Only tools with no structural `id` at all fall back to the synthesized
+ * default, and concrete `ServerTool<T, TId>` values keep their literal `TId`.
+ */
+export type ServerToolIdOf<T> = 'id' extends keyof T ? T extends {
+    readonly id?: infer Id;
+} ? Extract<Id, string> extends infer StringId extends string ? string extends StringId ? string : StringId : never : never : T extends {
+    readonly config: {
+        type: infer K extends string;
+    };
+} ? `server:${K}` : never;
+/** Union of every addressable id for one tool. */
+export type ToolIdOf<T extends Tool> = T extends ServerToolBase ? ServerToolIdOf<T> : ClientToolName<T>;
+export type ToolIdsOfTuple<T extends readonly Tool[]> = ToolIdOf<T[number]>;
+export type ClientToolNamesOfTuple<T extends readonly Tool[]> = ClientToolName<Extract<T[number], ClientTool>>;
+export type ServerToolIdsOfTuple<T extends readonly Tool[]> = ServerToolIdOf<Extract<T[number], ServerToolBase>>;
+/** Lookup tool by id inside a tuple (preserves concrete member type). */
+export type ToolById<T extends readonly Tool[], Id extends string> = Extract<{
+    [I in keyof T]: T[I] extends Tool ? (ToolIdOf<T[I]> extends Id ? T[I] : never) : never;
+}[number], Tool>;
+/**
+ * Distributive per-element filter used for the wide (non-tuple) case below.
+ * A "naked" type parameter (`El`) is required for the conditional to
+ * distribute over the `T[number]` union; wrapping it in an indexed access
+ * (e.g. checking `T[number]` directly inside the conditional) would collapse
+ * to a single non-distributive check instead.
+ */
+type KeepIfActive<El, Active extends string> = El extends Tool ? string extends ToolIdOf<El> ? El : ToolIdOf<El> extends Active ? El : never : never;
+/**
+ * Keep tuple order; drop members whose id is not in Active.
+ *
+ * A genuine fixed-length tuple (`T['length']` is a literal number) is
+ * filtered by exact head/tail recursion, preserving order and concrete
+ * per-element types. A dynamic `readonly Tool[]` (e.g. an `@openrouter/agent/mcp`
+ * tool array not typed as a literal tuple) has `number extends T['length']`,
+ * so it falls back to a distributive per-element filter instead of
+ * recursing — the tuple pattern never matches a general array, and without
+ * this branch the recursion always bottoms out at `readonly []`.
+ */
+export type FilterToolsByIds<T extends readonly Tool[], Active extends string> = number extends T['length'] ? readonly KeepIfActive<T[number], Active>[] : T extends readonly [
+    infer H extends Tool,
+    ...infer R extends readonly Tool[]
+] ? ToolIdOf<H> extends Active ? readonly [
+    H,
+    ...FilterToolsByIds<R, Active>
+] : FilterToolsByIds<R, Active> : readonly [];
+/** IDs that are statically enabled or selected from the conditional partition. */
+type ResolvedActiveIds<P extends Partition, TActive extends string> = P['enabled'] | Extract<TActive, P['conditional']>;
+/**
+ * Exact tuple for static partitions; possible active members for partitions
+ * whose runtime predicates can change tuple membership.
+ */
+export type ResolvedTools<TTools extends readonly Tool[], P extends Partition, TActive extends P['conditional'] = P['conditional']> = [
+    P['conditional']
+] extends [
+    never
+] ? FilterToolsByIds<TTools, P['enabled'] & ToolIdsOfTuple<TTools>> : readonly FilterToolsByIds<TTools, ResolvedActiveIds<P, TActive> & ToolIdsOfTuple<TTools>>[number][];
+/**
+ * Enabled  = statically on (default, or .activate / situation.enabled)
+ * Disabled = statically off (.deactivate / situation.disabled)
+ * Conditional = runtime predicate (.activateWhen / .deactivateWhen / situation rules)
+ *
+ * Invariants (enforced by mutators via Exclude):
+ *   Enabled ∩ Disabled = ∅
+ *   Enabled ∩ Conditional = ∅
+ *   Disabled ∩ Conditional = ∅
+ *   Enabled ∪ Disabled ∪ Conditional = all known IDs
+ */
+export type Partition = {
+    enabled: string;
+    disabled: string;
+    conditional: string;
+};
+export type EmptyPartition = {
+    enabled: never;
+    disabled: never;
+    conditional: never;
+};
+/** Default construction: every tool ID enabled. */
+export type InitialPartition<T extends readonly Tool[]> = {
+    enabled: ToolIdsOfTuple<T>;
+    disabled: never;
+    conditional: never;
+};
+/**
+ * Deliberately imprecise partition for mutable `ToolSet` instances.
+ *
+ * A mutable `ToolSet` mutates one shared runtime object in place, and any
+ * number of aliases can reference that same object. If mutators refined the
+ * partition type the way the immutable path does, two aliases of the same
+ * live object could statically claim different, contradictory exact
+ * partitions the instant one of them mutated — an unsound state (e.g. one
+ * alias's type promising `disabled: never` while the object it points to
+ * has, in fact, just been deactivated through another alias).
+ *
+ * Mutable instances therefore use this single widened partition,
+ * unconditionally and unchanging, for their entire lifetime: nothing is
+ * ever statically guaranteed enabled or disabled, and every id is treated
+ * as `conditional` (only knowable by calling `resolve()`). Every alias of a
+ * mutable instance carries the exact same (already maximally conservative)
+ * type, so no alias can ever make a compile-time claim the runtime object
+ * could contradict.
+ */
+export type WidenedPartition<T extends readonly Tool[]> = {
+    enabled: never;
+    disabled: never;
+    conditional: ToolIdsOfTuple<T>;
+};
+export type ActivatePartition<P extends Partition, Name extends string> = {
+    enabled: P['enabled'] | Name;
+    disabled: Exclude<P['disabled'], Name>;
+    conditional: Exclude<P['conditional'], Name>;
+};
+export type DeactivatePartition<P extends Partition, Name extends string> = {
+    enabled: Exclude<P['enabled'], Name>;
+    disabled: P['disabled'] | Name;
+    conditional: Exclude<P['conditional'], Name>;
+};
+export type ConditionalPartition<P extends Partition, Name extends string> = {
+    enabled: Exclude<P['enabled'], Name>;
+    disabled: Exclude<P['disabled'], Name>;
+    conditional: P['conditional'] | Name;
+};
+export type ActivationInput<TShared extends Record<string, unknown> = Record<string, unknown>> = {
+    state?: ConversationState;
+    context?: TShared;
+};
+export type ActivationPredicate<TShared extends Record<string, unknown> = Record<string, unknown>> = (input: ActivationInput<TShared>) => boolean;
+export type SituationConditionalRule<TShared extends Record<string, unknown> = Record<string, unknown>> = ActivationPredicate<TShared> | {
+    mode?: 'activateWhen' | 'deactivateWhen';
+    predicate: ActivationPredicate<TShared>;
+};
+/**
+ * Declarative fixed partition overlay for one named situation.
+ * Keys not listed keep the base ToolSet partition after the overlay.
+ */
+export type SituationConfig<TIds extends string = string, TShared extends Record<string, unknown> = Record<string, unknown>> = {
+    /** Statically on in this situation. */
+    enabled?: readonly TIds[];
+    /** Statically off in this situation. */
+    disabled?: readonly TIds[];
+    /**
+     * Conditional tools for this situation.
+     * Default mode is activateWhen (inactive until predicate is true).
+     * Use `{ mode: 'deactivateWhen', predicate }` for the reverse default.
+     */
+    conditional?: {
+        readonly [K in TIds]?: SituationConditionalRule<TShared>;
+    };
+};
+/** Situations registry accumulated on the ToolSet type. */
+export type SituationMap = Record<string, {
+    enabled: string;
+    disabled: string;
+    conditional: string;
+}>;
+export type EmptySituations = Record<never, never>;
+/**
+ * Deliberately imprecise situation registry for mutable `ToolSet` instances.
+ *
+ * Mirrors {@link WidenedPartition}: since `defineSituations` on a mutable
+ * instance mutates the shared runtime situation registry in place, its type
+ * cannot statically promise a specific set of situation names without
+ * risking the same cross-alias contradiction. `string` keeps every
+ * situation name assignable while still requiring a real string key.
+ */
+export type WidenedSituationMap = Record<string, Partition>;
+export type SituationNames<S extends SituationMap> = keyof S & string;
+/**
+ * Infer the static partition contribution of a situation config object.
+ * Missing fields contribute `never`.
+ */
+export type InferSituationEntry<C> = {
+    enabled: C extends {
+        enabled: readonly (infer E extends string)[];
+    } ? E : never;
+    disabled: C extends {
+        disabled: readonly (infer D extends string)[];
+    } ? D : never;
+    conditional: C extends {
+        conditional: infer Cond;
+    } ? keyof Cond & string : never;
+};
+export type InferSituationMap<M> = {
+    [K in keyof M]: InferSituationEntry<M[K]>;
+};
+/**
+ * Apply a situation overlay onto a base partition.
+ * Situation wins for every id it mentions; others stay from base.
+ */
+export type ApplySituationPartition<Base extends Partition, Sit extends {
+    enabled: string;
+    disabled: string;
+    conditional: string;
+}> = {
+    enabled: Exclude<Base['enabled'], Sit['enabled'] | Sit['disabled'] | Sit['conditional']> | Sit['enabled'];
+    disabled: Exclude<Base['disabled'], Sit['enabled'] | Sit['disabled'] | Sit['conditional']> | Sit['disabled'];
+    conditional: Exclude<Base['conditional'], Sit['enabled'] | Sit['disabled'] | Sit['conditional']> | Sit['conditional'];
+};
+export type StatusReason = 'default' | 'activate' | 'deactivate' | 'activateWhen' | 'deactivateWhen' | 'situation';
+export type ToolStatusEntry = {
+    readonly enabled: boolean;
+    readonly reason: StatusReason;
+    /**
+     * The last applicable directive for this tool before predicates ran, if any.
+     * Absent when the tool is still at its construction default.
+     */
+    readonly directive?: 'activate' | 'deactivate' | 'activateWhen' | 'deactivateWhen';
+    /** True when the final state depended on evaluating a runtime predicate. */
+    readonly predicate?: boolean;
+};
+export type StatusByToolMap<TIds extends string> = {
+    readonly [K in TIds]: ToolStatusEntry;
+};
+/**
+ * What resolve() / resolveSituation() returns.
+ *
+ * For static-only partitions (`conditional = never`), the snapshot is fully
+ * known at compile time. When conditional ≠ never, TActive selects possible
+ * members from `P['conditional']`; `P['enabled']` is always included. Tools
+ * become a readonly array of that possible member union because predicates
+ * can change length and positions at runtime. Runtime arrays/status are exact.
+ *
+ * `disabled` is declared as the complement of the *definitely-enabled* set
+ * (`P['enabled']`), not of `TActive`. A conditional id's predicate can
+ * resolve to either outcome at runtime — `#resolveWithActivation` pushes it
+ * into `disabled` whenever the predicate says off — so conditional ids must
+ * remain in both the `enabled` and `disabled` upper bounds for the declared
+ * types to stay sound. (Subtracting `TActive`, which already includes
+ * `P['conditional']`, would wrongly exclude conditional ids from `disabled`.)
+ */
+export type ResolvedToolSnapshot<TTools extends readonly Tool[], P extends Partition, TActive extends P['conditional'] = P['conditional']> = {
+    /** Active tools only, construction order preserved, concrete member types kept. */
+    readonly tools: ResolvedTools<TTools, P, TActive>;
+    /** Active client names only (`callModel.activeTools` wire format). Server ids omitted. */
+    readonly activeTools: readonly Extract<ResolvedActiveIds<P, TActive>, ClientToolNamesOfTuple<TTools>>[];
+    /** Spread-safe input for `callModel`; snapshot metadata is intentionally excluded. */
+    readonly callModel: {
+        readonly tools: ResolvedTools<TTools, P, TActive>;
+        readonly activeTools: readonly Extract<ResolvedActiveIds<P, TActive>, ClientToolNamesOfTuple<TTools>>[];
+    };
+    /** IDs that resolved active (client + server). */
+    readonly enabled: readonly (ResolvedActiveIds<P, TActive> & ToolIdsOfTuple<TTools>)[];
+    /**
+     * IDs that resolved inactive (client + server). Sound upper bound: the
+     * complement of the definitely-enabled set, so conditional ids whose
+     * predicate resolves `false` are included here too.
+     */
+    readonly disabled: readonly Exclude<ToolIdsOfTuple<TTools>, P['enabled']>[];
+    /** Exhaustive id → status entry. Every ToolIdsOfTuple key present. */
+    readonly statusByTool: StatusByToolMap<ToolIdsOfTuple<TTools>>;
+    /** Internal marker allowing `callModel` to recognize a snapshot spread. */
+    readonly [TOOL_SET_SNAPSHOT]: true;
+};
+/**
+ * Structural shape for extracting partition/situation generics from either
+ * mutable or immutable `ToolSet` instances.
+ */
+export type ToolSetLike<TTools extends readonly Tool[] = readonly Tool[], TShared extends Record<string, unknown> = Record<string, unknown>, P extends Partition = Partition, Sit extends SituationMap = SituationMap> = {
+    readonly tools: TTools;
+    readonly _partition?: P;
+    readonly _situations?: Sit;
+    readonly _shared?: TShared;
+};
+/** Every known tool-set ID. */
+export type InferAllIds<TS> = TS extends ToolSetLike<infer T, any, any, any> ? ToolIdsOfTuple<T> : never;
+/** Definitely-enabled IDs (static). */
+export type InferEnabledIds<TS> = TS extends ToolSetLike<any, any, infer P, any> ? P['enabled'] : never;
+/** Definitely-disabled IDs (static). */
+export type InferDisabledIds<TS> = TS extends ToolSetLike<any, any, infer P, any> ? P['disabled'] : never;
+/** Conditionally-activated IDs (runtime predicate). */
+export type InferConditionalIds<TS> = TS extends ToolSetLike<any, any, infer P, any> ? P['conditional'] : never;
+/**
+ * Name-correlated streaming events for a tools tuple.
+ * Delegates to the agent's core {@link CorrelatedToolEventUnion}.
+ */
+export type InferToolSet<T extends readonly Tool[]> = CorrelatedToolEventUnion<T>;
+export {};
+//# sourceMappingURL=tool-set-types.d.ts.map

package/esm/lib/tool-set-types.d.ts.map

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

package/esm/lib/tool-set-types.js

@@ -0,0 +1,2 @@
+import { TOOL_SET_SNAPSHOT } from './async-params.js';
+//# sourceMappingURL=tool-set-types.js.map

package/esm/lib/tool-set-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-set-types.js","sourceRoot":"","sources":["../../src/lib/tool-set-types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC"}