@ai-sdk/anthropic 4.0.0-beta.19 → 4.0.0-beta.21

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @ai-sdk/anthropic
 
+## 4.0.0-beta.21
+
+### Patch Changes
+
+- 34bd95d: feat(ai): add support for uploading provider skills using the provider references abstraction
+- Updated dependencies [34bd95d]
+- Updated dependencies [008271d]
+  - @ai-sdk/provider@4.0.0-beta.8
+  - @ai-sdk/provider-utils@5.0.0-beta.14
+
+## 4.0.0-beta.20
+
+### Patch Changes
+
+- Updated dependencies [b0c2869]
+- Updated dependencies [7e26e81]
+  - @ai-sdk/provider-utils@5.0.0-beta.13
+
 ## 4.0.0-beta.19
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { JSONObject, ProviderV4, LanguageModelV4, FilesV4 } from '@ai-sdk/provider';
+import { JSONObject, ProviderV4, LanguageModelV4, FilesV4, SkillsV4 } from '@ai-sdk/provider';
 import { z } from 'zod/v4';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction } from '@ai-sdk/provider-utils';
@@ -164,11 +164,15 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
     }, z.core.$strip>>>;
     container: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
-        skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            type: z.ZodUnion<readonly [z.ZodLiteral<"anthropic">, z.ZodLiteral<"custom">]>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"anthropic">;
             skillId: z.ZodString;
             version: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"custom">;
+            providerReference: z.ZodRecord<z.ZodString, z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
     }, z.core.$strip>>;
     toolStreaming: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodOptional<z.ZodEnum<{
@@ -1026,6 +1030,10 @@ interface AnthropicProvider extends ProviderV4 {
      */
     textEmbeddingModel(modelId: string): never;
     files(): FilesV4;
+    /**
+     * Returns a SkillsV4 interface for uploading skills to Anthropic.
+     */
+    skills(): SkillsV4;
     /**
      * Anthropic-specific computer use tool.
      */

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { JSONObject, ProviderV4, LanguageModelV4, FilesV4 } from '@ai-sdk/provider';
+import { JSONObject, ProviderV4, LanguageModelV4, FilesV4, SkillsV4 } from '@ai-sdk/provider';
 import { z } from 'zod/v4';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { FetchFunction } from '@ai-sdk/provider-utils';
@@ -164,11 +164,15 @@ declare const anthropicLanguageModelOptions: z.ZodObject<{
     }, z.core.$strip>>>;
     container: z.ZodOptional<z.ZodObject<{
         id: z.ZodOptional<z.ZodString>;
-        skills: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            type: z.ZodUnion<readonly [z.ZodLiteral<"anthropic">, z.ZodLiteral<"custom">]>;
+        skills: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+            type: z.ZodLiteral<"anthropic">;
             skillId: z.ZodString;
             version: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>>>;
+        }, z.core.$strip>, z.ZodObject<{
+            type: z.ZodLiteral<"custom">;
+            providerReference: z.ZodRecord<z.ZodString, z.ZodString>;
+            version: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>]>>>;
     }, z.core.$strip>>;
     toolStreaming: z.ZodOptional<z.ZodBoolean>;
     effort: z.ZodOptional<z.ZodEnum<{
@@ -1026,6 +1030,10 @@ interface AnthropicProvider extends ProviderV4 {
      */
     textEmbeddingModel(modelId: string): never;
     files(): FilesV4;
+    /**
+     * Returns a SkillsV4 interface for uploading skills to Anthropic.
+     */
+    skills(): SkillsV4;
     /**
      * Anthropic-specific computer use tool.
      */

package/dist/index.js

@@ -29,7 +29,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/anthropic-provider.ts
 var import_provider4 = require("@ai-sdk/provider");
-var import_provider_utils27 = require("@ai-sdk/provider-utils");
+var import_provider_utils29 = require("@ai-sdk/provider-utils");
 
 // src/anthropic-files.ts
 var import_provider_utils2 = require("@ai-sdk/provider-utils");
@@ -980,11 +980,18 @@ var anthropicLanguageModelOptions = import_v44.z.object({
   container: import_v44.z.object({
     id: import_v44.z.string().optional(),
     skills: import_v44.z.array(
-      import_v44.z.object({
-        type: import_v44.z.union([import_v44.z.literal("anthropic"), import_v44.z.literal("custom")]),
-        skillId: import_v44.z.string(),
-        version: import_v44.z.string().optional()
-      })
+      import_v44.z.discriminatedUnion("type", [
+        import_v44.z.object({
+          type: import_v44.z.literal("anthropic"),
+          skillId: import_v44.z.string(),
+          version: import_v44.z.string().optional()
+        }),
+        import_v44.z.object({
+          type: import_v44.z.literal("custom"),
+          providerReference: import_v44.z.record(import_v44.z.string(), import_v44.z.string()),
+          version: import_v44.z.string().optional()
+        })
+      ])
     ).optional()
   }).optional(),
   /**
@@ -3164,7 +3171,10 @@ var AnthropicMessagesLanguageModel = class {
             id: anthropicOptions.container.id,
             skills: anthropicOptions.container.skills.map((skill) => ({
               type: skill.type,
-              skill_id: skill.skillId,
+              skill_id: skill.type === "custom" ? (0, import_provider_utils16.resolveProviderReference)({
+                reference: skill.providerReference,
+                provider: "anthropic"
+              }) : skill.skillId,
               version: skill.version
             }))
           }
@@ -5237,14 +5247,136 @@ var anthropicTools = {
   toolSearchBm25_20251119
 };
 
+// src/skills/anthropic-skills.ts
+var import_provider_utils28 = require("@ai-sdk/provider-utils");
+
+// src/skills/anthropic-skills-api.ts
+var import_provider_utils27 = require("@ai-sdk/provider-utils");
+var import_v424 = require("zod/v4");
+var anthropicSkillResponseSchema = (0, import_provider_utils27.lazySchema)(
+  () => (0, import_provider_utils27.zodSchema)(
+    import_v424.z.object({
+      id: import_v424.z.string(),
+      display_title: import_v424.z.string().nullish(),
+      name: import_v424.z.string().nullish(),
+      description: import_v424.z.string().nullish(),
+      latest_version: import_v424.z.string().nullish(),
+      source: import_v424.z.string(),
+      created_at: import_v424.z.string(),
+      updated_at: import_v424.z.string()
+    })
+  )
+);
+var anthropicSkillVersionListResponseSchema = (0, import_provider_utils27.lazySchema)(
+  () => (0, import_provider_utils27.zodSchema)(
+    import_v424.z.object({
+      data: import_v424.z.array(
+        import_v424.z.object({
+          version: import_v424.z.string()
+        })
+      )
+    })
+  )
+);
+var anthropicSkillVersionResponseSchema = (0, import_provider_utils27.lazySchema)(
+  () => (0, import_provider_utils27.zodSchema)(
+    import_v424.z.object({
+      type: import_v424.z.string(),
+      skill_id: import_v424.z.string(),
+      name: import_v424.z.string().nullish(),
+      description: import_v424.z.string().nullish()
+    })
+  )
+);
+
+// src/skills/anthropic-skills.ts
+var AnthropicSkills = class {
+  constructor(config) {
+    this.config = config;
+    this.specificationVersion = "v4";
+  }
+  get provider() {
+    return this.config.provider;
+  }
+  async getHeaders() {
+    return (0, import_provider_utils28.combineHeaders)(await (0, import_provider_utils28.resolve)(this.config.headers), {
+      "anthropic-beta": "skills-2025-10-02"
+    });
+  }
+  async fetchVersionMetadata({
+    skillId,
+    version,
+    headers
+  }) {
+    const { value: versionResponse } = await (0, import_provider_utils28.getFromApi)({
+      url: `${this.config.baseURL}/skills/${skillId}/versions/${version}`,
+      headers,
+      failedResponseHandler: anthropicFailedResponseHandler,
+      successfulResponseHandler: (0, import_provider_utils28.createJsonResponseHandler)(
+        anthropicSkillVersionResponseSchema
+      ),
+      fetch: this.config.fetch
+    });
+    return {
+      ...versionResponse.name != null ? { name: versionResponse.name } : {},
+      ...versionResponse.description != null ? { description: versionResponse.description } : {}
+    };
+  }
+  async upload(params) {
+    var _a, _b;
+    const warnings = [];
+    const formData = new FormData();
+    if (params.displayTitle != null) {
+      formData.append("display_title", params.displayTitle);
+    }
+    for (const file of params.files) {
+      const content = typeof file.content === "string" ? (0, import_provider_utils28.convertBase64ToUint8Array)(file.content) : file.content;
+      formData.append("files[]", new Blob([content]), file.path);
+    }
+    const headers = await this.getHeaders();
+    const { value: response } = await (0, import_provider_utils28.postFormDataToApi)({
+      url: `${this.config.baseURL}/skills`,
+      headers,
+      formData,
+      failedResponseHandler: anthropicFailedResponseHandler,
+      successfulResponseHandler: (0, import_provider_utils28.createJsonResponseHandler)(
+        anthropicSkillResponseSchema
+      ),
+      fetch: this.config.fetch
+    });
+    const versionMetadata = response.latest_version != null ? await this.fetchVersionMetadata({
+      skillId: response.id,
+      version: response.latest_version,
+      headers
+    }) : {};
+    const name = (_a = versionMetadata.name) != null ? _a : response.name;
+    const description = (_b = versionMetadata.description) != null ? _b : response.description;
+    return {
+      providerReference: { anthropic: response.id },
+      ...response.display_title != null ? { displayTitle: response.display_title } : {},
+      ...name != null ? { name } : {},
+      ...description != null ? { description } : {},
+      ...response.latest_version != null ? { latestVersion: response.latest_version } : {},
+      providerMetadata: {
+        anthropic: {
+          ...response.source != null ? { source: response.source } : {},
+          ...response.created_at != null ? { createdAt: response.created_at } : {},
+          ...response.updated_at != null ? { updatedAt: response.updated_at } : {}
+        }
+      },
+      warnings
+    };
+  }
+};
+
 // src/version.ts
-var VERSION = true ? "4.0.0-beta.19" : "0.0.0-test";
+var VERSION = true ? "4.0.0-beta.21" : "0.0.0-test";
 
 // src/anthropic-provider.ts
 function createAnthropic(options = {}) {
   var _a, _b;
-  const baseURL = (_a = (0, import_provider_utils27.withoutTrailingSlash)(
-    (0, import_provider_utils27.loadOptionalSetting)({
+  const baseURL = (_a = (0, import_provider_utils29.withoutTrailingSlash)(
+    (0, import_provider_utils29.loadOptionalSetting)({
       settingValue: options.baseURL,
       environmentVariableName: "ANTHROPIC_BASE_URL"
     })
@@ -5258,13 +5390,13 @@ function createAnthropic(options = {}) {
   }
   const getHeaders = () => {
     const authHeaders = options.authToken ? { Authorization: `Bearer ${options.authToken}` } : {
-      "x-api-key": (0, import_provider_utils27.loadApiKey)({
+      "x-api-key": (0, import_provider_utils29.loadApiKey)({
         apiKey: options.apiKey,
         environmentVariableName: "ANTHROPIC_API_KEY",
         description: "Anthropic"
       })
     };
-    return (0, import_provider_utils27.withUserAgentSuffix)(
+    return (0, import_provider_utils29.withUserAgentSuffix)(
       {
         "anthropic-version": "2023-06-01",
         ...authHeaders,
@@ -5280,13 +5412,19 @@ function createAnthropic(options = {}) {
       baseURL,
       headers: getHeaders,
       fetch: options.fetch,
-      generateId: (_a2 = options.generateId) != null ? _a2 : import_provider_utils27.generateId,
+      generateId: (_a2 = options.generateId) != null ? _a2 : import_provider_utils29.generateId,
       supportedUrls: () => ({
         "image/*": [/^https?:\/\/.*$/],
         "application/pdf": [/^https?:\/\/.*$/]
       })
     });
   };
+  const createSkills = () => new AnthropicSkills({
+    provider: `${providerName.replace(".messages", "")}.skills`,
+    baseURL,
+    headers: getHeaders,
+    fetch: options.fetch
+  });
   const provider = function(modelId) {
     if (new.target) {
       throw new Error(
@@ -5312,6 +5450,7 @@ function createAnthropic(options = {}) {
     headers: getHeaders,
     fetch: options.fetch
   });
+  provider.skills = createSkills;
   provider.tools = anthropicTools;
   return provider;
 }