@ai-sdk/provider 4.0.8 → 4.0.10

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @ai-sdk/provider
 
+## 4.0.10
+
+### Patch Changes
+
+- 5190b67: feat(provider): extend the FilesV4 interface with optional `getFileMetadata`, `downloadFile` (streaming), and `deleteFile` operations, plus `abortSignal`/`headers` call options and a `{ type: 'stream' }` upload data variant; upload results now expose `byteSize`, `createdAt`, and `expiresAt` (also surfaced by the core `uploadFile()` helper, which now forwards `abortSignal`/`headers`); add `postMultipartStreamToApi` (streaming multipart uploads with deterministic part ordering and failure-path stream teardown), `deleteFromApi`, and `createBinaryStreamResponseHandler` to provider-utils
+
+## 4.0.9
+
+### Patch Changes
+
+- aa45741: fix(provider/anthropic): preserve native message batch request counts in provider metadata and support the full language-model option surface in batch requests
+
 ## 4.0.8
 
 ### Patch Changes

package/dist/index.d.ts

@@ -994,6 +994,183 @@ declare class UnsupportedFunctionalityError extends AISDKError {
     static isInstance(error: unknown): error is UnsupportedFunctionalityError;
 }
 
+/**
+ * Options for deleting a file via the files interface.
+ */
+type FilesV4DeleteFileCallOptions = {
+    /**
+     * The provider reference of the file, as returned by `uploadFile`.
+     */
+    file: SharedV4ProviderReference;
+    /**
+     * Abort signal for cancelling the operation.
+     */
+    abortSignal?: AbortSignal;
+    /**
+     * Additional HTTP headers to be sent with the request.
+     * Only applicable for HTTP-based providers.
+     */
+    headers?: Record<string, string | undefined>;
+    /**
+     * 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;
+};
+
+/**
+ * Result of deleting a file via the files interface.
+ */
+type FilesV4DeleteFileResult = {
+    /**
+     * A provider reference mapping provider names to provider-specific file identifiers.
+     * Contains only the operated provider's entry — when working with a merged
+     * multi-provider reference, do not reassign it with this result.
+     */
+    providerReference: SharedV4ProviderReference;
+    /**
+     * Whether the provider confirmed the deletion.
+     */
+    deleted: boolean;
+    /**
+     * 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 from the provider.
+     */
+    warnings: Array<SharedV4Warning>;
+};
+
+/**
+ * Options for downloading file content via the files interface.
+ */
+type FilesV4DownloadFileCallOptions = {
+    /**
+     * The provider reference of the file, as returned by `uploadFile`.
+     */
+    file: SharedV4ProviderReference;
+    /**
+     * Abort signal for cancelling the operation.
+     */
+    abortSignal?: AbortSignal;
+    /**
+     * Additional HTTP headers to be sent with the request.
+     * Only applicable for HTTP-based providers.
+     */
+    headers?: Record<string, string | undefined>;
+    /**
+     * 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;
+};
+
+/**
+ * Result of downloading file content via the files interface.
+ */
+type FilesV4DownloadFileResult = {
+    /**
+     * The file content as a byte stream.
+     * The consumer is responsible for draining or cancelling the stream.
+     */
+    content: ReadableStream<Uint8Array>;
+    /**
+     * The IANA media type of the file, if available from the provider.
+     */
+    mediaType?: string;
+    /**
+     * 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 from the provider.
+     */
+    warnings: Array<SharedV4Warning>;
+};
+
+/**
+ * Options for retrieving file metadata via the files interface.
+ */
+type FilesV4GetFileMetadataCallOptions = {
+    /**
+     * The provider reference of the file, as returned by `uploadFile`.
+     */
+    file: SharedV4ProviderReference;
+    /**
+     * Abort signal for cancelling the operation.
+     */
+    abortSignal?: AbortSignal;
+    /**
+     * Additional HTTP headers to be sent with the request.
+     * Only applicable for HTTP-based providers.
+     */
+    headers?: Record<string, string | undefined>;
+    /**
+     * 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;
+};
+
+/**
+ * Result of retrieving file metadata via the files interface.
+ */
+type FilesV4GetFileMetadataResult = {
+    /**
+     * A provider reference mapping provider names to provider-specific file identifiers.
+     * Contains only the operated provider's entry — when working with a merged
+     * multi-provider reference, do not reassign it with this result.
+     */
+    providerReference: SharedV4ProviderReference;
+    /**
+     * The filename of the file, if available from the provider.
+     */
+    filename?: string;
+    /**
+     * The IANA media type of the file, if available from the provider.
+     */
+    mediaType?: string;
+    /**
+     * The size of the file in bytes, if available from the provider.
+     */
+    byteSize?: number;
+    /**
+     * When the file was created, if available from the provider.
+     */
+    createdAt?: Date;
+    /**
+     * When the provider will delete the file (retention expiry),
+     * if available from the provider.
+     */
+    expiresAt?: Date;
+    /**
+     * 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 from the provider.
+     */
+    warnings: Array<SharedV4Warning>;
+};
+
+/**
+ * File data variant containing a byte stream. Providers that support
+ * streaming uploads send it without buffering the full file in memory.
+ */
+interface FilesV4UploadFileStreamData {
+    type: 'stream';
+    stream: ReadableStream<Uint8Array>;
+}
 /**
  * Options for uploading a file via the files interface.
  */
@@ -1003,8 +1180,10 @@ type FilesV4UploadFileCallOptions = {
      *
      * - `{ type: 'data', data }`: raw bytes (`Uint8Array`) or a base64-encoded string.
      * - `{ type: 'text', text }`: inline text (UTF-8).
+     * - `{ type: 'stream', stream }`: a byte stream (not buffered by providers
+     *   that support streaming uploads).
      */
-    data: SharedV4FileDataData | SharedV4FileDataText;
+    data: SharedV4FileDataData | SharedV4FileDataText | FilesV4UploadFileStreamData;
     /**
      * The IANA media type of the file (e.g. `'application/pdf'`).
      */
@@ -1013,6 +1192,15 @@ type FilesV4UploadFileCallOptions = {
      * The filename of the file.
      */
     filename?: string;
+    /**
+     * Abort signal for cancelling the operation.
+     */
+    abortSignal?: AbortSignal;
+    /**
+     * Additional HTTP headers to be sent with the request.
+     * Only applicable for HTTP-based providers.
+     */
+    headers?: Record<string, string | undefined>;
     /**
      * Additional provider-specific options. They are passed through
      * to the provider from the AI SDK and enable provider-specific
@@ -1027,6 +1215,8 @@ type FilesV4UploadFileCallOptions = {
 type FilesV4UploadFileResult = {
     /**
      * A provider reference mapping provider names to provider-specific file identifiers.
+     * The key is the canonical provider name (e.g. `openai`) and may differ from
+     * the interface's `provider` id (e.g. `openai.files`).
      */
     providerReference: SharedV4ProviderReference;
     /**
@@ -1037,6 +1227,19 @@ type FilesV4UploadFileResult = {
      * The filename of the uploaded file, if available from the provider.
      */
     filename?: string;
+    /**
+     * The size of the uploaded file in bytes, if available from the provider.
+     */
+    byteSize?: number;
+    /**
+     * When the file was created, if available from the provider.
+     */
+    createdAt?: Date;
+    /**
+     * When the provider will delete the file (retention expiry, e.g. from a
+     * requested upload TTL), if available from the provider.
+     */
+    expiresAt?: Date;
     /**
      * Additional provider-specific metadata. They are passed through
      * to the provider from the AI SDK and enable provider-specific
@@ -1051,6 +1254,10 @@ type FilesV4UploadFileResult = {
 
 /**
  * Specification for a file management interface that implements the files interface version 4.
+ *
+ * Only `uploadFile` is required. The other operations are optional
+ * capabilities: their presence signals that the provider supports them
+ * (mirroring the optional-method pattern of `VideoModelV4`).
  */
 type FilesV4 = {
     /**
@@ -1066,6 +1273,21 @@ type FilesV4 = {
      * that can be used in subsequent API calls.
      */
     uploadFile(options: FilesV4UploadFileCallOptions): PromiseLike<FilesV4UploadFileResult>;
+    /**
+     * Retrieves metadata for a previously uploaded file.
+     * Optional: presence signals that the provider supports metadata reads.
+     */
+    getFileMetadata?(options: FilesV4GetFileMetadataCallOptions): PromiseLike<FilesV4GetFileMetadataResult>;
+    /**
+     * Downloads the content of a previously uploaded file as a byte stream.
+     * Optional: presence signals that the provider supports content download.
+     */
+    downloadFile?(options: FilesV4DownloadFileCallOptions): PromiseLike<FilesV4DownloadFileResult>;
+    /**
+     * Deletes a previously uploaded file.
+     * Optional: presence signals that the provider supports deletion.
+     */
+    deleteFile?(options: FilesV4DeleteFileCallOptions): PromiseLike<FilesV4DeleteFileResult>;
 };
 
 /**
@@ -4954,7 +5176,7 @@ type LanguageModelV4BatchRequest = {
     /**
      * Normalized text-generation options for the request.
      */
-    readonly options: Pick<LanguageModelV4CallOptions, 'prompt' | 'maxOutputTokens' | 'temperature' | 'stopSequences' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'seed' | 'reasoning' | 'providerOptions'>;
+    readonly options: Pick<LanguageModelV4CallOptions, 'prompt' | 'maxOutputTokens' | 'temperature' | 'stopSequences' | 'topP' | 'topK' | 'presencePenalty' | 'frequencyPenalty' | 'seed' | 'reasoning' | 'responseFormat' | 'toolChoice' | 'tools' | 'providerOptions'>;
 };
 /**
  * Language model V4 with durable batch-processing support.
@@ -7948,4 +8170,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 BatchLanguageModelV4 as Experimental_BatchLanguageModelV4, type BatchModelV4 as Experimental_BatchModelV4, type BatchV4Error as Experimental_BatchV4Error, type BatchV4ItemResult as Experimental_BatchV4ItemResult, type BatchV4OperationOptions as Experimental_BatchV4OperationOptions, type BatchV4StartOptions as Experimental_BatchV4StartOptions, type BatchV4StartResult as Experimental_BatchV4StartResult, type BatchV4Status as Experimental_BatchV4Status, type LanguageModelV4BatchRequest as Experimental_LanguageModelV4BatchRequest, type RealtimeFactoryV4 as Experimental_RealtimeFactoryV4, type RealtimeFactoryV4GetTokenOptions as Experimental_RealtimeFactoryV4GetTokenOptions, type RealtimeFactoryV4GetTokenResult as Experimental_RealtimeFactoryV4GetTokenResult, type RealtimeModelV4 as Experimental_RealtimeModelV4, type RealtimeModelV4AudioMessage as Experimental_RealtimeModelV4AudioMessage, type RealtimeModelV4ClientEvent as Experimental_RealtimeModelV4ClientEvent, type RealtimeModelV4ClientSecretOptions as Experimental_RealtimeModelV4ClientSecretOptions, type RealtimeModelV4ClientSecretResult as Experimental_RealtimeModelV4ClientSecretResult, type RealtimeModelV4ConversationItem as Experimental_RealtimeModelV4ConversationItem, type RealtimeModelV4FunctionCallOutput as Experimental_RealtimeModelV4FunctionCallOutput, type RealtimeModelV4ServerEvent as Experimental_RealtimeModelV4ServerEvent, type RealtimeModelV4SessionConfig as Experimental_RealtimeModelV4SessionConfig, type RealtimeModelV4TextMessage as Experimental_RealtimeModelV4TextMessage, type RealtimeModelV4ToolDefinition as Experimental_RealtimeModelV4ToolDefinition, type SpeechTranslationModelV4 as Experimental_SpeechTranslationModelV4, type SpeechTranslationModelV4StreamOptions as Experimental_SpeechTranslationModelV4StreamOptions, type SpeechTranslationModelV4StreamPart as Experimental_SpeechTranslationModelV4StreamPart, type SpeechTranslationModelV4StreamResult as Experimental_SpeechTranslationModelV4StreamResult, type SpeechTranslationModelV4Usage as Experimental_SpeechTranslationModelV4Usage, type TranscriptionModelV4StreamOptions as Experimental_TranscriptionModelV4StreamOptions, type TranscriptionModelV4StreamPart as Experimental_TranscriptionModelV4StreamPart, type TranscriptionModelV4StreamResult as Experimental_TranscriptionModelV4StreamResult, type VideoModelV3 as Experimental_VideoModelV3, type VideoModelV3CallOptions as Experimental_VideoModelV3CallOptions, type VideoModelV3File as Experimental_VideoModelV3File, type VideoModelV3FrameImage as Experimental_VideoModelV3FrameImage, type VideoModelV3FrameType as Experimental_VideoModelV3FrameType, type VideoModelV3VideoData as Experimental_VideoModelV3VideoData, type VideoModelV4 as Experimental_VideoModelV4, type VideoModelV4CallOptions as Experimental_VideoModelV4CallOptions, type VideoModelV4File as Experimental_VideoModelV4File, type VideoModelV4FrameImage as Experimental_VideoModelV4FrameImage, type VideoModelV4FrameType as Experimental_VideoModelV4FrameType, type VideoModelV4OperationStartResult as Experimental_VideoModelV4OperationStartResult, type VideoModelV4OperationStatusResult as Experimental_VideoModelV4OperationStatusResult, type VideoModelV4OperationWebhook as Experimental_VideoModelV4OperationWebhook, 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 SharedV4AudioFormat, 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 };
+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 BatchLanguageModelV4 as Experimental_BatchLanguageModelV4, type BatchModelV4 as Experimental_BatchModelV4, type BatchV4Error as Experimental_BatchV4Error, type BatchV4ItemResult as Experimental_BatchV4ItemResult, type BatchV4OperationOptions as Experimental_BatchV4OperationOptions, type BatchV4StartOptions as Experimental_BatchV4StartOptions, type BatchV4StartResult as Experimental_BatchV4StartResult, type BatchV4Status as Experimental_BatchV4Status, type LanguageModelV4BatchRequest as Experimental_LanguageModelV4BatchRequest, type RealtimeFactoryV4 as Experimental_RealtimeFactoryV4, type RealtimeFactoryV4GetTokenOptions as Experimental_RealtimeFactoryV4GetTokenOptions, type RealtimeFactoryV4GetTokenResult as Experimental_RealtimeFactoryV4GetTokenResult, type RealtimeModelV4 as Experimental_RealtimeModelV4, type RealtimeModelV4AudioMessage as Experimental_RealtimeModelV4AudioMessage, type RealtimeModelV4ClientEvent as Experimental_RealtimeModelV4ClientEvent, type RealtimeModelV4ClientSecretOptions as Experimental_RealtimeModelV4ClientSecretOptions, type RealtimeModelV4ClientSecretResult as Experimental_RealtimeModelV4ClientSecretResult, type RealtimeModelV4ConversationItem as Experimental_RealtimeModelV4ConversationItem, type RealtimeModelV4FunctionCallOutput as Experimental_RealtimeModelV4FunctionCallOutput, type RealtimeModelV4ServerEvent as Experimental_RealtimeModelV4ServerEvent, type RealtimeModelV4SessionConfig as Experimental_RealtimeModelV4SessionConfig, type RealtimeModelV4TextMessage as Experimental_RealtimeModelV4TextMessage, type RealtimeModelV4ToolDefinition as Experimental_RealtimeModelV4ToolDefinition, type SpeechTranslationModelV4 as Experimental_SpeechTranslationModelV4, type SpeechTranslationModelV4StreamOptions as Experimental_SpeechTranslationModelV4StreamOptions, type SpeechTranslationModelV4StreamPart as Experimental_SpeechTranslationModelV4StreamPart, type SpeechTranslationModelV4StreamResult as Experimental_SpeechTranslationModelV4StreamResult, type SpeechTranslationModelV4Usage as Experimental_SpeechTranslationModelV4Usage, type TranscriptionModelV4StreamOptions as Experimental_TranscriptionModelV4StreamOptions, type TranscriptionModelV4StreamPart as Experimental_TranscriptionModelV4StreamPart, type TranscriptionModelV4StreamResult as Experimental_TranscriptionModelV4StreamResult, type VideoModelV3 as Experimental_VideoModelV3, type VideoModelV3CallOptions as Experimental_VideoModelV3CallOptions, type VideoModelV3File as Experimental_VideoModelV3File, type VideoModelV3FrameImage as Experimental_VideoModelV3FrameImage, type VideoModelV3FrameType as Experimental_VideoModelV3FrameType, type VideoModelV3VideoData as Experimental_VideoModelV3VideoData, type VideoModelV4 as Experimental_VideoModelV4, type VideoModelV4CallOptions as Experimental_VideoModelV4CallOptions, type VideoModelV4File as Experimental_VideoModelV4File, type VideoModelV4FrameImage as Experimental_VideoModelV4FrameImage, type VideoModelV4FrameType as Experimental_VideoModelV4FrameType, type VideoModelV4OperationStartResult as Experimental_VideoModelV4OperationStartResult, type VideoModelV4OperationStatusResult as Experimental_VideoModelV4OperationStatusResult, type VideoModelV4OperationWebhook as Experimental_VideoModelV4OperationWebhook, type VideoModelV4Result as Experimental_VideoModelV4Result, type VideoModelV4VideoData as Experimental_VideoModelV4VideoData, type FilesV4, type FilesV4DeleteFileCallOptions, type FilesV4DeleteFileResult, type FilesV4DownloadFileCallOptions, type FilesV4DownloadFileResult, type FilesV4GetFileMetadataCallOptions, type FilesV4GetFileMetadataResult, type FilesV4UploadFileCallOptions, type FilesV4UploadFileResult, type FilesV4UploadFileStreamData, 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 SharedV4AudioFormat, 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/provider",
-  "version": "4.0.8",
+  "version": "4.0.10",
   "type": "module",
   "license": "Apache-2.0",
   "sideEffects": false,

package/src/files/v4/files-v4-delete-file-call-options.ts

@@ -0,0 +1,30 @@
+import type { SharedV4ProviderOptions } from '../../shared/v4/shared-v4-provider-options';
+import type { SharedV4ProviderReference } from '../../shared/v4/shared-v4-provider-reference';
+
+/**
+ * Options for deleting a file via the files interface.
+ */
+export type FilesV4DeleteFileCallOptions = {
+  /**
+   * The provider reference of the file, as returned by `uploadFile`.
+   */
+  file: SharedV4ProviderReference;
+
+  /**
+   * Abort signal for cancelling the operation.
+   */
+  abortSignal?: AbortSignal;
+
+  /**
+   * Additional HTTP headers to be sent with the request.
+   * Only applicable for HTTP-based providers.
+   */
+  headers?: Record<string, string | undefined>;
+
+  /**
+   * 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;
+};

package/src/files/v4/files-v4-delete-file-result.ts

@@ -0,0 +1,32 @@
+import type { SharedV4ProviderMetadata } from '../../shared/v4/shared-v4-provider-metadata';
+import type { SharedV4ProviderReference } from '../../shared/v4/shared-v4-provider-reference';
+import type { SharedV4Warning } from '../../shared/v4/shared-v4-warning';
+
+/**
+ * Result of deleting a file via the files interface.
+ */
+export type FilesV4DeleteFileResult = {
+  /**
+   * A provider reference mapping provider names to provider-specific file identifiers.
+   * Contains only the operated provider's entry — when working with a merged
+   * multi-provider reference, do not reassign it with this result.
+   */
+  providerReference: SharedV4ProviderReference;
+
+  /**
+   * Whether the provider confirmed the deletion.
+   */
+  deleted: boolean;
+
+  /**
+   * 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 from the provider.
+   */
+  warnings: Array<SharedV4Warning>;
+};

package/src/files/v4/files-v4-download-file-call-options.ts

@@ -0,0 +1,30 @@
+import type { SharedV4ProviderOptions } from '../../shared/v4/shared-v4-provider-options';
+import type { SharedV4ProviderReference } from '../../shared/v4/shared-v4-provider-reference';
+
+/**
+ * Options for downloading file content via the files interface.
+ */
+export type FilesV4DownloadFileCallOptions = {
+  /**
+   * The provider reference of the file, as returned by `uploadFile`.
+   */
+  file: SharedV4ProviderReference;
+
+  /**
+   * Abort signal for cancelling the operation.
+   */
+  abortSignal?: AbortSignal;
+
+  /**
+   * Additional HTTP headers to be sent with the request.
+   * Only applicable for HTTP-based providers.
+   */
+  headers?: Record<string, string | undefined>;
+
+  /**
+   * 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;
+};

package/src/files/v4/files-v4-download-file-result.ts

@@ -0,0 +1,30 @@
+import type { SharedV4ProviderMetadata } from '../../shared/v4/shared-v4-provider-metadata';
+import type { SharedV4Warning } from '../../shared/v4/shared-v4-warning';
+
+/**
+ * Result of downloading file content via the files interface.
+ */
+export type FilesV4DownloadFileResult = {
+  /**
+   * The file content as a byte stream.
+   * The consumer is responsible for draining or cancelling the stream.
+   */
+  content: ReadableStream<Uint8Array>;
+
+  /**
+   * The IANA media type of the file, if available from the provider.
+   */
+  mediaType?: string;
+
+  /**
+   * 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 from the provider.
+   */
+  warnings: Array<SharedV4Warning>;
+};

package/src/files/v4/files-v4-get-file-metadata-call-options.ts

@@ -0,0 +1,30 @@
+import type { SharedV4ProviderOptions } from '../../shared/v4/shared-v4-provider-options';
+import type { SharedV4ProviderReference } from '../../shared/v4/shared-v4-provider-reference';
+
+/**
+ * Options for retrieving file metadata via the files interface.
+ */
+export type FilesV4GetFileMetadataCallOptions = {
+  /**
+   * The provider reference of the file, as returned by `uploadFile`.
+   */
+  file: SharedV4ProviderReference;
+
+  /**
+   * Abort signal for cancelling the operation.
+   */
+  abortSignal?: AbortSignal;
+
+  /**
+   * Additional HTTP headers to be sent with the request.
+   * Only applicable for HTTP-based providers.
+   */
+  headers?: Record<string, string | undefined>;
+
+  /**
+   * 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;
+};

package/src/files/v4/files-v4-get-file-metadata-result.ts

@@ -0,0 +1,53 @@
+import type { SharedV4ProviderMetadata } from '../../shared/v4/shared-v4-provider-metadata';
+import type { SharedV4ProviderReference } from '../../shared/v4/shared-v4-provider-reference';
+import type { SharedV4Warning } from '../../shared/v4/shared-v4-warning';
+
+/**
+ * Result of retrieving file metadata via the files interface.
+ */
+export type FilesV4GetFileMetadataResult = {
+  /**
+   * A provider reference mapping provider names to provider-specific file identifiers.
+   * Contains only the operated provider's entry — when working with a merged
+   * multi-provider reference, do not reassign it with this result.
+   */
+  providerReference: SharedV4ProviderReference;
+
+  /**
+   * The filename of the file, if available from the provider.
+   */
+  filename?: string;
+
+  /**
+   * The IANA media type of the file, if available from the provider.
+   */
+  mediaType?: string;
+
+  /**
+   * The size of the file in bytes, if available from the provider.
+   */
+  byteSize?: number;
+
+  /**
+   * When the file was created, if available from the provider.
+   */
+  createdAt?: Date;
+
+  /**
+   * When the provider will delete the file (retention expiry),
+   * if available from the provider.
+   */
+  expiresAt?: Date;
+
+  /**
+   * 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 from the provider.
+   */
+  warnings: Array<SharedV4Warning>;
+};

package/src/files/v4/files-v4-upload-file-call-options.ts

@@ -4,6 +4,15 @@ import type {
 } from '../../shared/v4/shared-v4-file-data';
 import type { SharedV4ProviderOptions } from '../../shared/v4/shared-v4-provider-options';
 
+/**
+ * File data variant containing a byte stream. Providers that support
+ * streaming uploads send it without buffering the full file in memory.
+ */
+export interface FilesV4UploadFileStreamData {
+  type: 'stream';
+  stream: ReadableStream<Uint8Array>;
+}
+
 /**
  * Options for uploading a file via the files interface.
  */
@@ -13,8 +22,13 @@ export type FilesV4UploadFileCallOptions = {
    *
    * - `{ type: 'data', data }`: raw bytes (`Uint8Array`) or a base64-encoded string.
    * - `{ type: 'text', text }`: inline text (UTF-8).
+   * - `{ type: 'stream', stream }`: a byte stream (not buffered by providers
+   *   that support streaming uploads).
    */
-  data: SharedV4FileDataData | SharedV4FileDataText;
+  data:
+    | SharedV4FileDataData
+    | SharedV4FileDataText
+    | FilesV4UploadFileStreamData;
 
   /**
    * The IANA media type of the file (e.g. `'application/pdf'`).
@@ -26,6 +40,17 @@ export type FilesV4UploadFileCallOptions = {
    */
   filename?: string;
 
+  /**
+   * Abort signal for cancelling the operation.
+   */
+  abortSignal?: AbortSignal;
+
+  /**
+   * Additional HTTP headers to be sent with the request.
+   * Only applicable for HTTP-based providers.
+   */
+  headers?: Record<string, string | undefined>;
+
   /**
    * Additional provider-specific options. They are passed through
    * to the provider from the AI SDK and enable provider-specific

package/src/files/v4/files-v4-upload-file-result.ts

@@ -8,6 +8,8 @@ import type { SharedV4Warning } from '../../shared/v4/shared-v4-warning';
 export type FilesV4UploadFileResult = {
   /**
    * A provider reference mapping provider names to provider-specific file identifiers.
+   * The key is the canonical provider name (e.g. `openai`) and may differ from
+   * the interface's `provider` id (e.g. `openai.files`).
    */
   providerReference: SharedV4ProviderReference;
 
@@ -21,6 +23,22 @@ export type FilesV4UploadFileResult = {
    */
   filename?: string;
 
+  /**
+   * The size of the uploaded file in bytes, if available from the provider.
+   */
+  byteSize?: number;
+
+  /**
+   * When the file was created, if available from the provider.
+   */
+  createdAt?: Date;
+
+  /**
+   * When the provider will delete the file (retention expiry, e.g. from a
+   * requested upload TTL), if available from the provider.
+   */
+  expiresAt?: Date;
+
   /**
    * Additional provider-specific metadata. They are passed through
    * to the provider from the AI SDK and enable provider-specific

package/src/files/v4/files-v4.ts

@@ -1,8 +1,18 @@
+import type { FilesV4DeleteFileCallOptions } from './files-v4-delete-file-call-options';
+import type { FilesV4DeleteFileResult } from './files-v4-delete-file-result';
+import type { FilesV4DownloadFileCallOptions } from './files-v4-download-file-call-options';
+import type { FilesV4DownloadFileResult } from './files-v4-download-file-result';
+import type { FilesV4GetFileMetadataCallOptions } from './files-v4-get-file-metadata-call-options';
+import type { FilesV4GetFileMetadataResult } from './files-v4-get-file-metadata-result';
 import type { FilesV4UploadFileCallOptions } from './files-v4-upload-file-call-options';
 import type { FilesV4UploadFileResult } from './files-v4-upload-file-result';
 
 /**
  * Specification for a file management interface that implements the files interface version 4.
+ *
+ * Only `uploadFile` is required. The other operations are optional
+ * capabilities: their presence signals that the provider supports them
+ * (mirroring the optional-method pattern of `VideoModelV4`).
  */
 export type FilesV4 = {
   /**
@@ -22,4 +32,28 @@ export type FilesV4 = {
   uploadFile(
     options: FilesV4UploadFileCallOptions,
   ): PromiseLike<FilesV4UploadFileResult>;
+
+  /**
+   * Retrieves metadata for a previously uploaded file.
+   * Optional: presence signals that the provider supports metadata reads.
+   */
+  getFileMetadata?(
+    options: FilesV4GetFileMetadataCallOptions,
+  ): PromiseLike<FilesV4GetFileMetadataResult>;
+
+  /**
+   * Downloads the content of a previously uploaded file as a byte stream.
+   * Optional: presence signals that the provider supports content download.
+   */
+  downloadFile?(
+    options: FilesV4DownloadFileCallOptions,
+  ): PromiseLike<FilesV4DownloadFileResult>;
+
+  /**
+   * Deletes a previously uploaded file.
+   * Optional: presence signals that the provider supports deletion.
+   */
+  deleteFile?(
+    options: FilesV4DeleteFileCallOptions,
+  ): PromiseLike<FilesV4DeleteFileResult>;
 };

package/src/files/v4/index.ts

@@ -1,3 +1,12 @@
 export type { FilesV4 } from './files-v4';
-export type { FilesV4UploadFileCallOptions } from './files-v4-upload-file-call-options';
+export type { FilesV4DeleteFileCallOptions } from './files-v4-delete-file-call-options';
+export type { FilesV4DeleteFileResult } from './files-v4-delete-file-result';
+export type { FilesV4DownloadFileCallOptions } from './files-v4-download-file-call-options';
+export type { FilesV4DownloadFileResult } from './files-v4-download-file-result';
+export type { FilesV4GetFileMetadataCallOptions } from './files-v4-get-file-metadata-call-options';
+export type { FilesV4GetFileMetadataResult } from './files-v4-get-file-metadata-result';
+export type {
+  FilesV4UploadFileCallOptions,
+  FilesV4UploadFileStreamData,
+} from './files-v4-upload-file-call-options';
 export type { FilesV4UploadFileResult } from './files-v4-upload-file-result';

package/src/language-model/v4/language-model-v4-batch.ts

@@ -28,6 +28,9 @@ export type LanguageModelV4BatchRequest = {
     | 'frequencyPenalty'
     | 'seed'
     | 'reasoning'
+    | 'responseFormat'
+    | 'toolChoice'
+    | 'tools'
     | 'providerOptions'
   >;
 };