ai 3.4.5 → 3.4.7

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # ai
 
+## 3.4.7
+
+### Patch Changes
+
+- db04700: feat (core): support converting attachments to file parts
+- 988707c: feat (ai/core): automatically download files from urls
+
+## 3.4.6
+
+### Patch Changes
+
+- d595d0d: feat (ai/core): file content parts
+- Updated dependencies [d595d0d]
+  - @ai-sdk/provider@0.0.24
+  - @ai-sdk/provider-utils@1.0.20
+  - @ai-sdk/ui-utils@0.0.46
+  - @ai-sdk/react@0.0.62
+  - @ai-sdk/solid@0.0.49
+  - @ai-sdk/svelte@0.0.51
+  - @ai-sdk/vue@0.0.53
+
 ## 3.4.5
 
 ### Patch Changes

package/dist/index.d.mts

@@ -438,6 +438,29 @@ interface ImagePart {
     experimental_providerMetadata?: ProviderMetadata;
 }
 /**
+File content part of a prompt. It contains a file.
+ */
+interface FilePart {
+    type: 'file';
+    /**
+  File data. Can either be:
+  
+  - data: a base64-encoded string, a Uint8Array, an ArrayBuffer, or a Buffer
+  - URL: a URL that points to the image
+     */
+    data: DataContent | URL;
+    /**
+  Mime type of the file.
+     */
+    mimeType: 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.
+   */
+    experimental_providerMetadata?: ProviderMetadata;
+}
+/**
 Tool call content part of a prompt. It contains a tool call (usually generated by the AI model).
  */
 interface ToolCallPart {
@@ -531,7 +554,7 @@ type ExperimentalUserMessage = CoreUserMessage;
 /**
 Content of a user message. It can be a string or an array of text and image parts.
  */
-type UserContent = string | Array<TextPart$1 | ImagePart>;
+type UserContent = string | Array<TextPart$1 | ImagePart | FilePart>;
 /**
 An assistant message. It can contain text, tool calls, or a combination of text and tool calls.
  */

package/dist/index.d.ts

@@ -438,6 +438,29 @@ interface ImagePart {
     experimental_providerMetadata?: ProviderMetadata;
 }
 /**
+File content part of a prompt. It contains a file.
+ */
+interface FilePart {
+    type: 'file';
+    /**
+  File data. Can either be:
+  
+  - data: a base64-encoded string, a Uint8Array, an ArrayBuffer, or a Buffer
+  - URL: a URL that points to the image
+     */
+    data: DataContent | URL;
+    /**
+  Mime type of the file.
+     */
+    mimeType: 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.
+   */
+    experimental_providerMetadata?: ProviderMetadata;
+}
+/**
 Tool call content part of a prompt. It contains a tool call (usually generated by the AI model).
  */
 interface ToolCallPart {
@@ -531,7 +554,7 @@ type ExperimentalUserMessage = CoreUserMessage;
 /**
 Content of a user message. It can be a string or an array of text and image parts.
  */
-type UserContent = string | Array<TextPart$1 | ImagePart>;
+type UserContent = string | Array<TextPart$1 | ImagePart | FilePart>;
 /**
 An assistant message. It can contain text, tool calls, or a combination of text and tool calls.
  */

package/dist/index.js

@@ -825,6 +825,15 @@ var dataContentSchema = import_zod.z.union([
     { message: "Must be a Buffer" }
   )
 ]);
+function convertDataContentToBase64String(content) {
+  if (typeof content === "string") {
+    return content;
+  }
+  if (content instanceof ArrayBuffer) {
+    return (0, import_provider_utils2.convertUint8ArrayToBase64)(new Uint8Array(content));
+  }
+  return (0, import_provider_utils2.convertUint8ArrayToBase64)(content);
+}
 function convertDataContentToUint8Array(content) {
   if (content instanceof Uint8Array) {
     return content;
@@ -891,6 +900,22 @@ var InvalidMessageRoleError = class extends import_provider5.AISDKError {
 };
 _a4 = symbol4;
 
+// core/prompt/split-data-url.ts
+function splitDataUrl(dataUrl) {
+  try {
+    const [header, base64Content] = dataUrl.split(",");
+    return {
+      mimeType: header.split(";")[0].split(":")[1],
+      base64Content
+    };
+  } catch (error) {
+    return {
+      mimeType: void 0,
+      base64Content: void 0
+    };
+  }
+}
+
 // core/prompt/convert-to-language-model-prompt.ts
 async function convertToLanguageModelPrompt({
   prompt,
@@ -901,7 +926,7 @@ async function convertToLanguageModelPrompt({
   if (prompt.system != null) {
     languageModelMessages.push({ role: "system", content: prompt.system });
   }
-  const downloadedImages = modelSupportsImageUrls || prompt.messages == null ? null : await downloadImages(prompt.messages, downloadImplementation);
+  const downloadedAssets = modelSupportsImageUrls || prompt.messages == null ? null : await downloadAssets(prompt.messages, downloadImplementation);
   const promptType = prompt.type;
   switch (promptType) {
     case "prompt": {
@@ -914,7 +939,7 @@ async function convertToLanguageModelPrompt({
     case "messages": {
       languageModelMessages.push(
         ...prompt.messages.map(
-          (message) => convertToLanguageModelMessage(message, downloadedImages)
+          (message) => convertToLanguageModelMessage(message, downloadedAssets)
         )
       );
       break;
@@ -926,7 +951,7 @@ async function convertToLanguageModelPrompt({
   }
   return languageModelMessages;
 }
-function convertToLanguageModelMessage(message, downloadedImages) {
+function convertToLanguageModelMessage(message, downloadedAssets) {
   const role = message.role;
   switch (role) {
     case "system": {
@@ -946,98 +971,178 @@ function convertToLanguageModelMessage(message, downloadedImages) {
       }
       return {
         role: "user",
-        content: message.content.map((part) => {
-          var _a11, _b, _c;
-          switch (part.type) {
-            case "text": {
-              return {
-                type: "text",
-                text: part.text,
-                providerMetadata: part.experimental_providerMetadata
-              };
-            }
-            case "image": {
-              if (part.image instanceof URL) {
-                if (downloadedImages == null) {
-                  return {
-                    type: "image",
-                    image: part.image,
-                    mimeType: part.mimeType,
-                    providerMetadata: part.experimental_providerMetadata
-                  };
-                } else {
-                  const downloadedImage = downloadedImages[part.image.toString()];
-                  return {
-                    type: "image",
-                    image: downloadedImage.data,
-                    mimeType: (_a11 = part.mimeType) != null ? _a11 : downloadedImage.mimeType,
-                    providerMetadata: part.experimental_providerMetadata
-                  };
-                }
+        content: message.content.map(
+          (part) => {
+            var _a11, _b, _c, _d, _e;
+            switch (part.type) {
+              case "text": {
+                return {
+                  type: "text",
+                  text: part.text,
+                  providerMetadata: part.experimental_providerMetadata
+                };
               }
-              if (typeof part.image === "string") {
-                try {
-                  const url = new URL(part.image);
-                  switch (url.protocol) {
-                    case "http:":
-                    case "https:": {
-                      if (downloadedImages == null) {
-                        return {
-                          type: "image",
-                          image: url,
-                          mimeType: part.mimeType,
-                          providerMetadata: part.experimental_providerMetadata
-                        };
-                      } else {
-                        const downloadedImage = downloadedImages[part.image];
-                        return {
-                          type: "image",
-                          image: downloadedImage.data,
-                          mimeType: (_b = part.mimeType) != null ? _b : downloadedImage.mimeType,
-                          providerMetadata: part.experimental_providerMetadata
-                        };
+              case "image": {
+                if (part.image instanceof URL) {
+                  if (downloadedAssets == null) {
+                    return {
+                      type: "image",
+                      image: part.image,
+                      mimeType: part.mimeType,
+                      providerMetadata: part.experimental_providerMetadata
+                    };
+                  } else {
+                    const downloadedImage = downloadedAssets[part.image.toString()];
+                    return {
+                      type: "image",
+                      image: downloadedImage.data,
+                      mimeType: (_a11 = part.mimeType) != null ? _a11 : downloadedImage.mimeType,
+                      providerMetadata: part.experimental_providerMetadata
+                    };
+                  }
+                }
+                if (typeof part.image === "string") {
+                  try {
+                    const url = new URL(part.image);
+                    switch (url.protocol) {
+                      case "http:":
+                      case "https:": {
+                        if (downloadedAssets == null) {
+                          return {
+                            type: "image",
+                            image: url,
+                            mimeType: part.mimeType,
+                            providerMetadata: part.experimental_providerMetadata
+                          };
+                        } else {
+                          const downloadedImage = downloadedAssets[url.toString()];
+                          return {
+                            type: "image",
+                            image: downloadedImage.data,
+                            mimeType: (_b = part.mimeType) != null ? _b : downloadedImage.mimeType,
+                            providerMetadata: part.experimental_providerMetadata
+                          };
+                        }
                       }
-                    }
-                    case "data:": {
-                      try {
-                        const [header, base64Content] = part.image.split(",");
-                        const mimeType = header.split(";")[0].split(":")[1];
-                        if (mimeType == null || base64Content == null) {
-                          throw new Error("Invalid data URL format");
+                      case "data:": {
+                        try {
+                          const { mimeType, base64Content } = splitDataUrl(
+                            part.image
+                          );
+                          if (mimeType == null || base64Content == null) {
+                            throw new Error("Invalid data URL format");
+                          }
+                          return {
+                            type: "image",
+                            image: convertDataContentToUint8Array(base64Content),
+                            mimeType,
+                            providerMetadata: part.experimental_providerMetadata
+                          };
+                        } catch (error) {
+                          throw new Error(
+                            `Error processing data URL: ${(0, import_provider_utils3.getErrorMessage)(
+                              message
+                            )}`
+                          );
                         }
-                        return {
-                          type: "image",
-                          image: convertDataContentToUint8Array(base64Content),
-                          mimeType,
-                          providerMetadata: part.experimental_providerMetadata
-                        };
-                      } catch (error) {
-                        throw new Error(
-                          `Error processing data URL: ${(0, import_provider_utils3.getErrorMessage)(
-                            message
-                          )}`
-                        );
                       }
                     }
-                    default: {
-                      throw new Error(
-                        `Unsupported URL protocol: ${url.protocol}`
-                      );
+                  } catch (_ignored) {
+                  }
+                }
+                const imageUint8 = convertDataContentToUint8Array(part.image);
+                return {
+                  type: "image",
+                  image: imageUint8,
+                  mimeType: (_c = part.mimeType) != null ? _c : detectImageMimeType(imageUint8),
+                  providerMetadata: part.experimental_providerMetadata
+                };
+              }
+              case "file": {
+                if (part.data instanceof URL) {
+                  if (downloadedAssets == null) {
+                    return {
+                      type: "file",
+                      data: part.data,
+                      mimeType: part.mimeType,
+                      providerMetadata: part.experimental_providerMetadata
+                    };
+                  } else {
+                    const downloadedImage = downloadedAssets[part.data.toString()];
+                    return {
+                      type: "file",
+                      data: (0, import_provider_utils3.convertUint8ArrayToBase64)(downloadedImage.data),
+                      mimeType: (_d = part.mimeType) != null ? _d : downloadedImage.mimeType,
+                      providerMetadata: part.experimental_providerMetadata
+                    };
+                  }
+                }
+                if (typeof part.data === "string") {
+                  try {
+                    const url = new URL(part.data);
+                    switch (url.protocol) {
+                      case "http:":
+                      case "https:": {
+                        if (downloadedAssets == null) {
+                          return {
+                            type: "file",
+                            data: url,
+                            mimeType: part.mimeType,
+                            providerMetadata: part.experimental_providerMetadata
+                          };
+                        } else {
+                          const downloadedImage = downloadedAssets[url.toString()];
+                          return {
+                            type: "file",
+                            data: (0, import_provider_utils3.convertUint8ArrayToBase64)(
+                              downloadedImage.data
+                            ),
+                            mimeType: (_e = part.mimeType) != null ? _e : downloadedImage.mimeType,
+                            providerMetadata: part.experimental_providerMetadata
+                          };
+                        }
+                      }
+                      case "data:": {
+                        try {
+                          const { mimeType, base64Content } = splitDataUrl(
+                            part.data
+                          );
+                          if (mimeType == null || base64Content == null) {
+                            throw new Error("Invalid data URL format");
+                          }
+                          return {
+                            type: "file",
+                            data: convertDataContentToBase64String(
+                              base64Content
+                            ),
+                            mimeType,
+                            providerMetadata: part.experimental_providerMetadata
+                          };
+                        } catch (error) {
+                          throw new Error(
+                            `Error processing data URL: ${(0, import_provider_utils3.getErrorMessage)(
+                              message
+                            )}`
+                          );
+                        }
+                      }
                     }
+                  } catch (_ignored) {
                   }
-                } catch (_ignored) {
                 }
+                const imageBase64 = convertDataContentToBase64String(
+                  part.data
+                );
+                return {
+                  type: "file",
+                  data: imageBase64,
+                  mimeType: part.mimeType,
+                  providerMetadata: part.experimental_providerMetadata
+                };
               }
-              const imageUint8 = convertDataContentToUint8Array(part.image);
-              return {
-                type: "image",
-                image: imageUint8,
-                mimeType: (_c = part.mimeType) != null ? _c : detectImageMimeType(imageUint8),
-                providerMetadata: part.experimental_providerMetadata
-              };
             }
           }
-        }).filter((part) => part.type !== "text" || part.text !== ""),
+        ).filter((part) => part.type !== "text" || part.text !== ""),
         providerMetadata: message.experimental_providerMetadata
       };
     }
@@ -1083,12 +1188,14 @@ function convertToLanguageModelMessage(message, downloadedImages) {
     }
   }
 }
-async function downloadImages(messages, downloadImplementation) {
+async function downloadAssets(messages, downloadImplementation) {
   const urls = messages.filter((message) => message.role === "user").map((message) => message.content).filter(
     (content) => Array.isArray(content)
-  ).flat().filter((part) => part.type === "image").map((part) => part.image).map(
+  ).flat().filter(
+    (part) => part.type === "image" || part.type === "file"
+  ).map((part) => part.type === "image" ? part.image : part.data).map(
     (part) => (
-      // support string urls in image parts:
+      // support string urls:
       typeof part === "string" && (part.startsWith("http:") || part.startsWith("https:")) ? new URL(part) : part
     )
   ).filter((image) => image instanceof URL);
@@ -1298,6 +1405,12 @@ var imagePartSchema = import_zod4.z.object({
   mimeType: import_zod4.z.string().optional(),
   experimental_providerMetadata: providerMetadataSchema.optional()
 });
+var filePartSchema = import_zod4.z.object({
+  type: import_zod4.z.literal("file"),
+  data: import_zod4.z.union([dataContentSchema, import_zod4.z.instanceof(URL)]),
+  mimeType: import_zod4.z.string(),
+  experimental_providerMetadata: providerMetadataSchema.optional()
+});
 var toolCallPartSchema = import_zod4.z.object({
   type: import_zod4.z.literal("tool-call"),
   toolCallId: import_zod4.z.string(),
@@ -1323,7 +1436,7 @@ var coreUserMessageSchema = import_zod5.z.object({
   role: import_zod5.z.literal("user"),
   content: import_zod5.z.union([
     import_zod5.z.string(),
-    import_zod5.z.array(import_zod5.z.union([textPartSchema, imagePartSchema]))
+    import_zod5.z.array(import_zod5.z.union([textPartSchema, imagePartSchema, filePartSchema]))
   ]),
   experimental_providerMetadata: providerMetadataSchema.optional()
 });
@@ -4651,6 +4764,17 @@ function attachmentsToParts(attachments) {
       case "https:": {
         if ((_a11 = attachment.contentType) == null ? void 0 : _a11.startsWith("image/")) {
           parts.push({ type: "image", image: url });
+        } else {
+          if (!attachment.contentType) {
+            throw new Error(
+              "If the attachment is not an image, it must specify a content type"
+            );
+          }
+          parts.push({
+            type: "file",
+            data: url,
+            mimeType: attachment.contentType
+          });
         }
         break;
       }
@@ -4679,6 +4803,17 @@ function attachmentsToParts(attachments) {
               convertDataContentToUint8Array(base64Content)
             )
           });
+        } else {
+          if (!attachment.contentType) {
+            throw new Error(
+              "If the attachment is not an image or text, it must specify a content type"
+            );
+          }
+          parts.push({
+            type: "file",
+            data: base64Content,
+            mimeType: attachment.contentType
+          });
         }
         break;
       }