ai 7.0.152 → 7.0.154

package/dist/index.js

@@ -1175,7 +1175,7 @@ function cloneValue(value) {
 }
 //#endregion
 //#region src/version.ts
-const VERSION = "7.0.152";
+const VERSION = "7.0.154";
 //#endregion
 //#region src/util/download/download.ts
 /**
@@ -4488,7 +4488,8 @@ function augmentEvent(event, telemetry, filterContext = false) {
 	const augmentedEvent = Object.assign(Object.create(Object.getPrototypeOf(event)), event, {
 		recordInputs: telemetry.recordInputs,
 		recordOutputs: telemetry.recordOutputs,
-		functionId: telemetry.functionId
+		functionId: telemetry.functionId,
+		aiVersion: VERSION
 	});
 	if (filterContext && event != null && typeof event === "object" && "runtimeContext" in event) augmentedEvent.runtimeContext = filterIncludedContext({
 		context: event.runtimeContext,
@@ -4565,6 +4566,7 @@ function createTelemetryDispatcher({ telemetry }) {
 		onToolExecutionStart: mergeTelemetryCallback("onToolExecutionStart"),
 		onToolExecutionEnd: mergeTelemetryCallback("onToolExecutionEnd"),
 		onStepEnd: onStepEnd == null && onStepFinish == null ? void 0 : mergeCallbacks(onStepEnd, onStepFinish),
+		onStepError: mergeTelemetryCallback("onStepError"),
 		onObjectStepStart: mergeTelemetryCallback("onObjectStepStart"),
 		onObjectStepEnd: mergeTelemetryCallback("onObjectStepEnd"),
 		onEmbedStart: mergeTelemetryCallback("onEmbedStart"),
@@ -4628,7 +4630,7 @@ function asReasoningText(reasoningParts) {
 //#endregion
 //#region src/generate-text/step-result.ts
 var DefaultStepResult = class {
-	constructor({ callId, stepNumber, provider, modelId, runtimeContext, toolsContext, content, finishReason, rawFinishReason, usage, performance, warnings, request, response, providerMetadata }) {
+	constructor({ callId, stepNumber, provider, modelId, runtimeContext, toolsContext, content, finishReason, rawFinishReason, usage, performance, warnings, request, response, providerMetadata, steeringMessages }) {
 		this.callId = callId;
 		this.stepNumber = stepNumber;
 		this.model = {
@@ -4646,6 +4648,7 @@ var DefaultStepResult = class {
 		this.request = request;
 		this.response = response;
 		this.providerMetadata = providerMetadata;
+		if (steeringMessages != null && steeringMessages.length > 0) this.experimental_steeringMessages = steeringMessages;
 	}
 	get text() {
 		return this.content.filter((part) => part.type === "text").map((part) => part.text).join("");
@@ -4709,7 +4712,8 @@ function restrictStepResult({ step, includeRuntimeContext, includeToolsContext }
 		warnings: step.warnings,
 		request: step.request,
 		response: step.response,
-		providerMetadata: step.providerMetadata
+		providerMetadata: step.providerMetadata,
+		steeringMessages: step.experimental_steeringMessages
 	});
 }
 /**
@@ -4718,6 +4722,22 @@ function restrictStepResult({ step, includeRuntimeContext, includeToolsContext }
 */
 function createRestrictedTelemetryDispatcher$3({ telemetry, includeRuntimeContext, includeToolsContext }) {
 	const telemetryDispatcher = createTelemetryDispatcher({ telemetry });
+	const restrictStepStartEvent = (event) => ({
+		...event,
+		runtimeContext: filterIncludedContext({
+			context: event.runtimeContext,
+			includeContext: includeRuntimeContext
+		}),
+		steps: event.steps.map((step) => restrictStepResult({
+			step,
+			includeRuntimeContext,
+			includeToolsContext
+		})),
+		toolsContext: filterToolsContext({
+			toolsContext: event.toolsContext,
+			includeToolsContext
+		})
+	});
 	return {
 		...telemetryDispatcher,
 		onStart: (event) => telemetryDispatcher.onStart?.({
@@ -4731,22 +4751,7 @@ function createRestrictedTelemetryDispatcher$3({ telemetry, includeRuntimeContex
 				includeToolsContext
 			})
 		}),
-		onStepStart: (event) => telemetryDispatcher.onStepStart?.({
-			...event,
-			runtimeContext: filterIncludedContext({
-				context: event.runtimeContext,
-				includeContext: includeRuntimeContext
-			}),
-			steps: event.steps.map((step) => restrictStepResult({
-				step,
-				includeRuntimeContext,
-				includeToolsContext
-			})),
-			toolsContext: filterToolsContext({
-				toolsContext: event.toolsContext,
-				includeToolsContext
-			})
-		}),
+		onStepStart: (event) => telemetryDispatcher.onStepStart?.(restrictStepStartEvent(event)),
 		onStepEnd: (event) => telemetryDispatcher.onStepEnd?.(restrictStepResult({
 			step: event,
 			includeRuntimeContext,
@@ -4757,6 +4762,7 @@ function createRestrictedTelemetryDispatcher$3({ telemetry, includeRuntimeContex
 			includeRuntimeContext,
 			includeToolsContext
 		})),
+		onStepError: (event) => telemetryDispatcher.onStepError?.(restrictStepStartEvent(event)),
 		onEnd: (event) => telemetryDispatcher.onEnd?.(((restrictedSteps) => {
 			return {
 				...event,
@@ -4803,6 +4809,139 @@ function createRestrictedTelemetryDispatcher$3({ telemetry, includeRuntimeContex
 	};
 }
 //#endregion
+//#region src/generate-text/steering.ts
+const generateSteeringId = createIdGenerator$1({
+	prefix: "steer",
+	size: 24
+});
+const steeringRunStarter = Symbol.for("vercel.ai.steering.start");
+var DefaultSteering = class {
+	constructor() {
+		this.state = "idle";
+		this.pending = [];
+		this.taken = [];
+		this.outcomes = /* @__PURE__ */ new Map();
+	}
+	steer(message, options) {
+		const id = options?.id ?? generateSteeringId();
+		const existingOutcome = this.outcomes.get(id);
+		if (existingOutcome != null) return existingOutcome;
+		const userMessage = typeof message === "string" ? {
+			role: "user",
+			content: message
+		} : message;
+		if (userMessage.role !== "user") throw new InvalidArgumentError({
+			parameter: "message",
+			value: message,
+			message: "Steering messages must be user messages."
+		});
+		const outcome = this.state === "ended" ? Promise.resolve({
+			type: "not-delivered",
+			id,
+			message: userMessage,
+			reason: "finished"
+		}) : new Promise((resolve) => {
+			this.pending.push({
+				id,
+				message: userMessage,
+				resolve
+			});
+		});
+		this.outcomes.set(id, outcome);
+		return outcome;
+	}
+	[steeringRunStarter]() {
+		if (this.state !== "idle") throw new InvalidArgumentError({
+			parameter: "experimental_steering",
+			value: this,
+			message: "The steering object was already used by a generation. Create a new one with experimental_createSteering() for each call."
+		});
+		this.state = "running";
+		return {
+			hasPendingMessages: () => this.state === "running" && this.pending.length > 0,
+			takeMessages: () => {
+				if (this.state !== "running") return [];
+				this.taken = [...this.taken, ...this.pending];
+				this.pending = [];
+				return this.taken.map(({ message }) => message);
+			},
+			resolveTakenMessages: ({ stepNumber, sentMessages }) => {
+				const taken = this.taken;
+				this.taken = [];
+				const delivered = [];
+				for (const { id, message, resolve } of taken) if (isSent({
+					message,
+					sentMessages
+				})) {
+					delivered.push(message);
+					resolve({
+						type: "delivered",
+						id,
+						message,
+						stepNumber
+					});
+				} else resolve({
+					type: "not-delivered",
+					id,
+					message,
+					reason: "removed-by-prepare-step"
+				});
+				return delivered;
+			},
+			end: (reason) => {
+				if (this.state !== "running") return;
+				const notDelivered = [...this.taken, ...this.pending];
+				this.taken = [];
+				this.pending = [];
+				this.state = "ended";
+				for (const { id, message, resolve } of notDelivered) resolve({
+					type: "not-delivered",
+					id,
+					message,
+					reason
+				});
+			}
+		};
+	}
+};
+function isSent({ message, sentMessages }) {
+	const content = JSON.stringify(message.content);
+	return sentMessages.some((sentMessage) => sentMessage === message || sentMessage.role === "user" && JSON.stringify(sentMessage.content) === content);
+}
+/**
+* Creates a steering object that sends user messages to a running generation.
+*
+* @example
+* ```ts
+* const steering = experimental_createSteering();
+*
+* const result = streamText({
+*   model,
+*   tools,
+*   stopWhen: isStepCount(20),
+*   experimental_steering: steering,
+* });
+*
+* const outcome = await steering.steer('Use Paris, Texas instead.');
+* ```
+*/
+function createSteering() {
+	return new DefaultSteering();
+}
+/**
+* Starts a run for a steering object that was passed to a generation.
+*/
+function startSteeringRun(steering) {
+	if (steering == null) return;
+	const start = steering[steeringRunStarter];
+	if (typeof start !== "function") throw new InvalidArgumentError({
+		parameter: "experimental_steering",
+		value: steering,
+		message: "The steering object must be created with experimental_createSteering()."
+	});
+	return start.call(steering);
+}
+//#endregion
 //#region src/generate-text/stop-condition.ts
 /**
 * Creates a stop condition that returns `true` when the number of completed
@@ -5321,6 +5460,7 @@ const originalGenerateCallId$9 = createIdGenerator$1({
 * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
 *
 * @param experimental_sandbox - The sandbox environment that is passed through to tool execution.
+* @param experimental_steering - A steering object that adds user messages to the generation at the next step boundary.
 * @param runtimeContext - User-defined runtime context that flows through the entire generation lifecycle.
 * @param experimental_refineToolInput - Optional mapping of tool names to functions that refine parsed tool inputs before tools are executed and before outputs, callbacks, and telemetry are recorded.
 * @param onStart - Callback invoked when generation begins, before any LLM calls.
@@ -5339,13 +5479,23 @@ const originalGenerateCallId$9 = createIdGenerator$1({
 * Uses a discriminated union: check `success` to determine if `output` or `error` is present.
 * @param experimental_onToolCallFinish - Deprecated alias for `onToolExecutionEnd`.
 * @param onStepFinish - Callback that is called when each step (LLM call) is finished, including intermediate steps.
+* @param onStepError - Callback that is called when a step that started fails before it produces a step result, i.e. when the provider call throws or rejects, or when the call is aborted or times out.
 * @param onEnd - Callback that is called when all steps are finished and the response is complete.
 * @param onFinish - Deprecated alias for `onEnd`.
 *
 * @returns
 * A result object that contains the generated text, the results of the tool calls, and additional information.
 */
-async function generateText({ model: modelArg, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries: maxRetriesArg, abortSignal, timeout, headers, stopWhen = isStepCount(1), experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry = experimental_telemetry, providerOptions, activeTools, toolOrder, toolCallConcurrency, prepareStep, experimental_repairToolCall, repairToolCall = experimental_repairToolCall, experimental_refineToolInput: refineToolInput, experimental_download: download, runtimeContext = {}, toolsContext = {}, experimental_include, include = experimental_include, _internal: { generateId = originalGenerateId$4, generateCallId = originalGenerateCallId$9, now: now$4 = now } = {}, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onLanguageModelCallStart, experimental_onLanguageModelCallStart, onLanguageModelCallEnd, experimental_onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, experimental_onToolCallStart, experimental_onToolCallFinish, onStepEnd, onStepFinish, onFinish, onEnd = onFinish, ...settings }) {
+async function generateText(options) {
+	const steeringRun = startSteeringRun(options.experimental_steering);
+	try {
+		return await generateTextInternal(options, steeringRun);
+	} catch (error) {
+		steeringRun?.end(options.abortSignal?.aborted ? "aborted" : "error");
+		throw error;
+	}
+}
+async function generateTextInternal({ model: modelArg, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries: maxRetriesArg, abortSignal, timeout, headers, stopWhen = isStepCount(1), experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry = experimental_telemetry, providerOptions, activeTools, toolOrder, toolCallConcurrency, prepareStep, experimental_repairToolCall, repairToolCall = experimental_repairToolCall, experimental_refineToolInput: refineToolInput, experimental_download: download, runtimeContext = {}, toolsContext = {}, experimental_include, include = experimental_include, _internal: { generateId = originalGenerateId$4, generateCallId = originalGenerateCallId$9, now: now$4 = now } = {}, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onLanguageModelCallStart, experimental_onLanguageModelCallStart, onLanguageModelCallEnd, experimental_onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, experimental_onToolCallStart, experimental_onToolCallFinish, onStepEnd, onStepError, onStepFinish, onFinish, onEnd = onFinish, ...settings }, steeringRun) {
 	include = {
 		requestBody: include?.requestBody ?? false,
 		requestMessages: include?.requestMessages ?? false,
@@ -5442,6 +5592,7 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 			event: generateTextStartEvent,
 			callbacks: [resolvedOnStart, telemetryDispatcher.onStart]
 		});
+		let openStep;
 		try {
 			const initialMessages = initialPrompt.messages;
 			const initialResponseMessages = [];
@@ -5533,6 +5684,29 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 			let instructionsForNextStep = initialPrompt.instructions;
 			let messagesForNextStep = [...initialMessages, ...initialResponseMessages];
 			const pendingDeferredToolCalls = /* @__PURE__ */ new Map();
+			let steeringEndReason = "finished";
+			const shouldStartNextStep = async () => {
+				if (steps[steps.length - 1].finishReason === "interrupted") return false;
+				if (clientToolOutputs.length + deniedToolApprovalResponses.length !== clientToolCalls.length) {
+					steeringEndReason = "waiting-for-tool-results";
+					return false;
+				}
+				if (clientToolCalls.length === 0 && pendingDeferredToolCalls.size === 0) {
+					if (!steeringRun?.hasPendingMessages()) return false;
+					if (steps[steps.length - 1].finishReason === "error") {
+						steeringEndReason = "error";
+						return false;
+					}
+				}
+				if (await isStopConditionMet({
+					stopConditions,
+					steps
+				})) {
+					steeringEndReason = "stop-condition";
+					return false;
+				}
+				return true;
+			};
 			do {
 				if (steps.length > 0) mergedAbortSignal?.throwIfAborted();
 				const stepTimeoutId = setAbortTimeout({
@@ -5541,6 +5715,8 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 					timeoutMs: stepTimeoutMs
 				});
 				const stepNumber = steps.length;
+				const steeringMessages = steeringRun?.takeMessages() ?? [];
+				if (steeringMessages.length > 0) messagesForNextStep = [...messagesForNextStep, ...steeringMessages];
 				try {
 					await runInTracingChannelSpan({
 						type: "step",
@@ -5560,6 +5736,7 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 								messages: stepInputMessages,
 								initialMessages,
 								responseMessages: accumulatedResponseMessages,
+								...steeringMessages.length > 0 ? { experimental_steeringMessages: steeringMessages } : {},
 								runtimeContext,
 								toolsContext,
 								experimental_sandbox: sandbox
@@ -5593,6 +5770,10 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 								messages: prepareStepResult?.messages ?? stepInputMessages,
 								toolCallerMessages
 							});
+							const deliveredSteeringMessages = steeringRun?.resolveTakenMessages({
+								stepNumber,
+								sentMessages: stepMessages
+							}) ?? [];
 							const promptMessages = await convertToLanguageModelPrompt({
 								prompt: {
 									instructions: stepInstructions,
@@ -5608,29 +5789,31 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 								callSettings,
 								stepSettings: prepareStepResult
 							});
+							const stepStartEvent = {
+								callId,
+								provider: stepModel.provider,
+								modelId: stepModel.modelId,
+								stepNumber,
+								instructions: stepInstructions,
+								messages: stepMessages,
+								tools,
+								toolChoice: prepareStepResult?.toolChoice ?? toolChoice,
+								activeTools: prepareStepResult?.activeTools ?? activeTools,
+								toolOrder: stepToolOrder,
+								steps: [...steps],
+								providerOptions: stepProviderOptions,
+								output,
+								runtimeContext,
+								promptMessages,
+								stepTools,
+								stepToolChoice,
+								toolsContext
+							};
 							await notify({
-								event: {
-									callId,
-									provider: stepModel.provider,
-									modelId: stepModel.modelId,
-									stepNumber,
-									instructions: stepInstructions,
-									messages: stepMessages,
-									tools,
-									toolChoice: prepareStepResult?.toolChoice ?? toolChoice,
-									activeTools: prepareStepResult?.activeTools ?? activeTools,
-									toolOrder: stepToolOrder,
-									steps: [...steps],
-									providerOptions: stepProviderOptions,
-									output,
-									runtimeContext,
-									promptMessages,
-									stepTools,
-									stepToolChoice,
-									toolsContext
-								},
+								event: stepStartEvent,
 								callbacks: [resolvedOnStepStart, telemetryDispatcher.onStepStart]
 							});
+							openStep = stepStartEvent;
 							const languageModelCallContext = {
 								provider: stepModel.provider,
 								modelId: stepModel.modelId,
@@ -5928,7 +6111,8 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 								providerMetadata: currentModelResponse.providerMetadata,
 								request: stepRequest,
 								response: stepResponse,
-								toolsContext
+								toolsContext,
+								steeringMessages: deliveredSteeringMessages
 							});
 							logWarnings({
 								warnings: currentModelResponse.warnings ?? [],
@@ -5938,6 +6122,7 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 							steps.push(currentStepResult);
 							instructionsForNextStep = stepInstructions;
 							messagesForNextStep = [...stepMessages, ...stepResponseMessages];
+							openStep = void 0;
 							await notify({
 								event: currentStepResult,
 								callbacks: [resolvedOnStepEnd, telemetryDispatcher.onStepEnd]
@@ -5948,10 +6133,8 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 				} finally {
 					if (stepTimeoutId != null) clearTimeout(stepTimeoutId);
 				}
-			} while (steps[steps.length - 1].finishReason !== "interrupted" && clientToolOutputs.length + deniedToolApprovalResponses.length === clientToolCalls.length && (clientToolCalls.length > 0 || pendingDeferredToolCalls.size > 0) && !await isStopConditionMet({
-				stopConditions,
-				steps
-			}));
+			} while (await shouldStartNextStep());
+			steeringRun?.end(steeringEndReason);
 			const lastStep = steps[steps.length - 1];
 			const totalUsage = steps.reduce((totalUsage, step) => {
 				return addLanguageModelUsage(totalUsage, step.usage);
@@ -6012,11 +6195,15 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 				callbacks: [onEnd, telemetryDispatcher.onEnd]
 			});
 			let resolvedOutput;
-			if (lastStep.finishReason === "stop" || lastStep.finishReason !== "tool-calls" && lastStep.text.length > 0) resolvedOutput = await (output ?? text()).parseCompleteOutput({ text: lastStep.text }, {
-				response: lastStep.response,
-				usage: lastStep.usage,
-				finishReason: lastStep.finishReason
-			});
+			if (lastStep.finishReason === "stop" || lastStep.finishReason !== "tool-calls" && lastStep.text.length > 0) {
+				const outputSpecification = output ?? text();
+				const textForOutput = (await outputSpecification.responseFormat)?.type === "json" ? currentModelResponse.structuredOutputText ?? lastStep.text : lastStep.text;
+				resolvedOutput = await outputSpecification.parseCompleteOutput({ text: textForOutput }, {
+					response: lastStep.response,
+					usage: lastStep.usage,
+					finishReason: lastStep.finishReason
+				});
+			}
 			return new DefaultGenerateTextResult({
 				initialResponseMessages,
 				steps,
@@ -6024,11 +6211,20 @@ async function generateText({ model: modelArg, tools, toolChoice, instructions,
 				output: resolvedOutput
 			});
 		} catch (error) {
+			const wrappedError = wrapGatewayError(error);
+			steeringRun?.end(mergedAbortSignal?.aborted ? "aborted" : "error");
+			if (openStep != null) await notify({
+				event: {
+					...openStep,
+					error: wrappedError
+				},
+				callbacks: [onStepError, telemetryDispatcher.onStepError]
+			});
 			await telemetryDispatcher.onError?.({
 				callId,
 				error
 			});
-			throw wrapGatewayError(error);
+			throw wrappedError;
 		}
 	};
 	return await runInTracingChannelSpan({
@@ -8828,6 +9024,7 @@ const originalGenerateCallId$7 = createIdGenerator$1({
 * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
 *
 * @param experimental_sandbox - The sandbox environment that is passed through to tool execution.
+* @param experimental_steering - A steering object that adds user messages to the generation at the next step boundary.
 * @param runtimeContext - User-defined runtime context that flows through the entire generation lifecycle.
 * @param experimental_refineToolInput - Optional mapping of tool names to functions that refine parsed tool inputs before tools are executed and before outputs, callbacks, and telemetry are recorded.
 *
@@ -8846,6 +9043,7 @@ const originalGenerateCallId$7 = createIdGenerator$1({
 * @param onToolExecutionEnd - Callback invoked after each tool execution completes.
 * @param experimental_onToolCallFinish - Deprecated alias for `onToolExecutionEnd`.
 * @param onStepEnd - Callback that is called when each step (LLM call) ends, including intermediate steps.
+* @param onStepError - Callback that is called when a step that started fails before it produces a step result, i.e. when the provider call throws or rejects, or when the model stream ends without output. A provider `error` chunk still ends the step with `onStepEnd`, and an abort or timeout ends it with `onAbort`.
 * @param onStepFinish - Deprecated alias for `onStepEnd`.
 * @param onEnd - Callback that is called when all steps are finished and the response is complete.
 * @param onFinish - Deprecated alias for `onEnd`.
@@ -8854,7 +9052,7 @@ const originalGenerateCallId$7 = createIdGenerator$1({
 * A result object for accessing different stream types and additional information.
 */
 function streamText(options) {
-	return streamTextInternal(options);
+	return startStreamText(options);
 }
 /**
 * Stream text with a single consumer, without replay or final-content getters.
@@ -8864,7 +9062,7 @@ function streamTextLowMemory(options) {
 	const telemetry = options.telemetry ?? options.experimental_telemetry;
 	const integrations = telemetry?.integrations != null ? asArray(telemetry.integrations) : getGlobalTelemetryIntegrations();
 	const collectContent = options.tools != null && Object.keys(options.tools).length > 0 || options.toolChoice != null || options.output != null || options.prepareStep != null || options.stopWhen != null || options.onEnd != null || options.onFinish != null || options.onStepEnd != null || options.onStepFinish != null || options.onAbort != null || options.onLanguageModelCallEnd != null || options.experimental_onLanguageModelCallEnd != null || telemetry?.isEnabled !== false && integrations.length > 0;
-	return createSingleConsumerStreamTextResult(streamTextInternal({
+	return createSingleConsumerStreamTextResult(startStreamText({
 		...options,
 		_internal: {
 			...options._internal,
@@ -8875,10 +9073,19 @@ function streamTextLowMemory(options) {
 		}
 	}));
 }
-function streamTextInternal({ model, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries, streamRetries, abortSignal, timeout, headers, stopWhen = isStepCount(1), experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry = experimental_telemetry, prepareStep, providerOptions, activeTools, toolOrder, toolCallConcurrency, experimental_repairToolCall, repairToolCall = experimental_repairToolCall, experimental_refineToolInput: refineToolInput, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError: onErrorArg, onFinish, onEnd = onFinish, onAbort, onStepEnd, onStepFinish, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onLanguageModelCallStart, experimental_onLanguageModelCallStart, onLanguageModelCallEnd, experimental_onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, experimental_onToolCallStart, experimental_onToolCallFinish, runtimeContext = {}, toolsContext = {}, experimental_include, include = experimental_include, _internal: { now: now$2 = now, generateId = originalGenerateId$2, generateCallId = originalGenerateCallId$7, retention = {
+function startStreamText(options) {
+	const steeringRun = startSteeringRun(options.experimental_steering);
+	try {
+		return streamTextInternal(options, steeringRun);
+	} catch (error) {
+		steeringRun?.end("error");
+		throw error;
+	}
+}
+function streamTextInternal({ model, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries, streamRetries, abortSignal, timeout, headers, stopWhen = isStepCount(1), experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry = experimental_telemetry, prepareStep, providerOptions, activeTools, toolOrder, toolCallConcurrency, experimental_repairToolCall, repairToolCall = experimental_repairToolCall, experimental_refineToolInput: refineToolInput, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError: onErrorArg, onFinish, onEnd = onFinish, onAbort, onStepEnd, onStepError, onStepFinish, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onLanguageModelCallStart, experimental_onLanguageModelCallStart, onLanguageModelCallEnd, experimental_onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, experimental_onToolCallStart, experimental_onToolCallFinish, runtimeContext = {}, toolsContext = {}, experimental_include, include = experimental_include, _internal: { now: now$2 = now, generateId = originalGenerateId$2, generateCallId = originalGenerateCallId$7, retention = {
 	replay: true,
 	collectContent: true
-} } = {}, ...settings }) {
+} } = {}, ...settings }, steeringRun) {
 	const resolvedToolCallConcurrency = prepareToolCallConcurrency(toolCallConcurrency);
 	const totalTimeoutMs = getTotalTimeoutMs(timeout);
 	const stepTimeoutMs = getStepTimeoutMs(timeout);
@@ -8918,6 +9125,7 @@ function streamTextInternal({ model, tools, toolChoice, instructions, system, pr
 		messages,
 		allowSystemInMessages,
 		experimental_sandbox: sandbox,
+		steeringRun,
 		tools,
 		toolsContext,
 		runtimeContext,
@@ -8942,6 +9150,7 @@ function streamTextInternal({ model, tools, toolChoice, instructions, system, pr
 		onEnd,
 		onAbort,
 		onStepFinish: resolvedOnStepEnd,
+		onStepError,
 		onStart: resolvedOnStart,
 		onStepStart: resolvedOnStepStart,
 		onLanguageModelCallStart: resolvedOnLanguageModelCallStart,
@@ -9139,7 +9348,7 @@ function applyStreamTextTransforms({ stream, transforms, tools, stopStream }) {
 	});
 }
 var DefaultStreamTextResult = class {
-	constructor({ retention, model, telemetry, headers, settings, maxRetries: maxRetriesArg, streamRetries: streamRetriesArg, abortSignal, stepTimeoutMs, stepAbortController, firstChunkTimeoutMs, firstChunkAbortController, chunkTimeoutMs, chunkAbortController, instructions, system, prompt, messages, allowSystemInMessages, experimental_sandbox: sandbox, tools, toolChoice, transforms, activeTools, toolOrder, toolCallConcurrency, repairToolCall, refineToolInput, stopConditions, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, providerOptions, prepareStep, now, generateId, generateCallId, timeout, onChunk, onError, canRetryStreamViaOnError, onEnd, onAbort, onStepFinish, onStart, onStepStart, onLanguageModelCallStart, onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, runtimeContext, toolsContext, download, include }) {
+	constructor({ retention, model, telemetry, headers, settings, maxRetries: maxRetriesArg, streamRetries: streamRetriesArg, abortSignal, stepTimeoutMs, stepAbortController, firstChunkTimeoutMs, firstChunkAbortController, chunkTimeoutMs, chunkAbortController, instructions, system, prompt, messages, allowSystemInMessages, experimental_sandbox: sandbox, steeringRun, tools, toolChoice, transforms, activeTools, toolOrder, toolCallConcurrency, repairToolCall, refineToolInput, stopConditions, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, providerOptions, prepareStep, now, generateId, generateCallId, timeout, onChunk, onError, canRetryStreamViaOnError, onEnd, onAbort, onStepFinish, onStepError, onStart, onStepStart, onLanguageModelCallStart, onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, runtimeContext, toolsContext, download, include }) {
 		this._totalUsage = new DelayedPromise();
 		this._finishReason = new DelayedPromise();
 		this._rawFinishReason = new DelayedPromise();
@@ -9174,6 +9383,7 @@ var DefaultStreamTextResult = class {
 		const initialResponseMessages = [];
 		let stepMessagesForNextStep;
 		let currentStepMessages = [];
+		let currentStepSteeringMessages = [];
 		let isAborted = false;
 		let currentStepModel = model;
 		const createPartIdReserver = () => {
@@ -9198,6 +9408,19 @@ var DefaultStreamTextResult = class {
 		let activeReasoningContent = createIdMap();
 		let recordedNoOutputError;
 		const errorsHandledForStreamRetry = /* @__PURE__ */ new Set();
+		let openStep;
+		const notifyStepError = async (error) => {
+			if (openStep == null || abortSignal?.aborted) return;
+			const { event } = openStep;
+			openStep = void 0;
+			await notify({
+				event: {
+					...event,
+					error
+				},
+				callbacks: [onStepError, telemetryDispatcher.onStepError]
+			});
+		};
 		const eventProcessor = new TransformStream({
 			async transform(chunk, controller) {
 				if (isStreamRetryBoundaryPart(chunk)) {
@@ -9221,12 +9444,15 @@ var DefaultStreamTextResult = class {
 					const error = wrapGatewayError(part.error);
 					if (NoOutputGeneratedError.isInstance(error)) recordedNoOutputError = error;
 					if (callbacksHandledForStreamRetry) errorsHandledForStreamRetry.delete(part.error);
-					else await notify({
-						event: { error },
-						callbacks: async (event) => {
-							await onError(event);
-						}
-					});
+					else {
+						if (openStep != null) openStep.error = error;
+						await notify({
+							event: { error },
+							callbacks: async (event) => {
+								await onError(event);
+							}
+						});
+					}
 				}
 				if (part.type === "custom" || part.type === "source" || part.type === "tool-call" || part.type === "tool-approval-request" || part.type === "tool-approval-response" || part.type === "tool-error") {
 					if (retention.collectContent) recordedContent.push(part);
@@ -9351,8 +9577,10 @@ var DefaultStreamTextResult = class {
 							...part.response,
 							messages: cloneModelMessages(stepResponseMessages)
 						},
-						providerMetadata: part.providerMetadata
+						providerMetadata: part.providerMetadata,
+						steeringMessages: currentStepSteeringMessages
 					});
+					openStep = void 0;
 					await notify({
 						event: currentStepResult,
 						callbacks: [onStepFinish, telemetryDispatcher.onStepEnd]
@@ -9373,9 +9601,16 @@ var DefaultStreamTextResult = class {
 				}
 			},
 			async flush(controller) {
+				steeringRun?.end(recordedSteps.length === 0 || recordedNoOutputError != null ? "error" : "finished");
 				try {
+					const noOutputError = new NoOutputGeneratedError({ message: "No output generated. Check the stream for errors." });
+					await notifyStepError(openStep?.error ?? noOutputError);
 					if (recordedSteps.length === 0 || recordedNoOutputError != null) {
-						const error = abortSignal?.aborted ? abortSignal.reason : recordedNoOutputError ?? new NoOutputGeneratedError({ message: "No output generated. Check the stream for errors." });
+						const error = abortSignal?.aborted ? abortSignal.reason : recordedNoOutputError ?? noOutputError;
+						if (recordedNoOutputError != null && !abortSignal?.aborted) await telemetryDispatcher.onError?.({
+							callId,
+							error: recordedNoOutputError
+						});
 						self.rejectResultPromises(error);
 						return;
 					}
@@ -9475,6 +9710,7 @@ var DefaultStreamTextResult = class {
 				async function abort() {
 					isAborted = true;
 					removeAbortListener();
+					steeringRun?.end("aborted");
 					await notify({
 						event: {
 							callId,
@@ -9505,6 +9741,8 @@ var DefaultStreamTextResult = class {
 					removeAbortListener();
 					if (isAbortError(error) && abortSignal?.aborted) await abort();
 					else {
+						steeringRun?.end("error");
+						await notifyStepError(wrapGatewayError(error));
 						await telemetryDispatcher.onError?.({
 							callId,
 							error
@@ -9515,6 +9753,7 @@ var DefaultStreamTextResult = class {
 			},
 			cancel(reason) {
 				removeAbortListener();
+				steeringRun?.end("aborted");
 				return reader.cancel(reason);
 			}
 		});
@@ -9770,7 +10009,8 @@ var DefaultStreamTextResult = class {
 					const runInStepTracingChannelContext = (execute) => stepTracingChannelContext?.run(execute) ?? execute();
 					const responseMessagesFromPreviousSteps = recordedSteps.flatMap((step) => step.response.messages);
 					const accumulatedResponseMessages = [...initialResponseMessages, ...responseMessagesFromPreviousSteps];
-					const stepInputMessages = stepMessagesForNextStep ?? [...initialMessages, ...initialResponseMessages];
+					const steeringMessages = steeringRun?.takeMessages() ?? [];
+					const stepInputMessages = [...stepMessagesForNextStep ?? [...initialMessages, ...initialResponseMessages], ...steeringMessages];
 					const prepareStepResult = await prepareStep?.({
 						model,
 						steps: recordedSteps,
@@ -9780,6 +10020,7 @@ var DefaultStreamTextResult = class {
 						messages: stepInputMessages,
 						initialMessages,
 						responseMessages: accumulatedResponseMessages,
+						...steeringMessages.length > 0 ? { experimental_steeringMessages: steeringMessages } : {},
 						toolsContext,
 						runtimeContext,
 						experimental_sandbox: sandbox
@@ -9814,6 +10055,10 @@ var DefaultStreamTextResult = class {
 						toolCallerMessages
 					});
 					currentStepMessages = stepMessages;
+					currentStepSteeringMessages = steeringRun?.resolveTakenMessages({
+						stepNumber: currentStep,
+						sentMessages: stepMessages
+					}) ?? [];
 					const stepInstructions = prepareStepResult?.instructions ?? prepareStepResult?.system ?? instructionsForNextStep;
 					instructionsForNextStep = stepInstructions;
 					const stepProviderOptions = mergeObjects(providerOptions, prepareStepResult?.providerOptions);
@@ -9852,29 +10097,31 @@ var DefaultStreamTextResult = class {
 						onStart: async ({ promptMessages }) => {
 							if (hasNotifiedStepStart) return;
 							hasNotifiedStepStart = true;
+							const stepStartEvent = {
+								callId,
+								provider: stepModel.provider,
+								modelId: stepModel.modelId,
+								stepNumber: recordedSteps.length,
+								instructions: stepInstructions,
+								messages: stepMessages,
+								tools,
+								toolChoice: prepareStepResult?.toolChoice ?? toolChoice,
+								activeTools: prepareStepResult?.activeTools ?? activeTools,
+								toolOrder: stepToolOrder,
+								steps: [...recordedSteps],
+								providerOptions: stepProviderOptions,
+								runtimeContext,
+								toolsContext,
+								output,
+								promptMessages,
+								stepTools,
+								stepToolChoice
+							};
 							await notify({
-								event: {
-									callId,
-									provider: stepModel.provider,
-									modelId: stepModel.modelId,
-									stepNumber: recordedSteps.length,
-									instructions: stepInstructions,
-									messages: stepMessages,
-									tools,
-									toolChoice: prepareStepResult?.toolChoice ?? toolChoice,
-									activeTools: prepareStepResult?.activeTools ?? activeTools,
-									toolOrder: stepToolOrder,
-									steps: [...recordedSteps],
-									providerOptions: stepProviderOptions,
-									runtimeContext,
-									toolsContext,
-									output,
-									promptMessages,
-									stepTools,
-									stepToolChoice
-								},
+								event: stepStartEvent,
 								callbacks: [onStepStart, telemetryDispatcher.onStepStart]
 							});
+							openStep = { event: stepStartEvent };
 						},
 						_internal: {
 							now,
@@ -10255,15 +10502,36 @@ var DefaultStreamTextResult = class {
 							}
 							for (const output of stepToolOutputs) if (output.type === "tool-result" || output.type === "tool-error") pendingDeferredToolCalls.delete(output.toolCallId);
 							cleanupStepTimeouts();
-							if (stepFinishReason !== "interrupted" && clientToolCalls.length === clientToolOutputs.length + deniedToolApprovalResponses.length && (clientToolCalls.length > 0 || pendingDeferredToolCalls.size > 0) && !await isStopConditionMet({
-								stopConditions,
-								steps: recordedSteps
-							})) try {
+							let steeringEndReason = "finished";
+							const shouldStartNextStep = async () => {
+								if (stepFinishReason === "interrupted") return false;
+								if (clientToolCalls.length !== clientToolOutputs.length + deniedToolApprovalResponses.length) {
+									steeringEndReason = "waiting-for-tool-results";
+									return false;
+								}
+								if (clientToolCalls.length === 0 && pendingDeferredToolCalls.size === 0) {
+									if (!steeringRun?.hasPendingMessages()) return false;
+									if (stepFinishReason === "error") {
+										steeringEndReason = "error";
+										return false;
+									}
+								}
+								if (await isStopConditionMet({
+									stopConditions,
+									steps: recordedSteps
+								})) {
+									steeringEndReason = "stop-condition";
+									return false;
+								}
+								return true;
+							};
+							if (await shouldStartNextStep()) try {
 								await runInStreamTextTracingChannelContext(() => streamStep({
 									currentStep: currentStep + 1,
 									usage: combinedUsage
 								}));
 							} catch (error) {
+								steeringRun?.end("error");
 								enqueueStepPart(controller, {
 									type: "error",
 									error
@@ -10271,6 +10539,7 @@ var DefaultStreamTextResult = class {
 								self.closeStream();
 							}
 							else {
+								steeringRun?.end(steeringEndReason);
 								enqueueStepPart(controller, {
 									type: "finish",
 									finishReason: stepFinishReason,
@@ -10294,6 +10563,8 @@ var DefaultStreamTextResult = class {
 				usage: createNullLanguageModelUsage()
 			}));
 		})().catch(async (error) => {
+			steeringRun?.end(abortSignal?.aborted ? "aborted" : "error");
+			await notifyStepError(wrapGatewayError(error));
 			await telemetryDispatcher.onError?.({
 				callId,
 				error
@@ -10579,6 +10850,21 @@ var DefaultStreamTextResult = class {
 	}
 };
 //#endregion
+//#region src/util/is-caused-by-abort.ts
+/**
+* Checks if the error is an abort or timeout error, or is caused by one.
+* Providers can wrap the abort or timeout error, e.g. as the cause of an
+* API call error.
+*/
+function isCausedByAbort(error) {
+	let current = error;
+	for (let depth = 0; current != null && depth < 5; depth++) {
+		if (isAbortError(current)) return true;
+		current = current.cause;
+	}
+	return false;
+}
+//#endregion
 //#region src/agent/default-stop-condition.ts
 /**
 * Stop conditions are only evaluated when the tool loop can otherwise continue,
@@ -10645,7 +10931,7 @@ var ToolLoopAgent = class {
 				options: validatedOptions
 			};
 		}
-		const { onStart: _settingsStableOnStart, experimental_onStart: _settingsExperimentalOnStart, onStepStart: _settingsStableOnStepStart, experimental_onStepStart: _settingsExperimentalOnStepStart, onToolExecutionStart: _settingsOnToolExecutionStart, onToolExecutionEnd: _settingsOnToolExecutionEnd, onStepEnd: _settingsOnStepEnd, onStepFinish: _settingsOnStepFinish, onFinish: _settingsOnFinish, onEnd: _settingsOnEnd, ...settingsWithoutCallbacks } = this.settings;
+		const { onStart: _settingsStableOnStart, experimental_onStart: _settingsExperimentalOnStart, onStepStart: _settingsStableOnStepStart, experimental_onStepStart: _settingsExperimentalOnStepStart, onToolExecutionStart: _settingsOnToolExecutionStart, onToolExecutionEnd: _settingsOnToolExecutionEnd, onStepEnd: _settingsOnStepEnd, onStepFinish: _settingsOnStepFinish, onError: _settingsOnError, onAbort: _settingsOnAbort, onFinish: _settingsOnFinish, onEnd: _settingsOnEnd, ...settingsWithoutCallbacks } = this.settings;
 		const baseCallArgs = {
 			...settingsWithoutCallbacks,
 			stopWhen: this.settings.stopWhen ?? createDefaultStopCondition(20),
@@ -10679,7 +10965,7 @@ var ToolLoopAgent = class {
 	/**
 	* Generates an output from the agent (non-streaming).
 	*/
-	async generate({ abortSignal, timeout, experimental_sandbox: sandbox, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd = onFinish, ...options }) {
+	async generate({ abortSignal, timeout, experimental_sandbox: sandbox, experimental_steering: steering, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd = onFinish, ...options }) {
 		const generate = generateText;
 		const preparedCall = await this.prepareCall({
 			...options,
@@ -10689,6 +10975,7 @@ var ToolLoopAgent = class {
 			abortSignal,
 			timeout: timeout ?? preparedCall.timeout,
 			experimental_sandbox: sandbox,
+			experimental_steering: steering,
 			onStart: mergeCallbacks(this.settings.onStart ?? this.settings.experimental_onStart, onStart ?? experimental_onStart),
 			onStepStart: mergeCallbacks(this.settings.onStepStart ?? this.settings.experimental_onStepStart, onStepStart ?? experimental_onStepStart),
 			onToolExecutionStart: mergeCallbacks(this.settings.onToolExecutionStart, onToolExecutionStart),
@@ -10696,16 +10983,24 @@ var ToolLoopAgent = class {
 			onStepEnd: mergeCallbacks(this.settings.onStepEnd ?? this.settings.onStepFinish, onStepEnd ?? onStepFinish),
 			onEnd: mergeCallbacks(this.settings.onEnd, onEnd)
 		};
-		return await generate({
-			...preparedCall,
-			...callbackArgs,
-			headers: this.agentHeaders(preparedCall)
-		});
+		try {
+			return await generate({
+				...preparedCall,
+				...callbackArgs,
+				headers: this.agentHeaders(preparedCall)
+			});
+		} catch (error) {
+			if (!isCausedByAbort(error) && !abortSignal?.aborted) await notify({
+				event: { error },
+				callbacks: this.settings.onError
+			});
+			throw error;
+		}
 	}
 	/**
 	* Streams an output from the agent (streaming).
 	*/
-	async stream({ abortSignal, timeout, experimental_sandbox: sandbox, experimental_transform, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd = onFinish, ...options }) {
+	async stream({ abortSignal, timeout, experimental_sandbox: sandbox, experimental_steering: steering, experimental_transform, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd = onFinish, ...options }) {
 		const stream = streamText;
 		const preparedCall = await this.prepareCall({
 			...options,
@@ -10715,13 +11010,16 @@ var ToolLoopAgent = class {
 			abortSignal,
 			timeout: timeout ?? preparedCall.timeout,
 			experimental_sandbox: sandbox,
+			experimental_steering: steering,
 			experimental_transform,
 			onStart: mergeCallbacks(this.settings.onStart ?? this.settings.experimental_onStart, onStart ?? experimental_onStart),
 			onStepStart: mergeCallbacks(this.settings.onStepStart ?? this.settings.experimental_onStepStart, onStepStart ?? experimental_onStepStart),
 			onToolExecutionStart: mergeCallbacks(this.settings.onToolExecutionStart, onToolExecutionStart),
 			onToolExecutionEnd: mergeCallbacks(this.settings.onToolExecutionEnd, onToolExecutionEnd),
 			onStepEnd: mergeCallbacks(this.settings.onStepEnd ?? this.settings.onStepFinish, onStepEnd ?? onStepFinish),
-			onEnd: mergeCallbacks(this.settings.onEnd, onEnd)
+			onEnd: mergeCallbacks(this.settings.onEnd, onEnd),
+			onError: this.settings.onError,
+			onAbort: this.settings.onAbort
 		};
 		return await stream({
 			...preparedCall,
@@ -11679,6 +11977,7 @@ async function validateUIMessagesForAgent(options) {
 * @param abortSignal - The abort signal. Optional.
 * @param timeout - Timeout in milliseconds. Optional.
 * @param experimental_sandbox - The sandbox environment that is passed through to tool execution. Optional.
+* @param experimental_steering - A steering object that adds user messages to the run at the next step boundary. Only supported by `ToolLoopAgent`. Optional.
 * @param options - The options for the agent.
 * @param experimental_transform - The stream transformations. Optional.
 * @param onStepEnd - Callback that is called when each step ends. Optional.
@@ -11687,7 +11986,12 @@ async function validateUIMessagesForAgent(options) {
 *
 * @returns The UI message stream.
 */
-async function createAgentUIStream({ agent, uiMessages, convertDataPart, options, abortSignal, timeout, experimental_sandbox: sandbox, experimental_transform, onStepEnd, onStepFinish, onUIMessageStepEnd, ...uiMessageStreamOptions }) {
+async function createAgentUIStream({ agent, uiMessages, convertDataPart, options, abortSignal, timeout, experimental_sandbox: sandbox, experimental_steering: steering, experimental_transform, onStepEnd, onStepFinish, onUIMessageStepEnd, ...uiMessageStreamOptions }) {
+	if (steering != null && !(agent instanceof ToolLoopAgent)) throw new InvalidArgumentError({
+		parameter: "experimental_steering",
+		value: steering,
+		message: "Steering is only supported by ToolLoopAgent."
+	});
 	const validatedMessages = await validateUIMessagesForAgent({
 		messages: uiMessages,
 		tools: agent.tools
@@ -11702,6 +12006,7 @@ async function createAgentUIStream({ agent, uiMessages, convertDataPart, options
 		abortSignal,
 		timeout,
 		experimental_sandbox: sandbox,
+		experimental_steering: steering,
 		experimental_transform,
 		onStepEnd: onStepEnd ?? onStepFinish
 	});
@@ -11725,6 +12030,7 @@ async function createAgentUIStream({ agent, uiMessages, convertDataPart, options
 * @param abortSignal - Abort signal. Optional.
 * @param timeout - Timeout in milliseconds. Optional.
 * @param experimental_sandbox - The sandbox environment that is passed through to tool execution. Optional.
+* @param experimental_steering - A steering object that adds user messages to the run at the next step boundary. Only supported by `ToolLoopAgent`. Optional.
 * @param options - The options for the agent. Optional.
 * @param experimental_transform - Stream transformations. Optional.
 * @param onStepEnd - Callback that is called when each step ends. Optional.
@@ -11760,6 +12066,7 @@ async function createAgentUIStreamResponse({ headers, status, statusText, keepAl
 * @param abortSignal - Abort signal. Optional.
 * @param timeout - Timeout in milliseconds. Optional.
 * @param experimental_sandbox - The sandbox environment that is passed through to tool execution. Optional.
+* @param experimental_steering - A steering object that adds user messages to the run at the next step boundary. Only supported by `ToolLoopAgent`. Optional.
 * @param options - The options for the agent. Optional.
 * @param experimental_transform - Stream transformations. Optional.
 * @param onStepEnd - Callback that is called when each step ends. Optional.
@@ -13911,7 +14218,7 @@ async function generateObject(options) {
 			},
 			callbacks: [resolvedOnStepEnd, telemetryDispatcher.onObjectStepEnd]
 		});
-		const object = await parseAndValidateObjectResultWithRepair(text, outputStrategy, repairText, {
+		const object = await parseAndValidateObjectResultWithRepair(generateResult.structuredOutputText ?? text, outputStrategy, repairText, {
 			response,
 			usage,
 			finishReason
@@ -15937,7 +16244,7 @@ function extractJsonMiddleware(options) {
 	return {
 		specificationVersion: "v4",
 		wrapGenerate: async ({ doGenerate }) => {
-			const { content, ...rest } = await doGenerate();
+			const { content, structuredOutputText, ...rest } = await doGenerate();
 			const transformedContent = [];
 			for (const part of content) {
 				if (part.type !== "text") {
@@ -15951,7 +16258,8 @@ function extractJsonMiddleware(options) {
 			}
 			return {
 				content: transformedContent,
-				...rest
+				...rest,
+				...structuredOutputText != null && { structuredOutputText: transform(structuredOutputText) }
 			};
 		},
 		wrapStream: async ({ doStream }) => {
@@ -16083,43 +16391,55 @@ function extractReasoningMiddleware({ tagName, separator = "\n", startWithReason
 	});
 	const escapedOpeningTag = openingTag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 	const escapedClosingTag = closingTag.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+	function extractReasoning(input) {
+		const text = startWithReasoning ? openingTag + input : input;
+		const regexp = new RegExp(`${escapedOpeningTag}(.*?)${escapedClosingTag}`, "gs");
+		const matches = Array.from(text.matchAll(regexp));
+		if (!matches.length) return {
+			text: input,
+			reasoning: void 0
+		};
+		const reasoning = matches.map((match) => match[1]).join(separator);
+		let textWithoutReasoning = text;
+		for (let i = matches.length - 1; i >= 0; i--) {
+			const match = matches[i];
+			const beforeMatch = textWithoutReasoning.slice(0, match.index);
+			const afterMatch = textWithoutReasoning.slice(match.index + match[0].length);
+			textWithoutReasoning = beforeMatch + (beforeMatch.length > 0 && afterMatch.length > 0 ? separator : "") + afterMatch;
+		}
+		return {
+			text: textWithoutReasoning,
+			reasoning
+		};
+	}
 	return {
 		specificationVersion: "v4",
 		wrapGenerate: async ({ doGenerate }) => {
-			const { content, ...rest } = await doGenerate();
+			const { content, structuredOutputText, ...rest } = await doGenerate();
 			const transformedContent = [];
 			for (const part of content) {
 				if (part.type !== "text") {
 					transformedContent.push(part);
 					continue;
 				}
-				const text = startWithReasoning ? openingTag + part.text : part.text;
-				const regexp = new RegExp(`${escapedOpeningTag}(.*?)${escapedClosingTag}`, "gs");
-				const matches = Array.from(text.matchAll(regexp));
-				if (!matches.length) {
+				const { text, reasoning } = extractReasoning(part.text);
+				if (reasoning === void 0) {
 					transformedContent.push(part);
 					continue;
 				}
-				const reasoningText = matches.map((match) => match[1]).join(separator);
-				let textWithoutReasoning = text;
-				for (let i = matches.length - 1; i >= 0; i--) {
-					const match = matches[i];
-					const beforeMatch = textWithoutReasoning.slice(0, match.index);
-					const afterMatch = textWithoutReasoning.slice(match.index + match[0].length);
-					textWithoutReasoning = beforeMatch + (beforeMatch.length > 0 && afterMatch.length > 0 ? separator : "") + afterMatch;
-				}
 				transformedContent.push({
 					type: "reasoning",
-					text: reasoningText
+					text: reasoning
 				});
 				transformedContent.push({
 					type: "text",
-					text: textWithoutReasoning
+					text
 				});
 			}
 			return {
 				content: transformedContent,
-				...rest
+				...rest,
+				...structuredOutputText != null && { structuredOutputText: extractReasoning(structuredOutputText).text }
 			};
 		},
 		wrapStream: async ({ doStream }) => {
@@ -21484,6 +21804,6 @@ async function uploadSkill({ api, files, displayTitle, providerOptions }) {
 	});
 }
 //#endregion
-export { AISDKError, AI_SDK_TELEMETRY_TRACING_CHANNEL, APICallError, AbstractChat, DefaultChatTransport, DefaultGeneratedFile, DirectChatTransport, DownloadError, EmptyResponseBodyError, AbstractRealtimeSession as Experimental_AbstractRealtimeSession, ToolLoopAgent as Experimental_Agent, ToolLoopAgent, Experimental_DecisionRefusalError, Experimental_DecisionUnsupportedQuestionTypeError, Experimental_EvaluationUnsupportedQuestionTypeError, HttpChatTransport, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidPromptError, InvalidResponseDataError, InvalidStreamPartError, InvalidToolApprovalError, InvalidToolApprovalSignatureError, InvalidToolInputError, JSONParseError, JsonToSseTransformStream, LoadAPIKeyError, LoadSettingError, MessageConversionError, MissingToolResultsError, NoContentGeneratedError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoSpeechGeneratedError, NoSuchModelError, NoSuchProviderError, NoSuchProviderReferenceError, NoSuchToolError, NoTranscriptGeneratedError, NoTranslationGeneratedError, NoVideoGeneratedError, output_exports as Output, RetryError, SerialJobExecutor, StreamProviderError, TextStreamChatTransport, TooManyEmbeddingValuesForCallError, ToolCallNotFoundForApprovalError, ToolCallRepairError, ToolChoiceViolationError, TypeValidationError, UIMessageStreamError, UI_MESSAGE_STREAM_HEADERS, UnsupportedFunctionalityError, UnsupportedModelVersionError, WebSocketChatTransport, addToolInputExamplesMiddleware, asSchema, assistantModelMessageSchema, callCompletionApi, consumeStream, convertDataContentToBase64String, convertFileListToFileUIParts, convertToModelMessages, cosineSimilarity, createAgentUIStream, createAgentUIStreamResponse, createDownload, createGateway, createIdGenerator, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultEmbeddingSettingsMiddleware, defaultInstructionsMiddleware, defaultSettingsMiddleware, detectToolDrift, dynamicTool, embed, embedMany, cancelBatch as experimental_cancelBatch, experimental_createProviderRegistry, decide as experimental_decide, decodeRealtimeAudio as experimental_decodeRealtimeAudio, encodeRealtimeAudio as experimental_encodeRealtimeAudio, experimental_evaluate, filterActiveTools as experimental_filterActiveTools, experimental_generateSpeech, experimental_generateVideo, getBatchResults as experimental_getBatchResults, getBatchStatus as experimental_getBatchStatus, getRealtimeToolDefinitions as experimental_getRealtimeToolDefinitions, experimental_getVideoStatus, listBatches as experimental_listBatches, resampleAudio as experimental_resampleAudio, startBatch as experimental_startBatch, experimental_startVideo, streamLanguageModelCall as experimental_streamLanguageModelCall, streamSpeech as experimental_streamSpeech, streamTextLowMemory as experimental_streamTextLowMemory, streamTranscribe as experimental_streamTranscribe, streamTranslate as experimental_streamTranslate, experimental_toolCaller, experimental_transcribe, extractJsonMiddleware, extractReasoningMiddleware, fingerprintTools, gateway, generateId, generateImage, generateObject, generateSpeech, generateText, getChunkTimeoutMs, getFirstChunkTimeoutMs, getStaticToolName, getStepTimeoutMs, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, getToolTimeoutMs, getTotalTimeoutMs, hasToolCall, isCustomContentUIPart, isDataUIPart, isDeepEqualData, isDynamicToolUIPart, isFileUIPart, isLoopFinished, isReasoningFileUIPart, isReasoningUIPart, isStaticToolUIPart, isStepCount, isStepCount as stepCountIs, isTextUIPart, isToolOutputErrorUIPart, isToolUIPart, jsonSchema, lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parseJsonEventStream, parsePartialJson, pipeAgentUIStreamToResponse, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, pruneMessages, readUIMessageStream, registerTelemetry, rerank, safeValidateUIMessages, safeValidateWebSocketChatTransportRequest, simulateReadableStream, simulateStreamingMiddleware, smoothStream, streamObject, streamText, systemModelMessageSchema, toTextStream, toUIMessageChunk, toUIMessageStream, tool, toolModelMessageSchema, toolSearch, transcribe, uiMessageChunkSchema, uploadFile, uploadSkill, userModelMessageSchema, validateUIMessages, wrapEmbeddingModel, wrapImageModel, wrapLanguageModel, wrapProvider, zodSchema };
+export { AISDKError, AI_SDK_TELEMETRY_TRACING_CHANNEL, APICallError, AbstractChat, DefaultChatTransport, DefaultGeneratedFile, DirectChatTransport, DownloadError, EmptyResponseBodyError, AbstractRealtimeSession as Experimental_AbstractRealtimeSession, ToolLoopAgent as Experimental_Agent, ToolLoopAgent, Experimental_DecisionRefusalError, Experimental_DecisionUnsupportedQuestionTypeError, Experimental_EvaluationUnsupportedQuestionTypeError, HttpChatTransport, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidPromptError, InvalidResponseDataError, InvalidStreamPartError, InvalidToolApprovalError, InvalidToolApprovalSignatureError, InvalidToolInputError, JSONParseError, JsonToSseTransformStream, LoadAPIKeyError, LoadSettingError, MessageConversionError, MissingToolResultsError, NoContentGeneratedError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoSpeechGeneratedError, NoSuchModelError, NoSuchProviderError, NoSuchProviderReferenceError, NoSuchToolError, NoTranscriptGeneratedError, NoTranslationGeneratedError, NoVideoGeneratedError, output_exports as Output, RetryError, SerialJobExecutor, StreamProviderError, TextStreamChatTransport, TooManyEmbeddingValuesForCallError, ToolCallNotFoundForApprovalError, ToolCallRepairError, ToolChoiceViolationError, TypeValidationError, UIMessageStreamError, UI_MESSAGE_STREAM_HEADERS, UnsupportedFunctionalityError, UnsupportedModelVersionError, WebSocketChatTransport, addToolInputExamplesMiddleware, asSchema, assistantModelMessageSchema, callCompletionApi, consumeStream, convertDataContentToBase64String, convertFileListToFileUIParts, convertToModelMessages, cosineSimilarity, createAgentUIStream, createAgentUIStreamResponse, createDownload, createGateway, createIdGenerator, createProviderRegistry, createTextStreamResponse, createUIMessageStream, createUIMessageStreamResponse, customProvider, defaultEmbeddingSettingsMiddleware, defaultInstructionsMiddleware, defaultSettingsMiddleware, detectToolDrift, dynamicTool, embed, embedMany, cancelBatch as experimental_cancelBatch, experimental_createProviderRegistry, createSteering as experimental_createSteering, decide as experimental_decide, decodeRealtimeAudio as experimental_decodeRealtimeAudio, encodeRealtimeAudio as experimental_encodeRealtimeAudio, experimental_evaluate, filterActiveTools as experimental_filterActiveTools, experimental_generateSpeech, experimental_generateVideo, getBatchResults as experimental_getBatchResults, getBatchStatus as experimental_getBatchStatus, getRealtimeToolDefinitions as experimental_getRealtimeToolDefinitions, experimental_getVideoStatus, listBatches as experimental_listBatches, resampleAudio as experimental_resampleAudio, startBatch as experimental_startBatch, experimental_startVideo, streamLanguageModelCall as experimental_streamLanguageModelCall, streamSpeech as experimental_streamSpeech, streamTextLowMemory as experimental_streamTextLowMemory, streamTranscribe as experimental_streamTranscribe, streamTranslate as experimental_streamTranslate, experimental_toolCaller, experimental_transcribe, extractJsonMiddleware, extractReasoningMiddleware, fingerprintTools, gateway, generateId, generateImage, generateObject, generateSpeech, generateText, getChunkTimeoutMs, getFirstChunkTimeoutMs, getStaticToolName, getStepTimeoutMs, getTextFromDataUrl, getToolName, getToolOrDynamicToolName, getToolTimeoutMs, getTotalTimeoutMs, hasToolCall, isCustomContentUIPart, isDataUIPart, isDeepEqualData, isDynamicToolUIPart, isFileUIPart, isLoopFinished, isReasoningFileUIPart, isReasoningUIPart, isStaticToolUIPart, isStepCount, isStepCount as stepCountIs, isTextUIPart, isToolOutputErrorUIPart, isToolUIPart, jsonSchema, lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parseJsonEventStream, parsePartialJson, pipeAgentUIStreamToResponse, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, pruneMessages, readUIMessageStream, registerTelemetry, rerank, safeValidateUIMessages, safeValidateWebSocketChatTransportRequest, simulateReadableStream, simulateStreamingMiddleware, smoothStream, streamObject, streamText, systemModelMessageSchema, toTextStream, toUIMessageChunk, toUIMessageStream, tool, toolModelMessageSchema, toolSearch, transcribe, uiMessageChunkSchema, uploadFile, uploadSkill, userModelMessageSchema, validateUIMessages, wrapEmbeddingModel, wrapImageModel, wrapLanguageModel, wrapProvider, zodSchema };
 
 //# sourceMappingURL=index.js.map