@openrouter/ai-sdk-provider 1.5.4 → 6.0.0-alpha.0

package/dist/internal/index.d.mts

@@ -1,410 +1,364 @@
-import { LanguageModelV2, LanguageModelV2CallOptions, LanguageModelV2Content, LanguageModelV2FinishReason, LanguageModelV2Usage, LanguageModelV2CallWarning, LanguageModelV2ResponseMetadata, SharedV2Headers, LanguageModelV2StreamPart } from '@ai-sdk/provider';
-export { LanguageModelV2, LanguageModelV2Prompt } from '@ai-sdk/provider';
-import { z } from 'zod/v4';
-import * as models from '@openrouter/sdk/models';
+import { LanguageModelV3Usage, JSONObject, LanguageModelV3FinishReason, LanguageModelV3Prompt } from '@ai-sdk/provider';
+import { ChatGenerationTokenUsage } from '@openrouter/sdk/models';
 
-declare enum ReasoningFormat {
-    Unknown = "unknown",
-    OpenAIResponsesV1 = "openai-responses-v1",
-    XAIResponsesV1 = "xai-responses-v1",
-    AnthropicClaudeV1 = "anthropic-claude-v1",
-    GoogleGeminiV1 = "google-gemini-v1"
-}
-
-declare enum ReasoningDetailType {
-    Summary = "reasoning.summary",
-    Encrypted = "reasoning.encrypted",
-    Text = "reasoning.text"
+/**
+ * Raw usage data from OpenRouter API response.
+ */
+interface OpenRouterRawUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    inputTokensDetails?: {
+        cachedTokens?: number;
+    };
+    outputTokensDetails?: {
+        reasoningTokens?: number;
+    };
 }
-declare const ReasoningDetailUnionSchema: z.ZodUnion<readonly [z.ZodObject<{
-    type: z.ZodLiteral<ReasoningDetailType.Summary>;
-    summary: z.ZodString;
-    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    format: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof ReasoningFormat>>>;
-    index: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<ReasoningDetailType.Encrypted>;
-    data: z.ZodString;
-    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    format: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof ReasoningFormat>>>;
-    index: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>, z.ZodObject<{
-    type: z.ZodLiteral<ReasoningDetailType.Text>;
-    text: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    signature: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    format: z.ZodOptional<z.ZodNullable<z.ZodEnum<typeof ReasoningFormat>>>;
-    index: z.ZodOptional<z.ZodNumber>;
-}, z.core.$strip>]>;
-type ReasoningDetailUnion = z.infer<typeof ReasoningDetailUnionSchema>;
+/**
+ * Builds a LanguageModelV3Usage object from OpenRouter API usage data.
+ *
+ * @param usage - The raw usage data from the OpenRouter API response.
+ * @returns A LanguageModelV3Usage object with standardized token counts.
+ */
+declare function buildUsage(usage: OpenRouterRawUsage | undefined): LanguageModelV3Usage;
 
-type OpenRouterChatModelId = string;
-type OpenRouterChatSettings = {
-    /**
-  Modify the likelihood of specified tokens appearing in the completion.
-  
-  Accepts a JSON object that maps tokens (specified by their token ID in
-  the GPT tokenizer) to an associated bias value from -100 to 100. You
-  can use this tokenizer tool to convert text to token IDs. Mathematically,
-  the bias is added to the logits generated by the model prior to sampling.
-  The exact effect will vary per model, but values between -1 and 1 should
-  decrease or increase likelihood of selection; values like -100 or 100
-  should result in a ban or exclusive selection of the relevant token.
-  
-  As an example, you can pass {"50256": -100} to prevent the <|endoftext|>
-  token from being generated.
-  */
-    logitBias?: Record<number, number>;
-    /**
-  Return the log probabilities of the tokens. Including logprobs will increase
-  the response size and can slow down response times. However, it can
-  be useful to understand better how the model is behaving.
-  
-  Setting to true will return the log probabilities of the tokens that
-  were generated.
-  
-  Setting to a number will return the log probabilities of the top n
-  tokens that were generated.
-  */
-    logprobs?: boolean | number;
+/**
+ * OpenRouter-specific provider metadata structure.
+ */
+interface OpenRouterProviderMetadata {
     /**
-  Whether to enable parallel function calling during tool use. Default to true.
+     * The response ID from OpenRouter.
      */
-    parallelToolCalls?: boolean;
+    responseId?: string;
     /**
-  A unique identifier representing your end-user, which can help OpenRouter to
-  monitor and detect abuse. Learn more.
-  */
-    user?: string;
-    /**
-     * Plugin configurations for enabling various capabilities
+     * The upstream provider that served the request.
      */
-    plugins?: Array<{
-        id: models.IdWeb;
-        max_results?: number;
-        search_prompt?: string;
-        engine?: models.Engine;
-    } | {
-        id: models.IdFileParser;
-        max_files?: number;
-        pdf?: {
-            engine?: models.PdfEngine;
-        };
-    } | {
-        id: models.IdModeration;
-    }>;
+    provider?: string;
     /**
-     * Built-in web search options for models that support native web search
+     * Detailed usage information.
      */
-    web_search_options?: {
+    usage?: {
+        promptTokens?: number;
+        completionTokens?: number;
+        totalTokens?: number;
+        promptTokensDetails?: {
+            cachedTokens?: number;
+            cacheWriteTokens?: number;
+            audioTokens?: number;
+            videoTokens?: number;
+        };
+        completionTokensDetails?: {
+            reasoningTokens?: number;
+            imageTokens?: number;
+        };
         /**
-         * Maximum number of search results to include
+         * Cost in USD (omit if unavailable).
          */
-        max_results?: number;
+        cost?: number;
         /**
-         * Custom search prompt to guide the search query
+         * Whether the request used BYOK (Bring Your Own Key).
          */
-        search_prompt?: string;
+        isByok?: boolean;
         /**
-         * Search engine to use for web search
-         * - "native": Use provider's built-in web search
-         * - "exa": Use Exa's search API
-         * - undefined: Native if supported, otherwise Exa
-         * @see https://openrouter.ai/docs/features/web-search
+         * Detailed cost breakdown.
          */
-        engine?: models.Engine;
+        costDetails?: JSONObject;
     };
+}
+/**
+ * Extended prompt tokens details with fields not in SDK types.
+ */
+interface ExtendedPromptTokensDetails {
+    cachedTokens?: number | null;
+    cacheWriteTokens?: number | null;
+    audioTokens?: number | null;
+    videoTokens?: number | null;
+}
+/**
+ * Extended completion tokens details with fields not in SDK types.
+ */
+interface ExtendedCompletionTokensDetails {
+    reasoningTokens?: number | null;
+    imageTokens?: number | null;
+}
+/**
+ * Extended usage type with additional fields from raw OpenRouter API response.
+ * The SDK types don't include cost/is_byok but the API returns them.
+ */
+interface OpenRouterUsageExtended extends Omit<ChatGenerationTokenUsage, 'promptTokensDetails' | 'completionTokensDetails'> {
+    cost?: number;
+    isByok?: boolean;
+    costDetails?: JSONObject;
+    promptTokensDetails?: ExtendedPromptTokensDetails | null;
+    completionTokensDetails?: ExtendedCompletionTokensDetails | null;
+}
+/**
+ * Response data from OpenRouter API used to build provider metadata.
+ * Note: The SDK transforms snake_case to camelCase for all fields.
+ * The `provider` field exists in raw API responses but isn't in SDK types.
+ */
+interface OpenRouterResponseData {
+    id?: string;
     /**
-     * Debug options for troubleshooting API requests.
-     * Only works with streaming requests.
-     * @see https://openrouter.ai/docs/api-reference/debugging
+     * The upstream provider that served the request (e.g. "Google", "Anthropic").
+     * This field exists in the raw API response but isn't in SDK TypeScript types.
      */
-    debug?: {
-        /**
-         * When true, echoes back the request body that was sent to the upstream provider.
-         * The debug data will be returned as the first chunk in the stream with a `debug.echo_upstream_body` field.
-         * Sensitive data like user IDs and base64 content will be redacted.
-         */
-        echo_upstream_body?: boolean;
-    };
+    provider?: string;
     /**
-     * Provider routing preferences to control request routing behavior
+     * Usage data in camelCase (as transformed by SDK).
      */
-    provider?: {
-        /**
-         * List of provider slugs to try in order (e.g. ["anthropic", "openai"])
-         */
-        order?: string[];
-        /**
-         * Whether to allow backup providers when primary is unavailable (default: true)
-         */
-        allow_fallbacks?: boolean;
-        /**
-         * Only use providers that support all parameters in your request (default: false)
-         */
-        require_parameters?: boolean;
-        /**
-         * Control whether to use providers that may store data
-         */
-        data_collection?: models.DataCollection;
-        /**
-         * List of provider slugs to allow for this request
-         */
-        only?: string[];
-        /**
-         * List of provider slugs to skip for this request
-         */
-        ignore?: string[];
-        /**
-         * List of quantization levels to filter by (e.g. ["int4", "int8"])
-         */
-        quantizations?: Array<models.Quantization>;
-        /**
-         * Sort providers by price, throughput, or latency
-         */
-        sort?: models.ProviderSort;
-        /**
-         * Maximum pricing you want to pay for this request
-         */
-        max_price?: {
-            prompt?: number | string;
-            completion?: number | string;
-            image?: number | string;
-            audio?: number | string;
-            request?: number | string;
-        };
-        /**
-         * Whether to restrict routing to only ZDR (Zero Data Retention) endpoints.
-         * When true, only endpoints that do not retain prompts will be used.
-         */
-        zdr?: boolean;
-    };
-} & OpenRouterSharedSettings;
+    usage?: OpenRouterUsageExtended;
+}
+/**
+ * Builds provider metadata from OpenRouter API response data.
+ *
+ * @param response - The response data from OpenRouter API (with camelCase fields from SDK).
+ * @returns Provider metadata in the format expected by AI SDK.
+ */
+declare function buildProviderMetadata(response: OpenRouterResponseData | undefined): Record<string, JSONObject> | undefined;
 
-type OpenRouterCompletionModelId = string;
-type OpenRouterCompletionSettings = {
+/**
+ * Configuration for an OpenRouter plugin.
+ *
+ * @description
+ * Plugins extend OpenRouter functionality with features like web search, code execution,
+ * and more. Each plugin has a unique identifier and optional configuration parameters.
+ * Additional plugin-specific properties can be included as needed.
+ *
+ * @example
+ * ```ts
+ * const model = openrouter('anthropic/claude-3.5-sonnet', {
+ *   plugins: [
+ *     { id: 'web-search' },
+ *     { id: 'code-interpreter', config: { timeout: 30000 } },
+ *   ],
+ * });
+ * ```
+ */
+interface OpenRouterPluginConfig {
     /**
-  Modify the likelihood of specified tokens appearing in the completion.
-  
-  Accepts a JSON object that maps tokens (specified by their token ID in
-  the GPT tokenizer) to an associated bias value from -100 to 100. You
-  can use this tokenizer tool to convert text to token IDs. Mathematically,
-  the bias is added to the logits generated by the model prior to sampling.
-  The exact effect will vary per model, but values between -1 and 1 should
-  decrease or increase likelihood of selection; values like -100 or 100
-  should result in a ban or exclusive selection of the relevant token.
-  
-  As an example, you can pass {"50256": -100} to prevent the <|endoftext|>
-  token from being generated.
+     * The plugin identifier.
      */
-    logitBias?: Record<number, number>;
+    id: string;
     /**
-  Return the log probabilities of the tokens. Including logprobs will increase
-  the response size and can slow down response times. However, it can
-  be useful to better understand how the model is behaving.
-  
-  Setting to true will return the log probabilities of the tokens that
-  were generated.
-  
-  Setting to a number will return the log probabilities of the top n
-  tokens that were generated.
+     * Plugin-specific configuration.
      */
-    logprobs?: boolean | number;
+    config?: Record<string, unknown>;
     /**
-  The suffix that comes after a completion of inserted text.
+     * Allow any additional plugin-specific properties.
      */
-    suffix?: string;
-} & OpenRouterSharedSettings;
-
-type OpenRouterCompletionConfig = {
-    provider: string;
-    compatibility: 'strict' | 'compatible';
-    headers: () => Record<string, string | undefined>;
-    url: (options: {
-        modelId: string;
-        path: string;
-    }) => string;
-    fetch?: typeof fetch;
-    extraBody?: Record<string, unknown>;
-};
-declare class OpenRouterCompletionLanguageModel implements LanguageModelV2 {
-    readonly specificationVersion: "v2";
-    readonly provider = "openrouter";
-    readonly modelId: OpenRouterCompletionModelId;
-    readonly supportsImageUrls = true;
-    readonly supportedUrls: Record<string, RegExp[]>;
-    readonly defaultObjectGenerationMode: undefined;
-    readonly settings: OpenRouterCompletionSettings;
-    private readonly config;
-    constructor(modelId: OpenRouterCompletionModelId, settings: OpenRouterCompletionSettings, config: OpenRouterCompletionConfig);
-    private getArgs;
-    doGenerate(options: LanguageModelV2CallOptions): Promise<Awaited<ReturnType<LanguageModelV2['doGenerate']>>>;
-    doStream(options: LanguageModelV2CallOptions): Promise<Awaited<ReturnType<LanguageModelV2['doStream']>>>;
+    [key: string]: unknown;
 }
-
-type OpenRouterEmbeddingModelId = string;
-type OpenRouterEmbeddingSettings = {
+/**
+ * Configuration for OpenRouter's provider routing behavior.
+ *
+ * @description
+ * Controls how OpenRouter selects and falls back between different AI providers
+ * when routing requests. Use this to specify provider preferences, enable/disable
+ * fallbacks, and require specific provider parameters.
+ *
+ * @example
+ * ```ts
+ * const model = openrouter('openai/gpt-4', {
+ *   provider: {
+ *     order: ['Azure', 'OpenAI'],
+ *     allowFallbacks: true,
+ *   },
+ * });
+ * ```
+ */
+interface OpenRouterProviderRoutingConfig {
     /**
-     * A unique identifier representing your end-user, which can help OpenRouter to
-     * monitor and detect abuse.
+     * Provider order preference.
      */
-    user?: string;
+    order?: string[];
     /**
-     * Provider routing preferences to control request routing behavior
+     * Allow fallbacks to other providers.
      */
-    provider?: {
-        /**
-         * List of provider slugs to try in order (e.g. ["openai", "voyageai"])
-         */
-        order?: string[];
-        /**
-         * Whether to allow backup providers when primary is unavailable (default: true)
-         */
-        allow_fallbacks?: boolean;
-        /**
-         * Only use providers that support all parameters in your request (default: false)
-         */
-        require_parameters?: boolean;
-        /**
-         * Control whether to use providers that may store data
-         */
-        data_collection?: 'allow' | 'deny';
-        /**
-         * List of provider slugs to allow for this request
-         */
-        only?: string[];
-        /**
-         * List of provider slugs to skip for this request
-         */
-        ignore?: string[];
-        /**
-         * Sort providers by price, throughput, or latency
-         */
-        sort?: 'price' | 'throughput' | 'latency';
+    allowFallbacks?: boolean;
+    /**
+     * Required provider parameters.
+     */
+    requireParameters?: boolean;
+}
+/**
+ * Model-specific options for OpenRouter requests.
+ *
+ * @description
+ * Options that can be passed when creating a model to customize its behavior.
+ * These include OpenRouter-specific features like plugins, transforms, model
+ * fallbacks, and routing configuration. Additional properties are passed through
+ * to the underlying API.
+ *
+ * @example
+ * ```ts
+ * const model = openrouter('anthropic/claude-3.5-sonnet', {
+ *   usage: { include: true },
+ *   transforms: ['middle-out'],
+ *   models: ['anthropic/claude-3-opus', 'openai/gpt-4'],  // fallbacks
+ *   provider: {
+ *     order: ['Anthropic'],
+ *     allowFallbacks: false,
+ *   },
+ * });
+ * ```
+ */
+interface OpenRouterModelOptions {
+    /**
+     * Usage accounting configuration.
+     */
+    usage?: {
         /**
-         * Maximum pricing you want to pay for this request
+         * Whether to include usage information in the response.
          */
-        max_price?: {
-            prompt?: number | string;
-            completion?: number | string;
-            image?: number | string;
-            audio?: number | string;
-            request?: number | string;
-        };
+        include?: boolean;
     };
-} & OpenRouterSharedSettings;
-
-type OpenRouterProviderOptions = {
+    /**
+     * OpenRouter plugins to enable.
+     */
+    plugins?: OpenRouterPluginConfig[];
+    /**
+     * Message transforms to apply.
+     */
+    transforms?: string[];
+    /**
+     * Fallback model IDs.
+     */
     models?: string[];
     /**
-     * https://openrouter.ai/docs/use-cases/reasoning-tokens
-     * One of `max_tokens` or `effort` is required.
-     * If `exclude` is true, reasoning will be removed from the response. Default is false.
+     * Routing strategy.
      */
-    reasoning?: {
-        enabled?: boolean;
-        exclude?: boolean;
-    } & ({
-        max_tokens: number;
-    } | {
-        effort: 'high' | 'medium' | 'low';
-    });
+    route?: string;
     /**
-     * A unique identifier representing your end-user, which can
-     * help OpenRouter to monitor and detect abuse.
+     * Provider routing configuration.
      */
-    user?: string;
-};
-type OpenRouterSharedSettings = OpenRouterProviderOptions & {
+    provider?: OpenRouterProviderRoutingConfig;
     /**
-     * @deprecated use `reasoning` instead
+     * How to handle system messages for reasoning models.
+     * - 'system': Standard system message (default)
+     * - 'developer': Convert system to developer role for reasoning models
+     * - 'remove': Strip system messages entirely
      */
-    includeReasoning?: boolean;
-    extraBody?: Record<string, unknown>;
+    systemMessageMode?: 'system' | 'developer' | 'remove';
     /**
-     * Enable usage accounting to get detailed token usage information.
-     * https://openrouter.ai/docs/use-cases/usage-accounting
+     * Allow any additional model-specific options.
+     * These are passed through to the API.
      */
-    usage?: {
-        /**
-         * When true, includes token usage information in the response.
-         */
-        include: boolean;
-    };
-};
+    [key: string]: unknown;
+}
+
 /**
- * Usage accounting response
- * @see https://openrouter.ai/docs/use-cases/usage-accounting
+ * Result of parsing provider options, including any warnings.
  */
-type OpenRouterUsageAccounting = {
-    promptTokens: number;
-    promptTokensDetails?: {
-        cachedTokens: number;
-    };
-    completionTokens: number;
-    completionTokensDetails?: {
-        reasoningTokens: number;
-    };
-    totalTokens: number;
-    cost?: number;
-    costDetails?: {
-        upstreamInferenceCost: number;
-    };
-};
-
-type OpenRouterChatConfig = {
-    provider: string;
-    compatibility: 'strict' | 'compatible';
-    headers: () => Record<string, string | undefined>;
-    url: (options: {
-        modelId: string;
-        path: string;
-    }) => string;
-    fetch?: typeof fetch;
-    extraBody?: Record<string, unknown>;
-};
-declare class OpenRouterChatLanguageModel implements LanguageModelV2 {
-    readonly specificationVersion: "v2";
-    readonly provider = "openrouter";
-    readonly defaultObjectGenerationMode: "tool";
-    readonly modelId: OpenRouterChatModelId;
-    readonly supportsImageUrls = true;
-    readonly supportedUrls: Record<string, RegExp[]>;
-    readonly settings: OpenRouterChatSettings;
-    private readonly config;
-    constructor(modelId: OpenRouterChatModelId, settings: OpenRouterChatSettings, config: OpenRouterChatConfig);
-    private getArgs;
-    doGenerate(options: LanguageModelV2CallOptions): Promise<{
-        content: Array<LanguageModelV2Content>;
-        finishReason: LanguageModelV2FinishReason;
-        usage: LanguageModelV2Usage;
-        warnings: Array<LanguageModelV2CallWarning>;
-        providerMetadata?: {
-            openrouter: {
-                provider: string;
-                reasoning_details?: ReasoningDetailUnion[];
-                usage: OpenRouterUsageAccounting;
-            };
-        };
-        request?: {
-            body?: unknown;
-        };
-        response?: LanguageModelV2ResponseMetadata & {
-            headers?: SharedV2Headers;
-            body?: unknown;
-        };
-    }>;
-    doStream(options: LanguageModelV2CallOptions): Promise<{
-        stream: ReadableStream<LanguageModelV2StreamPart>;
-        warnings: Array<LanguageModelV2CallWarning>;
-        request?: {
-            body?: unknown;
-        };
-        response?: LanguageModelV2ResponseMetadata & {
-            headers?: SharedV2Headers;
-            body?: unknown;
-        };
+interface ParsedProviderOptions {
+    /**
+     * The merged options.
+     */
+    options: OpenRouterModelOptions;
+    /**
+     * Warnings generated during parsing (e.g., unknown keys).
+     */
+    warnings: Array<{
+        type: 'unsupported';
+        feature: string;
+        details?: string;
     }>;
 }
+/**
+ * Parses and merges provider options from model-level and call-time sources.
+ *
+ * Call-time options override model-level options for the same keys.
+ * Unknown keys pass through (per design spec - they are passed to the API).
+ *
+ * @param modelOptions - Options set at model creation time.
+ * @param callOptions - Options set at call time via providerOptions.openrouter.
+ * @returns The merged options and any warnings.
+ */
+declare function parseOpenRouterOptions(modelOptions: OpenRouterModelOptions | undefined, callOptions: Record<string, unknown> | undefined): ParsedProviderOptions;
+
+/**
+ * Maps OpenRouter finish reasons to the AI SDK V3 unified format.
+ *
+ * Mapping table:
+ * - 'end_turn', 'stop', 'stop_sequence' -> 'stop'
+ * - 'max_tokens', 'length' -> 'length'
+ * - 'tool_use', 'tool_calls' -> 'tool-calls'
+ * - 'content_filter' -> 'content-filter'
+ * - 'error' -> 'error'
+ * - null/undefined/unknown -> 'other'
+ *
+ * @param finishReason - The finish reason from OpenRouter API response
+ * @returns Object containing the unified finish reason and raw original value
+ */
+declare function mapOpenRouterFinishReason(finishReason: string | null | undefined): LanguageModelV3FinishReason;
+
+/**
+ * OpenRouter Responses API input item types.
+ * These match the OpenResponsesEasyInputMessage format used by the Responses API.
+ */
+type OpenRouterInputItem = OpenRouterEasyInputMessage | OpenRouterFunctionCall | OpenRouterFunctionCallOutput;
+/**
+ * Reasoning object for assistant messages.
+ * Contains the reasoning details to send back to the API.
+ */
+interface OpenRouterReasoning {
+    text?: string;
+    summary?: string;
+    encrypted?: string;
+}
+/**
+ * Easy input message format for Responses API.
+ * Supports user, system, assistant, and developer roles.
+ */
+interface OpenRouterEasyInputMessage {
+    type?: 'message';
+    role: 'user' | 'system' | 'assistant' | 'developer';
+    content: string | OpenRouterInputContent[];
+    reasoning?: OpenRouterReasoning;
+}
+interface OpenRouterFunctionCall {
+    type: 'function_call';
+    callId: string;
+    name: string;
+    arguments: string;
+}
+interface OpenRouterFunctionCallOutput {
+    type: 'function_call_output';
+    callId: string;
+    output: string;
+    status: 'completed' | 'incomplete';
+}
+/**
+ * Input content types for Responses API.
+ * Uses 'input_text', 'input_image', 'input_file' type prefixes.
+ */
+type OpenRouterInputContent = {
+    type: 'input_text';
+    text: string;
+} | {
+    type: 'input_image';
+    imageUrl: string;
+    detail?: 'auto' | 'low' | 'high';
+} | {
+    type: 'input_file';
+    fileUrl: string;
+    filename?: string;
+};
+/**
+ * Converts AI SDK V3 prompt format to OpenRouter Responses API input format.
+ *
+ * Mapping table:
+ * - system { content } -> { role: 'system', content: string }
+ * - user text -> { role: 'user', content: [{ type: 'input_text', text }] }
+ * - user image -> { role: 'user', content: [{ type: 'input_image', imageUrl }] }
+ * - user file -> { role: 'user', content: [{ type: 'input_file', fileUrl }] }
+ * - assistant text -> { role: 'assistant', content: string }
+ * - assistant tool-call -> { type: 'function_call', ... }
+ * - tool result -> { type: 'function_call_output', ... }
+ *
+ * @param prompt - The AI SDK V3 prompt
+ * @returns Array of input items in OpenRouter Responses API format
+ */
+declare function convertToOpenRouterMessages(prompt: LanguageModelV3Prompt): OpenRouterInputItem[];
 
-export { OpenRouterChatLanguageModel, type OpenRouterChatModelId, type OpenRouterChatSettings, OpenRouterCompletionLanguageModel, type OpenRouterCompletionModelId, type OpenRouterCompletionSettings, type OpenRouterEmbeddingModelId, type OpenRouterEmbeddingSettings, type OpenRouterProviderOptions, type OpenRouterSharedSettings, type OpenRouterUsageAccounting };
+export { type OpenRouterProviderMetadata, type OpenRouterRawUsage, type OpenRouterResponseData, type ParsedProviderOptions, buildProviderMetadata, buildUsage, convertToOpenRouterMessages, mapOpenRouterFinishReason, parseOpenRouterOptions };