@better-agent/core 0.1.0-beta.1

package/dist/run/helpers.mjs

@@ -0,0 +1,466 @@
+import { resolveToJsonSchema, validateInput } from "../schema/resolve-json-schema.mjs";
+import { getPreflightedOutputSchema } from "../agent/validation.mjs";
+import { createIdGenerator } from "../internal/id.mjs";
+import { normalizeInputToConversationItems, normalizeInputToMessages, projectConversationItemsToInput, pruneInputByCapabilities } from "./messages.mjs";
+import { BetterAgentError } from "@better-agent/shared/errors";
+import { isPlainRecord, safeJsonParse } from "@better-agent/shared/utils";
+
+//#region src/run/helpers.ts
+const MAX_OUTPUT_REPAIR_DEPTH = 2;
+const isJsonSchemaRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const normalizeStructuredOutputJsonSchema = (schema) => {
+	const normalized = {};
+	for (const [key, value] of Object.entries(schema)) {
+		if (Array.isArray(value)) {
+			normalized[key] = value.map((item) => isJsonSchemaRecord(item) ? normalizeStructuredOutputJsonSchema(item) : item);
+			continue;
+		}
+		normalized[key] = isJsonSchemaRecord(value) ? normalizeStructuredOutputJsonSchema(value) : value;
+	}
+	if ((normalized.type === "object" || isJsonSchemaRecord(normalized.properties) || Array.isArray(normalized.required)) && normalized.additionalProperties === void 0) normalized.additionalProperties = false;
+	return normalized;
+};
+/** Creates an emitter that persists stream events. */
+function createStreamPersistenceEmitter(params) {
+	const stream = params.stream;
+	if (!stream) return;
+	let nextSeq = 0;
+	return async (event) => {
+		const streamEvent = {
+			...event,
+			seq: nextSeq++,
+			timestamp: event.timestamp ?? Date.now()
+		};
+		try {
+			await stream.append(params.streamId, streamEvent);
+		} catch (error) {
+			if (error instanceof Error && error.message.includes("not found")) return;
+			throw error;
+		}
+	};
+}
+/** Converts `onEvent` into an internal emitter. */
+function toEventEmitter(onEvent) {
+	if (!onEvent) return async () => {};
+	return async (event) => {
+		await onEvent(event);
+	};
+}
+/** Validates run context against the agent schema. */
+async function validateAgentContext(agent, context) {
+	if (!agent.contextSchema) return context;
+	const validated = await validateInput(agent.contextSchema, context, { invalidMessage: "The provided data is invalid according to context schema." });
+	if (validated.isErr()) throw validated.error.at({ at: "core.run.validateAgentContext" });
+	return validated.value;
+}
+const throwInvalidStoredConversationItem = (conversationId, index) => {
+	throw BetterAgentError.fromCode("VALIDATION_FAILED", "Loaded conversation items are invalid.", {
+		context: {
+			conversationId,
+			index
+		},
+		trace: [{ at: "core.run.validateStoredConversationItems" }]
+	});
+};
+const isConversationPart = (part) => {
+	if (!isPlainRecord(part) || typeof part.type !== "string") return false;
+	switch (part.type) {
+		case "text": return typeof part.text === "string";
+		case "reasoning": return typeof part.text === "string" && (part.visibility === "summary" || part.visibility === "full") && (part.provider === void 0 || typeof part.provider === "string");
+		case "transcript": return typeof part.text === "string" && (part.segments === void 0 || Array.isArray(part.segments) && part.segments.every((segment) => isPlainRecord(segment) && typeof segment.id === "string" && typeof segment.start === "number" && typeof segment.end === "number" && typeof segment.text === "string" && (segment.speaker === void 0 || typeof segment.speaker === "string")));
+		case "image":
+		case "audio":
+		case "video":
+		case "file": return isPlainRecord(part.source);
+		case "embedding": return Array.isArray(part.embedding);
+		default: return false;
+	}
+};
+const validateStoredConversationItems = (items, conversationId) => {
+	for (const [index, item] of items.entries()) {
+		if (!isPlainRecord(item) || typeof item.type !== "string") throwInvalidStoredConversationItem(conversationId, index);
+		if (item.type === "message") {
+			if (typeof item.role !== "string" || !(typeof item.content === "string" || Array.isArray(item.content) && item.content.every((part) => isConversationPart(part)))) throwInvalidStoredConversationItem(conversationId, index);
+			continue;
+		}
+		if (item.type === "tool-call") {
+			if (typeof item.name !== "string" || typeof item.callId !== "string" || !("result" in item) && typeof item.arguments !== "string") throwInvalidStoredConversationItem(conversationId, index);
+			continue;
+		}
+		if (item.type === "provider-tool-result" && typeof item.name === "string" && typeof item.callId === "string") continue;
+		throwInvalidStoredConversationItem(conversationId, index);
+	}
+};
+const throwUnsupportedInputModality = (params) => {
+	throw BetterAgentError.fromCode("VALIDATION_FAILED", `Agent '${params.agent.name}' model does not accept ${params.modality} input at ${params.location}.`, {
+		context: {
+			agentName: params.agent.name,
+			modelId: params.agent.model.modelId,
+			modality: params.modality,
+			location: params.location
+		},
+		trace: [{ at: params.traceAt }]
+	});
+};
+const validateMessageContentCapabilities = (params) => {
+	const caps = params.agent.model.caps;
+	if (typeof params.content === "string") {
+		if (caps.inputModalities?.text === false) throwUnsupportedInputModality({
+			agent: params.agent,
+			modality: "text",
+			location: `input[${params.itemIndex}].content`,
+			traceAt: params.traceAt
+		});
+		return;
+	}
+	if (!Array.isArray(params.content)) return;
+	for (const [partIndex, part] of params.content.entries()) {
+		if (typeof part !== "object" || part === null || !("type" in part)) continue;
+		const partType = part.type;
+		if (partType === "text" || partType === "transcript" || partType === "reasoning") {
+			if (caps.inputModalities?.text === false) throwUnsupportedInputModality({
+				agent: params.agent,
+				modality: "text",
+				location: `input[${params.itemIndex}].content[${partIndex}]`,
+				traceAt: params.traceAt
+			});
+			continue;
+		}
+		if (partType === "image" || partType === "audio" || partType === "video" || partType === "file" || partType === "embedding") {
+			const modality = partType;
+			if (caps.inputModalities?.[modality] !== true) throwUnsupportedInputModality({
+				agent: params.agent,
+				modality,
+				location: `input[${params.itemIndex}].content[${partIndex}]`,
+				traceAt: params.traceAt
+			});
+		}
+	}
+};
+const isReplayInputPart = (part) => {
+	if (!isPlainRecord(part) || typeof part.type !== "string") return false;
+	switch (part.type) {
+		case "text": return typeof part.text === "string";
+		case "reasoning": return typeof part.text === "string" && (part.visibility === "summary" || part.visibility === "full") && (part.provider === void 0 || typeof part.provider === "string");
+		case "transcript": return typeof part.text === "string" && (part.segments === void 0 || Array.isArray(part.segments) && part.segments.every((segment) => isPlainRecord(segment) && typeof segment.id === "string" && typeof segment.start === "number" && typeof segment.end === "number" && typeof segment.text === "string" && (segment.speaker === void 0 || typeof segment.speaker === "string")));
+		case "image":
+		case "audio":
+		case "video":
+		case "file": return isPlainRecord(part.source);
+		case "embedding": return Array.isArray(part.embedding) && part.embedding.every((value) => typeof value === "number");
+		default: return false;
+	}
+};
+const isReplayInputItem = (item) => {
+	if (!isPlainRecord(item) || typeof item.type !== "string") return false;
+	if (item.type === "message") {
+		if (item.role !== void 0 && typeof item.role !== "string") return false;
+		if (typeof item.content === "string") return true;
+		return Array.isArray(item.content) && item.content.every(isReplayInputPart);
+	}
+	if (item.type === "tool-call") return typeof item.name === "string" && typeof item.callId === "string" && "result" in item;
+	return item.type === "provider-tool-result" && typeof item.name === "string" && typeof item.callId === "string" && "result" in item;
+};
+const validatePreparedReplayInput = (params) => {
+	if (!Array.isArray(params.input) || !params.input.every(isReplayInputItem)) throw BetterAgentError.fromCode("VALIDATION_FAILED", "conversationReplay.prepareInput must return a valid array of model input items.", {
+		context: {
+			agentName: params.agentName,
+			conversationId: params.conversationId
+		},
+		trace: [{ at: "core.run.prepareConversationReplayInput.validatePreparedInput" }]
+	});
+	for (const item of params.input) {
+		if (item.type !== "message") continue;
+		if (params.caps.inputShape === "prompt") {
+			if ("role" in item && item.role !== void 0) throw BetterAgentError.fromCode("VALIDATION_FAILED", "conversationReplay.prepareInput returned a role-bearing message for a prompt-shaped model.", {
+				context: {
+					agentName: params.agentName,
+					conversationId: params.conversationId
+				},
+				trace: [{ at: "core.run.prepareConversationReplayInput.validatePreparedInput.promptRole" }]
+			});
+			continue;
+		}
+		if (!("role" in item) || typeof item.role !== "string") throw BetterAgentError.fromCode("VALIDATION_FAILED", "conversationReplay.prepareInput returned a role-less message for a chat-shaped model.", {
+			context: {
+				agentName: params.agentName,
+				conversationId: params.conversationId
+			},
+			trace: [{ at: "core.run.prepareConversationReplayInput.validatePreparedInput.chatRole" }]
+		});
+	}
+	return params.input;
+};
+/**
+* Validates that run input only uses modalities supported by the target model.
+*/
+function validateRunInputCapabilities(params) {
+	const caps = params.agent.model.caps;
+	if (typeof params.input === "string") {
+		if (caps.inputModalities?.text === false) throwUnsupportedInputModality({
+			agent: params.agent,
+			modality: "text",
+			location: "input",
+			traceAt: params.traceAt
+		});
+		return;
+	}
+	for (const [itemIndex, item] of params.input.entries()) {
+		if (item.type !== "message") continue;
+		validateMessageContentCapabilities({
+			agent: params.agent,
+			content: item.content,
+			itemIndex,
+			traceAt: params.traceAt
+		});
+	}
+}
+/**
+* Validates requested output modalities against the target model's capabilities.
+*/
+function validateRunModalities(params) {
+	if (!params.modalities || params.modalities.length === 0) return;
+	const caps = params.agent.model.caps;
+	for (const modality of params.modalities) {
+		if (caps.outputModalities?.[modality] !== void 0) continue;
+		throw BetterAgentError.fromCode("VALIDATION_FAILED", `Agent '${params.agent.name}' model does not support ${modality} output.`, {
+			context: {
+				agentName: params.agent.name,
+				modelId: params.agent.model.modelId,
+				modality
+			},
+			trace: [{ at: params.traceAt }]
+		});
+	}
+	if (params.output !== void 0 && !params.modalities.includes("text")) throw BetterAgentError.fromCode("VALIDATION_FAILED", `Structured output requires text output for agent '${params.agent.name}'.`, {
+		context: {
+			agentName: params.agent.name,
+			modelId: params.agent.model.modelId,
+			modalities: [...params.modalities]
+		},
+		trace: [{ at: params.traceAt }]
+	});
+}
+/**
+* Prepares replayable model input from durable conversation items for a run.
+*
+* Stored history is projected losslessly first. The run can then override that
+* projection with `prepareInput`, or fall back to capability-based pruning.
+*/
+function prepareConversationReplayInput(params) {
+	const projected = projectConversationItemsToInput(params.items, params.caps);
+	const replay = params.conversationReplay;
+	if (typeof replay?.prepareInput === "function") return Promise.resolve(replay.prepareInput({
+		items: params.items,
+		caps: params.caps,
+		agentName: params.agentName,
+		conversationId: params.conversationId
+	})).then((input) => validatePreparedReplayInput({
+		input,
+		caps: params.caps,
+		agentName: params.agentName,
+		conversationId: params.conversationId
+	}));
+	if (replay?.omitUnsupportedParts === false) return projected;
+	return pruneInputByCapabilities(projected, params.caps);
+}
+/**
+* Converts a public output schema definition into a provider request.
+*/
+function toStructuredOutputRequest(agent, output) {
+	if (output === void 0) return;
+	if (!agent.model.caps.structured_output) throw BetterAgentError.fromCode("NOT_IMPLEMENTED", `Model '${agent.model.modelId}' does not support structured output.`, {
+		context: {
+			agentName: agent.name,
+			modelId: agent.model.modelId
+		},
+		trace: [{ at: "core.run.toStructuredOutputRequest.capability" }]
+	});
+	const preflightedSchema = output === agent.outputSchema ? getPreflightedOutputSchema(agent) : void 0;
+	if (preflightedSchema !== void 0) return {
+		name: output.name ?? `${agent.name}_output`,
+		schema: normalizeStructuredOutputJsonSchema(preflightedSchema),
+		strict: output.strict
+	};
+	const runtimeResolvedSchema = resolveToJsonSchema(output.schema);
+	if (runtimeResolvedSchema.isErr()) throw runtimeResolvedSchema.error.at({ at: "core.run.toStructuredOutputRequest.resolveSchema" });
+	return {
+		name: output.name ?? `${agent.name}_output`,
+		schema: normalizeStructuredOutputJsonSchema(runtimeResolvedSchema.value),
+		strict: output.strict
+	};
+}
+/**
+* Parses and validates structured output from a provider response.
+*
+* Structured output currently requires text output.
+*/
+async function finalizeRunResult(result, output, options) {
+	if (output === void 0) return result;
+	const outputMessages = result.response.output.filter((item) => item.type === "message");
+	const resolvedOutputErrorMode = options?.outputErrorMode ?? "throw";
+	const getLastStructuredText = () => outputMessages.map((message) => typeof message.content === "string" ? message.content : message.content.filter((part) => part.type === "text").map((part) => part.text).join("")).filter((text) => text.trim().length > 0).at(-1);
+	const defaultOutputErrorBehavior = (error) => {
+		throw error;
+	};
+	const validateStructuredValue = async (value, text, repairDepth) => {
+		const validated = await validateInput(output.schema, value);
+		if (validated.isErr()) return await resolveOutputError({
+			errorKind: "validation",
+			error: validated.error.at({ at: "core.run.finalizeRunResult.validateSchema" }),
+			text,
+			value
+		}, repairDepth);
+		return validated.value;
+	};
+	const parseStructuredText = async (text, repairDepth) => {
+		const parsed = safeJsonParse(text);
+		if (parsed.isErr()) return await resolveOutputError({
+			errorKind: "parse",
+			error: BetterAgentError.wrap({
+				err: parsed.error,
+				message: "Structured output was requested, but the model returned invalid JSON.",
+				opts: {
+					code: "VALIDATION_FAILED",
+					context: { preview: text.slice(0, 200) },
+					trace: [{ at: "core.run.finalizeRunResult.parseJson" }]
+				}
+			}),
+			text
+		}, repairDepth);
+		return await validateStructuredValue(parsed.value, text, repairDepth);
+	};
+	const resolveOutputError = async (context, repairDepth) => {
+		if (resolvedOutputErrorMode === "throw" || repairDepth >= MAX_OUTPUT_REPAIR_DEPTH) return defaultOutputErrorBehavior(context.error);
+		const action = await options?.onOutputError?.(context);
+		switch (action?.action) {
+			case "repair_text": return await parseStructuredText(action.text, repairDepth + 1);
+			case "repair_value": return await validateStructuredValue(action.value, "text" in context ? context.text : "", repairDepth + 1);
+			case "throw": throw context.error;
+			default: return defaultOutputErrorBehavior(context.error);
+		}
+	};
+	const lastText = getLastStructuredText();
+	if (!lastText) {
+		const structured = await resolveOutputError({
+			errorKind: "missing_text",
+			error: BetterAgentError.fromCode("VALIDATION_FAILED", "Structured output was requested, but the model did not return JSON text.", { trace: [{ at: "core.run.finalizeRunResult.noStructuredText" }] })
+		}, 0);
+		return {
+			...result,
+			structured
+		};
+	}
+	const structured = await parseStructuredText(lastText, 0);
+	return {
+		...result,
+		structured
+	};
+}
+/**
+* Shared id generator for runs and messages.
+*/
+const generateId = createIdGenerator({ prefixes: {
+	run: "run",
+	message: "msg"
+} });
+/**
+* Loads persisted conversation history and returns:
+* - `input`: the model-facing input for this run
+* - `items`: the durable conversation state to mutate and save
+* - `loaded`: the original persisted record for save concurrency
+* - `replayStartIndex`: where the current run's replay window starts in `items`
+*
+* `replayStartIndex` is `loaded.items.length` when older history should be kept in
+* durable state but excluded from per-step replay, otherwise it is `0`.
+*/
+async function loadConversationMessages(params) {
+	const inputItems = normalizeInputToMessages(params.input, params.caps ?? { inputShape: "chat" });
+	const durableInputItems = normalizeInputToConversationItems(params.input, params.caps ?? { inputShape: "chat" });
+	if (!params.conversations || params.conversationId === void 0) return {
+		input: params.input,
+		items: durableInputItems,
+		replayStartIndex: 0,
+		conversationReplayActive: false
+	};
+	if (!params.agentName) throw BetterAgentError.fromCode("INTERNAL", "agentName is required when loading conversation messages.", {
+		context: { conversationId: params.conversationId },
+		trace: [{ at: "core.run.loadConversationMessages.missingAgentName" }]
+	});
+	const loaded = await params.conversations.load({
+		conversationId: params.conversationId,
+		agentName: params.agentName
+	});
+	if (!loaded) return {
+		input: params.input,
+		items: durableInputItems,
+		replayStartIndex: 0,
+		conversationReplayActive: false
+	};
+	validateStoredConversationItems(loaded.items, params.conversationId);
+	if (params.replaceHistory) return {
+		input: params.input,
+		items: durableInputItems,
+		replayStartIndex: 0,
+		conversationReplayActive: false,
+		loaded
+	};
+	const caps = params.caps ?? { inputShape: "chat" };
+	if ((caps.replayMode ?? (caps.inputShape === "prompt" ? "single_turn_persistent" : "multi_turn")) !== "multi_turn") return {
+		input: params.input,
+		items: [...loaded.items, ...durableInputItems],
+		replayStartIndex: loaded.items.length,
+		conversationReplayActive: false,
+		loaded
+	};
+	return {
+		input: [...await prepareConversationReplayInput({
+			items: loaded.items,
+			caps,
+			agentName: params.agentName,
+			conversationId: params.conversationId,
+			conversationReplay: params.conversationReplay
+		}), ...inputItems],
+		items: [...loaded.items, ...durableInputItems],
+		replayStartIndex: 0,
+		conversationReplayActive: true,
+		loaded
+	};
+}
+/**
+* Saves durable conversation items after a run completes.
+*/
+async function saveConversationMessages(params) {
+	if (!params.conversations || params.conversationId === void 0) return;
+	if (!params.agentName) throw BetterAgentError.fromCode("INTERNAL", "agentName is required when saving conversation messages.", {
+		context: { conversationId: params.conversationId },
+		trace: [{ at: "core.run.saveConversationMessages.missingAgentName" }]
+	});
+	try {
+		validateStoredConversationItems(params.result.items, params.conversationId);
+		await params.conversations.save({
+			conversationId: params.conversationId,
+			agentName: params.agentName,
+			items: params.result.items,
+			...params.loaded?.cursor !== void 0 ? { expectedCursor: params.loaded.cursor } : {}
+		});
+	} catch (error) {
+		throw BetterAgentError.wrap({
+			err: error,
+			message: "Failed to save conversation messages.",
+			opts: {
+				code: error instanceof BetterAgentError && error.code !== void 0 ? error.code : typeof error?.code === "string" ? error.code : "INTERNAL",
+				...typeof error?.status === "number" ? { status: error.status } : {},
+				context: {
+					conversationId: params.conversationId,
+					agentName: params.agentName
+				},
+				trace: [{ at: "core.run.saveConversationMessages" }]
+			}
+		});
+	}
+}
+
+//#endregion
+export { createStreamPersistenceEmitter, finalizeRunResult, generateId, loadConversationMessages, prepareConversationReplayInput, saveConversationMessages, toEventEmitter, toStructuredOutputRequest, validateAgentContext, validateRunInputCapabilities, validateRunModalities, validateStoredConversationItems };
+//# sourceMappingURL=helpers.mjs.map

package/dist/run/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../../src/run/helpers.ts"],"sourcesContent":["import { BetterAgentError } from \"@better-agent/shared/errors\";\nimport { isPlainRecord, safeJsonParse } from \"@better-agent/shared/utils\";\nimport type { AnyAgentDefinition } from \"../agent\";\nimport { getPreflightedOutputSchema } from \"../agent/validation\";\nimport type { Event } from \"../events\";\nimport { createIdGenerator } from \"../internal/id\";\nimport type { Awaitable } from \"../internal/types\";\nimport type {\n    ConversationStore,\n    LoadedConversation,\n    StreamEvent,\n    StreamStore,\n} from \"../persistence\";\nimport type {\n    Capabilities,\n    ConversationItem,\n    GenerativeModelInput,\n    GenerativeModelInputItem,\n    GenerativeModelInputMessageContent,\n    GenerativeModelOutputMessage,\n    Modality,\n    OutputSchemaDefinition,\n    StructuredOutput,\n} from \"../providers\";\nimport { resolveToJsonSchema, validateInput } from \"../schema\";\nimport {\n    normalizeInputToConversationItems,\n    normalizeInputToMessages,\n    projectConversationItemsToInput,\n    pruneInputByCapabilities,\n} from \"./messages\";\nimport type { OnOutputError, OutputErrorContext, OutputErrorMode } from \"./output-errors\";\nimport type { ContextBoundAgent, ConversationReplayOptions, RunOptions, RunResult } from \"./types\";\n\nconst MAX_OUTPUT_REPAIR_DEPTH = 2;\ntype NonTextInputModality = Exclude<Modality, \"text\">;\n\nconst isJsonSchemaRecord = (value: unknown): value is Record<string, unknown> =>\n    typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst normalizeStructuredOutputJsonSchema = (\n    schema: Record<string, unknown>,\n): Record<string, unknown> => {\n    const normalized: Record<string, unknown> = {};\n\n    for (const [key, value] of Object.entries(schema)) {\n        if (Array.isArray(value)) {\n            normalized[key] = value.map((item) =>\n                isJsonSchemaRecord(item) ? normalizeStructuredOutputJsonSchema(item) : item,\n            );\n            continue;\n        }\n\n        normalized[key] = isJsonSchemaRecord(value)\n            ? normalizeStructuredOutputJsonSchema(value)\n            : value;\n    }\n\n    const objectLike =\n        normalized.type === \"object\" ||\n        isJsonSchemaRecord(normalized.properties) ||\n        Array.isArray(normalized.required);\n\n    if (objectLike && normalized.additionalProperties === undefined) {\n        normalized.additionalProperties = false;\n    }\n\n    return normalized;\n};\n\n/** Creates an emitter that persists stream events. */\nexport function createStreamPersistenceEmitter(params: {\n    stream?: StreamStore;\n    streamId: string;\n}): ((event: Event) => Promise<void>) | undefined {\n    const stream = params.stream;\n    if (!stream) {\n        return undefined;\n    }\n\n    let nextSeq = 0;\n\n    return async (event: Event) => {\n        const streamEvent: StreamEvent = {\n            ...event,\n            seq: nextSeq++,\n            timestamp: event.timestamp ?? Date.now(),\n        };\n        try {\n            await stream.append(params.streamId, streamEvent);\n        } catch (error) {\n            if (error instanceof Error && error.message.includes(\"not found\")) {\n                return;\n            }\n            throw error;\n        }\n    };\n}\n\n/** Converts `onEvent` into an internal emitter. */\nexport function toEventEmitter(onEvent?: RunOptions[\"onEvent\"]): (event: Event) => Promise<void> {\n    if (!onEvent) {\n        return async () => {};\n    }\n\n    return async (event) => {\n        await onEvent(event);\n    };\n}\n\n/** Validates run context against the agent schema. */\nexport async function validateAgentContext<TContext>(\n    agent: ContextBoundAgent<TContext>,\n    context: TContext | undefined,\n): Promise<TContext | undefined> {\n    if (!agent.contextSchema) {\n        return context;\n    }\n\n    const validated = await validateInput<TContext>(agent.contextSchema, context, {\n        invalidMessage: \"The provided data is invalid according to context schema.\",\n    });\n    if (validated.isErr()) {\n        throw validated.error.at({ at: \"core.run.validateAgentContext\" });\n    }\n\n    return validated.value;\n}\n\n/** Minimal model info for runtime validation. */\ntype AgentModelInfo = {\n    name: string;\n    model: {\n        modelId: string;\n        caps: Capabilities;\n    };\n};\n\nconst throwInvalidStoredConversationItem = (conversationId: string, index: number): never => {\n    throw BetterAgentError.fromCode(\"VALIDATION_FAILED\", \"Loaded conversation items are invalid.\", {\n        context: { conversationId, index },\n        trace: [{ at: \"core.run.validateStoredConversationItems\" }],\n    });\n};\n\nconst isConversationPart = (part: unknown): boolean => {\n    if (!isPlainRecord(part) || typeof part.type !== \"string\") {\n        return false;\n    }\n\n    switch (part.type) {\n        case \"text\":\n            return typeof part.text === \"string\";\n        case \"reasoning\":\n            return (\n                typeof part.text === \"string\" &&\n                (part.visibility === \"summary\" || part.visibility === \"full\") &&\n                (part.provider === undefined || typeof part.provider === \"string\")\n            );\n        case \"transcript\":\n            return (\n                typeof part.text === \"string\" &&\n                (part.segments === undefined ||\n                    (Array.isArray(part.segments) &&\n                        part.segments.every(\n                            (segment) =>\n                                isPlainRecord(segment) &&\n                                typeof segment.id === \"string\" &&\n                                typeof segment.start === \"number\" &&\n                                typeof segment.end === \"number\" &&\n                                typeof segment.text === \"string\" &&\n                                (segment.speaker === undefined ||\n                                    typeof segment.speaker === \"string\"),\n                        )))\n            );\n        case \"image\":\n        case \"audio\":\n        case \"video\":\n        case \"file\":\n            return isPlainRecord(part.source);\n        case \"embedding\":\n            return Array.isArray(part.embedding);\n        default:\n            return false;\n    }\n};\n\nexport const validateStoredConversationItems = (\n    items: ConversationItem[],\n    conversationId: string,\n): void => {\n    for (const [index, item] of items.entries()) {\n        if (!isPlainRecord(item) || typeof item.type !== \"string\") {\n            throwInvalidStoredConversationItem(conversationId, index);\n        }\n\n        if (item.type === \"message\") {\n            if (\n                typeof item.role !== \"string\" ||\n                !(\n                    typeof item.content === \"string\" ||\n                    (Array.isArray(item.content) &&\n                        item.content.every((part) => isConversationPart(part)))\n                )\n            ) {\n                throwInvalidStoredConversationItem(conversationId, index);\n            }\n            continue;\n        }\n\n        if (item.type === \"tool-call\") {\n            if (\n                typeof item.name !== \"string\" ||\n                typeof item.callId !== \"string\" ||\n                (!(\"result\" in item) && typeof item.arguments !== \"string\")\n            ) {\n                throwInvalidStoredConversationItem(conversationId, index);\n            }\n            continue;\n        }\n\n        if (\n            item.type === \"provider-tool-result\" &&\n            typeof item.name === \"string\" &&\n            typeof item.callId === \"string\"\n        ) {\n            continue;\n        }\n\n        throwInvalidStoredConversationItem(conversationId, index);\n    }\n};\n\nconst throwUnsupportedInputModality = (params: {\n    agent: AgentModelInfo;\n    modality: \"text\" | \"image\" | \"audio\" | \"video\" | \"file\" | \"embedding\";\n    location: string;\n    traceAt: string;\n}): never => {\n    throw BetterAgentError.fromCode(\n        \"VALIDATION_FAILED\",\n        `Agent '${params.agent.name}' model does not accept ${params.modality} input at ${params.location}.`,\n        {\n            context: {\n                agentName: params.agent.name,\n                modelId: params.agent.model.modelId,\n                modality: params.modality,\n                location: params.location,\n            },\n            trace: [{ at: params.traceAt }],\n        },\n    );\n};\n\nconst validateMessageContentCapabilities = (params: {\n    agent: AgentModelInfo;\n    content: GenerativeModelInputMessageContent;\n    itemIndex: number;\n    traceAt: string;\n}): void => {\n    const caps = params.agent.model.caps;\n\n    if (typeof params.content === \"string\") {\n        if (caps.inputModalities?.text === false) {\n            throwUnsupportedInputModality({\n                agent: params.agent,\n                modality: \"text\",\n                location: `input[${params.itemIndex}].content`,\n                traceAt: params.traceAt,\n            });\n        }\n        return;\n    }\n\n    if (!Array.isArray(params.content)) {\n        return;\n    }\n\n    for (const [partIndex, part] of params.content.entries()) {\n        if (typeof part !== \"object\" || part === null || !(\"type\" in part)) {\n            continue;\n        }\n\n        const partType = (part as { type: string }).type;\n\n        if (partType === \"text\" || partType === \"transcript\" || partType === \"reasoning\") {\n            if (caps.inputModalities?.text === false) {\n                throwUnsupportedInputModality({\n                    agent: params.agent,\n                    modality: \"text\",\n                    location: `input[${params.itemIndex}].content[${partIndex}]`,\n                    traceAt: params.traceAt,\n                });\n            }\n            continue;\n        }\n\n        if (\n            partType === \"image\" ||\n            partType === \"audio\" ||\n            partType === \"video\" ||\n            partType === \"file\" ||\n            partType === \"embedding\"\n        ) {\n            const modality = partType as NonTextInputModality;\n            if (caps.inputModalities?.[modality] !== true) {\n                throwUnsupportedInputModality({\n                    agent: params.agent,\n                    modality,\n                    location: `input[${params.itemIndex}].content[${partIndex}]`,\n                    traceAt: params.traceAt,\n                });\n            }\n        }\n    }\n};\n\nconst isReplayInputPart = (part: unknown): boolean => {\n    if (!isPlainRecord(part) || typeof part.type !== \"string\") {\n        return false;\n    }\n\n    switch (part.type) {\n        case \"text\":\n            return typeof part.text === \"string\";\n        case \"reasoning\":\n            return (\n                typeof part.text === \"string\" &&\n                (part.visibility === \"summary\" || part.visibility === \"full\") &&\n                (part.provider === undefined || typeof part.provider === \"string\")\n            );\n        case \"transcript\":\n            return (\n                typeof part.text === \"string\" &&\n                (part.segments === undefined ||\n                    (Array.isArray(part.segments) &&\n                        part.segments.every(\n                            (segment) =>\n                                isPlainRecord(segment) &&\n                                typeof segment.id === \"string\" &&\n                                typeof segment.start === \"number\" &&\n                                typeof segment.end === \"number\" &&\n                                typeof segment.text === \"string\" &&\n                                (segment.speaker === undefined ||\n                                    typeof segment.speaker === \"string\"),\n                        )))\n            );\n        case \"image\":\n        case \"audio\":\n        case \"video\":\n        case \"file\":\n            return isPlainRecord(part.source);\n        case \"embedding\":\n            return (\n                Array.isArray(part.embedding) &&\n                part.embedding.every((value) => typeof value === \"number\")\n            );\n        default:\n            return false;\n    }\n};\n\nconst isReplayInputItem = (item: unknown): item is GenerativeModelInputItem => {\n    if (!isPlainRecord(item) || typeof item.type !== \"string\") {\n        return false;\n    }\n\n    if (item.type === \"message\") {\n        if (item.role !== undefined && typeof item.role !== \"string\") {\n            return false;\n        }\n\n        if (typeof item.content === \"string\") {\n            return true;\n        }\n\n        return Array.isArray(item.content) && item.content.every(isReplayInputPart);\n    }\n\n    if (item.type === \"tool-call\") {\n        return typeof item.name === \"string\" && typeof item.callId === \"string\" && \"result\" in item;\n    }\n\n    return (\n        item.type === \"provider-tool-result\" &&\n        typeof item.name === \"string\" &&\n        typeof item.callId === \"string\" &&\n        \"result\" in item\n    );\n};\n\nconst validatePreparedReplayInput = (params: {\n    input: unknown;\n    caps: Capabilities;\n    agentName: string;\n    conversationId: string;\n}): GenerativeModelInputItem[] => {\n    if (!Array.isArray(params.input) || !params.input.every(isReplayInputItem)) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            \"conversationReplay.prepareInput must return a valid array of model input items.\",\n            {\n                context: {\n                    agentName: params.agentName,\n                    conversationId: params.conversationId,\n                },\n                trace: [{ at: \"core.run.prepareConversationReplayInput.validatePreparedInput\" }],\n            },\n        );\n    }\n\n    for (const item of params.input) {\n        if (item.type !== \"message\") {\n            continue;\n        }\n\n        if (params.caps.inputShape === \"prompt\") {\n            if (\"role\" in item && item.role !== undefined) {\n                throw BetterAgentError.fromCode(\n                    \"VALIDATION_FAILED\",\n                    \"conversationReplay.prepareInput returned a role-bearing message for a prompt-shaped model.\",\n                    {\n                        context: {\n                            agentName: params.agentName,\n                            conversationId: params.conversationId,\n                        },\n                        trace: [\n                            {\n                                at: \"core.run.prepareConversationReplayInput.validatePreparedInput.promptRole\",\n                            },\n                        ],\n                    },\n                );\n            }\n            continue;\n        }\n\n        if (!(\"role\" in item) || typeof item.role !== \"string\") {\n            throw BetterAgentError.fromCode(\n                \"VALIDATION_FAILED\",\n                \"conversationReplay.prepareInput returned a role-less message for a chat-shaped model.\",\n                {\n                    context: {\n                        agentName: params.agentName,\n                        conversationId: params.conversationId,\n                    },\n                    trace: [\n                        {\n                            at: \"core.run.prepareConversationReplayInput.validatePreparedInput.chatRole\",\n                        },\n                    ],\n                },\n            );\n        }\n    }\n\n    return params.input;\n};\n\n/**\n * Validates that run input only uses modalities supported by the target model.\n */\nexport function validateRunInputCapabilities(params: {\n    agent: AgentModelInfo;\n    input: GenerativeModelInput;\n    traceAt: string;\n}): void {\n    const caps = params.agent.model.caps;\n\n    if (typeof params.input === \"string\") {\n        if (caps.inputModalities?.text === false) {\n            throwUnsupportedInputModality({\n                agent: params.agent,\n                modality: \"text\",\n                location: \"input\",\n                traceAt: params.traceAt,\n            });\n        }\n        return;\n    }\n\n    for (const [itemIndex, item] of params.input.entries()) {\n        if (item.type !== \"message\") {\n            continue;\n        }\n\n        validateMessageContentCapabilities({\n            agent: params.agent,\n            content: item.content,\n            itemIndex,\n            traceAt: params.traceAt,\n        });\n    }\n}\n\n/**\n * Validates requested output modalities against the target model's capabilities.\n */\nexport function validateRunModalities(params: {\n    agent: AgentModelInfo;\n    modalities: readonly Modality[] | undefined;\n    output: OutputSchemaDefinition | undefined;\n    traceAt: string;\n}): void {\n    if (!params.modalities || params.modalities.length === 0) {\n        return;\n    }\n\n    const caps = params.agent.model.caps;\n\n    for (const modality of params.modalities) {\n        if (caps.outputModalities?.[modality] !== undefined) {\n            continue;\n        }\n\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            `Agent '${params.agent.name}' model does not support ${modality} output.`,\n            {\n                context: {\n                    agentName: params.agent.name,\n                    modelId: params.agent.model.modelId,\n                    modality,\n                },\n                trace: [{ at: params.traceAt }],\n            },\n        );\n    }\n\n    if (params.output !== undefined && !params.modalities.includes(\"text\")) {\n        throw BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            `Structured output requires text output for agent '${params.agent.name}'.`,\n            {\n                context: {\n                    agentName: params.agent.name,\n                    modelId: params.agent.model.modelId,\n                    modalities: [...params.modalities],\n                },\n                trace: [{ at: params.traceAt }],\n            },\n        );\n    }\n}\n\n/**\n * Prepares replayable model input from durable conversation items for a run.\n *\n * Stored history is projected losslessly first. The run can then override that\n * projection with `prepareInput`, or fall back to capability-based pruning.\n */\nexport function prepareConversationReplayInput(params: {\n    items: ConversationItem[];\n    caps: Capabilities;\n    agentName: string;\n    conversationId: string;\n    conversationReplay?: ConversationReplayOptions;\n}): Awaitable<GenerativeModelInputItem[]> {\n    const projected = projectConversationItemsToInput(params.items, params.caps);\n    const replay = params.conversationReplay;\n\n    if (typeof replay?.prepareInput === \"function\") {\n        return Promise.resolve(\n            replay.prepareInput({\n                items: params.items,\n                caps: params.caps,\n                agentName: params.agentName,\n                conversationId: params.conversationId,\n            }),\n        ).then((input) =>\n            validatePreparedReplayInput({\n                input,\n                caps: params.caps,\n                agentName: params.agentName,\n                conversationId: params.conversationId,\n            }),\n        );\n    }\n\n    if (replay?.omitUnsupportedParts === false) {\n        return projected;\n    }\n\n    return pruneInputByCapabilities(projected, params.caps);\n}\n\n/**\n * Converts a public output schema definition into a provider request.\n */\nexport function toStructuredOutputRequest(\n    agent: Pick<AnyAgentDefinition, \"model\" | \"name\" | \"outputSchema\">,\n    output: OutputSchemaDefinition | undefined,\n): StructuredOutput | undefined {\n    if (output === undefined) {\n        return undefined;\n    }\n\n    const modelCaps = agent.model.caps;\n    if (!modelCaps.structured_output) {\n        throw BetterAgentError.fromCode(\n            \"NOT_IMPLEMENTED\",\n            `Model '${agent.model.modelId}' does not support structured output.`,\n            {\n                context: {\n                    agentName: agent.name,\n                    modelId: agent.model.modelId,\n                },\n                trace: [{ at: \"core.run.toStructuredOutputRequest.capability\" }],\n            },\n        );\n    }\n\n    const preflightedSchema =\n        output === agent.outputSchema ? getPreflightedOutputSchema(agent) : undefined;\n    if (preflightedSchema !== undefined) {\n        return {\n            name: output.name ?? `${agent.name}_output`,\n            schema: normalizeStructuredOutputJsonSchema(preflightedSchema),\n            strict: output.strict,\n        };\n    }\n\n    const runtimeResolvedSchema = resolveToJsonSchema(output.schema as never);\n    if (runtimeResolvedSchema.isErr()) {\n        throw runtimeResolvedSchema.error.at({\n            at: \"core.run.toStructuredOutputRequest.resolveSchema\",\n        });\n    }\n\n    return {\n        name: output.name ?? `${agent.name}_output`,\n        schema: normalizeStructuredOutputJsonSchema(runtimeResolvedSchema.value),\n        strict: output.strict,\n    };\n}\n\n/**\n * Parses and validates structured output from a provider response.\n *\n * Structured output currently requires text output.\n */\nexport async function finalizeRunResult(\n    result: RunResult & { items: ConversationItem[] },\n    output: OutputSchemaDefinition | undefined,\n    options?: {\n        outputErrorMode?: OutputErrorMode;\n        onOutputError?: OnOutputError;\n    },\n): Promise<RunResult & { items: ConversationItem[] }> {\n    if (output === undefined) {\n        return result;\n    }\n\n    const outputMessages = result.response.output.filter(\n        (item): item is GenerativeModelOutputMessage => item.type === \"message\",\n    );\n    const resolvedOutputErrorMode = options?.outputErrorMode ?? \"throw\";\n\n    const getLastStructuredText = () =>\n        outputMessages\n            .map((message) =>\n                typeof message.content === \"string\"\n                    ? message.content\n                    : message.content\n                          .filter(\n                              (\n                                  part,\n                              ): part is Extract<\n                                  (typeof message.content)[number],\n                                  { type: \"text\" }\n                              > => part.type === \"text\",\n                          )\n                          .map((part) => part.text)\n                          .join(\"\"),\n            )\n            .filter((text) => text.trim().length > 0)\n            .at(-1);\n\n    const defaultOutputErrorBehavior = (error: unknown): never => {\n        throw error;\n    };\n\n    const validateStructuredValue = async (\n        value: unknown,\n        text: string,\n        repairDepth: number,\n    ): Promise<unknown> => {\n        const validated = await validateInput(output.schema, value);\n        if (validated.isErr()) {\n            return await resolveOutputError(\n                {\n                    errorKind: \"validation\",\n                    error: validated.error.at({ at: \"core.run.finalizeRunResult.validateSchema\" }),\n                    text,\n                    value,\n                },\n                repairDepth,\n            );\n        }\n\n        return validated.value;\n    };\n\n    const parseStructuredText = async (text: string, repairDepth: number): Promise<unknown> => {\n        const parsed = safeJsonParse(text);\n        if (parsed.isErr()) {\n            return await resolveOutputError(\n                {\n                    errorKind: \"parse\",\n                    error: BetterAgentError.wrap({\n                        err: parsed.error,\n                        message:\n                            \"Structured output was requested, but the model returned invalid JSON.\",\n                        opts: {\n                            code: \"VALIDATION_FAILED\",\n                            context: {\n                                preview: text.slice(0, 200),\n                            },\n                            trace: [{ at: \"core.run.finalizeRunResult.parseJson\" }],\n                        },\n                    }),\n                    text,\n                },\n                repairDepth,\n            );\n        }\n\n        return await validateStructuredValue(parsed.value, text, repairDepth);\n    };\n\n    const resolveOutputError = async (\n        context: OutputErrorContext,\n        repairDepth: number,\n    ): Promise<unknown> => {\n        if (resolvedOutputErrorMode === \"throw\" || repairDepth >= MAX_OUTPUT_REPAIR_DEPTH) {\n            return defaultOutputErrorBehavior(context.error);\n        }\n\n        const action = await options?.onOutputError?.(context);\n\n        switch (action?.action) {\n            case \"repair_text\":\n                return await parseStructuredText(action.text, repairDepth + 1);\n            case \"repair_value\":\n                return await validateStructuredValue(\n                    action.value,\n                    \"text\" in context ? context.text : \"\",\n                    repairDepth + 1,\n                );\n            case \"throw\":\n                throw context.error;\n            default:\n                return defaultOutputErrorBehavior(context.error);\n        }\n    };\n\n    const lastText = getLastStructuredText();\n    if (!lastText) {\n        const missingTextError = BetterAgentError.fromCode(\n            \"VALIDATION_FAILED\",\n            \"Structured output was requested, but the model did not return JSON text.\",\n            {\n                trace: [{ at: \"core.run.finalizeRunResult.noStructuredText\" }],\n            },\n        );\n\n        const structured = await resolveOutputError(\n            {\n                errorKind: \"missing_text\",\n                error: missingTextError,\n            },\n            0,\n        );\n\n        return {\n            ...result,\n            structured,\n        };\n    }\n\n    const structured = await parseStructuredText(lastText, 0);\n\n    return {\n        ...result,\n        structured,\n    };\n}\n\n/**\n * Shared id generator for runs and messages.\n */\nexport const generateId = createIdGenerator({\n    prefixes: {\n        run: \"run\",\n        message: \"msg\",\n    },\n});\n\n/**\n * Loads persisted conversation history and returns:\n * - `input`: the model-facing input for this run\n * - `items`: the durable conversation state to mutate and save\n * - `loaded`: the original persisted record for save concurrency\n * - `replayStartIndex`: where the current run's replay window starts in `items`\n *\n * `replayStartIndex` is `loaded.items.length` when older history should be kept in\n * durable state but excluded from per-step replay, otherwise it is `0`.\n */\nexport async function loadConversationMessages(params: {\n    conversations?: ConversationStore;\n    conversationId?: string;\n    agentName?: string;\n    input: GenerativeModelInput;\n    caps?: Capabilities;\n    replaceHistory?: boolean;\n    conversationReplay?: ConversationReplayOptions;\n}): Promise<{\n    input: GenerativeModelInput;\n    items: ConversationItem[];\n    replayStartIndex: number;\n    conversationReplayActive: boolean;\n    loaded?: LoadedConversation;\n}> {\n    const inputItems = normalizeInputToMessages(\n        params.input,\n        params.caps ?? { inputShape: \"chat\" },\n    );\n    const durableInputItems = normalizeInputToConversationItems(\n        params.input,\n        params.caps ?? { inputShape: \"chat\" },\n    );\n\n    if (!params.conversations || params.conversationId === undefined) {\n        return {\n            input: params.input,\n            items: durableInputItems,\n            replayStartIndex: 0,\n            conversationReplayActive: false,\n        };\n    }\n\n    if (!params.agentName) {\n        throw BetterAgentError.fromCode(\n            \"INTERNAL\",\n            \"agentName is required when loading conversation messages.\",\n            {\n                context: { conversationId: params.conversationId },\n                trace: [{ at: \"core.run.loadConversationMessages.missingAgentName\" }],\n            },\n        );\n    }\n\n    const loaded = await params.conversations.load({\n        conversationId: params.conversationId,\n        agentName: params.agentName,\n    });\n    if (!loaded) {\n        return {\n            input: params.input,\n            items: durableInputItems,\n            replayStartIndex: 0,\n            conversationReplayActive: false,\n        };\n    }\n\n    validateStoredConversationItems(loaded.items, params.conversationId);\n\n    if (params.replaceHistory) {\n        return {\n            input: params.input,\n            items: durableInputItems,\n            replayStartIndex: 0,\n            conversationReplayActive: false,\n            loaded,\n        };\n    }\n\n    const caps = params.caps ?? { inputShape: \"chat\" };\n    const replayMode =\n        caps.replayMode ?? (caps.inputShape === \"prompt\" ? \"single_turn_persistent\" : \"multi_turn\");\n\n    if (replayMode !== \"multi_turn\") {\n        return {\n            input: params.input,\n            items: [...loaded.items, ...durableInputItems],\n            replayStartIndex: loaded.items.length,\n            conversationReplayActive: false,\n            loaded,\n        };\n    }\n\n    const loadedMessages = await prepareConversationReplayInput({\n        items: loaded.items,\n        caps,\n        agentName: params.agentName,\n        conversationId: params.conversationId,\n        conversationReplay: params.conversationReplay,\n    });\n\n    return {\n        input: [...loadedMessages, ...inputItems],\n        items: [...loaded.items, ...durableInputItems],\n        replayStartIndex: 0,\n        conversationReplayActive: true,\n        loaded,\n    };\n}\n\n/**\n * Saves durable conversation items after a run completes.\n */\nexport async function saveConversationMessages(params: {\n    conversations?: ConversationStore;\n    conversationId?: string;\n    agentName?: string;\n    result: RunResult & { items: ConversationItem[] };\n    loaded?: LoadedConversation;\n}): Promise<void> {\n    if (!params.conversations || params.conversationId === undefined) {\n        return;\n    }\n\n    if (!params.agentName) {\n        throw BetterAgentError.fromCode(\n            \"INTERNAL\",\n            \"agentName is required when saving conversation messages.\",\n            {\n                context: { conversationId: params.conversationId },\n                trace: [{ at: \"core.run.saveConversationMessages.missingAgentName\" }],\n            },\n        );\n    }\n\n    try {\n        validateStoredConversationItems(params.result.items, params.conversationId);\n        await params.conversations.save({\n            conversationId: params.conversationId,\n            agentName: params.agentName,\n            items: params.result.items,\n            ...(params.loaded?.cursor !== undefined\n                ? { expectedCursor: params.loaded.cursor }\n                : {}),\n        });\n    } catch (error) {\n        throw BetterAgentError.wrap({\n            err: error,\n            message: \"Failed to save conversation messages.\",\n            opts: {\n                code:\n                    error instanceof BetterAgentError && error.code !== undefined\n                        ? error.code\n                        : typeof (error as { code?: unknown })?.code === \"string\"\n                          ? ((error as { code: string }).code as BetterAgentError[\"code\"])\n                          : \"INTERNAL\",\n                ...(typeof (error as { status?: unknown })?.status === \"number\"\n                    ? { status: (error as { status: number }).status }\n                    : {}),\n                context: {\n                    conversationId: params.conversationId,\n                    agentName: params.agentName,\n                },\n                trace: [{ at: \"core.run.saveConversationMessages\" }],\n            },\n        });\n    }\n}\n"],"mappings":"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"}