@better-agent/core 0.1.0-beta.1

package/dist/run/hooks.mjs

@@ -0,0 +1,124 @@
+import { BetterAgentError } from "@better-agent/shared/errors";
+
+//#region src/run/hooks.ts
+/** Applies `onStep` hooks. */
+const applyOnStep = async (params) => {
+	const prepared = { messages: [...params.messages] };
+	if (params.pluginRuntime?.hasOnStep) {
+		const pluginPrepared = await params.pluginRuntime.applyOnStep({
+			runId: params.runId,
+			agentName: params.agentName,
+			stepIndex: params.stepIndex,
+			maxSteps: params.maxSteps,
+			messages: prepared.messages,
+			conversationId: params.conversationId,
+			context: params.context,
+			previousStep: params.previousStep,
+			modelCaps: params.modelCaps
+		});
+		prepared.messages = pluginPrepared.messages;
+		if (pluginPrepared.toolChoice !== void 0) prepared.toolChoice = pluginPrepared.toolChoice;
+		if (pluginPrepared.activeTools !== void 0) prepared.activeTools = pluginPrepared.activeTools;
+		if (pluginPrepared.systemInstruction !== void 0) prepared.systemInstruction = pluginPrepared.systemInstruction;
+	}
+	if (!params.onStep) return prepared;
+	const baseContext = {
+		runId: params.runId,
+		agentName: params.agentName,
+		stepIndex: params.stepIndex,
+		maxSteps: params.maxSteps,
+		messages: prepared.messages,
+		conversationId: params.conversationId,
+		previousStep: params.previousStep,
+		updateMessages: (updater) => {
+			prepared.messages = updater([...prepared.messages]);
+			baseContext.messages = prepared.messages;
+		}
+	};
+	const supportsTools = params.modelCaps?.tools === true;
+	const withInstructionControl = (params.modelCaps === void 0 ? true : params.modelCaps.inputShape !== "prompt" && params.modelCaps.supportsInstruction === true) ? {
+		...baseContext,
+		setSystemInstruction: (instruction) => {
+			prepared.systemInstruction = instruction;
+		}
+	} : baseContext;
+	const contextWithControls = supportsTools ? {
+		...withInstructionControl,
+		setToolChoice: (choice) => {
+			prepared.toolChoice = choice;
+		},
+		setActiveTools: (names) => {
+			prepared.activeTools = [...names];
+		}
+	} : withInstructionControl;
+	const hookContext = params.context !== void 0 ? {
+		...contextWithControls,
+		context: params.context
+	} : contextWithControls;
+	try {
+		await params.onStep(hookContext);
+	} catch (error) {
+		throw BetterAgentError.fromCode("HOOK_FAILED", "Agent onStep hook threw.", {
+			cause: error,
+			trace: [{ at: "core.run.applyOnStep" }]
+		});
+	}
+	return prepared;
+};
+/** Applies `onBeforeModelCall` hooks. */
+const applyBeforeModelCall = async (params) => {
+	if (!params.pluginRuntime?.hasModelHooks) return {
+		input: [...params.input],
+		tools: [...params.tools],
+		toolChoice: params.toolChoice
+	};
+	return await params.pluginRuntime.applyBeforeModelCall({
+		runId: params.runId,
+		agentName: params.agentName,
+		stepIndex: params.stepIndex,
+		input: params.input,
+		tools: params.tools,
+		conversationId: params.conversationId,
+		toolChoice: params.toolChoice,
+		modelCaps: params.modelCaps
+	});
+};
+/** Applies `onAfterModelCall` hooks. */
+const applyAfterModelCall = async (params) => {
+	if (!params.pluginRuntime?.hasModelHooks) return;
+	await params.pluginRuntime.applyAfterModelCall({
+		runId: params.runId,
+		agentName: params.agentName,
+		stepIndex: params.stepIndex,
+		response: params.response,
+		conversationId: params.conversationId
+	});
+};
+/** Applies `onStepFinish`. */
+const applyOnStepFinish = async (params) => {
+	if (!params.onStepFinish) return;
+	const baseContext = {
+		runId: params.runId,
+		agentName: params.agentName,
+		stepIndex: params.stepIndex,
+		maxSteps: params.maxSteps,
+		result: params.result,
+		conversationId: params.conversationId
+	};
+	const hookContext = params.context !== void 0 ? {
+		...baseContext,
+		context: params.context
+	} : baseContext;
+	try {
+		await params.onStepFinish(hookContext);
+	} catch (error) {
+		throw BetterAgentError.fromCode("HOOK_FAILED", "Agent onStepFinish hook threw.", {
+			cause: error,
+			trace: [{ at: "core.run.applyOnStepFinish" }]
+		});
+	}
+};
+
+//#endregion
+export { applyAfterModelCall, applyBeforeModelCall, applyOnStep, applyOnStepFinish };
+//# sourceMappingURL=hooks.mjs.map

package/dist/run/hooks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.mjs","names":[],"sources":["../../src/run/hooks.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport type { Awaitable } from \"../internal/types\";\nimport type { PluginRuntime } from \"../plugins\";\nimport type {\n    Capabilities,\n    GenerativeModelInputItem,\n    GenerativeModelInputMessageContent,\n    GenerativeModelResponse,\n    ToolChoice,\n} from \"../providers\";\nimport type { AgentToolDefinition } from \"../tools\";\nimport type {\n    OnStepContext,\n    OnStepContextBase,\n    OnStepFinishContext,\n    OnStepFinishContextBase,\n    PreviousStepResult,\n} from \"./types\";\n\n/** Applies `onStep` hooks. */\nexport const applyOnStep = async <TContext, TModelCaps extends Capabilities = Capabilities>(\n    params: {\n        runId: string;\n        agentName: string;\n        conversationId?: string;\n        stepIndex: number;\n        maxSteps: number | undefined;\n        context?: TContext;\n        pluginRuntime?: PluginRuntime | null;\n        /** Model caps for plugin controls. */\n        modelCaps?: TModelCaps;\n    } & {\n        messages: GenerativeModelInputItem<TModelCaps>[];\n        previousStep?: PreviousStepResult;\n        onStep?: (context: OnStepContext<undefined, TContext, TModelCaps>) => Awaitable<void>;\n    },\n): Promise<{\n    messages: GenerativeModelInputItem<TModelCaps>[];\n    toolChoice?: ToolChoice;\n    activeTools?: string[];\n    systemInstruction?: GenerativeModelInputMessageContent<TModelCaps>;\n}> => {\n    const prepared: {\n        messages: GenerativeModelInputItem<TModelCaps>[];\n        toolChoice?: ToolChoice;\n        activeTools?: string[];\n        systemInstruction?: GenerativeModelInputMessageContent<TModelCaps>;\n    } = {\n        messages: [...params.messages],\n    };\n\n    if (params.pluginRuntime?.hasOnStep) {\n        const pluginPrepared = await params.pluginRuntime.applyOnStep({\n            runId: params.runId,\n            agentName: params.agentName,\n            stepIndex: params.stepIndex,\n            maxSteps: params.maxSteps,\n            messages: prepared.messages,\n            conversationId: params.conversationId,\n            context: params.context,\n            previousStep: params.previousStep,\n            modelCaps: params.modelCaps,\n        });\n\n        prepared.messages = pluginPrepared.messages;\n        if (pluginPrepared.toolChoice !== undefined) {\n            prepared.toolChoice = pluginPrepared.toolChoice;\n        }\n        if (pluginPrepared.activeTools !== undefined) {\n            prepared.activeTools = pluginPrepared.activeTools;\n        }\n        if (pluginPrepared.systemInstruction !== undefined) {\n            prepared.systemInstruction = pluginPrepared.systemInstruction;\n        }\n    }\n\n    if (!params.onStep) return prepared;\n\n    const baseContext: OnStepContextBase<TModelCaps> = {\n        runId: params.runId,\n        agentName: params.agentName,\n        stepIndex: params.stepIndex,\n        maxSteps: params.maxSteps,\n        messages: prepared.messages,\n        conversationId: params.conversationId,\n        previousStep: params.previousStep,\n        updateMessages: (updater) => {\n            prepared.messages = updater([...prepared.messages]);\n            (baseContext as typeof hookContext).messages = prepared.messages;\n        },\n    };\n\n    const supportsTools = params.modelCaps?.tools === true;\n    const canSetInstruction =\n        params.modelCaps === undefined\n            ? true\n            : params.modelCaps.inputShape !== \"prompt\" &&\n              params.modelCaps.supportsInstruction === true;\n    const withInstructionControl = canSetInstruction\n        ? {\n              ...baseContext,\n              setSystemInstruction: (\n                  instruction: GenerativeModelInputMessageContent<TModelCaps>,\n              ) => {\n                  prepared.systemInstruction = instruction;\n              },\n          }\n        : baseContext;\n    const contextWithControls = supportsTools\n        ? {\n              ...withInstructionControl,\n              setToolChoice: (choice: ToolChoice) => {\n                  prepared.toolChoice = choice;\n              },\n              setActiveTools: (names: readonly string[]) => {\n                  prepared.activeTools = [...names];\n              },\n          }\n        : withInstructionControl;\n\n    // Add `context` only when present.\n    const hookContext =\n        params.context !== undefined\n            ? { ...contextWithControls, context: params.context }\n            : contextWithControls;\n\n    try {\n        await params.onStep(hookContext as OnStepContext<undefined, TContext, TModelCaps>);\n    } catch (error) {\n        throw BetterAgentError.fromCode(\"HOOK_FAILED\", \"Agent onStep hook threw.\", {\n            cause: error,\n            trace: [{ at: \"core.run.applyOnStep\" }],\n        });\n    }\n    return prepared;\n};\n\n/** Applies `onBeforeModelCall` hooks. */\nexport const applyBeforeModelCall = async (params: {\n    runId: string;\n    agentName: string;\n    conversationId?: string;\n    stepIndex: number;\n    modelCaps?: Capabilities;\n    input: GenerativeModelInputItem[];\n    tools: AgentToolDefinition[];\n    toolChoice?: ToolChoice;\n    pluginRuntime?: PluginRuntime | null;\n}): Promise<{\n    input: GenerativeModelInputItem[];\n    tools: AgentToolDefinition[];\n    toolChoice?: ToolChoice;\n}> => {\n    if (!params.pluginRuntime?.hasModelHooks) {\n        return {\n            input: [...params.input],\n            tools: [...params.tools],\n            toolChoice: params.toolChoice,\n        };\n    }\n\n    return await params.pluginRuntime.applyBeforeModelCall({\n        runId: params.runId,\n        agentName: params.agentName,\n        stepIndex: params.stepIndex,\n        input: params.input,\n        tools: params.tools,\n        conversationId: params.conversationId,\n        toolChoice: params.toolChoice,\n        modelCaps: params.modelCaps,\n    });\n};\n\n/** Applies `onAfterModelCall` hooks. */\nexport const applyAfterModelCall = async (params: {\n    runId: string;\n    agentName: string;\n    conversationId?: string;\n    stepIndex: number;\n    response: GenerativeModelResponse;\n    pluginRuntime?: PluginRuntime | null;\n}): Promise<void> => {\n    if (!params.pluginRuntime?.hasModelHooks) {\n        return;\n    }\n\n    await params.pluginRuntime.applyAfterModelCall({\n        runId: params.runId,\n        agentName: params.agentName,\n        stepIndex: params.stepIndex,\n        response: params.response,\n        conversationId: params.conversationId,\n    });\n};\n\n/** Applies `onStepFinish`. */\nexport const applyOnStepFinish = async <TContext>(\n    params: {\n        runId: string;\n        agentName: string;\n        conversationId?: string;\n        stepIndex: number;\n        maxSteps: number | undefined;\n        context?: TContext;\n    } & {\n        result: PreviousStepResult;\n        onStepFinish?: (context: OnStepFinishContext<undefined, TContext>) => Awaitable<void>;\n    },\n): Promise<void> => {\n    if (!params.onStepFinish) return;\n\n    const baseContext: OnStepFinishContextBase = {\n        runId: params.runId,\n        agentName: params.agentName,\n        stepIndex: params.stepIndex,\n        maxSteps: params.maxSteps,\n        result: params.result,\n        conversationId: params.conversationId,\n    };\n\n    // Add `context` only when present.\n    const hookContext =\n        params.context !== undefined ? { ...baseContext, context: params.context } : baseContext;\n\n    try {\n        await params.onStepFinish(hookContext as OnStepFinishContext<undefined, TContext>);\n    } catch (error) {\n        throw BetterAgentError.fromCode(\"HOOK_FAILED\", \"Agent onStepFinish hook threw.\", {\n            cause: error,\n            trace: [{ at: \"core.run.applyOnStepFinish\" }],\n        });\n    }\n};\n"],"mappings":"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"}

package/dist/run/index.d.mts

@@ -0,0 +1,4 @@
+import { 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 } from "./types.mjs";
+import { createRuntime } from "./runtime.mjs";
+import { pruneInputByCapabilities } from "./messages.mjs";
+import { MissingTextOutputError, OnOutputError, OutputErrorBase, OutputErrorContext, OutputErrorMode, OutputErrorResult, ParseOutputError, RepairTextOutputAction, RepairValueOutputAction, SkipOutputAction, ThrowOutputAction, ValidationOutputError } from "./output-errors.mjs";

package/dist/run/messages.d.mts

@@ -0,0 +1,8 @@
+import { Capabilities } from "../providers/types/capabilities.mjs";
+import { GenerativeModelInputItem } from "../providers/types/input.mjs";
+//#region src/run/messages.d.ts
+/** Removes replayed parts the model cannot accept. */
+declare const pruneInputByCapabilities: (input: GenerativeModelInputItem[], caps: Capabilities) => GenerativeModelInputItem[];
+//#endregion
+export { pruneInputByCapabilities };
+//# sourceMappingURL=messages.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.mts","names":[],"sources":["../../src/run/messages.ts"],"mappings":";;;;cAiHa,wBAAA,GAAwB,KAAA,EAC1B,wBAAA,IAA0B,IAAA,EAC3B,YAAA,KACP,wBAAA"}

package/dist/run/messages.mjs

@@ -0,0 +1,83 @@
+//#region src/run/messages.ts
+/** Converts run input into provider input items. */
+const normalizeInputToMessages = (input, caps) => {
+	if (typeof input === "string") return [caps.inputShape === "prompt" ? {
+		type: "message",
+		content: input
+	} : {
+		type: "message",
+		role: "user",
+		content: input
+	}];
+	return [...input];
+};
+/** Converts run input into durable conversation items. */
+const normalizeInputToConversationItems = (input, caps) => normalizeInputToMessages(input, caps).map((item) => item.type === "message" ? {
+	type: "message",
+	role: "role" in item ? item.role : "user",
+	content: item.content
+} : item);
+/** Projects durable conversation items back into provider input. */
+const projectConversationItemsToInput = (items, caps) => items.flatMap((item) => {
+	switch (item.type) {
+		case "message": {
+			const projectedContent = typeof item.content === "string" ? item.content : item.content.map((part) => {
+				switch (part.type) {
+					case "text":
+					case "image":
+					case "audio":
+					case "video":
+					case "file":
+					case "embedding":
+					case "transcript":
+					case "reasoning": return part;
+				}
+			}).filter((part) => part !== null);
+			if (projectedContent === null) return [];
+			if (Array.isArray(projectedContent) && projectedContent.length === 0) return [];
+			return [caps.inputShape === "prompt" ? {
+				type: "message",
+				content: projectedContent
+			} : {
+				type: "message",
+				role: item.role,
+				content: projectedContent
+			}];
+		}
+		case "tool-call": return "result" in item ? [item] : [];
+		case "provider-tool-result": return [item];
+	}
+});
+/** Removes replayed parts the model cannot accept. */
+const pruneInputByCapabilities = (input, caps) => {
+	const textSupported = caps.inputModalities?.text !== false;
+	const isSupportedPart = (part) => {
+		switch (part.type) {
+			case "text":
+			case "transcript":
+			case "reasoning": return textSupported;
+			case "image":
+			case "audio":
+			case "video":
+			case "file":
+			case "embedding": return caps.inputModalities?.[part.type] === true;
+		}
+	};
+	const pruneMessage = (message) => {
+		if (typeof message.content === "string") return textSupported ? [message] : [];
+		const content = message.content.filter(isSupportedPart);
+		if (content.length === 0) return [];
+		return [{
+			...message,
+			content
+		}];
+	};
+	return input.flatMap((item) => {
+		if (item.type !== "message") return [item];
+		return pruneMessage(item);
+	});
+};
+
+//#endregion
+export { normalizeInputToConversationItems, normalizeInputToMessages, projectConversationItemsToInput, pruneInputByCapabilities };
+//# sourceMappingURL=messages.mjs.map

package/dist/run/messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.mjs","names":[],"sources":["../../src/run/messages.ts"],"sourcesContent":["import type {\n    AudioContentBase,\n    Capabilities,\n    ConversationItem,\n    ConversationMessage,\n    EmbeddingContentBase,\n    FileContentBase,\n    GenerativeModelInput,\n    GenerativeModelInputItem,\n    GenerativeModelInputMessage,\n    GenerativeModelInputMessageContent,\n    GenerativeModelToolCallResult,\n    ImageContentBase,\n    ReasoningContentBase,\n    TextContentBase,\n    TranscriptContentBase,\n    VideoContentBase,\n} from \"../providers\";\n\n/** Converts run input into provider input items. */\nexport const normalizeInputToMessages = (\n    input: GenerativeModelInput,\n    caps: Capabilities,\n): GenerativeModelInputItem[] => {\n    if (typeof input === \"string\") {\n        return [\n            caps.inputShape === \"prompt\"\n                ? {\n                      type: \"message\",\n                      content: input,\n                  }\n                : {\n                      type: \"message\",\n                      role: \"user\",\n                      content: input,\n                  },\n        ] as GenerativeModelInputItem[];\n    }\n\n    return [...input];\n};\n\n/** Converts run input into durable conversation items. */\nexport const normalizeInputToConversationItems = (\n    input: GenerativeModelInput,\n    caps: Capabilities,\n): ConversationItem[] =>\n    normalizeInputToMessages(input, caps).map((item) =>\n        item.type === \"message\"\n            ? ({\n                  type: \"message\",\n                  role: \"role\" in item ? item.role : \"user\",\n                  content: item.content,\n              } satisfies ConversationMessage)\n            : item,\n    );\n\n/** Projects durable conversation items back into provider input. */\nexport const projectConversationItemsToInput = (\n    items: ConversationItem[],\n    caps: Capabilities,\n): GenerativeModelInputItem[] =>\n    items.flatMap((item) => {\n        switch (item.type) {\n            case \"message\": {\n                const projectedContent =\n                    typeof item.content === \"string\"\n                        ? item.content\n                        : (item.content\n                              .map((part) => {\n                                  switch (part.type) {\n                                      case \"text\":\n                                      case \"image\":\n                                      case \"audio\":\n                                      case \"video\":\n                                      case \"file\":\n                                      case \"embedding\":\n                                      case \"transcript\":\n                                      case \"reasoning\":\n                                          return part;\n                                  }\n                              })\n                              .filter(\n                                  (part) => part !== null,\n                              ) as GenerativeModelInputMessageContent);\n                if (projectedContent === null) {\n                    return [];\n                }\n                if (Array.isArray(projectedContent) && projectedContent.length === 0) {\n                    return [];\n                }\n\n                return [\n                    caps.inputShape === \"prompt\"\n                        ? ({\n                              type: \"message\",\n                              content: projectedContent,\n                          } as GenerativeModelInputItem)\n                        : ({\n                              type: \"message\",\n                              role: item.role,\n                              content: projectedContent,\n                          } as GenerativeModelInputItem),\n                ];\n            }\n            case \"tool-call\":\n                return \"result\" in item ? [item as GenerativeModelToolCallResult] : [];\n            case \"provider-tool-result\":\n                return [item];\n        }\n    });\n\n/** Removes replayed parts the model cannot accept. */\nexport const pruneInputByCapabilities = (\n    input: GenerativeModelInputItem[],\n    caps: Capabilities,\n): GenerativeModelInputItem[] => {\n    const textSupported = caps.inputModalities?.text !== false;\n\n    const isSupportedPart = (\n        part:\n            | TextContentBase\n            | TranscriptContentBase\n            | ReasoningContentBase\n            | ImageContentBase\n            | AudioContentBase\n            | VideoContentBase\n            | FileContentBase\n            | EmbeddingContentBase,\n    ): boolean => {\n        switch (part.type) {\n            case \"text\":\n            case \"transcript\":\n            case \"reasoning\":\n                return textSupported;\n            case \"image\":\n            case \"audio\":\n            case \"video\":\n            case \"file\":\n            case \"embedding\":\n                return caps.inputModalities?.[part.type] === true;\n        }\n    };\n\n    const pruneMessage = (message: GenerativeModelInputMessage): GenerativeModelInputItem[] => {\n        if (typeof message.content === \"string\") {\n            return textSupported ? [message] : [];\n        }\n\n        const content = message.content.filter(isSupportedPart);\n        if (content.length === 0) {\n            return [];\n        }\n\n        return [{ ...message, content }];\n    };\n\n    return input.flatMap((item) => {\n        if (item.type !== \"message\") {\n            return [item];\n        }\n\n        return pruneMessage(item);\n    });\n};\n"],"mappings":";;AAoBA,MAAa,4BACT,OACA,SAC6B;AAC7B,KAAI,OAAO,UAAU,SACjB,QAAO,CACH,KAAK,eAAe,WACd;EACI,MAAM;EACN,SAAS;EACZ,GACD;EACI,MAAM;EACN,MAAM;EACN,SAAS;EACZ,CACV;AAGL,QAAO,CAAC,GAAG,MAAM;;;AAIrB,MAAa,qCACT,OACA,SAEA,yBAAyB,OAAO,KAAK,CAAC,KAAK,SACvC,KAAK,SAAS,YACP;CACG,MAAM;CACN,MAAM,UAAU,OAAO,KAAK,OAAO;CACnC,SAAS,KAAK;CACjB,GACD,KACT;;AAGL,MAAa,mCACT,OACA,SAEA,MAAM,SAAS,SAAS;AACpB,SAAQ,KAAK,MAAb;EACI,KAAK,WAAW;GACZ,MAAM,mBACF,OAAO,KAAK,YAAY,WAClB,KAAK,UACJ,KAAK,QACD,KAAK,SAAS;AACX,YAAQ,KAAK,MAAb;KACI,KAAK;KACL,KAAK;KACL,KAAK;KACL,KAAK;KACL,KAAK;KACL,KAAK;KACL,KAAK;KACL,KAAK,YACD,QAAO;;KAEjB,CACD,QACI,SAAS,SAAS,KACtB;AACf,OAAI,qBAAqB,KACrB,QAAO,EAAE;AAEb,OAAI,MAAM,QAAQ,iBAAiB,IAAI,iBAAiB,WAAW,EAC/D,QAAO,EAAE;AAGb,UAAO,CACH,KAAK,eAAe,WACb;IACG,MAAM;IACN,SAAS;IACZ,GACA;IACG,MAAM;IACN,MAAM,KAAK;IACX,SAAS;IACZ,CACV;;EAEL,KAAK,YACD,QAAO,YAAY,OAAO,CAAC,KAAsC,GAAG,EAAE;EAC1E,KAAK,uBACD,QAAO,CAAC,KAAK;;EAEvB;;AAGN,MAAa,4BACT,OACA,SAC6B;CAC7B,MAAM,gBAAgB,KAAK,iBAAiB,SAAS;CAErD,MAAM,mBACF,SASU;AACV,UAAQ,KAAK,MAAb;GACI,KAAK;GACL,KAAK;GACL,KAAK,YACD,QAAO;GACX,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK;GACL,KAAK,YACD,QAAO,KAAK,kBAAkB,KAAK,UAAU;;;CAIzD,MAAM,gBAAgB,YAAqE;AACvF,MAAI,OAAO,QAAQ,YAAY,SAC3B,QAAO,gBAAgB,CAAC,QAAQ,GAAG,EAAE;EAGzC,MAAM,UAAU,QAAQ,QAAQ,OAAO,gBAAgB;AACvD,MAAI,QAAQ,WAAW,EACnB,QAAO,EAAE;AAGb,SAAO,CAAC;GAAE,GAAG;GAAS;GAAS,CAAC;;AAGpC,QAAO,MAAM,SAAS,SAAS;AAC3B,MAAI,KAAK,SAAS,UACd,QAAO,CAAC,KAAK;AAGjB,SAAO,aAAa,KAAK;GAC3B"}

package/dist/run/model-strategy.mjs

@@ -0,0 +1,105 @@
+import { BetterAgentError } from "@better-agent/shared/errors";
+
+//#region src/run/model-strategy.ts
+const getAssistantMessageIdFromEvent = (event) => {
+	if ("parentMessageId" in event && typeof event.parentMessageId === "string" && event.parentMessageId.length > 0) return event.parentMessageId;
+	if ("messageId" in event && typeof event.messageId === "string" && event.messageId.length > 0 && "role" in event && event.role === "assistant") return event.messageId;
+};
+const createRunModelCallStrategy = () => ({
+	mode: "run",
+	async call(params) {
+		const { options } = params;
+		let firstGeneratedMessageId;
+		let assistantMessageId;
+		const generateMessageId = () => {
+			const id = options.generateMessageId();
+			firstGeneratedMessageId ??= id;
+			return id;
+		};
+		const modelContext = {
+			runId: params.runId,
+			agentName: params.agentName,
+			providerId: options.agent.model.providerId,
+			modelId: options.agent.model.modelId,
+			signal: options.signal,
+			generateMessageId,
+			conversationId: params.conversationId
+		};
+		if (!options.agent.model.doGenerate) throw BetterAgentError.fromCode("NOT_IMPLEMENTED", `Model '${options.agent.model.modelId}' does not implement doGenerate().`, {
+			context: {
+				agentName: params.agentName,
+				modelId: options.agent.model.modelId
+			},
+			trace: [{ at: "core.run.runLoop.model.doGenerate" }]
+		});
+		const responseResult = await options.agent.model.doGenerate({
+			...options.modelOptions ?? {},
+			input: params.modelInput,
+			modalities: options.modalities,
+			tools: params.tools.length > 0 ? params.tools : void 0,
+			toolChoice: params.toolChoice,
+			structured_output: options.structuredOutput
+		}, modelContext);
+		if (responseResult.isErr()) throw responseResult.error;
+		const { response, events } = responseResult.value;
+		for (const event of events ?? []) {
+			assistantMessageId = getAssistantMessageIdFromEvent(event) ?? assistantMessageId;
+			await options.emit({ ...event });
+		}
+		return {
+			response,
+			assistantMessageId: assistantMessageId ?? firstGeneratedMessageId ?? generateMessageId()
+		};
+	}
+});
+const createStreamModelCallStrategy = () => ({
+	mode: "stream",
+	async call(params) {
+		const { options } = params;
+		let firstGeneratedMessageId;
+		let assistantMessageId;
+		const generateMessageId = () => {
+			const id = options.generateMessageId();
+			firstGeneratedMessageId ??= id;
+			return id;
+		};
+		const modelContext = {
+			runId: params.runId,
+			agentName: params.agentName,
+			providerId: options.agent.model.providerId,
+			modelId: options.agent.model.modelId,
+			signal: options.signal,
+			generateMessageId,
+			conversationId: params.conversationId
+		};
+		if (!options.agent.model.doGenerateStream) throw BetterAgentError.fromCode("NOT_IMPLEMENTED", `Model '${options.agent.model.modelId}' does not implement doGenerateStream().`, {
+			context: {
+				agentName: params.agentName,
+				modelId: options.agent.model.modelId
+			},
+			trace: [{ at: "core.run.runStreamLoop.model.doGenerateStream" }]
+		});
+		const streamResult = await options.agent.model.doGenerateStream({
+			...options.modelOptions ?? {},
+			input: params.modelInput,
+			modalities: options.modalities,
+			tools: params.tools.length > 0 ? params.tools : void 0,
+			toolChoice: params.toolChoice,
+			structured_output: options.structuredOutput
+		}, modelContext);
+		if (streamResult.isErr()) throw streamResult.error;
+		for await (const eventResult of streamResult.value.events) {
+			if (eventResult.isErr()) throw eventResult.error;
+			assistantMessageId = getAssistantMessageIdFromEvent(eventResult.value) ?? assistantMessageId;
+			await options.emit({ ...eventResult.value });
+		}
+		return {
+			response: await streamResult.value.final,
+			assistantMessageId: assistantMessageId ?? firstGeneratedMessageId ?? generateMessageId()
+		};
+	}
+});
+
+//#endregion
+export { createRunModelCallStrategy, createStreamModelCallStrategy };
+//# sourceMappingURL=model-strategy.mjs.map

package/dist/run/model-strategy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-strategy.mjs","names":[],"sources":["../../src/run/model-strategy.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport type { Event } from \"../events\";\nimport type { ModelCallStrategy } from \"./types\";\n\nconst getAssistantMessageIdFromEvent = (event: Event): string | undefined => {\n    if (\n        \"parentMessageId\" in event &&\n        typeof event.parentMessageId === \"string\" &&\n        event.parentMessageId.length > 0\n    ) {\n        return event.parentMessageId;\n    }\n\n    if (\n        \"messageId\" in event &&\n        typeof event.messageId === \"string\" &&\n        event.messageId.length > 0 &&\n        \"role\" in event &&\n        event.role === \"assistant\"\n    ) {\n        return event.messageId;\n    }\n\n    return undefined;\n};\n\nexport const createRunModelCallStrategy = <TContext>(): ModelCallStrategy<TContext> => ({\n    mode: \"run\",\n    async call(params) {\n        const { options } = params;\n        let firstGeneratedMessageId: string | undefined;\n        let assistantMessageId: string | undefined;\n        const generateMessageId = () => {\n            const id = options.generateMessageId();\n            firstGeneratedMessageId ??= id;\n            return id;\n        };\n\n        const modelContext = {\n            runId: params.runId,\n            agentName: params.agentName,\n            providerId: options.agent.model.providerId,\n            modelId: options.agent.model.modelId,\n            signal: options.signal,\n            generateMessageId,\n            conversationId: params.conversationId,\n        };\n\n        if (!options.agent.model.doGenerate) {\n            throw BetterAgentError.fromCode(\n                \"NOT_IMPLEMENTED\",\n                `Model '${options.agent.model.modelId}' does not implement doGenerate().`,\n                {\n                    context: {\n                        agentName: params.agentName,\n                        modelId: options.agent.model.modelId,\n                    },\n                    trace: [{ at: \"core.run.runLoop.model.doGenerate\" }],\n                },\n            );\n        }\n\n        const responseResult = await options.agent.model.doGenerate(\n            {\n                ...(options.modelOptions ?? {}),\n                input: params.modelInput,\n                modalities: options.modalities,\n                tools: params.tools.length > 0 ? params.tools : undefined,\n                toolChoice: params.toolChoice,\n                structured_output: options.structuredOutput,\n            },\n            modelContext,\n        );\n        if (responseResult.isErr()) {\n            throw responseResult.error;\n        }\n\n        const { response, events } = responseResult.value;\n        for (const event of events ?? []) {\n            assistantMessageId = getAssistantMessageIdFromEvent(event) ?? assistantMessageId;\n            await options.emit({\n                ...event,\n            });\n        }\n\n        return {\n            response,\n            // Prefer the provider ID, then reuse or generate one.\n            assistantMessageId:\n                assistantMessageId ?? firstGeneratedMessageId ?? generateMessageId(),\n        };\n    },\n});\n\nexport const createStreamModelCallStrategy = <TContext>(): ModelCallStrategy<TContext> => ({\n    mode: \"stream\",\n    async call(params) {\n        const { options } = params;\n        let firstGeneratedMessageId: string | undefined;\n        let assistantMessageId: string | undefined;\n        const generateMessageId = () => {\n            const id = options.generateMessageId();\n            firstGeneratedMessageId ??= id;\n            return id;\n        };\n\n        const modelContext = {\n            runId: params.runId,\n            agentName: params.agentName,\n            providerId: options.agent.model.providerId,\n            modelId: options.agent.model.modelId,\n            signal: options.signal,\n            generateMessageId,\n            conversationId: params.conversationId,\n        };\n\n        if (!options.agent.model.doGenerateStream) {\n            throw BetterAgentError.fromCode(\n                \"NOT_IMPLEMENTED\",\n                `Model '${options.agent.model.modelId}' does not implement doGenerateStream().`,\n                {\n                    context: {\n                        agentName: params.agentName,\n                        modelId: options.agent.model.modelId,\n                    },\n                    trace: [{ at: \"core.run.runStreamLoop.model.doGenerateStream\" }],\n                },\n            );\n        }\n\n        const streamResult = await options.agent.model.doGenerateStream(\n            {\n                ...(options.modelOptions ?? {}),\n                input: params.modelInput,\n                modalities: options.modalities,\n                tools: params.tools.length > 0 ? params.tools : undefined,\n                toolChoice: params.toolChoice,\n                structured_output: options.structuredOutput,\n            },\n            modelContext,\n        );\n\n        if (streamResult.isErr()) {\n            throw streamResult.error;\n        }\n\n        for await (const eventResult of streamResult.value.events) {\n            if (eventResult.isErr()) {\n                throw eventResult.error;\n            }\n\n            assistantMessageId =\n                getAssistantMessageIdFromEvent(eventResult.value) ?? assistantMessageId;\n            await options.emit({\n                ...eventResult.value,\n            });\n        }\n\n        return {\n            response: await streamResult.value.final,\n            // Prefer the provider ID, then reuse or generate one.\n            assistantMessageId:\n                assistantMessageId ?? firstGeneratedMessageId ?? generateMessageId(),\n        };\n    },\n});\n"],"mappings":"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"}

package/dist/run/output-errors.d.mts

@@ -0,0 +1,75 @@
+import { Awaitable } from "../internal/types.mjs";
+
+//#region src/run/output-errors.d.ts
+/**
+ * Default handling mode for structured output finalization failures.
+ */
+type OutputErrorMode = "repair" | "throw";
+/**
+ * Shared context for structured output finalization failures.
+ */
+interface OutputErrorBase {
+  error: unknown;
+}
+/**
+ * The model did not return any non-empty text to parse as structured output.
+ */
+interface MissingTextOutputError extends OutputErrorBase {
+  errorKind: "missing_text";
+}
+/**
+ * The model returned text, but it could not be parsed as valid JSON.
+ */
+interface ParseOutputError extends OutputErrorBase {
+  errorKind: "parse";
+  text: string;
+}
+/**
+ * The model returned valid JSON text, but the parsed value failed schema validation.
+ */
+interface ValidationOutputError extends OutputErrorBase {
+  errorKind: "validation";
+  text: string;
+  value: unknown;
+}
+/**
+ * Union of all recoverable structured output finalization failures.
+ */
+type OutputErrorContext = MissingTextOutputError | ParseOutputError | ValidationOutputError;
+/**
+ * Skips custom recovery and uses the runtime default behavior.
+ */
+interface SkipOutputAction {
+  action: "skip";
+}
+/**
+ * Re-throws the original structured output finalization error.
+ */
+interface ThrowOutputAction {
+  action: "throw";
+}
+/**
+ * Provides replacement JSON text to parse and validate again.
+ */
+interface RepairTextOutputAction {
+  action: "repair_text";
+  text: string;
+}
+/**
+ * Provides a replacement parsed value to validate directly.
+ */
+interface RepairValueOutputAction {
+  action: "repair_value";
+  value: unknown;
+}
+/**
+ * Actions that can be returned from {@link OnOutputError}.
+ */
+type OutputErrorResult = SkipOutputAction | ThrowOutputAction | RepairTextOutputAction | RepairValueOutputAction | undefined;
+/**
+ * Hook for customizing structured output finalization failures.
+ */
+type OnOutputError = (context: OutputErrorContext) => Awaitable<OutputErrorResult>;
+//#endregion
+export { MissingTextOutputError, OnOutputError, OutputErrorBase, OutputErrorContext, OutputErrorMode, OutputErrorResult, ParseOutputError, RepairTextOutputAction, RepairValueOutputAction, SkipOutputAction, ThrowOutputAction, ValidationOutputError };
+//# sourceMappingURL=output-errors.d.mts.map

package/dist/run/output-errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-errors.d.mts","names":[],"sources":["../../src/run/output-errors.ts"],"mappings":";;;;;AAKA;KAAY,eAAA;;;;UAKK,eAAA;EACb,KAAA;AAAA;;;AAMJ;UAAiB,sBAAA,SAA+B,eAAA;EAC5C,SAAA;AAAA;;AAMJ;;UAAiB,gBAAA,SAAyB,eAAA;EACtC,SAAA;EACA,IAAA;AAAA;;;;UAMa,qBAAA,SAA8B,eAAA;EAC3C,SAAA;EACA,IAAA;EACA,KAAA;AAAA;;;;KAMQ,kBAAA,GAAqB,sBAAA,GAAyB,gBAAA,GAAmB,qBAAA;;AAA7E;;UAKiB,gBAAA;EACb,MAAA;AAAA;;;;UAMa,iBAAA;EACb,MAAA;AAAA;;;AARJ;UAciB,sBAAA;EACb,MAAA;EACA,IAAA;AAAA;AATJ;;;AAAA,UAeiB,uBAAA;EACb,MAAA;EACA,KAAA;AAAA;;;;KAMQ,iBAAA,GACN,gBAAA,GACA,iBAAA,GACA,sBAAA,GACA,uBAAA;;;;KAMM,aAAA,IAAiB,OAAA,EAAS,kBAAA,KAAuB,SAAA,CAAU,iBAAA"}

package/dist/run/pending-tools.d.mts

@@ -0,0 +1 @@
+export { };

package/dist/run/pending-tools.mjs

@@ -0,0 +1,185 @@
+import { BetterAgentError } from "@better-agent/shared/errors";
+
+//#region src/run/pending-tools.ts
+const createPendingToolRuntime = () => {
+	const pendingClientToolCalls = /* @__PURE__ */ new Map();
+	const pendingApprovals = /* @__PURE__ */ new Map();
+	const removePendingEntry = (entries, runId, toolCallId) => {
+		const runPending = entries.get(runId);
+		if (!runPending) return;
+		runPending.delete(toolCallId);
+		if (runPending.size === 0) entries.delete(runId);
+	};
+	return {
+		awaitClientToolResult(params) {
+			return new Promise((resolve, reject) => {
+				const timeoutMs = params.timeoutMs ?? 3e4;
+				const runPending = pendingClientToolCalls.get(params.runId) ?? /* @__PURE__ */ new Map();
+				pendingClientToolCalls.set(params.runId, runPending);
+				if (runPending.has(params.toolCallId)) {
+					reject(BetterAgentError.fromCode("VALIDATION_FAILED", `Client tool '${params.toolName}' call '${params.toolCallId}' is already pending.`, {
+						context: {
+							runId: params.runId,
+							toolName: params.toolName,
+							toolCallId: params.toolCallId
+						},
+						trace: [{ at: "core.run.pendingTools.awaitClientToolResult" }]
+					}));
+					return;
+				}
+				const onAbort = () => {
+					cleanup();
+					reject(createAbortError(`Run '${params.runId}' was aborted while waiting for client tool result for '${params.toolName}'.`, {
+						runId: params.runId,
+						toolName: params.toolName,
+						toolCallId: params.toolCallId
+					}));
+				};
+				const cleanup = () => {
+					clearTimeout(timeout);
+					params.signal?.removeEventListener("abort", onAbort);
+					removePendingEntry(pendingClientToolCalls, params.runId, params.toolCallId);
+				};
+				const timeout = setTimeout(() => {
+					cleanup();
+					reject(BetterAgentError.fromCode("TIMEOUT", `Timed out waiting for client tool result for '${params.toolName}'.`, {
+						context: {
+							runId: params.runId,
+							toolName: params.toolName,
+							toolCallId: params.toolCallId
+						},
+						trace: [{ at: "core.run.pendingTools.awaitClientToolResult" }]
+					}));
+				}, timeoutMs);
+				if (params.signal?.aborted) {
+					onAbort();
+					return;
+				}
+				params.signal?.addEventListener("abort", onAbort, { once: true });
+				runPending.set(params.toolCallId, {
+					resolve: (value) => {
+						cleanup();
+						resolve(value);
+					},
+					reject: (error) => {
+						cleanup();
+						reject(error);
+					}
+				});
+			});
+		},
+		awaitToolApproval(params) {
+			return new Promise((resolve, reject) => {
+				const timeoutMs = params.timeoutMs ?? 3e4;
+				const runPending = pendingApprovals.get(params.runId) ?? /* @__PURE__ */ new Map();
+				pendingApprovals.set(params.runId, runPending);
+				if (runPending.has(params.toolCallId)) {
+					reject(BetterAgentError.fromCode("VALIDATION_FAILED", `Tool '${params.toolName}' call '${params.toolCallId}' is already pending approval.`, {
+						context: {
+							runId: params.runId,
+							toolName: params.toolName,
+							toolCallId: params.toolCallId
+						},
+						trace: [{ at: "core.run.pendingTools.awaitToolApproval" }]
+					}));
+					return;
+				}
+				const cleanup = () => {
+					clearTimeout(timeout);
+					params.signal?.removeEventListener("abort", onAbort);
+					removePendingEntry(pendingApprovals, params.runId, params.toolCallId);
+				};
+				const onAbort = () => {
+					cleanup();
+					reject(createAbortError(`Run '${params.runId}' was aborted while waiting for approval of '${params.toolName}'.`, {
+						runId: params.runId,
+						toolName: params.toolName,
+						toolCallId: params.toolCallId
+					}));
+				};
+				const timeout = setTimeout(() => {
+					cleanup();
+					reject(BetterAgentError.fromCode("TIMEOUT", `Timed out waiting for approval of '${params.toolName}'.`, {
+						context: {
+							runId: params.runId,
+							toolName: params.toolName,
+							toolCallId: params.toolCallId
+						},
+						trace: [{ at: "core.run.pendingTools.awaitToolApproval" }]
+					}));
+				}, timeoutMs);
+				if (params.signal?.aborted) {
+					onAbort();
+					return;
+				}
+				params.signal?.addEventListener("abort", onAbort, { once: true });
+				runPending.set(params.toolCallId, {
+					resolve: (value) => {
+						cleanup();
+						resolve(value);
+					},
+					reject: (error) => {
+						cleanup();
+						reject(error);
+					}
+				});
+			});
+		},
+		submitToolResult(params) {
+			const runPending = pendingClientToolCalls.get(params.runId);
+			if (!runPending) return Promise.resolve(false);
+			const pending = runPending.get(params.toolCallId);
+			if (!pending) return Promise.resolve(false);
+			runPending.delete(params.toolCallId);
+			if (runPending.size === 0) pendingClientToolCalls.delete(params.runId);
+			if (params.status === "error") pending.reject(BetterAgentError.fromCode("TOOL_EXECUTION_FAILED", params.error, {
+				context: {
+					runId: params.runId,
+					toolCallId: params.toolCallId
+				},
+				trace: [{ at: "core.run.pendingTools.submitToolResult" }]
+			}));
+			else pending.resolve(params.result);
+			return Promise.resolve(true);
+		},
+		submitToolApproval(params) {
+			const runPending = pendingApprovals.get(params.runId);
+			if (!runPending) return Promise.resolve(false);
+			const pending = runPending.get(params.toolCallId);
+			if (!pending) return Promise.resolve(false);
+			runPending.delete(params.toolCallId);
+			if (runPending.size === 0) pendingApprovals.delete(params.runId);
+			const result = { decision: params.decision };
+			if (params.note !== void 0) result.note = params.note;
+			if (params.actorId !== void 0) result.actorId = params.actorId;
+			pending.resolve(result);
+			return Promise.resolve(true);
+		},
+		clearRun(runId, reason) {
+			const clientToolCalls = pendingClientToolCalls.get(runId);
+			if (clientToolCalls) {
+				for (const [toolCallId, pending] of clientToolCalls) pending.reject(createAbortError(`Run '${runId}' was cleared: ${reason}`, {
+					runId,
+					toolCallId
+				}));
+				pendingClientToolCalls.delete(runId);
+			}
+			const approvals = pendingApprovals.get(runId);
+			if (approvals) {
+				for (const [toolCallId, pending] of approvals) pending.reject(createAbortError(`Run '${runId}' was cleared: ${reason}`, {
+					runId,
+					toolCallId
+				}));
+				pendingApprovals.delete(runId);
+			}
+		}
+	};
+};
+const createAbortError = (message, context) => BetterAgentError.fromCode("ABORTED", message, {
+	context,
+	trace: [{ at: "core.run.pendingTools.clearRun" }]
+});
+
+//#endregion
+export { createPendingToolRuntime };
+//# sourceMappingURL=pending-tools.mjs.map