@ai-sdk/openai 4.0.0-beta.22 → 4.0.0-beta.25

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/openai",
-  "version": "4.0.0-beta.22",
+  "version": "4.0.0-beta.25",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -36,8 +36,8 @@
     }
   },
   "dependencies": {
-    "@ai-sdk/provider": "4.0.0-beta.7",
-    "@ai-sdk/provider-utils": "5.0.0-beta.11"
+    "@ai-sdk/provider": "4.0.0-beta.8",
+    "@ai-sdk/provider-utils": "5.0.0-beta.14"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/openai-provider.ts

@@ -5,6 +5,7 @@ import {
   LanguageModelV4,
   ProviderV4,
   SpeechModelV4,
+  SkillsV4,
   TranscriptionModelV4,
 } from '@ai-sdk/provider';
 import {
@@ -30,6 +31,7 @@ import { OpenAISpeechModel } from './speech/openai-speech-model';
 import { OpenAISpeechModelId } from './speech/openai-speech-options';
 import { OpenAITranscriptionModel } from './transcription/openai-transcription-model';
 import { OpenAITranscriptionModelId } from './transcription/openai-transcription-options';
+import { OpenAISkills } from './skills/openai-skills';
 import { VERSION } from './version';
 
 export interface OpenAIProvider extends ProviderV4 {
@@ -100,6 +102,11 @@ export interface OpenAIProvider extends ProviderV4 {
    */
   files(): FilesV4;
 
+  /**
+   * Returns a SkillsV4 interface for uploading skills to OpenAI.
+   */
+  skills(): SkillsV4;
+
   /**
    * OpenAI-specific tools.
    */
@@ -231,6 +238,14 @@ export function createOpenAI(
       fetch: options.fetch,
     });
 
+  const createSkills = () =>
+    new OpenAISkills({
+      provider: `${providerName}.skills`,
+      url: ({ path }) => `${baseURL}${path}`,
+      headers: getHeaders,
+      fetch: options.fetch,
+    });
+
   const createLanguageModel = (modelId: OpenAIResponsesModelId) => {
     if (new.target) {
       throw new Error(
@@ -274,8 +289,8 @@ export function createOpenAI(
 
   provider.speech = createSpeechModel;
   provider.speechModel = createSpeechModel;
-
   provider.files = createFiles;
+  provider.skills = createSkills;
 
   provider.tools = openaiTools;
 

package/src/responses/openai-responses-prepare-tools.ts

@@ -1,9 +1,14 @@
 import {
   LanguageModelV4CallOptions,
+  SharedV4ProviderReference,
   SharedV4Warning,
   UnsupportedFunctionalityError,
 } from '@ai-sdk/provider';
-import { ToolNameMapping, validateTypes } from '@ai-sdk/provider-utils';
+import {
+  resolveProviderReference,
+  ToolNameMapping,
+  validateTypes,
+} from '@ai-sdk/provider-utils';
 import { codeInterpreterArgsSchema } from '../tool/code-interpreter';
 import { fileSearchArgsSchema } from '../tool/file-search';
 import { imageGenerationArgsSchema } from '../tool/image-generation';
@@ -360,7 +365,7 @@ function mapShellEnvironment(environment: {
       };
       skills?: Array<{
         type: string;
-        skillId?: string;
+        providerReference?: SharedV4ProviderReference;
         version?: string;
         name?: string;
         description?: string;
@@ -404,7 +409,7 @@ function mapShellSkills(
   skills:
     | Array<{
         type: string;
-        skillId?: string;
+        providerReference?: SharedV4ProviderReference;
         version?: string;
         name?: string;
         description?: string;
@@ -416,8 +421,11 @@ function mapShellSkills(
     skill.type === 'skillReference'
       ? {
           type: 'skill_reference' as const,
-          skill_id: skill.skillId!,
-          version: skill.version,
+          skill_id: resolveProviderReference({
+            reference: skill.providerReference ?? {},
+            provider: 'openai',
+          }),
+          version: skill.version ?? 'latest',
         }
       : {
           type: 'inline' as const,

package/src/skills/openai-skills-api.ts

@@ -0,0 +1,31 @@
+import { lazySchema, zodSchema } from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+export const openaiSkillResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      id: z.string(),
+      name: z.string().nullish(),
+      description: z.string().nullish(),
+      default_version: z.string().nullish(),
+      latest_version: z.string().nullish(),
+      created_at: z.number(),
+      updated_at: z.number().nullish(),
+    }),
+  ),
+);
+
+export type OpenAISkillResponse = ReturnType<
+  typeof openaiSkillResponseSchema
+>['_type'];
+
+export const openaiSkillVersionResponseSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      id: z.string(),
+      version: z.string().nullish(),
+      name: z.string().nullish(),
+      description: z.string().nullish(),
+    }),
+  ),
+);

package/src/skills/openai-skills.ts

@@ -0,0 +1,87 @@
+import { SkillsV4, SharedV4Warning } from '@ai-sdk/provider';
+import {
+  combineHeaders,
+  convertBase64ToUint8Array,
+  createJsonResponseHandler,
+  FetchFunction,
+  postFormDataToApi,
+} from '@ai-sdk/provider-utils';
+import { openaiFailedResponseHandler } from '../openai-error';
+import { openaiSkillResponseSchema } from './openai-skills-api';
+
+interface OpenAISkillsConfig {
+  provider: string;
+  url: (options: { path: string }) => string;
+  headers: () => Record<string, string | undefined>;
+  fetch?: FetchFunction;
+}
+
+export class OpenAISkills implements SkillsV4 {
+  readonly specificationVersion = 'v4';
+
+  get provider(): string {
+    return this.config.provider;
+  }
+
+  constructor(private readonly config: OpenAISkillsConfig) {}
+
+  async upload(
+    params: Parameters<SkillsV4['upload']>[0],
+  ): Promise<Awaited<ReturnType<SkillsV4['upload']>>> {
+    const warnings: SharedV4Warning[] = [];
+
+    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'
+          ? convertBase64ToUint8Array(file.content)
+          : file.content;
+
+      formData.append('files[]', new Blob([content]), file.path);
+    }
+
+    const { value: response } = await postFormDataToApi({
+      url: this.config.url({ path: '/skills' }),
+      headers: combineHeaders(this.config.headers()),
+      formData,
+      failedResponseHandler: openaiFailedResponseHandler,
+      successfulResponseHandler: 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,
+    };
+  }
+}

package/src/tool/shell.ts

@@ -3,6 +3,7 @@ import {
   lazySchema,
   zodSchema,
 } from '@ai-sdk/provider-utils';
+import type { SharedV4ProviderReference } from '@ai-sdk/provider';
 import { z } from 'zod/v4';
 
 export const shellInputSchema = lazySchema(() =>
@@ -39,7 +40,7 @@ const shellSkillsSchema = z
     z.discriminatedUnion('type', [
       z.object({
         type: z.literal('skillReference'),
-        skillId: z.string(),
+        providerReference: z.record(z.string(), z.string()),
         version: z.string().optional(),
       }),
       z.object({
@@ -125,7 +126,11 @@ type ShellArgs = {
               }>;
             };
         skills?: Array<
-          | { type: 'skillReference'; skillId: string; version?: string }
+          | {
+              type: 'skillReference';
+              providerReference: SharedV4ProviderReference;
+              version?: string;
+            }
           | {
               type: 'inline';
               name: string;