@better-agent/core 0.1.0-beta.1

package/dist/run/execute-tool-calls.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-tool-calls.mjs","names":[],"sources":["../../src/run/execute-tool-calls.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { logger } from \"@better-agent/shared/logger\";\nimport { safeJsonParse } from \"@better-agent/shared/utils\";\nimport { type Event, Events } from \"../events\";\nimport type { PluginRuntime } from \"../plugins\";\nimport type { GenerativeModelToolCallRequest, GenerativeModelToolCallResult } from \"../providers\";\nimport { validateInput } from \"../schema\";\nimport type {\n    AgentToolDefinition,\n    ExecutionToolError,\n    OnToolError,\n    ParseToolError,\n    ToolApprovalConfig,\n    ToolErrorContext,\n    ToolErrorMode,\n    ToolErrorPayload,\n    ToolErrorResultFor,\n    ValidationToolError,\n} from \"../tools\";\nimport type { PendingToolRuntime } from \"./pending-tools\";\nimport type { RunAdvancedOptions } from \"./types\";\n\nconst MAX_TOOL_ERROR_REPAIR_DEPTH = 2;\nconst MAX_TOOL_ERROR_RETRY_ATTEMPTS = 3;\n\ntype RecoverableToolErrorKind = ToolErrorPayload[\"errorKind\"];\ntype ExecutableToolDefinition = Exclude<AgentToolDefinition, { kind: \"hosted\" }>;\n\ntype ToolExecutionOutcome = {\n    result: unknown;\n    isError?: boolean;\n    errorKind?: RecoverableToolErrorKind;\n};\n\ntype ResolvedApproval = {\n    required?: boolean;\n    timeoutMs?: number;\n    meta?: Record<string, unknown>;\n};\n\ntype PreparedToolCall = {\n    toolCall: GenerativeModelToolCallRequest;\n    tool: ExecutableToolDefinition;\n    toolTarget: \"server\" | \"client\";\n    args?: unknown;\n    validatedInput?: unknown;\n    resolvedApproval?: ResolvedApproval;\n    skip: boolean;\n    skipResult?: unknown;\n    parseError?: BetterAgentError;\n    validationError?: BetterAgentError;\n    shouldEmitToolCallEnd: boolean;\n};\n\nconst getToolRunName = (tool: AgentToolDefinition): string | undefined =>\n    tool.kind === \"hosted\"\n        ? typeof tool.name === \"string\" && tool.name.length > 0\n            ? tool.name\n            : typeof tool.type === \"string\" && tool.type.length > 0\n              ? tool.type\n              : undefined\n        : typeof tool.name === \"string\" && tool.name.length > 0\n          ? tool.name\n          : undefined;\n\n/** Executes the next batch of tool calls. */\nexport const executeToolCalls = async <TContext>(params: {\n    runId: string;\n    agentName: string;\n    conversationId?: string;\n    parentMessageId: string;\n    toolCalls: readonly GenerativeModelToolCallRequest[];\n    tools: readonly AgentToolDefinition[];\n    toolErrorMode?: ToolErrorMode;\n    onToolError?: OnToolError;\n    signal: AbortSignal;\n    emit: (event: Event) => Promise<void>;\n    advanced?: RunAdvancedOptions;\n    pendingToolRuntime?: PendingToolRuntime;\n    context?: TContext;\n    pluginRuntime?: PluginRuntime | null;\n}): Promise<{\n    results: GenerativeModelToolCallResult[];\n}> => {\n    const results: GenerativeModelToolCallResult[] = [];\n\n    const throwIfAborted = () => {\n        if (params.signal.aborted) {\n            throw BetterAgentError.fromCode(\"ABORTED\", \"Tool execution was aborted.\", {\n                trace: [{ at: \"core.run.executeToolCalls.aborted\" }],\n            });\n        }\n    };\n\n    const isAbortError = (error: unknown): boolean =>\n        params.signal.aborted === true ||\n        (error instanceof BetterAgentError && error.code === \"ABORTED\");\n\n    const waitForRetryBackoff = async (ms: number) => {\n        if (ms <= 0) {\n            throwIfAborted();\n            return;\n        }\n\n        await new Promise<void>((resolve, reject) => {\n            const timer = setTimeout(() => {\n                params.signal.removeEventListener(\"abort\", onAbort);\n                resolve();\n            }, ms);\n\n            const onAbort = () => {\n                clearTimeout(timer);\n                reject(\n                    BetterAgentError.fromCode(\"ABORTED\", \"Tool execution was aborted.\", {\n                        trace: [{ at: \"core.run.executeToolCalls.retryBackoff\" }],\n                    }),\n                );\n            };\n\n            if (params.signal.aborted) {\n                onAbort();\n                return;\n            }\n\n            params.signal.addEventListener(\"abort\", onAbort, { once: true });\n        });\n    };\n\n    const extractToolErrorMessage = (\n        error: unknown,\n        errorKind: RecoverableToolErrorKind,\n    ): string => {\n        const rawMessage =\n            error instanceof BetterAgentError || error instanceof Error\n                ? error.message\n                : typeof error === \"string\"\n                  ? error\n                  : \"Unknown tool error\";\n\n        if (errorKind === \"parse\") {\n            return `Tool arguments could not be parsed as valid JSON. ${rawMessage}`.trim();\n        }\n\n        if (errorKind === \"validation\") {\n            return `Tool arguments failed schema validation. ${rawMessage}`.trim();\n        }\n\n        return rawMessage;\n    };\n\n    const createToolErrorOutcome = (args: {\n        toolName: string;\n        errorKind: RecoverableToolErrorKind;\n        message: string;\n        retryable?: boolean;\n    }): ToolExecutionOutcome => ({\n        result: {\n            type: \"tool_error\",\n            toolName: args.toolName,\n            errorKind: args.errorKind,\n            message: args.message,\n            retryable: args.retryable,\n        } satisfies ToolErrorPayload,\n        isError: true,\n        errorKind: args.errorKind,\n    });\n\n    const createToolErrorOutcomeFromError = (args: {\n        toolName: string;\n        error: unknown;\n        errorKind: RecoverableToolErrorKind;\n        message?: string;\n        retryable?: boolean;\n    }): ToolExecutionOutcome =>\n        createToolErrorOutcome({\n            toolName: args.toolName,\n            errorKind: args.errorKind,\n            message: args.message ?? extractToolErrorMessage(args.error, args.errorKind),\n            retryable:\n                args.retryable ??\n                (args.error instanceof BetterAgentError ? args.error.retryable : undefined),\n        });\n\n    const emitToolCallStart = async (prepared: {\n        toolCall: GenerativeModelToolCallRequest;\n        toolTarget: \"server\" | \"client\";\n    }) => {\n        await params.emit({\n            type: Events.TOOL_CALL_START,\n            runId: params.runId,\n            agentName: params.agentName,\n            parentMessageId: params.parentMessageId,\n            toolCallId: prepared.toolCall.callId,\n            toolCallName: prepared.toolCall.name,\n            toolTarget: prepared.toolTarget,\n            timestamp: Date.now(),\n        });\n    };\n\n    const emitToolCallArgs = async (prepared: {\n        toolCall: GenerativeModelToolCallRequest;\n        toolTarget: \"server\" | \"client\";\n    }) => {\n        await params.emit({\n            type: Events.TOOL_CALL_ARGS,\n            runId: params.runId,\n            agentName: params.agentName,\n            parentMessageId: params.parentMessageId,\n            toolCallId: prepared.toolCall.callId,\n            toolCallName: prepared.toolCall.name,\n            delta: prepared.toolCall.arguments,\n            toolTarget: prepared.toolTarget,\n            timestamp: Date.now(),\n        });\n    };\n\n    const emitToolCallEnd = async (prepared: {\n        toolCall: GenerativeModelToolCallRequest;\n        toolTarget: \"server\" | \"client\";\n    }) => {\n        await params.emit({\n            type: Events.TOOL_CALL_END,\n            runId: params.runId,\n            agentName: params.agentName,\n            parentMessageId: params.parentMessageId,\n            toolCallId: prepared.toolCall.callId,\n            toolCallName: prepared.toolCall.name,\n            toolTarget: prepared.toolTarget,\n            timestamp: Date.now(),\n        });\n    };\n\n    const emitToolCallResult = async (\n        prepared: PreparedToolCall,\n        outcome: ToolExecutionOutcome,\n    ) => {\n        await params.emit({\n            type: Events.TOOL_CALL_RESULT,\n            runId: params.runId,\n            agentName: params.agentName,\n            parentMessageId: params.parentMessageId,\n            toolCallId: prepared.toolCall.callId,\n            toolCallName: prepared.toolCall.name,\n            result: outcome.result,\n            isError: outcome.isError,\n            errorKind: outcome.errorKind,\n            toolTarget: prepared.toolTarget,\n            timestamp: Date.now(),\n        });\n    };\n\n    const resolveExecutableTool = (\n        toolCall: GenerativeModelToolCallRequest,\n    ): { tool: ExecutableToolDefinition; toolTarget: \"server\" | \"client\" } => {\n        const tool = params.tools.find((candidate) => getToolRunName(candidate) === toolCall.name);\n        if (!tool) {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                `Tool '${toolCall.name}' was requested by the model but is not available for this run.`,\n                {\n                    context: {\n                        runId: params.runId,\n                        agentName: params.agentName,\n                        toolName: toolCall.name,\n                    },\n                    trace: [{ at: \"core.run.executeToolCalls.missingTool\" }],\n                },\n            );\n        }\n\n        if (tool.kind === \"hosted\") {\n            throw BetterAgentError.fromCode(\n                \"NOT_IMPLEMENTED\",\n                `Hosted tool '${getToolRunName(tool) ?? toolCall.name}' reached the in-process tool executor, but hosted tools must be executed by the provider during model invocation.`,\n                {\n                    context: {\n                        runId: params.runId,\n                        agentName: params.agentName,\n                        toolName: getToolRunName(tool) ?? toolCall.name,\n                        toolTarget: tool.kind,\n                        provider: tool.provider,\n                        toolType: tool.type,\n                    },\n                    trace: [{ at: \"core.run.executeToolCalls.hostedToolInvariant\" }],\n                },\n            );\n        }\n\n        return {\n            tool,\n            toolTarget: tool.kind === \"client\" ? \"client\" : \"server\",\n        };\n    };\n\n    const resolveApprovalConfig = async <TInput>(args: {\n        approval?: ToolApprovalConfig<unknown, TInput>;\n        input: TInput;\n        toolCall: GenerativeModelToolCallRequest;\n        tool: ExecutableToolDefinition;\n        toolTarget: \"server\" | \"client\";\n    }): Promise<ResolvedApproval | undefined> => {\n        const approval = args.approval;\n        if (!approval) {\n            return undefined;\n        }\n\n        let resolved: ResolvedApproval = {\n            required: approval.required,\n            timeoutMs: approval.timeoutMs,\n            meta: approval.meta,\n        };\n\n        if (approval.resolve) {\n            const runtimeResolved = await approval.resolve({\n                context: params.context,\n                input: args.input,\n                runId: params.runId,\n                toolCallId: args.toolCall.callId,\n                toolName: args.tool.name,\n                toolTarget: args.toolTarget,\n            });\n\n            resolved = {\n                required: runtimeResolved.required ?? resolved.required,\n                timeoutMs: runtimeResolved.timeoutMs ?? resolved.timeoutMs,\n                meta: runtimeResolved.meta ?? resolved.meta,\n            };\n        }\n\n        return resolved;\n    };\n\n    const emitApprovalRequested = async (prepared: PreparedToolCall) => {\n        await params.emit({\n            type: Events.TOOL_APPROVAL_REQUIRED,\n            runId: params.runId,\n            agentName: params.agentName,\n            parentMessageId: params.parentMessageId,\n            toolCallId: prepared.toolCall.callId,\n            toolCallName: prepared.toolCall.name,\n            toolTarget: prepared.toolTarget,\n            toolInput: prepared.validatedInput,\n            state: \"requested\",\n            timestamp: Date.now(),\n            meta: prepared.resolvedApproval?.meta,\n        });\n\n        await params.emit({\n            type: Events.TOOL_APPROVAL_UPDATED,\n            runId: params.runId,\n            agentName: params.agentName,\n            parentMessageId: params.parentMessageId,\n            toolCallId: prepared.toolCall.callId,\n            toolCallName: prepared.toolCall.name,\n            toolTarget: prepared.toolTarget,\n            state: \"requested\",\n            toolInput: prepared.validatedInput,\n            timestamp: Date.now(),\n            meta: prepared.resolvedApproval?.meta,\n        });\n    };\n\n    const awaitApprovalIfNeeded = async (\n        prepared: PreparedToolCall,\n    ): Promise<{ approved: true } | { approved: false; note?: string }> => {\n        if (!prepared.resolvedApproval?.required) {\n            return { approved: true };\n        }\n\n        if (!params.pendingToolRuntime) {\n            throw BetterAgentError.fromCode(\n                \"NOT_IMPLEMENTED\",\n                `Tool '${prepared.tool.name}' requires approval, but no approval runtime is configured.`,\n                {\n                    context: {\n                        runId: params.runId,\n                        toolName: prepared.tool.name,\n                        toolCallId: prepared.toolCall.callId,\n                        toolTarget: prepared.toolTarget,\n                    },\n                    trace: [{ at: \"core.run.executeTools.awaitApprovalIfNeeded\" }],\n                },\n            );\n        }\n\n        try {\n            const decision = await params.pendingToolRuntime.awaitToolApproval({\n                runId: params.runId,\n                toolCallId: prepared.toolCall.callId,\n                toolName: prepared.tool.name,\n                timeoutMs:\n                    prepared.resolvedApproval.timeoutMs ?? params.advanced?.toolApprovalTimeoutMs,\n                signal: params.signal,\n            });\n\n            await params.emit({\n                type: Events.TOOL_APPROVAL_UPDATED,\n                runId: params.runId,\n                agentName: params.agentName,\n                parentMessageId: params.parentMessageId,\n                toolCallId: prepared.toolCall.callId,\n                toolCallName: prepared.toolCall.name,\n                toolTarget: prepared.toolTarget,\n                state: decision.decision,\n                toolInput: prepared.validatedInput,\n                timestamp: Date.now(),\n                meta: prepared.resolvedApproval.meta,\n                note: decision.note,\n                actorId: decision.actorId,\n            });\n\n            if (decision.decision === \"denied\") {\n                return decision.note !== undefined\n                    ? { approved: false, note: decision.note }\n                    : { approved: false };\n            }\n\n            return { approved: true };\n        } catch (error) {\n            if (error instanceof BetterAgentError && error.code === \"TIMEOUT\") {\n                await params.emit({\n                    type: Events.TOOL_APPROVAL_UPDATED,\n                    runId: params.runId,\n                    agentName: params.agentName,\n                    parentMessageId: params.parentMessageId,\n                    toolCallId: prepared.toolCall.callId,\n                    toolCallName: prepared.toolCall.name,\n                    toolTarget: prepared.toolTarget,\n                    state: \"expired\",\n                    toolInput: prepared.validatedInput,\n                    timestamp: Date.now(),\n                    meta: prepared.resolvedApproval.meta,\n                });\n            }\n\n            throw error;\n        }\n    };\n\n    for (const toolCall of params.toolCalls) {\n        throwIfAborted();\n\n        const { tool, toolTarget } = resolveExecutableTool(toolCall);\n        const resolvedToolErrorMode = tool.toolErrorMode ?? params.toolErrorMode ?? \"tool_error\";\n\n        const defaultToolErrorOutcome = (args: {\n            error: unknown;\n            errorKind: RecoverableToolErrorKind;\n            retryable?: boolean;\n        }): ToolExecutionOutcome => {\n            if (isAbortError(args.error)) {\n                throw args.error;\n            }\n\n            if (resolvedToolErrorMode === \"throw\") {\n                throw args.error;\n            }\n\n            return createToolErrorOutcomeFromError({\n                toolName: toolCall.name,\n                error: args.error,\n                errorKind: args.errorKind,\n                retryable: args.retryable,\n            });\n        };\n\n        const runToolHandler = async (input: unknown) => {\n            if (tool.kind === \"server\") {\n                return await tool.handler(input, {\n                    signal: params.signal,\n                    emit: params.emit,\n                });\n            }\n\n            if (!params.pendingToolRuntime) {\n                throw BetterAgentError.fromCode(\n                    \"NOT_IMPLEMENTED\",\n                    `Client tool '${tool.name}' requires a live runtime capable of accepting tool results.`,\n                    {\n                        context: {\n                            runId: params.runId,\n                            agentName: params.agentName,\n                            toolName: tool.name,\n                            toolCallId: toolCall.callId,\n                        },\n                        trace: [{ at: \"core.run.executeToolCalls.awaitClientToolResult\" }],\n                    },\n                );\n            }\n\n            return await params.pendingToolRuntime.awaitClientToolResult({\n                runId: params.runId,\n                toolCallId: toolCall.callId,\n                toolName: toolCall.name,\n                timeoutMs: params.advanced?.clientToolResultTimeoutMs,\n                signal: params.signal,\n            });\n        };\n\n        const resolveHookAction = async <T extends ToolErrorContext>(\n            context: T,\n        ): Promise<ToolErrorResultFor<T> | undefined> => {\n            const toolAction = await tool.onToolError?.(context);\n            if (toolAction !== undefined) {\n                if (toolAction.action !== \"skip\") {\n                    return toolAction;\n                }\n            } else {\n                return undefined;\n            }\n\n            const agentAction = await params.onToolError?.(context);\n            if (agentAction !== undefined && agentAction.action !== \"skip\") {\n                return agentAction;\n            }\n\n            return undefined;\n        };\n\n        const resolveToolError = async (args: {\n            error: unknown;\n            errorKind: RecoverableToolErrorKind;\n            input?: unknown;\n            recoveryDepth: number;\n        }): Promise<ToolExecutionOutcome> => {\n            if (isAbortError(args.error)) {\n                throw args.error;\n            }\n\n            if (args.recoveryDepth >= MAX_TOOL_ERROR_REPAIR_DEPTH) {\n                return defaultToolErrorOutcome({\n                    error: args.error,\n                    errorKind: args.errorKind,\n                });\n            }\n\n            const context =\n                args.errorKind === \"parse\"\n                    ? ({\n                          toolName: toolCall.name,\n                          toolCallId: toolCall.callId,\n                          error: args.error,\n                          rawArguments: toolCall.arguments,\n                          errorKind: \"parse\",\n                      } satisfies ParseToolError)\n                    : args.errorKind === \"validation\"\n                      ? ({\n                            toolName: toolCall.name,\n                            toolCallId: toolCall.callId,\n                            error: args.error,\n                            rawArguments: toolCall.arguments,\n                            input: args.input,\n                            errorKind: \"validation\",\n                        } satisfies ValidationToolError)\n                      : ({\n                            toolName: toolCall.name,\n                            toolCallId: toolCall.callId,\n                            error: args.error,\n                            rawArguments: toolCall.arguments,\n                            input: args.input,\n                            errorKind: \"execution\",\n                        } satisfies ExecutionToolError);\n\n            const action = await resolveHookAction(context);\n            if (action === undefined) {\n                return defaultToolErrorOutcome({\n                    error: args.error,\n                    errorKind: args.errorKind,\n                });\n            }\n\n            switch (action.action) {\n                case \"send_to_model\":\n                    return createToolErrorOutcomeFromError({\n                        toolName: toolCall.name,\n                        error: args.error,\n                        errorKind: args.errorKind,\n                        message:\n                            action.message ?? extractToolErrorMessage(args.error, args.errorKind),\n                        retryable: action.retryable,\n                    });\n\n                case \"throw\":\n                    throw args.error;\n\n                case \"skip\":\n                    return defaultToolErrorOutcome({\n                        error: args.error,\n                        errorKind: args.errorKind,\n                    });\n\n                case \"repair\":\n                    return await validateAndExecuteInput(action.input, args.recoveryDepth + 1);\n\n                case \"retry\": {\n                    if (args.errorKind !== \"execution\" || args.input === undefined) {\n                        logger.warn(\n                            `[better-agent] Ignoring invalid onToolError action '${action.action}' for tool '${toolCall.name}' (${args.errorKind} error).`,\n                        );\n                        return createToolErrorOutcomeFromError({\n                            toolName: toolCall.name,\n                            error: args.error,\n                            errorKind: args.errorKind,\n                        });\n                    }\n\n                    const attempts = Math.max(\n                        1,\n                        Math.min(action.maxAttempts ?? 1, MAX_TOOL_ERROR_RETRY_ATTEMPTS),\n                    );\n\n                    let lastError = args.error;\n                    for (let attempt = 0; attempt < attempts; attempt += 1) {\n                        throwIfAborted();\n                        try {\n                            return { result: await runToolHandler(args.input) };\n                        } catch (retryError) {\n                            if (isAbortError(retryError)) {\n                                throw retryError;\n                            }\n\n                            lastError = retryError;\n                            if (attempt < attempts - 1) {\n                                await waitForRetryBackoff((attempt + 1) * 500);\n                            }\n                        }\n                    }\n\n                    return await resolveToolError({\n                        error: lastError,\n                        errorKind: \"execution\",\n                        input: args.input,\n                        recoveryDepth: args.recoveryDepth + 1,\n                    });\n                }\n\n                case \"result\":\n                    if (args.errorKind !== \"execution\") {\n                        logger.warn(\n                            `[better-agent] Ignoring invalid onToolError action '${action.action}' for tool '${toolCall.name}' (${args.errorKind} error).`,\n                        );\n                        return createToolErrorOutcomeFromError({\n                            toolName: toolCall.name,\n                            error: args.error,\n                            errorKind: args.errorKind,\n                        });\n                    }\n\n                    return { result: action.value };\n\n                default:\n                    return defaultToolErrorOutcome({\n                        error: args.error,\n                        errorKind: args.errorKind,\n                    });\n            }\n        };\n\n        const executeApprovedInput = async (\n            prepared: PreparedToolCall,\n            input: unknown,\n            recoveryDepth: number,\n        ): Promise<ToolExecutionOutcome> => {\n            const approval = await awaitApprovalIfNeeded(prepared);\n            if (!approval.approved) {\n                const denialReason = approval.note ? ` Reason: ${approval.note}` : \"\";\n                return {\n                    result: `Tool '${toolCall.name}' was denied by the operator.${denialReason}`,\n                };\n            }\n\n            try {\n                return { result: await runToolHandler(input) };\n            } catch (error) {\n                if (isAbortError(error)) {\n                    throw error;\n                }\n\n                return await resolveToolError({\n                    error,\n                    errorKind: \"execution\",\n                    input,\n                    recoveryDepth,\n                });\n            }\n        };\n\n        const validateAndExecuteInput = async (\n            input: unknown,\n            recoveryDepth: number,\n        ): Promise<ToolExecutionOutcome> => {\n            const validatedInput = await validateInput(tool.schema, input);\n            if (validatedInput.isErr()) {\n                return await resolveToolError({\n                    error: validatedInput.error.at({\n                        at: \"core.run.executeToolCalls.validateToolInput\",\n                    }),\n                    errorKind: \"validation\",\n                    input,\n                    recoveryDepth,\n                });\n            }\n\n            const prepared: PreparedToolCall = {\n                toolCall,\n                tool,\n                toolTarget,\n                args: input,\n                validatedInput: validatedInput.value,\n                resolvedApproval: await resolveApprovalConfig({\n                    approval: tool.approval,\n                    input: validatedInput.value,\n                    toolCall,\n                    tool,\n                    toolTarget,\n                }),\n                skip: false,\n                shouldEmitToolCallEnd: false,\n            };\n\n            return await executeApprovedInput(prepared, validatedInput.value, recoveryDepth);\n        };\n\n        const prepareToolCall = async (): Promise<PreparedToolCall> => {\n            const parsed = safeJsonParse(toolCall.arguments);\n            if (parsed.isErr()) {\n                return {\n                    toolCall,\n                    tool,\n                    toolTarget,\n                    skip: false,\n                    shouldEmitToolCallEnd: false,\n                    parseError: BetterAgentError.wrap({\n                        err: parsed.error,\n                        message: `Failed to parse arguments for tool '${toolCall.name}'`,\n                        opts: {\n                            code: \"VALIDATION_FAILED\",\n                            context: {\n                                toolName: toolCall.name,\n                                toolCallId: toolCall.callId,\n                            },\n                            trace: [{ at: \"core.run.executeToolCalls.parseToolArguments\" }],\n                        },\n                    }),\n                };\n            }\n\n            const beforeHook =\n                params.pluginRuntime?.hasToolHooks === true\n                    ? await params.pluginRuntime.applyBeforeToolCall({\n                          runId: params.runId,\n                          agentName: params.agentName,\n                          toolName: toolCall.name,\n                          toolCallId: toolCall.callId,\n                          args: parsed.value,\n                          conversationId: params.conversationId,\n                      })\n                    : { args: parsed.value };\n\n            if (beforeHook?.decision?.skip === true) {\n                return {\n                    toolCall,\n                    tool,\n                    toolTarget,\n                    args: beforeHook.args,\n                    skip: true,\n                    skipResult: beforeHook.decision.result,\n                    shouldEmitToolCallEnd: true,\n                };\n            }\n\n            const validatedInput = await validateInput(tool.schema, beforeHook.args);\n            if (validatedInput.isErr()) {\n                return {\n                    toolCall,\n                    tool,\n                    toolTarget,\n                    args: beforeHook.args,\n                    skip: false,\n                    shouldEmitToolCallEnd: false,\n                    validationError: validatedInput.error.at({\n                        at: \"core.run.executeToolCalls.validateToolInput\",\n                    }),\n                };\n            }\n\n            const prepared: PreparedToolCall = {\n                toolCall,\n                tool,\n                toolTarget,\n                args: beforeHook.args,\n                validatedInput: validatedInput.value,\n                resolvedApproval: await resolveApprovalConfig({\n                    approval: tool.approval,\n                    input: validatedInput.value,\n                    toolCall,\n                    tool,\n                    toolTarget,\n                }),\n                skip: false,\n                shouldEmitToolCallEnd: true,\n            };\n\n            if (prepared.resolvedApproval?.required) {\n                await emitApprovalRequested(prepared);\n            }\n\n            return prepared;\n        };\n\n        const executePreparedTool = async (\n            prepared: PreparedToolCall,\n        ): Promise<ToolExecutionOutcome> => {\n            if (prepared.parseError) {\n                return await resolveToolError({\n                    error: prepared.parseError,\n                    errorKind: \"parse\",\n                    recoveryDepth: 0,\n                });\n            }\n\n            if (prepared.skip) {\n                return { result: prepared.skipResult };\n            }\n\n            if (prepared.validationError) {\n                return await resolveToolError({\n                    error: prepared.validationError,\n                    errorKind: \"validation\",\n                    input: prepared.args,\n                    recoveryDepth: 0,\n                });\n            }\n\n            return await executeApprovedInput(prepared, prepared.validatedInput, 0);\n        };\n\n        const applyAfterToolCall = async (\n            prepared: PreparedToolCall,\n            outcome: ToolExecutionOutcome,\n        ): Promise<ToolExecutionOutcome> => {\n            if (params.pluginRuntime?.hasToolHooks !== true) {\n                return outcome;\n            }\n\n            const afterHook = await params.pluginRuntime.applyAfterToolCall({\n                runId: params.runId,\n                agentName: params.agentName,\n                toolName: toolCall.name,\n                toolCallId: toolCall.callId,\n                args: prepared.args,\n                result: outcome.result,\n                conversationId: params.conversationId,\n                error:\n                    outcome.isError === true &&\n                    typeof outcome.result === \"object\" &&\n                    outcome.result !== null &&\n                    \"message\" in outcome.result &&\n                    typeof outcome.result.message === \"string\"\n                        ? outcome.result.message\n                        : undefined,\n            });\n\n            return {\n                ...outcome,\n                result: afterHook.result,\n            };\n        };\n\n        await emitToolCallStart({ toolCall, toolTarget });\n        await emitToolCallArgs({ toolCall, toolTarget });\n\n        const prepared = await prepareToolCall();\n        if (prepared.shouldEmitToolCallEnd) {\n            await emitToolCallEnd(prepared);\n        }\n\n        const outcome = await executePreparedTool(prepared);\n        const finalOutcome = await applyAfterToolCall(prepared, outcome);\n\n        await emitToolCallResult(prepared, finalOutcome);\n\n        results.push({\n            type: \"tool-call\",\n            callId: toolCall.callId,\n            name: toolCall.name,\n            arguments: toolCall.arguments,\n            result: finalOutcome.result,\n            isError: finalOutcome.isError,\n        });\n    }\n\n    return { results };\n};\n"],"mappings":"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"}

package/dist/run/execution.mjs

@@ -0,0 +1,93 @@
+import { finalizeRunResult, prepareConversationReplayInput, toStructuredOutputRequest, validateRunInputCapabilities, validateRunModalities } from "./helpers.mjs";
+import { runAgentLoop } from "./agent-loop.mjs";
+import { createRunModelCallStrategy, createStreamModelCallStrategy } from "./model-strategy.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { isPlainRecord } from "@better-agent/shared/utils";
+
+//#region src/run/execution.ts
+/** Executes a run. */
+async function executeRun(params) {
+	const { agent: currentAgent, options } = params;
+	const modelCaps = currentAgent.model.caps;
+	const items = options.initialItems;
+	validateRunInputCapabilities({
+		agent: currentAgent,
+		input: options.conversationId !== void 0 && options.conversationReplayActive ? await prepareConversationReplayInput({
+			items,
+			caps: modelCaps,
+			agentName: currentAgent.name,
+			conversationId: options.conversationId,
+			conversationReplay: options.conversationReplay
+		}) : options.input,
+		traceAt: `core.run.executeRun.validateInputCapabilities.${options.mode}`
+	});
+	const effectiveModalities = options.modalities ?? currentAgent.defaultModalities;
+	const outputSchema = options.output ?? currentAgent.outputSchema;
+	validateRunModalities({
+		agent: currentAgent,
+		modalities: effectiveModalities,
+		output: outputSchema,
+		traceAt: `core.run.executeRun.validateModalities.${options.mode}`
+	});
+	const structuredOutput = toStructuredOutputRequest(currentAgent, outputSchema);
+	const modelOptions = (() => {
+		const { input: _input, context: _context, output: _output, modelOptions: nestedModelOptions, conversationId: _conversationId, conversationReplay: _conversationReplay, signal: _signal, onEvent: _onEvent, maxSteps: _maxSteps, persistence: _persistence } = options;
+		const merged = {};
+		const mergeInto = (target, source) => {
+			for (const [key, value] of Object.entries(source)) {
+				const existing = target[key];
+				if (isPlainRecord(existing) && isPlainRecord(value)) target[key] = mergeInto({ ...existing }, value);
+				else target[key] = value;
+			}
+			return target;
+		};
+		if (currentAgent.defaultModelOptions) mergeInto(merged, currentAgent.defaultModelOptions);
+		if (isPlainRecord(nestedModelOptions)) mergeInto(merged, nestedModelOptions);
+		return merged;
+	})();
+	const advanced = options.advanced !== void 0 || currentAgent.advanced !== void 0 || options.advancedDefaults !== void 0 ? {
+		...options.advancedDefaults ?? {},
+		...currentAgent.advanced ?? {},
+		...options.advanced ?? {}
+	} : void 0;
+	const baseOptions = {
+		agent: currentAgent,
+		items,
+		replayStartIndex: options.replayStartIndex ?? 0,
+		conversationReplayActive: options.conversationReplayActive,
+		conversationReplay: options.conversationReplay,
+		modelOptions: Object.keys(modelOptions).length > 0 ? modelOptions : void 0,
+		modalities: effectiveModalities,
+		runId: options.runId,
+		signal: options.signal,
+		emit: options.emit,
+		generateMessageId: options.generateMessageId,
+		conversationId: options.conversationId,
+		context: options.context,
+		structuredOutput,
+		maxSteps: options.maxSteps ?? currentAgent.maxSteps,
+		advanced,
+		pendingToolRuntime: options.pendingToolRuntime,
+		pluginRuntime: options.pluginRuntime
+	};
+	if (baseOptions.maxSteps !== void 0 && baseOptions.maxSteps <= 0) throw BetterAgentError.fromCode("VALIDATION_FAILED", `maxSteps must be a positive integer or undefined, got ${baseOptions.maxSteps}.`, {
+		context: { maxSteps: baseOptions.maxSteps },
+		trace: [{ at: "core.run.executeRun.validateMaxSteps" }]
+	});
+	if (advanced?.clientToolResultTimeoutMs !== void 0 && (!Number.isFinite(advanced.clientToolResultTimeoutMs) || advanced.clientToolResultTimeoutMs <= 0)) throw BetterAgentError.fromCode("VALIDATION_FAILED", "clientToolResultTimeoutMs must be a positive number.", {
+		context: { clientToolResultTimeoutMs: advanced.clientToolResultTimeoutMs },
+		trace: [{ at: "core.run.executeRun.validateAdvanced.clientToolResultTimeoutMs" }]
+	});
+	if (advanced?.toolApprovalTimeoutMs !== void 0 && (!Number.isFinite(advanced.toolApprovalTimeoutMs) || advanced.toolApprovalTimeoutMs <= 0)) throw BetterAgentError.fromCode("VALIDATION_FAILED", "toolApprovalTimeoutMs must be a positive number.", {
+		context: { toolApprovalTimeoutMs: advanced.toolApprovalTimeoutMs },
+		trace: [{ at: "core.run.executeRun.validateAdvanced.toolApprovalTimeoutMs" }]
+	});
+	return await finalizeRunResult(options.mode === "stream" ? await runAgentLoop(baseOptions, createStreamModelCallStrategy()) : await runAgentLoop(baseOptions, createRunModelCallStrategy()), outputSchema, {
+		outputErrorMode: currentAgent.outputErrorMode,
+		onOutputError: currentAgent.onOutputError
+	});
+}
+
+//#endregion
+export { executeRun };
+//# sourceMappingURL=execution.mjs.map

package/dist/run/execution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.mjs","names":[],"sources":["../../src/run/execution.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { isPlainRecord } from \"@better-agent/shared/utils\";\nimport type { Event } from \"../events\";\nimport type { PluginRuntime } from \"../plugins\";\nimport type {\n    Capabilities,\n    ConversationItem,\n    ModalitiesParam,\n    OutputSchemaDefinition,\n} from \"../providers\";\nimport { runAgentLoop } from \"./agent-loop\";\nimport {\n    finalizeRunResult,\n    prepareConversationReplayInput,\n    toStructuredOutputRequest,\n    validateRunInputCapabilities,\n    validateRunModalities,\n} from \"./helpers\";\nimport { createRunModelCallStrategy, createStreamModelCallStrategy } from \"./model-strategy\";\nimport type { PendingToolRuntime } from \"./pending-tools\";\nimport type { ContextBoundAgent, RunAdvancedOptions, RunOptions, RunResult } from \"./types\";\n\n/** Internal run options. */\nexport interface InternalRunOptions<TContext = unknown>\n    extends RunOptions<\n        TContext,\n        OutputSchemaDefinition | undefined,\n        Capabilities,\n        Record<string, unknown>,\n        ModalitiesParam<Capabilities> | undefined\n    > {\n    runId: string;\n    signal: AbortSignal;\n    emit: (event: Event) => Promise<void>;\n    generateMessageId: () => string;\n    mode: \"run\" | \"stream\";\n    pendingToolRuntime: PendingToolRuntime;\n    advancedDefaults?: RunAdvancedOptions;\n    initialItems: ConversationItem[];\n    replayStartIndex?: number;\n    conversationReplayActive?: boolean;\n    pluginRuntime?: PluginRuntime | null;\n}\n\n/** Executes a run. */\nexport async function executeRun<TContext>(params: {\n    agent: ContextBoundAgent<TContext>;\n    options: InternalRunOptions<TContext>;\n}): Promise<RunResult & { items: ConversationItem[] }> {\n    const { agent: currentAgent, options } = params;\n\n    const modelCaps = currentAgent.model.caps;\n    const items = options.initialItems;\n\n    const projectedInput =\n        options.conversationId !== undefined && options.conversationReplayActive\n            ? await prepareConversationReplayInput({\n                  items,\n                  caps: modelCaps,\n                  agentName: currentAgent.name,\n                  conversationId: options.conversationId,\n                  conversationReplay: options.conversationReplay,\n              })\n            : options.input;\n    validateRunInputCapabilities({\n        agent: currentAgent,\n        input: projectedInput,\n        traceAt: `core.run.executeRun.validateInputCapabilities.${options.mode}`,\n    });\n    const effectiveModalities = options.modalities ?? currentAgent.defaultModalities;\n    const outputSchema = options.output ?? currentAgent.outputSchema;\n    validateRunModalities({\n        agent: currentAgent,\n        modalities: effectiveModalities,\n        output: outputSchema,\n        traceAt: `core.run.executeRun.validateModalities.${options.mode}`,\n    });\n    const structuredOutput = toStructuredOutputRequest(currentAgent, outputSchema);\n\n    // Merge agent and run model options.\n    const modelOptions = (() => {\n        const {\n            input: _input,\n            context: _context,\n            output: _output,\n            modelOptions: nestedModelOptions,\n            conversationId: _conversationId,\n            conversationReplay: _conversationReplay,\n            signal: _signal,\n            onEvent: _onEvent,\n            maxSteps: _maxSteps,\n            persistence: _persistence,\n        } = options;\n\n        const merged = {};\n        const mergeInto = (target: Record<string, unknown>, source: Record<string, unknown>) => {\n            for (const [key, value] of Object.entries(source)) {\n                const existing = target[key];\n                if (isPlainRecord(existing) && isPlainRecord(value)) {\n                    target[key] = mergeInto({ ...existing }, value);\n                } else {\n                    target[key] = value;\n                }\n            }\n\n            return target;\n        };\n\n        if (currentAgent.defaultModelOptions) {\n            mergeInto(merged, currentAgent.defaultModelOptions);\n        }\n        if (isPlainRecord(nestedModelOptions)) {\n            mergeInto(merged, nestedModelOptions);\n        }\n\n        return merged;\n    })();\n\n    const advanced: RunAdvancedOptions | undefined =\n        options.advanced !== undefined ||\n        currentAgent.advanced !== undefined ||\n        options.advancedDefaults !== undefined\n            ? {\n                  ...(options.advancedDefaults ?? {}),\n                  ...(currentAgent.advanced ?? {}),\n                  ...(options.advanced ?? {}),\n              }\n            : undefined;\n\n    const baseOptions = {\n        agent: currentAgent,\n        items,\n        replayStartIndex: options.replayStartIndex ?? 0,\n        conversationReplayActive: options.conversationReplayActive,\n        conversationReplay: options.conversationReplay,\n        modelOptions: Object.keys(modelOptions).length > 0 ? modelOptions : undefined,\n        modalities: effectiveModalities,\n        runId: options.runId,\n        signal: options.signal,\n        emit: options.emit,\n        generateMessageId: options.generateMessageId,\n        conversationId: options.conversationId,\n        context: options.context,\n        structuredOutput,\n        maxSteps: options.maxSteps ?? currentAgent.maxSteps,\n        advanced,\n        pendingToolRuntime: options.pendingToolRuntime,\n        pluginRuntime: options.pluginRuntime,\n    };\n\n    // Validate merged overrides.\n    if (baseOptions.maxSteps !== undefined && baseOptions.maxSteps <= 0) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            `maxSteps must be a positive integer or undefined, got ${baseOptions.maxSteps}.`,\n            {\n                context: { maxSteps: baseOptions.maxSteps },\n                trace: [{ at: \"core.run.executeRun.validateMaxSteps\" }],\n            },\n        );\n    }\n\n    if (\n        advanced?.clientToolResultTimeoutMs !== undefined &&\n        (!Number.isFinite(advanced.clientToolResultTimeoutMs) ||\n            advanced.clientToolResultTimeoutMs <= 0)\n    ) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            \"clientToolResultTimeoutMs must be a positive number.\",\n            {\n                context: { clientToolResultTimeoutMs: advanced.clientToolResultTimeoutMs },\n                trace: [{ at: \"core.run.executeRun.validateAdvanced.clientToolResultTimeoutMs\" }],\n            },\n        );\n    }\n    if (\n        advanced?.toolApprovalTimeoutMs !== undefined &&\n        (!Number.isFinite(advanced.toolApprovalTimeoutMs) || advanced.toolApprovalTimeoutMs <= 0)\n    ) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            \"toolApprovalTimeoutMs must be a positive number.\",\n            {\n                context: { toolApprovalTimeoutMs: advanced.toolApprovalTimeoutMs },\n                trace: [{ at: \"core.run.executeRun.validateAdvanced.toolApprovalTimeoutMs\" }],\n            },\n        );\n    }\n\n    const loopResult =\n        options.mode === \"stream\"\n            ? await runAgentLoop(baseOptions, createStreamModelCallStrategy<TContext>())\n            : await runAgentLoop(baseOptions, createRunModelCallStrategy<TContext>());\n\n    return await finalizeRunResult(loopResult, outputSchema, {\n        outputErrorMode: currentAgent.outputErrorMode,\n        onOutputError: currentAgent.onOutputError,\n    });\n}\n"],"mappings":"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"}