@openrouter/agent 0.8.0 → 0.10.0

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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"}

package/esm/lib/agent-tool.d.ts

@@ -0,0 +1,92 @@
+import type { $ZodObject, $ZodShape, $ZodType, infer as zodInfer } from 'zod/v4/core';
+import type { CallModelInput } from './async-params.js';
+import type { ModelResult } from './model-result.js';
+import type { TaskTranscriptSource } from './tool-task.js';
+import type { AsyncToolAck, ContextFromSchema, ConversationState, NextTurnParamsFunctions, Tool, ToolApprovalCheck, ToolCheckConfig, ToolExecuteContext, ToolLoopKey, UnifiedTool } from './tool-types.js';
+/**
+ * The child run spec an agent tool produces per call.
+ *
+ * Exclusions and why:
+ * - `state`: the engine supplies an internal in-memory accessor (it is what
+ *   makes the live transcript possible). A child persisting to the parent's
+ *   accessor would clobber the parent conversation; durable child sessions
+ *   are a separate feature.
+ * - `signal`: the engine supplies it (parent abort / timeout / cancelTask
+ *   propagate into the child).
+ * - `approveToolCalls`/`rejectToolCalls`: approval decisions belong to a
+ *   durable session.
+ *
+ * `hooks` IS allowed — a child may declare its own hooks explicitly. The
+ * parent's hooks are never inherited (they are written against the parent's
+ * tool vocabulary and their session accounting would double-fire per child).
+ */
+export type AgentRunSpec<TChildTools extends readonly Tool[] = readonly Tool[]> = Omit<CallModelInput<TChildTools>, 'state' | 'approveToolCalls' | 'rejectToolCalls' | 'signal'>;
+/**
+ * Live transcript over an agent child's conversation, rendered from the
+ * child's (internal, in-memory) conversation state — the actual message
+ * history, robust regardless of streaming vs non-streaming transport.
+ */
+export declare class AgentTranscriptSource implements TaskTranscriptSource {
+    private readonly readState;
+    private turnsStarted;
+    private turnsEnded;
+    private currentActivity;
+    constructor(readState: () => ConversationState | null);
+    noteTurnStart(): void;
+    noteTurnEnd(lastText: string): void;
+    setActivity(activity: string): void;
+    statusExtras(): Record<string, unknown>;
+    render(maxChars: number): string;
+}
+/** Configuration for `tool.agent()`. */
+export type AgentToolConfig<TInput extends $ZodObject<$ZodShape>, TOutput extends $ZodType, TChildTools extends readonly Tool[] = readonly Tool[], TCtx extends $ZodObject<$ZodShape> = $ZodObject<$ZodShape>, TName extends string = string> = {
+    name: TName;
+    description?: string;
+    inputSchema: TInput;
+    /**
+     * Whether providers should enforce strict schema adherence for this agent
+     * tool's generated arguments. OpenAI-style strict mode requires every
+     * property to be required; those providers may reject `.optional()` fields,
+     * so use `.nullable()` when the key may conceptually have no value.
+     */
+    strict?: boolean | null;
+    /**
+     * Required. The mapped child result is validated against it — the same
+     * rule every long-running tool obeys (results settle after the round).
+     */
+    outputSchema: TOutput;
+    /** Build the child run spec from this call's arguments. */
+    agent: (params: zodInfer<TInput>, context?: ToolExecuteContext<TName, ContextFromSchema<TCtx>>) => AgentRunSpec<TChildTools> | Promise<AgentRunSpec<TChildTools>>;
+    /**
+     * Map the finished child run to this tool's output. Default:
+     * `{ text: await child.getText() }` — so the natural outputSchema is
+     * `z.object({ text: z.string() })`.
+     */
+    result?: (child: ModelResult<TChildTools>) => Promise<zodInfer<TOutput>> | zodInfer<TOutput>;
+    /** Hold the round this long before placeholdering. Default 250ms. */
+    graceMs?: number;
+    /** Deadline for the whole child run, in ms. */
+    timeoutMs?: number;
+    /** Max simultaneous child runs of this tool. */
+    maxConcurrency?: number;
+    /** Model-facing acknowledgement merged into the pending placeholder. */
+    ack?: AsyncToolAck<zodInfer<TInput>>;
+    /** Check-in config (the SDK default reports turns + activity). */
+    check?: ToolCheckConfig;
+    contextSchema?: TCtx;
+    nextTurnParams?: NextTurnParamsFunctions<zodInfer<TInput>>;
+    requireApproval?: boolean | ToolApprovalCheck<zodInfer<TInput>>;
+    loopKey?: ToolLoopKey<zodInfer<TInput>>;
+};
+/**
+ * Create an agent tool: a long-running tool whose work IS a child
+ * `callModel` conversation. The child runs as a background task — the
+ * parent loop keeps going, its per-turn activity feeds the task log (one
+ * entry per child turn), its conversation is the check-in transcript, and
+ * its final answer (via the `result` mapper) is delivered like any
+ * background result. Steering messages (`sendToTask`, or a check call's
+ * `task.send`) are injected into the child as user messages at its next
+ * turn boundary. `cancelTask` / parent abort cancel the child run.
+ */
+export declare function agentToolBuilder<TInput extends $ZodObject<$ZodShape>, TOutput extends $ZodType, TChildTools extends readonly Tool[] = readonly Tool[], TCtx extends $ZodObject<$ZodShape> = $ZodObject<$ZodShape>, TName extends string = string>(config: AgentToolConfig<TInput, TOutput, TChildTools, TCtx, TName>): UnifiedTool<TInput, TOutput, $ZodType<unknown>, Record<string, unknown>, TCtx, TName>;
+//# sourceMappingURL=agent-tool.d.ts.map

package/esm/lib/agent-tool.d.ts.map

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

package/esm/lib/agent-tool.js

@@ -0,0 +1,211 @@
+import { extractTextFromResponse } from './conversation-state.js';
+import { TASK_TOOL_NAME } from './tool-check.js';
+import { truncateTranscriptTail } from './tool-task.js';
+import { SHARED_CONTEXT_KEY, ToolType } from './tool-types.js';
+const TEXT_PREVIEW_CHARS = 200;
+const ARGS_PREVIEW_CHARS = 80;
+function preview(value, maxChars) {
+    const text = typeof value === 'string' ? value : (JSON.stringify(value) ?? String(value));
+    return text.length > maxChars ? `${text.slice(0, maxChars)}…` : text;
+}
+/**
+ * Live transcript over an agent child's conversation, rendered from the
+ * child's (internal, in-memory) conversation state — the actual message
+ * history, robust regardless of streaming vs non-streaming transport.
+ */
+export class AgentTranscriptSource {
+    constructor(readState) {
+        this.readState = readState;
+        this.turnsStarted = 0;
+        this.turnsEnded = 0;
+        this.currentActivity = 'starting';
+    }
+    noteTurnStart() {
+        this.turnsStarted++;
+        this.currentActivity = `turn ${this.turnsStarted} in progress`;
+    }
+    noteTurnEnd(lastText) {
+        this.turnsEnded++;
+        this.currentActivity = lastText ? `responded: ${preview(lastText, 80)}` : 'thinking';
+    }
+    setActivity(activity) {
+        this.currentActivity = activity;
+    }
+    statusExtras() {
+        return {
+            // Ended turns only — an in-flight turn shows up in turnsStarted and
+            // currentActivity, but is not counted as completed.
+            turnsCompleted: this.turnsEnded,
+            turnsStarted: this.turnsStarted,
+            currentActivity: this.currentActivity,
+        };
+    }
+    render(maxChars) {
+        const state = this.readState();
+        if (!state || !Array.isArray(state.messages)) {
+            return '';
+        }
+        const lines = [];
+        for (const item of state.messages) {
+            const type = item['type'];
+            const role = item['role'];
+            if (role === 'user' && typeof item['content'] === 'string') {
+                lines.push(`user: ${preview(item['content'], TEXT_PREVIEW_CHARS)}`);
+            }
+            else if (type === 'message' && role === 'assistant') {
+                const content = item['content'];
+                const text = Array.isArray(content)
+                    ? content
+                        .map((c) => c.text ?? '')
+                        .join('')
+                        .trim()
+                    : '';
+                if (text) {
+                    lines.push(`assistant: ${preview(text, TEXT_PREVIEW_CHARS)}`);
+                }
+            }
+            else if (type === 'function_call') {
+                lines.push(`→ ${String(item['name'])}(${preview(item['arguments'], ARGS_PREVIEW_CHARS)})`);
+            }
+            else if (type === 'function_call_output') {
+                lines.push(`  ⇒ ${preview(item['output'], ARGS_PREVIEW_CHARS)}`);
+            }
+        }
+        const full = lines.join('\n');
+        return truncateTranscriptTail(full, maxChars);
+    }
+}
+/** Paused child statuses that an in-memory agent child cannot recover from. */
+const CHILD_PAUSE_STATUSES = new Set([
+    'awaiting_approval',
+    'awaiting_hitl',
+    'awaiting_client_tools',
+    'awaiting_async_tools',
+]);
+/**
+ * Create an agent tool: a long-running tool whose work IS a child
+ * `callModel` conversation. The child runs as a background task — the
+ * parent loop keeps going, its per-turn activity feeds the task log (one
+ * entry per child turn), its conversation is the check-in transcript, and
+ * its final answer (via the `result` mapper) is delivered like any
+ * background result. Steering messages (`sendToTask`, or a check call's
+ * `task.send`) are injected into the child as user messages at its next
+ * turn boundary. `cancelTask` / parent abort cancel the child run.
+ */
+export function agentToolBuilder(config) {
+    // Same reserved-name guards as tool() — a subagent named 'shared' would
+    // collide with the shared-context store key, one named 'task' would
+    // disable the built-in task-interaction tool.
+    if (config.name === SHARED_CONTEXT_KEY) {
+        throw new Error(`Tool name "${SHARED_CONTEXT_KEY}" is reserved for shared context. Choose a different name.`);
+    }
+    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.`);
+    }
+    if (config.outputSchema === undefined) {
+        throw new Error(`Agent tool "${config.name}" must declare an outputSchema. The child's mapped result is validated when it settles.`);
+    }
+    const defaultResult = async (child) => ({
+        text: await child.getText(),
+    });
+    const mapResult = config.result ?? defaultResult;
+    // The synthesized run: a plain async fn driving the child to completion.
+    // Turn activity surfaces through ctx.log (task log + preliminary events);
+    // the transcript reads the child's live in-memory conversation state.
+    async function run(params, ctx) {
+        const client = ctx?.client;
+        if (!client) {
+            throw new Error(`Agent tool "${config.name}": no client available on the run context. Agent tools must execute inside a callModel run.`);
+        }
+        const spec = await config.agent(params, ctx);
+        // Internal in-memory accessor: the child's message history IS the
+        // transcript, and getState() enables the pause-detection below. Never
+        // the caller's accessor — a child persisting there would clobber the
+        // parent conversation.
+        let childState = null;
+        const childAccessor = {
+            load: async () => childState,
+            save: async (state) => {
+                childState = state;
+            },
+        };
+        const transcript = new AgentTranscriptSource(() => childState);
+        if (ctx?.taskTranscript) {
+            ctx.taskTranscript.transcriptSource = transcript;
+        }
+        // Lazy import: agent-tool → call-model → model-result would otherwise
+        // be a static cycle (same pattern as bindDeferredCompletion).
+        const { callModel } = await import('../inner-loop/call-model.js');
+        const userOnTurnStart = spec.onTurnStart;
+        const userOnTurnEnd = spec.onTurnEnd;
+        const child = callModel(client, {
+            ...spec,
+            state: childAccessor,
+            ...(ctx?.signal !== undefined && {
+                signal: ctx.signal,
+            }),
+            onTurnStart: async (turnContext) => {
+                transcript.noteTurnStart();
+                await userOnTurnStart?.(turnContext);
+            },
+            onTurnEnd: async (turnContext, response) => {
+                const text = extractTextFromResponse(response);
+                transcript.noteTurnEnd(text);
+                // One log entry per child turn — feeds tailLogs and preliminary
+                // results on the parent stream.
+                ctx?.log?.({
+                    turn: turnContext.numberOfTurns,
+                    textPreview: preview(text.trim(), TEXT_PREVIEW_CHARS),
+                });
+                await userOnTurnEnd?.(turnContext, response);
+            },
+        });
+        // Steering: forward inbound task messages into the child conversation
+        // as user messages at its next safe turn boundary.
+        ctx?.onMessage?.((message) => {
+            child.queueUserMessage(typeof message === 'string' ? message : JSON.stringify(message));
+        });
+        // Drive the child to completion.
+        await child.getResponse();
+        transcript.setActivity('finished');
+        // In-memory children cannot pause durably: a paused child means a tool
+        // inside it awaits input that will never arrive. Fail loudly instead of
+        // silently returning a partial answer.
+        const finalStatus = childState !== null ? childState.status : undefined;
+        if (finalStatus !== undefined && CHILD_PAUSE_STATUSES.has(finalStatus)) {
+            throw new Error(`Agent tool "${config.name}": the child run paused with status '${finalStatus}'. Agent children run in-memory and cannot pause — avoid HITL/manual/deferred/approval tools inside agents (use lifecycle: 'deferred' on the parent tool instead).`);
+        }
+        return await mapResult(child);
+    }
+    const fn = {
+        lifecycle: 'background',
+        kind: 'agent',
+        name: config.name,
+        inputSchema: config.inputSchema,
+        outputSchema: config.outputSchema,
+        run,
+    };
+    const optionalFields = [
+        'description',
+        'strict',
+        'contextSchema',
+        'nextTurnParams',
+        'requireApproval',
+        'loopKey',
+        'timeoutMs',
+        'maxConcurrency',
+        'ack',
+        'graceMs',
+        'check',
+    ];
+    for (const field of optionalFields) {
+        if (config[field] !== undefined) {
+            fn[field] = config[field];
+        }
+    }
+    return {
+        type: ToolType.Function,
+        function: fn,
+    };
+}
+//# sourceMappingURL=agent-tool.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent-tool.js","sourceRoot":"","sources":["../../src/lib/agent-tool.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAElE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAcxD,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAwB/D,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,kBAAkB,GAAG,EAAE,CAAC;AAE9B,SAAS,OAAO,CAAC,KAAc,EAAE,QAAgB;IAC/C,MAAM,IAAI,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1F,OAAO,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,qBAAqB;IAKhC,YAA6B,SAAyC;QAAzC,cAAS,GAAT,SAAS,CAAgC;QAJ9D,iBAAY,GAAG,CAAC,CAAC;QACjB,eAAU,GAAG,CAAC,CAAC;QACf,oBAAe,GAAG,UAAU,CAAC;IAEoC,CAAC;IAE1E,aAAa;QACX,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,IAAI,CAAC,eAAe,GAAG,QAAQ,IAAI,CAAC,YAAY,cAAc,CAAC;IACjE,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC,CAAC,CAAC,cAAc,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;IACvF,CAAC;IAED,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,eAAe,GAAG,QAAQ,CAAC;IAClC,CAAC;IAED,YAAY;QACV,OAAO;YACL,oEAAoE;YACpE,oDAAoD;YACpD,cAAc,EAAE,IAAI,CAAC,UAAU;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAgB;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7C,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAA0C,EAAE,CAAC;YACpE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAC3D,KAAK,CAAC,IAAI,CAAC,SAAS,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACtE,CAAC;iBAAM,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;gBACtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;gBAChC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;oBACjC,CAAC,CAAC,OAAO;yBACJ,GAAG,CACF,CAAC,CAAC,EAAE,EAAE,CAEF,CAGD,CAAC,IAAI,IAAI,EAAE,CACf;yBACA,IAAI,CAAC,EAAE,CAAC;yBACR,IAAI,EAAE;oBACX,CAAC,CAAC,EAAE,CAAC;gBACP,IAAI,IAAI,EAAE,CAAC;oBACT,KAAK,CAAC,IAAI,CAAC,cAAc,OAAO,CAAC,IAAI,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;gBAChE,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;gBACpC,KAAK,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC,CAAC;YAC7F,CAAC;iBAAM,IAAI,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC3C,KAAK,CAAC,IAAI,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,OAAO,sBAAsB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;CACF;AAoDD,+EAA+E;AAC/E,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,mBAAmB;IACnB,eAAe;IACf,uBAAuB;IACvB,sBAAsB;CACvB,CAAC,CAAC;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAO9B,MAAkE;IAElE,wEAAwE;IACxE,oEAAoE;IACpE,8CAA8C;IAC9C,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACvC,MAAM,IAAI,KAAK,CACb,cAAc,kBAAkB,4DAA4D,CAC7F,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,cAAc,cAAc,gFAAgF,CAC7G,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,CAAC,IAAI,yFAAyF,CACpH,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,KAAK,EAAE,KAA+B,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,EAAE,MAAM,KAAK,CAAC,OAAO,EAAE;KAC5B,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,IAAK,aAAmD,CAAC;IAExF,yEAAyE;IACzE,0EAA0E;IAC1E,sEAAsE;IACtE,KAAK,UAAU,GAAG,CAChB,MAAwB,EACxB,GAOC;QAED,MAAM,MAAM,GAAG,GAAG,EAAE,MAAM,CAAC;QAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,CAAC,IAAI,6FAA6F,CACxH,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAE7C,kEAAkE;QAClE,sEAAsE;QACtE,qEAAqE;QACrE,uBAAuB;QACvB,IAAI,UAAU,GAA6B,IAAI,CAAC;QAChD,MAAM,aAAa,GAAkB;YACnC,IAAI,EAAE,KAAK,IAAI,EAAE,CAAC,UAAU;YAC5B,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;gBACpB,UAAU,GAAG,KAAK,CAAC;YACrB,CAAC;SACF,CAAC;QAEF,MAAM,UAAU,GAAG,IAAI,qBAAqB,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,GAAG,EAAE,cAAc,EAAE,CAAC;YACxB,GAAG,CAAC,cAAc,CAAC,gBAAgB,GAAG,UAAU,CAAC;QACnD,CAAC;QAED,sEAAsE;QACtE,8DAA8D;QAC9D,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,6BAA6B,CAAC,CAAC;QAElE,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC;QACzC,MAAM,aAAa,GAAG,IAAI,CAAC,SAAS,CAAC;QAErC,MAAM,KAAK,GAAG,SAAS,CAAC,MAAM,EAAE;YAC9B,GAAG,IAAI;YACP,KAAK,EAAE,aAAa;YACpB,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,IAAI;gBAC/B,MAAM,EAAE,GAAG,CAAC,MAAM;aACnB,CAAC;YACF,WAAW,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE;gBACjC,UAAU,CAAC,aAAa,EAAE,CAAC;gBAC3B,MAAM,eAAe,EAAE,CAAC,WAAW,CAAC,CAAC;YACvC,CAAC;YACD,SAAS,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE;gBACzC,MAAM,IAAI,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;gBAC/C,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC7B,gEAAgE;gBAChE,gCAAgC;gBAChC,GAAG,EAAE,GAAG,EAAE,CAAC;oBACT,IAAI,EAAE,WAAW,CAAC,aAAa;oBAC/B,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,kBAAkB,CAAC;iBACtD,CAAC,CAAC;gBACH,MAAM,aAAa,EAAE,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;YAC/C,CAAC;SAGF,CAA6B,CAAC;QAE/B,sEAAsE;QACtE,mDAAmD;QACnD,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE;YAC3B,KAAK,CAAC,gBAAgB,CAAC,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1F,CAAC,CAAC,CAAC;QAEH,iCAAiC;QACjC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC;QAC1B,UAAU,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;QAEnC,uEAAuE;QACvE,wEAAwE;QACxE,uCAAuC;QACvC,MAAM,WAAW,GAAG,UAAU,KAAK,IAAI,CAAC,CAAC,CAAE,UAAgC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QAC/F,IAAI,WAAW,KAAK,SAAS,IAAI,oBAAoB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CACb,eAAe,MAAM,CAAC,IAAI,wCAAwC,WAAW,oKAAoK,CAClP,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,SAAS,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;IAED,MAAM,EAAE,GAA4B;QAClC,SAAS,EAAE,YAAY;QACvB,IAAI,EAAE,OAAO;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,GAAG;KACJ,CAAC;IACF,MAAM,cAAc,GAAG;QACrB,aAAa;QACb,QAAQ;QACR,eAAe;QACf,gBAAgB;QAChB,iBAAiB;QACjB,SAAS;QACT,WAAW;QACX,gBAAgB;QAChB,KAAK;QACL,SAAS;QACT,OAAO;KACC,CAAC;IACX,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;YAChC,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,QAAQ,CAAC,QAAQ;QACvB,QAAQ,EAAE,EAOG;KACd,CAAC;AACJ,CAAC"}