@jterrazz/intelligence 4.2.0 → 5.0.0

package/dist/index.d.cts

@@ -4,7 +4,6 @@ import { LanguageModel, LanguageModelMiddleware } from "ai";
 import { JSONSchema7 } from "json-schema";
 import { Schema } from "zod";
 import { z } from "zod/v4";
-
 //#region src/logging/logging.middleware.d.ts
 interface LoggingMiddlewareOptions {
   logger: LoggerPort;
@@ -20,7 +19,68 @@ interface LoggingMiddlewareOptions {
 declare function createLoggingMiddleware(options: LoggingMiddlewareOptions): LanguageModelMiddleware;
 //#endregion
 //#region node_modules/@ai-sdk/provider/dist/index.d.ts
-type SharedV3Headers = Record<string, string>;
+/**
+ * A mapping of provider names to provider-specific file identifiers.
+ *
+ * Provider references allow files to be identified across different
+ * providers without re-uploading, by storing each provider's own
+ * identifier for the same logical file.
+ *
+ * ```ts
+ * {
+ *   "openai": "file-abc123",
+ *   "anthropic": "file-xyz789"
+ * }
+ * ```
+ *
+ * The `type?: never` constraint excludes any object that has a `type`
+ * property, so a `SharedV4ProviderReference` cannot be confused with a
+ * tagged file-data shape (e.g. `{ type: 'data', data }` or
+ * `{ type: 'reference', reference }`) when both appear in the same union.
+ */
+type SharedV4ProviderReference = Record<string, string> & {
+  type?: never;
+};
+/**
+ * File data variant containing raw bytes (`Uint8Array`) or a base64-encoded
+ * string.
+ */
+interface SharedV4FileDataData {
+  type: 'data';
+  data: Uint8Array | string;
+}
+/**
+ * File data variant containing a URL that points to the file.
+ */
+interface SharedV4FileDataUrl {
+  type: 'url';
+  url: URL;
+}
+/**
+ * File data variant containing a provider reference (`{ [provider]: id }`).
+ */
+interface SharedV4FileDataReference {
+  type: 'reference';
+  reference: SharedV4ProviderReference;
+}
+/**
+ * File data variant containing inline text content (e.g. an inline text
+ * document).
+ */
+interface SharedV4FileDataText {
+  type: 'text';
+  text: string;
+}
+/**
+ * File data as a tagged discriminated union:
+ *
+ * - `{ type: 'data', data }`: raw bytes (`Uint8Array`) or base64-encoded string.
+ * - `{ type: 'url', url }`: a URL that points to the file.
+ * - `{ type: 'reference', reference }`: a provider reference (`{ [provider]: id }`).
+ * - `{ type: 'text', text }`: inline text content (e.g. an inline text document).
+ */
+type SharedV4FileData = SharedV4FileDataData | SharedV4FileDataUrl | SharedV4FileDataReference | SharedV4FileDataText;
+type SharedV4Headers = Record<string, string>;
 /**
  * A JSON value can be a string, number, boolean, object, array, or null.
  * JSON values can be serialized and deserialized by the JSON.stringify and JSON.parse methods.
@@ -51,7 +111,7 @@ type JSONArray = JSONValue[];
  * }
  * ```
  */
-type SharedV3ProviderMetadata = Record<string, JSONObject>;
+type SharedV4ProviderMetadata = Record<string, JSONObject>;
 /**
  * Additional provider-specific options.
  * Options are additional input to the provider.
@@ -73,14 +133,14 @@ type SharedV3ProviderMetadata = Record<string, JSONObject>;
  * }
  * ```
  */
-type SharedV3ProviderOptions = Record<string, JSONObject>;
+type SharedV4ProviderOptions = Record<string, JSONObject>;
 /**
  * Warning from the model.
  *
  * For example, that certain features are unsupported or compatibility
  * functionality is used (which might lead to suboptimal results).
  */
-type SharedV3Warning = {
+type SharedV4Warning = {
   /**
    * A feature is not supported by the model.
    */
@@ -106,6 +166,19 @@ type SharedV3Warning = {
    * Additional details about the warning.
    */
   details?: string;
+} | {
+  /**
+   * A deprecated feature or option is being used.
+   */
+  type: 'deprecated';
+  /**
+   * The deprecated setting or feature name.
+   */
+  setting: string;
+  /**
+   * A human-readable message explaining what to use instead.
+   */
+  message: string;
 } | {
   /**
    * Other warning.
@@ -122,7 +195,7 @@ type SharedV3Warning = {
  * Note: this is **not** the user-facing tool definition. The AI SDK methods will
  * map the user-facing tool definitions to this format.
  */
-type LanguageModelV3FunctionTool = {
+type LanguageModelV4FunctionTool = {
   /**
    * The type of the tool (always 'function').
    */
@@ -159,12 +232,8 @@ type LanguageModelV3FunctionTool = {
   /**
    * The provider-specific options for the tool.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 };
-/**
- * Data content. Can be a Uint8Array, base64 encoded data as a string or a URL.
- */
-type LanguageModelV3DataContent = Uint8Array | string | URL;
 /**
  * A prompt is a list of messages.
  *
@@ -174,31 +243,31 @@ type LanguageModelV3DataContent = Uint8Array | string | URL;
  * Note: This is not a user-facing prompt. The AI SDK methods will map the
  * user-facing prompt types such as chat or instruction prompts to this format.
  */
-type LanguageModelV3Prompt = Array<LanguageModelV3Message>;
-type LanguageModelV3Message = ({
+type LanguageModelV4Prompt = Array<LanguageModelV4Message>;
+type LanguageModelV4Message = ({
   role: 'system';
   content: string;
 } | {
   role: 'user';
-  content: Array<LanguageModelV3TextPart | LanguageModelV3FilePart>;
+  content: Array<LanguageModelV4TextPart | LanguageModelV4FilePart>;
 } | {
   role: 'assistant';
-  content: Array<LanguageModelV3TextPart | LanguageModelV3FilePart | LanguageModelV3ReasoningPart | LanguageModelV3ToolCallPart | LanguageModelV3ToolResultPart>;
+  content: Array<LanguageModelV4TextPart | LanguageModelV4FilePart | LanguageModelV4CustomPart | LanguageModelV4ReasoningPart | LanguageModelV4ReasoningFilePart | LanguageModelV4ToolCallPart | LanguageModelV4ToolResultPart>;
 } | {
   role: 'tool';
-  content: Array<LanguageModelV3ToolResultPart | LanguageModelV3ToolApprovalResponsePart>;
+  content: Array<LanguageModelV4ToolResultPart | LanguageModelV4ToolApprovalResponsePart>;
 }) & {
   /**
    * Additional provider-specific options. They are passed through
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 };
 /**
  * Text content part of a prompt. It contains a string of text.
  */
-interface LanguageModelV3TextPart {
+interface LanguageModelV4TextPart {
   type: 'text';
   /**
    * The text content.
@@ -209,12 +278,12 @@ interface LanguageModelV3TextPart {
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 }
 /**
  * Reasoning content part of a prompt. It contains a string of reasoning text.
  */
-interface LanguageModelV3ReasoningPart {
+interface LanguageModelV4ReasoningPart {
   type: 'reasoning';
   /**
    * The reasoning text.
@@ -225,25 +294,77 @@ interface LanguageModelV3ReasoningPart {
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
+}
+/**
+ * Reasoning file content part of a prompt. It contains a file generated as part of reasoning.
+ */
+interface LanguageModelV4ReasoningFilePart {
+  type: 'reasoning-file';
+  /**
+   * File data as a tagged discriminated union:
+   *
+   * - `{ type: 'data', data }`: raw bytes (Uint8Array) or base64-encoded string.
+   * - `{ type: 'url', url }`: a URL that points to the file.
+   */
+  data: SharedV4FileDataData | SharedV4FileDataUrl;
+  /**
+   * IANA media type of the file.
+   *
+   * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+   */
+  mediaType: string;
+  /**
+   * Additional provider-specific options. They are passed through
+   * to the provider from the AI SDK and enable provider-specific
+   * functionality that can be fully encapsulated in the provider.
+   */
+  providerOptions?: SharedV4ProviderOptions;
+}
+/**
+ * Provider-specific content part of a prompt. It contains no standardized
+ * payload beyond provider-specific options.
+ */
+interface LanguageModelV4CustomPart {
+  type: 'custom';
+  /**
+   * The kind of custom content, in the format `{provider}.{provider-type}`.
+   */
+  kind: `${string}.${string}`;
+  /**
+   * Additional provider-specific options. They are passed through
+   * to the provider from the AI SDK and enable provider-specific
+   * functionality that can be fully encapsulated in the provider.
+   */
+  providerOptions?: SharedV4ProviderOptions;
 }
 /**
  * File content part of a prompt. It contains a file.
  */
-interface LanguageModelV3FilePart {
+interface LanguageModelV4FilePart {
   type: 'file';
   /**
    * Optional filename of the file.
    */
   filename?: string;
   /**
-   * File data. Can be a Uint8Array, base64 encoded data as a string or a URL.
+   * File data as a tagged discriminated union:
+   *
+   * - `{ type: 'data', data }`: raw bytes (Uint8Array) or base64-encoded string.
+   * - `{ type: 'url', url }`: a URL that points to the file.
+   * - `{ type: 'reference', reference }`: a provider reference (`{ [provider]: id }`).
+   * - `{ type: 'text', text }`: inline text content (e.g. an inline text document).
    */
-  data: LanguageModelV3DataContent;
+  data: SharedV4FileData;
   /**
-   * IANA media type of the file.
+   * Either a full IANA media type (`type/subtype`, e.g. `image/png`) or just
+   * the top-level IANA segment (e.g. `image`, `audio`, `video`, `text`).
    *
-   * Can support wildcards, e.g. `image/*` (in which case the provider needs to take appropriate action).
+   * `*`-subtype wildcards (e.g. `image/*`) are normalized as equivalent to the
+   * top-level segment alone (e.g. `image`). Providers can use the helpers in
+   * `@ai-sdk/provider-utils` (`isFullMediaType`, `getTopLevelMediaType`,
+   * `detectMediaType`) to resolve the field according to their API
+   * requirements.
    *
    * @see https://www.iana.org/assignments/media-types/media-types.xhtml
    */
@@ -253,12 +374,12 @@ interface LanguageModelV3FilePart {
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 }
 /**
  * Tool call content part of a prompt. It contains a tool call (usually generated by the AI model).
  */
-interface LanguageModelV3ToolCallPart {
+interface LanguageModelV4ToolCallPart {
   type: 'tool-call';
   /**
    * ID of the tool call. This ID is used to match the tool call with the tool result.
@@ -282,12 +403,12 @@ interface LanguageModelV3ToolCallPart {
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 }
 /**
  * Tool result content part of a prompt. It contains the result of the tool call with the matching ID.
  */
-interface LanguageModelV3ToolResultPart {
+interface LanguageModelV4ToolResultPart {
   type: 'tool-result';
   /**
    * ID of the tool call that this result is associated with.
@@ -300,19 +421,19 @@ interface LanguageModelV3ToolResultPart {
   /**
    * Result of the tool call.
    */
-  output: LanguageModelV3ToolResultOutput;
+  output: LanguageModelV4ToolResultOutput;
   /**
    * Additional provider-specific options. They are passed through
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 }
 /**
  * Tool approval response content part of a prompt. It contains the user's
  * decision to approve or deny a provider-executed tool call.
  */
-interface LanguageModelV3ToolApprovalResponsePart {
+interface LanguageModelV4ToolApprovalResponsePart {
   type: 'tool-approval-response';
   /**
    * ID of the approval request that this response refers to.
@@ -331,12 +452,12 @@ interface LanguageModelV3ToolApprovalResponsePart {
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 }
 /**
  * Result of a tool call.
  */
-type LanguageModelV3ToolResultOutput = {
+type LanguageModelV4ToolResultOutput = {
   /**
    * Text tool output that should be directly sent to the API.
    */
@@ -345,14 +466,14 @@ type LanguageModelV3ToolResultOutput = {
   /**
    * Provider-specific options.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 } | {
   type: 'json';
   value: JSONValue;
   /**
    * Provider-specific options.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 } | {
   /**
    * Type when the user has denied the execution of the tool call.
@@ -365,21 +486,21 @@ type LanguageModelV3ToolResultOutput = {
   /**
    * Provider-specific options.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 } | {
   type: 'error-text';
   value: string;
   /**
    * Provider-specific options.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 } | {
   type: 'error-json';
   value: JSONValue;
   /**
    * Provider-specific options.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
 } | {
   type: 'content';
   value: Array<{
@@ -391,15 +512,28 @@ type LanguageModelV3ToolResultOutput = {
     /**
      * Provider-specific options.
      */
-    providerOptions?: SharedV3ProviderOptions;
+    providerOptions?: SharedV4ProviderOptions;
   } | {
-    type: 'file-data';
+    type: 'file';
     /**
-     * Base-64 encoded media data.
+     * File data as a tagged discriminated union:
+     *
+     * - `{ type: 'data', data }`: raw bytes (Uint8Array) or base64-encoded string.
+     * - `{ type: 'url', url }`: a URL that points to the file.
+     * - `{ type: 'reference', reference }`: a provider reference (`{ [provider]: id }`).
+     * - `{ type: 'text', text }`: inline text content (e.g. an inline text document).
      */
-    data: string;
+    data: SharedV4FileData;
     /**
-     * IANA media type.
+     * Either a full IANA media type (`type/subtype`, e.g. `image/png`) or just
+     * the top-level IANA segment (e.g. `image`, `audio`, `video`, `text`).
+     *
+     * `*`-subtype wildcards (e.g. `image/*`) are normalized as equivalent to the
+     * top-level segment alone (e.g. `image`). Providers can use the helpers in
+     * `@ai-sdk/provider-utils` (`isFullMediaType`, `getTopLevelMediaType`,
+     * `detectMediaType`) to resolve the field according to their API
+     * requirements.
+     *
      * @see https://www.iana.org/assignments/media-types/media-types.xhtml
      */
     mediaType: string;
@@ -410,81 +544,7 @@ type LanguageModelV3ToolResultOutput = {
     /**
      * Provider-specific options.
      */
-    providerOptions?: SharedV3ProviderOptions;
-  } | {
-    type: 'file-url';
-    /**
-     * URL of the file.
-     */
-    url: string;
-    /**
-     * Provider-specific options.
-     */
-    providerOptions?: SharedV3ProviderOptions;
-  } | {
-    type: 'file-id';
-    /**
-     * ID of the file.
-     *
-     * If you use multiple providers, you need to
-     * specify the provider specific ids using
-     * the Record option. The key is the provider
-     * name, e.g. 'openai' or 'anthropic'.
-     */
-    fileId: string | Record<string, string>;
-    /**
-     * Provider-specific options.
-     */
-    providerOptions?: SharedV3ProviderOptions;
-  } | {
-    /**
-     * Images that are referenced using base64 encoded data.
-     */
-    type: 'image-data';
-    /**
-     * Base-64 encoded image data.
-     */
-    data: string;
-    /**
-     * IANA media type.
-     * @see https://www.iana.org/assignments/media-types/media-types.xhtml
-     */
-    mediaType: string;
-    /**
-     * Provider-specific options.
-     */
-    providerOptions?: SharedV3ProviderOptions;
-  } | {
-    /**
-     * Images that are referenced using a URL.
-     */
-    type: 'image-url';
-    /**
-     * URL of the image.
-     */
-    url: string;
-    /**
-     * Provider-specific options.
-     */
-    providerOptions?: SharedV3ProviderOptions;
-  } | {
-    /**
-     * Images that are referenced using a provider file id.
-     */
-    type: 'image-file-id';
-    /**
-     * Image that is referenced using a provider file id.
-     *
-     * If you use multiple providers, you need to
-     * specify the provider specific ids using
-     * the Record option. The key is the provider
-     * name, e.g. 'openai' or 'anthropic'.
-     */
-    fileId: string | Record<string, string>;
-    /**
-     * Provider-specific options.
-     */
-    providerOptions?: SharedV3ProviderOptions;
+    providerOptions?: SharedV4ProviderOptions;
   } | {
     /**
      * Custom content part. This can be used to implement
@@ -494,7 +554,7 @@ type LanguageModelV3ToolResultOutput = {
     /**
      * Provider-specific options.
      */
-    providerOptions?: SharedV3ProviderOptions;
+    providerOptions?: SharedV4ProviderOptions;
   }>;
 };
 /**
@@ -504,7 +564,7 @@ type LanguageModelV3ToolResultOutput = {
  * The input and output schemas are defined be the provider, and
  * some of the tools are also executed on the provider systems.
  */
-type LanguageModelV3ProviderTool = {
+type LanguageModelV4ProviderTool = {
   /**
    * The type of the tool (always 'provider').
    */
@@ -522,7 +582,7 @@ type LanguageModelV3ProviderTool = {
    */
   args: Record<string, unknown>;
 };
-type LanguageModelV3ToolChoice = {
+type LanguageModelV4ToolChoice = {
   type: 'auto';
 } | {
   type: 'none';
@@ -532,7 +592,7 @@ type LanguageModelV3ToolChoice = {
   type: 'tool';
   toolName: string;
 };
-type LanguageModelV3CallOptions = {
+type LanguageModelV4CallOptions = {
   /**
    * A language mode prompt is a standardized prompt type.
    *
@@ -541,7 +601,7 @@ type LanguageModelV3CallOptions = {
    * That approach allows us to evolve the user  facing prompts without breaking
    * the language model interface.
    */
-  prompt: LanguageModelV3Prompt;
+  prompt: LanguageModelV4Prompt;
   /**
    * Maximum number of tokens to generate.
    */
@@ -607,11 +667,11 @@ type LanguageModelV3CallOptions = {
   /**
    * The tools that are available for the model.
    */
-  tools?: Array<LanguageModelV3FunctionTool | LanguageModelV3ProviderTool>;
+  tools?: Array<LanguageModelV4FunctionTool | LanguageModelV4ProviderTool>;
   /**
    * Specifies how the tool should be selected. Defaults to 'auto'.
    */
-  toolChoice?: LanguageModelV3ToolChoice;
+  toolChoice?: LanguageModelV4ToolChoice;
   /**
    * Include raw chunks in the stream. Only applicable for streaming calls.
    */
@@ -625,19 +685,41 @@ type LanguageModelV3CallOptions = {
    * Only applicable for HTTP-based providers.
    */
   headers?: Record<string, string | undefined>;
+  /**
+   * Reasoning effort level for the model. Controls how much reasoning
+   * the model performs before generating a response. Defaults to 'provider-default'.
+   */
+  reasoning?: 'provider-default' | 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
   /**
    * Additional provider-specific options. They are passed through
    * to the provider from the AI SDK and enable provider-specific
    * functionality that can be fully encapsulated in the provider.
    */
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
+};
+/**
+ * A provider-specific content block that does not map to another standardized
+ * content part type.
+ */
+type LanguageModelV4CustomContent = {
+  type: 'custom';
+  /**
+   * The kind of custom content, in the format `{provider}.{provider-type}`.
+   */
+  kind: `${string}.${string}`;
+  /**
+   * Additional provider-specific options. They are passed through
+   * to the provider from the AI SDK and enable provider-specific
+   * functionality that can be fully encapsulated in the provider.
+   */
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * A file that has been generated by the model.
  * Generated files as base64 encoded strings or binary data.
  * The files should be returned without any unnecessary conversion.
  */
-type LanguageModelV3File = {
+type LanguageModelV4File = {
   type: 'file';
   /**
    * The IANA media type of the file, e.g. `image/png` or `audio/mp3`.
@@ -646,34 +728,67 @@ type LanguageModelV3File = {
    */
   mediaType: string;
   /**
-   * Generated file data as base64 encoded strings or binary data.
+   * Generated file data as a tagged discriminated union:
+   *
+   * - `{ type: 'data', data }`: raw bytes (Uint8Array) or base64-encoded string.
+   * - `{ type: 'url', url }`: a URL that points to the file.
    *
    * The file data should be returned without any unnecessary conversion.
    * If the API returns base64 encoded strings, the file data should be returned
    * as base64 encoded strings. If the API returns binary data, the file data should
    * be returned as binary data.
    */
-  data: string | Uint8Array;
+  data: SharedV4FileDataData | SharedV4FileDataUrl;
   /**
    * Optional provider-specific metadata for the file part.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * Reasoning that the model has generated.
  */
-type LanguageModelV3Reasoning = {
+type LanguageModelV4Reasoning = {
   type: 'reasoning';
   text: string;
   /**
    * Optional provider-specific metadata for the reasoning part.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
+};
+/**
+ * A file that has been generated by the model as part of reasoning.
+ * Generated files as base64 encoded strings or binary data.
+ * The files should be returned without any unnecessary conversion.
+ */
+type LanguageModelV4ReasoningFile = {
+  type: 'reasoning-file';
+  /**
+   * The IANA media type of the file, e.g. `image/png` or `audio/mp3`.
+   *
+   * @see https://www.iana.org/assignments/media-types/media-types.xhtml
+   */
+  mediaType: string;
+  /**
+   * Generated file data as a tagged discriminated union:
+   *
+   * - `{ type: 'data', data }`: raw bytes (Uint8Array) or base64-encoded string.
+   * - `{ type: 'url', url }`: a URL that points to the file.
+   *
+   * The file data should be returned without any unnecessary conversion.
+   * If the API returns base64 encoded strings, the file data should be returned
+   * as base64 encoded strings. If the API returns binary data, the file data should
+   * be returned as binary data.
+   */
+  data: SharedV4FileDataData | SharedV4FileDataUrl;
+  /**
+   * Optional provider-specific metadata for the reasoning file part.
+   */
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * A source that has been used as input to generate the response.
  */
-type LanguageModelV3Source = {
+type LanguageModelV4Source = {
   type: 'source';
   /**
    * The type of source - URL sources reference web content.
@@ -694,7 +809,7 @@ type LanguageModelV3Source = {
   /**
    * Additional provider metadata for the source.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 } | {
   type: 'source';
   /**
@@ -720,18 +835,18 @@ type LanguageModelV3Source = {
   /**
    * Additional provider metadata for the source.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * Text that the model has generated.
  */
-type LanguageModelV3Text = {
+type LanguageModelV4Text = {
   type: 'text';
   /**
    * The text content.
    */
   text: string;
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * Tool approval request emitted by a provider for a provider-executed tool call.
@@ -739,7 +854,7 @@ type LanguageModelV3Text = {
  * This is used for flows where the provider executes the tool (e.g. MCP tools)
  * but requires an explicit user approval before continuing.
  */
-type LanguageModelV3ToolApprovalRequest = {
+type LanguageModelV4ToolApprovalRequest = {
   type: 'tool-approval-request';
   /**
    * ID of the approval request. This ID is referenced by the subsequent
@@ -753,12 +868,12 @@ type LanguageModelV3ToolApprovalRequest = {
   /**
    * Additional provider-specific metadata for the approval request.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * Tool calls that the model has generated.
  */
-type LanguageModelV3ToolCall = {
+type LanguageModelV4ToolCall = {
   type: 'tool-call';
   /**
    * The identifier of the tool call. It must be unique across all tool calls.
@@ -786,12 +901,12 @@ type LanguageModelV3ToolCall = {
   /**
    * Additional provider-specific metadata for the tool call.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 };
 /**
  * Result of a tool call that has been executed by the provider.
  */
-type LanguageModelV3ToolResult = {
+type LanguageModelV4ToolResult = {
   type: 'tool-result';
   /**
    * The ID of the tool call that this result is associated with.
@@ -827,9 +942,9 @@ type LanguageModelV3ToolResult = {
   /**
    * Additional provider-specific metadata for the tool result.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 };
-type LanguageModelV3Content = LanguageModelV3Text | LanguageModelV3Reasoning | LanguageModelV3File | LanguageModelV3ToolApprovalRequest | LanguageModelV3Source | LanguageModelV3ToolCall | LanguageModelV3ToolResult;
+type LanguageModelV4Content = LanguageModelV4Text | LanguageModelV4Reasoning | LanguageModelV4CustomContent | LanguageModelV4ReasoningFile | LanguageModelV4File | LanguageModelV4ToolApprovalRequest | LanguageModelV4Source | LanguageModelV4ToolCall | LanguageModelV4ToolResult;
 /**
  * Reason why a language model finished generating a response.
  *
@@ -837,7 +952,7 @@ type LanguageModelV3Content = LanguageModelV3Text | LanguageModelV3Reasoning | L
  * The unified finish reason is used to provide a consistent finish reason across different providers.
  * The raw finish reason is used to provide the original finish reason from the provider.
  */
-type LanguageModelV3FinishReason = {
+type LanguageModelV4FinishReason = {
   /**
    * Unified finish reason. This enables using the same finish reason across different providers.
    *
@@ -856,7 +971,7 @@ type LanguageModelV3FinishReason = {
    */
   raw: string | undefined;
 };
-interface LanguageModelV3ResponseMetadata {
+interface LanguageModelV4ResponseMetadata {
   /**
    * ID for the generated response, if the provider sends one.
    */
@@ -873,7 +988,7 @@ interface LanguageModelV3ResponseMetadata {
 /**
  * Usage information for a language model call.
  */
-type LanguageModelV3Usage = {
+type LanguageModelV4Usage = {
   /**
    * Information about the input tokens.
    */
@@ -923,25 +1038,25 @@ type LanguageModelV3Usage = {
 /**
  * The result of a language model doGenerate call.
  */
-type LanguageModelV3GenerateResult = {
+type LanguageModelV4GenerateResult = {
   /**
    * Ordered content that the model has generated.
    */
-  content: Array<LanguageModelV3Content>;
+  content: Array<LanguageModelV4Content>;
   /**
    * The finish reason.
    */
-  finishReason: LanguageModelV3FinishReason;
+  finishReason: LanguageModelV4FinishReason;
   /**
    * The usage information.
    */
-  usage: LanguageModelV3Usage;
+  usage: LanguageModelV4Usage;
   /**
    * Additional provider-specific metadata. They are passed through
    * from the provider to the AI SDK and enable provider-specific
    * results that can be fully encapsulated in the provider.
    */
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   /**
    * Optional request information for telemetry and debugging purposes.
    */
@@ -954,11 +1069,11 @@ type LanguageModelV3GenerateResult = {
   /**
    * Optional response information for telemetry and debugging purposes.
    */
-  response?: LanguageModelV3ResponseMetadata & {
+  response?: LanguageModelV4ResponseMetadata & {
     /**
      * Response headers.
      */
-    headers?: SharedV3Headers;
+    headers?: SharedV4Headers;
     /**
      * Response HTTP body.
      */
@@ -967,39 +1082,39 @@ type LanguageModelV3GenerateResult = {
   /**
    * Warnings for the call, e.g. unsupported settings.
    */
-  warnings: Array<SharedV3Warning>;
+  warnings: Array<SharedV4Warning>;
 };
-type LanguageModelV3StreamPart = {
+type LanguageModelV4StreamPart = {
   type: 'text-start';
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   id: string;
 } | {
   type: 'text-delta';
   id: string;
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   delta: string;
 } | {
   type: 'text-end';
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   id: string;
 } | {
   type: 'reasoning-start';
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   id: string;
 } | {
   type: 'reasoning-delta';
   id: string;
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   delta: string;
 } | {
   type: 'reasoning-end';
   id: string;
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 } | {
   type: 'tool-input-start';
   id: string;
   toolName: string;
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
   providerExecuted?: boolean;
   dynamic?: boolean;
   title?: string;
@@ -1007,21 +1122,21 @@ type LanguageModelV3StreamPart = {
   type: 'tool-input-delta';
   id: string;
   delta: string;
-  providerMetadata?: SharedV3ProviderMetadata;
+  providerMetadata?: SharedV4ProviderMetadata;
 } | {
   type: 'tool-input-end';
   id: string;
-  providerMetadata?: SharedV3ProviderMetadata;
-} | LanguageModelV3ToolApprovalRequest | LanguageModelV3ToolCall | LanguageModelV3ToolResult | LanguageModelV3File | LanguageModelV3Source | {
+  providerMetadata?: SharedV4ProviderMetadata;
+} | LanguageModelV4ToolApprovalRequest | LanguageModelV4ToolCall | LanguageModelV4ToolResult | LanguageModelV4CustomContent | LanguageModelV4File | LanguageModelV4ReasoningFile | LanguageModelV4Source | {
   type: 'stream-start';
-  warnings: Array<SharedV3Warning>;
+  warnings: Array<SharedV4Warning>;
 } | ({
   type: 'response-metadata';
-} & LanguageModelV3ResponseMetadata) | {
+} & LanguageModelV4ResponseMetadata) | {
   type: 'finish';
-  usage: LanguageModelV3Usage;
-  finishReason: LanguageModelV3FinishReason;
-  providerMetadata?: SharedV3ProviderMetadata;
+  usage: LanguageModelV4Usage;
+  finishReason: LanguageModelV4FinishReason;
+  providerMetadata?: SharedV4ProviderMetadata;
 } | {
   type: 'raw';
   rawValue: unknown;
@@ -1032,11 +1147,11 @@ type LanguageModelV3StreamPart = {
 /**
  * The result of a language model doStream call.
  */
-type LanguageModelV3StreamResult = {
+type LanguageModelV4StreamResult = {
   /**
    * The stream.
    */
-  stream: ReadableStream<LanguageModelV3StreamPart>;
+  stream: ReadableStream<LanguageModelV4StreamPart>;
   /**
    * Optional request information for telemetry and debugging purposes.
    */
@@ -1053,17 +1168,17 @@ type LanguageModelV3StreamResult = {
     /**
      * Response headers.
      */
-    headers?: SharedV3Headers;
+    headers?: SharedV4Headers;
   };
 };
 /**
- * Specification for a language model that implements the language model interface version 3.
+ * Specification for a language model that implements the language model interface version 4.
  */
-type LanguageModelV3 = {
+type LanguageModelV4 = {
   /**
    * The language model must specify which language model interface version it implements.
    */
-  readonly specificationVersion: 'v3';
+  readonly specificationVersion: 'v4';
   /**
    * Provider ID.
    */
@@ -1087,10 +1202,11 @@ 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
+   *
+   * Naming: "do" prefix to prevent accidental direct usage of the method
    * by the user.
    */
-  doGenerate(options: LanguageModelV3CallOptions): PromiseLike<LanguageModelV3GenerateResult>;
+  doGenerate(options: LanguageModelV4CallOptions): PromiseLike<LanguageModelV4GenerateResult>;
   /**
    * Generates a language model output (streaming).
    *
@@ -1099,13 +1215,8 @@ type LanguageModelV3 = {
    *
    * @return A stream of higher-level language model output parts.
    */
-  doStream(options: LanguageModelV3CallOptions): PromiseLike<LanguageModelV3StreamResult>;
+  doStream(options: LanguageModelV4CallOptions): PromiseLike<LanguageModelV4StreamResult>;
 };
-/**
- * Experimental middleware for LanguageModelV3.
- * This type defines the structure for middleware that can be used to modify
- * the behavior of LanguageModelV3 operations.
- */
 //#endregion
 //#region src/ports/observability.port.d.ts
 /**
@@ -1197,7 +1308,7 @@ interface ObservabilityMiddlewareOptions {
 /**
  * Helper to create type-safe observability metadata for providerOptions
  */
-declare function withObservability(meta: ObservabilityMetadata): SharedV3ProviderOptions;
+declare function withObservability(meta: ObservabilityMetadata): SharedV4ProviderOptions;
 /**
  * Creates middleware that sends generation data to an observability platform.
  */
@@ -1296,11 +1407,11 @@ declare function unwrapOr<T>(result: GenerationResult<T>, defaultValue: T): T;
 //#endregion
 //#region src/generation/generate-structured.d.ts
 interface GenerateStructuredOptions<T> {
-  model: LanguageModelV3;
+  model: LanguageModelV4;
   prompt: string;
   system?: string;
   schema: Schema<T>;
-  providerOptions?: SharedV3ProviderOptions;
+  providerOptions?: SharedV4ProviderOptions;
   abortSignal?: AbortSignal;
   maxOutputTokens?: number;
   temperature?: number;