@ai-sdk/provider 4.0.0-beta.9 → 4.0.0-canary.16

package/dist/index.d.ts

@@ -1,6 +1,69 @@
 import { JSONSchema7 } from 'json-schema';
 export { JSONSchema7, JSONSchema7Definition } from 'json-schema';
 
+/**
+ * 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>;
 
 /**
@@ -59,22 +122,6 @@ type SharedV4ProviderMetadata = Record<string, JSONObject>;
  */
 type SharedV4ProviderOptions = Record<string, JSONObject>;
 
-/**
- * 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"
- * }
- * ```
- */
-type SharedV4ProviderReference = Record<string, string>;
-
 /**
  * Warning from the model.
  *
@@ -846,55 +893,60 @@ declare class UnsupportedFunctionalityError extends AISDKError {
 }
 
 /**
- * Result of uploading a file via the files interface.
+ * Options for uploading a file via the files interface.
  */
-type FilesV4UploadFileResult = {
+type FilesV4UploadFileCallOptions = {
     /**
-     * A provider reference mapping provider names to provider-specific file identifiers.
+     * The file data.
+     *
+     * - `{ type: 'data', data }`: raw bytes (`Uint8Array`) or a base64-encoded string.
+     * - `{ type: 'text', text }`: inline text (UTF-8).
      */
-    providerReference: SharedV4ProviderReference;
+    data: SharedV4FileDataData | SharedV4FileDataText;
     /**
-     * The IANA media type of the uploaded file, if available from the provider.
+     * The IANA media type of the file (e.g. `'application/pdf'`).
      */
-    mediaType?: string;
+    mediaType: string;
     /**
-     * The filename of the uploaded file, if available from the provider.
+     * The filename of the file.
      */
     filename?: string;
     /**
-     * Additional provider-specific metadata. They are passed through
+     * 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;
-    /**
-     * Warnings from the provider.
-     */
-    warnings: Array<SharedV4Warning>;
+    providerOptions?: SharedV4ProviderOptions;
 };
+
 /**
- * Options for uploading a file via the files interface.
+ * Result of uploading a file via the files interface.
  */
-type FilesV4UploadFileCallOptions = {
+type FilesV4UploadFileResult = {
     /**
-     * The file data as raw bytes or a base64-encoded string.
+     * A provider reference mapping provider names to provider-specific file identifiers.
      */
-    data: Uint8Array | string;
+    providerReference: SharedV4ProviderReference;
     /**
-     * The IANA media type of the file (e.g. `'application/pdf'`).
+     * The IANA media type of the uploaded file, if available from the provider.
      */
-    mediaType: string;
+    mediaType?: string;
     /**
-     * The filename of the file.
+     * The filename of the uploaded file, if available from the provider.
      */
     filename?: string;
     /**
-     * Additional provider-specific options. They are passed through
+     * Additional provider-specific metadata. 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;
+    providerMetadata?: SharedV4ProviderMetadata;
+    /**
+     * Warnings from the provider.
+     */
+    warnings: Array<SharedV4Warning>;
 };
+
 /**
  * Specification for a file management interface that implements the files interface version 4.
  */
@@ -914,28 +966,6 @@ type FilesV4 = {
     uploadFile(options: FilesV4UploadFileCallOptions): PromiseLike<FilesV4UploadFileResult>;
 };
 
-declare function isJSONValue(value: unknown): value is JSONValue;
-declare function isJSONArray(value: unknown): value is JSONArray;
-declare function isJSONObject(value: unknown): value is JSONObject;
-
-/**
- * Usage information for an image model call.
- */
-type ImageModelV4Usage = {
-    /**
-     * The number of input (prompt) tokens used.
-     */
-    inputTokens: number | undefined;
-    /**
-     * The number of output tokens used, if reported by the provider.
-     */
-    outputTokens: number | undefined;
-    /**
-     * The total number of tokens as reported by the provider.
-     */
-    totalTokens: number | undefined;
-};
-
 /**
  * An image file that can be used for image editing or variation generation.
  */
@@ -1035,9 +1065,88 @@ type ImageModelV4CallOptions = {
     headers?: Record<string, string | undefined>;
 };
 
+declare function isJSONValue(value: unknown): value is JSONValue;
+declare function isJSONArray(value: unknown): value is JSONArray;
+declare function isJSONObject(value: unknown): value is JSONObject;
+
+/**
+ * Usage information for an image model call.
+ */
+type ImageModelV4Usage = {
+    /**
+     * The number of input (prompt) tokens used.
+     */
+    inputTokens: number | undefined;
+    /**
+     * The number of output tokens used, if reported by the provider.
+     */
+    outputTokens: number | undefined;
+    /**
+     * The total number of tokens as reported by the provider.
+     */
+    totalTokens: number | undefined;
+};
+
 type ImageModelV4ProviderMetadata = Record<string, {
     images: JSONArray;
 } & JSONValue>;
+/**
+ * The result of an image model doGenerate call.
+ */
+type ImageModelV4Result = {
+    /**
+     * Generated images as base64 encoded strings or binary data.
+     * The images should be returned without any unnecessary conversion.
+     * If the API returns base64 encoded strings, the images should be returned
+     * as base64 encoded strings. If the API returns binary data, the images should
+     * be returned as binary data.
+     */
+    images: Array<string> | Array<Uint8Array>;
+    /**
+     * Warnings for the call, e.g. unsupported features.
+     */
+    warnings: Array<SharedV4Warning>;
+    /**
+     * 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.
+     *
+     * The outer record is keyed by the provider name, and the inner
+     * record is provider-specific metadata. It always includes an
+     * `images` key with image-specific metadata
+     *
+     * ```ts
+     * {
+     * "openai": {
+     * "images": ["revisedPrompt": "Revised prompt here."]
+     * }
+     * }
+     * ```
+     */
+    providerMetadata?: ImageModelV4ProviderMetadata;
+    /**
+     * Response information for telemetry and debugging purposes.
+     */
+    response: {
+        /**
+         * Timestamp for the start of the generated response.
+         */
+        timestamp: Date;
+        /**
+         * The ID of the response model that was used to generate the response.
+         */
+        modelId: string;
+        /**
+         * Response headers.
+         */
+        headers: Record<string, string> | undefined;
+    };
+    /**
+     * Optional token usage for the image generation call (if the provider reports it).
+     */
+    usage?: ImageModelV4Usage;
+};
+
 type GetMaxImagesPerCallFunction$2 = (options: {
     modelId: string;
 }) => PromiseLike<number | undefined> | number | undefined;
@@ -1071,59 +1180,7 @@ type ImageModelV4 = {
     /**
      * Generates an array of images.
      */
-    doGenerate(options: ImageModelV4CallOptions): PromiseLike<{
-        /**
-         * Generated images as base64 encoded strings or binary data.
-         * The images should be returned without any unnecessary conversion.
-         * If the API returns base64 encoded strings, the images should be returned
-         * as base64 encoded strings. If the API returns binary data, the images should
-         * be returned as binary data.
-         */
-        images: Array<string> | Array<Uint8Array>;
-        /**
-         * Warnings for the call, e.g. unsupported features.
-         */
-        warnings: Array<SharedV4Warning>;
-        /**
-         * 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.
-         *
-         * The outer record is keyed by the provider name, and the inner
-         * record is provider-specific metadata. It always includes an
-         * `images` key with image-specific metadata
-         *
-         * ```ts
-         * {
-         * "openai": {
-         * "images": ["revisedPrompt": "Revised prompt here."]
-         * }
-         * }
-         * ```
-         */
-        providerMetadata?: ImageModelV4ProviderMetadata;
-        /**
-         * Response information for telemetry and debugging purposes.
-         */
-        response: {
-            /**
-             * Timestamp for the start of the generated response.
-             */
-            timestamp: Date;
-            /**
-             * The ID of the response model that was used to generate the response.
-             */
-            modelId: string;
-            /**
-             * Response headers.
-             */
-            headers: Record<string, string> | undefined;
-        };
-        /**
-         * Optional token usage for the image generation call (if the provider reports it).
-         */
-        usage?: ImageModelV4Usage;
-    }>;
+    doGenerate(options: ImageModelV4CallOptions): PromiseLike<ImageModelV4Result>;
 };
 
 /**
@@ -1648,11 +1705,6 @@ type LanguageModelV4FunctionTool = {
     providerOptions?: SharedV4ProviderOptions;
 };
 
-/**
- * Data content. Can be a Uint8Array, base64 encoded data as a string or a URL.
- */
-type LanguageModelV4DataContent = Uint8Array | string | URL;
-
 /**
  * A prompt is a list of messages.
  *
@@ -1721,9 +1773,12 @@ interface LanguageModelV4ReasoningPart {
 interface LanguageModelV4ReasoningFilePart {
     type: 'reasoning-file';
     /**
-     * File data. Can be a Uint8Array or base64 encoded data as a 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.
      */
-    data: LanguageModelV4DataContent;
+    data: SharedV4FileDataData | SharedV4FileDataUrl;
     /**
      * IANA media type of the file.
      *
@@ -1764,14 +1819,23 @@ interface LanguageModelV4FilePart {
      */
     filename?: string;
     /**
-     * File data. Can be a Uint8Array, base64 encoded data as a string, a URL,
-     * or a provider reference mapping provider names to provider-specific file IDs.
+     * 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: LanguageModelV4DataContent | SharedV4ProviderReference;
+    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
      */
@@ -1921,13 +1985,26 @@ type LanguageModelV4ToolResultOutput = {
          */
         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;
@@ -1940,77 +2017,11 @@ type LanguageModelV4ToolResultOutput = {
          */
         providerOptions?: SharedV4ProviderOptions;
     } | {
-        type: 'file-url';
-        /**
-         * URL of the file.
-         */
-        url: string;
-        /**
-         * Provider-specific options.
-         */
-        providerOptions?: SharedV4ProviderOptions;
-    } | {
-        type: 'file-reference';
         /**
-         * Provider-specific references for the file.
-         * The key is the provider name, e.g. 'openai' or 'anthropic'.
+         * Custom content part. This can be used to implement
+         * provider-specific content parts.
          */
-        providerReference: SharedV4ProviderReference;
-        /**
-         * Provider-specific options.
-         */
-        providerOptions?: SharedV4ProviderOptions;
-    } | {
-        /**
-         * 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?: SharedV4ProviderOptions;
-    } | {
-        /**
-         * Images that are referenced using a URL.
-         */
-        type: 'image-url';
-        /**
-         * URL of the image.
-         */
-        url: string;
-        /**
-         * Provider-specific options.
-         */
-        providerOptions?: SharedV4ProviderOptions;
-    } | {
-        /**
-         * Images that are referenced using a provider reference.
-         */
-        type: 'image-file-reference';
-        /**
-         * Provider-specific references for the image file.
-         * The key is the provider name, e.g. 'openai' or 'anthropic'.
-         */
-        providerReference: SharedV4ProviderReference;
-        /**
-         * Provider-specific options.
-         */
-        providerOptions?: SharedV4ProviderOptions;
-    } | {
-        /**
-         * Custom content part. This can be used to implement
-         * provider-specific content parts.
-         */
-        type: 'custom';
+        type: 'custom';
         /**
          * Provider-specific options.
          */
@@ -2193,14 +2204,17 @@ type LanguageModelV4File = {
      */
     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.
      */
@@ -2233,14 +2247,17 @@ type LanguageModelV4ReasoningFile = {
      */
     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 reasoning file part.
      */
@@ -4860,6 +4877,61 @@ type RerankingModelV4CallOptions = {
     headers?: SharedV4Headers;
 };
 
+/**
+ * The result of a reranking model doRerank call.
+ */
+type RerankingModelV4Result = {
+    /**
+     * Ordered list of reranked documents (via index before reranking).
+     * The documents are sorted by the descending order of relevance scores.
+     */
+    ranking: Array<{
+        /**
+         * The index of the document in the original list of documents before reranking.
+         */
+        index: number;
+        /**
+         * The relevance score of the document after reranking.
+         */
+        relevanceScore: number;
+    }>;
+    /**
+     * Additional provider-specific metadata. 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;
+    /**
+     * Warnings for the call, e.g. unsupported settings.
+     */
+    warnings?: Array<SharedV4Warning>;
+    /**
+     * Optional response information for debugging purposes.
+     */
+    response?: {
+        /**
+         * ID for the generated response, if the provider sends one.
+         */
+        id?: string;
+        /**
+         * Timestamp for the start of the generated response, if the provider sends one.
+         */
+        timestamp?: Date;
+        /**
+         * The ID of the response model that was used to generate the response, if the provider sends one.
+         */
+        modelId?: string;
+        /**
+         * Response headers.
+         */
+        headers?: SharedV4Headers;
+        /**
+         * Response body.
+         */
+        body?: unknown;
+    };
+};
+
 /**
  * Specification for a reranking model that implements the reranking model interface version 3.
  */
@@ -4879,57 +4951,7 @@ type RerankingModelV4 = {
     /**
      * Reranking a list of documents using the query.
      */
-    doRerank(options: RerankingModelV4CallOptions): PromiseLike<{
-        /**
-         * Ordered list of reranked documents (via index before reranking).
-         * The documents are sorted by the descending order of relevance scores.
-         */
-        ranking: Array<{
-            /**
-             * The index of the document in the original list of documents before reranking.
-             */
-            index: number;
-            /**
-             * The relevance score of the document after reranking.
-             */
-            relevanceScore: number;
-        }>;
-        /**
-         * Additional provider-specific metadata. 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;
-        /**
-         * Warnings for the call, e.g. unsupported settings.
-         */
-        warnings?: Array<SharedV4Warning>;
-        /**
-         * Optional response information for debugging purposes.
-         */
-        response?: {
-            /**
-             * ID for the generated response, if the provider sends one.
-             */
-            id?: string;
-            /**
-             * Timestamp for the start of the generated response, if the provider sends one.
-             */
-            timestamp?: Date;
-            /**
-             * The ID of the response model that was used to generate the response, if the provider sends one.
-             */
-            modelId?: string;
-            /**
-             * Response headers.
-             */
-            headers?: SharedV4Headers;
-            /**
-             * Response body.
-             */
-            body?: unknown;
-        };
-    }>;
+    doRerank(options: RerankingModelV4CallOptions): PromiseLike<RerankingModelV4Result>;
 };
 
 type SpeechModelV4ProviderOptions = Record<string, JSONObject>;
@@ -4984,6 +5006,60 @@ type SpeechModelV4CallOptions = {
     headers?: Record<string, string | undefined>;
 };
 
+/**
+ * The result of a speech model doGenerate call.
+ */
+type SpeechModelV4Result = {
+    /**
+     * Generated audio as an ArrayBuffer.
+     * The audio should be returned without any unnecessary conversion.
+     * If the API returns base64 encoded strings, the audio should be returned
+     * as base64 encoded strings. If the API returns binary data, the audio
+     * should be returned as binary data.
+     */
+    audio: string | Uint8Array;
+    /**
+     * Warnings for the call, e.g. unsupported settings.
+     */
+    warnings: Array<SharedV4Warning>;
+    /**
+     * Optional request information for telemetry and debugging purposes.
+     */
+    request?: {
+        /**
+         * Response body (available only for providers that use HTTP requests).
+         */
+        body?: unknown;
+    };
+    /**
+     * Response information for telemetry and debugging purposes.
+     */
+    response: {
+        /**
+         * Timestamp for the start of the generated response.
+         */
+        timestamp: Date;
+        /**
+         * The ID of the response model that was used to generate the response.
+         */
+        modelId: string;
+        /**
+         * Response headers.
+         */
+        headers?: SharedV2Headers;
+        /**
+         * Response body.
+         */
+        body?: unknown;
+    };
+    /**
+     * 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?: Record<string, JSONObject>;
+};
+
 /**
  * Speech model specification version 3.
  */
@@ -5007,56 +5083,7 @@ type SpeechModelV4 = {
     /**
      * Generates speech audio from text.
      */
-    doGenerate(options: SpeechModelV4CallOptions): PromiseLike<{
-        /**
-         * Generated audio as an ArrayBuffer.
-         * The audio should be returned without any unnecessary conversion.
-         * If the API returns base64 encoded strings, the audio should be returned
-         * as base64 encoded strings. If the API returns binary data, the audio
-         * should be returned as binary data.
-         */
-        audio: string | Uint8Array;
-        /**
-         * Warnings for the call, e.g. unsupported settings.
-         */
-        warnings: Array<SharedV4Warning>;
-        /**
-         * Optional request information for telemetry and debugging purposes.
-         */
-        request?: {
-            /**
-             * Response body (available only for providers that use HTTP requests).
-             */
-            body?: unknown;
-        };
-        /**
-         * Response information for telemetry and debugging purposes.
-         */
-        response: {
-            /**
-             * Timestamp for the start of the generated response.
-             */
-            timestamp: Date;
-            /**
-             * The ID of the response model that was used to generate the response.
-             */
-            modelId: string;
-            /**
-             * Response headers.
-             */
-            headers?: SharedV2Headers;
-            /**
-             * Response body.
-             */
-            body?: unknown;
-        };
-        /**
-         * 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?: Record<string, JSONObject>;
-    }>;
+    doGenerate(options: SpeechModelV4CallOptions): PromiseLike<SpeechModelV4Result>;
 };
 
 type TranscriptionModelV4ProviderOptions = Record<string, JSONObject>;
@@ -5099,103 +5126,108 @@ type TranscriptionModelV4CallOptions = {
 };
 
 /**
- * Transcription model specification version 3.
+ * The result of a transcription model doGenerate call.
  */
-type TranscriptionModelV4 = {
-    /**
-     * The transcription model must specify which transcription model interface
-     * version it implements. This will allow us to evolve the transcription
-     * model interface and retain backwards compatibility. The different
-     * implementation versions can be handled as a discriminated union
-     * on our side.
-     */
-    readonly specificationVersion: 'v4';
-    /**
-     * Name of the provider for logging purposes.
-     */
-    readonly provider: string;
+type TranscriptionModelV4Result = {
     /**
-     * Provider-specific model ID for logging purposes.
+     * The complete transcribed text from the audio.
      */
-    readonly modelId: string;
+    text: string;
     /**
-     * Generates a transcript.
+     * Array of transcript segments with timing information.
+     * Each segment represents a portion of the transcribed text with start and end times.
      */
-    doGenerate(options: TranscriptionModelV4CallOptions): PromiseLike<{
+    segments: Array<{
         /**
-         * The complete transcribed text from the audio.
+         * The text content of this segment.
          */
         text: string;
         /**
-         * Array of transcript segments with timing information.
-         * Each segment represents a portion of the transcribed text with start and end times.
+         * The start time of this segment in seconds.
          */
-        segments: Array<{
-            /**
-             * The text content of this segment.
-             */
-            text: string;
-            /**
-             * The start time of this segment in seconds.
-             */
-            startSecond: number;
-            /**
-             * The end time of this segment in seconds.
-             */
-            endSecond: number;
-        }>;
+        startSecond: number;
         /**
-         * The detected language of the audio content, as an ISO-639-1 code (e.g., 'en' for English).
-         * May be undefined if the language couldn't be detected.
+         * The end time of this segment in seconds.
          */
-        language: string | undefined;
+        endSecond: number;
+    }>;
+    /**
+     * The detected language of the audio content, as an ISO-639-1 code (e.g., 'en' for English).
+     * May be undefined if the language couldn't be detected.
+     */
+    language: string | undefined;
+    /**
+     * The total duration of the audio file in seconds.
+     * May be undefined if the duration couldn't be determined.
+     */
+    durationInSeconds: number | undefined;
+    /**
+     * Warnings for the call, e.g. unsupported settings.
+     */
+    warnings: Array<SharedV4Warning>;
+    /**
+     * Optional request information for telemetry and debugging purposes.
+     */
+    request?: {
         /**
-         * The total duration of the audio file in seconds.
-         * May be undefined if the duration couldn't be determined.
+         * Raw request HTTP body that was sent to the provider API as a string (JSON should be stringified).
+         * Non-HTTP(s) providers should not set this.
          */
-        durationInSeconds: number | undefined;
+        body?: string;
+    };
+    /**
+     * Response information for telemetry and debugging purposes.
+     */
+    response: {
         /**
-         * Warnings for the call, e.g. unsupported settings.
+         * Timestamp for the start of the generated response.
          */
-        warnings: Array<SharedV4Warning>;
+        timestamp: Date;
         /**
-         * Optional request information for telemetry and debugging purposes.
+         * The ID of the response model that was used to generate the response.
          */
-        request?: {
-            /**
-             * Raw request HTTP body that was sent to the provider API as a string (JSON should be stringified).
-             * Non-HTTP(s) providers should not set this.
-             */
-            body?: string;
-        };
+        modelId: string;
         /**
-         * Response information for telemetry and debugging purposes.
+         * Response headers.
          */
-        response: {
-            /**
-             * Timestamp for the start of the generated 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;
-        };
+        headers?: SharedV4Headers;
         /**
-         * 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.
+         * Response body.
          */
-        providerMetadata?: Record<string, JSONObject>;
-    }>;
+        body?: unknown;
+    };
+    /**
+     * 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?: Record<string, JSONObject>;
+};
+
+/**
+ * Transcription model specification version 3.
+ */
+type TranscriptionModelV4 = {
+    /**
+     * The transcription model must specify which transcription model interface
+     * version it implements. This will allow us to evolve the transcription
+     * model interface and retain backwards compatibility. The different
+     * implementation versions can be handled as a discriminated union
+     * on our side.
+     */
+    readonly specificationVersion: 'v4';
+    /**
+     * Name of the provider for logging purposes.
+     */
+    readonly provider: string;
+    /**
+     * Provider-specific model ID for logging purposes.
+     */
+    readonly modelId: string;
+    /**
+     * Generates a transcript.
+     */
+    doGenerate(options: TranscriptionModelV4CallOptions): PromiseLike<TranscriptionModelV4Result>;
 };
 
 interface SkillsV4File {
@@ -5204,11 +5236,14 @@ interface SkillsV4File {
      */
     path: string;
     /**
-     * The content of the file, either as a base64 string or binary data.
+     * The file data.
+     *
+     * - `{ type: 'data', data }`: raw bytes (`Uint8Array`) or a base64-encoded string.
+     * - `{ type: 'text', text }`: inline text (UTF-8).
      */
-    content: string | Uint8Array;
+    data: SharedV4FileDataData | SharedV4FileDataText;
 }
-interface SkillsV4UploadParams {
+interface SkillsV4UploadSkillCallOptions {
     /**
      * The files that make up the skill.
      */
@@ -5222,7 +5257,8 @@ interface SkillsV4UploadParams {
      */
     providerOptions?: SharedV4ProviderOptions;
 }
-interface SkillsV4UploadResult {
+
+interface SkillsV4UploadSkillResult {
     /**
      * A provider reference mapping provider names to provider-specific skill identifiers.
      */
@@ -5252,6 +5288,7 @@ interface SkillsV4UploadResult {
      */
     warnings: SharedV4Warning[];
 }
+
 /**
  * Skills specification version 4.
  */
@@ -5271,7 +5308,7 @@ interface SkillsV4 {
     /**
      * Uploads a new skill from the given files.
      */
-    uploadSkill(params: SkillsV4UploadParams): PromiseLike<SkillsV4UploadResult>;
+    uploadSkill(params: SkillsV4UploadSkillCallOptions): PromiseLike<SkillsV4UploadSkillResult>;
 }
 
 /**
@@ -6256,9 +6293,6 @@ type VideoModelV4CallOptions = {
     headers?: Record<string, string | undefined>;
 };
 
-type GetMaxVideosPerCallFunction$1 = (options: {
-    modelId: string;
-}) => PromiseLike<number | undefined> | number | undefined;
 /**
  * Generated video data. Can be a URL, base64-encoded string, or binary data.
  */
@@ -6284,6 +6318,65 @@ type VideoModelV4VideoData = {
     data: Uint8Array;
     mediaType: string;
 };
+/**
+ * The result of a video model doGenerate call.
+ */
+type VideoModelV4Result = {
+    /**
+     * Generated videos as URLs, base64 strings, or binary data.
+     *
+     * Most providers return URLs to video files (MP4, WebM) due to large file sizes.
+     * Use the discriminated union to indicate the type of video data being returned.
+     */
+    videos: Array<VideoModelV4VideoData>;
+    /**
+     * Warnings for the call, e.g. unsupported features.
+     */
+    warnings: Array<SharedV4Warning>;
+    /**
+     * 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.
+     *
+     * The outer record is keyed by the provider name, and the inner
+     * record is provider-specific metadata.
+     *
+     * ```ts
+     * {
+     *   "fal": {
+     *     "videos": [{
+     *       "duration": 5.0,
+     *       "fps": 24,
+     *       "width": 1280,
+     *       "height": 720
+     *     }]
+     *   }
+     * }
+     * ```
+     */
+    providerMetadata?: SharedV4ProviderMetadata;
+    /**
+     * Response information for telemetry and debugging purposes.
+     */
+    response: {
+        /**
+         * Timestamp for the start of the generated response.
+         */
+        timestamp: Date;
+        /**
+         * The ID of the response model that was used to generate the response.
+         */
+        modelId: string;
+        /**
+         * Response headers.
+         */
+        headers: Record<string, string> | undefined;
+    };
+};
+
+type GetMaxVideosPerCallFunction$1 = (options: {
+    modelId: string;
+}) => PromiseLike<number | undefined> | number | undefined;
 /**
  * Video generation model specification version 3.
  */
@@ -6317,58 +6410,7 @@ type VideoModelV4 = {
     /**
      * Generates an array of videos.
      */
-    doGenerate(options: VideoModelV4CallOptions): PromiseLike<{
-        /**
-         * Generated videos as URLs, base64 strings, or binary data.
-         *
-         * Most providers return URLs to video files (MP4, WebM) due to large file sizes.
-         * Use the discriminated union to indicate the type of video data being returned.
-         */
-        videos: Array<VideoModelV4VideoData>;
-        /**
-         * Warnings for the call, e.g. unsupported features.
-         */
-        warnings: Array<SharedV4Warning>;
-        /**
-         * 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.
-         *
-         * The outer record is keyed by the provider name, and the inner
-         * record is provider-specific metadata.
-         *
-         * ```ts
-         * {
-         *   "fal": {
-         *     "videos": [{
-         *       "duration": 5.0,
-         *       "fps": 24,
-         *       "width": 1280,
-         *       "height": 720
-         *     }]
-         *   }
-         * }
-         * ```
-         */
-        providerMetadata?: SharedV4ProviderMetadata;
-        /**
-         * Response information for telemetry and debugging purposes.
-         */
-        response: {
-            /**
-             * Timestamp for the start of the generated response.
-             */
-            timestamp: Date;
-            /**
-             * The ID of the response model that was used to generate the response.
-             */
-            modelId: string;
-            /**
-             * Response headers.
-             */
-            headers: Record<string, string> | undefined;
-        };
-    }>;
+    doGenerate(options: VideoModelV4CallOptions): PromiseLike<VideoModelV4Result>;
 };
 
 /**
@@ -6587,4 +6629,4 @@ type VideoModelV3 = {
     }>;
 };
 
-export { AISDKError, APICallError, type EmbeddingModelV2, type EmbeddingModelV2Embedding, type EmbeddingModelV3, type EmbeddingModelV3CallOptions, type EmbeddingModelV3Embedding, type EmbeddingModelV3Middleware, type EmbeddingModelV3Result, type EmbeddingModelV4, type EmbeddingModelV4CallOptions, type EmbeddingModelV4Embedding, type EmbeddingModelV4Middleware, type EmbeddingModelV4Result, EmptyResponseBodyError, type VideoModelV3 as Experimental_VideoModelV3, type VideoModelV3CallOptions as Experimental_VideoModelV3CallOptions, type VideoModelV3File as Experimental_VideoModelV3File, type VideoModelV3VideoData as Experimental_VideoModelV3VideoData, type VideoModelV4 as Experimental_VideoModelV4, type VideoModelV4CallOptions as Experimental_VideoModelV4CallOptions, type VideoModelV4File as Experimental_VideoModelV4File, type VideoModelV4VideoData as Experimental_VideoModelV4VideoData, type FilesV4, type FilesV4UploadFileCallOptions, type FilesV4UploadFileResult, type ImageModelV2, type ImageModelV2CallOptions, type ImageModelV2CallWarning, type ImageModelV2ProviderMetadata, type ImageModelV3, type ImageModelV3CallOptions, type ImageModelV3File, type ImageModelV3Middleware, type ImageModelV3ProviderMetadata, type ImageModelV3Usage, type ImageModelV4, type ImageModelV4CallOptions, type ImageModelV4File, type ImageModelV4Middleware, type ImageModelV4ProviderMetadata, type ImageModelV4Usage, InvalidArgumentError, InvalidPromptError, InvalidResponseDataError, type JSONArray, type JSONObject, JSONParseError, type JSONValue, type LanguageModelV2, type LanguageModelV2CallOptions, type LanguageModelV2CallWarning, type LanguageModelV2Content, type LanguageModelV2DataContent, type LanguageModelV2File, type LanguageModelV2FilePart, type LanguageModelV2FinishReason, type LanguageModelV2FunctionTool, type LanguageModelV2Message, type LanguageModelV2Middleware, type LanguageModelV2Prompt, type LanguageModelV2ProviderDefinedTool, type LanguageModelV2Reasoning, type LanguageModelV2ReasoningPart, type LanguageModelV2ResponseMetadata, type LanguageModelV2Source, type LanguageModelV2StreamPart, type LanguageModelV2Text, type LanguageModelV2TextPart, type LanguageModelV2ToolCall, type LanguageModelV2ToolCallPart, type LanguageModelV2ToolChoice, type LanguageModelV2ToolResultOutput, type LanguageModelV2ToolResultPart, type LanguageModelV2Usage, type LanguageModelV3, type LanguageModelV3CallOptions, type LanguageModelV3Content, type LanguageModelV3DataContent, type LanguageModelV3File, type LanguageModelV3FilePart, type LanguageModelV3FinishReason, type LanguageModelV3FunctionTool, type LanguageModelV3GenerateResult, type LanguageModelV3Message, type LanguageModelV3Middleware, type LanguageModelV3Prompt, type LanguageModelV3ProviderTool, type LanguageModelV3Reasoning, type LanguageModelV3ReasoningPart, type LanguageModelV3ResponseMetadata, type LanguageModelV3Source, type LanguageModelV3StreamPart, type LanguageModelV3StreamResult, type LanguageModelV3Text, type LanguageModelV3TextPart, type LanguageModelV3ToolApprovalRequest, type LanguageModelV3ToolApprovalResponsePart, type LanguageModelV3ToolCall, type LanguageModelV3ToolCallPart, type LanguageModelV3ToolChoice, type LanguageModelV3ToolResult, type LanguageModelV3ToolResultOutput, type LanguageModelV3ToolResultPart, type LanguageModelV3Usage, type LanguageModelV4, type LanguageModelV4CallOptions, type LanguageModelV4Content, type LanguageModelV4CustomContent, type LanguageModelV4CustomPart, type LanguageModelV4DataContent, type LanguageModelV4File, type LanguageModelV4FilePart, type LanguageModelV4FinishReason, type LanguageModelV4FunctionTool, type LanguageModelV4GenerateResult, type LanguageModelV4Message, type LanguageModelV4Middleware, type LanguageModelV4Prompt, type LanguageModelV4ProviderTool, type LanguageModelV4Reasoning, type LanguageModelV4ReasoningFile, type LanguageModelV4ReasoningFilePart, type LanguageModelV4ReasoningPart, type LanguageModelV4ResponseMetadata, type LanguageModelV4Source, type LanguageModelV4StreamPart, type LanguageModelV4StreamResult, type LanguageModelV4Text, type LanguageModelV4TextPart, type LanguageModelV4ToolApprovalRequest, type LanguageModelV4ToolApprovalResponsePart, type LanguageModelV4ToolCall, type LanguageModelV4ToolCallPart, type LanguageModelV4ToolChoice, type LanguageModelV4ToolResult, type LanguageModelV4ToolResultOutput, type LanguageModelV4ToolResultPart, type LanguageModelV4Usage, LoadAPIKeyError, LoadSettingError, NoContentGeneratedError, NoSuchModelError, NoSuchProviderReferenceError, type ProviderV2, type ProviderV3, type ProviderV4, type RerankingModelV3, type RerankingModelV3CallOptions, type RerankingModelV4, type RerankingModelV4CallOptions, type SharedV2Headers, type SharedV2ProviderMetadata, type SharedV2ProviderOptions, type SharedV3Headers, type SharedV3ProviderMetadata, type SharedV3ProviderOptions, type SharedV3Warning, type SharedV4Headers, type SharedV4ProviderMetadata, type SharedV4ProviderOptions, type SharedV4ProviderReference, type SharedV4Warning, type SkillsV4, type SkillsV4File, type SkillsV4UploadParams, type SkillsV4UploadResult, type SpeechModelV2, type SpeechModelV2CallOptions, type SpeechModelV2CallWarning, type SpeechModelV3, type SpeechModelV3CallOptions, type SpeechModelV4, type SpeechModelV4CallOptions, TooManyEmbeddingValuesForCallError, type TranscriptionModelV2, type TranscriptionModelV2CallOptions, type TranscriptionModelV2CallWarning, type TranscriptionModelV3, type TranscriptionModelV3CallOptions, type TranscriptionModelV4, type TranscriptionModelV4CallOptions, type TypeValidationContext, TypeValidationError, UnsupportedFunctionalityError, getErrorMessage, isJSONArray, isJSONObject, isJSONValue };
+export { AISDKError, APICallError, type EmbeddingModelV2, type EmbeddingModelV2Embedding, type EmbeddingModelV3, type EmbeddingModelV3CallOptions, type EmbeddingModelV3Embedding, type EmbeddingModelV3Middleware, type EmbeddingModelV3Result, type EmbeddingModelV4, type EmbeddingModelV4CallOptions, type EmbeddingModelV4Embedding, type EmbeddingModelV4Middleware, type EmbeddingModelV4Result, EmptyResponseBodyError, type VideoModelV3 as Experimental_VideoModelV3, type VideoModelV3CallOptions as Experimental_VideoModelV3CallOptions, type VideoModelV3File as Experimental_VideoModelV3File, type VideoModelV3VideoData as Experimental_VideoModelV3VideoData, type VideoModelV4 as Experimental_VideoModelV4, type VideoModelV4CallOptions as Experimental_VideoModelV4CallOptions, type VideoModelV4File as Experimental_VideoModelV4File, type VideoModelV4Result as Experimental_VideoModelV4Result, type VideoModelV4VideoData as Experimental_VideoModelV4VideoData, type FilesV4, type FilesV4UploadFileCallOptions, type FilesV4UploadFileResult, type ImageModelV2, type ImageModelV2CallOptions, type ImageModelV2CallWarning, type ImageModelV2ProviderMetadata, type ImageModelV3, type ImageModelV3CallOptions, type ImageModelV3File, type ImageModelV3Middleware, type ImageModelV3ProviderMetadata, type ImageModelV3Usage, type ImageModelV4, type ImageModelV4CallOptions, type ImageModelV4File, type ImageModelV4Middleware, type ImageModelV4ProviderMetadata, type ImageModelV4Result, type ImageModelV4Usage, InvalidArgumentError, InvalidPromptError, InvalidResponseDataError, type JSONArray, type JSONObject, JSONParseError, type JSONValue, type LanguageModelV2, type LanguageModelV2CallOptions, type LanguageModelV2CallWarning, type LanguageModelV2Content, type LanguageModelV2DataContent, type LanguageModelV2File, type LanguageModelV2FilePart, type LanguageModelV2FinishReason, type LanguageModelV2FunctionTool, type LanguageModelV2Message, type LanguageModelV2Middleware, type LanguageModelV2Prompt, type LanguageModelV2ProviderDefinedTool, type LanguageModelV2Reasoning, type LanguageModelV2ReasoningPart, type LanguageModelV2ResponseMetadata, type LanguageModelV2Source, type LanguageModelV2StreamPart, type LanguageModelV2Text, type LanguageModelV2TextPart, type LanguageModelV2ToolCall, type LanguageModelV2ToolCallPart, type LanguageModelV2ToolChoice, type LanguageModelV2ToolResultOutput, type LanguageModelV2ToolResultPart, type LanguageModelV2Usage, type LanguageModelV3, type LanguageModelV3CallOptions, type LanguageModelV3Content, type LanguageModelV3DataContent, type LanguageModelV3File, type LanguageModelV3FilePart, type LanguageModelV3FinishReason, type LanguageModelV3FunctionTool, type LanguageModelV3GenerateResult, type LanguageModelV3Message, type LanguageModelV3Middleware, type LanguageModelV3Prompt, type LanguageModelV3ProviderTool, type LanguageModelV3Reasoning, type LanguageModelV3ReasoningPart, type LanguageModelV3ResponseMetadata, type LanguageModelV3Source, type LanguageModelV3StreamPart, type LanguageModelV3StreamResult, type LanguageModelV3Text, type LanguageModelV3TextPart, type LanguageModelV3ToolApprovalRequest, type LanguageModelV3ToolApprovalResponsePart, type LanguageModelV3ToolCall, type LanguageModelV3ToolCallPart, type LanguageModelV3ToolChoice, type LanguageModelV3ToolResult, type LanguageModelV3ToolResultOutput, type LanguageModelV3ToolResultPart, type LanguageModelV3Usage, type LanguageModelV4, type LanguageModelV4CallOptions, type LanguageModelV4Content, type LanguageModelV4CustomContent, type LanguageModelV4CustomPart, type LanguageModelV4File, type LanguageModelV4FilePart, type LanguageModelV4FinishReason, type LanguageModelV4FunctionTool, type LanguageModelV4GenerateResult, type LanguageModelV4Message, type LanguageModelV4Middleware, type LanguageModelV4Prompt, type LanguageModelV4ProviderTool, type LanguageModelV4Reasoning, type LanguageModelV4ReasoningFile, type LanguageModelV4ReasoningFilePart, type LanguageModelV4ReasoningPart, type LanguageModelV4ResponseMetadata, type LanguageModelV4Source, type LanguageModelV4StreamPart, type LanguageModelV4StreamResult, type LanguageModelV4Text, type LanguageModelV4TextPart, type LanguageModelV4ToolApprovalRequest, type LanguageModelV4ToolApprovalResponsePart, type LanguageModelV4ToolCall, type LanguageModelV4ToolCallPart, type LanguageModelV4ToolChoice, type LanguageModelV4ToolResult, type LanguageModelV4ToolResultOutput, type LanguageModelV4ToolResultPart, type LanguageModelV4Usage, LoadAPIKeyError, LoadSettingError, NoContentGeneratedError, NoSuchModelError, NoSuchProviderReferenceError, type ProviderV2, type ProviderV3, type ProviderV4, type RerankingModelV3, type RerankingModelV3CallOptions, type RerankingModelV4, type RerankingModelV4CallOptions, type RerankingModelV4Result, type SharedV2Headers, type SharedV2ProviderMetadata, type SharedV2ProviderOptions, type SharedV3Headers, type SharedV3ProviderMetadata, type SharedV3ProviderOptions, type SharedV3Warning, type SharedV4FileData, type SharedV4FileDataData, type SharedV4FileDataReference, type SharedV4FileDataText, type SharedV4FileDataUrl, type SharedV4Headers, type SharedV4ProviderMetadata, type SharedV4ProviderOptions, type SharedV4ProviderReference, type SharedV4Warning, type SkillsV4, type SkillsV4File, type SkillsV4UploadSkillCallOptions, type SkillsV4UploadSkillResult, type SpeechModelV2, type SpeechModelV2CallOptions, type SpeechModelV2CallWarning, type SpeechModelV3, type SpeechModelV3CallOptions, type SpeechModelV4, type SpeechModelV4CallOptions, type SpeechModelV4Result, TooManyEmbeddingValuesForCallError, type TranscriptionModelV2, type TranscriptionModelV2CallOptions, type TranscriptionModelV2CallWarning, type TranscriptionModelV3, type TranscriptionModelV3CallOptions, type TranscriptionModelV4, type TranscriptionModelV4CallOptions, type TranscriptionModelV4Result, type TypeValidationContext, TypeValidationError, UnsupportedFunctionalityError, getErrorMessage, isJSONArray, isJSONObject, isJSONValue };