@lmnr-ai/lmnr 0.8.53 → 0.8.55

package/dist/index.d.mts

@@ -1,15 +1,14 @@
-import { S as TracingLevel, _ as MaskInputOptions, a as HumanEvaluator, b as SpanType, c as InitializeOptions, d as LaminarClient, f as Dataset, g as LaminarSpanContext, h as Event, i as EvaluatorFunctionReturn, l as EvaluationDataset, m as EvaluationDatapointDatasetLink, o as evaluate, p as EvaluationDatapoint, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset, v as PushDatapointsResponse, x as TraceType, y as SessionRecordingOptions } from "./evaluations-BwB2JsRa.mjs";
+import { S as TracingLevel, _ as MaskInputOptions, a as HumanEvaluator, b as SpanType, c as InitializeOptions, d as LaminarClient, f as Dataset, g as LaminarSpanContext, h as Event, i as EvaluatorFunctionReturn, l as EvaluationDataset, m as EvaluationDatapointDatasetLink, o as evaluate, p as EvaluationDatapoint, r as EvaluatorFunction, s as StringUUID, t as Datapoint, u as LaminarDataset, v as PushDatapointsResponse, x as TraceType, y as SessionRecordingOptions } from "./evaluations-Bz4AjiEN.mjs";
 import { AttributeValue, Attributes, Context, Exception, HrTime, Link, Span, Span as Span$1, SpanContext, SpanKind, SpanStatus, TimeInput, Tracer, TracerProvider } from "@opentelemetry/api";
 import { Instrumentation, InstrumentationBase } from "@opentelemetry/instrumentation";
 import { ReadableSpan, SpanExporter, SpanProcessor, TimedEvent } from "@opentelemetry/sdk-trace-base";
 import { InstrumentationScope } from "@opentelemetry/core";
 import { ServerResponse } from "node:http";
-import { JSONSchema7, JSONSchema7 as JSONSchema7$1 } from "json-schema";
+import { JSONSchema7, JSONSchema7 as JSONSchema7$2 } from "json-schema";
 import { $ZodType } from "zod/v4/core";
 import * as z3 from "zod/v3";
 import { ZodType } from "zod/v4";
 import { ServerResponse as ServerResponse$1 } from "http";
-//#region src/decorators.d.ts
 interface ObserveOptions {
   name?: string;
   sessionId?: string;
@@ -167,8 +166,6 @@ export declare function observeDecorator<This, Args extends unknown[], Return>(c
  * ```
  */
 export declare function observeExperimentalDecorator(config: Partial<ObserveOptions> | ((thisArg: unknown, ...funcArgs: unknown[]) => Partial<ObserveOptions>)): (_target: unknown, propertyKey: string, descriptor: PropertyDescriptor) => void;
-//#endregion
-//#region src/integrations/eve.d.ts
 /**
  * Narrow local mirrors of eve's `eve/evals` types. We intentionally do not
  * import from `eve`, so the SDK carries no peer dependency on it. Every field
@@ -273,6 +270,8 @@ type EveEvalVerdict = "passed" | "failed" | "scored" | "skipped";
 interface EveEvalResult {
   /** Path-derived eval id (e.g. "weather"). */
   id?: string;
+  /** 1-based Trial number (eve calls it `attempt`), present only when the run repeats evals. */
+  attempt?: number;
   /** Execution result (output, session, derived facts). */
   result?: EveEvalTaskResult;
   /** Every assertion recorded by the eval's `test(t)`, in record order. */
@@ -335,7 +334,7 @@ interface LaminarReporterOptions {
  * Reports eve eval results to Laminar.
  *
  * Eve 0.35+ gives reporters every native trace context observed during an eval.
- * The reporter links the datapoint to the first sampled primary trace (or the
+ * The reporter links each Trial to the first sampled primary trace (or the
  * first sampled trace when there is no sampled primary), records every valid
  * context in metadata, and adds
  * a small EVALUATION span to the selected native trace for the grade. When eve
@@ -371,8 +370,6 @@ export declare class LaminarReporter implements EvalReporter {
   private toSpanContext;
   private finishGradeTrace;
 }
-//#endregion
-//#region ../../node_modules/.pnpm/@ai-sdk+provider@4.0.24/node_modules/@ai-sdk/provider/dist/index.d.ts
 //#region src/shared/v4/shared-v4-audio-format.d.ts
 /**
  * Audio format configuration shared by provider V4 model specifications.
@@ -875,6 +872,22 @@ type LanguageModelV4Source = {
   providerMetadata?: SharedV4ProviderMetadata;
 };
 //#endregion
+//#region src/language-model/v4/language-model-v4-citation.d.ts
+/**
+ * A reference supporting generated text. Citations are attached to the text
+ * they support, independently of the complete set of retrieved sources.
+ */
+type LanguageModelV4Citation = {
+  /** The referenced URL or document. */
+  source: LanguageModelV4Source;
+  /** Start offset in the containing generated text, when supplied by the provider. */
+  startIndex?: number;
+  /** Exclusive end offset in the containing generated text, when supplied by the provider. */
+  endIndex?: number;
+  /** The supporting passage from the source, when supplied by the provider. */
+  citedText?: string;
+};
+//#endregion
 //#region src/language-model/v4/language-model-v4-text.d.ts
 /**
  * Text that the model has generated.
@@ -885,6 +898,8 @@ type LanguageModelV4Text = {
    * The text content.
    */
   text: string;
+  /** References supporting this text, separate from retrieved sources. */
+  citations?: Array<LanguageModelV4Citation>;
   providerMetadata?: SharedV4ProviderMetadata;
 };
 //#endregion
@@ -927,8 +942,9 @@ type LanguageModelV4ToolCall = {
    */
   toolName: string;
   /**
-   * Stringified JSON object with the tool call arguments. Must match the
-   * parameters schema of the tool.
+   * JSON-encoded tool input. Must match the input schema of the tool.
+   * String inputs must also be JSON-encoded, even when input deltas use text
+   * encoding.
    */
   input: string;
   /**
@@ -1011,9 +1027,10 @@ type LanguageModelV4FinishReason = {
    * - `content-filter`: content filter violation stopped the model
    * - `tool-calls`: model triggered tool calls
    * - `error`: model stopped because of an error
+   * - `interrupted`: provider stream ended without a completion signal; output may be incomplete
    * - `other`: model stopped for other reasons
    */
-  unified: 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other';
+  unified: 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other';
   /**
    * Raw finish reason from the provider.
    * This is the original finish reason from the provider.
@@ -1098,6 +1115,15 @@ type LanguageModelV4GenerateResult = {
    * Ordered content that the model has generated.
    */
   content: Array<LanguageModelV4Content>;
+  /**
+   * Text to parse for structured JSON output when it differs from the
+   * concatenation of all text parts in `content` (e.g. drafts followed by a
+   * final answer). This does not replace or remove any generated content.
+   *
+   * When omitted, consumers concatenate all text parts. An empty string is
+   * an explicit selection and must not fall back to the other text parts.
+   */
+  structuredOutputText?: string;
   /**
    * The finish reason.
    */
@@ -2094,6 +2120,12 @@ type EmbeddingModelV4CallOptions = {
    * List of text values to generate embeddings for.
    */
   values: Array<string>;
+  /**
+   * The requested number of dimensions for the output embeddings.
+   * Must be a positive integer. Support and allowed values depend on the model
+   * and provider implementation.
+   */
+  dimensions?: number;
   /**
    * Abort signal for cancelling the operation.
    */
@@ -2714,33 +2746,49 @@ declare class UnsupportedFunctionalityError extends AISDKError {
 }
 //#endregion
 //#region src/decision-model/v4/decision-model-v4-question.d.ts
-/** Shared state or structured instructions for a decision. */
+/** Content for decision instructions and criteria descriptions. */
 type DecisionModelV4Input = string | Readonly<JSONObject$2> | readonly JSONValue$3[];
 /** A judgment to make about the shared state. */
 type DecisionModelV4Question = {
   readonly type: 'choice';
-  readonly instructions: DecisionModelV4Input;
+  /** May be omitted or null when supported by the provider and criteria define the judgment. */
+  readonly instructions?: DecisionModelV4Input | null;
   /** Nonempty map of option names to descriptions. Null means no description. */
   readonly criteria: Readonly<Record<string, DecisionModelV4Input | null>>;
 } | {
   readonly type: 'score';
-  readonly instructions: DecisionModelV4Input;
-  /** At least two ordered levels, indexed from zero. */
+  /** May be omitted or null when supported by the provider and criteria define the judgment. */
+  readonly instructions?: DecisionModelV4Input | null;
+  /** At least one ordered level, indexed from zero. Providers may require more. */
   readonly criteria: readonly (DecisionModelV4Input | null)[];
 } | {
-  readonly type: 'boolean';
+  readonly type: 'box';
   readonly instructions: DecisionModelV4Input;
+} | {
+  readonly type: 'boolean';
+  /** May be omitted or null when supported by the provider and criteria define the judgment. */
+  readonly instructions?: DecisionModelV4Input | null;
+  /** At least one non-null description is required when instructions are absent. */
   readonly criteria?: {
     readonly true?: DecisionModelV4Input | null;
     readonly false?: DecisionModelV4Input | null;
   };
 };
 //#endregion
+//#region src/decision-model/v4/decision-model-v4-state.d.ts
+type DecisionModelV4State = readonly DecisionModelV4StatePart[];
+type DecisionModelV4StatePart = LanguageModelV4TextPart | LanguageModelV4FilePart | {
+  type: 'json';
+  value: JSONValue$3;
+};
+//#endregion
 //#region src/decision-model/v4/decision-model-v4-call-options.d.ts
 type DecisionModelV4CallOptions = {
-  /** One shared state, even when the value is an array. */
-  state: DecisionModelV4Input;
+  state: DecisionModelV4State;
   questions: Readonly<Record<string, DecisionModelV4Question>>;
+  maxOutputTokens?: number;
+  /** Reasoning effort for supported models. Language-model adapters default to none. */
+  reasoning?: LanguageModelV4CallOptions['reasoning'];
   abortSignal?: AbortSignal;
   headers?: SharedV4Headers;
   providerOptions?: SharedV4ProviderOptions;
@@ -2762,6 +2810,15 @@ type DecisionModelV4Answer = {
    * When supplied, score is its probability-weighted mean.
    */
   probabilities?: Record<string, number>;
+} | {
+  type: 'box';
+  /** Edges in [0, 1], measured from the image's top-left corner. */
+  box: {
+    top: number;
+    bottom: number;
+    left: number;
+    right: number;
+  };
 } | {
   type: 'boolean';
   /** Model-estimated P(true), in [0, 1]. Not confidence in either outcome. */
@@ -3574,6 +3631,8 @@ type LanguageModelV4StreamPart = {
   delta: string;
 } | {
   type: 'text-end';
+  /** References supporting the text block with this ID. */
+  citations?: Array<LanguageModelV4Citation>;
   providerMetadata?: SharedV4ProviderMetadata;
   id: string;
 } | {
@@ -3593,6 +3652,12 @@ type LanguageModelV4StreamPart = {
   type: 'tool-input-start';
   id: string;
   toolName: string;
+  /**
+   * Encoding of the input deltas. Defaults to JSON when omitted.
+   * Text deltas concatenate to a raw string. The final tool-call input
+   * must still be JSON-encoded, regardless of the delta encoding.
+   */
+  inputEncoding?: 'json' | 'text';
   providerMetadata?: SharedV4ProviderMetadata;
   providerExecuted?: boolean;
   dynamic?: boolean;
@@ -5770,7 +5835,7 @@ type RerankingModelV4 = {
 };
 //#endregion
 //#region src/speech-model/v4/speech-model-v4-call-options.d.ts
-type SpeechModelV4ProviderOptions = Record<string, JSONObject$2>;
+type SpeechModelV4ProviderOptions$1 = Record<string, JSONObject$2>;
 type SpeechModelV4CallOptions = {
   /**
    * Text to convert to speech.
@@ -5810,7 +5875,7 @@ type SpeechModelV4CallOptions = {
    * }
    * ```
    */
-  providerOptions?: SpeechModelV4ProviderOptions;
+  providerOptions?: SpeechModelV4ProviderOptions$1;
   /**
    * Abort signal for cancelling the operation.
    */
@@ -7803,6 +7868,255 @@ interface RealtimeFactoryV4 {
   getToken(options: RealtimeFactoryV4GetTokenOptions): Promise<RealtimeFactoryV4GetTokenResult>;
 }
 //#endregion
+//#region src/speech-model/v4/speech-model-v4-stream-text-part.d.ts
+/**
+ * One piece of streamed input text. Consecutive parts are synthesized in
+ * order as one continuous script.
+ */
+type SpeechModelV4StreamTextPart = {
+  type: 'text';
+  /**
+   * The text to synthesize. Parts may split anywhere, including mid-word.
+   */
+  text: string;
+  /**
+   * The voice that speaks this part. Like the call's `voice`, the value is
+   * provider-specific (a voice ID, name, or other identifier). Defaults to the
+   * call's `voice` (or the provider's default voice). Providers that support
+   * several voices per stream (e.g. dialogue) switch speakers when it changes.
+   * Single-voice providers fail the stream (error it) when a part's voice
+   * differs from the voice of the call.
+   */
+  voice?: string;
+  /**
+   * Additional provider-specific options for this part, keyed by provider
+   * name (e.g. to start a new speaker turn without changing the voice).
+   */
+  providerOptions?: SharedV4ProviderOptions;
+};
+//#endregion
+//#region src/speech-model/v4/speech-model-v4-stream-options.d.ts
+type SpeechModelV4ProviderOptions = Record<string, JSONObject$2>;
+/**
+ * Options for a speech model stream call.
+ */
+type SpeechModelV4StreamOptions = {
+  /**
+   * Text to convert to speech, as a stream of text parts.
+   *
+   * Parts are synthesized in order. Providers with an incremental text
+   * input transport forward text as it arrives; providers that only accept
+   * complete text read the stream to completion before synthesis. The end of
+   * the stream signals the end of the input text. A part's optional `voice`
+   * selects its speaker on providers that support several voices.
+   *
+   * The provider owns the stream once `doStream` is called. It must release
+   * it in every terminal path: cancel it (or its locked reader) when the
+   * abort signal fires, when the consumer cancels the returned stream, when
+   * setup fails before or after the stream is locked, and when the provider
+   * fails. Leaving it unread and uncancelled keeps the caller's text producer
+   * running indefinitely. After a normal finish the stream is fully read.
+   */
+  text: ReadableStream<SpeechModelV4StreamTextPart>;
+  /**
+   * The voice to use for speech synthesis.
+   * This is provider-specific and may be a voice ID, name, or other identifier.
+   */
+  voice?: string;
+  /**
+   * The desired format of the output audio chunks, e.g.
+   * `{ type: 'audio/pcm', rate: 24000 }` or `{ type: 'audio/mpeg' }`.
+   * When absent, the provider default format is used.
+   */
+  outputFormat?: SharedV4AudioFormat;
+  /**
+   * Instructions for the speech generation e.g. "Speak in a slow and steady tone".
+   */
+  instructions?: string;
+  /**
+   * The speed of the speech generation.
+   */
+  speed?: number;
+  /**
+   * The language for speech generation. This should be an ISO 639-1 language code (e.g. "en", "es", "fr")
+   * or "auto" for automatic language detection. Provider support varies.
+   */
+  language?: string;
+  /**
+   * Additional provider-specific options that are passed through to the provider.
+   *
+   * The outer record is keyed by the provider name, and the inner record is keyed
+   * by provider-specific option names.
+   */
+  providerOptions?: SpeechModelV4ProviderOptions;
+  /**
+   * Abort signal for cancelling the operation.
+   */
+  abortSignal?: AbortSignal;
+  /**
+   * Additional HTTP headers to be sent with the request.
+   * Only applicable for HTTP/WebSocket-based providers that support headers.
+   */
+  headers?: Record<string, string | undefined>;
+  /**
+   * When true, providers should include raw provider chunks in the stream.
+   */
+  includeRawChunks?: boolean;
+};
+//#endregion
+//#region src/speech-model/v4/speech-model-v4-stream-usage.d.ts
+/**
+ * Usage information for a speech stream call.
+ *
+ * All fields are optional because providers bill speech with different
+ * units (input characters, text tokens, and/or audio tokens).
+ */
+type SpeechModelV4StreamUsage = {
+  /**
+   * Number of input text characters (Unicode code points) that were sent
+   * for synthesis, if known. Character-billed providers report this.
+   */
+  inputCharacters?: number;
+  /**
+   * Number of input text tokens, if reported.
+   */
+  inputTokens?: number;
+  /**
+   * Number of output audio tokens, if reported.
+   */
+  outputTokens?: number;
+  /**
+   * Raw usage information from the provider, in the shape the provider
+   * returns it.
+   */
+  raw?: JSONObject$2;
+};
+//#endregion
+//#region src/speech-model/v4/speech-model-v4-stream-part.d.ts
+type SpeechModelV4StreamPart = {
+  /**
+   * Stream start event with warnings for the call, e.g. unsupported settings.
+   */
+  type: 'stream-start';
+  warnings: Array<SharedV4Warning>;
+} | {
+  /**
+   * Output audio chunk, in generation order. Chunks are not necessarily
+   * standalone files; concatenate them to reconstruct the audio.
+   *
+   * `Uint8Array` chunks contain raw audio bytes. `string` chunks contain
+   * base64-encoded raw audio bytes.
+   *
+   * A chunk may be empty when it only carries `providerMetadata` for a
+   * point in the audio, e.g. a provider's end-of-turn marker.
+   */
+  type: 'audio';
+  /**
+   * Optional provider identifier for the chunk.
+   */
+  id?: string;
+  audio: Uint8Array | string;
+  /**
+   * Format of the audio chunk, e.g. `{ type: 'audio/mpeg' }` or
+   * `{ type: 'audio/pcm', rate: 24000 }`.
+   */
+  audioFormat: SharedV4AudioFormat;
+  providerMetadata?: SharedV4ProviderMetadata;
+} | {
+  /**
+   * Metadata for the response, emitted once available.
+   */
+  type: 'response-metadata';
+  timestamp?: Date;
+  modelId?: string;
+  headers?: SharedV4Headers;
+  body?: unknown;
+} | {
+  /**
+   * Metadata that is available after the stream is finished. Emitted
+   * exactly once, after all audio chunks.
+   */
+  type: 'finish';
+  /**
+   * Usage information for the call, if known.
+   */
+  usage?: SpeechModelV4StreamUsage;
+  /**
+   * Additional provider-specific metadata.
+   */
+  providerMetadata?: SharedV4ProviderMetadata;
+} | {
+  /**
+   * Raw provider chunks if enabled.
+   */
+  type: 'raw';
+  rawValue: unknown;
+} | {
+  /**
+   * A non-fatal error; the stream continues and may carry more of them.
+   * Providers signal an unrecoverable failure by erroring the stream, or
+   * by closing it without a `finish` part.
+   */
+  type: 'error';
+  error: unknown;
+};
+//#endregion
+//#region src/speech-model/v4/speech-model-v4-stream-result.d.ts
+/**
+ * The result of a speech model doStream call.
+ */
+type SpeechModelV4StreamResult = {
+  /**
+   * The stream.
+   */
+  stream: ReadableStream<SpeechModelV4StreamPart>;
+  /**
+   * Optional request information for telemetry and debugging purposes.
+   */
+  request?: {
+    /**
+     * Request body or setup payload that was sent to the provider API.
+     */
+    body?: unknown;
+  };
+  /**
+   * Optional response data.
+   */
+  response?: {
+    /**
+     * Timestamp for the start of the streamed response.
+     */
+    timestamp?: Date;
+    /**
+     * The ID of the response model that was used to generate the response.
+     */
+    modelId?: string;
+    /**
+     * Response headers.
+     */
+    headers?: SharedV4Headers;
+    /**
+     * Response body.
+     */
+    body?: unknown;
+  };
+};
+//#endregion
+//#region src/speech-model/v4/speech-model-v4-streaming.d.ts
+/**
+ * A speech model that can also stream speech audio for streamed text input.
+ *
+ * Experimental: kept separate from the stable `SpeechModelV4` contract while
+ * `experimental_streamSpeech` is experimental, and may change in patch
+ * releases. Exported with an `Experimental_` prefix.
+ */
+type StreamingSpeechModelV4 = SpeechModelV4 & {
+  /**
+   * Streams speech audio for streamed text input.
+   */
+  doStream(options: SpeechModelV4StreamOptions): PromiseLike<SpeechModelV4StreamResult>;
+};
+//#endregion
 //#region src/speech-translation-model/v4/speech-translation-model-v4-stream-options.d.ts
 type SpeechTranslationModelV4ProviderOptions = Record<string, JSONObject$2>;
 /**
@@ -8809,8 +9123,6 @@ type VideoModelV3 = {
     };
   }>;
 };
-//#endregion
-//#region ../../node_modules/.pnpm/@ai-sdk+provider@2.0.5/node_modules/@ai-sdk/provider/dist/index.d.ts
 type SharedV2Headers = Record<string, string>;
 /**
 A JSON value can be a string, number, boolean, object, array, or null.
@@ -9613,8 +9925,6 @@ type LanguageModelV2 = {
     };
   }>;
 };
-//#endregion
-//#region ../../node_modules/.pnpm/@ai-sdk+provider@3.0.19/node_modules/@ai-sdk/provider/dist/index.d.ts
 type SharedV3Headers = Record<string, string>;
 /**
  * A JSON value can be a string, number, boolean, object, array, or null.
@@ -10701,6 +11011,7 @@ type LanguageModelV3 = {
   supportedUrls: PromiseLike<Record<string, RegExp[]>> | Record<string, RegExp[]>;
   /**
    * Generates a language model output (non-streaming).
+
    * Naming: "do" prefix to prevent accidental direct usage of the method
    * by the user.
    */
@@ -10715,8 +11026,35 @@ type LanguageModelV3 = {
    */
   doStream(options: LanguageModelV3CallOptions): PromiseLike<LanguageModelV3StreamResult>;
 };
-//#endregion
-//#region src/opentelemetry-lib/tracing/processor.d.ts
+/**
+ * Turns the spans of this process into lmnr-atif trajectory files.
+ *
+ * `path` may contain `{trace_id}` (one file per trace) and `{pid}`. Without
+ * `{trace_id}`, every trace of the process goes into one file.
+ */
+declare class TrajectoryCollector {
+  readonly path: string;
+  readonly exported: boolean;
+  readonly release?: string | undefined;
+  snapshotIntervalMs: number;
+  private records;
+  private open;
+  dirty: boolean;
+  private timer;
+  private stopped;
+  private warned;
+  private exitHook;
+  constructor(path: string, exported: boolean, release?: string | undefined, snapshotIntervalMs?: number);
+  onStart(span: ReadableSpan): void;
+  onEnd(span: ReadableSpan): void;
+  /** Rebuild and write the file(s) now. Never throws. */
+  write(): boolean;
+  /** Write `records`. Never throws. */
+  private writeRecords;
+  /** Stop snapshots and the exit hook, then write the final file. Safe to
+   * call more than once. */
+  shutdown(): boolean;
+}
 interface LaminarSpanProcessorOptions {
   /**
    * The base URL of the Laminar API. Optional.
@@ -10786,9 +11124,28 @@ interface LaminarSpanProcessorOptions {
    * every span. Optional. If not provided, detected from the environment.
    */
   release?: string;
+  /**
+   * Write the run as an lmnr-atif trajectory file here
+   * (`LMNR_TRAJECTORY_PATH`). May contain `{trace_id}` and `{pid}`. Optional.
+   */
+  trajectoryPath?: string;
+  /**
+   * Whether to export spans to Laminar. Optional. Defaults to true. False
+   * (with `trajectoryPath`) is local-only: no exporter and no batch
+   * processor are created, and `exporter` / a wrapped LaminarSpanProcessor's
+   * pipeline are not used. A `spanProcessor` that isn't a
+   * LaminarSpanProcessor is the caller's own pipeline and still runs.
+   */
+  exportSpans?: boolean;
 }
 export declare class LaminarSpanProcessor implements SpanProcessor {
   private instance;
+  private exporter;
+  /**
+   * Writes the trajectory file, when there is one. Fed from `onStart` /
+   * `onEnd`, so it sees exactly the spans that would be exported.
+   */
+  readonly trajectory: TrajectoryCollector | undefined;
   private logger;
   private readonly _spanIdToPath;
   private readonly _spanIdLists;
@@ -10839,8 +11196,6 @@ export declare class LaminarSpanProcessor implements SpanProcessor {
   dropPathInfo(spanId: string): void;
   clear(): void;
 }
-//#endregion
-//#region src/opentelemetry-lib/tracing/attributes.d.ts
 export declare const LaminarAttributes: {
   INPUT_TOKEN_COUNT: string;
   OUTPUT_TOKEN_COUNT: string;
@@ -10852,8 +11207,6 @@ export declare const LaminarAttributes: {
   OUTPUT_COST: string;
   TOTAL_COST: string;
 };
-//#endregion
-//#region src/opentelemetry-lib/tracing/span.d.ts
 declare class LaminarSpan implements Span$1, ReadableSpan {
   private _span;
   private _activated;
@@ -10912,8 +11265,6 @@ declare class LaminarSpan implements Span$1, ReadableSpan {
   getParentSpanId(): string | undefined;
   get isActivated(): boolean;
 }
-//#endregion
-//#region src/laminar.d.ts
 interface LaminarInitializeProps {
   projectApiKey?: string;
   baseUrl?: string;
@@ -10933,6 +11284,7 @@ interface LaminarInitializeProps {
   inheritGlobalContext?: boolean;
   spanProcessor?: SpanProcessor;
   release?: string;
+  writeTrajectory?: boolean;
 }
 type LaminarAttributesProp = Record<(typeof LaminarAttributes)[keyof typeof LaminarAttributes], AttributeValue>;
 export declare class Laminar {
@@ -11007,6 +11359,19 @@ export declare class Laminar {
    * SHA. Laminar groups an agent's traces into versions by release. If not specified, read
    * from the LMNR_RELEASE environment variable, common deploy platform variables (Vercel,
    * Render, Railway, Heroku, Cloud Run, ...), or the checked-out git commit.
+   * @param {boolean} props.writeTrajectory - Whether `LMNR_TRAJECTORY_PATH` (see below)
+   * applies to this process. Set to false in a process whose environment is meant
+   * for an agent it runs, so its own spans are still exported. Defaults to true.
+   *
+   * Environment variables:
+   * - `LMNR_TRAJECTORY_PATH`: write the run as an lmnr-atif trajectory (Harbor's ATIF
+   *   format with Laminar's extensions) to this file, and do NOT export spans to
+   *   Laminar, so no API key is needed. The path may contain `{trace_id}` (one file
+   *   per trace) and `{pid}`. Inline images go to an `images/` directory next to it.
+   *   The file is written on `Laminar.flush()` / `Laminar.shutdown()`, on process
+   *   exit, and as a snapshot at most every 2 seconds while spans end.
+   * - `LMNR_TRAJECTORY_FORCE_EXPORT`: with `LMNR_TRAJECTORY_PATH`, also export spans to
+   *   Laminar as usual (an API key is then required). The file says `exported: true`.
    *
    * @example
    * import { Laminar } from '@lmnr-ai/lmnr';
@@ -11024,9 +11389,9 @@ export declare class Laminar {
    *   }
    * });
    *
-   * @throws {Error} - If project API key is not set
+   * @throws {Error} - If project API key is not set and spans are exported
    */
-  static initialize({ projectApiKey, baseUrl, baseHttpUrl, httpPort, grpcPort, instrumentModules, disableBatch, traceExportTimeoutMillis, logLevel, maxExportBatchSize, maxExportBatchSizeBytes, flushBySize, forceHttp, sessionRecordingOptions, metadata, inheritGlobalContext, spanProcessor, release }?: LaminarInitializeProps): void;
+  static initialize({ projectApiKey, baseUrl, baseHttpUrl, httpPort, grpcPort, instrumentModules, disableBatch, traceExportTimeoutMillis, logLevel, maxExportBatchSize, maxExportBatchSizeBytes, flushBySize, forceHttp, sessionRecordingOptions, metadata, inheritGlobalContext, spanProcessor, release, writeTrajectory }?: LaminarInitializeProps): void;
   /**
    * Initialize Laminar context from the LMNR_SPAN_CONTEXT environment variable.
    * This allows continuing traces across process boundaries.
@@ -11317,8 +11682,6 @@ export declare class Laminar {
    */
   static wrapClaudeAgentQuery<T extends Function>(originalQuery: T): T;
 }
-//#endregion
-//#region ../../node_modules/.pnpm/@standard-schema+spec@1.1.0/node_modules/@standard-schema/spec/dist/index.d.ts
 /** The Standard Typed interface. This is a base type extended by other specs. */
 interface StandardTypedV1<Input = unknown, Output = Input> {
   /** The Standard properties. */
@@ -11434,8 +11797,6 @@ declare namespace StandardJSONSchemaV1 {
   /** Infers the output type of a Standard. */
   type InferOutput<Schema extends StandardTypedV1> = StandardTypedV1.InferOutput<Schema>;
 }
-//#endregion
-//#region ../../node_modules/.pnpm/@ai-sdk+provider-utils@5.0.56_zod@4.4.3/node_modules/@ai-sdk/provider-utils/dist/index.d.ts
 //#region src/as-array.d.ts
 /**
  * A value that can be provided either as a single item, an array of items,
@@ -12015,7 +12376,7 @@ type Schema<OBJECT = unknown> = {
   /**
    * The JSON Schema for the schema. It is passed to the providers.
    */
-  readonly jsonSchema: JSONSchema7$1 | PromiseLike<JSONSchema7$1>;
+  readonly jsonSchema: JSONSchema7$2 | PromiseLike<JSONSchema7$2>;
 };
 type LazySchema<SCHEMA> = () => Schema<SCHEMA>;
 type ZodSchema<SCHEMA = any> = z3.Schema<SCHEMA, z3.ZodTypeDef, any> | $ZodType<SCHEMA, any>;
@@ -12032,7 +12393,7 @@ type InferSchema<SCHEMA> = SCHEMA extends ZodSchema<infer T> ? T : SCHEMA extend
  * @param jsonSchema The JSON Schema for the schema.
  * @param options.validate Optional. A validation function for the schema.
  */
-declare function jsonSchema<OBJECT = unknown>(jsonSchema: JSONSchema7$1 | PromiseLike<JSONSchema7$1> | (() => JSONSchema7$1 | PromiseLike<JSONSchema7$1>), { validate }?: {
+declare function jsonSchema<OBJECT = unknown>(jsonSchema: JSONSchema7$2 | PromiseLike<JSONSchema7$2> | (() => JSONSchema7$2 | PromiseLike<JSONSchema7$2>), { validate }?: {
   validate?: (value: unknown) => ValidationResult<OBJECT> | PromiseLike<ValidationResult<OBJECT>>;
 }): Schema<OBJECT>;
 declare function asSchema<OBJECT>(schema: FlexibleSchema<OBJECT> | undefined): Schema<OBJECT>;
@@ -12232,6 +12593,13 @@ type ToolApprovalResponse = {
   approved: boolean;
   /**
    * Optional reason for the approval or denial.
+   *
+   * For denied tool calls, the reason is included in the `execution-denied`
+   * tool result that is sent to the model. For approved tool calls that are
+   * executed by the SDK, the reason remains in the message history: it is not
+   * included in the model prompt and is not exposed through a dedicated tool
+   * execution option. For provider-executed tools, the approval response
+   * (including the reason) is forwarded to the provider.
    */
   reason?: string;
   /**
@@ -12939,31 +13307,29 @@ type ToolCallerTool<TOOL extends Tool = Tool> = TOOL & {
   readonly experimental_toolCaller: ToolCallerDefinition;
 };
 declare function toolCaller<TOOL extends Tool>(tool: TOOL, definition: ToolCallerDefinition): ToolCallerTool<TOOL>;
-//#endregion
-//#region ../../node_modules/.pnpm/@ai-sdk+gateway@4.0.106_zod@4.4.3/node_modules/@ai-sdk/gateway/dist/index.d.ts
 //#region src/gateway-decision-model-settings.d.ts
-type GatewayDecisionModelId = 'convaiinnovations/laya' | 'convaiinnovations/laya-free' | 'liquid/d1' | 'typesafe-ai/jev' | (string & {});
+type GatewayDecisionModelId = 'baseten/elephant-1' | 'baseten/mammoth-1' | 'convaiinnovations/laya' | 'convaiinnovations/laya-free' | 'liquid/d1' | 'liquid/d1-ultra' | 'microsoft/microsoft-decision-1' | 'openai/gpt-6-luna-decisions' | 'perplexity/pplx-decider-flash-v1.2' | 'perplexity/pplx-decider-v1.2' | 'scaledown/scaledown-classify-1' | 'typesafe-ai/jev' | 'typesafe-ai/jev-1.13.0' | 'typesafe-ai/jev-1.14.0' | (string & {});
 //#endregion
 //#region src/gateway-embedding-model-settings.d.ts
 type GatewayEmbeddingModelId = 'alibaba/qwen3-embedding-0.6b' | 'alibaba/qwen3-embedding-4b' | 'alibaba/qwen3-embedding-8b' | 'amazon/titan-embed-text-v2' | 'cohere/embed-v4.0' | 'cohere/embed-v5.0-fast' | 'cohere/embed-v5.0-pro' | 'google/gemini-embedding-001' | 'google/gemini-embedding-2' | 'google/text-embedding-005' | 'google/text-multilingual-embedding-002' | 'mistral/codestral-embed' | 'mistral/mistral-embed' | 'openai/text-embedding-3-large' | 'openai/text-embedding-3-small' | 'openai/text-embedding-ada-002' | 'perplexity/pplx-embed-v1-0.6b' | 'perplexity/pplx-embed-v1-4b' | 'voyage/voyage-3-large' | 'voyage/voyage-3.5' | 'voyage/voyage-3.5-lite' | 'voyage/voyage-4' | 'voyage/voyage-4-large' | 'voyage/voyage-4-lite' | 'voyage/voyage-code-2' | 'voyage/voyage-code-3' | 'voyage/voyage-finance-2' | 'voyage/voyage-law-2' | (string & {});
 //#endregion
 //#region src/gateway-image-model-settings.d.ts
-type GatewayImageModelId = 'bfl/flux-2-flex' | 'bfl/flux-2-klein-4b' | 'bfl/flux-2-klein-9b' | 'bfl/flux-2-max' | 'bfl/flux-2-pro' | 'bfl/flux-3-image' | 'bfl/flux-kontext-max' | 'bfl/flux-kontext-pro' | 'bfl/flux-pro-1.0-fill' | 'bfl/flux-pro-1.1' | 'bfl/flux-pro-1.1-ultra' | 'bytedance/seedream-4.0' | 'bytedance/seedream-4.5' | 'bytedance/seedream-5.0-lite' | 'bytedance/seedream-5.0-pro' | 'meta/muse-image-1.0' | 'openai/gpt-image-1' | 'openai/gpt-image-1-mini' | 'openai/gpt-image-1.5' | 'openai/gpt-image-2' | 'openai/gpt-image-2.5-flare' | 'openai/gpt-image-2.5-sunburst' | 'prodia/flux-fast-schnell' | 'quiverai/arrow-1.1' | 'recraft/recraft-v2' | 'recraft/recraft-v3' | 'recraft/recraft-v4' | 'recraft/recraft-v4-pro' | 'recraft/recraft-v4.1' | 'recraft/recraft-v4.1-flash' | 'recraft/recraft-v4.1-pro' | 'recraft/recraft-v4.1-utility' | 'recraft/recraft-v4.1-utility-pro' | 'spacexai/grok-imagine-image' | 'spacexai/grok-imagine-image-2.0' | (string & {});
+type GatewayImageModelId = 'bfl/flux-2-flex' | 'bfl/flux-2-klein-4b' | 'bfl/flux-2-klein-9b' | 'bfl/flux-2-max' | 'bfl/flux-2-pro' | 'bfl/flux-3-image' | 'bfl/flux-3-image-klein' | 'bfl/flux-kontext-max' | 'bfl/flux-kontext-pro' | 'bfl/flux-pro-1.0-fill' | 'bfl/flux-pro-1.1' | 'bfl/flux-pro-1.1-ultra' | 'bytedance/seedream-4.0' | 'bytedance/seedream-4.5' | 'bytedance/seedream-5.0-lite' | 'bytedance/seedream-5.0-pro' | 'meta/muse-image-1.0' | 'microsoft/mai-image-2.6' | 'microsoft/mai-image-2.6-flash' | 'openai/gpt-image-1-mini' | 'openai/gpt-image-1.5' | 'openai/gpt-image-2' | 'openai/gpt-image-2.5-flare' | 'openai/gpt-image-2.5-sunburst' | 'prodia/flux-fast-schnell' | 'recraft/recraft-v2' | 'recraft/recraft-v3' | 'recraft/recraft-v4' | 'recraft/recraft-v4-pro' | 'recraft/recraft-v4.1' | 'recraft/recraft-v4.1-flash' | 'recraft/recraft-v4.1-pro' | 'recraft/recraft-v4.1-utility' | 'recraft/recraft-v4.1-utility-pro' | 'spacexai/grok-imagine-image' | 'spacexai/grok-imagine-image-2.0' | 'topaz/wonder-3.5' | (string & {});
 //#endregion
 //#region src/gateway-language-model-settings.d.ts
-type GatewayModelId = 'alibaba/qwen-3-14b' | 'alibaba/qwen-3-235b' | 'alibaba/qwen-3-30b' | 'alibaba/qwen-3-32b' | 'alibaba/qwen-3.6-max-preview' | 'alibaba/qwen3-235b-a22b-thinking' | 'alibaba/qwen3-coder' | 'alibaba/qwen3-coder-30b-a3b' | 'alibaba/qwen3-coder-next' | 'alibaba/qwen3-coder-plus' | 'alibaba/qwen3-max' | 'alibaba/qwen3-max-preview' | 'alibaba/qwen3-max-thinking' | 'alibaba/qwen3-next-80b-a3b-instruct' | 'alibaba/qwen3-next-80b-a3b-thinking' | 'alibaba/qwen3-vl-235b-a22b-instruct' | 'alibaba/qwen3-vl-instruct' | 'alibaba/qwen3-vl-thinking' | 'alibaba/qwen3.5-flash' | 'alibaba/qwen3.5-plus' | 'alibaba/qwen3.6-27b' | 'alibaba/qwen3.6-plus' | 'alibaba/qwen3.7-flash' | 'alibaba/qwen3.7-max' | 'alibaba/qwen3.7-plus' | 'alibaba/qwen3.8-2.4t-a95b' | 'alibaba/qwen3.8-27b' | 'alibaba/qwen3.8-flash' | 'alibaba/qwen3.8-max' | 'alibaba/qwen3.8-max-0902' | 'alibaba/qwen3.8-max-prime' | 'alibaba/qwen3.8-omni-flash' | 'amazon/nova-2-lite' | 'amazon/nova-lite' | 'amazon/nova-micro' | 'amazon/nova-pro' | 'anthropic/claude-3-haiku' | 'anthropic/claude-fable-5' | 'anthropic/claude-fable-5.1' | 'anthropic/claude-haiku-4.5' | 'anthropic/claude-opus-4' | 'anthropic/claude-opus-4.5' | 'anthropic/claude-opus-4.6' | 'anthropic/claude-opus-4.7' | 'anthropic/claude-opus-4.8' | 'anthropic/claude-opus-4.8-fast' | 'anthropic/claude-opus-5' | 'anthropic/claude-opus-5-fast' | 'anthropic/claude-opus-5.5' | 'anthropic/claude-opus-5.5-fast' | 'anthropic/claude-sonnet-4' | 'anthropic/claude-sonnet-4.5' | 'anthropic/claude-sonnet-4.6' | 'anthropic/claude-sonnet-5' | 'anthropic/claude-sonnet-5.5' | 'arcee-ai/trinity-large-thinking' | 'bytedance/seed-1.6' | 'bytedance/seed-1.8' | 'bytedance/seed-2.1-turbo' | 'cohere/command-a' | 'deepseek/deepseek-r1' | 'deepseek/deepseek-v3.1' | 'deepseek/deepseek-v3.1-terminus' | 'deepseek/deepseek-v3.2' | 'deepseek/deepseek-v3.2-thinking' | 'deepseek/deepseek-v4-flash' | 'deepseek/deepseek-v4-flash-0731' | 'deepseek/deepseek-v4-flash-vision-exp' | 'deepseek/deepseek-v4-pro' | 'deepseek/deepseek-v4-pro-0813' | 'deepseek/deepseek-v4.1-flash' | 'deepseek/deepseek-v4.1-flash-fast' | 'fireworks/ember-1' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-flash-image' | 'google/gemini-2.5-flash-lite' | 'google/gemini-2.5-pro' | 'google/gemini-3-flash' | 'google/gemini-3-pro-image' | 'google/gemini-3.1-flash-image' | 'google/gemini-3.1-flash-image-preview' | 'google/gemini-3.1-flash-lite' | 'google/gemini-3.1-flash-lite-image' | 'google/gemini-3.1-pro-preview' | 'google/gemini-3.5-flash' | 'google/gemini-3.5-flash-lite' | 'google/gemini-3.6-flash' | 'google/gemini-3.7-flash' | 'google/gemini-3.8-flash' | 'google/gemini-nano-banana-2.1' | 'google/gemini-omni-flash-preview' | 'google/gemma-4-26b-a4b-it' | 'google/gemma-4-31b-it' | 'inception/mercury-2' | 'inception/mercury-2.5' | 'inception/mercury-coder-small' | 'inclusionai/ling-3.0-flash' | 'inclusionai/ling-3.0-flash-fin' | 'inclusionai/ling-3.0-flash-sante' | 'inclusionai/ling-3.0-flash-vl' | 'inclusionai/ling-3.1-flash' | 'inclusionai/ling-3.1-flash-free' | 'inference-net/schematron-v2-small' | 'inference-net/schematron-v2-turbo' | 'interfaze/interfaze-beta' | 'meituan/longcat-2.5-preview' | 'meta/llama-3.1-70b' | 'meta/llama-3.1-8b' | 'meta/llama-3.3-70b' | 'meta/llama-4-maverick' | 'meta/llama-4-scout' | 'meta/muse-glimmer-30b' | 'meta/muse-spark-1.1' | 'meta/muse-spark-1.2' | 'meta/muse-spark-1.2-contributor' | 'meta/muse-spark-1.3' | 'meta/muse-spark-1.3-contributor' | 'minimax/minimax-m2' | 'minimax/minimax-m2.1' | 'minimax/minimax-m2.1-lightning' | 'minimax/minimax-m2.5' | 'minimax/minimax-m2.5-highspeed' | 'minimax/minimax-m2.7' | 'minimax/minimax-m2.7-highspeed' | 'minimax/minimax-m3' | 'mistral/codestral' | 'mistral/ministral-14b' | 'mistral/ministral-3b' | 'mistral/ministral-8b' | 'mistral/mistral-large-3' | 'mistral/mistral-large-4' | 'mistral/mistral-medium-3.5' | 'mistral/mistral-nemo' | 'mistral/mistral-small' | 'mixedbread/toast-1' | 'moonshotai/kimi-k2' | 'moonshotai/kimi-k2-thinking' | 'moonshotai/kimi-k2.5' | 'moonshotai/kimi-k2.6' | 'moonshotai/kimi-k2.7-code' | 'moonshotai/kimi-k2.7-code-highspeed' | 'moonshotai/kimi-k3' | 'moonshotai/kimi-k3-fast' | 'morph/morph-v3-fast' | 'morph/morph-v3-large' | 'nvidia/nemotron-3-nano-30b-a3b' | 'nvidia/nemotron-3-super-120b-a12b' | 'nvidia/nemotron-3-ultra-550b-a55b' | 'nvidia/nemotron-3.5-lightning' | 'nvidia/nemotron-nano-12b-v2-vl' | 'nvidia/nemotron-nano-9b-v2' | 'openai/gpt-3.5-turbo' | 'openai/gpt-4-turbo' | 'openai/gpt-4.1' | 'openai/gpt-4.1-fast' | 'openai/gpt-4.1-mini' | 'openai/gpt-4.1-mini-fast' | 'openai/gpt-4.1-nano' | 'openai/gpt-4.1-nano-fast' | 'openai/gpt-4o' | 'openai/gpt-4o-fast' | 'openai/gpt-4o-mini' | 'openai/gpt-4o-mini-fast' | 'openai/gpt-5' | 'openai/gpt-5-codex' | 'openai/gpt-5-fast' | 'openai/gpt-5-mini' | 'openai/gpt-5-mini-fast' | 'openai/gpt-5-nano' | 'openai/gpt-5-pro' | 'openai/gpt-5.1-codex' | 'openai/gpt-5.1-codex-max' | 'openai/gpt-5.1-codex-mini' | 'openai/gpt-5.1-thinking' | 'openai/gpt-5.1-thinking-fast' | 'openai/gpt-5.2' | 'openai/gpt-5.2-codex' | 'openai/gpt-5.2-fast' | 'openai/gpt-5.2-pro' | 'openai/gpt-5.3-codex' | 'openai/gpt-5.3-codex-fast' | 'openai/gpt-5.4' | 'openai/gpt-5.4-fast' | 'openai/gpt-5.4-mini' | 'openai/gpt-5.4-mini-fast' | 'openai/gpt-5.4-nano' | 'openai/gpt-5.4-pro' | 'openai/gpt-5.5' | 'openai/gpt-5.5-fast' | 'openai/gpt-5.5-pro' | 'openai/gpt-5.6-luna' | 'openai/gpt-5.6-luna-fast' | 'openai/gpt-5.6-sol' | 'openai/gpt-5.6-sol-fast' | 'openai/gpt-5.6-terra' | 'openai/gpt-5.6-terra-fast' | 'openai/gpt-6-astra' | 'openai/gpt-6-astra-fast' | 'openai/gpt-6-luna' | 'openai/gpt-6-luna-fast' | 'openai/gpt-6-sol' | 'openai/gpt-6-sol-fast' | 'openai/gpt-6.1-sol' | 'openai/gpt-6.1-sol-fast' | 'openai/gpt-oss-120b' | 'openai/gpt-oss-20b' | 'openai/gpt-oss-safeguard-120b' | 'openai/gpt-oss-safeguard-20b' | 'openai/o1' | 'openai/o3' | 'openai/o3-fast' | 'openai/o3-mini' | 'openai/o3-pro' | 'openai/o4-mini' | 'openai/o4-mini-fast' | 'perplexity/sonar' | 'poolside/laguna-s-2.1' | 'poolside/laguna-s-2.1-free' | 'quiverai/arrow-2' | 'quiverai/arrow-2-telos' | 'sakana/fugu-max' | 'sakana/fugu-ultra' | 'sakana/fugu-ultra-v2' | 'sakana/namazu' | 'spacexai/grok-4.1-fast-non-reasoning' | 'spacexai/grok-4.1-fast-reasoning' | 'spacexai/grok-4.20-multi-agent' | 'spacexai/grok-4.20-multi-agent-beta' | 'spacexai/grok-4.20-non-reasoning' | 'spacexai/grok-4.20-non-reasoning-beta' | 'spacexai/grok-4.20-reasoning' | 'spacexai/grok-4.20-reasoning-beta' | 'spacexai/grok-4.3' | 'spacexai/grok-4.5' | 'spacexai/grok-4.6' | 'spacexai/grok-4.7' | 'spacexai/grok-build-0.1' | 'stepfun/step-3.5-flash' | 'stepfun/step-3.7-flash' | 'stepfun/step-5-preview' | 'tencent/hy-mt2-lite' | 'tencent/hy-mt2-plus' | 'tencent/hy-mt2-pro' | 'tencent/hy3' | 'tencent/hy4-preview' | 'thinkingmachines/inkling' | 'thinkingmachines/inkling-small' | 'xiaomi/mimo-v2.5' | 'xiaomi/mimo-v2.5-pro' | 'xiaomi/mimo-v2.6-flash' | 'xiaomi/mimo-v2.6-pro' | 'xiaomi/mimo-v2.6-pro-ultraspeed' | 'zai/glm-4.5' | 'zai/glm-4.5-air' | 'zai/glm-4.5v' | 'zai/glm-4.6' | 'zai/glm-4.7' | 'zai/glm-4.7-flash' | 'zai/glm-4.7-flashx' | 'zai/glm-5' | 'zai/glm-5-turbo' | 'zai/glm-5.1' | 'zai/glm-5.2' | 'zai/glm-5.2-fast' | 'zai/glm-5.3' | 'zai/glm-5.3-fast' | 'zai/glm-5.3-flash' | 'zai/glm-5.3-flashx' | 'zai/glm-5v-turbo' | (string & {});
+type GatewayModelId = 'alibaba/qwen-3-14b' | 'alibaba/qwen-3-235b' | 'alibaba/qwen-3-30b' | 'alibaba/qwen-3-32b' | 'alibaba/qwen3-coder' | 'alibaba/qwen3-coder-30b-a3b' | 'alibaba/qwen3-coder-next' | 'alibaba/qwen3-max-thinking' | 'alibaba/qwen3-next-80b-a3b-instruct' | 'alibaba/qwen3-next-80b-a3b-thinking' | 'alibaba/qwen3-vl-instruct' | 'alibaba/qwen3.5-flash' | 'alibaba/qwen3.5-plus' | 'alibaba/qwen3.6-27b' | 'alibaba/qwen3.6-plus' | 'alibaba/qwen3.7-flash' | 'alibaba/qwen3.7-max' | 'alibaba/qwen3.7-plus' | 'alibaba/qwen3.8-2.4t-a95b' | 'alibaba/qwen3.8-27b' | 'alibaba/qwen3.8-flash' | 'alibaba/qwen3.8-max' | 'alibaba/qwen3.8-max-0902' | 'alibaba/qwen3.8-max-prime' | 'alibaba/qwen3.8-omni-flash' | 'amazon/nova-2-lite' | 'amazon/nova-lite' | 'amazon/nova-micro' | 'amazon/nova-pro' | 'anthropic/claude-fable-5' | 'anthropic/claude-fable-5-batch' | 'anthropic/claude-fable-5.1' | 'anthropic/claude-fable-5.1-batch' | 'anthropic/claude-haiku-4.5' | 'anthropic/claude-haiku-4.5-batch' | 'anthropic/claude-haiku-5.5' | 'anthropic/claude-haiku-5.5-batch' | 'anthropic/claude-opus-4.5' | 'anthropic/claude-opus-4.5-batch' | 'anthropic/claude-opus-4.6' | 'anthropic/claude-opus-4.6-batch' | 'anthropic/claude-opus-4.7' | 'anthropic/claude-opus-4.7-batch' | 'anthropic/claude-opus-4.8' | 'anthropic/claude-opus-4.8-batch' | 'anthropic/claude-opus-4.8-fast' | 'anthropic/claude-opus-5' | 'anthropic/claude-opus-5-batch' | 'anthropic/claude-opus-5-fast' | 'anthropic/claude-opus-5.5' | 'anthropic/claude-opus-5.5-batch' | 'anthropic/claude-opus-5.5-fast' | 'anthropic/claude-sonnet-4.5' | 'anthropic/claude-sonnet-4.5-batch' | 'anthropic/claude-sonnet-4.6' | 'anthropic/claude-sonnet-4.6-batch' | 'anthropic/claude-sonnet-5' | 'anthropic/claude-sonnet-5-batch' | 'anthropic/claude-sonnet-5.5' | 'anthropic/claude-sonnet-5.5-batch' | 'arcee-ai/trinity-large-thinking' | 'bytedance/seed-1.6' | 'bytedance/seed-1.8' | 'bytedance/seed-2.1-turbo' | 'callstack/apex' | 'cohere/command-a' | 'deepseek/deepseek-r1' | 'deepseek/deepseek-v3.1' | 'deepseek/deepseek-v3.2' | 'deepseek/deepseek-v3.2-thinking' | 'deepseek/deepseek-v4-flash' | 'deepseek/deepseek-v4-flash-0731' | 'deepseek/deepseek-v4-flash-vision-exp' | 'deepseek/deepseek-v4-pro' | 'deepseek/deepseek-v4-pro-0813' | 'deepseek/deepseek-v4.1-flash' | 'deepseek/deepseek-v4.1-flash-1017' | 'deepseek/deepseek-v4.1-flash-1017-fast' | 'deepseek/deepseek-v4.1-flash-fast' | 'elorian/glimpse' | 'fireworks/ember-1' | 'google/gemini-2.5-flash' | 'google/gemini-2.5-flash-batch' | 'google/gemini-2.5-flash-image' | 'google/gemini-2.5-flash-lite' | 'google/gemini-2.5-flash-lite-batch' | 'google/gemini-2.5-pro' | 'google/gemini-2.5-pro-batch' | 'google/gemini-3-flash' | 'google/gemini-3-flash-batch' | 'google/gemini-3-pro-image' | 'google/gemini-3.1-flash-image' | 'google/gemini-3.1-flash-image-preview' | 'google/gemini-3.1-flash-lite' | 'google/gemini-3.1-flash-lite-batch' | 'google/gemini-3.1-flash-lite-image' | 'google/gemini-3.1-pro-preview' | 'google/gemini-3.1-pro-preview-batch' | 'google/gemini-3.5-flash' | 'google/gemini-3.5-flash-batch' | 'google/gemini-3.5-flash-lite' | 'google/gemini-3.5-flash-lite-batch' | 'google/gemini-3.6-flash' | 'google/gemini-3.6-flash-batch' | 'google/gemini-3.7-flash' | 'google/gemini-3.7-flash-batch' | 'google/gemini-3.8-flash' | 'google/gemini-4-argon' | 'google/gemini-nano-banana-2.1' | 'google/gemini-omni-flash-preview' | 'google/gemma-4-26b-a4b-it' | 'google/gemma-4-31b-it' | 'inception/mercury-2' | 'inception/mercury-2.5' | 'inception/mercury-3' | 'inception/mercury-coder-small' | 'inclusionai/ling-3.0-flash' | 'inclusionai/ling-3.0-flash-fin' | 'inclusionai/ling-3.0-flash-sante' | 'inclusionai/ling-3.0-flash-vl' | 'inclusionai/ling-3.1-flash' | 'inference-net/schematron-v2-small' | 'inference-net/schematron-v2-turbo' | 'interfaze/interfaze-beta' | 'liquid/lfm2.5-24b-a2b' | 'meituan/longcat-2.5-preview' | 'meta/llama-3.1-70b' | 'meta/llama-3.1-8b' | 'meta/llama-3.3-70b' | 'meta/llama-4-maverick' | 'meta/llama-4-scout' | 'meta/muse-glimmer-30b' | 'meta/muse-spark-1.1' | 'meta/muse-spark-1.2' | 'meta/muse-spark-1.2-contributor' | 'meta/muse-spark-1.3' | 'meta/muse-spark-1.3-contributor' | 'meta/muse-spark-open' | 'meta/muse-wonder-1.0' | 'minimax/minimax-m2' | 'minimax/minimax-m2.1' | 'minimax/minimax-m2.1-lightning' | 'minimax/minimax-m2.5' | 'minimax/minimax-m2.5-highspeed' | 'minimax/minimax-m2.7' | 'minimax/minimax-m2.7-highspeed' | 'minimax/minimax-m3' | 'minimax/minimax-m3.1-flash' | 'mistral/codestral' | 'mistral/ministral-14b' | 'mistral/ministral-3b' | 'mistral/ministral-8b' | 'mistral/mistral-large-3' | 'mistral/mistral-large-4' | 'mistral/mistral-medium-3.5' | 'mistral/mistral-nemo' | 'mistral/mistral-small' | 'mixedbread/toast-1' | 'moonshotai/kimi-k2' | 'moonshotai/kimi-k2.5' | 'moonshotai/kimi-k2.6' | 'moonshotai/kimi-k2.7-code' | 'moonshotai/kimi-k2.7-code-highspeed' | 'moonshotai/kimi-k3' | 'moonshotai/kimi-k3-fast' | 'moonshotai/kimi-k3.1-pro' | 'moonshotai/kimi-k3.1-pro-highspeed' | 'morph/morph-v3-fast' | 'morph/morph-v3-large' | 'nvidia/nemotron-3-nano-30b-a3b' | 'nvidia/nemotron-3-super-120b-a12b' | 'nvidia/nemotron-3-ultra-550b-a55b' | 'nvidia/nemotron-3.5-lightning' | 'nvidia/nemotron-3.5-lightning-free' | 'nvidia/nemotron-3.5-super-vl' | 'nvidia/nemotron-nano-12b-v2-vl' | 'nvidia/nemotron-nano-9b-v2' | 'openai/gpt-4.1' | 'openai/gpt-4.1-batch' | 'openai/gpt-4.1-fast' | 'openai/gpt-4.1-mini' | 'openai/gpt-4.1-mini-batch' | 'openai/gpt-4.1-mini-fast' | 'openai/gpt-4.1-nano' | 'openai/gpt-4o' | 'openai/gpt-4o-batch' | 'openai/gpt-4o-fast' | 'openai/gpt-4o-mini' | 'openai/gpt-4o-mini-batch' | 'openai/gpt-4o-mini-fast' | 'openai/gpt-5' | 'openai/gpt-5-batch' | 'openai/gpt-5-codex' | 'openai/gpt-5-fast' | 'openai/gpt-5-mini' | 'openai/gpt-5-mini-batch' | 'openai/gpt-5-mini-fast' | 'openai/gpt-5-nano' | 'openai/gpt-5-nano-batch' | 'openai/gpt-5-pro' | 'openai/gpt-5-pro-batch' | 'openai/gpt-5.1-codex' | 'openai/gpt-5.1-codex-max' | 'openai/gpt-5.1-codex-mini' | 'openai/gpt-5.1-thinking' | 'openai/gpt-5.1-thinking-fast' | 'openai/gpt-5.2' | 'openai/gpt-5.2-batch' | 'openai/gpt-5.2-codex' | 'openai/gpt-5.2-fast' | 'openai/gpt-5.2-pro' | 'openai/gpt-5.3-codex' | 'openai/gpt-5.3-codex-fast' | 'openai/gpt-5.4' | 'openai/gpt-5.4-batch' | 'openai/gpt-5.4-fast' | 'openai/gpt-5.4-mini' | 'openai/gpt-5.4-mini-batch' | 'openai/gpt-5.4-mini-fast' | 'openai/gpt-5.4-nano' | 'openai/gpt-5.4-nano-batch' | 'openai/gpt-5.4-pro' | 'openai/gpt-5.5' | 'openai/gpt-5.5-batch' | 'openai/gpt-5.5-fast' | 'openai/gpt-5.5-pro' | 'openai/gpt-5.5-pro-batch' | 'openai/gpt-5.6-luna' | 'openai/gpt-5.6-luna-batch' | 'openai/gpt-5.6-luna-fast' | 'openai/gpt-5.6-sol' | 'openai/gpt-5.6-sol-batch' | 'openai/gpt-5.6-sol-fast' | 'openai/gpt-5.6-terra' | 'openai/gpt-5.6-terra-batch' | 'openai/gpt-5.6-terra-fast' | 'openai/gpt-6-astra' | 'openai/gpt-6-astra-batch' | 'openai/gpt-6-astra-fast' | 'openai/gpt-6-luna' | 'openai/gpt-6-luna-batch' | 'openai/gpt-6-luna-fast' | 'openai/gpt-6-sol' | 'openai/gpt-6-sol-batch' | 'openai/gpt-6-sol-fast' | 'openai/gpt-6.1-sol' | 'openai/gpt-6.1-sol-batch' | 'openai/gpt-6.1-sol-fast' | 'openai/gpt-oss-120b' | 'openai/gpt-oss-20b' | 'openai/gpt-oss-safeguard-120b' | 'openai/gpt-oss-safeguard-20b' | 'openai/o1' | 'openai/o3' | 'openai/o3-fast' | 'openai/o3-mini' | 'openai/o3-pro' | 'openai/o4-mini' | 'perplexity/sonar' | 'poolside/laguna-s-2.1' | 'poolside/laguna-s-2.1-free' | 'quiverai/arrow-2' | 'quiverai/arrow-2-telos' | 'reflection/beam' | 'reflection/beam-free' | 'sakana/fugu-max' | 'sakana/fugu-ultra' | 'sakana/fugu-ultra-v2' | 'sakana/namazu' | 'scaledown/scaledown-extract-1' | 'scaledown/scaledown-summarize-1' | 'spacexai/grok-4.20-multi-agent' | 'spacexai/grok-4.20-multi-agent-batch' | 'spacexai/grok-4.20-multi-agent-beta' | 'spacexai/grok-4.20-non-reasoning' | 'spacexai/grok-4.20-non-reasoning-batch' | 'spacexai/grok-4.20-non-reasoning-beta' | 'spacexai/grok-4.20-reasoning' | 'spacexai/grok-4.20-reasoning-batch' | 'spacexai/grok-4.20-reasoning-beta' | 'spacexai/grok-4.3' | 'spacexai/grok-4.3-batch' | 'spacexai/grok-4.5' | 'spacexai/grok-4.6' | 'spacexai/grok-4.7' | 'spacexai/grok-build-0.1' | 'stealth/glyph-cluster' | 'stepfun/step-3.7-flash' | 'stepfun/step-5-preview' | 'tencent/hy-mt2-lite' | 'tencent/hy-mt2-plus' | 'tencent/hy-mt2-pro' | 'tencent/hy3' | 'tencent/hy4-preview' | 'thinkingmachines/inkling' | 'thinkingmachines/inkling-small' | 'xiaomi/mimo-v2.5' | 'xiaomi/mimo-v2.5-pro' | 'xiaomi/mimo-v2.6-flash' | 'xiaomi/mimo-v2.6-pro' | 'xiaomi/mimo-v2.6-pro-ultraspeed' | 'zai/glm-4.5' | 'zai/glm-4.5-air' | 'zai/glm-4.5v' | 'zai/glm-4.6' | 'zai/glm-4.7' | 'zai/glm-4.7-flash' | 'zai/glm-4.7-flashx' | 'zai/glm-5' | 'zai/glm-5-turbo' | 'zai/glm-5.1' | 'zai/glm-5.2' | 'zai/glm-5.2-fast' | 'zai/glm-5.3' | 'zai/glm-5.3-fast' | 'zai/glm-5.3-flash' | 'zai/glm-5.3-flashx' | 'zai/glm-5v-turbo' | (string & {});
 //#endregion
 //#region src/gateway-reranking-model-settings.d.ts
-type GatewayRerankingModelId = 'cohere/rerank-v3.5' | 'cohere/rerank-v4-fast' | 'cohere/rerank-v4-pro' | 'voyage/rerank-2.5' | 'voyage/rerank-2.5-lite' | 'voyage/rerank-3' | 'voyage/rerank-3-lite' | (string & {});
+type GatewayRerankingModelId = 'cohere/rerank-v3.5' | 'cohere/rerank-v4-fast' | 'cohere/rerank-v4-pro' | 'cohere/rerank-v5-fast' | 'cohere/rerank-v5-pro' | 'voyage/rerank-2.5' | 'voyage/rerank-2.5-lite' | 'voyage/rerank-3' | 'voyage/rerank-3-lite' | (string & {});
 //#endregion
 //#region src/gateway-speech-model-settings.d.ts
-type GatewaySpeechModelId = 'fish-audio/s1' | 'fish-audio/s2-pro' | 'fish-audio/s2.1-pro' | 'google/gemini-3.8-flash-lite-tts' | 'google/gemini-3.8-flash-tts' | 'microsoft/mai-voice-2' | 'microsoft/mai-voice-2-flash' | 'microsoft/mai-voice-2.1' | 'microsoft/mai-voice-2.1-flash' | 'openai/tts-1' | 'openai/tts-1-hd' | 'spacexai/grok-tts' | (string & {});
+type GatewaySpeechModelId = 'fish-audio/drama-3' | 'fish-audio/s1' | 'fish-audio/s2-pro' | 'fish-audio/s2.1-pro' | 'google/gemini-3.8-flash-lite-tts' | 'google/gemini-3.8-flash-tts' | 'microsoft/mai-voice-2' | 'microsoft/mai-voice-2-flash' | 'microsoft/mai-voice-2.1' | 'microsoft/mai-voice-2.1-flash' | 'mistral/voxtral-mini-tts-3' | 'openai/tts-1' | 'openai/tts-1-hd' | 'spacexai/grok-tts' | (string & {});
 //#endregion
 //#region src/gateway-transcription-model-settings.d.ts
-type GatewayTranscriptionModelId = 'fish-audio/transcribe-1' | 'google/gemini-3.5-transcribe' | 'google/gemini-3.5-transcribe-live' | 'microsoft/mai-transcribe-1.5' | 'microsoft/mai-transcribe-2' | 'microsoft/mai-transcribe-2-streaming' | 'openai/gpt-4o-mini-transcribe' | 'openai/gpt-4o-transcribe' | 'openai/gpt-realtime-whisper' | 'openai/whisper-1' | 'spacexai/grok-stt' | (string & {});
+type GatewayTranscriptionModelId = 'fish-audio/transcribe-1' | 'google/gemini-3.5-transcribe' | 'google/gemini-3.5-transcribe-live' | 'microsoft/mai-transcribe-2' | 'microsoft/mai-transcribe-2-streaming' | 'mistral/voxtral-mini-transcribe-3' | 'mistral/voxtral-small-transcribe-3' | 'openai/gpt-4o-mini-transcribe' | 'openai/gpt-4o-transcribe' | 'openai/gpt-realtime-whisper' | 'openai/whisper-1' | 'spacexai/grok-stt' | (string & {});
 //#endregion
 //#region src/gateway-video-model-settings.d.ts
-type GatewayVideoModelId = 'alibaba/wan-v2.5-t2v-preview' | 'alibaba/wan-v2.6-i2v' | 'alibaba/wan-v2.6-i2v-flash' | 'alibaba/wan-v2.6-r2v' | 'alibaba/wan-v2.6-r2v-flash' | 'alibaba/wan-v2.6-t2v' | 'alibaba/wan-v2.7-r2v' | 'alibaba/wan-v2.7-t2v' | 'alibaba/wan-v3.0-video' | 'alibaba/wan-v3.0-video-prime' | 'bfl/flux-3-video' | 'bytedance/seedance-2.0' | 'bytedance/seedance-2.0-fast' | 'bytedance/seedance-2.0-mini' | 'bytedance/seedance-2.5' | 'bytedance/seedance-v1.0-pro' | 'bytedance/seedance-v1.0-pro-fast' | 'bytedance/seedance-v1.5-pro' | 'google/veo-3.0-fast-generate-001' | 'google/veo-3.0-generate-001' | 'google/veo-3.1-fast-generate-001' | 'google/veo-3.1-generate-001' | 'google/veo-3.1-lite-generate-001' | 'klingai/kling-v2.5-turbo-i2v' | 'klingai/kling-v2.5-turbo-t2v' | 'klingai/kling-v2.6-i2v' | 'klingai/kling-v2.6-motion-control' | 'klingai/kling-v2.6-t2v' | 'klingai/kling-v3.0-i2v' | 'klingai/kling-v3.0-motion-control' | 'klingai/kling-v3.0-t2v' | 'minimax/minimax-h3' | 'minimax/minimax-h3-max' | 'spacexai/grok-imagine-video' | 'spacexai/grok-imagine-video-1.5' | 'spacexai/grok-imagine-video-1.5-lite' | (string & {});
+type GatewayVideoModelId = 'alibaba/wan-v2.5-t2v-preview' | 'alibaba/wan-v2.6-i2v' | 'alibaba/wan-v2.6-i2v-flash' | 'alibaba/wan-v2.6-r2v' | 'alibaba/wan-v2.6-r2v-flash' | 'alibaba/wan-v2.6-t2v' | 'alibaba/wan-v2.7-r2v' | 'alibaba/wan-v2.7-t2v' | 'alibaba/wan-v3.0-video' | 'alibaba/wan-v3.0-video-prime' | 'bfl/flux-3-video' | 'bytedance/seedance-2.0' | 'bytedance/seedance-2.0-fast' | 'bytedance/seedance-2.0-mini' | 'bytedance/seedance-2.5' | 'bytedance/seedance-v1.0-pro' | 'bytedance/seedance-v1.0-pro-fast' | 'bytedance/seedance-v1.5-pro' | 'google/veo-3.0-fast-generate-001' | 'google/veo-3.0-generate-001' | 'google/veo-3.1-fast-generate-001' | 'google/veo-3.1-generate-001' | 'google/veo-3.1-lite-generate-001' | 'heygen/heygen-video-1' | 'klingai/kling-v2.5-turbo-i2v' | 'klingai/kling-v2.5-turbo-t2v' | 'klingai/kling-v2.6-i2v' | 'klingai/kling-v2.6-motion-control' | 'klingai/kling-v2.6-t2v' | 'klingai/kling-v3.0-i2v' | 'klingai/kling-v3.0-motion-control' | 'klingai/kling-v3.0-t2v' | 'minimax/minimax-h3' | 'minimax/minimax-h3-max' | 'spacexai/grok-imagine-video' | 'spacexai/grok-imagine-video-1.5' | 'spacexai/grok-imagine-video-1.5-lite' | 'topaz/proteus' | 'topaz/starlight-precise-2.6' | (string & {});
 //#endregion
 //#region src/gateway-model-entry.d.ts
 declare const KNOWN_MODEL_TYPES: readonly ["embedding", "decision", "evaluation", "image", "language", "realtime", "reranking", "speech", "transcription", "video"];
@@ -13365,19 +13731,26 @@ type ExaSearchOutput = ExaSearchResponse | ExaSearchError;
 declare const exaSearchToolFactory: ProviderExecutedToolFactory<ExaSearchInput, ExaSearchOutput, ExaSearchConfig, {}>;
 //#endregion
 //#region src/tool/parallel-search.d.ts
+declare const parallelSearchModes: readonly ["turbo", "fast", "basic", "advanced", "one-shot", "agentic"];
+/**
+ * Search mode. `turbo` and `fast` trade excerpt depth for latency (`turbo` is
+ * English and Japanese only), `basic` is balanced, `advanced` is the most thorough.
+ * Deprecated: `one-shot` (runs as `basic`) and `agentic` (runs as `advanced`).
+ */
+type ParallelSearchMode = (typeof parallelSearchModes)[number];
 interface ParallelSearchSourcePolicy {
   /**
-   * List of domains to include in search results.
-   * Example: ['wikipedia.org', 'nature.com']
+   * Domains or domain/path prefixes to restrict results to. When set,
+   * `excludeDomains` is ignored. Example: ['wikipedia.org', 'docs.python.org/3']
    */
   includeDomains?: string[];
   /**
-   * List of domains to exclude from search results.
-   * Example: ['reddit.com', 'twitter.com']
+   * Domains or domain/path prefixes to exclude from results.
+   * Example: ['reddit.com']
    */
   excludeDomains?: string[];
   /**
-   * Only include results published after this date (ISO 8601 format).
+   * Only include results published on or after this date (YYYY-MM-DD).
    * Example: '2024-01-01'
    */
   afterDate?: string;
@@ -13389,23 +13762,32 @@ interface ParallelSearchExcerpts {
   maxCharsPerResult?: number;
   /**
    * Maximum total characters across all results.
+   * @deprecated Use the top-level `maxCharsTotal` option instead.
    */
   maxCharsTotal?: number;
 }
 interface ParallelSearchFetchPolicy {
   /**
-   * Maximum age in seconds for cached content.
-   * Set to 0 to always fetch fresh content.
+   * Maximum age in seconds of cached content before a live fetch is attempted.
+   * Minimum 600; lower values are raised to 600.
    */
   maxAgeSeconds?: number;
+  /**
+   * Timeout in seconds for a live fetch when content is not cached.
+   * The gateway caps it to stay within its own tool timeout.
+   */
+  timeoutSeconds?: number;
+  /**
+   * Return an error instead of falling back to older cached content when a
+   * live fetch fails or times out. Defaults to false.
+   */
+  disableCacheFallback?: boolean;
 }
 interface ParallelSearchConfig {
   /**
-   * Mode preset for different use cases:
-   * - "one-shot": Comprehensive results with longer excerpts for single-response answers (default)
-   * - "agentic": Concise, token-efficient results for multi-step agentic workflows
+   * Search mode. Defaults to `basic`.
    */
-  mode?: 'one-shot' | 'agentic';
+  mode?: ParallelSearchMode;
   /**
    * Default maximum number of results to return (1-20).
    * Defaults to 10 if not specified.
@@ -13419,32 +13801,59 @@ interface ParallelSearchConfig {
    * Default excerpt configuration for controlling result length.
    */
   excerpts?: ParallelSearchExcerpts;
+  /**
+   * Maximum total characters across all result excerpts.
+   */
+  maxCharsTotal?: number;
   /**
    * Default fetch policy for controlling content freshness.
    */
   fetchPolicy?: ParallelSearchFetchPolicy;
+  /**
+   * ISO 3166-1 alpha-2 country code to localize results, e.g. 'us'.
+   * Invalid codes are ignored with a warning.
+   */
+  location?: string;
 }
 interface ParallelSearchResult {
   /** URL of the search result */
   url: string;
-  /** Title of the search result */
-  title: string;
-  /** Extracted text excerpt/content from the page */
-  excerpt: string;
-  /** Publication date of the content (may be null) */
-  publishDate?: string | null;
-  /** Relevance score for the result */
-  relevanceScore?: number;
+  /** Title of the page, if available */
+  title?: string | null;
+  /** Publication date of the page (YYYY-MM-DD), if available */
+  publish_date?: string | null;
+  /** Relevant excerpts from the page, formatted as markdown */
+  excerpts: string[];
+}
+interface ParallelSearchWarning {
+  /** Warning type, e.g. 'input_validation_warning'. New types may be added. */
+  type: string;
+  /** Human-readable message */
+  message: string;
+  /** Optional detail supporting the warning */
+  detail?: Record<string, unknown> | null;
+}
+interface ParallelSearchUsage {
+  /** Usage item name, e.g. 'sku_search' */
+  name: string;
+  /** Count for the usage item */
+  count?: number;
 }
 interface ParallelSearchResponse {
   /** Unique identifier for this search request */
-  searchId: string;
-  /** Array of search results */
+  search_id: string;
+  /** Search results, ordered by decreasing relevance */
   results: ParallelSearchResult[];
+  /** Non-fatal issues with the request, such as an ignored `location` */
+  warnings?: ParallelSearchWarning[] | null;
+  /** Usage reported by Parallel for this search */
+  usage?: ParallelSearchUsage[] | null;
+  /** Session identifier shared by the searches made during one request */
+  session_id?: string;
 }
 interface ParallelSearchError {
   /** Error type */
-  error: 'api_error' | 'rate_limit' | 'timeout' | 'invalid_input' | 'configuration_error' | 'unknown';
+  error: 'api_error' | 'configuration_error' | 'execution_error' | 'gateway_rate_limit' | 'invalid_input' | 'rate_limit' | 'timeout' | 'unknown' | 'unknown_tool';
   /** HTTP status code if applicable */
   statusCode?: number;
   /** Human-readable error message */
@@ -13458,16 +13867,13 @@ interface ParallelSearchInput {
    */
   objective: string;
   /**
-   * Optional search queries to supplement the objective.
-   * Maximum 200 characters per query.
+   * 2-3 concise keyword queries, 3-6 words each (max 5, 200 characters each).
    */
   search_queries?: string[];
   /**
-   * Mode preset for different use cases:
-   * - "one-shot": Comprehensive results with longer excerpts
-   * - "agentic": Concise, token-efficient results for multi-step workflows
+   * Search mode. Defaults to `basic`.
    */
-  mode?: 'one-shot' | 'agentic';
+  mode?: ParallelSearchMode;
   /**
    * Maximum number of results to return (1-20).
    * Defaults to 10 if not specified.
@@ -13486,14 +13892,25 @@ interface ParallelSearchInput {
    */
   excerpts?: {
     max_chars_per_result?: number;
+    /** @deprecated Use the top-level `max_chars_total` instead. */
     max_chars_total?: number;
   };
+  /**
+   * Maximum total characters across all result excerpts.
+   */
+  max_chars_total?: number;
   /**
    * Fetch policy for controlling content freshness.
    */
   fetch_policy?: {
     max_age_seconds?: number;
+    timeout_seconds?: number;
+    disable_cache_fallback?: boolean;
   };
+  /**
+   * ISO 3166-1 alpha-2 country code to localize results.
+   */
+  location?: string;
 }
 type ParallelSearchOutput = ParallelSearchResponse | ParallelSearchError;
 declare const parallelSearchToolFactory: ProviderExecutedToolFactory<ParallelSearchInput, ParallelSearchOutput, ParallelSearchConfig, {}>;
@@ -14028,6 +14445,13 @@ interface GatewayProvider extends ProviderV4 {
    * transcription WebSocket without holding the Gateway credential.
    */
   experimental_transcription: GatewayTranscriptionFactory;
+  /**
+   * Experimental streaming-speech entry point. Callable like
+   * `speech(modelId)`, plus `getToken` for minting a short-lived client
+   * secret (`vcst_`) a browser can use to open the streaming speech
+   * WebSocket without holding the Gateway credential.
+   */
+  experimental_speech: GatewaySpeechFactory;
   /**
    * Gateway-specific tools executed server-side.
    */
@@ -14057,6 +14481,30 @@ interface GatewayTranscriptionFactory {
   (modelId: GatewayTranscriptionModelId): TranscriptionModelV4;
   getToken(options: GatewayTranscriptionFactoryGetTokenOptions): Promise<GatewayTranscriptionFactoryGetTokenResult>;
 }
+type GatewaySpeechFactoryGetTokenOptions = {
+  model: GatewaySpeechModelId;
+  /** Token lifetime in seconds. Gateway default is 60s (max 300s). */
+  expiresAfterSeconds?: number;
+};
+type GatewaySpeechFactoryGetTokenResult = {
+  /** The minted `vcst_` client secret. */
+  token: string;
+  /** WebSocket URL of the streaming speech surface for this model. */
+  url: string;
+  /** Token expiry, epoch seconds. */
+  expiresAt?: number;
+};
+/**
+ * Streaming-speech factory: callable like `speech(modelId)`, plus a
+ * server-side `getToken` that mints a speech-bound short-lived client secret
+ * (`vcst_`). The browser connects with
+ * `createGateway({ apiKey: token }).speech(modelId)`; the token rides the
+ * same auth subprotocol an API key does, without exposing the credential.
+ */
+interface GatewaySpeechFactory {
+  (modelId: GatewaySpeechModelId): StreamingSpeechModelV4;
+  getToken(options: GatewaySpeechFactoryGetTokenOptions): Promise<GatewaySpeechFactoryGetTokenResult>;
+}
 interface GatewayProviderSettings {
   /** Settings for downloading JSON Lines batch results. */
   batchResultDownloads?: {
@@ -14087,10 +14535,10 @@ interface GatewayProviderSettings {
    */
   fetch?: FetchFunction;
   /**
-   * Custom WebSocket implementation used for streaming transcription. This is
-   * useful for testing or for runtimes without a global WebSocket. A
-   * header-capable implementation is not required — Gateway WebSocket auth is
-   * carried in the subprotocols.
+   * Custom WebSocket implementation used for streaming transcription and
+   * streaming speech. This is useful for testing or for runtimes without a
+   * global WebSocket. A header-capable implementation is not required —
+   * Gateway WebSocket auth is carried in the subprotocols.
    */
   webSocket?: WebSocketConstructor;
   /**
@@ -14129,8 +14577,12 @@ type GatewayProviderMetadata = {
   readonly [key: string]: JSONValue$3 | undefined;
 };
 declare namespace index_d_exports {
-  export { AISDKError, AI_SDK_TELEMETRY_TRACING_CHANNEL, APICallError, AbstractChat, ActiveTools, Agent$1 as Agent, AgentCallParameters, AgentStreamParameters, AssistantContent, AssistantModelMessage, AsyncIterableStream, CallSettings, CallWarning, CallWarningRegistry, ChatAddToolApproveResponseFunction, ChatAddToolOutputFunction, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, CompletionRequestOptions, ContentPart, CreateUIMessage, CustomContentUIPart, DataContent, DataUIPart, DeepPartial, DefaultChatTransport, DefaultGeneratedFile, DirectChatTransport, DirectChatTransportOptions, DownloadError, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedEndEvent, EmbedManyResult, EmbedResult, EmbedStartEvent, Embedding, EmbeddingModel, EmbeddingModelCallEndEvent, EmbeddingModelCallStartEvent, EmbeddingModelMiddleware, EmbeddingModelUsage, EmptyResponseBodyError, ErrorHandler, AbstractRealtimeSession as Experimental_AbstractRealtimeSession, ToolLoopAgent as Experimental_Agent, ToolLoopAgentSettings as Experimental_AgentSettings, Batch as Experimental_Batch, BatchError as Experimental_BatchError, BatchItemResult as Experimental_BatchItemResult, BatchProvider as Experimental_BatchProvider, BatchReference as Experimental_BatchReference, BatchRequest as Experimental_BatchRequest, BatchStatus as Experimental_BatchStatus, CancelBatchOptions as Experimental_CancelBatchOptions, CancelBatchResult as Experimental_CancelBatchResult, DecideEndEvent as Experimental_DecideEndEvent, DecideStartEvent as Experimental_DecideStartEvent, DecisionAnswer as Experimental_DecisionAnswer, DecisionModel as Experimental_DecisionModel, DecisionModelCallEndEvent as Experimental_DecisionModelCallEndEvent, DecisionModelCallStartEvent as Experimental_DecisionModelCallStartEvent, DecisionProviderRegistry as Experimental_DecisionProviderRegistry, DecisionQuestion as Experimental_DecisionQuestion, DecisionRefusalError as Experimental_DecisionRefusalError, DecisionResult as Experimental_DecisionResult, DecisionUnsupportedQuestionTypeError as Experimental_DecisionUnsupportedQuestionTypeError, DownloadFunction as Experimental_DownloadFunction, Experimental_EvaluateEndEvent, Experimental_EvaluateStartEvent, Experimental_EvaluationAnswer, Experimental_EvaluationModel, Experimental_EvaluationModelCallEndEvent, Experimental_EvaluationModelCallStartEvent, Experimental_EvaluationProviderRegistry, Experimental_EvaluationQuestion, Experimental_EvaluationResult, Experimental_EvaluationUnsupportedQuestionTypeError, Experimental_GeneratedImage, GetBatchResultsOptions as Experimental_GetBatchResultsOptions, GetBatchStatusOptions as Experimental_GetBatchStatusOptions, ImageBatchGenerationResult as Experimental_ImageBatchGenerationResult, ImageBatchItemResult as Experimental_ImageBatchItemResult, ImageBatchRequest as Experimental_ImageBatchRequest, InferAgentUIMessage as Experimental_InferAgentUIMessage, LanguageModelStreamPart as Experimental_LanguageModelStreamPart, ListBatchesOptions as Experimental_ListBatchesOptions, ListBatchesResult as Experimental_ListBatchesResult, LogWarningsFunction as Experimental_LogWarningsFunction, RealtimeClientEvent as Experimental_RealtimeClientEvent, RealtimeFactory as Experimental_RealtimeFactory, RealtimeFactoryGetTokenOptions as Experimental_RealtimeFactoryGetTokenOptions, RealtimeFactoryGetTokenResult as Experimental_RealtimeFactoryGetTokenResult, RealtimeModel as Experimental_RealtimeModel, RealtimeServerEvent as Experimental_RealtimeServerEvent, RealtimeSessionConfig as Experimental_RealtimeSessionConfig, RealtimeSessionOptions as Experimental_RealtimeSessionOptions, RealtimeSessionState as Experimental_RealtimeSessionState, RealtimeSetupResponse as Experimental_RealtimeSetupResponse, RealtimeState as Experimental_RealtimeState, RealtimeStatus as Experimental_RealtimeStatus, RealtimeToolDefinition as Experimental_RealtimeToolDefinition, SandboxProcess as Experimental_SandboxProcess, SandboxSession as Experimental_SandboxSession, Experimental_SpeechResult, StartBatchOptions as Experimental_StartBatchOptions, StartBatchResult as Experimental_StartBatchResult, StreamTranscriptionEndEvent as Experimental_StreamTranscriptionEndEvent, StreamTranscriptionStartEvent as Experimental_StreamTranscriptionStartEvent, StreamTranslationResult as Experimental_StreamTranslationResult, TextBatchGenerationResult as Experimental_TextBatchGenerationResult, TextBatchItemResult as Experimental_TextBatchItemResult, TextBatchRequest as Experimental_TextBatchRequest, ToolCallerTool as Experimental_ToolCallerTool, Experimental_ToolCallers, Experimental_TranscriptionResult, TranslationStreamPart as Experimental_TranslationStreamPart, FilePart, FileUIPart, FinishReason, FlexibleSchema, GatewayAsyncJobMetadata, GatewayModelId, GatewayProviderMetadata, GenerateImageCall, GenerateImageResult, GenerateObjectEndEvent, GenerateObjectResult, GenerateObjectStartEvent, GenerateObjectStepEndEvent, GenerateObjectStepStartEvent, GenerateSpeechEndEvent, GenerateSpeechStartEvent, GenerateTextAbortEvent, GenerateTextEndEvent, GenerateTextInclude, GenerateTextOnAbortCallback, GenerateTextOnEndCallback, GenerateTextOnFinishCallback, GenerateTextOnStartCallback, GenerateTextOnStepEndCallback, GenerateTextOnStepFinishCallback, GenerateTextOnStepStartCallback, GenerateTextResult, GenerateTextStartEvent, GenerateTextStepEndEvent, GenerateTextStepStartEvent, GenerateVideoPrompt, GenerateVideoResult, GeneratedAudioFile, GeneratedFile, GenericToolApprovalFunction, GetVideoStatusResult, HttpChatTransport, HttpChatTransportInitOptions, IdGenerator, ImageModel, ImageModelMiddleware, ImageModelProviderMetadata, ImageModelResponseMetadata, ImageModelUsage, ImagePart, InferAgentUIMessage, InferCompleteOutput as InferGenerateOutput, InferSchema, InferPartialOutput as InferStreamOutput, InferTelemetryEvent, InferToolInput, InferToolOutput, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, Instructions, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidPromptError, InvalidResponseDataError, InvalidStreamPartError, InvalidToolApprovalError, InvalidToolApprovalSignatureError, InvalidToolInputError, JSONParseError, JSONSchema7$1 as JSONSchema7, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelCallEndEvent, LanguageModelCallOptions, LanguageModelCallStartEvent, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, LoadAPIKeyError, LoadSettingError, LogWarningsFunction, MessageConversionError, MissingToolResultsError, ModelInfo, ModelMessage, NoContentGeneratedError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoSpeechGeneratedError, NoSuchModelError, NoSuchProviderError, NoSuchProviderReferenceError, NoSuchToolError, NoTranscriptGeneratedError, NoTranslationGeneratedError, NoVideoGeneratedError, ObjectStreamPart, OnFinishEvent, OnLanguageModelCallEndCallback, OnLanguageModelCallStartCallback, OnStartEvent, OnStepFinishEvent, OnStepStartEvent, OnToolCallFinishEvent, OnToolCallStartEvent, OnToolExecutionEndCallback, OnToolExecutionStartCallback, output_d_exports as Output, OutputChunkTimingStats, Output as OutputInterface, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, Prompt, Provider, ProviderMetadata, ProviderReference, ProviderRegistryProvider, ReasoningFileOutput, ReasoningFileUIPart, ReasoningOutput, ReasoningUIPart, RepairTextFunction, RequestOptions, RerankEndEvent, RerankResult, RerankStartEvent, RerankingModel, RerankingModelCallEndEvent, RerankingModelCallStartEvent, RetryError, SafeValidateUIMessagesResult, Schema, SerialJobExecutor, SingleToolApprovalFunction, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, SpeechResult, StartVideoResult, StaticToolCall, StaticToolError, StaticToolOutputDenied, StaticToolResult, StepResult, StepResultPerformance, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamProviderError, StreamTextEndEvent, StreamTextInclude, StreamTextOnChunkCallback, StreamTextOnEndCallback, StreamTextOnErrorCallback, StreamTextOnErrorResult, StreamTextOnErrorRetryCallback, StreamTextResult, StreamTextTransform, StreamTranscriptionResult, SystemModelMessage, Telemetry, TelemetryOptions, TelemetryTracingChannelMessage, TelemetryTracingEventType, TextPart, TextStreamChatTransport, TextStreamPart, TextUIPart, TimeoutConfiguration, ToUIMessageChunkOptions, TooManyEmbeddingValuesForCallError, Tool, ToolApprovalConfiguration, ToolApprovalRequest, ToolApprovalRequestOutput, ToolApprovalResponse, ToolApprovalResponseOutput, ToolApprovalStatus, ToolCallNotFoundForApprovalError, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolChoiceViolationError, ToolContent, ToolExecuteFunction, ToolExecutionEndEvent, ToolExecutionOptions, ToolExecutionStartEvent, ToolInputRefinement, ToolLoopAgent, ToolLoopAgentSettings, ToolModelMessage, ToolOrder, ToolOutputErrorUIPart, ToolResultPart, ToolSet, ToolUIPart, TranscriptionEndEvent, TranscriptionModel, TranscriptionModelResponseMetadata, TranscriptionResult, TranscriptionStartEvent, TranscriptionStreamPart, TypeValidationError, TypedToolCall, TypedToolError, TypedToolOutputDenied, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamError, UIMessageStreamOnEndCallback, UIMessageStreamOnFinishCallback, UIMessageStreamOnStepEndCallback, UIMessageStreamOnStepFinishCallback, UIMessageStreamOptions, UIMessageStreamOutcome, UIMessageStreamWriter, UIMessageStreamWriterWithOutcome, UITool, UIToolInvocation, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedFunctionalityError, UnsupportedModelVersionError, UploadFileResult, UploadSkillResult, UseCompletionOptions, UserContent, UserModelMessage, Warning, 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, streamTranscribe as experimental_streamTranscribe, streamTranslate as experimental_streamTranslate, toolCaller as experimental_toolCaller, experimental_transcribe, extractJsonMiddleware, extractReasoningMiddleware, fingerprintTools, gateway, generateId$1 as 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, isTextUIPart, isToolOutputErrorUIPart, isToolUIPart, jsonSchema, lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parseJsonEventStream, parsePartialJson, pipeAgentUIStreamToResponse, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, pruneMessages, readUIMessageStream, registerTelemetry, rerank, safeValidateUIMessages, simulateReadableStream, simulateStreamingMiddleware, smoothStream, isStepCount as stepCountIs, streamObject, streamText, systemModelMessageSchema, toTextStream, toUIMessageChunk, toUIMessageStream, tool$1 as tool, toolModelMessageSchema, toolSearch, transcribe, uiMessageChunkSchema, uploadFile, uploadSkill, userModelMessageSchema, validateUIMessages, wrapEmbeddingModel, wrapImageModel, wrapLanguageModel$1 as wrapLanguageModel, wrapProvider, zodSchema };
+  export { AISDKError, AI_SDK_TELEMETRY_TRACING_CHANNEL, APICallError, AbstractChat, ActiveTools, Agent$1 as Agent, AgentCallParameters, AgentStreamParameters, AssistantContent, AssistantModelMessage, AsyncIterableStream, CallSettings, CallWarning, CallWarningRegistry, ChatAddToolApproveResponseFunction, ChatAddToolOutputFunction, ChatInit, ChatOnDataCallback, ChatOnErrorCallback, ChatOnFinishCallback, ChatOnToolCallCallback, ChatRequestOptions, ChatState, ChatStatus, ChatTransport, ChunkDetector, Citation, CompletionRequestOptions, ContentPart, CreateUIMessage, CustomContentUIPart, DataContent, DataUIPart, DeepPartial, DefaultChatTransport, DefaultGeneratedFile, DirectChatTransport, DirectChatTransportOptions, DownloadError, DynamicToolCall, DynamicToolError, DynamicToolResult, DynamicToolUIPart, EmbedEndEvent, EmbedManyResult, EmbedResult, EmbedStartEvent, Embedding, EmbeddingModel, EmbeddingModelCallEndEvent, EmbeddingModelCallStartEvent, EmbeddingModelMiddleware, EmbeddingModelUsage, EmptyResponseBodyError, ErrorHandler, AbstractRealtimeSession as Experimental_AbstractRealtimeSession, ToolLoopAgent as Experimental_Agent, ToolLoopAgentSettings as Experimental_AgentSettings, Batch as Experimental_Batch, BatchError as Experimental_BatchError, BatchItemResult as Experimental_BatchItemResult, BatchProvider as Experimental_BatchProvider, BatchReference as Experimental_BatchReference, BatchRequest as Experimental_BatchRequest, BatchStatus as Experimental_BatchStatus, CancelBatchOptions as Experimental_CancelBatchOptions, CancelBatchResult as Experimental_CancelBatchResult, DecideEndEvent as Experimental_DecideEndEvent, DecideStartEvent as Experimental_DecideStartEvent, DecisionAnswer as Experimental_DecisionAnswer, DecisionModel as Experimental_DecisionModel, DecisionModelCallEndEvent as Experimental_DecisionModelCallEndEvent, DecisionModelCallStartEvent as Experimental_DecisionModelCallStartEvent, DecisionProviderRegistry as Experimental_DecisionProviderRegistry, DecisionModelV4Question as Experimental_DecisionQuestion, DecisionRefusalError as Experimental_DecisionRefusalError, DecisionResult as Experimental_DecisionResult, DecisionState as Experimental_DecisionState, DecisionStatePart as Experimental_DecisionStatePart, DecisionUnsupportedQuestionTypeError as Experimental_DecisionUnsupportedQuestionTypeError, DownloadFunction as Experimental_DownloadFunction, Experimental_EvaluateEndEvent, Experimental_EvaluateStartEvent, Experimental_EvaluationAnswer, Experimental_EvaluationModel, Experimental_EvaluationModelCallEndEvent, Experimental_EvaluationModelCallStartEvent, Experimental_EvaluationProviderRegistry, Experimental_EvaluationQuestion, Experimental_EvaluationResult, Experimental_EvaluationUnsupportedQuestionTypeError, Experimental_GeneratedImage, GetBatchResultsOptions as Experimental_GetBatchResultsOptions, GetBatchStatusOptions as Experimental_GetBatchStatusOptions, ImageBatchGenerationResult as Experimental_ImageBatchGenerationResult, ImageBatchItemResult as Experimental_ImageBatchItemResult, ImageBatchRequest as Experimental_ImageBatchRequest, InferAgentUIMessage as Experimental_InferAgentUIMessage, LanguageModelStreamPart as Experimental_LanguageModelStreamPart, ListBatchesOptions as Experimental_ListBatchesOptions, ListBatchesResult as Experimental_ListBatchesResult, LogWarningsFunction as Experimental_LogWarningsFunction, RealtimeClientEvent as Experimental_RealtimeClientEvent, RealtimeFactory as Experimental_RealtimeFactory, RealtimeFactoryGetTokenOptions as Experimental_RealtimeFactoryGetTokenOptions, RealtimeFactoryGetTokenResult as Experimental_RealtimeFactoryGetTokenResult, RealtimeModel as Experimental_RealtimeModel, RealtimeServerEvent as Experimental_RealtimeServerEvent, RealtimeSessionConfig as Experimental_RealtimeSessionConfig, RealtimeSessionOptions as Experimental_RealtimeSessionOptions, RealtimeSessionState as Experimental_RealtimeSessionState, RealtimeSetupResponse as Experimental_RealtimeSetupResponse, RealtimeState as Experimental_RealtimeState, RealtimeStatus as Experimental_RealtimeStatus, RealtimeToolDefinition as Experimental_RealtimeToolDefinition, SandboxProcess as Experimental_SandboxProcess, SandboxSession as Experimental_SandboxSession, Experimental_SpeechResult, SpeechStreamPart as Experimental_SpeechStreamPart, SpeechStreamUsage as Experimental_SpeechStreamUsage, SpeechTextPart as Experimental_SpeechTextPart, StartBatchOptions as Experimental_StartBatchOptions, StartBatchResult as Experimental_StartBatchResult, Steering as Experimental_Steering, SteeringNotDeliveredReason as Experimental_SteeringNotDeliveredReason, SteeringOutcome as Experimental_SteeringOutcome, StreamSpeechResult as Experimental_StreamSpeechResult, StreamTranscriptionEndEvent as Experimental_StreamTranscriptionEndEvent, StreamTranscriptionStartEvent as Experimental_StreamTranscriptionStartEvent, StreamTranslationResult as Experimental_StreamTranslationResult, TextBatchGenerationResult as Experimental_TextBatchGenerationResult, TextBatchItemResult as Experimental_TextBatchItemResult, TextBatchRequest as Experimental_TextBatchRequest, ToolCallerTool as Experimental_ToolCallerTool, Experimental_ToolCallers, Experimental_TranscriptionResult, TranslationStreamPart as Experimental_TranslationStreamPart, FilePart, FileUIPart, FinishReason, FlexibleSchema, GatewayAsyncJobMetadata, GatewayModelId, GatewayProviderMetadata, GenerateImageCall, GenerateImageResult, GenerateObjectEndEvent, GenerateObjectResult, GenerateObjectStartEvent, GenerateObjectStepEndEvent, GenerateObjectStepStartEvent, GenerateSpeechEndEvent, GenerateSpeechStartEvent, GenerateTextAbortEvent, GenerateTextEndEvent, GenerateTextInclude, GenerateTextOnAbortCallback, GenerateTextOnEndCallback, GenerateTextOnFinishCallback, GenerateTextOnStartCallback, GenerateTextOnStepEndCallback, GenerateTextOnStepErrorCallback, GenerateTextOnStepFinishCallback, GenerateTextOnStepStartCallback, GenerateTextResult, GenerateTextStartEvent, GenerateTextStepEndEvent, GenerateTextStepErrorEvent, GenerateTextStepStartEvent, GenerateVideoPrompt, GenerateVideoResult, GeneratedAudioFile, GeneratedFile, GenericToolApprovalFunction, GetVideoStatusResult, HttpChatTransport, HttpChatTransportInitOptions, IdGenerator, ImageModel, ImageModelMiddleware, ImageModelProviderMetadata, ImageModelResponseMetadata, ImageModelUsage, ImagePart, InferAgentUIMessage, InferCompleteOutput as InferGenerateOutput, InferSchema, InferPartialOutput as InferStreamOutput, InferTelemetryEvent, InferToolInput, InferToolOutput, InferUIDataParts, InferUIMessageChunk, InferUITool, InferUITools, Instructions, InvalidArgumentError, InvalidDataContentError, InvalidMessageRoleError, InvalidPromptError, InvalidResponseDataError, InvalidStreamPartError, InvalidToolApprovalError, InvalidToolApprovalSignatureError, InvalidToolInputError, JSONParseError, JSONSchema7$2 as JSONSchema7, JSONValue, JsonToSseTransformStream, LanguageModel, LanguageModelCallEndEvent, LanguageModelCallOptions, LanguageModelCallStartEvent, LanguageModelMiddleware, LanguageModelRequestMetadata, LanguageModelResponseMetadata, LanguageModelUsage, LoadAPIKeyError, LoadSettingError, LogWarningsFunction, MessageConversionError, MissingToolResultsError, ModelInfo, ModelMessage, NoContentGeneratedError, NoImageGeneratedError, NoObjectGeneratedError, NoOutputGeneratedError, NoSpeechGeneratedError, NoSuchModelError, NoSuchProviderError, NoSuchProviderReferenceError, NoSuchToolError, NoTranscriptGeneratedError, NoTranslationGeneratedError, NoVideoGeneratedError, ObjectStreamPart, OnFinishEvent, OnLanguageModelCallEndCallback, OnLanguageModelCallStartCallback, OnStartEvent, OnStepFinishEvent, OnStepStartEvent, OnToolCallFinishEvent, OnToolCallStartEvent, OnToolExecutionEndCallback, OnToolExecutionStartCallback, output_d_exports as Output, OutputChunkTimingStats, Output as OutputInterface, PrepareReconnectToStreamRequest, PrepareSendMessagesRequest, PrepareStepFunction, PrepareStepResult, PrepareWebSocketChatTransportReconnectToStreamRequest, PrepareWebSocketChatTransportSendMessagesRequest, Prompt, Provider, ProviderMetadata, ProviderReference, ProviderRegistryProvider, ReasoningFileOutput, ReasoningFileUIPart, ReasoningOutput, ReasoningUIPart, RepairTextFunction, RequestOptions, RerankEndEvent, RerankResult, RerankStartEvent, RerankingModel, RerankingModelCallEndEvent, RerankingModelCallStartEvent, RetryError, SafeValidateUIMessagesResult, SafeValidateWebSocketChatTransportRequestResult, Schema, SerialJobExecutor, SingleToolApprovalFunction, SourceDocumentUIPart, SourceUrlUIPart, SpeechModel, SpeechModelResponseMetadata, SpeechResult, StartVideoResult, StaticToolCall, StaticToolError, StaticToolOutputDenied, StaticToolResult, StepResult, StepResultPerformance, StepStartUIPart, StopCondition, StreamObjectOnFinishCallback, StreamObjectResult, StreamProviderError, StreamTextEndEvent, StreamTextInclude, StreamTextOnChunkCallback, StreamTextOnEndCallback, StreamTextOnErrorCallback, StreamTextOnErrorResult, StreamTextOnErrorRetryCallback, StreamTextResult, StreamTextTransform, StreamTranscriptionResult, SystemModelMessage, Telemetry, TelemetryOptions, TelemetryTracingChannelMessage, TelemetryTracingEventType, TextPart, TextStreamChatTransport, TextStreamPart, TextUIPart, TimeoutConfiguration, ToUIMessageChunkOptions, TooManyEmbeddingValuesForCallError, Tool, ToolApprovalConfiguration, ToolApprovalRequest, ToolApprovalRequestOutput, ToolApprovalResponse, ToolApprovalResponseOutput, ToolApprovalStatus, ToolCallNotFoundForApprovalError, ToolCallPart, ToolCallRepairError, ToolCallRepairFunction, ToolChoice, ToolChoiceViolationError, ToolContent, ToolExecuteFunction, ToolExecutionEndEvent, ToolExecutionOptions, ToolExecutionStartEvent, ToolInputRefinement, ToolLoopAgent, ToolLoopAgentSettings, ToolModelMessage, ToolOrder, ToolOutputErrorUIPart, ToolResultPart, ToolSet, ToolUIPart, TranscriptionEndEvent, TranscriptionModel, TranscriptionModelResponseMetadata, TranscriptionResult, TranscriptionStartEvent, TranscriptionStreamPart, TypeValidationError, TypedToolCall, TypedToolError, TypedToolOutputDenied, TypedToolResult, UIDataPartSchemas, UIDataTypes, UIMessage, UIMessageChunk, UIMessagePart, UIMessageStreamError, UIMessageStreamOnEndCallback, UIMessageStreamOnFinishCallback, UIMessageStreamOnStepEndCallback, UIMessageStreamOnStepFinishCallback, UIMessageStreamOptions, UIMessageStreamOutcome, UIMessageStreamWriter, UIMessageStreamWriterWithOutcome, UITool, UIToolInvocation, UITools, UI_MESSAGE_STREAM_HEADERS, UnsupportedFunctionalityError, UnsupportedModelVersionError, UploadFileResult, UploadSkillResult, UseCompletionOptions, UserContent, UserModelMessage, Warning, WebSocketChatTransport, WebSocketChatTransportAbortRequest, WebSocketChatTransportInitOptions, WebSocketChatTransportRequest, WebSocketChatTransportResponse, WebSocketChatTransportResumeRequest, WebSocketChatTransportSendRequest, 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, toolCaller as experimental_toolCaller, experimental_transcribe, extractJsonMiddleware, extractReasoningMiddleware, fingerprintTools, gateway, generateId$1 as 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, isTextUIPart, isToolOutputErrorUIPart, isToolUIPart, jsonSchema, lastAssistantMessageIsCompleteWithApprovalResponses, lastAssistantMessageIsCompleteWithToolCalls, modelMessageSchema, parseJsonEventStream, parsePartialJson, pipeAgentUIStreamToResponse, pipeTextStreamToResponse, pipeUIMessageStreamToResponse, pruneMessages, readUIMessageStream, registerTelemetry, rerank, safeValidateUIMessages, safeValidateWebSocketChatTransportRequest, simulateReadableStream, simulateStreamingMiddleware, smoothStream, isStepCount as stepCountIs, streamObject, streamText, systemModelMessageSchema, toTextStream, toUIMessageChunk, toUIMessageStream, tool$1 as tool, toolModelMessageSchema, toolSearch, transcribe, uiMessageChunkSchema, uploadFile, uploadSkill, userModelMessageSchema, validateUIMessages, wrapEmbeddingModel, wrapImageModel, wrapLanguageModel$1 as wrapLanguageModel, wrapProvider, zodSchema };
 }
+//#region src/types/citation.d.ts
+/** A reference supporting a generated text part. */
+type Citation = LanguageModelV4Citation;
+//#endregion
 //#region src/types/embedding-model.d.ts
 /**
  * Embedding model that is used by the AI SDK.
@@ -14245,9 +14697,10 @@ type LanguageModel = GlobalProviderModelId | LanguageModelV4 | LanguageModelV3$1
  * - `content-filter`: content filter violation stopped the model
  * - `tool-calls`: model triggered tool calls
  * - `error`: model stopped because of an error
+ * - `interrupted`: provider stream ended without a completion signal; output may be incomplete
  * - `other`: model stopped for other reasons
  */
-type FinishReason = 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other';
+type FinishReason = 'stop' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'interrupted' | 'other';
 /**
  * Registry for call warning variants. Packages that expose additional warning
  * protocols can augment this interface.
@@ -14582,6 +15035,8 @@ type EmbedStartEvent<RUNTIME_CONTEXT extends Context$1 = Context$1> = {
   readonly modelId: string;
   /** The value(s) being embedded. A string for embed, an array for embedMany. */
   readonly value: string | Array<string>;
+  /** Requested output dimensions, when specified. */
+  readonly dimensions?: number;
   /** Maximum number of retries for failed requests. */
   readonly maxRetries: number;
   /** Additional HTTP headers sent with the request. */
@@ -14643,6 +15098,8 @@ type EmbeddingModelCallStartEvent = {
   readonly modelId: string;
   /** The values being embedded in this particular model call. */
   readonly values: Array<string>;
+  /** Requested output dimensions, when specified. */
+  readonly dimensions?: number;
 };
 /**
  * Event fired when an individual embedding model call (doEmbed) completes.
@@ -14668,10 +15125,17 @@ type EmbeddingModelCallEndEvent = {
   readonly usage: EmbeddingModelUsage;
 };
 //#endregion
+//#region src/decide/decision-state.d.ts
+/** Shared text, JSON data, or ordered multimodal parts for a decision. */
+type DecisionState = string | Readonly<JSONObject$2> | readonly DecisionStatePart[];
+type DecisionStatePart = TextPart | FilePart | {
+  type: 'json';
+  value: JSONValue$3;
+};
+//#endregion
 //#region src/decide/decision-result.d.ts
 type DecisionModel = string | DecisionModelV4 | Experimental_EvaluationModelV4;
-type DecisionQuestion = DecisionModelV4Question;
-type DecisionAnswer<QUESTION extends DecisionQuestion> = QUESTION extends {
+type DecisionAnswer<QUESTION extends DecisionModelV4Question> = QUESTION extends {
   type: 'choice';
   criteria: infer CRITERIA;
 } ? {
@@ -14684,11 +15148,21 @@ type DecisionAnswer<QUESTION extends DecisionQuestion> = QUESTION extends {
   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;
 };
-type DecisionResult<QUESTIONS extends Record<string, DecisionQuestion>> = {
+type DecisionResult<QUESTIONS extends Record<string, DecisionModelV4Question>> = {
   readonly answers: { [ID in keyof QUESTIONS]: DecisionAnswer<QUESTIONS[ID]>; };
   readonly usage: {
     inputTokens: number | undefined;
@@ -14722,9 +15196,13 @@ type DecideStartEvent<RUNTIME_CONTEXT extends Context$1 = Context$1> = {
   /** The decision model identifier. */
   readonly modelId: string;
   /** The shared state used to make decisions. */
-  readonly state: DecisionModelV4CallOptions['state'];
+  readonly state: DecisionState;
   /** The questions to decide against the shared state. */
-  readonly questions: Readonly<Record<string, DecisionQuestion>>;
+  readonly questions: Readonly<Record<string, DecisionModelV4Question>>;
+  /** Maximum output tokens requested for the decision. */
+  readonly maxOutputTokens?: number;
+  /** Reasoning effort requested for the decision. */
+  readonly reasoning?: DecisionModelV4CallOptions['reasoning'];
   /** Maximum number of retries for the decision model call. */
   readonly maxRetries: number;
   /** Additional HTTP headers sent with the request. */
@@ -14739,17 +15217,17 @@ type DecideStartEvent<RUNTIME_CONTEXT extends Context$1 = Context$1> = {
  */
 type DecideEndEvent<RUNTIME_CONTEXT extends Context$1 = Context$1> = DecideStartEvent<RUNTIME_CONTEXT> & {
   /** Exactly one typed answer per question ID. */
-  readonly answers: DecisionResult<Record<string, DecisionQuestion>>['answers'];
+  readonly answers: DecisionResult<Record<string, DecisionModelV4Question>>['answers'];
   /** Token usage for the decision operation. */
-  readonly usage: DecisionResult<Record<string, DecisionQuestion>>['usage'];
+  readonly usage: DecisionResult<Record<string, DecisionModelV4Question>>['usage'];
   /** Warnings from the decision model. */
-  readonly warnings: DecisionResult<Record<string, DecisionQuestion>>['warnings'];
+  readonly warnings: DecisionResult<Record<string, DecisionModelV4Question>>['warnings'];
   /** Provider-declared decimal precision for probabilities and scores. */
-  readonly rounding: DecisionResult<Record<string, DecisionQuestion>>['rounding'];
+  readonly rounding: DecisionResult<Record<string, DecisionModelV4Question>>['rounding'];
   /** Optional provider-specific metadata. */
-  readonly providerMetadata: DecisionResult<Record<string, DecisionQuestion>>['providerMetadata'];
+  readonly providerMetadata: DecisionResult<Record<string, DecisionModelV4Question>>['providerMetadata'];
   /** Response metadata, including the resolved model ID and timestamp. */
-  readonly response: DecisionResult<Record<string, DecisionQuestion>>['response'];
+  readonly response: DecisionResult<Record<string, DecisionModelV4Question>>['response'];
 };
 /**
  * Event fired when the decision model call begins.
@@ -14768,7 +15246,7 @@ type DecisionModelCallStartEvent = {
   /** The shared state used to make decisions. */
   readonly state: DecisionModelV4CallOptions['state'];
   /** The questions to decide against the shared state. */
-  readonly questions: Readonly<Record<string, DecisionQuestion>>;
+  readonly questions: DecisionModelV4CallOptions['questions'];
 };
 /**
  * Event fired after the decision model response has been validated.
@@ -14865,9 +15343,9 @@ type LanguageModelCallOptions = {
  * Timeout configuration for API calls. Can be specified as:
  * - A number representing milliseconds
  * - An object with `totalMs` property for the total timeout in milliseconds
- * - An object with `stepMs` property for the timeout of each step in milliseconds
+ * - An object with `stepMs` property for the timeout of each complete step, including model generation, retries, and local tool execution, in milliseconds
  * - An object with `firstChunkMs` property for the timeout until the first content chunk of each step (streaming only)
- * - An object with `chunkMs` property for the timeout between content chunks (streaming only)
+ * - An object with `chunkMs` property for the timeout between meaningful model output chunks, starting with the first output and ending when the model response ends (streaming only)
  * - An object with `toolMs` property for the default timeout for all tool executions
  * - An object with `tools` property for per-tool timeout overrides using `{toolName}Ms` keys
  */
@@ -15421,7 +15899,7 @@ type BaseToolCall = {
  * A tool call whose `toolName` maps to a tool in the declared tool set,
  * with an `input` type inferred from that tool's input schema.
  */
-type StaticToolCall<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]: BaseToolCall & {
+type StaticToolCall<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]-?: BaseToolCall & {
   toolName: NAME & string;
   input: InferToolInput<TOOLS[NAME]>;
   dynamic?: false | undefined;
@@ -15516,7 +15994,7 @@ type ToolApprovalResponseOutput<TOOLS extends ToolSet> = {
 };
 //#endregion
 //#region src/generate-text/tool-error.d.ts
-type StaticToolError<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]: {
+type StaticToolError<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]-?: {
   type: 'tool-error';
   toolCallId: string;
   toolName: NAME & string;
@@ -15543,7 +16021,7 @@ type DynamicToolError = {
 type TypedToolError<TOOLS extends ToolSet> = StaticToolError<TOOLS> | DynamicToolError;
 //#endregion
 //#region src/generate-text/tool-result.d.ts
-type StaticToolResult<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]: {
+type StaticToolResult<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]-?: {
   type: 'tool-result';
   toolCallId: string;
   toolName: NAME & string;
@@ -15575,6 +16053,7 @@ type TypedToolResult<TOOLS extends ToolSet> = StaticToolResult<TOOLS> | DynamicT
 type ContentPart<TOOLS extends ToolSet> = {
   type: 'text';
   text: string;
+  citations?: Array<Citation>;
   providerMetadata?: ProviderMetadata;
 } | {
   type: 'custom';
@@ -15800,6 +16279,12 @@ type StepResult<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Conte
    * results that can be fully encapsulated in the provider.
    */
   readonly providerMetadata: ProviderMetadata | undefined;
+  /**
+   * The user messages that were sent with `experimental_steering` and added
+   * to the input of this step. Undefined when the step received no steering
+   * messages.
+   */
+  readonly experimental_steeringMessages?: Array<UserModelMessage>;
 };
 //#endregion
 //#region src/generate-text/language-model-events.d.ts
@@ -15905,205 +16390,6 @@ type OnLanguageModelCallStartCallback = Callback<LanguageModelCallStartEvent>;
  */
 type OnLanguageModelCallEndCallback<TOOLS extends ToolSet = ToolSet> = 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> = 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, RUNTIME_CONTEXT extends Context$1 = Context$1> = (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>;
-  /**
-   * The initial messages that were passed into generateText or streamText.
-   */
-  initialMessages: Array<ModelMessage>;
-  /**
-   * 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?: SandboxSession;
-}) => 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, RUNTIME_CONTEXT extends Context$1 = Context$1> = ({
-  /**
-   * 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>;
-  /**
-   * 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?: SandboxSession;
-  /**
-   * 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, RUNTIME_CONTEXT extends Context$1 = Context$1> = (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.
- */
-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.
- */
-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.
- */
-declare function hasToolCall<TOOLS extends ToolSet>(...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.
@@ -16159,6 +16445,8 @@ type UIMessagePart<DATA_TYPES extends UIDataTypes, TOOLS extends UITools> = Text
  */
 type TextUIPart = {
   type: 'text';
+  /** References supporting this text, separate from retrieved sources. */
+  citations?: Array<Citation>;
   /**
    * The text content.
    */
@@ -16330,6 +16618,8 @@ type UIToolInvocation<TOOL extends UITool | Tool> = {
    * and later resumed.
    */
   rawInput?: string;
+  /** Encoding of `rawInput`. Defaults to JSON when omitted. */
+  inputEncoding?: 'json' | 'text';
   output?: never;
   errorText?: never;
   callProviderMetadata?: ProviderMetadata;
@@ -16466,6 +16756,8 @@ type DynamicToolUIPart = {
    * and later resumed.
    */
   rawInput?: string;
+  /** Encoding of `rawInput`. Defaults to JSON when omitted. */
+  inputEncoding?: 'json' | 'text';
   output?: never;
   errorText?: never;
   callProviderMetadata?: ProviderMetadata;
@@ -16663,6 +16955,7 @@ type UIMessageChunk<METADATA = unknown, DATA_TYPES extends UIDataTypes = UIDataT
   providerMetadata?: ProviderMetadata;
 } | {
   type: 'text-end';
+  citations?: Array<Citation>;
   id: string;
   providerMetadata?: ProviderMetadata;
 } | {
@@ -16746,6 +17039,8 @@ type UIMessageChunk<METADATA = unknown, DATA_TYPES extends UIDataTypes = UIDataT
   type: 'tool-input-start';
   toolCallId: string;
   toolName: string;
+  /** Encoding of the input deltas. Defaults to JSON when omitted. */
+  inputEncoding?: 'json' | 'text';
   providerExecuted?: boolean;
   providerMetadata?: ProviderMetadata;
   toolMetadata?: JSONObject$2;
@@ -16865,28 +17160,59 @@ type UIMessageStreamOnEndCallback<UI_MESSAGE extends UIMessage> = (event: {
   finishReason?: FinishReason;
 }) => PromiseLike<void> | void;
 //#endregion
-//#region src/ui-message-stream/ui-message-stream-response-init.d.ts
+//#region src/ui-message-stream/ui-message-stream-on-step-end-callback.d.ts
 /**
- * Options for creating a UI message stream response.
- * Extends the standard `ResponseInit` with additional streaming options.
+ * Callback that is called when a step ends during streaming.
+ * This is useful for persisting intermediate UI messages during multi-step agent runs.
  */
-type UIMessageStreamResponseInit = ResponseInit & {
+type UIMessageStreamOnStepEndCallback<UI_MESSAGE extends UIMessage> = (event: {
   /**
-   * Optional interval in milliseconds for sending SSE keep-alive comments.
-   * When set, an opening comment is sent immediately and additional comments
-   * are sent after the stream has been idle for the configured interval.
+   * The updated list of UI messages at the end of this step.
    */
-  keepAliveMs?: number;
+  messages: UI_MESSAGE[];
   /**
-   * Optional callback to consume a copy of the SSE stream independently.
-   * This is useful for logging, debugging, or processing the stream in parallel.
-   * The callback receives a tee'd copy of the stream and does not block the response.
+   * Indicates whether the response message is a continuation of the last original message,
+   * or if a new message was created.
    */
-  consumeSseStream?: (options: {
-    stream: ReadableStream<string>;
-  }) => PromiseLike<void> | void;
-};
-//#endregion
+  isContinuation: boolean;
+  /**
+   * The message that was sent to the client as a response
+   * (including the original message if it was extended).
+   */
+  responseMessage: UI_MESSAGE;
+}) => PromiseLike<void> | void;
+//#endregion
+//#region src/ui-message-stream/ui-message-stream-on-step-finish-callback.d.ts
+/**
+ * Callback that is called when a step finishes during streaming.
+ * This is useful for persisting intermediate UI messages during multi-step agent runs.
+ *
+ * @deprecated Use `UIMessageStreamOnStepEndCallback` instead.
+ */
+type UIMessageStreamOnStepFinishCallback<UI_MESSAGE extends UIMessage> = UIMessageStreamOnStepEndCallback<UI_MESSAGE>;
+//#endregion
+//#region src/ui-message-stream/ui-message-stream-response-init.d.ts
+/**
+ * Options for creating a UI message stream response.
+ * Extends the standard `ResponseInit` with additional streaming options.
+ */
+type UIMessageStreamResponseInit = ResponseInit & {
+  /**
+   * Optional interval in milliseconds for sending SSE keep-alive comments.
+   * When set, an opening comment is sent immediately and additional comments
+   * are sent after the stream has been idle for the configured interval.
+   */
+  keepAliveMs?: number;
+  /**
+   * Optional callback to consume a copy of the SSE stream independently.
+   * This is useful for logging, debugging, or processing the stream in parallel.
+   * The callback receives a tee'd copy of the stream and does not block the response.
+   */
+  consumeSseStream?: (options: {
+    stream: ReadableStream<string>;
+  }) => PromiseLike<void> | void;
+};
+//#endregion
 //#region src/util/async-iterable-stream.d.ts
 /**
  * A type that combines AsyncIterable and ReadableStream.
@@ -16897,11 +17223,25 @@ 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).
  */
-type StaticToolOutputDenied<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]: {
+type StaticToolOutputDenied<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]-?: {
   type: 'tool-output-denied';
   toolCallId: string;
   toolName: NAME & string;
@@ -16927,6 +17267,13 @@ type UIMessageStreamOptions<UI_MESSAGE extends UIMessage> = {
    * the original messages are provided and the last message is an assistant message).
    */
   generateMessageId?: IdGenerator;
+  /**
+   * Called after each step is converted to UI message parts.
+   * Receives the accumulated UI message for inspection or persistence.
+   */
+  onStepEnd?: UIMessageStreamOnStepEndCallback<UI_MESSAGE>;
+  /** @deprecated Use `onStepEnd` instead. */
+  onStepFinish?: UIMessageStreamOnStepFinishCallback<UI_MESSAGE>;
   onEnd?: UIMessageStreamOnEndCallback<UI_MESSAGE>;
   /**
    * @deprecated Use `onEnd` instead.
@@ -17254,6 +17601,7 @@ type TextStreamTextStartPart = {
 };
 type TextStreamTextEndPart = {
   type: 'text-end';
+  citations?: Array<Citation>;
   id: string;
   providerMetadata?: ProviderMetadata;
 };
@@ -17282,6 +17630,8 @@ type TextStreamToolInputStartPart = {
   type: 'tool-input-start';
   id: string;
   toolName: string;
+  /** Encoding of the input deltas. Defaults to JSON when omitted. */
+  inputEncoding?: 'json' | 'text';
   providerMetadata?: ProviderMetadata;
   toolMetadata?: JSONObject$2;
   providerExecuted?: boolean;
@@ -17363,6 +17713,301 @@ type TextStreamRawPart = {
 };
 type TextStreamPart<TOOLS extends ToolSet> = 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, RUNTIME_CONTEXT extends Context$1, 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> = 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.experimental_steeringMessages - The steering messages that were added to `messages` for the current step.
+ * @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, RUNTIME_CONTEXT extends Context$1 = Context$1> = (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>;
+  /**
+   * The initial messages that were passed into generateText or streamText.
+   */
+  initialMessages: Array<ModelMessage>;
+  /**
+   * The response messages that have been accumulated from all previous steps.
+   */
+  responseMessages: Array<ResponseMessage>;
+  /**
+   * The user messages that were sent with `experimental_steering` and added to
+   * `messages` for the current step. Undefined when the step received no
+   * steering messages. `messages` already contains them. If you return a
+   * `messages` override that is rebuilt from other fields, e.g.
+   * `initialMessages` and `responseMessages`, add them back together with the
+   * steering messages of previous steps from `steps`.
+   */
+  experimental_steeringMessages?: Array<UserModelMessage>;
+  /**
+   * Tool context.
+   */
+  toolsContext: InferToolSetContext<TOOLS>;
+  /**
+   * User-defined runtime context.
+   */
+  runtimeContext: RUNTIME_CONTEXT;
+  /**
+   * The sandbox environment that the step is operating in.
+   */
+  experimental_sandbox?: SandboxSession;
+}) => 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, RUNTIME_CONTEXT extends Context$1 = Context$1> = ({
+  /**
+   * 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>;
+  /**
+   * 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?: SandboxSession;
+  /**
+   * 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/steering.d.ts
+/**
+ * Why a steering message was not delivered:
+ *
+ * - `finished`: the run ended before the message could be delivered.
+ * - `removed-by-prepare-step`: `prepareStep` returned messages without it.
+ * - `stop-condition`: a stop condition ended the run.
+ * - `waiting-for-tool-results`: the run ended to wait for tool results,
+ *   e.g. a tool approval or a tool without an `execute` function.
+ * - `aborted`: the run was aborted.
+ * - `error`: the run failed.
+ */
+type SteeringNotDeliveredReason = 'finished' | 'removed-by-prepare-step' | 'stop-condition' | 'waiting-for-tool-results' | 'aborted' | 'error';
+/**
+ * The outcome of a steering message.
+ */
+type SteeringOutcome = {
+  readonly type: 'delivered';
+  /** The id of the steering message. */
+  readonly id: string;
+  /** The user message that was added to the run. */
+  readonly message: UserModelMessage;
+  /** The number of the step whose model call received the message. */
+  readonly stepNumber: number;
+} | {
+  readonly type: 'not-delivered';
+  /** The id of the steering message. */
+  readonly id: string;
+  /** The user message that was not added to the run. */
+  readonly message: UserModelMessage;
+  /** Why the message was not delivered. */
+  readonly reason: SteeringNotDeliveredReason;
+};
+/**
+ * Sends user messages to a running generation. Pass it to `generateText`,
+ * `streamText`, or an agent call with the `experimental_steering` option.
+ */
+interface Steering {
+  /**
+   * Adds a user message to the run at the next step boundary, after the
+   * current step and its tool calls are done. If the run would end because the
+   * model finished its answer, it continues for another step unless a stop
+   * condition is met.
+   *
+   * Messages that are sent before the run starts are delivered in the first
+   * step. A steering object can only be used for one generation.
+   *
+   * @param message - The user message, or its text.
+   * @param options.id - The id of the message. Sending a message again with
+   * the same id returns the outcome of the first message.
+   *
+   * @returns The outcome of the message. It never rejects.
+   */
+  steer(message: string | UserModelMessage, options?: {
+    id?: string;
+  }): Promise<SteeringOutcome>;
+}
+/**
+ * The run side of a steering object.
+ */
+type SteeringRun = {
+  hasPendingMessages(): boolean;
+  /**
+   * Takes the waiting messages for the next step. They are resolved by
+   * `resolveTakenMessages` once the prompt of the step is known.
+   */
+  takeMessages(): Array<UserModelMessage>;
+  /**
+   * Resolves the taken messages as delivered when they are part of the
+   * messages that are sent to the model, and returns the delivered messages.
+   */
+  resolveTakenMessages(options: {
+    stepNumber: number;
+    sentMessages: ReadonlyArray<ModelMessage>;
+  }): Array<UserModelMessage>;
+  end(reason: SteeringNotDeliveredReason): void;
+};
+/**
+ * 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.');
+ * ```
+ */
+declare function createSteering(): Steering;
+//#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, RUNTIME_CONTEXT extends Context$1 = Context$1> = (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.
+ */
+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.
+ */
+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.
+ */
+declare function hasToolCall<TOOLS extends ToolSet>(...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:
@@ -17509,7 +18154,7 @@ type ToolCallRepairFunction<TOOLS extends ToolSet> = (options: {
   tools: TOOLS;
   inputSchema: (options: {
     toolName: string;
-  }) => PromiseLike<JSONSchema7$1>;
+  }) => PromiseLike<JSONSchema7$2>;
   error: NoSuchToolError | InvalidToolInputError;
   abortSignal?: AbortSignal;
 }) => Promise<LanguageModelV4ToolCall | null>;
@@ -17538,7 +18183,7 @@ type BaseToolExecutionStartFields = {
  * Each union member ties a specific `toolCall.toolName` to that tool's
  * validated `toolContext` type.
  */
-type StaticToolExecutionStartEvent<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]: BaseToolExecutionStartFields & {
+type StaticToolExecutionStartEvent<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]-?: BaseToolExecutionStartFields & {
   readonly toolCall: Extract<StaticToolCall<TOOLS>, {
     toolName: NAME;
   }>;
@@ -17584,7 +18229,7 @@ type BaseToolExecutionEndFields = {
  * Each union member preserves the link between `toolCall.toolName`, the
  * corresponding validated `toolContext`, and the tool execution result.
  */
-type StaticToolExecutionEndEvent<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]: BaseToolExecutionEndFields & {
+type StaticToolExecutionEndEvent<TOOLS extends ToolSet> = ValueOf<{ [NAME in keyof TOOLS]-?: BaseToolExecutionEndFields & {
   readonly toolCall: Extract<StaticToolCall<TOOLS>, {
     toolName: NAME;
   }>;
@@ -17678,6 +18323,13 @@ type ToolsContextParameter<TOOLS extends ToolSet> = {
 } & 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.
@@ -17761,6 +18413,7 @@ type StreamTextOnEndCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT ex
  * @param event - The event that is passed to the callback.
  */
 type StreamTextOnAbortCallback<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1> = Callback<GenerateTextAbortEvent<TOOLS, RUNTIME_CONTEXT>>;
+type StreamTextOptions<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1, OUTPUT extends Output> = Parameters<typeof streamTextInternal<TOOLS, RUNTIME_CONTEXT, OUTPUT>>[0];
 /**
  * Generate a text and call tools for a given prompt using a language model.
  *
@@ -17769,6 +18422,7 @@ type StreamTextOnAbortCallback<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Co
  * @param model - The language model to use.
  * @param tools - Tools that are accessible to and can be called by the model. The model needs to support calling tools.
  * @param toolOrder - Controls the order in which tools are sent to the provider. Tools not listed are appended alphabetically.
+ * @param toolCallConcurrency - Maximum number of tool calls that may execute concurrently within a step. Set to 1 for sequential execution. Default: unlimited.
  *
  * @param system - A system message that will be part of the prompt.
  * @param prompt - A simple text prompt. You can either use `prompt` or `messages` but not both.
@@ -17803,6 +18457,7 @@ type StreamTextOnAbortCallback<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Co
  * @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.
  *
@@ -17821,6 +18476,7 @@ type StreamTextOnAbortCallback<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Co
  * @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`.
@@ -17828,7 +18484,13 @@ type StreamTextOnAbortCallback<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Co
  * @returns
  * A result object for accessing different stream types and additional information.
  */
-declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, 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, 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> & {
+declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output<string, string, never>>(options: StreamTextOptions<TOOLS, RUNTIME_CONTEXT, OUTPUT>): StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+/**
+ * Stream text with a single consumer, without replay or final-content getters.
+ * Accepts the same options as streamText and uses the same execution engine.
+ */
+declare function streamTextLowMemory<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output<string, string, never>>(options: StreamTextOptions<TOOLS, RUNTIME_CONTEXT, OUTPUT>): StreamTextSingleConsumerResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+declare function streamTextInternal<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, 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, 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, _internal: { now, generateId, generateCallId, retention }, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
   /**
    * The language model to use.
    */
@@ -17864,6 +18526,12 @@ declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Conte
    * The sandbox environment that is passed through to tool execution.
    */
   experimental_sandbox?: SandboxSession;
+  /**
+   * A steering object created with `experimental_createSteering()`.
+   * Messages sent with it are added to the generation at the next step
+   * boundary.
+   */
+  experimental_steering?: Steering;
   /**
    * Runtime context. Treat runtime context as immutable.
    * If you need to mutate runtime context, update it in `prepareStep`.
@@ -17882,6 +18550,13 @@ declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Conte
    * caching by keeping tool definitions in a stable order.
    */
   toolOrder?: ToolOrder<NoInfer<TOOLS>>;
+  /**
+   * Maximum number of tool calls that may execute concurrently within a step.
+   *
+   * Set to `1` to execute tool calls sequentially in the order they were
+   * generated. By default, all tool calls execute concurrently.
+   */
+  toolCallConcurrency?: number;
   /**
    * Optional specification for parsing structured outputs from the LLM response.
    */
@@ -18006,6 +18681,11 @@ declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Conte
    * Callback that is called when each step (LLM call) ends, including intermediate steps.
    */
   onStepEnd?: GenerateTextOnStepEndCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>;
+  /**
+   * Callback that is called when a step that started fails before it
+   * produces a step result. `onStepEnd` is not called for such a step.
+   */
+  onStepError?: GenerateTextOnStepErrorCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>, NoInfer<OUTPUT>>;
   /**
    * Callback that is called when each step (LLM call) ends, including intermediate steps.
    *
@@ -18099,8 +18779,10 @@ declare function streamText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Conte
     now?: () => number;
     generateId?: IdGenerator;
     generateCallId?: IdGenerator;
+    /** Internal policy used by the streaming-only facade. */
+    retention?: StreamTextRetention;
   };
-}): StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+}, steeringRun: SteeringRun | undefined): StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>;
 type EnrichedStreamPart<TOOLS extends ToolSet, PARTIAL_OUTPUT> = {
   part: TextStreamPart<TOOLS>;
   partialOutput: PARTIAL_OUTPUT | undefined;
@@ -18205,7 +18887,7 @@ declare const array$1: <ELEMENT>({ element: inputElementSchema, minItems, maxIte
 }) => Output<Array<ELEMENT>, Array<ELEMENT>, ELEMENT>;
 /**
  * Output specification for choice generation.
- * When the model generates a text response, it will return a one of the choice options.
+ * When the model generates a text response, it will return one of the choice options.
  *
  * @param options - The available choices.
  * @param name - Optional name of the output that should be generated. Used by some providers for additional LLM guidance, e.g. via tool or schema name.
@@ -18483,15 +19165,42 @@ type GenerateTextOnStepStartCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CO
  * Called when a step (LLM call) completes. The event includes all step result
  * properties (text, tool calls, usage, etc.) along with additional metadata.
  *
- * @param stepResult - The result of the step.
+ * @param stepResult - The result of the step.
+ */
+type GenerateTextOnStepEndCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1> = Callback<GenerateTextStepEndEvent<TOOLS, RUNTIME_CONTEXT>>;
+/**
+ * Callback that is set using the `onStepFinish` option.
+ *
+ * @deprecated Use `GenerateTextOnStepEndCallback` instead.
+ */
+type GenerateTextOnStepFinishCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1> = GenerateTextOnStepEndCallback<TOOLS, RUNTIME_CONTEXT>;
+/**
+ * Event passed to the `onStepError` callback.
+ *
+ * Contains the step start event of the step that failed before it produced
+ * a step result, along with the error.
  */
-type GenerateTextOnStepEndCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1> = Callback<GenerateTextStepEndEvent<TOOLS, RUNTIME_CONTEXT>>;
+type GenerateTextStepErrorEvent<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output> = GenerateTextStepStartEvent<TOOLS, RUNTIME_CONTEXT, OUTPUT> & {
+  /** The error that ended the step. */
+  readonly error: unknown;
+};
 /**
- * Callback that is set using the `onStepFinish` option.
+ * Callback that is set using the `onStepError` option.
  *
- * @deprecated Use `GenerateTextOnStepEndCallback` instead.
+ * Called when a step that started fails before it produces a step result:
+ * when the provider call throws or rejects, or when the model stream ends
+ * without output. `onStepEnd` is not called for such a step. A provider
+ * `error` chunk does not fail the step, it still ends with `onStepEnd` and
+ * `finishReason: 'error'`.
+ *
+ * In `generateText`, an abort or timeout also ends the step here. The error
+ * is the abort or timeout error, or a provider error that has it as its
+ * `cause`. In `streamText`, an abort or timeout ends the step
+ * with `onAbort` instead.
+ *
+ * @param event - The step that failed and the error.
  */
-type GenerateTextOnStepFinishCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1> = GenerateTextOnStepEndCallback<TOOLS, RUNTIME_CONTEXT>;
+type GenerateTextOnStepErrorCallback<TOOLS extends ToolSet = ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output> = Callback<GenerateTextStepErrorEvent<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
 /**
  * Callback that is set using the `onEnd` option.
  *
@@ -18782,7 +19491,13 @@ type TelemetryTracingChannelMessage<EVENT = unknown> = {
 };
 //#endregion
 //#region src/telemetry/telemetry.d.ts
-type InferTelemetryEvent<EVENT> = EVENT & Omit<TelemetryOptions, 'integrations' | 'isEnabled' | 'includeRuntimeContext'>;
+type InferTelemetryEvent<EVENT> = EVENT & Omit<TelemetryOptions, 'integrations' | 'isEnabled' | 'includeRuntimeContext'> & {
+  /**
+   * The version of the `ai` package that emitted this event.
+   * Absent in older releases.
+   */
+  readonly aiVersion?: string;
+};
 type BivariantCallback<EVENT> = {
   bivarianceHack(event: EVENT): PromiseLike<void> | void;
 }['bivarianceHack'];
@@ -18849,6 +19564,11 @@ interface Telemetry {
    * @deprecated Use `onStepEnd` instead.
    */
   onStepFinish?: Callback<InferTelemetryEvent<GenerateTextStepEndEvent>>;
+  /**
+   * Called when a step that started fails before it produces a step result.
+   * Use it to close step-level spans. The call then ends with `onError`.
+   */
+  onStepError?: Callback<InferTelemetryEvent<GenerateTextStepErrorEvent>>;
   /**
    * Called when an object generation step (single LLM invocation) begins.
    * For generateObject/streamObject there is always exactly one step.
@@ -18962,7 +19682,15 @@ interface Telemetry {
 }
 //#endregion
 //#region src/global.d.ts
+declare const aiSdkGlobalsKey: unique symbol;
 declare global {
+  interface AISDKGlobalTypes {
+    [aiSdkGlobalsKey]: {
+      provider: ProviderV4 | ProviderV3 | ProviderV2;
+      logWarnings: LogWarningsFunction;
+      telemetry: Telemetry;
+    };
+  }
   /**
    * The default provider to use for the AI SDK.
    * String model ids are resolved to the default provider and model id.
@@ -18972,7 +19700,7 @@ declare global {
    *
    * @see https://ai-sdk.dev/docs/ai-sdk-core/provider-management#global-provider-configuration
    */
-  var AI_SDK_DEFAULT_PROVIDER: ProviderV4 | ProviderV3 | ProviderV2 | undefined;
+  var AI_SDK_DEFAULT_PROVIDER: AISDKGlobalTypes[keyof AISDKGlobalTypes]['provider'] | undefined;
   /**
    * The warning logger to use for the AI SDK.
    *
@@ -18981,7 +19709,7 @@ declare global {
    *
    * If set to false, no warnings are logged.
    */
-  var AI_SDK_LOG_WARNINGS: LogWarningsFunction | undefined | false;
+  var AI_SDK_LOG_WARNINGS: AISDKGlobalTypes[keyof AISDKGlobalTypes]['logWarnings'] | undefined | false;
   /**
    * Globally registered telemetry integrations for the AI SDK.
    *
@@ -18991,7 +19719,7 @@ declare global {
    * Prefer using `registerTelemetry()` from `'ai'` instead of
    * assigning this directly.
    */
-  var AI_SDK_TELEMETRY_INTEGRATIONS: Telemetry[] | undefined;
+  var AI_SDK_TELEMETRY_INTEGRATIONS: Array<AISDKGlobalTypes[keyof AISDKGlobalTypes]['telemetry']> | undefined;
 }
 //#endregion
 //#region src/generate-text/generate-text-result.d.ts
@@ -19310,6 +20038,7 @@ type GenerateTextInclude = {
  * @param tools - Tools that are accessible to and can be called by the model. The model needs to support calling tools.
  * @param toolChoice - The tool choice strategy. Default: 'auto'.
  * @param toolOrder - Controls the order in which tools are sent to the provider. Tools not listed are appended alphabetically.
+ * @param toolCallConcurrency - Maximum number of tool calls that may execute concurrently within a step. Set to 1 for sequential execution. Default: unlimited.
  *
  * @param system - A system message that will be part of the prompt.
  * @param prompt - A simple text prompt. You can either use `prompt` or `messages` but not both.
@@ -19343,6 +20072,7 @@ type GenerateTextInclude = {
  * @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.
@@ -19361,13 +20091,16 @@ type GenerateTextInclude = {
  * 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.
  */
-declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output<string, string>>({ model: modelArg, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries: maxRetriesArg, abortSignal, timeout, headers, stopWhen, experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry, providerOptions, activeTools, toolOrder, prepareStep, experimental_repairToolCall, repairToolCall, experimental_refineToolInput: refineToolInput, experimental_download: download, runtimeContext, toolsContext, experimental_include, include, _internal: { generateId, generateCallId, now }, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onLanguageModelCallStart, experimental_onLanguageModelCallStart, onLanguageModelCallEnd, experimental_onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, experimental_onToolCallStart, experimental_onToolCallFinish, onStepEnd, onStepFinish, onFinish, onEnd, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
+declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output<string, string>>(options: GenerateTextOptions<TOOLS, RUNTIME_CONTEXT, OUTPUT>): Promise<GenerateTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
+type GenerateTextOptions<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1, OUTPUT extends Output> = Parameters<typeof generateTextInternal<TOOLS, RUNTIME_CONTEXT, OUTPUT>>[0];
+declare function generateTextInternal<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = Output<string, string>>({ model: modelArg, tools, toolChoice, instructions, system, prompt, messages, allowSystemInMessages, maxRetries: maxRetriesArg, abortSignal, timeout, headers, stopWhen, experimental_sandbox: sandbox, output, toolApproval, experimental_toolCallers, experimental_toolApprovalSecret, experimental_telemetry, telemetry, providerOptions, activeTools, toolOrder, toolCallConcurrency, prepareStep, experimental_repairToolCall, repairToolCall, experimental_refineToolInput: refineToolInput, experimental_download: download, runtimeContext, toolsContext, experimental_include, include, _internal: { generateId, generateCallId, now }, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onLanguageModelCallStart, experimental_onLanguageModelCallStart, onLanguageModelCallEnd, experimental_onLanguageModelCallEnd, onToolExecutionStart, onToolExecutionEnd, experimental_onToolCallStart, experimental_onToolCallFinish, onStepEnd, onStepError, onStepFinish, onFinish, onEnd, ...settings }: LanguageModelCallOptions & RequestOptions<TOOLS> & Prompt & ToolsContextParameter<TOOLS> & {
   /**
    * The language model to use.
    */
@@ -19403,6 +20136,12 @@ declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Con
    * The sandbox environment that is passed through to tool execution.
    */
   experimental_sandbox?: SandboxSession;
+  /**
+   * A steering object created with `experimental_createSteering()`.
+   * Messages sent with it are added to the generation at the next step
+   * boundary.
+   */
+  experimental_steering?: Steering;
   /**
    * Runtime context. Treat runtime context as immutable.
    * If you need to mutate runtime context, update it in `prepareStep`.
@@ -19421,6 +20160,13 @@ declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Con
    * caching by keeping tool definitions in a stable order.
    */
   toolOrder?: ToolOrder<NoInfer<TOOLS>>;
+  /**
+   * Maximum number of tool calls that may execute concurrently within a step.
+   *
+   * Set to `1` to execute tool calls sequentially in the order they were
+   * generated. By default, all tool calls execute concurrently.
+   */
+  toolCallConcurrency?: number;
   /**
    * Optional specification for parsing structured outputs from the LLM response.
    */
@@ -19538,6 +20284,11 @@ declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Con
    * Callback that is called when each step (LLM call) ends, including intermediate steps.
    */
   onStepEnd?: GenerateTextOnStepEndCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>;
+  /**
+   * Callback that is called when a step that started fails before it
+   * produces a step result. `onStepEnd` is not called for such a step.
+   */
+  onStepError?: GenerateTextOnStepErrorCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>, NoInfer<OUTPUT>>;
   /**
    * Callback that is called when each step (LLM call) ends, including intermediate steps.
    *
@@ -19577,7 +20328,7 @@ declare function generateText<TOOLS extends ToolSet, RUNTIME_CONTEXT extends Con
     generateCallId?: IdGenerator;
     now?: () => number;
   };
-}): Promise<GenerateTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
+}, steeringRun: SteeringRun | undefined): Promise<GenerateTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
 //#endregion
 //#region src/agent/tool-loop-agent-settings.d.ts
 /**
@@ -19641,6 +20392,13 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
    * caching by keeping tool definitions in a stable order.
    */
   toolOrder?: ToolOrder<NoInfer<TOOLS>>;
+  /**
+   * Maximum number of tool calls that may execute concurrently within a step.
+   *
+   * Set to `1` to execute tool calls sequentially in the order they were
+   * generated. By default, all tool calls execute concurrently.
+   */
+  toolCallConcurrency?: number;
   /**
    * Optional specification for generating structured outputs.
    */
@@ -19728,6 +20486,27 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
    * Callback that is called when each step (LLM call) ends, including intermediate steps.
    */
   onStepEnd?: GenerateTextOnStepEndCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>;
+  /**
+   * Callback that is called when a step that started fails before it
+   * produces a step result. `onStepEnd` is not called for such a step.
+   *
+   * Unlike `onStepStart` and `onStepEnd`, it can only be set here and not
+   * per call, because the per-call callbacks are shared with other `Agent`
+   * implementations that do not report step errors.
+   */
+  onStepError?: GenerateTextOnStepErrorCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>, NoInfer<OUTPUT>>;
+  /**
+   * Callback that is called when an error occurs. For `stream()` it receives
+   * the errors of the stream, for `generate()` it receives the error before
+   * it is thrown. Aborts and timeouts are not reported.
+   */
+  onError?: StreamTextOnErrorCallback;
+  /**
+   * Callback that is called when `stream()` is aborted or times out.
+   * `generate()` does not call it: an aborted or timed out `generate()` call
+   * rejects, and its step ends with `onStepError`.
+   */
+  onAbort?: StreamTextOnAbortCallback<NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>;
   /**
    * Callback that is called when each step (LLM call) ends, including intermediate steps.
    *
@@ -19791,14 +20570,24 @@ type ToolLoopAgentSettings<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUN
    *   }),
    * ```
    */
-  prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>, 'abortSignal' | 'timeout' | 'onStart' | 'experimental_onStart' | 'onStepStart' | 'experimental_onStepStart' | 'onToolExecutionStart' | 'onToolExecutionEnd' | 'onStepEnd' | 'onStepFinish' | 'onEnd' | 'onFinish'> & Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'toolChoice' | 'maxRetries' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolApproval' | 'experimental_toolCallers' | 'experimental_toolApprovalSecret' | 'prepareStep' | 'repairToolCall' | 'experimental_repairToolCall' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & {
+  prepareCall?: (options: Omit<AgentCallParameters<CALL_OPTIONS, NoInfer<TOOLS>, NoInfer<RUNTIME_CONTEXT>>, 'abortSignal' | 'timeout' | 'onStart' | 'experimental_onStart' | 'onStepStart' | 'experimental_onStepStart' | 'onToolExecutionStart' | 'onToolExecutionEnd' | 'onStepEnd' | 'onStepFinish' | 'onEnd' | 'onFinish'> & Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'toolChoice' | 'maxRetries' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolCallConcurrency' | 'toolApproval' | 'experimental_toolCallers' | 'experimental_toolApprovalSecret' | 'prepareStep' | 'repairToolCall' | 'experimental_repairToolCall' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & {
     toolsContext: InferToolSetContext<TOOLS>;
-  }) => MaybePromiseLike<Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'toolChoice' | 'maxRetries' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolApproval' | 'experimental_toolCallers' | 'experimental_toolApprovalSecret' | 'prepareStep' | 'repairToolCall' | 'experimental_repairToolCall' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & Omit<Prompt, 'system'> & {
+  }) => MaybePromiseLike<Pick<ToolLoopAgentSettings<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, NoInfer<OUTPUT>>, 'model' | 'tools' | 'toolChoice' | 'maxRetries' | 'maxOutputTokens' | 'temperature' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'stopSequences' | 'seed' | 'reasoning' | 'headers' | 'instructions' | 'allowSystemInMessages' | 'stopWhen' | 'telemetry' | 'experimental_telemetry' | 'activeTools' | 'toolOrder' | 'toolCallConcurrency' | 'toolApproval' | 'experimental_toolCallers' | 'experimental_toolApprovalSecret' | 'prepareStep' | 'repairToolCall' | 'experimental_repairToolCall' | 'providerOptions' | 'experimental_download' | 'experimental_refineToolInput' | 'include' | 'runtimeContext' | '_internal'> & Omit<Prompt, 'system'> & {
     toolsContext: InferToolSetContext<TOOLS>;
   }>;
 };
 //#endregion
 //#region src/agent/tool-loop-agent.d.ts
+/**
+ * Call parameters that only `ToolLoopAgent` supports.
+ */
+interface ToolLoopAgentCallExtensions {
+  /**
+   * A steering object created with `experimental_createSteering()`.
+   * Messages sent with it are added to the run at the next step boundary.
+   */
+  experimental_steering?: Steering;
+}
 /**
  * A tool loop agent is an agent that runs tools in a loop. In each step,
  * it calls the LLM, and if there are tool calls, it executes the tools
@@ -19832,11 +20621,11 @@ declare class ToolLoopAgent<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RU
   /**
    * Generates an output from the agent (non-streaming).
    */
-  generate({ abortSignal, timeout, experimental_sandbox: sandbox, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd, ...options }: AgentCallParameters<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT>): Promise<GenerateTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
+  generate({ abortSignal, timeout, experimental_sandbox: sandbox, experimental_steering: steering, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd, ...options }: AgentCallParameters<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT> & ToolLoopAgentCallExtensions): Promise<GenerateTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
   /**
    * Streams an output from the agent (streaming).
    */
-  stream({ abortSignal, timeout, experimental_sandbox: sandbox, experimental_transform, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd, ...options }: AgentStreamParameters<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT>): Promise<StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
+  stream({ abortSignal, timeout, experimental_sandbox: sandbox, experimental_steering: steering, experimental_transform, onStart, experimental_onStart, onStepStart, experimental_onStepStart, onToolExecutionStart, onToolExecutionEnd, onStepEnd, onStepFinish, onFinish, onEnd, ...options }: AgentStreamParameters<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT> & ToolLoopAgentCallExtensions): Promise<StreamTextResult<TOOLS, RUNTIME_CONTEXT, OUTPUT>>;
 }
 //#endregion
 //#region src/agent/infer-agent-tools.d.ts
@@ -19869,77 +20658,6 @@ declare function convertToModelMessages<UI_MESSAGE extends UIMessage>(messages:
   convertDataPart?: (part: DataUIPart<InferUIMessageData<UI_MESSAGE>>) => TextPart | FilePart | undefined;
 }): Promise<ModelMessage[]>;
 //#endregion
-//#region src/agent/create-agent-ui-stream-response.d.ts
-/**
- * Runs the agent and returns a response object with a UI message stream.
- *
- * @param agent - The agent to run.
- * @param uiMessages - The input UI messages.
- * @param convertDataPart - Optional function to convert custom data parts to text or file model message parts.
- * @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 options - The options for the agent. Optional.
- * @param experimental_transform - Stream transformations. Optional.
- * @param onStepEnd - Callback that is called when each step ends. Optional.
- * @param onStepFinish - Deprecated alias for `onStepEnd`. Optional.
- * @param headers - Additional headers for the response. Optional.
- * @param status - The status code for the response. Optional.
- * @param statusText - The status text for the response. Optional.
- * @param keepAliveMs - Optional interval for sending SSE keep-alive comments.
- * @param consumeSseStream - Whether to consume the SSE stream. Optional.
- *
- * @returns The response object.
- */
-declare function createAgentUIStreamResponse<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = never, MESSAGE_METADATA = unknown, UI_MESSAGE extends UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>> = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>>({ headers, status, statusText, keepAliveMs, consumeSseStream, ...options }: {
-  agent: Agent$1<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
-  uiMessages: unknown[];
-  /**
-   * Converts custom UI data parts to text or file model message parts.
-   * Data parts are ignored when omitted or when the callback returns undefined.
-   */
-  convertDataPart?: NonNullable<Parameters<typeof convertToModelMessages<UI_MESSAGE>>[1]>['convertDataPart'];
-  abortSignal?: AbortSignal;
-  timeout?: TimeoutConfiguration<TOOLS>;
-  experimental_sandbox?: SandboxSession;
-  options?: CALL_OPTIONS;
-  experimental_transform?: Arrayable<StreamTextTransform<TOOLS>>;
-  onStepEnd?: GenerateTextOnStepEndCallback<TOOLS>;
-  /** @deprecated Use `onStepEnd` instead. */
-  onStepFinish?: GenerateTextOnStepFinishCallback<TOOLS>;
-} & UIMessageStreamResponseInit & UIMessageStreamOptions<UI_MESSAGE>): Promise<Response>;
-//#endregion
-//#region src/ui-message-stream/ui-message-stream-on-step-end-callback.d.ts
-/**
- * Callback that is called when a step ends during streaming.
- * This is useful for persisting intermediate UI messages during multi-step agent runs.
- */
-type UIMessageStreamOnStepEndCallback<UI_MESSAGE extends UIMessage> = (event: {
-  /**
-   * The updated list of UI messages at the end of this step.
-   */
-  messages: UI_MESSAGE[];
-  /**
-   * Indicates whether the response message is a continuation of the last original message,
-   * or if a new message was created.
-   */
-  isContinuation: boolean;
-  /**
-   * The message that was sent to the client as a response
-   * (including the original message if it was extended).
-   */
-  responseMessage: UI_MESSAGE;
-}) => PromiseLike<void> | void;
-//#endregion
-//#region src/ui-message-stream/ui-message-stream-on-step-finish-callback.d.ts
-/**
- * Callback that is called when a step finishes during streaming.
- * This is useful for persisting intermediate UI messages during multi-step agent runs.
- *
- * @deprecated Use `UIMessageStreamOnStepEndCallback` instead.
- */
-type UIMessageStreamOnStepFinishCallback<UI_MESSAGE extends UIMessage> = UIMessageStreamOnStepEndCallback<UI_MESSAGE>;
-//#endregion
 //#region src/ui/call-completion-api.d.ts
 declare const getOriginalFetch: () => typeof fetch;
 declare function callCompletionApi({ api, prompt, credentials, headers, body, streamProtocol, setCompletion, setLoading, setError, setAbortController, getAbortController, onFinish, onError, fetch }: {
@@ -19971,6 +20689,20 @@ declare function callCompletionApi({ api, prompt, credentials, headers, body, st
  * @template UI_MESSAGE - The UI message type extending UIMessage
  */
 interface ChatTransport<UI_MESSAGE extends UIMessage> {
+  /**
+   * Whether reconnecting returns the complete response from its beginning.
+   * Complete replays must reset the streaming message state before processing
+   * the first start chunk.
+   */
+  readonly resumeStreamIsReplay?: boolean;
+  /**
+   * Releases persistent resources owned by the transport.
+   *
+   * The caller that creates a transport owns its lifecycle and should call
+   * this method when no consumers remain. `AbstractChat.dispose()` calls it
+   * for directly managed chat instances.
+   */
+  close?: () => void;
   /**
    * Sends messages to the chat API endpoint and returns a streaming response.
    *
@@ -20137,7 +20869,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<UI_MESSAGE['metadata']>;
@@ -20180,7 +20912,8 @@ interface ChatInit<UI_MESSAGE extends UIMessage> {
   }) => boolean | PromiseLike<boolean>;
 }
 declare abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
-  readonly id: string;
+  private _id;
+  get id(): string;
   readonly generateId: IdGenerator;
   protected state: ChatState<UI_MESSAGE>;
   private messageMetadataSchema;
@@ -20193,10 +20926,13 @@ declare abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
   private sendAutomaticallyWhen?;
   private pendingMessagePreparations;
   private pendingApprovalMessageId;
+  private interruptedMessageIds;
   private activeResponse;
   private activeResumeRequest;
   private resumableStreamState;
   private jobExecutor;
+  private activeStopCount;
+  private stopGeneration;
   constructor({ generateId, id, transport, messageMetadataSchema, dataPartSchemas, state, onError, onToolCall, onFinish, onData, sendAutomaticallyWhen }: Omit<ChatInit<UI_MESSAGE>, 'messages'> & {
     state: ChatState<UI_MESSAGE>;
   });
@@ -20259,12 +20995,19 @@ declare abstract class AbstractChat<UI_MESSAGE extends UIMessage> {
   /** @deprecated Use addToolOutput */
   addToolResult: ChatAddToolOutputFunction<UI_MESSAGE>;
   /**
-   * Abort the current request immediately, keep the generated tokens if any.
+   * Abort the current request, keep the generated tokens if any, and wait for
+   * the request pipeline to finish.
    */
   stop: () => Promise<void>;
+  /**
+   * Stops active work and releases resources owned by the chat transport.
+   */
+  dispose: () => Promise<void>;
   private shouldSendAutomatically;
+  private runAutomaticRequest;
   private makeRequestForToolApproval;
   private makeRequest;
+  private makeRequestImpl;
 }
 //#endregion
 //#region src/ui/convert-file-list-to-file-ui-parts.d.ts
@@ -20377,83 +21120,273 @@ declare abstract class HttpChatTransport<UI_MESSAGE extends UIMessage> implement
 //#endregion
 //#region src/ui/default-chat-transport.d.ts
 declare class DefaultChatTransport<UI_MESSAGE extends UIMessage> extends HttpChatTransport<UI_MESSAGE> {
-  constructor(options?: HttpChatTransportInitOptions<UI_MESSAGE>);
+  readonly resumeStreamIsReplay: boolean;
+  constructor({ resumeStreamIsReplay, ...options }?: HttpChatTransportInitOptions<UI_MESSAGE> & {
+    /**
+     * Whether resumed streams replay the response from the beginning.
+     * Defaults to true. Set to false for endpoints that only continue the
+     * interrupted response, even when they emit a start chunk.
+     */
+    resumeStreamIsReplay?: boolean;
+  });
   protected processResponseStream(stream: ReadableStream<Uint8Array<ArrayBufferLike>>): ReadableStream<UIMessageChunk>;
 }
 //#endregion
 //#region src/ui/direct-chat-transport.d.ts
 /**
- * Options for the `DirectChatTransport` class.
+ * Options for the `DirectChatTransport` class.
+ */
+type DirectChatTransportOptions<CALL_OPTIONS, TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1, OUTPUT extends Output, UI_MESSAGE extends UIMessage<unknown, never, InferUITools<TOOLS>>> = {
+  /**
+   * The agent to use for generating responses.
+   */
+  agent: Agent$1<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+  /**
+   * Options to pass to the agent when calling it.
+   */
+  options?: CALL_OPTIONS;
+} & Omit<UIMessageStreamOptions<UI_MESSAGE>, 'onFinish'>;
+/**
+ * A transport that directly communicates with an Agent in-process,
+ * without going through HTTP. This is useful for:
+ * - Server-side rendering scenarios
+ * - Testing without network
+ * - Single-process applications
+ *
+ * @example
+ * ```tsx
+ * import { useChat } from '@ai-sdk/react';
+ * import { DirectChatTransport } from 'ai';
+ * import { myAgent } from './my-agent';
+ *
+ * const { messages, sendMessage } = useChat({
+ *   transport: new DirectChatTransport({ agent: myAgent }),
+ * });
+ * ```
+ */
+declare class DirectChatTransport<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = never, UI_MESSAGE extends UIMessage<unknown, never, InferUITools<TOOLS>> = UIMessage<unknown, never, InferUITools<TOOLS>>> implements ChatTransport<UI_MESSAGE> {
+  private readonly agent;
+  private readonly agentOptions;
+  private readonly uiMessageStreamOptions;
+  constructor({ agent, options, ...uiMessageStreamOptions }: DirectChatTransportOptions<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT, UI_MESSAGE>);
+  sendMessages({ messages, abortSignal }: Parameters<ChatTransport<UI_MESSAGE>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+  /**
+   * Direct transport does not support reconnection since there is no
+   * persistent server-side stream to reconnect to.
+   *
+   * @returns Always returns `null`
+   */
+  reconnectToStream(_options: Parameters<ChatTransport<UI_MESSAGE>['reconnectToStream']>[0]): Promise<ReadableStream<UIMessageChunk> | null>;
+}
+//#endregion
+//#region src/ui/last-assistant-message-is-complete-with-approval-responses.d.ts
+/**
+ * Check if the last message is an assistant message with completed tool call approvals.
+ * The last step of the message must have at least one tool approval response and
+ * all tool approvals must have a response.
+ */
+declare function lastAssistantMessageIsCompleteWithApprovalResponses({ messages }: {
+  messages: UIMessage[];
+}): boolean;
+//#endregion
+//#region src/ui/last-assistant-message-is-complete-with-tool-calls.d.ts
+/**
+ * Check if the last message is an assistant message with completed tool calls.
+ * The last step of the message must have at least one tool invocation and
+ * all tool invocations must have a result. Completed model text may follow
+ * the tool invocation because client-side tool results update parts in place,
+ * but trailing text without a completed stream state prevents resubmission.
+ */
+declare function lastAssistantMessageIsCompleteWithToolCalls({ messages }: {
+  messages: UIMessage[];
+}): boolean;
+//#endregion
+//#region src/ui/text-stream-chat-transport.d.ts
+declare class TextStreamChatTransport<UI_MESSAGE extends UIMessage> extends HttpChatTransport<UI_MESSAGE> {
+  constructor(options?: HttpChatTransportInitOptions<UI_MESSAGE>);
+  protected processResponseStream(stream: ReadableStream<Uint8Array<ArrayBufferLike>>): ReadableStream<UIMessageChunk>;
+}
+//#endregion
+//#region src/ui/websocket-chat-transport.d.ts
+type WebSocketChatTransportSendRequest<UI_MESSAGE extends UIMessage = UIMessage> = {
+  type: 'send';
+  requestId: string;
+  id: string;
+  trigger: 'submit-message' | 'regenerate-message';
+  messageId: string | undefined;
+  messages: UI_MESSAGE[];
+  headers: Record<string, string>;
+  body: object;
+  metadata: unknown;
+};
+type WebSocketChatTransportResumeRequest = {
+  type: 'resume';
+  requestId: string;
+  id: string;
+  /** Omitted by this transport to request a complete UI message replay. */
+  lastSequence: number | undefined;
+  headers: Record<string, string>;
+  body: object;
+  metadata: unknown;
+};
+type WebSocketChatTransportAbortRequest = {
+  type: 'abort';
+  requestId: string;
+};
+/**
+ * A client-to-server frame used by `WebSocketChatTransport`.
+ */
+type WebSocketChatTransportRequest<UI_MESSAGE extends UIMessage = UIMessage> = WebSocketChatTransportSendRequest<UI_MESSAGE> | WebSocketChatTransportResumeRequest | WebSocketChatTransportAbortRequest;
+/**
+ * A server-to-client frame used by `WebSocketChatTransport`.
+ */
+type WebSocketChatTransportResponse = {
+  type: 'start';
+  requestId: string;
+} | {
+  type: 'chunk';
+  requestId: string;
+  sequence: number;
+  chunk: UIMessageChunk;
+} | {
+  type: 'end';
+  requestId: string;
+} | {
+  type: 'error';
+  requestId: string;
+  errorText?: string;
+} | {
+  type: 'no-active';
+  requestId: string;
+};
+type SafeValidateWebSocketChatTransportRequestResult<UI_MESSAGE extends UIMessage> = {
+  success: true;
+  data: WebSocketChatTransportRequest<UI_MESSAGE>;
+} | {
+  success: false;
+  error: Error;
+};
+type PrepareWebSocketChatTransportSendMessagesRequest<UI_MESSAGE extends UIMessage> = (options: {
+  id: string;
+  messages: UI_MESSAGE[];
+  requestMetadata: unknown;
+  body: object;
+  headers: Record<string, string>;
+  trigger: 'submit-message' | 'regenerate-message';
+  messageId: string | undefined;
+}) => {
+  messages?: UI_MESSAGE[];
+  body?: object;
+  headers?: HeadersInit;
+} | PromiseLike<{
+  messages?: UI_MESSAGE[];
+  body?: object;
+  headers?: HeadersInit;
+}>;
+type PrepareWebSocketChatTransportReconnectToStreamRequest = (options: {
+  id: string;
+  requestMetadata: unknown;
+  body: object;
+  headers: Record<string, string>;
+}) => {
+  body?: object;
+  headers?: HeadersInit;
+} | PromiseLike<{
+  body?: object;
+  headers?: HeadersInit;
+}>;
+/**
+ * Options for `WebSocketChatTransport`.
  */
-type DirectChatTransportOptions<CALL_OPTIONS, TOOLS extends ToolSet, RUNTIME_CONTEXT extends Context$1, OUTPUT extends Output, UI_MESSAGE extends UIMessage<unknown, never, InferUITools<TOOLS>>> = {
+type WebSocketChatTransportInitOptions<UI_MESSAGE extends UIMessage> = {
   /**
-   * The agent to use for generating responses.
+   * WebSocket endpoint URL. HTTP(S) URLs are converted to WS(S), and relative
+   * URLs are resolved against the current browser location.
    */
-  agent: Agent$1<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+  url: string;
   /**
-   * Options to pass to the agent when calling it.
+   * Optional WebSocket subprotocols used during the connection handshake.
    */
-  options?: CALL_OPTIONS;
-} & Omit<UIMessageStreamOptions<UI_MESSAGE>, 'onFinish'>;
-/**
- * A transport that directly communicates with an Agent in-process,
- * without going through HTTP. This is useful for:
- * - Server-side rendering scenarios
- * - Testing without network
- * - Single-process applications
- *
- * @example
- * ```tsx
- * import { useChat } from '@ai-sdk/react';
- * import { DirectChatTransport } from 'ai';
- * import { myAgent } from './my-agent';
- *
- * const { messages, sendMessage } = useChat({
- *   transport: new DirectChatTransport({ agent: myAgent }),
- * });
- * ```
- */
-declare class DirectChatTransport<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = never, UI_MESSAGE extends UIMessage<unknown, never, InferUITools<TOOLS>> = UIMessage<unknown, never, InferUITools<TOOLS>>> implements ChatTransport<UI_MESSAGE> {
-  private readonly agent;
-  private readonly agentOptions;
-  private readonly uiMessageStreamOptions;
-  constructor({ agent, options, ...uiMessageStreamOptions }: DirectChatTransportOptions<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT, UI_MESSAGE>);
-  sendMessages({ messages, abortSignal }: Parameters<ChatTransport<UI_MESSAGE>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+  protocols?: string | string[];
   /**
-   * Direct transport does not support reconnection since there is no
-   * persistent server-side stream to reconnect to.
+   * Query parameters appended when a new connection is opened.
+   */
+  params?: Resolvable<Record<string, string>>;
+  /**
+   * Headers included in each application-level request frame.
    *
-   * @returns Always returns `null`
+   * Browser WebSocket APIs cannot set handshake headers. Use cookies, query
+   * parameters, or subprotocols for handshake authentication.
    */
-  reconnectToStream(_options: Parameters<ChatTransport<UI_MESSAGE>['reconnectToStream']>[0]): Promise<ReadableStream<UIMessageChunk> | null>;
-}
-//#endregion
-//#region src/ui/last-assistant-message-is-complete-with-approval-responses.d.ts
+  headers?: Resolvable<Record<string, string> | Headers>;
+  /**
+   * Extra application data included in each send and resume request.
+   */
+  body?: Resolvable<object>;
+  /**
+   * Custom WebSocket implementation, for example the `ws` package in Node.js.
+   */
+  webSocket?: WebSocketConstructor;
+  /**
+   * Customizes send request frames before they are transmitted.
+   */
+  prepareSendMessagesRequest?: PrepareWebSocketChatTransportSendMessagesRequest<UI_MESSAGE>;
+  /**
+   * Customizes resume request frames before they are transmitted.
+   */
+  prepareReconnectToStreamRequest?: PrepareWebSocketChatTransportReconnectToStreamRequest;
+};
 /**
- * Check if the last message is an assistant message with completed tool call approvals.
- * The last step of the message must have at least one tool approval response and
- * all tool approvals must have a response.
+ * Validates an untrusted client-to-server WebSocket chat frame.
  */
-declare function lastAssistantMessageIsCompleteWithApprovalResponses({ messages }: {
-  messages: UIMessage[];
-}): boolean;
-//#endregion
-//#region src/ui/last-assistant-message-is-complete-with-tool-calls.d.ts
+declare function safeValidateWebSocketChatTransportRequest<UI_MESSAGE extends UIMessage = UIMessage>({ value }: {
+  value: unknown;
+}): Promise<SafeValidateWebSocketChatTransportRequestResult<UI_MESSAGE>>;
 /**
- * Check if the last message is an assistant message with completed tool calls.
- * The last step of the message must have at least one tool invocation and
- * all tool invocations must have a result. Completed model text may follow
- * the tool invocation because client-side tool results update parts in place,
- * but trailing text without a completed stream state prevents resubmission.
+ * A `ChatTransport` that multiplexes correlated UI message streams over one
+ * persistent WebSocket connection.
+ *
+ * The server must implement the protocol represented by
+ * `WebSocketChatTransportRequest` and `WebSocketChatTransportResponse`.
  */
-declare function lastAssistantMessageIsCompleteWithToolCalls({ messages }: {
-  messages: UIMessage[];
-}): boolean;
-//#endregion
-//#region src/ui/text-stream-chat-transport.d.ts
-declare class TextStreamChatTransport<UI_MESSAGE extends UIMessage> extends HttpChatTransport<UI_MESSAGE> {
-  constructor(options?: HttpChatTransportInitOptions<UI_MESSAGE>);
-  protected processResponseStream(stream: ReadableStream<Uint8Array<ArrayBufferLike>>): ReadableStream<UIMessageChunk>;
+declare class WebSocketChatTransport<UI_MESSAGE extends UIMessage> implements ChatTransport<UI_MESSAGE> {
+  readonly resumeStreamIsReplay = true;
+  private readonly url;
+  private readonly protocols?;
+  private readonly params?;
+  private readonly headers?;
+  private readonly body?;
+  private readonly webSocket?;
+  private readonly prepareSendMessagesRequest?;
+  private readonly prepareReconnectToStreamRequest?;
+  private connection?;
+  private readonly activeRequests;
+  private sendQueue;
+  constructor(options: WebSocketChatTransportInitOptions<UI_MESSAGE>);
+  sendMessages({ abortSignal, ...options }: Parameters<ChatTransport<UI_MESSAGE>['sendMessages']>[0]): Promise<ReadableStream<UIMessageChunk>>;
+  reconnectToStream(options: Parameters<ChatTransport<UI_MESSAGE>['reconnectToStream']>[0]): Promise<ReadableStream<UIMessageChunk> | null>;
+  /**
+   * Closes the current connection and errors any active response streams.
+   * A later request opens a new connection.
+   */
+  close(): void;
+  private throwIfAborted;
+  private getSocket;
+  private initializeConnection;
+  private buildUrl;
+  private waitForConnection;
+  private resolveConnection;
+  private rejectConnection;
+  private terminateConnection;
+  private createActiveRequest;
+  private abortRequest;
+  private cleanupRequest;
+  private failRequest;
+  private failAllRequests;
+  private resolveResumeStream;
+  private validateResponseChunk;
+  private handleResponseFrame;
+  private sendFrame;
 }
 //#endregion
 //#region src/ui/use-completion.d.ts
@@ -20730,9 +21663,9 @@ declare function toUIMessageChunk<TOOLS extends ToolSet = ToolSet, UI_MESSAGE ex
  * Converts a stream of `TextStreamPart<TOOLS>` chunks (as emitted by
  * `streamText`'s `stream`) into a stream of `UIMessageChunk`s suitable for
  * UI message streaming, including response message ID injection and
- * `onEnd` handling.
+ * step and stream end callbacks.
  */
-declare function toUIMessageStream<TOOLS extends ToolSet = ToolSet, UI_MESSAGE extends UIMessage = UIMessage>({ stream, tools, sendReasoning, sendSources, sendStart, sendFinish, onError, messageMetadata, originalMessages, generateMessageId, onEnd, onFinish }: {
+declare function toUIMessageStream<TOOLS extends ToolSet = ToolSet, UI_MESSAGE extends UIMessage = UIMessage>({ stream, tools, sendReasoning, sendSources, sendStart, sendFinish, onError, messageMetadata, originalMessages, generateMessageId, onStepEnd, onStepFinish, onEnd, onFinish }: {
   stream: ReadableStream<TextStreamPart<TOOLS>>;
   tools?: TOOLS;
 } & UIMessageStreamOptions<UI_MESSAGE>): ReadableStream<InferUIMessageChunk<UI_MESSAGE>>;
@@ -20753,6 +21686,19 @@ declare const UI_MESSAGE_STREAM_HEADERS: {
 type UIMessageStreamOnFinishCallback<UI_MESSAGE extends UIMessage> = UIMessageStreamOnEndCallback<UI_MESSAGE>;
 //#endregion
 //#region src/agent/create-agent-ui-stream.d.ts
+/**
+ * UI stream options with separate generation and UI message step callbacks.
+ */
+type AgentUIMessageStreamOptions<TOOLS extends ToolSet, UI_MESSAGE extends UIMessage> = Omit<UIMessageStreamOptions<UI_MESSAGE>, 'onStepEnd' | 'onStepFinish'> & {
+  onStepEnd?: GenerateTextOnStepEndCallback<TOOLS>;
+  /** @deprecated Use `onStepEnd` instead. */
+  onStepFinish?: GenerateTextOnStepFinishCallback<TOOLS>;
+  /**
+   * Called after each step is converted to UI message parts.
+   * Receives the accumulated UI message for inspection or persistence.
+   */
+  onUIMessageStepEnd?: UIMessageStreamOnStepEndCallback<UI_MESSAGE>;
+};
 /**
  * Runs the agent and stream the output as a UI message stream.
  *
@@ -20762,14 +21708,16 @@ type UIMessageStreamOnFinishCallback<UI_MESSAGE extends UIMessage> = UIMessageSt
  * @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.
  * @param onStepFinish - Deprecated alias for `onStepEnd`. Optional.
+ * @param onUIMessageStepEnd - Callback with the accumulated UI message after each step. Optional.
  *
  * @returns The UI message stream.
  */
-declare function createAgentUIStream<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = never, MESSAGE_METADATA = unknown, UI_MESSAGE extends UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>> = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>>({ agent, uiMessages, convertDataPart, options, abortSignal, timeout, experimental_sandbox: sandbox, experimental_transform, onStepEnd, onStepFinish, ...uiMessageStreamOptions }: {
+declare function createAgentUIStream<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = never, MESSAGE_METADATA = unknown, UI_MESSAGE extends UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>> = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>>({ agent, uiMessages, convertDataPart, options, abortSignal, timeout, experimental_sandbox: sandbox, experimental_steering: steering, experimental_transform, onStepEnd, onStepFinish, onUIMessageStepEnd, ...uiMessageStreamOptions }: {
   agent: Agent$1<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
   uiMessages: unknown[];
   /**
@@ -20780,12 +21728,50 @@ declare function createAgentUIStream<CALL_OPTIONS = never, TOOLS extends ToolSet
   abortSignal?: AbortSignal;
   timeout?: TimeoutConfiguration<TOOLS>;
   experimental_sandbox?: SandboxSession;
+  experimental_steering?: Steering;
   options?: CALL_OPTIONS;
   experimental_transform?: Arrayable<StreamTextTransform<TOOLS>>;
-  onStepEnd?: GenerateTextOnStepEndCallback<TOOLS>;
-  /** @deprecated Use `onStepEnd` instead. */
-  onStepFinish?: GenerateTextOnStepFinishCallback<TOOLS>;
-} & UIMessageStreamOptions<UI_MESSAGE>): Promise<AsyncIterableStream<InferUIMessageChunk<UI_MESSAGE>>>;
+} & AgentUIMessageStreamOptions<TOOLS, UI_MESSAGE>): Promise<AsyncIterableStream<InferUIMessageChunk<UI_MESSAGE>>>;
+//#endregion
+//#region src/agent/create-agent-ui-stream-response.d.ts
+/**
+ * Runs the agent and returns a response object with a UI message stream.
+ *
+ * @param agent - The agent to run.
+ * @param uiMessages - The input UI messages.
+ * @param convertDataPart - Optional function to convert custom data parts to text or file model message parts.
+ * @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.
+ * @param onStepFinish - Deprecated alias for `onStepEnd`. Optional.
+ * @param onUIMessageStepEnd - Callback with the accumulated UI message after each step. Optional.
+ * @param headers - Additional headers for the response. Optional.
+ * @param status - The status code for the response. Optional.
+ * @param statusText - The status text for the response. Optional.
+ * @param keepAliveMs - Optional interval for sending SSE keep-alive comments.
+ * @param consumeSseStream - Whether to consume the SSE stream. Optional.
+ *
+ * @returns The response object.
+ */
+declare function createAgentUIStreamResponse<CALL_OPTIONS = never, TOOLS extends ToolSet = {}, RUNTIME_CONTEXT extends Context$1 = Context$1, OUTPUT extends Output = never, MESSAGE_METADATA = unknown, UI_MESSAGE extends UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>> = UIMessage<MESSAGE_METADATA, UIDataTypes, InferUITools<TOOLS>>>({ headers, status, statusText, keepAliveMs, consumeSseStream, ...options }: {
+  agent: Agent$1<CALL_OPTIONS, TOOLS, RUNTIME_CONTEXT, OUTPUT>;
+  uiMessages: unknown[];
+  /**
+   * Converts custom UI data parts to text or file model message parts.
+   * Data parts are ignored when omitted or when the callback returns undefined.
+   */
+  convertDataPart?: NonNullable<Parameters<typeof convertToModelMessages<UI_MESSAGE>>[1]>['convertDataPart'];
+  abortSignal?: AbortSignal;
+  timeout?: TimeoutConfiguration<TOOLS>;
+  experimental_sandbox?: SandboxSession;
+  experimental_steering?: Steering;
+  options?: CALL_OPTIONS;
+  experimental_transform?: Arrayable<StreamTextTransform<TOOLS>>;
+} & UIMessageStreamResponseInit & AgentUIMessageStreamOptions<TOOLS, UI_MESSAGE>): Promise<Response>;
 //#endregion
 //#region src/agent/pipe-agent-ui-stream-to-response.d.ts
 /**
@@ -20798,10 +21784,12 @@ declare function createAgentUIStream<CALL_OPTIONS = never, TOOLS extends ToolSet
  * @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.
  * @param onStepFinish - Deprecated alias for `onStepEnd`. Optional.
+ * @param onUIMessageStepEnd - Callback with the accumulated UI message after each step. Optional.
  * @param headers - Additional headers for the response. Optional.
  * @param status - The status code for the response. Optional.
  * @param statusText - The status text for the response. Optional.
@@ -20820,12 +21808,10 @@ declare function pipeAgentUIStreamToResponse<CALL_OPTIONS = never, TOOLS extends
   abortSignal?: AbortSignal;
   timeout?: TimeoutConfiguration<TOOLS>;
   experimental_sandbox?: SandboxSession;
+  experimental_steering?: Steering;
   options?: CALL_OPTIONS;
   experimental_transform?: Arrayable<StreamTextTransform<TOOLS>>;
-  onStepEnd?: GenerateTextOnStepEndCallback<TOOLS>;
-  /** @deprecated Use `onStepEnd` instead. */
-  onStepFinish?: GenerateTextOnStepFinishCallback<TOOLS>;
-} & UIMessageStreamResponseInit & UIMessageStreamOptions<UI_MESSAGE>): Promise<void>;
+} & UIMessageStreamResponseInit & AgentUIMessageStreamOptions<TOOLS, UI_MESSAGE>): Promise<void>;
 //#endregion
 //#region src/generate-text/filter-active-tools.d.ts
 type ActiveToolSubset<TOOLS extends ToolSet | undefined, ACTIVE_TOOL_NAMES extends ActiveTools<NonNullable<TOOLS>>> = TOOLS extends undefined ? undefined : [ACTIVE_TOOL_NAMES] extends [NonNullable<ActiveTools<NonNullable<TOOLS>>>] ? Pick<NonNullable<TOOLS>, ACTIVE_TOOL_NAMES[number]> : TOOLS;
@@ -20978,7 +21964,7 @@ type LanguageModelStreamPart<TOOLS extends ToolSet = ToolSet> = Exclude<TextStre
  *
  * @returns A stream of model call parts together with request and response metadata when available.
  */
-declare function streamLanguageModelCall<TOOLS extends ToolSet, 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, 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>;
@@ -21006,6 +21992,8 @@ declare function streamLanguageModelCall<TOOLS extends ToolSet, OUTPUT extends O
     generateId?: IdGenerator;
     generateCallId?: IdGenerator;
     now?: () => number;
+    /** Internal: content is only needed by collectors and full-content callbacks. */
+    collectContent?: boolean;
   };
   onLanguageModelCallStart?: Arrayable<OnLanguageModelCallStartCallback>;
   onLanguageModelCallEnd?: Arrayable<OnLanguageModelCallEndCallback<TOOLS>>;
@@ -21491,6 +22479,8 @@ interface EmbedResult {
  * @param model - The embedding model to use.
  * @param value - The value that should be embedded.
  *
+ * @param dimensions - Requested output dimensions. Must be a positive integer. Requires provider support.
+ *
  * @param maxRetries - Maximum number of retries. Set to 0 to disable retries. Default: 2.
  * @param abortSignal - An optional abort signal that can be used to cancel the call.
  * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
@@ -21504,7 +22494,7 @@ interface EmbedResult {
  *
  * @returns A result object that contains the embedding, the value, and additional information.
  */
-declare function embed<RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: modelArg, value, providerOptions, maxRetries: maxRetriesArg, abortSignal, headers, experimental_telemetry, telemetry, runtimeContext, onStart, experimental_onStart, onEnd, experimental_onEnd, _internal: { generateCallId } }: {
+declare function embed<RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: modelArg, value, dimensions, providerOptions, maxRetries: maxRetriesArg, abortSignal, headers, experimental_telemetry, telemetry, runtimeContext, onStart, experimental_onStart, onEnd, experimental_onEnd, _internal: { generateCallId } }: {
   /**
    * The embedding model to use.
    */
@@ -21513,6 +22503,12 @@ declare function embed<RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: m
    * The value that should be embedded.
    */
   value: string;
+  /**
+   * The requested number of dimensions for the output embeddings.
+   * Must be a positive integer. Support and allowed values depend on the model
+   * and provider implementation.
+   */
+  dimensions?: number;
   /**
    * Maximum number of retries per embedding model call. Set to 0 to disable retries.
    *
@@ -21633,6 +22629,8 @@ interface EmbedManyResult {
  * @param model - The embedding model to use.
  * @param values - The values that should be embedded.
  *
+ * @param dimensions - Requested output dimensions. Must be a positive integer. Requires provider support.
+ *
  * @param maxRetries - Maximum number of retries. Set to 0 to disable retries. Default: 2.
  * @param abortSignal - An optional abort signal that can be used to cancel the call.
  * @param headers - Additional HTTP headers to be sent with the request. Only applicable for HTTP-based providers.
@@ -21650,7 +22648,7 @@ interface EmbedManyResult {
  *
  * @returns A result object that contains the embeddings, the value, and additional information.
  */
-declare function embedMany<RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: modelArg, values, maxParallelCalls, maxRetries: maxRetriesArg, abortSignal, headers, providerOptions, experimental_telemetry, telemetry, runtimeContext, onStart, experimental_onStart, onEnd, experimental_onEnd, _internal: { generateCallId } }: {
+declare function embedMany<RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: modelArg, values, dimensions, maxParallelCalls, maxRetries: maxRetriesArg, abortSignal, headers, providerOptions, experimental_telemetry, telemetry, runtimeContext, onStart, experimental_onStart, onEnd, experimental_onEnd, _internal: { generateCallId } }: {
   /**
    * The embedding model to use.
    */
@@ -21659,6 +22657,12 @@ declare function embedMany<RUNTIME_CONTEXT extends Context$1 = Context$1>({ mode
    * The values that should be embedded.
    */
   values: Array<string>;
+  /**
+   * The requested number of dimensions for the output embeddings.
+   * Must be a positive integer. Support and allowed values depend on the model
+   * and provider implementation.
+   */
+  dimensions?: number;
   /**
    * Maximum number of retries per embedding model call. Set to 0 to disable retries.
    *
@@ -21901,6 +22905,7 @@ declare class NoSpeechGeneratedError extends AISDKError {
   readonly responses: Array<SpeechModelResponseMetadata>;
   constructor(options: {
     responses: Array<SpeechModelResponseMetadata>;
+    cause?: unknown;
   });
   static isInstance(error: unknown): error is NoSpeechGeneratedError;
 }
@@ -22063,6 +23068,8 @@ declare class ToolCallRepairError extends AISDKError {
 //#region src/error/tool-choice-violation-error.d.ts
 declare const symbol$6: unique symbol;
 type EnforcedToolChoice = Extract<LanguageModelV4ToolChoice, {
+  type: 'none';
+} | {
   type: 'required';
 } | {
   type: 'tool';
@@ -22215,11 +23222,15 @@ type Experimental_EvaluationUnsupportedQuestionTypeError = DecisionUnsupportedQu
 //#endregion
 //#region src/decide/decide.d.ts
 /** Decide answers to typed questions against one shared state. Experimental. */
-declare function decide<const QUESTIONS extends Record<string, DecisionQuestion>, RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: modelArg, state, questions, maxRetries, abortSignal, headers, providerOptions, telemetry, runtimeContext, onStart, onEnd, _internal: { generateCallId } }: {
+declare function decide<const QUESTIONS extends Record<string, DecisionModelV4Question>, RUNTIME_CONTEXT extends Context$1 = Context$1>({ model: modelArg, state, questions, maxOutputTokens, reasoning, maxRetries, abortSignal, headers, providerOptions, telemetry, runtimeContext, onStart, onEnd, _internal: { generateCallId } }: {
   /** A decision model instance or an ID resolved by the configured default provider. */
   model: DecisionModel;
-  state: DecisionModelV4CallOptions['state'];
+  state: DecisionState;
   questions: QUESTIONS;
+  /** Maximum output tokens for supported models. Must be an integer >= 1. */
+  maxOutputTokens?: number;
+  /** Reasoning effort for supported models. Language-model adapters default to none. */
+  reasoning?: DecisionModelV4CallOptions['reasoning'];
   /** Maximum retries for transient provider failures. Defaults to 2. */
   maxRetries?: number;
   abortSignal?: AbortSignal;
@@ -22253,11 +23264,11 @@ type Experimental_EvaluationModelCallEndEvent = DecisionModelCallEndEvent;
 /** @deprecated Use `Experimental_DecisionModel` instead. */
 type Experimental_EvaluationModel = DecisionModel;
 /** @deprecated Use `Experimental_DecisionQuestion` instead. */
-type Experimental_EvaluationQuestion = DecisionQuestion;
+type Experimental_EvaluationQuestion = DecisionModelV4Question;
 /** @deprecated Use `Experimental_DecisionAnswer` instead. */
-type Experimental_EvaluationAnswer<QUESTION extends DecisionQuestion> = DecisionAnswer<QUESTION>;
+type Experimental_EvaluationAnswer<QUESTION extends DecisionModelV4Question> = DecisionAnswer<QUESTION>;
 /** @deprecated Use `Experimental_DecisionResult` instead. */
-type Experimental_EvaluationResult<QUESTIONS extends Record<string, DecisionQuestion>> = DecisionResult<QUESTIONS>;
+type Experimental_EvaluationResult<QUESTIONS extends Record<string, DecisionModelV4Question>> = DecisionResult<QUESTIONS>;
 //#endregion
 //#region src/generate-object/generate-object-result.d.ts
 /**
@@ -22589,8 +23600,10 @@ type Job = () => Promise<void>;
 declare class SerialJobExecutor {
   private queue;
   private isProcessing;
+  private idleWaiters;
   private processQueue;
   run(job: Job): Promise<void>;
+  waitForIdle(): Promise<void>;
 }
 //#endregion
 //#region src/util/simulate-readable-stream.d.ts
@@ -23059,6 +24072,166 @@ declare function generateSpeech({ model, text, voice, outputFormat, instructions
   };
 }): Promise<SpeechResult>;
 //#endregion
+//#region src/generate-speech/stream-speech-result.d.ts
+/**
+ * A piece of text to synthesize. Pass a stream of these (or mix them with
+ * plain strings) to give parts their own voice, e.g. for dialogue.
+ */
+type SpeechTextPart = {
+  type: 'text';
+  text: string;
+  /**
+   * The voice that speaks this part (provider-specific, like the call's
+   * `voice`). Single-voice providers reject a voice that differs from the
+   * call's voice.
+   */
+  voice?: string;
+  /**
+   * Additional provider-specific options for this part.
+   */
+  providerOptions?: ProviderOptions;
+};
+type SpeechStreamPart = {
+  /**
+   * Audio chunk in generation order. Chunks are not necessarily
+   * standalone files; concatenate them to reconstruct the audio. A chunk
+   * is empty only when it carries `providerMetadata` (e.g. a turn marker).
+   */
+  type: 'audio';
+  id?: string;
+  audio: Uint8Array;
+  audioFormat: SharedV4AudioFormat;
+  providerMetadata?: SharedV4ProviderMetadata;
+} | {
+  type: 'raw';
+  rawValue: unknown;
+} | {
+  type: 'error';
+  error: unknown;
+};
+type SpeechStreamUsage = SpeechModelV4StreamUsage;
+interface StreamSpeechResult {
+  /**
+   * Usage information reported for the call, if available.
+   */
+  readonly usage: PromiseLike<SpeechStreamUsage>;
+  /**
+   * Warnings for the call, e.g. unsupported settings.
+   */
+  readonly warnings: PromiseLike<Array<Warning>>;
+  /**
+   * Response metadata.
+   */
+  readonly responses: PromiseLike<Array<SpeechModelResponseMetadata>>;
+  /**
+   * Additional provider-specific metadata.
+   */
+  readonly providerMetadata: PromiseLike<Record<string, JSONObject$2>>;
+  /**
+   * Stream of audio bytes in generation order.
+   *
+   * `audioStream` and `fullStream` share one live stream: only one of them
+   * can be accessed, and only once. Access it before any result promise;
+   * accessing a result promise first consumes the stream internally.
+   */
+  readonly audioStream: AsyncIterableStream<Uint8Array>;
+  /**
+   * Full stream of speech parts (audio, raw, and error parts).
+   *
+   * `audioStream` and `fullStream` share one live stream: only one of them
+   * can be accessed, and only once. Access it before any result promise;
+   * accessing a result promise first consumes the stream internally.
+   */
+  readonly fullStream: AsyncIterableStream<SpeechStreamPart>;
+}
+//#endregion
+//#region src/generate-speech/stream-speech.d.ts
+/**
+ * Streams speech audio using a speech model.
+ *
+ * @param model - The speech model to use. It must support streaming speech.
+ * @param text - The text to convert to speech: a complete string, or a stream of text deltas
+ * (e.g. the text stream of `streamText`) or text parts that is synthesized as it arrives.
+ * A text part can set its own `voice` on providers that support several voices per stream.
+ * @param voice - The voice to use for speech generation.
+ * @param outputFormat - The format of the output audio chunks, e.g. `{ type: 'audio/pcm', rate: 24000 }`.
+ * @param instructions - Instructions for the speech generation e.g. "Speak in a slow and steady tone".
+ * @param speed - The speed of the speech generation.
+ * @param language - The language for speech generation (ISO 639-1 code e.g. "en", "es", "fr") or "auto" for automatic detection.
+ * @param providerOptions - Additional provider-specific options.
+ * @param abortSignal - An optional abort signal that can be used to cancel the call.
+ * @param headers - Additional HTTP/WebSocket headers to send when supported by the provider.
+ * @param includeRawChunks - When true, raw provider chunks are included in `fullStream`.
+ * @param onError - Called for each provider error part; defaults to `console.error`.
+ *
+ * @returns A result object with the audio stream and the final usage and metadata.
+ */
+declare function streamSpeech({ model, text, voice, outputFormat, instructions, speed, language, providerOptions, abortSignal, headers, includeRawChunks, onError, _internal: { currentDate } }: {
+  /**
+   * The speech model to use.
+   */
+  model: SpeechModel;
+  /**
+   * The text to convert to speech: a complete string, or an array, iterable,
+   * or stream of text deltas and/or text parts.
+   */
+  text: string | Iterable<string | SpeechTextPart> | AsyncIterable<string | SpeechTextPart> | ReadableStream<string | SpeechTextPart>;
+  /**
+   * The voice to use for speech generation.
+   */
+  voice?: string;
+  /**
+   * The desired format of the output audio chunks, e.g.
+   * `{ type: 'audio/pcm', rate: 24000 }` or `{ type: 'audio/mpeg' }`.
+   * Supported formats are provider-specific.
+   */
+  outputFormat?: SharedV4AudioFormat;
+  /**
+   * Instructions for the speech generation e.g. "Speak in a slow and steady tone".
+   */
+  instructions?: string;
+  /**
+   * The speed of the speech generation.
+   */
+  speed?: number;
+  /**
+   * The language for speech generation. This should be an ISO 639-1 language code (e.g. "en", "es", "fr")
+   * or "auto" for automatic language detection. Provider support varies.
+   */
+  language?: string;
+  /**
+   * Additional provider-specific options.
+   */
+  providerOptions?: ProviderOptions;
+  /**
+   * Abort signal.
+   */
+  abortSignal?: AbortSignal;
+  /**
+   * Additional headers to include in the request, if supported by the provider.
+   */
+  headers?: Record<string, string>;
+  /**
+   * When true, providers should include raw provider chunks in the stream.
+   */
+  includeRawChunks?: boolean;
+  /**
+   * Called for each error part the provider reports. Error parts are not
+   * fatal: `fullStream` includes them and `audioStream` skips them. The
+   * callback is not awaited, and errors it throws are ignored.
+   * Defaults to logging the error with `console.error`.
+   */
+  onError?: (event: {
+    error: unknown;
+  }) => void | PromiseLike<void>;
+  /**
+   * Internal test hooks.
+   */
+  _internal?: {
+    currentDate?: () => Date;
+  };
+}): StreamSpeechResult;
+//#endregion
 //#region src/generate-speech/index.d.ts
 /**
  * @deprecated Use `generateSpeech` instead.
@@ -24762,14 +25935,10 @@ declare function uploadSkill({ api, files, displayTitle, providerOptions }: {
 } & Omit<SkillsV4UploadSkillCallOptions, 'files'> & {
   files: UploadSkillFile[];
 }): Promise<UploadSkillResult>;
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/aisdk/index.d.ts
 export declare const wrapAISDK: (ai: typeof index_d_exports) => typeof index_d_exports;
 export declare function wrapLanguageModel(languageModel: LanguageModelV4): LanguageModelV4;
 export declare function wrapLanguageModel(languageModel: LanguageModelV3): LanguageModelV3;
 export declare function wrapLanguageModel(languageModel: LanguageModelV2): LanguageModelV2;
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/aisdk/v7-integration/index.d.ts
 /**
  * The AI SDK v7 diagnostics channel name. Every lifecycle event fires
  * `{ type, event }` through this channel.
@@ -24812,7 +25981,6 @@ export declare class LaminarAiSdkTelemetry {
   private readonly toolByCallId;
   private readonly activeStreamStepByCallId;
   private readonly promptByCallId;
-  private readonly logger;
   constructor(options?: LaminarAiSdkTelemetryOptions);
   onStart: (event: any) => void;
   onStepStart: (event: any) => void;
@@ -24912,8 +26080,6 @@ export declare const enableAiSdkTelemetryDebug: (log?: (entry: {
   type: string;
   event: unknown;
 }) => void) => (() => void);
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/claude-agent-sdk/index.d.ts
 /**
  * Create an instrumented version of the claude-agent-sdk query function.
  * This can be used when importing the query function before Laminar initialization.
@@ -24922,8 +26088,6 @@ export declare const enableAiSdkTelemetryDebug: (log?: (entry: {
  * @returns The instrumented query function
  */
 export declare function instrumentClaudeAgentQuery(originalQuery: any): any;
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/mastra/types.d.ts
 interface MastraSpanErrorInfo {
   message: string;
   name?: string;
@@ -24971,8 +26135,6 @@ interface MastraExporterOptions {
    */
   linkToActiveContext?: boolean;
 }
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/mastra/exporter.d.ts
 /**
  * Bridges Mastra's ObservabilityExporter contract to Laminar's OTLP ingestion.
  *
@@ -25025,8 +26187,6 @@ export declare class MastraExporter {
   private applyLlmAttributes;
   private applyToolAttributes;
 }
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/temporal/interceptors.d.ts
 /**
  * Options for Laminar Temporal interceptors.
  */
@@ -25164,8 +26324,6 @@ declare class ActivityInboundInterceptor {
 declare const ActivityInterceptorFactory: (options?: LaminarTemporalInterceptorOptions) => (ctx: any) => {
   inbound: ActivityInboundInterceptor;
 };
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/temporal/index.d.ts
 /** Namespace export: `LaminarTemporalInterceptors.WorkflowClientInterceptor`. */
 export declare const LaminarTemporalInterceptors: {
   WorkflowClientInterceptor: typeof WorkflowClientInterceptor;
@@ -25185,8 +26343,6 @@ export declare const LaminarTemporalInterceptors: {
     };
   };
 };
-//#endregion
-//#region src/opentelemetry-lib/instrumentation/temporal/consts.d.ts
 /** Header key used to carry the serialized Laminar span context through Temporal. */
 declare const LAMINAR_SPAN_CONTEXT_HEADER = "x-lmnr-span-context";
 /**
@@ -25194,8 +26350,6 @@ declare const LAMINAR_SPAN_CONTEXT_HEADER = "x-lmnr-span-context";
  * interop with non-Laminar clients/workers that understand W3C trace context.
  */
 declare const TRACEPARENT_HEADER = "traceparent";
-//#endregion
-//#region src/opentelemetry-lib/tracing/index.d.ts
 /**
  * Get the tracer provider. Returns Laminar's tracer provider if Laminar is initialized,
  * otherwise returns the global tracer provider.
@@ -25227,8 +26381,6 @@ export declare const getTracerProvider: () => TracerProvider;
  * })
  */
 export declare const getTracer: () => Tracer;
-//#endregion
-//#region src/opentelemetry-lib/tracing/instrumentations.d.ts
 /**
  * Initialize and return Laminar instrumentations.
  * Useful to use with libraries that initialize tracing and can register passed
@@ -25256,11 +26408,11 @@ export declare const getTracer: () => Tracer;
 export declare const initializeLaminarInstrumentations: (options?: {
   baseUrl?: string;
   apiKey?: string;
+  exportSpans?: boolean;
   httpPort?: number;
   suppressContentTracing?: boolean;
   instrumentModules?: InitializeOptions["instrumentModules"];
   sessionRecordingOptions?: SessionRecordingOptions;
 }) => Instrumentation<import("@opentelemetry/instrumentation").InstrumentationConfig>[];
-//#endregion
 export { type Datapoint, EvaluationDataset as Dataset, type Dataset as DatasetType, type EvalReporter, type EvaluationDatapoint, type EvaluationDatapointDatasetLink, type EvaluatorFunction, type EvaluatorFunctionReturn, type EveAssertionResult, type EveAssertionSeverity, type EveEval, type EveEvalDerivedFacts, type EveEvalResult, type EveEvalRunSummary, type EveEvalTarget, type EveEvalTaskResult, type EveEvalToolCall, type EveEvalVerdict, type EveRuntimeIdentity, type Event, HumanEvaluator, LAMINAR_SPAN_CONTEXT_HEADER as LAMINAR_TEMPORAL_SPAN_CONTEXT_HEADER, TRACEPARENT_HEADER as LAMINAR_TEMPORAL_TRACEPARENT_HEADER, type LaminarAiSdkTelemetryOptions, LaminarClient, LaminarDataset, type LaminarInitializeProps, type LaminarReporterOptions, type LaminarSpanContext, ActivityClientInterceptor as LaminarTemporalActivityClientInterceptor, ActivityInterceptorFactory as LaminarTemporalActivityInterceptorFactory, ScheduleClientInterceptor as LaminarTemporalScheduleClientInterceptor, WorkflowClientInterceptor as LaminarTemporalWorkflowClientInterceptor, type MaskInputOptions, type MastraExporterOptions, type PushDatapointsResponse, type SessionRecordingOptions, type Span, TracingLevel, evaluate };
 //# sourceMappingURL=index.d.mts.map