ai 7.0.142 → 7.0.143

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # ai
 
+## 7.0.143
+
+### Patch Changes
+
+- 8a5233b: Generate default chat IDs on first access so `useChat()` can prerender without reading a random value when the ID is not used during rendering.
+- 894e130: fix(ai): add `experimental_lowMemory: true` to `streamText` for single-consumer streaming without a replay buffer or retained final-content results, reducing memory retention.
+- 0957554: Add `box` decision question type with image bounds for TypeSafe AI.
+- Updated dependencies [0957554]
+  - @ai-sdk/provider@4.0.29
+  - @ai-sdk/provider-utils@5.0.62
+  - @ai-sdk/gateway@4.0.116
+
 ## 7.0.142
 
 ### Patch Changes

package/dist/index.d.ts

@@ -572,6 +572,16 @@ type DecisionAnswer<QUESTION extends Experimental_DecisionModelV4Question> = QUE
   type: 'score';
   score: number;
   probabilities?: Record<string, number>;
+} : QUESTION extends {
+  type: 'box';
+} ? {
+  type: 'box';
+  box: {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+  };
 } : {
   type: 'boolean';
   probability: number;
@@ -1794,205 +1804,6 @@ type OnLanguageModelCallStartCallback = Callback<LanguageModelCallStartEvent>;
  */
 type OnLanguageModelCallEndCallback<TOOLS extends ToolSet$1 = ToolSet$1> = Callback<LanguageModelCallEndEvent<TOOLS>>;
 //#endregion
-//#region src/generate-text/output-utils.d.ts
-/**
- * Infers the complete output type from the output specification.
- */
-type InferCompleteOutput<OUTPUT extends Output> = OUTPUT extends Output<infer COMPLETE_OUTPUT, any, any> ? COMPLETE_OUTPUT : never;
-/**
- * Infers the partial output type from the output specification.
- */
-type InferPartialOutput<OUTPUT extends Output> = OUTPUT extends Output<any, infer PARTIAL_OUTPUT, any> ? PARTIAL_OUTPUT : never;
-/**
- * Infers the element type from an array output specification.
- */
-type InferElementOutput<OUTPUT extends Output> = OUTPUT extends Output<any, any, infer ELEMENT> ? ELEMENT : never;
-//#endregion
-//#region src/generate-text/tool-order.d.ts
-/**
- * Tool names that define the order in which tools are sent to the provider.
- *
- * Tool names are object keys at runtime, so the type is restricted to the
- * string keys of the configured tool set. The list can be partial; tools not
- * listed in `toolOrder` are sent after the listed tools, sorted alphabetically.
- */
-type ToolOrder<TOOLS extends ToolSet$1> = ReadonlyArray<keyof TOOLS & string> | undefined;
-//#endregion
-//#region src/generate-text/prepare-step.d.ts
-/**
- * Function that you can use to provide different settings for a step.
- *
- * @param options - The options for the step.
- * @param options.steps - The steps that have been executed so far.
- * @param options.stepNumber - The number of the step that is being executed.
- * @param options.model - The model that is being used.
- * @param options.instructions - The instructions that will be sent to the model for the current step.
- * @param options.initialInstructions - The initial instructions that were passed into generateText or streamText.
- * @param options.messages - The messages that will be sent to the model for the current step. If you return a `messages` override, those messages carry forward to later steps.
- * @param options.initialMessages - The initial messages that were passed into generateText or streamText.
- * @param options.responseMessages - The response messages that have been accumulated from previous steps.
- * @param options.runtimeContext - The user-defined runtime context.
- *
- * @returns An object that contains the settings for the step.
- * If you return undefined (or for undefined settings), the settings from the outer level will be used.
- */
-type PrepareStepFunction<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context> = (options: {
-  /**
-   * The steps that have been executed so far.
-   */
-  steps: Array<StepResult<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>>;
-  /**
-   * The number of the step that is being executed.
-   */
-  stepNumber: number;
-  /**
-   * The model instance that is being used for this step.
-   */
-  model: LanguageModel;
-  /**
-   * The instructions that will be sent to the model for the current step.
-   */
-  instructions: Instructions | undefined;
-  /**
-   * The initial instructions that were passed into generateText or streamText.
-   */
-  initialInstructions: Instructions | undefined;
-  /**
-   * The messages that will be sent to the model for the current step.
-   * If you return a `messages` override, those messages carry forward to later steps.
-   */
-  messages: Array<ModelMessage$1>;
-  /**
-   * The initial messages that were passed into generateText or streamText.
-   */
-  initialMessages: Array<ModelMessage$1>;
-  /**
-   * The response messages that have been accumulated from all previous steps.
-   */
-  responseMessages: Array<ResponseMessage>;
-  /**
-   * Tool context.
-   */
-  toolsContext: InferToolSetContext<TOOLS>;
-  /**
-   * User-defined runtime context.
-   */
-  runtimeContext: RUNTIME_CONTEXT;
-  /**
-   * The sandbox environment that the step is operating in.
-   */
-  experimental_sandbox?: Experimental_SandboxSession$1;
-}) => PromiseLike<PrepareStepResult<TOOLS, RUNTIME_CONTEXT>> | PrepareStepResult<TOOLS, RUNTIME_CONTEXT>;
-/**
- * The result type returned by a {@link PrepareStepFunction},
- * allowing per-step overrides of model call settings, model, tools,
- * instructions, or messages.
- *
- * Model call setting overrides apply only to the current step. Undefined
- * settings fall back to the outer call settings.
- */
-type PrepareStepResult<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context> = ({
-  /**
-   * Optionally override which LanguageModel instance is used for this step.
-   */
-  model?: LanguageModel;
-  /**
-   * Optionally set which tool the model must call, or provide tool call configuration
-   * for this step.
-   */
-  toolChoice?: ToolChoice<NoInfer<TOOLS>>;
-  /**
-   * If provided, only these tools are enabled/available for this step.
-   */
-  activeTools?: ActiveTools<NoInfer<TOOLS>>;
-  /**
-   * Optionally override the order in which tools are sent to the provider
-   * for this step.
-   */
-  toolOrder?: ToolOrder<NoInfer<TOOLS>>;
-  /**
-   * Optionally override the instructions sent to the model for this step.
-   * The override carries forward to later steps.
-   */
-  instructions?: Instructions;
-  /**
-   * Optionally override the instructions sent to the model for this step.
-   *
-   * @deprecated Use `instructions` instead.
-   */
-  system?: Instructions;
-  /**
-   * Optionally override the full set of messages sent to the model
-   * for this step. The override carries forward to later steps.
-   */
-  messages?: Array<ModelMessage$1>;
-  /**
-   * Tool context.
-   *
-   * Changing the toolsContext will affect the toolsContext in this step
-   * and all subsequent steps.
-   *
-   * The toolsContext is passed into tool execution.
-   */
-  toolsContext?: InferToolSetContext<TOOLS>;
-  /**
-   * Runtime context.
-   *
-   * Changing the runtimeContext will affect the runtimeContext in this step
-   * and all subsequent steps.
-   */
-  runtimeContext?: RUNTIME_CONTEXT;
-  /**
-   * The sandbox environment that the step is operating in.
-   *
-   * Changing the sandbox will affect tool execution in this step only.
-   */
-  experimental_sandbox?: Experimental_SandboxSession$1;
-  /**
-   * Additional provider-specific options for this step.
-   *
-   * Can be used to pass provider-specific configuration such as
-   * container IDs for Anthropic's code execution.
-   */
-  providerOptions?: ProviderOptions;
-} & LanguageModelCallOptions) | undefined;
-//#endregion
-//#region src/generate-text/stop-condition.d.ts
-/**
- * A predicate that decides whether a tool-calling loop should stop after the
- * current step.
- *
- * A tool calling loop continues until one of the following conditions is met:
- * - The model returns a finish reason other than `tool-calls`
- * - A tool without an execute function is called
- * - A tool call needs approval
- * - One of the provided stop conditions returns `true`
- */
-type StopCondition<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context> = (options: {
-  steps: Array<StepResult<TOOLS, RUNTIME_CONTEXT>>;
-}) => PromiseLike<boolean> | boolean;
-/**
- * Creates a stop condition that returns `true` when the number of completed
- * steps equals `stepCount`.
- *
- * @param stepCount - The number of steps to allow before stopping.
- */
-export declare function isStepCount(stepCount: number): StopCondition<any, any>;
-/**
- * Creates a stop condition that never returns `true`.
- *
- * This lets the tool-calling loop continue until it reaches one of its
- * natural termination conditions.
- */
-export declare function isLoopFinished(): StopCondition<any, any>;
-/**
- * Creates a stop condition that returns `true` when the most recent step
- * contains a tool call with any of the specified names.
- *
- * @param toolName - The names of the tools that should stop the loop.
- */
-export declare function hasToolCall<TOOLS extends ToolSet$1>(...toolName: Array<keyof TOOLS | (string & {})>): StopCondition<TOOLS, any>;
-//#endregion
 //#region src/ui/ui-messages.d.ts
 /**
  * The data types that can be used in the UI message for the UI message data parts.
@@ -2826,6 +2637,20 @@ type AsyncIterableStream<T> = AsyncIterable<T> & ReadableStream<T>;
 //#region src/util/error-handler.d.ts
 type ErrorHandler = (error: unknown) => void;
 //#endregion
+//#region src/generate-text/output-utils.d.ts
+/**
+ * Infers the complete output type from the output specification.
+ */
+type InferCompleteOutput<OUTPUT extends Output> = OUTPUT extends Output<infer COMPLETE_OUTPUT, any, any> ? COMPLETE_OUTPUT : never;
+/**
+ * Infers the partial output type from the output specification.
+ */
+type InferPartialOutput<OUTPUT extends Output> = OUTPUT extends Output<any, infer PARTIAL_OUTPUT, any> ? PARTIAL_OUTPUT : never;
+/**
+ * Infers the element type from an array output specification.
+ */
+type InferElementOutput<OUTPUT extends Output> = OUTPUT extends Output<any, any, infer ELEMENT> ? ELEMENT : never;
+//#endregion
 //#region src/generate-text/tool-output-denied.d.ts
 /**
  * Tool output when the tool execution has been denied (for static tools).
@@ -3302,6 +3127,195 @@ type TextStreamRawPart = {
 };
 type TextStreamPart<TOOLS extends ToolSet$1> = TextStreamTextStartPart | TextStreamTextEndPart | TextStreamTextDeltaPart | TextStreamReasoningStartPart | TextStreamReasoningEndPart | TextStreamReasoningDeltaPart | TextStreamCustomPart | TextStreamToolInputStartPart | TextStreamToolInputEndPart | TextStreamToolInputDeltaPart | TextStreamSourcePart | TextStreamFilePart | TextStreamReasoningFilePart | TextStreamToolCallPart<TOOLS> | TextStreamToolResultPart<TOOLS> | TextStreamToolErrorPart<TOOLS> | TextStreamToolOutputDeniedPart<TOOLS> | TextStreamToolApprovalRequestPart<TOOLS> | TextStreamToolApprovalResponsePart<TOOLS> | TextStreamStartStepPart | TextStreamFinishStepPart | TextStreamStartPart | TextStreamFinishPart | TextStreamAbortPart | TextStreamErrorPart | TextStreamRawPart;
 //#endregion
+//#region src/generate-text/stream-text-single-consumer-result.d.ts
+/** A single-consumer view of a text generation, without replay or final content getters. */
+type StreamTextSingleConsumerResult<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context, OUTPUT extends Output> = Pick<StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>, 'textStream' | 'stream' | 'fullStream' | 'partialOutputStream' | 'elementStream' | 'totalUsage' | 'usage' | 'finishReason' | 'rawFinishReason' | 'consumeStream' | 'toUIMessageStream' | 'toUIMessageStreamResponse' | 'toTextStreamResponse' | 'pipeUIMessageStreamToResponse' | 'pipeTextStreamToResponse'>;
+//#endregion
+//#region src/generate-text/tool-order.d.ts
+/**
+ * Tool names that define the order in which tools are sent to the provider.
+ *
+ * Tool names are object keys at runtime, so the type is restricted to the
+ * string keys of the configured tool set. The list can be partial; tools not
+ * listed in `toolOrder` are sent after the listed tools, sorted alphabetically.
+ */
+type ToolOrder<TOOLS extends ToolSet$1> = ReadonlyArray<keyof TOOLS & string> | undefined;
+//#endregion
+//#region src/generate-text/prepare-step.d.ts
+/**
+ * Function that you can use to provide different settings for a step.
+ *
+ * @param options - The options for the step.
+ * @param options.steps - The steps that have been executed so far.
+ * @param options.stepNumber - The number of the step that is being executed.
+ * @param options.model - The model that is being used.
+ * @param options.instructions - The instructions that will be sent to the model for the current step.
+ * @param options.initialInstructions - The initial instructions that were passed into generateText or streamText.
+ * @param options.messages - The messages that will be sent to the model for the current step. If you return a `messages` override, those messages carry forward to later steps.
+ * @param options.initialMessages - The initial messages that were passed into generateText or streamText.
+ * @param options.responseMessages - The response messages that have been accumulated from previous steps.
+ * @param options.runtimeContext - The user-defined runtime context.
+ *
+ * @returns An object that contains the settings for the step.
+ * If you return undefined (or for undefined settings), the settings from the outer level will be used.
+ */
+type PrepareStepFunction<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context> = (options: {
+  /**
+   * The steps that have been executed so far.
+   */
+  steps: Array<StepResult<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>>;
+  /**
+   * The number of the step that is being executed.
+   */
+  stepNumber: number;
+  /**
+   * The model instance that is being used for this step.
+   */
+  model: LanguageModel;
+  /**
+   * The instructions that will be sent to the model for the current step.
+   */
+  instructions: Instructions | undefined;
+  /**
+   * The initial instructions that were passed into generateText or streamText.
+   */
+  initialInstructions: Instructions | undefined;
+  /**
+   * The messages that will be sent to the model for the current step.
+   * If you return a `messages` override, those messages carry forward to later steps.
+   */
+  messages: Array<ModelMessage$1>;
+  /**
+   * The initial messages that were passed into generateText or streamText.
+   */
+  initialMessages: Array<ModelMessage$1>;
+  /**
+   * The response messages that have been accumulated from all previous steps.
+   */
+  responseMessages: Array<ResponseMessage>;
+  /**
+   * Tool context.
+   */
+  toolsContext: InferToolSetContext<TOOLS>;
+  /**
+   * User-defined runtime context.
+   */
+  runtimeContext: RUNTIME_CONTEXT;
+  /**
+   * The sandbox environment that the step is operating in.
+   */
+  experimental_sandbox?: Experimental_SandboxSession$1;
+}) => PromiseLike<PrepareStepResult<TOOLS, RUNTIME_CONTEXT>> | PrepareStepResult<TOOLS, RUNTIME_CONTEXT>;
+/**
+ * The result type returned by a {@link PrepareStepFunction},
+ * allowing per-step overrides of model call settings, model, tools,
+ * instructions, or messages.
+ *
+ * Model call setting overrides apply only to the current step. Undefined
+ * settings fall back to the outer call settings.
+ */
+type PrepareStepResult<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context> = ({
+  /**
+   * Optionally override which LanguageModel instance is used for this step.
+   */
+  model?: LanguageModel;
+  /**
+   * Optionally set which tool the model must call, or provide tool call configuration
+   * for this step.
+   */
+  toolChoice?: ToolChoice<NoInfer<TOOLS>>;
+  /**
+   * If provided, only these tools are enabled/available for this step.
+   */
+  activeTools?: ActiveTools<NoInfer<TOOLS>>;
+  /**
+   * Optionally override the order in which tools are sent to the provider
+   * for this step.
+   */
+  toolOrder?: ToolOrder<NoInfer<TOOLS>>;
+  /**
+   * Optionally override the instructions sent to the model for this step.
+   * The override carries forward to later steps.
+   */
+  instructions?: Instructions;
+  /**
+   * Optionally override the instructions sent to the model for this step.
+   *
+   * @deprecated Use `instructions` instead.
+   */
+  system?: Instructions;
+  /**
+   * Optionally override the full set of messages sent to the model
+   * for this step. The override carries forward to later steps.
+   */
+  messages?: Array<ModelMessage$1>;
+  /**
+   * Tool context.
+   *
+   * Changing the toolsContext will affect the toolsContext in this step
+   * and all subsequent steps.
+   *
+   * The toolsContext is passed into tool execution.
+   */
+  toolsContext?: InferToolSetContext<TOOLS>;
+  /**
+   * Runtime context.
+   *
+   * Changing the runtimeContext will affect the runtimeContext in this step
+   * and all subsequent steps.
+   */
+  runtimeContext?: RUNTIME_CONTEXT;
+  /**
+   * The sandbox environment that the step is operating in.
+   *
+   * Changing the sandbox will affect tool execution in this step only.
+   */
+  experimental_sandbox?: Experimental_SandboxSession$1;
+  /**
+   * Additional provider-specific options for this step.
+   *
+   * Can be used to pass provider-specific configuration such as
+   * container IDs for Anthropic's code execution.
+   */
+  providerOptions?: ProviderOptions;
+} & LanguageModelCallOptions) | undefined;
+//#endregion
+//#region src/generate-text/stop-condition.d.ts
+/**
+ * A predicate that decides whether a tool-calling loop should stop after the
+ * current step.
+ *
+ * A tool calling loop continues until one of the following conditions is met:
+ * - The model returns a finish reason other than `tool-calls`
+ * - A tool without an execute function is called
+ * - A tool call needs approval
+ * - One of the provided stop conditions returns `true`
+ */
+type StopCondition<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context> = (options: {
+  steps: Array<StepResult<TOOLS, RUNTIME_CONTEXT>>;
+}) => PromiseLike<boolean> | boolean;
+/**
+ * Creates a stop condition that returns `true` when the number of completed
+ * steps equals `stepCount`.
+ *
+ * @param stepCount - The number of steps to allow before stopping.
+ */
+export declare function isStepCount(stepCount: number): StopCondition<any, any>;
+/**
+ * Creates a stop condition that never returns `true`.
+ *
+ * This lets the tool-calling loop continue until it reaches one of its
+ * natural termination conditions.
+ */
+export declare function isLoopFinished(): StopCondition<any, any>;
+/**
+ * Creates a stop condition that returns `true` when the most recent step
+ * contains a tool call with any of the specified names.
+ *
+ * @param toolName - The names of the tools that should stop the loop.
+ */
+export declare function hasToolCall<TOOLS extends ToolSet$1>(...toolName: Array<keyof TOOLS | (string & {})>): StopCondition<TOOLS, any>;
+//#endregion
 //#region src/generate-text/tool-approval-configuration.d.ts
 /**
  * The approval status of a tool configuration. This can be one of the following:
@@ -3617,6 +3631,13 @@ type ToolsContextParameter<TOOLS extends ToolSet$1> = {
 } & ToolsContextSettings<TOOLS>;
 //#endregion
 //#region src/generate-text/stream-text.d.ts
+/** Internal policy, fixed before the model request starts. */
+type StreamTextRetention = {
+  /** Keep a replay branch for independently consumed stream projections. */
+  replay: boolean;
+  /** Collect complete content for results, callbacks, or subsequent steps. */
+  collectContent: boolean;
+};
 type StreamTextInclude = {
   /**
    * Whether to retain the request body in step results.
@@ -3700,6 +3721,16 @@ type StreamTextOnEndCallback<TOOLS extends ToolSet$1 = ToolSet$1, RUNTIME_CONTEX
  * @param event - The event that is passed to the callback.
  */
 type StreamTextOnAbortCallback<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context> = Callback<GenerateTextAbortEvent<TOOLS, RUNTIME_CONTEXT>>;
+type StreamTextOptions<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context, OUTPUT extends Output> = Parameters<typeof streamTextInternal<TOOLS, RUNTIME_CONTEXT, OUTPUT>>[0] & {
+  /**
+   * Consume the stream once without replay or final-content getters.
+   * Content is collected only when required by tools, output parsing,
+   * full-content callbacks, or telemetry integrations.
+   *
+   * @default false
+   */
+  experimental_lowMemory?: boolean;
+};
 /**
  * Generate a text and call tools for a given prompt using a language model.
  *
@@ -3746,6 +3777,8 @@ type StreamTextOnAbortCallback<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends
  * @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 experimental_lowMemory - Consume the stream once without replay or final-content getters. Default: false.
+ *
  * @param onChunk - Callback that is called for each chunk of the stream. The stream processing will pause until the callback promise is resolved.
  * @param onError - Callback that is called when an error occurs during streaming. You can use it to log errors.
  * @param onStart - Callback invoked when generation begins, before any LLM calls.
@@ -3768,7 +3801,14 @@ type StreamTextOnAbortCallback<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends
  * @returns
  * A result object for accessing different stream types and additional information.
  */
-export declare function streamText<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>({ model, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries, streamRetries, abortSignal, timeout, headers, stopWhen, experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry, prepareStep, providerOptions, activeTools, toolOrder, toolCallConcurrency, experimental_repairToolCall, repairToolCall, experimental_refineToolInput: refineToolInput, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError: onErrorArg, onFinish, onEnd, 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, _internal: { now, generateId, generateCallId }, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
+export declare function streamText<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>(options: StreamTextOptions<TOOLS, RUNTIME_CONTEXT, OUTPUT> & {
+  experimental_lowMemory?: false;
+}): StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+export declare function streamText<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>(options: StreamTextOptions<TOOLS, RUNTIME_CONTEXT, OUTPUT> & {
+  experimental_lowMemory: true;
+}): StreamTextSingleConsumerResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+export declare function streamText<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>(options: StreamTextOptions<TOOLS, RUNTIME_CONTEXT, OUTPUT>): StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT> | StreamTextSingleConsumerResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+declare function streamTextInternal<TOOLS extends ToolSet$1, RUNTIME_CONTEXT extends Context = Context, OUTPUT extends Output = Output<string, string, never>>({ model, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries, streamRetries, abortSignal, timeout, headers, stopWhen, experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry, prepareStep, providerOptions, activeTools, toolOrder, toolCallConcurrency, experimental_repairToolCall, repairToolCall, experimental_refineToolInput: refineToolInput, experimental_transform: transform, experimental_download: download, includeRawChunks, onChunk, onError: onErrorArg, onFinish, onEnd, 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, _internal: { now, generateId, generateCallId, retention }, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
   /**
    * The language model to use.
    */
@@ -4046,6 +4086,8 @@ export declare function streamText<TOOLS extends ToolSet$1, RUNTIME_CONTEXT exte
     now?: () => number;
     generateId?: IdGenerator$1;
     generateCallId?: IdGenerator$1;
+    /** Internal policy used by the streaming-only facade. */
+    retention?: StreamTextRetention;
   };
 }): StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
 type EnrichedStreamPart<TOOLS extends ToolSet$1, PARTIAL_OUTPUT> = {
@@ -6050,7 +6092,7 @@ type ChatOnFinishCallback<UI_MESSAGE extends UIMessage> = (options: {
 interface ChatInit<UI_MESSAGE extends UIMessage> {
   /**
    * A unique identifier for the chat. If not provided, a random one will be
-   * generated.
+   * generated when first accessed.
    */
   id?: string;
   messageMetadataSchema?: FlexibleSchema$1<UI_MESSAGE['metadata']>;
@@ -6093,7 +6135,8 @@ interface ChatInit<UI_MESSAGE extends UIMessage> {
   }) => boolean | PromiseLike<boolean>;
 }
 export declare abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
-  readonly id: string;
+  private _id;
+  get id(): string;
   readonly generateId: IdGenerator$1;
   protected state: ChatState<UI_MESSAGE>;
   private messageMetadataSchema;
@@ -7137,7 +7180,7 @@ type LanguageModelStreamPart<TOOLS extends ToolSet$1 = ToolSet$1> = Exclude<Text
  *
  * @returns A stream of model call parts together with request and response metadata when available.
  */
-declare function streamLanguageModelCall<TOOLS extends ToolSet$1, OUTPUT extends Output = Output>({ model, tools, toolOrder, output, toolChoice, prompt, system, instructions, messages, allowSystemInMessages, download, abortSignal, headers, includeRawChunks, providerOptions, repairToolCall, refineToolInput, executeLanguageModelCallInTelemetryContext, callId, toolsContext, experimental_sandbox: sandbox, _internal: { generateId, generateCallId, now }, onStart, onLanguageModelCallStart, onLanguageModelCallEnd, ...callSettings }: {
+declare function streamLanguageModelCall<TOOLS extends ToolSet$1, OUTPUT extends Output = Output>({ model, tools, toolOrder, output, toolChoice, prompt, system, instructions, messages, allowSystemInMessages, download, abortSignal, headers, includeRawChunks, providerOptions, repairToolCall, refineToolInput, executeLanguageModelCallInTelemetryContext, callId, toolsContext, experimental_sandbox: sandbox, _internal: { generateId, generateCallId, now, collectContent }, onStart, onLanguageModelCallStart, onLanguageModelCallEnd, ...callSettings }: {
   model: LanguageModel;
   tools?: TOOLS;
   toolOrder?: ToolOrder<TOOLS>;
@@ -7165,6 +7208,8 @@ declare function streamLanguageModelCall<TOOLS extends ToolSet$1, OUTPUT extends
     generateId?: IdGenerator$1;
     generateCallId?: IdGenerator$1;
     now?: () => number;
+    /** Internal: content is only needed by collectors and full-content callbacks. */
+    collectContent?: boolean;
   };
   onLanguageModelCallStart?: Arrayable<OnLanguageModelCallStartCallback>;
   onLanguageModelCallEnd?: Arrayable<OnLanguageModelCallEndCallback<TOOLS>>;