@ai-sdk/openai 4.0.18 → 4.0.20

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

@@ -1,5 +1,7 @@
 import {
   UnsupportedFunctionalityError,
+  type JSONSchema7,
+  type JSONObject,
   type LanguageModelV4CallOptions,
   type LanguageModelV4FunctionTool,
   type SharedV4ProviderReference,
@@ -24,8 +26,10 @@ import type {
   OpenAIResponsesTool,
 } from './openai-responses-api';
 
-type OpenAIToolOptions = {
+export type OpenAIToolOptions = {
+  allowedCallers?: Array<'direct' | 'programmatic'>;
   deferLoading?: boolean;
+  outputSchema?: JSONObject;
   namespace?: {
     name: string;
     description: string;
@@ -63,6 +67,7 @@ export async function prepareResponsesTools({
     | { type: 'image_generation' }
     | { type: 'apply_patch' }
     | { type: 'computer' }
+    | { type: 'programmatic_tool_calling' }
     | {
         type: 'allowed_tools';
         mode: 'auto' | 'required';
@@ -312,6 +317,12 @@ export async function prepareResponsesTools({
             resolvedCustomProviderToolNames.add(tool.name);
             break;
           }
+          case 'openai.programmatic_tool_calling': {
+            openaiTools.push({
+              type: 'programmatic_tool_calling',
+            });
+            break;
+          }
           case 'openai.tool_search': {
             const args = await validateTypes({
               value: tool.args,
@@ -382,7 +393,8 @@ export async function prepareResponsesTools({
           resolvedToolName === 'web_search' ||
           resolvedToolName === 'mcp' ||
           resolvedToolName === 'apply_patch' ||
-          resolvedToolName === 'computer'
+          resolvedToolName === 'computer' ||
+          resolvedToolName === 'programmatic_tool_calling'
             ? { type: resolvedToolName }
             : resolvedCustomProviderToolNames.has(resolvedToolName)
               ? { type: 'custom', name: resolvedToolName }
@@ -415,6 +427,12 @@ function prepareFunctionTool({
     parameters: tool.inputSchema,
     ...(tool.strict != null ? { strict: tool.strict } : {}),
     ...(deferLoading != null ? { defer_loading: deferLoading } : {}),
+    ...(options?.allowedCallers != null
+      ? { allowed_callers: options.allowedCallers }
+      : {}),
+    ...(options?.outputSchema != null
+      ? { output_schema: options.outputSchema as JSONSchema7 }
+      : {}),
   };
 }
 

package/src/tool/programmatic-tool-calling.ts

@@ -0,0 +1,57 @@
+import {
+  createProviderExecutedToolFactory,
+  lazySchema,
+  zodSchema,
+} from '@ai-sdk/provider-utils';
+import { z } from 'zod/v4';
+
+export const programmaticToolCallingInputSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      code: z.string(),
+      fingerprint: z.string(),
+    }),
+  ),
+);
+
+export const programmaticToolCallingOutputSchema = lazySchema(() =>
+  zodSchema(
+    z.object({
+      result: z.string(),
+      status: z.enum(['completed', 'incomplete']),
+    }),
+  ),
+);
+
+const programmaticToolCallingFactory = createProviderExecutedToolFactory<
+  {
+    /**
+     * JavaScript source generated and executed by OpenAI.
+     */
+    code: string;
+
+    /**
+     * Opaque replay fingerprint that must be preserved across requests.
+     */
+    fingerprint: string;
+  },
+  {
+    /**
+     * The result emitted by the hosted JavaScript program.
+     */
+    result: string;
+
+    /**
+     * Whether the program completed or stopped before producing a final result.
+     */
+    status: 'completed' | 'incomplete';
+  },
+  {}
+>({
+  id: 'openai.programmatic_tool_calling',
+  inputSchema: programmaticToolCallingInputSchema,
+  outputSchema: programmaticToolCallingOutputSchema,
+  supportsDeferredResults: true,
+});
+
+export const programmaticToolCalling = () => programmaticToolCallingFactory({});