@better-agent/core 0.1.0-beta.1

package/dist/run/runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.mjs","names":[],"sources":["../../src/run/runtime.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { logger } from \"@better-agent/shared/logger\";\nimport type { AnyAgentDefinition } from \"../agent\";\nimport { type Event, Events } from \"../events\";\nimport type { ConversationRuntimeStateStore, ConversationStore, StreamStore } from \"../persistence\";\nimport type { PluginRuntime } from \"../plugins\";\nimport type { ConversationItem, OutputSchemaDefinition } from \"../providers\";\nimport { type AsyncEventQueue, createAsyncEventQueue } from \"./event-queue\";\nimport { executeRun } from \"./execution\";\nimport {\n    createStreamPersistenceEmitter,\n    generateId,\n    loadConversationMessages,\n    saveConversationMessages,\n    toEventEmitter,\n    validateAgentContext,\n    validateStoredConversationItems,\n} from \"./helpers\";\nimport { createPendingToolRuntime } from \"./pending-tools\";\nimport { createAgentRegistry, resolveAgentFromRegistry } from \"./registry\";\nimport type {\n    BetterAgentRuntime,\n    ContextBoundAgent,\n    ResumeConversationOptions,\n    RunAdvancedOptions,\n    RunOptions,\n    RunResult,\n    StreamResult,\n    SubmitToolApprovalParams,\n    SubmitToolResultParams,\n} from \"./types\";\n\n/** Creates a runtime for registered agents. */\nexport function createRuntime<const TAgents extends readonly AnyAgentDefinition[]>(options: {\n    agents: TAgents;\n    pluginRuntime?: PluginRuntime | null;\n    stream?: StreamStore;\n    conversations?: ConversationStore;\n    runtimeState?: ConversationRuntimeStateStore;\n    streamLifecycle?: \"request_bound\" | \"detached\";\n    advanced?: RunAdvancedOptions;\n}): BetterAgentRuntime<TAgents> {\n    const agents = createAgentRegistry(options.agents);\n    const pluginRuntime = options.pluginRuntime ?? null;\n    const pendingToolRuntime = createPendingToolRuntime();\n    const streamLifecycle = options.streamLifecycle ?? \"request_bound\";\n    const activeRuns = new Map<string, AbortController>();\n\n    const resolveConversationReplay = (\n        agent: AnyAgentDefinition,\n        runReplay: RunOptions<unknown>[\"conversationReplay\"],\n    ): RunOptions<unknown>[\"conversationReplay\"] => {\n        const agentReplay = agent.conversationReplay;\n        if (!agentReplay && !runReplay) {\n            return undefined;\n        }\n\n        const merged = {\n            ...(agentReplay ?? {}),\n            ...(runReplay ?? {}),\n        };\n\n        if (\n            runReplay &&\n            Object.prototype.hasOwnProperty.call(runReplay, \"prepareInput\") &&\n            runReplay.prepareInput === null\n        ) {\n            merged.prepareInput = undefined;\n        }\n\n        return merged;\n    };\n\n    const warnIgnoredConversationReplay = (params: {\n        agent: AnyAgentDefinition;\n        conversationReplay: RunOptions<unknown>[\"conversationReplay\"];\n    }) => {\n        if (!params.conversationReplay) {\n            return;\n        }\n\n        const replayMode =\n            params.agent.model.caps.replayMode ??\n            (params.agent.model.caps.inputShape === \"prompt\"\n                ? \"single_turn_persistent\"\n                : \"multi_turn\");\n\n        if (replayMode === \"multi_turn\") {\n            return;\n        }\n\n        logger.warn(\n            `conversationReplay was provided for agent '${params.agent.name}', but model replayMode is '${replayMode}', so stored history replay customization was skipped.`,\n        );\n    };\n\n    const buildPersistence = <TContext>(\n        persistence?: RunOptions<TContext>[\"persistence\"],\n        defaults?: {\n            stream?: StreamStore;\n            conversations?: ConversationStore;\n            runtimeState?: ConversationRuntimeStateStore;\n        },\n    ) => {\n        const resolved = {\n            stream: persistence?.stream ?? defaults?.stream,\n            conversations: persistence?.conversations ?? defaults?.conversations,\n            runtimeState: persistence?.runtimeState ?? defaults?.runtimeState,\n        };\n\n        return resolved.stream || resolved.conversations || resolved.runtimeState\n            ? resolved\n            : undefined;\n    };\n\n    const createPluginEventContext = (params: {\n        runId: string;\n        agentName: string;\n        conversationId?: string;\n        abortController: AbortController;\n    }) => ({\n        runId: params.runId,\n        agentName: params.agentName,\n        conversationId: params.conversationId,\n        control: {\n            abortRun: async () => {\n                params.abortController.abort();\n            },\n        },\n    });\n\n    const createLiveEmitter = (params: {\n        runId: string;\n        agentName: string;\n        conversationId?: string;\n        abortController: AbortController;\n        persistenceEmit?: (event: Event) => Promise<void>;\n        queuePush?: (event: Event) => Promise<void>;\n        onEvent?: RunOptions<unknown>[\"onEvent\"];\n    }) => {\n        const userEmit = toEventEmitter(params.onEvent);\n\n        return async (event: Event) => {\n            const pluginEventContext = createPluginEventContext({\n                runId: params.runId,\n                agentName: params.agentName,\n                abortController: params.abortController,\n                conversationId: params.conversationId,\n            });\n\n            const transformed =\n                pluginRuntime?.hasEventMiddleware === true\n                    ? await pluginRuntime.dispatchEvent(event, pluginEventContext)\n                    : event;\n\n            if (!transformed) {\n                return;\n            }\n\n            if (params.persistenceEmit) {\n                await params.persistenceEmit(transformed);\n            }\n\n            if (pluginRuntime?.hasOnEvent) {\n                await pluginRuntime.dispatchOnEvent(transformed, pluginEventContext);\n            }\n\n            if (params.queuePush) {\n                await params.queuePush(transformed);\n            }\n\n            await userEmit(transformed);\n        };\n    };\n\n    const wrapRuntimeError = (params: {\n        error: unknown;\n        message: string;\n        traceAt: string;\n        isAbort?: boolean;\n    }) =>\n        BetterAgentError.wrap({\n            err: params.error,\n            message: params.message,\n            opts: {\n                code: params.isAbort\n                    ? \"ABORTED\"\n                    : params.error instanceof BetterAgentError\n                      ? params.error.code\n                      : \"INTERNAL\",\n                trace: [{ at: params.traceAt }],\n            },\n        });\n\n    const emitSafely = async (emit: (event: Event) => Promise<void>, event: Event) => {\n        try {\n            await emit(event);\n        } catch (error) {\n            logger.error(\"Failed to emit runtime event.\", error);\n        }\n    };\n\n    const closeStreamSafely = async (streamStore: StreamStore | undefined, runId: string) => {\n        if (!streamStore) {\n            return;\n        }\n\n        try {\n            await streamStore.close(runId);\n        } catch (error) {\n            logger.error(`Failed to close stream '${runId}'.`, error);\n        }\n    };\n\n    const createRuntimeExecutionContext = (params: {\n        resolvedAgent: AnyAgentDefinition;\n        conversationId?: string;\n        onEvent?: RunOptions<unknown>[\"onEvent\"];\n        externalSignal?: AbortSignal;\n        streamStore?: StreamStore;\n        queue?: AsyncEventQueue<Event>;\n        queueSignal?: AbortSignal;\n        detachFromExternalAbort?: boolean;\n    }) => {\n        const runId = generateId(\"run\");\n        const abortController = new AbortController();\n        activeRuns.set(runId, abortController);\n        const signalController = new AbortController();\n        const abortFromSignal = (signal: AbortSignal) => {\n            if (!signalController.signal.aborted) {\n                signalController.abort(signal.reason);\n            }\n        };\n        const onInternalAbort = () => abortFromSignal(abortController.signal);\n        const onExternalAbort = () => {\n            if (params.externalSignal) {\n                abortFromSignal(params.externalSignal);\n            }\n        };\n        const signal = signalController.signal;\n        const persistenceEmit = params.streamStore\n            ? createStreamPersistenceEmitter({\n                  stream: params.streamStore,\n                  streamId: runId,\n              })\n            : undefined;\n        const emit = createLiveEmitter({\n            runId,\n            agentName: params.resolvedAgent.name,\n            abortController,\n            conversationId: params.conversationId,\n            persistenceEmit,\n            queuePush: params.queue\n                ? async (event) => {\n                      if (!params.queueSignal?.aborted) {\n                          params.queue?.push(event);\n                      }\n                  }\n                : undefined,\n            onEvent: params.onEvent,\n        });\n\n        abortController.signal.addEventListener(\"abort\", onInternalAbort, { once: true });\n        if (params.externalSignal && !params.detachFromExternalAbort) {\n            if (params.externalSignal.aborted) {\n                abortFromSignal(params.externalSignal);\n            } else {\n                params.externalSignal.addEventListener(\"abort\", onExternalAbort, { once: true });\n            }\n        }\n\n        if (params.queue && params.queueSignal) {\n            const closeQueueOnAbort = () => params.queue?.close();\n            if (params.queueSignal.aborted) {\n                closeQueueOnAbort();\n            } else {\n                params.queueSignal.addEventListener(\"abort\", closeQueueOnAbort, { once: true });\n            }\n        }\n\n        return {\n            runId,\n            signal,\n            emit,\n            cleanupSignal() {\n                abortController.signal.removeEventListener(\"abort\", onInternalAbort);\n                params.externalSignal?.removeEventListener(\"abort\", onExternalAbort);\n            },\n        };\n    };\n\n    const completeRunSuccess = async <TResult>(params: {\n        runId: string;\n        resolvedAgent: AnyAgentDefinition;\n        conversationId?: string;\n        emit: (event: Event) => Promise<void>;\n        result: RunResult & { items: ConversationItem[] };\n        saveConversationParams?: Omit<Parameters<typeof saveConversationMessages>[0], \"result\">;\n        streamStore?: StreamStore;\n        runtimeState?: ConversationRuntimeStateStore;\n        queue?: AsyncEventQueue<Event>;\n        success: (result: RunResult) => TResult;\n    }) => {\n        const itemsToSave =\n            pluginRuntime?.hasOnBeforeSave === true\n                ? await pluginRuntime.applyBeforeSave({\n                      runId: params.runId,\n                      agentName: params.resolvedAgent.name,\n                      items: params.result.items,\n                      conversationId: params.conversationId,\n                  })\n                : params.result.items;\n\n        if (params.saveConversationParams) {\n            await saveConversationMessages({\n                ...params.saveConversationParams,\n                result: { ...params.result, items: itemsToSave },\n            });\n        }\n\n        const publicResult = {\n            response: params.result.response,\n            structured: params.result.structured,\n        };\n        await params.emit({\n            type: Events.RUN_FINISHED,\n            runId: params.runId,\n            agentName: params.resolvedAgent.name,\n            result: publicResult,\n            timestamp: Date.now(),\n            conversationId: params.conversationId,\n        });\n\n        activeRuns.delete(params.runId);\n        if (params.runtimeState && params.conversationId !== undefined) {\n            await params.runtimeState.clear({\n                conversationId: params.conversationId,\n                agentName: params.resolvedAgent.name,\n            });\n        }\n        await closeStreamSafely(params.streamStore, params.runId);\n        params.queue?.close();\n        pendingToolRuntime.clearRun(params.runId, \"Run finished\");\n        return params.success(publicResult);\n    };\n\n    const handleRunFailure = async (params: {\n        error: unknown;\n        signal: AbortSignal;\n        traceAt: string;\n        emit: (event: Event) => Promise<void>;\n        runId: string;\n        resolvedAgent: AnyAgentDefinition;\n        conversationId?: string;\n        streamStore?: StreamStore;\n        runtimeState?: ConversationRuntimeStateStore;\n        queue?: AsyncEventQueue<Event>;\n    }): Promise<never> => {\n        const isAbort =\n            params.signal.aborted ||\n            (params.error instanceof BetterAgentError && params.error.code === \"ABORTED\");\n\n        const wrapped = wrapRuntimeError({\n            error: params.error,\n            message: \"Run failed\",\n            traceAt: params.traceAt,\n            isAbort,\n        });\n\n        if (isAbort) {\n            await emitSafely(params.emit, {\n                type: Events.RUN_ABORTED,\n                runId: params.runId,\n                agentName: params.resolvedAgent.name,\n                timestamp: Date.now(),\n                conversationId: params.conversationId,\n            });\n        } else {\n            await emitSafely(params.emit, {\n                type: Events.RUN_ERROR,\n                runId: params.runId,\n                agentName: params.resolvedAgent.name,\n                error: wrapped,\n                timestamp: Date.now(),\n                conversationId: params.conversationId,\n            });\n        }\n\n        activeRuns.delete(params.runId);\n        if (params.runtimeState && params.conversationId !== undefined) {\n            await params.runtimeState.clear({\n                conversationId: params.conversationId,\n                agentName: params.resolvedAgent.name,\n            });\n        }\n        await closeStreamSafely(params.streamStore, params.runId);\n        params.queue?.fail(wrapped);\n        pendingToolRuntime.clearRun(params.runId, wrapped.message);\n        throw wrapped;\n    };\n\n    return {\n        streamLifecycle,\n        run: (async <TContext, TOutput extends OutputSchemaDefinition | undefined = undefined>(\n            agent: TAgents[number][\"name\"],\n            runOptions: RunOptions<TContext, TOutput>,\n        ): Promise<RunResult> => {\n            const resolvedAgent = resolveAgentFromRegistry(\n                agents,\n                agent,\n                \"core.run.createRuntime.run\",\n            ) as ContextBoundAgent<TContext>;\n            if (\n                runOptions.conversationId !== undefined &&\n                runOptions.conversationId.trim().length === 0\n            ) {\n                throw BetterAgentError.fromCode(\n                    \"VALIDATION_FAILED\",\n                    \"conversationId must be a non-empty string.\",\n                    {\n                        context: { conversationId: runOptions.conversationId },\n                        trace: [{ at: \"core.run.createRuntime.run.validateConversationId\" }],\n                    },\n                );\n            }\n\n            const execution = createRuntimeExecutionContext({\n                resolvedAgent,\n                conversationId: runOptions.conversationId,\n                onEvent: runOptions.onEvent,\n                externalSignal: runOptions.signal,\n            });\n\n            const resolvedPersistence = buildPersistence(runOptions.persistence, {\n                stream: options.stream,\n                conversations: options.conversations,\n                runtimeState: options.runtimeState,\n            });\n\n            try {\n                const effectiveConversationReplay = resolveConversationReplay(\n                    resolvedAgent,\n                    runOptions.conversationReplay,\n                );\n                warnIgnoredConversationReplay({\n                    agent: resolvedAgent,\n                    conversationReplay: effectiveConversationReplay,\n                });\n                const validatedContext = await validateAgentContext(\n                    resolvedAgent,\n                    runOptions.context,\n                );\n                const runPersistence = runOptions.persistence;\n                const resolvedConversations =\n                    runPersistence?.conversations ?? options.conversations;\n                const conversationInput = await loadConversationMessages({\n                    input: runOptions.input,\n                    caps: resolvedAgent.model.caps,\n                    agentName: resolvedAgent.name,\n                    replaceHistory: runOptions.replaceHistory,\n                    conversationReplay: effectiveConversationReplay,\n                    conversations: resolvedConversations,\n                    conversationId: runOptions.conversationId,\n                });\n\n                await execution.emit({\n                    type: Events.RUN_STARTED,\n                    runId: execution.runId,\n                    agentName: resolvedAgent.name,\n                    runInput: {\n                        input: runOptions.input,\n                        context: validatedContext,\n                    },\n                    timestamp: Date.now(),\n                    conversationId: runOptions.conversationId,\n                });\n\n                if (execution.signal.aborted) {\n                    throw BetterAgentError.fromCode(\"ABORTED\", \"Run aborted before it started\", {\n                        context: { runId: execution.runId, agentName: resolvedAgent.name },\n                        trace: [{ at: \"core.run.createRuntime.run.abortedBeforeStart\" }],\n                    });\n                }\n\n                const result = await executeRun({\n                    agent: resolvedAgent,\n                    options: {\n                        ...runOptions,\n                        input: conversationInput.input,\n                        initialItems: conversationInput.items,\n                        replayStartIndex: conversationInput.replayStartIndex,\n                        conversationReplayActive: conversationInput.conversationReplayActive,\n                        conversationReplay: effectiveConversationReplay,\n                        context: validatedContext,\n                        runId: execution.runId,\n                        signal: execution.signal,\n                        emit: execution.emit,\n                        generateMessageId: () => generateId(\"message\"),\n                        mode: \"run\",\n                        advancedDefaults: options.advanced,\n                        persistence: resolvedPersistence,\n                        pendingToolRuntime,\n                        pluginRuntime,\n                    },\n                });\n\n                return await completeRunSuccess({\n                    runId: execution.runId,\n                    resolvedAgent,\n                    emit: execution.emit,\n                    result,\n                    saveConversationParams: {\n                        agentName: resolvedAgent.name,\n                        loaded: conversationInput.loaded,\n                        conversations: resolvedConversations,\n                        conversationId: runOptions.conversationId,\n                    },\n                    runtimeState: resolvedPersistence?.runtimeState,\n                    conversationId: runOptions.conversationId,\n                    success: (publicResult) => publicResult,\n                });\n            } catch (error) {\n                return await handleRunFailure({\n                    error,\n                    signal: execution.signal,\n                    traceAt: \"core.run.createRuntime.run\",\n                    emit: execution.emit,\n                    runId: execution.runId,\n                    resolvedAgent,\n                    conversationId: runOptions.conversationId,\n                    runtimeState: resolvedPersistence?.runtimeState,\n                });\n            } finally {\n                execution.cleanupSignal();\n            }\n        }) as unknown as BetterAgentRuntime<TAgents>[\"run\"],\n\n        stream: (<TContext, TOutput extends OutputSchemaDefinition | undefined = undefined>(\n            agent: TAgents[number][\"name\"],\n            runOptions: RunOptions<TContext, TOutput>,\n        ): StreamResult => {\n            const resolvedAgent = resolveAgentFromRegistry(\n                agents,\n                agent,\n                \"core.run.createRuntime.stream\",\n            ) as ContextBoundAgent<TContext>;\n            if (\n                runOptions.conversationId !== undefined &&\n                runOptions.conversationId.trim().length === 0\n            ) {\n                throw BetterAgentError.fromCode(\n                    \"VALIDATION_FAILED\",\n                    \"conversationId must be a non-empty string.\",\n                    {\n                        context: { conversationId: runOptions.conversationId },\n                        trace: [{ at: \"core.run.createRuntime.stream.validateConversationId\" }],\n                    },\n                );\n            }\n\n            const queue = createAsyncEventQueue<Event>();\n            const runPersistence = runOptions.persistence;\n            const streamStore = runPersistence?.stream ?? options.stream;\n            const execution = createRuntimeExecutionContext({\n                resolvedAgent,\n                conversationId: runOptions.conversationId,\n                onEvent: runOptions.onEvent,\n                externalSignal: runOptions.signal,\n                detachFromExternalAbort: streamLifecycle === \"detached\",\n                queueSignal: streamLifecycle === \"detached\" ? runOptions.signal : undefined,\n                streamStore,\n                queue,\n            });\n\n            const resolvedPersistence = buildPersistence(runPersistence, {\n                stream: streamStore,\n                conversations: options.conversations,\n                runtimeState: options.runtimeState,\n            });\n\n            const result = (async (): Promise<RunResult> => {\n                try {\n                    const effectiveConversationReplay = resolveConversationReplay(\n                        resolvedAgent,\n                        runOptions.conversationReplay,\n                    );\n                    warnIgnoredConversationReplay({\n                        agent: resolvedAgent,\n                        conversationReplay: effectiveConversationReplay,\n                    });\n                    const validatedContext = await validateAgentContext(\n                        resolvedAgent,\n                        runOptions.context,\n                    );\n                    const resolvedConversations =\n                        runPersistence?.conversations ?? options.conversations;\n                    const conversationInput = await loadConversationMessages({\n                        input: runOptions.input,\n                        caps: resolvedAgent.model.caps,\n                        agentName: resolvedAgent.name,\n                        replaceHistory: runOptions.replaceHistory,\n                        conversationReplay: effectiveConversationReplay,\n                        conversations: resolvedConversations,\n                        conversationId: runOptions.conversationId,\n                    });\n\n                    if (streamStore) {\n                        await streamStore.open(execution.runId, { runId: execution.runId });\n                    }\n\n                    if (\n                        resolvedPersistence?.runtimeState &&\n                        runOptions.conversationId !== undefined\n                    ) {\n                        await resolvedPersistence.runtimeState.set({\n                            conversationId: runOptions.conversationId,\n                            agentName: resolvedAgent.name,\n                            status: \"running\",\n                            updatedAt: Date.now(),\n                            activeRunId: execution.runId,\n                            activeStreamId: streamStore ? execution.runId : undefined,\n                        });\n                    }\n\n                    await execution.emit({\n                        type: Events.RUN_STARTED,\n                        runId: execution.runId,\n                        agentName: resolvedAgent.name,\n                        runInput: {\n                            input: runOptions.input,\n                            context: validatedContext,\n                        },\n                        timestamp: Date.now(),\n                        conversationId: runOptions.conversationId,\n                    });\n\n                    if (execution.signal.aborted) {\n                        throw BetterAgentError.fromCode(\n                            \"ABORTED\",\n                            \"Run aborted before it started\",\n                            {\n                                context: { runId: execution.runId, agentName: resolvedAgent.name },\n                                trace: [{ at: \"core.run.createRuntime.stream.abortedBeforeStart\" }],\n                            },\n                        );\n                    }\n\n                    const runResult = await executeRun({\n                        agent: resolvedAgent,\n                        options: {\n                            ...runOptions,\n                            input: conversationInput.input,\n                            initialItems: conversationInput.items,\n                            replayStartIndex: conversationInput.replayStartIndex,\n                            conversationReplayActive: conversationInput.conversationReplayActive,\n                            conversationReplay: effectiveConversationReplay,\n                            context: validatedContext,\n                            runId: execution.runId,\n                            signal: execution.signal,\n                            emit: execution.emit,\n                            generateMessageId: () => generateId(\"message\"),\n                            mode: \"stream\",\n                            advancedDefaults: options.advanced,\n                            persistence: resolvedPersistence,\n                            pendingToolRuntime,\n                            pluginRuntime,\n                        },\n                    });\n\n                    return await completeRunSuccess({\n                        runId: execution.runId,\n                        resolvedAgent,\n                        emit: execution.emit,\n                        result: runResult,\n                        streamStore,\n                        queue,\n                        saveConversationParams: {\n                            agentName: resolvedAgent.name,\n                            loaded: conversationInput.loaded,\n                            conversations: resolvedConversations,\n                            conversationId: runOptions.conversationId,\n                        },\n                        runtimeState: resolvedPersistence?.runtimeState,\n                        conversationId: runOptions.conversationId,\n                        success: (publicResult) => publicResult,\n                    });\n                } catch (error) {\n                    return await handleRunFailure({\n                        error,\n                        signal: execution.signal,\n                        traceAt: \"core.run.createRuntime.stream\",\n                        emit: execution.emit,\n                        runId: execution.runId,\n                        resolvedAgent,\n                        conversationId: runOptions.conversationId,\n                        streamStore,\n                        runtimeState: resolvedPersistence?.runtimeState,\n                        queue,\n                    });\n                } finally {\n                    execution.cleanupSignal();\n                }\n            })();\n\n            void result.catch(() => {});\n\n            return {\n                runId: execution.runId,\n                events: queue.iterate(),\n                result,\n            };\n        }) as unknown as BetterAgentRuntime<TAgents>[\"stream\"],\n\n        loadConversation: async <TName extends TAgents[number][\"name\"]>(\n            agent: TName,\n            conversationId: string,\n        ) => {\n            if (conversationId.trim().length === 0) {\n                throw BetterAgentError.fromCode(\n                    \"VALIDATION_FAILED\",\n                    \"conversationId must be a non-empty string.\",\n                    {\n                        context: { conversationId },\n                        trace: [\n                            {\n                                at: \"core.run.createRuntime.loadConversation.validateConversationId\",\n                            },\n                        ],\n                    },\n                );\n            }\n            const resolvedAgent = resolveAgentFromRegistry(\n                agents,\n                agent,\n                \"core.run.createRuntime.loadConversation\",\n            );\n            const conversations = options.conversations;\n            if (!conversations) {\n                return null;\n            }\n\n            const loaded = await conversations.load({\n                conversationId,\n                agentName: resolvedAgent.name,\n            });\n            if (!loaded) {\n                return null;\n            }\n\n            validateStoredConversationItems(loaded.items, conversationId);\n            return { items: loaded.items };\n        },\n        resumeStream: async (params) => {\n            if (params.streamId.trim().length === 0) {\n                throw BetterAgentError.fromCode(\n                    \"VALIDATION_FAILED\",\n                    \"streamId must be a non-empty string.\",\n                    {\n                        context: { streamId: params.streamId },\n                        trace: [{ at: \"core.run.createRuntime.resumeStream.validateStreamId\" }],\n                    },\n                );\n            }\n            if (!options.stream) {\n                return null;\n            }\n\n            return options.stream.resume(params.streamId, params.afterSeq);\n        },\n\n        resumeConversation: async <TName extends TAgents[number][\"name\"]>(\n            agent: TName,\n            params: ResumeConversationOptions,\n        ) => {\n            if (params.conversationId.trim().length === 0) {\n                throw BetterAgentError.fromCode(\n                    \"VALIDATION_FAILED\",\n                    \"conversationId must be a non-empty string.\",\n                    {\n                        context: { conversationId: params.conversationId },\n                        trace: [\n                            {\n                                at: \"core.run.createRuntime.resumeConversation.validateConversationId\",\n                            },\n                        ],\n                    },\n                );\n            }\n\n            const resolvedAgent = resolveAgentFromRegistry(\n                agents,\n                agent,\n                \"core.run.createRuntime.resumeConversation\",\n            );\n            const state = !options.runtimeState\n                ? null\n                : await options.runtimeState.get({\n                      conversationId: params.conversationId,\n                      agentName: resolvedAgent.name,\n                  });\n\n            if (!state || state.status !== \"running\" || !state.activeStreamId || !options.stream) {\n                return null;\n            }\n\n            // biome-ignore lint/style/noNonNullAssertion: activeStreamId is checked above via runtime state existence\n            return options.stream.resume(state.activeStreamId!, params.afterSeq);\n        },\n\n        abortRun: async (runId: string): Promise<boolean> => {\n            const controller = activeRuns.get(runId);\n            if (!controller) {\n                return false;\n            }\n\n            controller.abort();\n            return true;\n        },\n\n        submitToolResult: async (params: SubmitToolResultParams): Promise<boolean> =>\n            pendingToolRuntime.submitToolResult(params),\n\n        submitToolApproval: async (params: SubmitToolApprovalParams): Promise<boolean> =>\n            pendingToolRuntime.submitToolApproval(params),\n    };\n}\n"],"mappings":"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"}

package/dist/run/stop-conditions.mjs

@@ -0,0 +1,41 @@
+//#region src/run/stop-conditions.ts
+/** Extracts tool-call requests from a response. */
+const extractToolCallRequests = (response) => response.output.filter((item) => item.type === "tool-call" && "arguments" in item);
+/** Checks whether the loop hit `maxSteps`. */
+const shouldStopByMaxSteps = (params) => params.maxSteps !== void 0 && params.maxSteps > 0 && params.stepIndex + 1 >= params.maxSteps;
+/** Checks whether the loop produced no tool calls. */
+const shouldStopNaturally = (params) => extractToolCallRequests(params.response).length === 0;
+/** Evaluates stop conditions for the current step. */
+const evaluateStopConditions = (params) => {
+	if (shouldStopNaturally({ response: params.lastStep.response })) return {
+		stop: true,
+		reason: "no_tool_calls"
+	};
+	const baseStopWhenContext = {
+		stepIndex: params.stepIndex,
+		maxSteps: params.maxSteps,
+		lastStep: params.lastStep,
+		steps: params.steps,
+		messages: params.messages
+	};
+	const stopWhenContext = params.context !== void 0 ? {
+		...baseStopWhenContext,
+		context: params.context
+	} : baseStopWhenContext;
+	if (params.stopWhen?.(stopWhenContext) === true) return {
+		stop: true,
+		reason: "stop_when"
+	};
+	if (shouldStopByMaxSteps({
+		stepIndex: params.stepIndex,
+		maxSteps: params.maxSteps
+	})) return {
+		stop: true,
+		reason: "max_steps"
+	};
+	return { stop: false };
+};
+
+//#endregion
+export { evaluateStopConditions, extractToolCallRequests };
+//# sourceMappingURL=stop-conditions.mjs.map

package/dist/run/stop-conditions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stop-conditions.mjs","names":[],"sources":["../../src/run/stop-conditions.ts"],"sourcesContent":["import type {\n    Capabilities,\n    GenerativeModelInputItem,\n    GenerativeModelToolCallRequest,\n} from \"../providers\";\nimport type { ResolvableSchema } from \"../schema\";\nimport type { PreviousStepResult, StopWhen, StopWhenContext } from \"./types\";\n\n/** Stop decision for loop evaluation. */\nexport type LoopStopDecision =\n    | { stop: false }\n    | { stop: true; reason: \"max_steps\" | \"stop_when\" | \"no_tool_calls\" };\n\n/** Extracts tool-call requests from a response. */\nexport const extractToolCallRequests = (\n    response: PreviousStepResult[\"response\"],\n): GenerativeModelToolCallRequest[] =>\n    response.output.filter(\n        (item): item is GenerativeModelToolCallRequest =>\n            item.type === \"tool-call\" && \"arguments\" in item,\n    );\n\n/** Checks whether the loop hit `maxSteps`. */\nexport const shouldStopByMaxSteps = (params: {\n    stepIndex: number;\n    maxSteps: number | undefined;\n}): boolean =>\n    params.maxSteps !== undefined && params.maxSteps > 0 && params.stepIndex + 1 >= params.maxSteps;\n\n/** Checks whether the loop produced no tool calls. */\nexport const shouldStopNaturally = (params: {\n    response: PreviousStepResult[\"response\"];\n}): boolean => extractToolCallRequests(params.response).length === 0;\n\n/** Evaluates stop conditions for the current step. */\nexport const evaluateStopConditions = <\n    TContextSchema extends ResolvableSchema | undefined,\n    TContext,\n    TModelCaps extends Capabilities = Capabilities,\n>(params: {\n    maxSteps: number | undefined;\n    stepIndex: number;\n    stopWhen?: StopWhen<TContextSchema, TContext, TModelCaps>;\n    steps: PreviousStepResult[];\n    messages: GenerativeModelInputItem<TModelCaps>[];\n    context?: TContext;\n    lastStep: PreviousStepResult;\n}): LoopStopDecision => {\n    if (shouldStopNaturally({ response: params.lastStep.response })) {\n        return { stop: true, reason: \"no_tool_calls\" };\n    }\n\n    // Add `context` only when present.\n    const baseStopWhenContext = {\n        stepIndex: params.stepIndex,\n        maxSteps: params.maxSteps,\n        lastStep: params.lastStep,\n        steps: params.steps,\n        messages: params.messages,\n    };\n\n    const stopWhenContext =\n        params.context !== undefined\n            ? { ...baseStopWhenContext, context: params.context }\n            : baseStopWhenContext;\n\n    if (\n        params.stopWhen?.(\n            stopWhenContext as StopWhenContext<TContextSchema, TContext, TModelCaps>,\n        ) === true\n    ) {\n        return { stop: true, reason: \"stop_when\" };\n    }\n\n    if (\n        shouldStopByMaxSteps({\n            stepIndex: params.stepIndex,\n            maxSteps: params.maxSteps,\n        })\n    ) {\n        return { stop: true, reason: \"max_steps\" };\n    }\n\n    return { stop: false };\n};\n"],"mappings":";;AAcA,MAAa,2BACT,aAEA,SAAS,OAAO,QACX,SACG,KAAK,SAAS,eAAe,eAAe,KACnD;;AAGL,MAAa,wBAAwB,WAIjC,OAAO,aAAa,UAAa,OAAO,WAAW,KAAK,OAAO,YAAY,KAAK,OAAO;;AAG3F,MAAa,uBAAuB,WAErB,wBAAwB,OAAO,SAAS,CAAC,WAAW;;AAGnE,MAAa,0BAIX,WAQsB;AACpB,KAAI,oBAAoB,EAAE,UAAU,OAAO,SAAS,UAAU,CAAC,CAC3D,QAAO;EAAE,MAAM;EAAM,QAAQ;EAAiB;CAIlD,MAAM,sBAAsB;EACxB,WAAW,OAAO;EAClB,UAAU,OAAO;EACjB,UAAU,OAAO;EACjB,OAAO,OAAO;EACd,UAAU,OAAO;EACpB;CAED,MAAM,kBACF,OAAO,YAAY,SACb;EAAE,GAAG;EAAqB,SAAS,OAAO;EAAS,GACnD;AAEV,KACI,OAAO,WACH,gBACH,KAAK,KAEN,QAAO;EAAE,MAAM;EAAM,QAAQ;EAAa;AAG9C,KACI,qBAAqB;EACjB,WAAW,OAAO;EAClB,UAAU,OAAO;EACpB,CAAC,CAEF,QAAO;EAAE,MAAM;EAAM,QAAQ;EAAa;AAG9C,QAAO,EAAE,MAAM,OAAO"}

package/dist/run/types.d.mts

@@ -0,0 +1,348 @@
+import { Awaitable, BivariantFn } from "../internal/types.mjs";
+import { ResolvableSchema } from "../schema/types.mjs";
+import { Capabilities, InferOutputSchema, InstructionEnabled, ModalitiesParam, ModalityOptionsFor, OutputSchemaDefinition, OutputSchemaForCaps } from "../providers/types/capabilities.mjs";
+import { ToolChoice } from "../providers/types/tool-calls.mjs";
+import { GenerativeModelInput, GenerativeModelInputItem, GenerativeModelInputMessageContent, ModelOptions } from "../providers/types/input.mjs";
+import { ConversationItem } from "../providers/types/conversation.mjs";
+import { GenerativeModelResponse } from "../providers/types/response.mjs";
+import { GenerativeModel } from "../providers/types/model.mjs";
+import { AgentContext, AgentContextSchema, AgentModelCaps, AgentOutputSchema, AnyAgentDefinition } from "../agent/types.mjs";
+import { ConversationRuntimeStateStore, ConversationStore, StreamEvent, StreamStore } from "../persistence/types.mjs";
+import { Event } from "../events/types.mjs";
+//#region src/run/types.d.ts
+/**
+ * Conditional `context` field based on whether a schema is defined.
+ */
+type ConditionalContextField<TContextSchema extends ResolvableSchema | undefined, TContext> = [TContextSchema] extends [undefined] ? Record<never, never> : undefined extends TContextSchema ? {
+  context?: TContext;
+} : {
+  context: TContext;
+};
+/**
+ * Final result returned when a run completes.
+ */
+interface RunResult<TStructured = unknown> {
+  /** Final model response for the run. */
+  response: GenerativeModelResponse;
+  /** Parsed and validated structured output, when requested. */
+  structured?: TStructured;
+}
+/**
+ * Live stream handle returned by `.stream()`.
+ */
+interface StreamResult<TStructured = unknown> {
+  /** Unique id for this run. */
+  runId: string;
+  /** Live event stream for the run. */
+  events: AsyncGenerator<Event>;
+  /** Final result once the run finishes. */
+  result: Promise<RunResult<TStructured>>;
+}
+/** Options for resuming a stream by its known stream id. */
+interface ResumeStreamOptions {
+  /** Stream id to resume. */
+  streamId: string;
+  /** Optional sequence number to continue after. */
+  afterSeq?: number;
+}
+/** Options for resuming the active stream for a conversation. */
+interface ResumeConversationOptions {
+  /** Conversation id used to resolve the active stream. */
+  conversationId: string;
+  /** Optional sequence number to continue after. */
+  afterSeq?: number;
+}
+/**
+ * Runtime customization for replaying stored conversation history.
+ */
+interface ConversationReplayOptions {
+  /**
+   * When true, removes message parts that the current model cannot accept as
+   * input before replaying stored conversation history.
+   *
+   * Defaults to `true`.
+   */
+  omitUnsupportedParts?: boolean;
+  /**
+   * Customizes the provider input built from stored conversation items for
+   * this run.
+   *
+   * When provided, this fully replaces the default projection and
+   * capability-based pruning behavior. Set this to `null` on a run to
+   * disable an inherited agent-level hook.
+   */
+  prepareInput?: ((params: {
+    items: ConversationItem[];
+    caps: Capabilities;
+    agentName: string;
+    conversationId: string;
+  }) => Awaitable<GenerativeModelInputItem[]>) | null;
+}
+/**
+ * Payload used to submit a pending client tool result.
+ */
+type SubmitToolResultParams = {
+  /** Run id that owns the pending tool call. */runId: string; /** Tool call id to resolve. */
+  toolCallId: string; /** Submit a successful result for the tool call. */
+  status: "success"; /** Result payload to send back to the run. */
+  result: unknown;
+} | {
+  /** Run id that owns the pending tool call. */runId: string; /** Tool call id to resolve. */
+  toolCallId: string; /** Submit an execution error for the tool call. */
+  status: "error"; /** Error message to send back instead of a result. */
+  error: string;
+};
+/**
+ * Payload used to submit a pending tool approval decision.
+ */
+interface SubmitToolApprovalParams {
+  /** Run id that owns the pending approval. */
+  runId: string;
+  /** Tool call id to approve or deny. */
+  toolCallId: string;
+  /** Approval decision. */
+  decision: "approved" | "denied";
+  /** Optional note about the decision. */
+  note?: string;
+  /** Optional actor id for audit trails. */
+  actorId?: string;
+}
+type RuntimeAgentByName<TAgents extends readonly AnyAgentDefinition[], TName extends TAgents[number]["name"]> = Extract<TAgents[number], {
+  name: TName;
+}>;
+/**
+ * Structured output override accepted by one agent's model.
+ */
+type RunOutputOverrideForAgent<TAgent extends AnyAgentDefinition> = OutputSchemaForCaps<AgentModelCaps<TAgent["model"]>>;
+type StructuredRunResult<TStructured> = Omit<RunResult<TStructured>, "structured"> & {
+  structured: TStructured;
+};
+type UnstructuredRunResult = Omit<RunResult<never>, "structured">;
+type StructuredStreamResult<TStructured> = Omit<StreamResult<TStructured>, "result"> & {
+  result: Promise<StructuredRunResult<TStructured>>;
+};
+type UnstructuredStreamResult = Omit<StreamResult<never>, "result"> & {
+  result: Promise<UnstructuredRunResult>;
+};
+type AgentDefaultStructuredOutput<TAgent extends AnyAgentDefinition> = [AgentOutputSchema<TAgent>] extends [undefined] ? never : InferOutputSchema<AgentOutputSchema<TAgent>>;
+type RunOutputField<TAgent extends AnyAgentDefinition, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined> = [RunOutputOverrideForAgent<TAgent>] extends [never] ? object : {
+  /** Optional structured output schema override for this run. */output?: TOutput;
+};
+/**
+ * Structured output type produced for one agent run.
+ */
+type StructuredOutputForAgentRun<TAgent extends AnyAgentDefinition, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined = undefined> = [TOutput] extends [undefined] ? AgentDefaultStructuredOutput<TAgent> : InferOutputSchema<TOutput>;
+type AgentModelOptions<TAgent extends AnyAgentDefinition> = TAgent["model"] extends GenerativeModel<infer TOptions, infer _TProviderId, infer _TModelId, infer _TCaps> ? ModelOptions<TOptions> : TAgent["model"] extends {
+  options: infer TOptions extends Record<string, unknown>;
+} ? ModelOptions<TOptions> : Record<never, never>;
+/**
+ * Agent-aware run options with capability-gated structured output overrides.
+ */
+type RunOptionsForAgent<TAgent extends AnyAgentDefinition, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined = RunOutputOverrideForAgent<TAgent> | undefined, TModalities extends ModalitiesParam<AgentModelCaps<TAgent["model"]>> | undefined = undefined> = Omit<RunOptions<AgentContext<TAgent>, TOutput, AgentModelCaps<TAgent["model"]>, AgentModelOptions<TAgent>, TModalities>, "output" | "context"> & ConditionalContextField<AgentContextSchema<TAgent>, AgentContext<TAgent>> & RunOutputField<TAgent, TOutput>;
+/**
+ * Final run result for one agent.
+ */
+type RunResultForAgent<TAgent extends AnyAgentDefinition, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined = undefined> = [StructuredOutputForAgentRun<TAgent, TOutput>] extends [never] ? UnstructuredRunResult : StructuredRunResult<StructuredOutputForAgentRun<TAgent, TOutput>>;
+/**
+ * Stream handle for one agent and optional structured output override.
+ */
+type StreamResultForAgent<TAgent extends AnyAgentDefinition, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined = undefined> = [StructuredOutputForAgentRun<TAgent, TOutput>] extends [never] ? UnstructuredStreamResult : StructuredStreamResult<StructuredOutputForAgentRun<TAgent, TOutput>>;
+/**
+ * Runtime interface used by the app and HTTP server.
+ */
+interface BetterAgentRuntime<TAgents extends readonly AnyAgentDefinition[] = readonly AnyAgentDefinition[]> {
+  /** Runs an agent and returns the final result. */
+  run<TName extends TAgents[number]["name"], TAgent extends RuntimeAgentByName<TAgents, TName>, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined = undefined>(agent: TName, runOptions: RunOptionsForAgent<TAgent, TOutput>): Promise<RunResultForAgent<TAgent, TOutput>>;
+  /** Runs an agent and streams events as they happen. */
+  stream<TName extends TAgents[number]["name"], TAgent extends RuntimeAgentByName<TAgents, TName>, TOutput extends RunOutputOverrideForAgent<TAgent> | undefined = undefined>(agent: TName, runOptions: RunOptionsForAgent<TAgent, TOutput>): StreamResultForAgent<TAgent, TOutput>;
+  /** Resumes a stream from a known stream id. */
+  resumeStream(params: ResumeStreamOptions): Promise<AsyncIterable<StreamEvent> | null>;
+  /**
+   * Resume the active stream for a conversation when runtime-state lookup is configured.
+   *
+   * Returns `null` when runtime-state lookup is not configured, no active
+   * stream exists, or the stored stream cannot be resumed.
+   */
+  resumeConversation<TName extends TAgents[number]["name"]>(agent: TName, params: ResumeConversationOptions): Promise<AsyncIterable<StreamEvent> | null>;
+  /** Aborts an active run by id. Returns `false` when no active run is found. */
+  abortRun(runId: string): Promise<boolean>;
+  /**
+   * Load the persisted message history for one conversation.
+   *
+   * Returns `null` when no stored conversation exists.
+   */
+  loadConversation<TName extends TAgents[number]["name"]>(agent: TName, conversationId: string): Promise<{
+    items: ConversationItem[];
+  } | null>;
+  /** Submits a result for a pending client tool call. */
+  submitToolResult(params: SubmitToolResultParams): Promise<boolean>;
+  /** Submits an approval decision for a pending tool call. */
+  submitToolApproval(params: SubmitToolApprovalParams): Promise<boolean>;
+  /** Effective lifecycle for streaming runs created by this runtime. */
+  streamLifecycle?: "request_bound" | "detached";
+}
+/**
+ * Function used to stop the loop based on the latest completed step.
+ */
+type StopWhen<TContextSchema extends ResolvableSchema | undefined = undefined, TContext = unknown, TModelCaps extends Capabilities = Capabilities> = BivariantFn<[StopWhenContext<TContextSchema, TContext, TModelCaps>], boolean>;
+/**
+ * Conditional tool-control fields.
+ */
+type ConditionalToolControlField<TModelCaps extends Capabilities = Capabilities> = TModelCaps["tools"] extends true ? {
+  setToolChoice(choice: ToolChoice): void;
+  setActiveTools(names: readonly string[]): void;
+} : Record<never, never>;
+/**
+ * Conditional instruction-control fields.
+ */
+type ConditionalInstructionControlField<TModelCaps extends Capabilities = Capabilities> = InstructionEnabled<TModelCaps> extends true ? {
+  setSystemInstruction(instruction: GenerativeModelInputMessageContent<TModelCaps>): void;
+} : Record<never, never>;
+/**
+ * Base context passed to `onStep`.
+ */
+interface OnStepContextBase<TModelCaps extends Capabilities = Capabilities> {
+  /** Unique id for this run. */
+  runId: string;
+  /** Name of the active agent. */
+  agentName: string;
+  /** Shared conversation id, if this run uses one. */
+  conversationId?: string;
+  /** Zero-based step number for the next step. */
+  stepIndex: number;
+  /** Maximum number of steps allowed for this run. */
+  maxSteps: number | undefined;
+  /** Current message history before the next model call. */
+  messages: GenerativeModelInputItem<TModelCaps>[];
+  /** Result from the last completed step, if one exists. */
+  previousStep?: PreviousStepResult;
+  /** Replace the current messages before the next step runs. */
+  updateMessages(updater: (messages: GenerativeModelInputItem<TModelCaps>[]) => GenerativeModelInputItem<TModelCaps>[]): void;
+}
+/**
+ * Context passed to `onStep`.
+ */
+type OnStepContext<TContextSchema extends ResolvableSchema | undefined = undefined, TContext = unknown, TModelCaps extends Capabilities = Capabilities> = OnStepContextBase<TModelCaps> & ConditionalInstructionControlField<TModelCaps> & ConditionalContextField<TContextSchema, TContext> & ConditionalToolControlField<TModelCaps>;
+/**
+ * Base context passed to `onStepFinish`.
+ */
+interface OnStepFinishContextBase {
+  /** Unique id for this run. */
+  runId: string;
+  /** Name of the active agent. */
+  agentName: string;
+  /** Shared conversation id, if this run uses one. */
+  conversationId?: string;
+  /** Zero-based step number that just finished. */
+  stepIndex: number;
+  /** Maximum number of steps allowed for this run. */
+  maxSteps: number | undefined;
+  /** Result from the step that just finished. */
+  result: PreviousStepResult;
+}
+/**
+ * Context passed to `onStepFinish`.
+ */
+type OnStepFinishContext<TContextSchema extends ResolvableSchema | undefined = undefined, TContext = unknown> = OnStepFinishContextBase & ConditionalContextField<TContextSchema, TContext>;
+/**
+ * Base context passed to `stopWhen`.
+ */
+interface StopWhenContextBase<TModelCaps extends Capabilities = Capabilities> {
+  /** Zero-based index of the current step. */
+  stepIndex: number;
+  /** Maximum number of steps allowed for this run. If undefined, no limit. */
+  maxSteps: number | undefined;
+  /** Result from the most recent completed step. */
+  lastStep: PreviousStepResult;
+  /** Results from all completed steps so far. */
+  steps: PreviousStepResult[];
+  /** Current message history after the last step. */
+  messages: GenerativeModelInputItem<TModelCaps>[];
+}
+/**
+ * Context passed to `stopWhen`.
+ */
+type StopWhenContext<TContextSchema extends ResolvableSchema | undefined = undefined, TContext = unknown, TModelCaps extends Capabilities = Capabilities> = StopWhenContextBase<TModelCaps> & ConditionalContextField<TContextSchema, TContext>;
+/**
+ * Summary of the most recently completed loop step.
+ */
+interface PreviousStepResult {
+  /** Model response produced by that step. */
+  response: GenerativeModelResponse;
+}
+/**
+ * Basic runtime context for the current run.
+ */
+interface RunContext {
+  /** Unique id for this run. */
+  runId: string;
+  /** Name of the active agent. */
+  agentName: string;
+  /** Provider identifier for the model being used. */
+  providerId: string;
+  /** Model identifier within the provider. */
+  modelId: string;
+  /** Shared conversation id, if this run uses one. */
+  conversationId?: string;
+  /** Abort signal for canceling work. */
+  signal: AbortSignal;
+  /** Generate a stable message id for provider-authored model events. */
+  generateMessageId: () => string;
+}
+/**
+ * Persistence overrides for one run.
+ */
+interface RunPersistenceOptions {
+  /** Advanced: override the stream store for this run. */
+  stream?: StreamStore;
+  /** Advanced: override the conversation store for this run. */
+  conversations?: ConversationStore;
+  /** Advanced: override the conversation runtime-state store for this run. */
+  runtimeState?: ConversationRuntimeStateStore;
+}
+/**
+ * Advanced runtime controls for interactive runs.
+ */
+interface RunAdvancedOptions {
+  /**
+   * Default timeout for waiting on client tool results when the tool itself
+   * does not provide a more specific timeout.
+   */
+  clientToolResultTimeoutMs?: number;
+  /**
+   * Default timeout for waiting on tool approvals when the tool itself does
+   * not provide a more specific timeout.
+   */
+  toolApprovalTimeoutMs?: number;
+}
+/**
+ * Options for running an agent.
+ *
+ * Prefer {@link RunOptionsForAgent} for agent-aware APIs.
+ */
+type RunOptions<TContext = unknown, TOutput extends OutputSchemaDefinition | undefined = undefined, TModelCaps extends Capabilities = Capabilities, TModelOptions extends object = Record<never, never>, TModalities extends ModalitiesParam<TModelCaps> | undefined = undefined> = {
+  /** Input to send to the agent. */input: GenerativeModelInput<TModelCaps>; /** Extra agent context to validate and use during the run. */
+  context?: TContext; /** Optional structured output schema override for this run. */
+  output?: TOutput; /** Optional output modalities to request for this run. */
+  modalities?: TModalities; /** Optional provider-specific model options for this run. Unknown keys are passed through to the provider. */
+  modelOptions?: TModelOptions & ModalityOptionsFor<TModelCaps, TModalities> & Record<string, unknown>; /** Conversation id to load and save message history. */
+  conversationId?: string; /** Controls how stored conversation history is prepared for replay in this run. */
+  conversationReplay?: ConversationReplayOptions;
+  /**
+   * When true, array input replaces stored conversation history instead of being
+   * prepended with it.
+   *
+   * This is primarily used when a client submits the full conversation history
+   * together with a `conversationId`, for example during retry/regenerate flows.
+   * String or single-message inputs should usually leave this unset.
+   */
+  replaceHistory?: boolean; /** Abort signal for canceling the run. */
+  signal?: AbortSignal; /** Called for each event emitted during the run. */
+  onEvent?: (event: Event) => void | Promise<void>; /** Max loop steps for this run. Overrides the agent default. */
+  maxSteps?: number; /** Advanced interactive runtime options for this run. */
+  advanced?: RunAdvancedOptions; /** Advanced: override persistence stores for this run. */
+  persistence?: RunPersistenceOptions;
+};
+//#endregion
+export { BetterAgentRuntime, ConditionalContextField, ConditionalInstructionControlField, ConditionalToolControlField, ConversationReplayOptions, OnStepContext, OnStepContextBase, OnStepFinishContext, OnStepFinishContextBase, PreviousStepResult, ResumeConversationOptions, ResumeStreamOptions, RunAdvancedOptions, RunContext, RunOptions, RunOptionsForAgent, RunOutputOverrideForAgent, RunPersistenceOptions, RunResult, RunResultForAgent, StopWhen, StopWhenContext, StopWhenContextBase, StreamResult, StreamResultForAgent, StructuredOutputForAgentRun, SubmitToolApprovalParams, SubmitToolResultParams };
+//# sourceMappingURL=types.d.mts.map

package/dist/run/types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../src/run/types.ts"],"mappings":";;;;;;;;;;;;;;;KA0CY,uBAAA,wBACe,gBAAA,2BAEtB,cAAA,wBACC,MAAA,mCACkB,cAAA;EACd,OAAA,GAAU,QAAA;AAAA;EACV,OAAA,EAAS,QAAA;AAAA;;;;UAKF,SAAA;EAZL;EAcR,QAAA,EAAU,uBAAA;EAdqB;EAgB/B,UAAA,GAAa,WAAA;AAAA;;;;UAMA,YAAA;EAfU;EAiBvB,KAAA;EAvBA;EAyBA,MAAA,EAAQ,cAAA,CAAe,KAAA;EAxBvB;EA0BA,MAAA,EAAQ,OAAA,CAAQ,SAAA,CAAU,WAAA;AAAA;;UAIb,mBAAA;EA1BG;EA4BhB,QAAA;EA3Be;EA6Bf,QAAA;AAAA;AAxBJ;AAAA,UA4BiB,yBAAA;EA5BS;EA8BtB,cAAA;EA9BuB;EAgCvB,QAAA;AAAA;;;;UAMa,yBAAA;EA5BA;;;;;;EAmCb,oBAAA;EA7BQ;;;;;;;;EAsCR,YAAA,KACQ,MAAA;IACE,KAAA,EAAO,gBAAA;IACP,IAAA,EAAM,YAAA;IACN,SAAA;IACA,cAAA;EAAA,MACE,SAAA,CAAU,wBAAA;AAAA;;;;KAOd,sBAAA;EAvCK,8CA0CP,KAAA;EAEA,UAAA,UAxCE;EA0CF,MAAA,aApCgC;EAsChC,MAAA;AAAA;EAnBU,8CAuBV,KAAA,UApBM;EAsBN,UAAA,UAtBe;EAwBf,MAAA,WA9BN;EAgCM,KAAA;AAAA;;;;UAMO,wBAAA;EArCL;EAuCR,KAAA;EAlCsB;EAoCtB,UAAA;EApC8C;EAsC9C,QAAA;EA/B8B;EAiC9B,IAAA;EAjC8B;EAmC9B,OAAA;AAAA;AAAA,KAGC,kBAAA,0BACwB,kBAAA,kBACX,OAAA,oBACd,OAAA,CAAQ,OAAA;EAAmB,IAAA,EAAM,KAAA;AAAA;;;;KAKzB,yBAAA,gBAAyC,kBAAA,IAAsB,mBAAA,CACvE,cAAA,CAAe,MAAA;AAAA,KAGd,mBAAA,gBAAmC,IAAA,CAAK,SAAA,CAAU,WAAA;EACnD,UAAA,EAAY,WAAA;AAAA;AAAA,KAGX,qBAAA,GAAwB,IAAA,CAAK,SAAA;AAAA,KAE7B,sBAAA,gBAAsC,IAAA,CAAK,YAAA,CAAa,WAAA;EACzD,MAAA,EAAQ,OAAA,CAAQ,mBAAA,CAAoB,WAAA;AAAA;AAAA,KAGnC,wBAAA,GAA2B,IAAA,CAAK,YAAA;EACjC,MAAA,EAAQ,OAAA,CAAQ,qBAAA;AAAA;AAAA,KAGf,4BAAA,gBAA4C,kBAAA,KAC7C,iBAAA,CAAkB,MAAA,iCAGhB,iBAAA,CAAkB,iBAAA,CAAkB,MAAA;AAAA,KAErC,cAAA,gBACc,kBAAA,kBACC,yBAAA,CAA0B,MAAA,kBACzC,yBAAA,CAA0B,MAAA;EAnCR,+DAuCb,MAAA,GAAS,OAAA;AAAA;;;;KAMP,2BAAA,gBACO,kBAAA,kBACC,yBAAA,CAA0B,MAAA,8BACzC,OAAA,wBACC,4BAAA,CAA6B,MAAA,IAC7B,iBAAA,CAAkB,OAAA;AAAA,KAEnB,iBAAA,gBAAiC,kBAAA,IAAsB,MAAA,kBAAwB,eAAA,sEAM9E,YAAA,CAAa,QAAA,IACb,MAAA;EACM,OAAA,yBAAgC,MAAA;AAAA,IAEpC,YAAA,CAAa,QAAA,IACb,MAAA;;;;KAKI,kBAAA,gBACO,kBAAA,kBACC,yBAAA,CAA0B,MAAA,gBACpC,yBAAA,CAA0B,MAAA,mCAEZ,eAAA,CAAgB,cAAA,CAAe,MAAA,uCACnD,IAAA,CACA,UAAA,CACI,YAAA,CAAa,MAAA,GACb,OAAA,EACA,cAAA,CAAe,MAAA,YACf,iBAAA,CAAkB,MAAA,GAClB,WAAA,2BAIJ,uBAAA,CAAwB,kBAAA,CAAmB,MAAA,GAAS,YAAA,CAAa,MAAA,KACjE,cAAA,CAAe,MAAA,EAAQ,OAAA;;;;KAKf,iBAAA,gBACO,kBAAA,kBACC,yBAAA,CAA0B,MAAA,8BACzC,2BAAA,CAA4B,MAAA,EAAQ,OAAA,qBACnC,qBAAA,GACA,mBAAA,CAAoB,2BAAA,CAA4B,MAAA,EAAQ,OAAA;AAvF9D;;;AAAA,KA4FY,oBAAA,gBACO,kBAAA,kBACC,yBAAA,CAA0B,MAAA,8BACzC,2BAAA,CAA4B,MAAA,EAAQ,OAAA,qBACnC,wBAAA,GACA,sBAAA,CAAuB,2BAAA,CAA4B,MAAA,EAAQ,OAAA;;;;UAKhD,kBAAA,0BACY,kBAAA,cAAgC,kBAAA;EAvGiC;EA0G1F,GAAA,eACkB,OAAA,iCACC,kBAAA,CAAmB,OAAA,EAAS,KAAA,mBAC3B,yBAAA,CAA0B,MAAA,2BAE1C,KAAA,EAAO,KAAA,EACP,UAAA,EAAY,kBAAA,CAAmB,MAAA,EAAQ,OAAA,IACxC,OAAA,CAAQ,iBAAA,CAAkB,MAAA,EAAQ,OAAA;EAjHY;EAmHjD,MAAA,eACkB,OAAA,iCACC,kBAAA,CAAmB,OAAA,EAAS,KAAA,mBAC3B,yBAAA,CAA0B,MAAA,2BAE1C,KAAA,EAAO,KAAA,EACP,UAAA,EAAY,kBAAA,CAAmB,MAAA,EAAQ,OAAA,IACxC,oBAAA,CAAqB,MAAA,EAAQ,OAAA;EAzHhC;EA2HA,YAAA,CAAa,MAAA,EAAQ,mBAAA,GAAsB,OAAA,CAAQ,aAAA,CAAc,WAAA;EA3H5C;;AACvB;;;;EAiIE,kBAAA,eAAiC,OAAA,kBAC7B,KAAA,EAAO,KAAA,EACP,MAAA,EAAQ,yBAAA,GACT,OAAA,CAAQ,aAAA,CAAc,WAAA;EAlIW;EAoIpC,QAAA,CAAS,KAAA,WAAgB,OAAA;EAnIF;;;;;EAyIvB,gBAAA,eAA+B,OAAA,kBAC3B,KAAA,EAAO,KAAA,EACP,cAAA,WACD,OAAA;IAAU,KAAA,EAAO,gBAAA;EAAA;EA5IG;EA8IvB,gBAAA,CAAiB,MAAA,EAAQ,sBAAA,GAAyB,OAAA;EA3IjD;EA6ID,kBAAA,CAAmB,MAAA,EAAQ,wBAAA,GAA2B,OAAA;;EAEtD,eAAA;AAAA;AA/IuC;;;AAAA,KAqJ/B,QAAA,wBACe,gBAAA,iEAEJ,YAAA,GAAe,YAAA,IAClC,WAAA,EAAa,eAAA,CAAgB,cAAA,EAAgB,QAAA,EAAU,UAAA;;;;KAK/C,2BAAA,oBAA+C,YAAA,GAAe,YAAA,IACtE,UAAA;EAEU,aAAA,CAAc,MAAA,EAAQ,UAAA;EACtB,cAAA,CAAe,KAAA;AAAA,IAEnB,MAAA;;;;KAKE,kCAAA,oBAAsD,YAAA,GAAe,YAAA,IAC7E,kBAAA,CAAmB,UAAA;EAET,oBAAA,CACI,WAAA,EAAa,kCAAA,CAAmC,UAAA;AAAA,IAGxD,MAAA;;;;UAKO,iBAAA,oBAAqC,YAAA,GAAe,YAAA;EA/KhE;EAiLD,KAAA;;EAEA,SAAA;EAnL4B;EAqL5B,cAAA;EApLQ;EAsLR,SAAA;EAtLe;EAwLf,QAAA;EAzLiC;EA2LjC,QAAA,EAAU,wBAAA,CAAyB,UAAA;EA1L3B;EA4LR,YAAA,GAAe,kBAAA;EA5LsB;EA8LrC,cAAA,CACI,OAAA,GACI,QAAA,EAAU,wBAAA,CAAyB,UAAA,QAClC,wBAAA,CAAyB,UAAA;AAAA;;;;KAO1B,aAAA,wBACe,gBAAA,iEAEJ,YAAA,GAAe,YAAA,IAClC,iBAAA,CAAkB,UAAA,IAClB,kCAAA,CAAmC,UAAA,IACnC,uBAAA,CAAwB,cAAA,EAAgB,QAAA,IACxC,2BAAA,CAA4B,UAAA;;;;UAKf,uBAAA;EA7MM;EA+MnB,KAAA;EAnN8B;EAqN9B,SAAA;EApNA;EAsNA,cAAA;EAnNE;EAqNF,SAAA;EArNsC;EAuNtC,QAAA;EAvN4C;EAyN5C,MAAA,EAAQ,kBAAA;AAAA;;;;KAMA,mBAAA,wBACe,gBAAA,gDAEvB,uBAAA,GAA0B,uBAAA,CAAwB,cAAA,EAAgB,QAAA;;;;UAKrD,mBAAA,oBAAuC,YAAA,GAAe,YAAA;EA9N7C;EAgOtB,SAAA;EAtOe;EAwOf,QAAA;EAvOgB;EAyOhB,QAAA,EAAU,kBAAA;EAxOT;EA0OD,KAAA,EAAO,kBAAA;EAtOD;EAwON,QAAA,EAAU,wBAAA,CAAyB,UAAA;AAAA;;AAlOvC;;KAwOY,eAAA,wBACe,gBAAA,iEAEJ,YAAA,GAAe,YAAA,IAClC,mBAAA,CAAoB,UAAA,IAAc,uBAAA,CAAwB,cAAA,EAAgB,QAAA;;;;UAK7D,kBAAA;EA7OkB;EA+O/B,QAAA,EAAU,uBAAA;AAAA;;;;UAMG,UAAA;EAxPE;EA0Pf,KAAA;EAzPgB;EA2PhB,SAAA;EA1PC;EA4PD,UAAA;EA3P+B;EA6P/B,OAAA;EA5PoB;EA8PpB,cAAA;EA9P2B;EAgQ3B,MAAA,EAAQ,WAAA;EA9PU;EAgQlB,iBAAA;AAAA;;;;UAMa,qBAAA;EA/PX;EAiQF,MAAA,GAAS,WAAA;EA9PQ;EAgQjB,aAAA,GAAgB,iBAAA;EA/PZ;EAiQJ,YAAA,GAAe,6BAAA;AAAA;;;;UAMF,kBAAA;EAjRP;;;;EAsRN,yBAAA;EAjRe;;;;EAsRf,qBAAA;AAAA;;;;;AA5QJ;KAoRY,UAAA,qCAEQ,sBAAA,6CACG,YAAA,GAAe,YAAA,iCACH,MAAA,oCACX,eAAA,CAAgB,UAAA;EAzRV,kCA4R1B,KAAA,EAAO,oBAAA,CAAqB,UAAA,GA1Rc;EA4R1C,OAAA,GAAU,QAAA,EA3RsB;EA6RhC,MAAA,GAAS,OAAA,EA3R0C;EA6RnD,UAAA,GAAa,WAAA,EA7RO;EA+RpB,YAAA,GAAe,aAAA,GACX,kBAAA,CAAmB,UAAA,EAAY,WAAA,IAC/B,MAAA,mBA9RA;EAgSJ,cAAA,WA9RmB;EAgSnB,kBAAA,GAAqB,yBAAA;EA/RC;;;;;;;;EAwStB,cAAA,YAnSA;EAqSA,MAAA,GAAS,WAAA,EApSc;EAsSvB,OAAA,IAAW,KAAA,EAAO,KAAA,YAAiB,OAAA,QAtSrB;EAwSd,QAAA,WAxTA;EA0TA,QAAA,GAAW,kBAAA,EAzTX;EA2TA,WAAA,GAAc,qBAAA;AAAA"}

package/dist/schema/index.d.mts

@@ -0,0 +1,2 @@
+import { AnyStandardSchemaV1, InferSchemaInput, InferStandardInput, ResolvableSchema, StandardSchema, ValidatableSchema } from "./types.mjs";
+import { resolveToJsonSchema, validateInput } from "./resolve-json-schema.mjs";

package/dist/schema/resolve-json-schema.d.mts

@@ -0,0 +1,12 @@
+import { ResolvableSchema, ValidatableSchema } from "./types.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { Result } from "@better-agent/shared/neverthrow";
+
+//#region src/schema/resolve-json-schema.d.ts
+declare const resolveToJsonSchema: (schema: ResolvableSchema) => Result<Record<string, unknown>, BetterAgentError>;
+declare const validateInput: <T>(schema: ValidatableSchema, data: unknown, options?: {
+  invalidMessage?: string;
+}) => Promise<Result<T, BetterAgentError>>;
+//#endregion
+export { resolveToJsonSchema, validateInput };
+//# sourceMappingURL=resolve-json-schema.d.mts.map

package/dist/schema/resolve-json-schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-json-schema.d.mts","names":[],"sources":["../../src/schema/resolve-json-schema.ts"],"mappings":";;;;;cA8Ia,mBAAA,GAAmB,MAAA,EACpB,gBAAA,KACT,MAAA,CAAO,MAAA,mBAAyB,gBAAA;AAAA,cA4EtB,aAAA,MAAwB,MAAA,EACzB,iBAAA,EAAiB,IAAA,WACZ,OAAA;EAET,cAAA;AAAA,MAEL,OAAA,CAAQ,MAAA,CAAO,CAAA,EAAG,gBAAA"}