@ai-sdk/openai 4.0.0-beta.23 → 4.0.0-beta.26

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @ai-sdk/openai
 
+## 4.0.0-beta.26
+
+### Patch Changes
+
+- e311194: feat(ai): allow passing provider instance to `uploadFile` and `uploadSkill` as shorthand
+- Updated dependencies [e311194]
+  - @ai-sdk/provider@4.0.0-beta.9
+  - @ai-sdk/provider-utils@5.0.0-beta.15
+
+## 4.0.0-beta.25
+
+### 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.24
+
+### Patch Changes
+
+- Updated dependencies [b0c2869]
+- Updated dependencies [7e26e81]
+  - @ai-sdk/provider-utils@5.0.0-beta.13
+
 ## 4.0.0-beta.23
 
 ### Patch Changes

package/dist/index.d.mts

@@ -1,5 +1,5 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
-import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4, FilesV4 } from '@ai-sdk/provider';
+import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4, FilesV4, SkillsV4 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction } from '@ai-sdk/provider-utils';
 
@@ -853,7 +853,7 @@ declare const openaiTools: {
             };
             skills?: Array<{
                 type: "skillReference";
-                skillId: string;
+                providerReference: _ai_sdk_provider.SharedV4ProviderReference;
                 version?: string;
             } | {
                 type: "inline";
@@ -1098,6 +1098,10 @@ interface OpenAIProvider extends ProviderV4 {
      * Returns a FilesV4 interface for uploading files to OpenAI.
      */
     files(): FilesV4;
+    /**
+     * Returns a SkillsV4 interface for uploading skills to OpenAI.
+     */
+    skills(): SkillsV4;
     /**
      * OpenAI-specific tools.
      */

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _ai_sdk_provider from '@ai-sdk/provider';
-import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4, FilesV4 } from '@ai-sdk/provider';
+import { JSONValue, ProviderV4, LanguageModelV4, EmbeddingModelV4, ImageModelV4, TranscriptionModelV4, SpeechModelV4, FilesV4, SkillsV4 } from '@ai-sdk/provider';
 import * as _ai_sdk_provider_utils from '@ai-sdk/provider-utils';
 import { InferSchema, FetchFunction } from '@ai-sdk/provider-utils';
 
@@ -853,7 +853,7 @@ declare const openaiTools: {
             };
             skills?: Array<{
                 type: "skillReference";
-                skillId: string;
+                providerReference: _ai_sdk_provider.SharedV4ProviderReference;
                 version?: string;
             } | {
                 type: "inline";
@@ -1098,6 +1098,10 @@ interface OpenAIProvider extends ProviderV4 {
      * Returns a FilesV4 interface for uploading files to OpenAI.
      */
     files(): FilesV4;
+    /**
+     * Returns a SkillsV4 interface for uploading skills to OpenAI.
+     */
+    skills(): SkillsV4;
     /**
      * OpenAI-specific tools.
      */

package/dist/index.js

@@ -27,7 +27,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/openai-provider.ts
-var import_provider_utils38 = require("@ai-sdk/provider-utils");
+var import_provider_utils40 = require("@ai-sdk/provider-utils");
 
 // src/chat/openai-chat-language-model.ts
 var import_provider3 = require("@ai-sdk/provider");
@@ -2328,7 +2328,7 @@ var shellSkillsSchema = import_v417.z.array(
   import_v417.z.discriminatedUnion("type", [
     import_v417.z.object({
       type: import_v417.z.literal("skillReference"),
-      skillId: import_v417.z.string(),
+      providerReference: import_v417.z.record(import_v417.z.string(), import_v417.z.string()),
       version: import_v417.z.string().optional()
     }),
     import_v417.z.object({
@@ -4761,19 +4761,25 @@ function mapShellEnvironment(environment) {
 }
 function mapShellSkills(skills) {
   return skills == null ? void 0 : skills.map(
-    (skill) => skill.type === "skillReference" ? {
-      type: "skill_reference",
-      skill_id: skill.skillId,
-      version: skill.version
-    } : {
-      type: "inline",
-      name: skill.name,
-      description: skill.description,
-      source: {
-        type: "base64",
-        media_type: skill.source.mediaType,
-        data: skill.source.data
-      }
+    (skill) => {
+      var _a, _b;
+      return skill.type === "skillReference" ? {
+        type: "skill_reference",
+        skill_id: (0, import_provider_utils31.resolveProviderReference)({
+          reference: (_a = skill.providerReference) != null ? _a : {},
+          provider: "openai"
+        }),
+        version: (_b = skill.version) != null ? _b : "latest"
+      } : {
+        type: "inline",
+        name: skill.name,
+        description: skill.description,
+        source: {
+          type: "base64",
+          media_type: skill.source.mediaType,
+          data: skill.source.data
+        }
+      };
     }
   );
 }
@@ -6855,22 +6861,101 @@ var OpenAITranscriptionModel = class {
   }
 };
 
+// src/skills/openai-skills.ts
+var import_provider_utils39 = require("@ai-sdk/provider-utils");
+
+// src/skills/openai-skills-api.ts
+var import_provider_utils38 = require("@ai-sdk/provider-utils");
+var import_v428 = require("zod/v4");
+var openaiSkillResponseSchema = (0, import_provider_utils38.lazySchema)(
+  () => (0, import_provider_utils38.zodSchema)(
+    import_v428.z.object({
+      id: import_v428.z.string(),
+      name: import_v428.z.string().nullish(),
+      description: import_v428.z.string().nullish(),
+      default_version: import_v428.z.string().nullish(),
+      latest_version: import_v428.z.string().nullish(),
+      created_at: import_v428.z.number(),
+      updated_at: import_v428.z.number().nullish()
+    })
+  )
+);
+var openaiSkillVersionResponseSchema = (0, import_provider_utils38.lazySchema)(
+  () => (0, import_provider_utils38.zodSchema)(
+    import_v428.z.object({
+      id: import_v428.z.string(),
+      version: import_v428.z.string().nullish(),
+      name: import_v428.z.string().nullish(),
+      description: import_v428.z.string().nullish()
+    })
+  )
+);
+
+// src/skills/openai-skills.ts
+var OpenAISkills = class {
+  constructor(config) {
+    this.config = config;
+    this.specificationVersion = "v4";
+  }
+  get provider() {
+    return this.config.provider;
+  }
+  async uploadSkill(params) {
+    const warnings = [];
+    if (params.displayTitle != null) {
+      warnings.push({
+        type: "unsupported",
+        feature: "displayTitle"
+      });
+    }
+    const formData = new FormData();
+    for (const file of params.files) {
+      const content = typeof file.content === "string" ? (0, import_provider_utils39.convertBase64ToUint8Array)(file.content) : file.content;
+      formData.append("files[]", new Blob([content]), file.path);
+    }
+    const { value: response } = await (0, import_provider_utils39.postFormDataToApi)({
+      url: this.config.url({ path: "/skills" }),
+      headers: (0, import_provider_utils39.combineHeaders)(this.config.headers()),
+      formData,
+      failedResponseHandler: openaiFailedResponseHandler,
+      successfulResponseHandler: (0, import_provider_utils39.createJsonResponseHandler)(
+        openaiSkillResponseSchema
+      ),
+      fetch: this.config.fetch
+    });
+    return {
+      providerReference: { openai: response.id },
+      ...response.name != null ? { name: response.name } : {},
+      ...response.description != null ? { description: response.description } : {},
+      ...response.latest_version != null ? { latestVersion: response.latest_version } : {},
+      providerMetadata: {
+        openai: {
+          ...response.default_version != null ? { defaultVersion: response.default_version } : {},
+          ...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.23" : "0.0.0-test";
+var VERSION = true ? "4.0.0-beta.26" : "0.0.0-test";
 
 // src/openai-provider.ts
 function createOpenAI(options = {}) {
   var _a, _b;
-  const baseURL = (_a = (0, import_provider_utils38.withoutTrailingSlash)(
-    (0, import_provider_utils38.loadOptionalSetting)({
+  const baseURL = (_a = (0, import_provider_utils40.withoutTrailingSlash)(
+    (0, import_provider_utils40.loadOptionalSetting)({
       settingValue: options.baseURL,
       environmentVariableName: "OPENAI_BASE_URL"
     })
   )) != null ? _a : "https://api.openai.com/v1";
   const providerName = (_b = options.name) != null ? _b : "openai";
-  const getHeaders = () => (0, import_provider_utils38.withUserAgentSuffix)(
+  const getHeaders = () => (0, import_provider_utils40.withUserAgentSuffix)(
     {
-      Authorization: `Bearer ${(0, import_provider_utils38.loadApiKey)({
+      Authorization: `Bearer ${(0, import_provider_utils40.loadApiKey)({
         apiKey: options.apiKey,
         environmentVariableName: "OPENAI_API_KEY",
         description: "OpenAI"
@@ -6923,6 +7008,12 @@ function createOpenAI(options = {}) {
     headers: getHeaders,
     fetch: options.fetch
   });
+  const createSkills = () => new OpenAISkills({
+    provider: `${providerName}.skills`,
+    url: ({ path }) => `${baseURL}${path}`,
+    headers: getHeaders,
+    fetch: options.fetch
+  });
   const createLanguageModel = (modelId) => {
     if (new.target) {
       throw new Error(
@@ -6960,6 +7051,7 @@ function createOpenAI(options = {}) {
   provider.speech = createSpeechModel;
   provider.speechModel = createSpeechModel;
   provider.files = createFiles;
+  provider.skills = createSkills;
   provider.tools = openaiTools;
   return provider;
 }