@providerprotocol/ai 0.0.7 → 0.0.9

package/dist/anthropic/index.js

@@ -6,7 +6,7 @@ import {
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-QUUX4G7U.js";
+} from "../chunk-W4BB4BG2.js";
 import {
   parseSSEStream
 } from "../chunk-X5G4EHL7.js";

package/dist/{chunk-QUUX4G7U.js → chunk-W4BB4BG2.js}

@@ -30,6 +30,24 @@ var Message = class {
   get text() {
     return this.getContent().filter((block) => block.type === "text").map((block) => block.text).join("\n\n");
   }
+  /**
+   * Convenience accessor for image content blocks
+   */
+  get images() {
+    return this.getContent().filter((block) => block.type === "image");
+  }
+  /**
+   * Convenience accessor for audio content blocks
+   */
+  get audio() {
+    return this.getContent().filter((block) => block.type === "audio");
+  }
+  /**
+   * Convenience accessor for video content blocks
+   */
+  get video() {
+    return this.getContent().filter((block) => block.type === "video");
+  }
 };
 var UserMessage = class extends Message {
   type = "user";
@@ -114,4 +132,4 @@ export {
   isAssistantMessage,
   isToolResultMessage
 };
-//# sourceMappingURL=chunk-QUUX4G7U.js.map
+//# sourceMappingURL=chunk-W4BB4BG2.js.map

package/dist/chunk-W4BB4BG2.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/id.ts","../src/types/messages.ts"],"sourcesContent":["/**\n * Generate a unique ID\n * Uses crypto.randomUUID if available, falls back to a simple implementation\n */\nexport function generateId(): string {\n  if (typeof crypto !== 'undefined' && crypto.randomUUID) {\n    return crypto.randomUUID();\n  }\n\n  // Fallback for environments without crypto.randomUUID\n  return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === 'x' ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Generate a short ID (for tool call IDs, etc.)\n */\nexport function generateShortId(prefix = ''): string {\n  const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';\n  let result = prefix;\n  for (let i = 0; i < 12; i++) {\n    result += chars.charAt(Math.floor(Math.random() * chars.length));\n  }\n  return result;\n}\n","import { generateId } from '../utils/id.ts';\nimport type {\n  ContentBlock,\n  TextBlock,\n  ImageBlock,\n  AudioBlock,\n  VideoBlock,\n  UserContent,\n  AssistantContent,\n} from './content.ts';\nimport type { ToolCall, ToolResult } from './tool.ts';\n\n/**\n * Message type discriminator\n */\nexport type MessageType = 'user' | 'assistant' | 'tool_result';\n\n/**\n * Provider-namespaced metadata\n * Each provider uses its own namespace\n */\nexport interface MessageMetadata {\n  [provider: string]: Record<string, unknown> | undefined;\n}\n\n/**\n * Options for message construction\n */\nexport interface MessageOptions {\n  id?: string;\n  metadata?: MessageMetadata;\n}\n\n/**\n * Base message class\n * All messages inherit from this\n */\nexport abstract class Message {\n  /** Unique message identifier */\n  readonly id: string;\n\n  /** Timestamp */\n  readonly timestamp: Date;\n\n  /** Provider-specific metadata, namespaced by provider */\n  readonly metadata?: MessageMetadata;\n\n  /** Message type discriminator */\n  abstract readonly type: MessageType;\n\n  /** Raw content - implemented by subclasses */\n  protected abstract getContent(): ContentBlock[];\n\n  constructor(options?: MessageOptions) {\n    this.id = options?.id ?? generateId();\n    this.timestamp = new Date();\n    this.metadata = options?.metadata;\n  }\n\n  /**\n   * Convenience accessor for text content\n   * Concatenates all text blocks with '\\n\\n'\n   */\n  get text(): string {\n    return this.getContent()\n      .filter((block): block is TextBlock => block.type === 'text')\n      .map((block) => block.text)\n      .join('\\n\\n');\n  }\n\n  /**\n   * Convenience accessor for image content blocks\n   */\n  get images(): ImageBlock[] {\n    return this.getContent().filter((block): block is ImageBlock => block.type === 'image');\n  }\n\n  /**\n   * Convenience accessor for audio content blocks\n   */\n  get audio(): AudioBlock[] {\n    return this.getContent().filter((block): block is AudioBlock => block.type === 'audio');\n  }\n\n  /**\n   * Convenience accessor for video content blocks\n   */\n  get video(): VideoBlock[] {\n    return this.getContent().filter((block): block is VideoBlock => block.type === 'video');\n  }\n}\n\n/**\n * User input message\n */\nexport class UserMessage extends Message {\n  readonly type = 'user' as const;\n  readonly content: UserContent[];\n\n  /**\n   * @param content - String (converted to TextBlock) or array of content blocks\n   */\n  constructor(content: string | UserContent[], options?: MessageOptions) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n}\n\n/**\n * Assistant response message\n * May contain text, media, and/or tool calls\n */\nexport class AssistantMessage extends Message {\n  readonly type = 'assistant' as const;\n  readonly content: AssistantContent[];\n\n  /** Tool calls requested by the model (if any) */\n  readonly toolCalls?: ToolCall[];\n\n  /**\n   * @param content - String (converted to TextBlock) or array of content blocks\n   * @param toolCalls - Tool calls requested by the model\n   * @param options - Message ID and metadata\n   */\n  constructor(\n    content: string | AssistantContent[],\n    toolCalls?: ToolCall[],\n    options?: MessageOptions\n  ) {\n    super(options);\n    if (typeof content === 'string') {\n      this.content = [{ type: 'text', text: content }];\n    } else {\n      this.content = content;\n    }\n    this.toolCalls = toolCalls;\n  }\n\n  protected getContent(): ContentBlock[] {\n    return this.content;\n  }\n\n  /** Check if this message requests tool execution */\n  get hasToolCalls(): boolean {\n    return this.toolCalls !== undefined && this.toolCalls.length > 0;\n  }\n}\n\n/**\n * Result of tool execution (sent back to model)\n */\nexport class ToolResultMessage extends Message {\n  readonly type = 'tool_result' as const;\n  readonly results: ToolResult[];\n\n  /**\n   * @param results - Array of tool execution results\n   * @param options - Message ID and metadata\n   */\n  constructor(results: ToolResult[], options?: MessageOptions) {\n    super(options);\n    this.results = results;\n  }\n\n  protected getContent(): ContentBlock[] {\n    // Tool results don't have traditional content blocks\n    // Return text representations of results\n    return this.results.map((result) => ({\n      type: 'text' as const,\n      text:\n        typeof result.result === 'string'\n          ? result.result\n          : JSON.stringify(result.result),\n    }));\n  }\n}\n\n/**\n * Type guard for UserMessage\n */\nexport function isUserMessage(msg: Message): msg is UserMessage {\n  return msg.type === 'user';\n}\n\n/**\n * Type guard for AssistantMessage\n */\nexport function isAssistantMessage(msg: Message): msg is AssistantMessage {\n  return msg.type === 'assistant';\n}\n\n/**\n * Type guard for ToolResultMessage\n */\nexport function isToolResultMessage(msg: Message): msg is ToolResultMessage {\n  return msg.type === 'tool_result';\n}\n"],"mappings":"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","names":[]}

package/dist/google/index.js

@@ -6,7 +6,7 @@ import {
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-QUUX4G7U.js";
+} from "../chunk-W4BB4BG2.js";
 import {
   parseSSEStream
 } from "../chunk-X5G4EHL7.js";

package/dist/index.d.ts

@@ -249,6 +249,18 @@ declare abstract class Message {
      * Concatenates all text blocks with '\n\n'
      */
     get text(): string;
+    /**
+     * Convenience accessor for image content blocks
+     */
+    get images(): ImageBlock[];
+    /**
+     * Convenience accessor for audio content blocks
+     */
+    get audio(): AudioBlock[];
+    /**
+     * Convenience accessor for video content blocks
+     */
+    get video(): VideoBlock[];
 }
 /**
  * User input message

package/dist/index.js

@@ -10,7 +10,7 @@ import {
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "./chunk-QUUX4G7U.js";
+} from "./chunk-W4BB4BG2.js";
 import {
   ExponentialBackoff,
   LinearBackoff,

package/dist/ollama/index.js

@@ -6,7 +6,7 @@ import {
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-QUUX4G7U.js";
+} from "../chunk-W4BB4BG2.js";
 import {
   UPPError,
   doFetch,

package/dist/openai/index.d.ts

@@ -1,5 +1,42 @@
 import { b as Provider, M as ModelReference, a as LLMHandler } from '../provider-CUJWjgNl.js';
 
+/**
+ * Audio output configuration for Chat Completions
+ */
+interface OpenAIAudioConfig {
+    /** Audio format */
+    format: 'wav' | 'aac' | 'mp3' | 'flac' | 'opus' | 'pcm16';
+    /** Voice to use for audio generation */
+    voice: 'alloy' | 'ash' | 'ballad' | 'coral' | 'echo' | 'sage' | 'shimmer' | 'verse' | 'marin' | 'cedar';
+}
+/**
+ * User location for web search context
+ * Requires type: 'approximate' with location fields at the same level
+ */
+interface OpenAIWebSearchUserLocation {
+    /** Location type - must be 'approximate' */
+    type: 'approximate';
+    /** City name */
+    city?: string;
+    /** ISO 3166-1 country code (e.g., "US") */
+    country?: string;
+    /** Region/state name */
+    region?: string;
+    /** IANA timezone (e.g., "America/New_York") */
+    timezone?: string;
+}
+/**
+ * Web search options for Chat Completions API
+ */
+interface OpenAIWebSearchOptions {
+    /**
+     * Context size for search results
+     * Controls how much context from web results to include
+     */
+    search_context_size?: 'low' | 'medium' | 'high';
+    /** User location for localizing search results */
+    user_location?: OpenAIWebSearchUserLocation | null;
+}
 /**
  * OpenAI Chat Completions API parameters
  * These are passed through to the /v1/chat/completions endpoint
@@ -25,9 +62,9 @@ interface OpenAICompletionsParams {
     logprobs?: boolean;
     /** Number of top logprobs to return (0-20) */
     top_logprobs?: number;
-    /** Seed for deterministic sampling (beta) */
+    /** Seed for deterministic sampling (beta, deprecated) */
     seed?: number;
-    /** User identifier for abuse detection */
+    /** User identifier (deprecated, use safety_identifier or prompt_cache_key) */
     user?: string;
     /** Logit bias map */
     logit_bias?: Record<string, number>;
@@ -38,10 +75,10 @@ interface OpenAICompletionsParams {
     /** Reasoning effort for reasoning models */
     reasoning_effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
     /** Service tier */
-    service_tier?: 'auto' | 'default' | 'flex' | 'priority';
+    service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority';
     /** Store completion for distillation */
     store?: boolean;
-    /** Metadata key-value pairs */
+    /** Metadata key-value pairs (max 16, keys max 64 chars, values max 512 chars) */
     metadata?: Record<string, string>;
     /** Response format for structured output */
     response_format?: OpenAIResponseFormat;
@@ -58,19 +95,51 @@ interface OpenAICompletionsParams {
     };
     /**
      * Stable identifier for caching similar requests
-     * Used to optimize cache hit rates
+     * Used to optimize cache hit rates (replaces user field)
      */
     prompt_cache_key?: string;
     /**
      * Retention policy for prompt cache
      * Set to "24h" to enable extended prompt caching up to 24 hours
      */
-    prompt_cache_retention?: '24h';
+    prompt_cache_retention?: 'in-memory' | '24h';
     /**
      * Stable identifier for abuse detection
      * Recommend hashing username or email address
      */
     safety_identifier?: string;
+    /**
+     * Output modalities to generate
+     * Default: ["text"]. Use ["text", "audio"] for audio-capable models
+     */
+    modalities?: Array<'text' | 'audio'>;
+    /**
+     * Audio output configuration
+     * Required when modalities includes "audio"
+     */
+    audio?: OpenAIAudioConfig | null;
+    /**
+     * Web search configuration
+     * Enables the model to search the web for up-to-date information
+     */
+    web_search_options?: OpenAIWebSearchOptions;
+}
+/**
+ * Prompt template reference for Responses API
+ */
+interface OpenAIPromptTemplate {
+    /** Prompt template ID */
+    id: string;
+    /** Variables to fill into the template */
+    variables?: Record<string, string>;
+}
+/**
+ * Conversation reference for Responses API
+ * Items from this conversation are prepended to input_items
+ */
+interface OpenAIConversation {
+    /** Conversation ID */
+    id: string;
 }
 /**
  * OpenAI Responses API parameters
@@ -83,27 +152,91 @@ interface OpenAIResponsesParams {
     temperature?: number;
     /** Top-p (nucleus) sampling (0.0 - 1.0) */
     top_p?: number;
+    /** Number of top logprobs to return (0-20) */
+    top_logprobs?: number;
     /** Whether to enable parallel tool calls */
     parallel_tool_calls?: boolean;
-    /** Reasoning configuration */
+    /** Reasoning configuration (for gpt-5 and o-series models) */
     reasoning?: {
         effort?: 'none' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
-        summary?: string;
+        /** Include summary of reasoning */
+        summary?: 'auto' | 'concise' | 'detailed';
     };
     /** Service tier */
-    service_tier?: 'auto' | 'default' | 'flex' | 'priority';
+    service_tier?: 'auto' | 'default' | 'flex' | 'scale' | 'priority';
     /** Truncation strategy */
     truncation?: 'auto' | 'disabled';
-    /** Fields to include in output */
+    /**
+     * Fields to include in output
+     * Supported values:
+     * - 'web_search_call.action.sources': Include web search sources
+     * - 'code_interpreter_call.outputs': Include code execution outputs
+     * - 'computer_call_output.output.image_url': Include computer call images
+     * - 'file_search_call.results': Include file search results
+     * - 'message.input_image.image_url': Include input image URLs
+     * - 'message.output_text.logprobs': Include logprobs with messages
+     * - 'reasoning.encrypted_content': Include encrypted reasoning tokens
+     */
     include?: string[];
-    /** Background processing */
+    /** Background processing - run response asynchronously */
     background?: boolean;
-    /** Continue from a previous response */
+    /** Continue from a previous response (cannot use with conversation) */
     previous_response_id?: string;
+    /**
+     * Conversation context - items prepended to input_items
+     * Cannot be used with previous_response_id
+     */
+    conversation?: string | OpenAIConversation;
     /** Store response for continuation */
     store?: boolean;
-    /** Metadata key-value pairs */
+    /** Metadata key-value pairs (max 16, keys max 64 chars, values max 512 chars) */
     metadata?: Record<string, string>;
+    /**
+     * Maximum total calls to built-in tools in a response
+     * Applies across all built-in tool calls, not per tool
+     */
+    max_tool_calls?: number;
+    /**
+     * Reference to a prompt template and its variables
+     */
+    prompt?: OpenAIPromptTemplate;
+    /**
+     * Stable identifier for caching similar requests
+     * Used to optimize cache hit rates (replaces user field)
+     */
+    prompt_cache_key?: string;
+    /**
+     * Retention policy for prompt cache
+     * Set to "24h" to enable extended prompt caching up to 24 hours
+     */
+    prompt_cache_retention?: 'in-memory' | '24h';
+    /**
+     * Stable identifier for abuse detection
+     * Recommend hashing username or email address
+     */
+    safety_identifier?: string;
+    /** User identifier (deprecated, use safety_identifier or prompt_cache_key) */
+    user?: string;
+    /**
+     * Built-in tools for the Responses API
+     * Use the tool helper constructors: tools.webSearch(), tools.imageGeneration(), etc.
+     *
+     * @example
+     * ```ts
+     * import { tools } from 'provider-protocol/openai';
+     *
+     * const model = llm({
+     *   model: openai('gpt-4o'),
+     *   params: {
+     *     tools: [
+     *       tools.webSearch(),
+     *       tools.imageGeneration({ quality: 'high' }),
+     *     ],
+     *   },
+     * });
+     * ```
+     */
+    tools?: OpenAIBuiltInTool[];
 }
 /**
  * API mode for OpenAI provider
@@ -146,6 +279,244 @@ type OpenAIResponseFormat = {
         strict?: boolean;
     };
 };
+/**
+ * Tool definition for Responses API
+ */
+interface OpenAIResponsesTool {
+    type: 'function';
+    name: string;
+    description: string;
+    parameters: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    strict?: boolean;
+}
+/**
+ * Web search tool for Responses API
+ * Enables the model to search the web for up-to-date information
+ */
+interface OpenAIWebSearchTool {
+    type: 'web_search';
+    /**
+     * Context size for search results
+     * Controls how much context from web results to include
+     */
+    search_context_size?: 'low' | 'medium' | 'high';
+    /** User location for localizing search results */
+    user_location?: OpenAIWebSearchUserLocation | null;
+}
+/**
+ * File search tool for Responses API
+ * Enables the model to search through uploaded files
+ */
+interface OpenAIFileSearchTool {
+    type: 'file_search';
+    /** File search configuration */
+    file_search?: {
+        /** Vector store IDs to search */
+        vector_store_ids: string[];
+        /** Maximum number of results to return */
+        max_num_results?: number;
+        /** Ranking options for search results */
+        ranking_options?: {
+            /** Ranker to use */
+            ranker?: 'auto' | 'default_2024_08_21';
+            /** Score threshold (0-1) */
+            score_threshold?: number;
+        };
+        /** Filters to apply */
+        filters?: Record<string, unknown>;
+    };
+}
+/**
+ * Code interpreter container configuration
+ */
+interface OpenAICodeInterpreterContainer {
+    /** Container type - 'auto' creates a new container */
+    type: 'auto';
+    /** Memory limit for the container (e.g., '1g', '4g') */
+    memory_limit?: string;
+    /** File IDs to make available in the container */
+    file_ids?: string[];
+}
+/**
+ * Code interpreter tool for Responses API
+ * Allows the model to write and run Python code
+ */
+interface OpenAICodeInterpreterTool {
+    type: 'code_interpreter';
+    /** Code interpreter configuration */
+    code_interpreter?: {
+        /** Container configuration */
+        container: string | OpenAICodeInterpreterContainer;
+    };
+}
+/**
+ * Computer tool environment configuration
+ */
+interface OpenAIComputerEnvironment {
+    /** Environment type */
+    type: 'browser' | 'mac' | 'windows' | 'linux' | 'ubuntu';
+}
+/**
+ * Computer tool for Responses API
+ * Enables the model to interact with computer interfaces
+ */
+interface OpenAIComputerTool {
+    type: 'computer';
+    /** Computer tool configuration */
+    computer?: {
+        /** Display width in pixels */
+        display_width: number;
+        /** Display height in pixels */
+        display_height: number;
+        /** Environment configuration */
+        environment?: OpenAIComputerEnvironment;
+    };
+}
+/**
+ * Image generation tool for Responses API
+ */
+interface OpenAIImageGenerationTool {
+    type: 'image_generation';
+    /** Background transparency */
+    background?: 'transparent' | 'opaque' | 'auto';
+    /** Input image formats supported */
+    input_image_mask?: boolean;
+    /** Model to use for generation */
+    model?: string;
+    /** Moderation level */
+    moderation?: 'auto' | 'low';
+    /** Output compression */
+    output_compression?: number;
+    /** Output format */
+    output_format?: 'png' | 'jpeg' | 'webp';
+    /** Partial images during streaming */
+    partial_images?: number;
+    /** Image quality */
+    quality?: 'auto' | 'high' | 'medium' | 'low';
+    /** Image size */
+    size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024';
+}
+/**
+ * MCP (Model Context Protocol) server configuration
+ */
+interface OpenAIMcpServerConfig {
+    /** Server URL */
+    url: string;
+    /** Server name for identification */
+    name?: string;
+    /** Tool configuration for the server */
+    tool_configuration?: {
+        /** Allowed tools from this server */
+        allowed_tools?: string[] | {
+            type: 'all';
+        };
+    };
+    /** Headers to send with requests */
+    headers?: Record<string, string>;
+    /** Allowed resources */
+    allowed_resources?: string[];
+    /** Require approval for tool calls */
+    require_approval?: 'always' | 'never' | {
+        type: 'except';
+        tools: string[];
+    };
+}
+/**
+ * MCP tool for Responses API
+ * Enables connections to MCP servers
+ */
+interface OpenAIMcpTool {
+    type: 'mcp';
+    /** MCP server configurations */
+    mcp?: {
+        /** Server configuration */
+        server: OpenAIMcpServerConfig;
+    };
+}
+/**
+ * Union type for all Responses API built-in tools
+ */
+type OpenAIBuiltInTool = OpenAIWebSearchTool | OpenAIFileSearchTool | OpenAICodeInterpreterTool | OpenAIComputerTool | OpenAIImageGenerationTool | OpenAIMcpTool;
+/**
+ * Combined tool type for Responses API (built-in or function)
+ */
+type OpenAIResponsesToolUnion = OpenAIResponsesTool | OpenAIBuiltInTool;
+/**
+ * Helper to create a web search tool
+ * Note: Configuration options are passed at the top level, not nested
+ */
+declare function webSearchTool(options?: {
+    search_context_size?: 'low' | 'medium' | 'high';
+    user_location?: OpenAIWebSearchUserLocation | null;
+}): OpenAIWebSearchTool;
+/**
+ * Helper to create a file search tool
+ */
+declare function fileSearchTool(options: {
+    vector_store_ids: string[];
+    max_num_results?: number;
+    ranking_options?: {
+        ranker?: 'auto' | 'default_2024_08_21';
+        score_threshold?: number;
+    };
+    filters?: Record<string, unknown>;
+}): OpenAIFileSearchTool;
+/**
+ * Helper to create a code interpreter tool
+ */
+declare function codeInterpreterTool(options?: {
+    container?: string | OpenAICodeInterpreterContainer;
+}): OpenAICodeInterpreterTool;
+/**
+ * Helper to create a computer tool
+ */
+declare function computerTool(options: {
+    display_width: number;
+    display_height: number;
+    environment?: OpenAIComputerEnvironment;
+}): OpenAIComputerTool;
+/**
+ * Helper to create an image generation tool
+ * Note: Configuration options are passed at the top level, not nested
+ */
+declare function imageGenerationTool(options?: {
+    background?: 'transparent' | 'opaque' | 'auto';
+    model?: string;
+    quality?: 'auto' | 'high' | 'medium' | 'low';
+    size?: 'auto' | '1024x1024' | '1024x1536' | '1536x1024';
+    output_format?: 'png' | 'jpeg' | 'webp';
+}): OpenAIImageGenerationTool;
+/**
+ * Helper to create an MCP tool
+ */
+declare function mcpTool(options: {
+    url: string;
+    name?: string;
+    allowed_tools?: string[] | {
+        type: 'all';
+    };
+    headers?: Record<string, string>;
+    require_approval?: 'always' | 'never' | {
+        type: 'except';
+        tools: string[];
+    };
+}): OpenAIMcpTool;
+/**
+ * Namespace for tool helper constructors
+ */
+declare const tools: {
+    webSearch: typeof webSearchTool;
+    fileSearch: typeof fileSearchTool;
+    codeInterpreter: typeof codeInterpreterTool;
+    computer: typeof computerTool;
+    imageGeneration: typeof imageGenerationTool;
+    mcp: typeof mcpTool;
+};
 
 /** Union type for modalities interface */
 type OpenAILLMParamsUnion = OpenAICompletionsParams | OpenAIResponsesParams;
@@ -220,4 +591,4 @@ interface OpenAIProvider extends Provider<OpenAIProviderOptions> {
  */
 declare const openai: OpenAIProvider;
 
-export { type OpenAIAPIMode, type OpenAICompletionsParams, type OpenAIConfig, type OpenAIModelOptions, type OpenAIModelReference, type OpenAIResponsesParams, openai };
+export { type OpenAIAPIMode, type OpenAIAudioConfig, type OpenAIBuiltInTool, type OpenAICodeInterpreterContainer, type OpenAICodeInterpreterTool, type OpenAICompletionsParams, type OpenAIComputerEnvironment, type OpenAIComputerTool, type OpenAIConfig, type OpenAIConversation, type OpenAIFileSearchTool, type OpenAIImageGenerationTool, type OpenAIMcpServerConfig, type OpenAIMcpTool, type OpenAIModelOptions, type OpenAIModelReference, type OpenAIPromptTemplate, type OpenAIResponsesParams, type OpenAIResponsesToolUnion, type OpenAIWebSearchOptions, type OpenAIWebSearchTool, type OpenAIWebSearchUserLocation, codeInterpreterTool, computerTool, fileSearchTool, imageGenerationTool, mcpTool, openai, tools, webSearchTool };