@standardagents/openrouter 0.11.4 → 0.11.6

package/dist/index.d.ts

@@ -27,6 +27,14 @@ import { z } from 'zod';
  *   },
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Use the Responses API (beta) instead of Chat Completions
+ * providerOptions: {
+ *   useResponsesApi: true,
+ * }
+ * ```
  */
 declare const openrouterProviderOptions: z.ZodObject<{
     provider: z.ZodOptional<z.ZodObject<{
@@ -86,6 +94,7 @@ declare const openrouterProviderOptions: z.ZodObject<{
         }, z.core.$strip>]>>;
         enforce_distillable_text: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;
+    useResponsesApi: z.ZodOptional<z.ZodBoolean>;
 }, z.core.$loose>;
 /**
  * TypeScript type for OpenRouter provider options.
@@ -100,11 +109,19 @@ interface OpenRouterConfig extends ProviderFactoryConfig {
     /** List of providers to route to (e.g., ['openai', 'anthropic']) */
     providers?: string[];
 }
+/**
+ * API mode for OpenRouter requests.
+ * - 'chat': OpenAI-compatible Chat Completions API (default, stable)
+ * - 'responses': OpenRouter Responses API (beta, additional features)
+ */
+type OpenRouterApiMode = 'chat' | 'responses';
 /**
  * OpenRouter provider implementation for Standard Agents
  *
- * Uses the official @openrouter/sdk Responses API for API calls.
+ * By default, uses the OpenAI-compatible Chat Completions API which is stable and well-tested.
  * OpenRouter is a multi-provider gateway that routes requests to various LLM providers.
+ *
+ * To use the Responses API (beta), set `useResponsesApi: true` in providerOptions.
  */
 declare class OpenRouterProvider implements LLMProviderInterface {
     readonly name = "openrouter";
@@ -112,6 +129,12 @@ declare class OpenRouterProvider implements LLMProviderInterface {
     private client;
     private config;
     constructor(config: OpenRouterConfig);
+    /**
+     * Determine which API to use for a request.
+     * Checks request-level providerOptions first, then falls back to config.
+     * Defaults to Chat Completions (stable API).
+     */
+    private getApiMode;
     private getClient;
     supportsModel(_modelId: string): boolean;
     /**
@@ -142,7 +165,23 @@ declare class OpenRouterProvider implements LLMProviderInterface {
     getModels(filter?: string): Promise<ProviderModelInfo[]>;
     private mapToProviderModelInfo;
     generate(request: ProviderRequest): Promise<ProviderResponse>;
+    /**
+     * Generate using the Chat Completions API (default).
+     */
+    private generateWithChat;
+    /**
+     * Generate using the Responses API (beta).
+     */
+    private generateWithResponses;
     stream(request: ProviderRequest): Promise<AsyncIterable<ProviderStreamChunk>>;
+    /**
+     * Stream using the Chat Completions API (default).
+     */
+    private streamWithChat;
+    /**
+     * Stream using the Responses API (beta).
+     */
+    private streamWithResponses;
     /**
      * Fetch additional metadata about a completed response.
      * Called asynchronously after the response is received.
@@ -153,7 +192,7 @@ declare class OpenRouterProvider implements LLMProviderInterface {
     getResponseMetadata(summary: ResponseSummary, signal?: AbortSignal): Promise<Record<string, unknown> | null>;
     private toProviderError;
     /**
-     * Transform a ProviderRequest to OpenRouter Responses API format for inspection.
+     * Transform a ProviderRequest to the appropriate API format for inspection.
      * Returns the exact request body that would be sent to OpenRouter, with base64 data truncated.
      */
     inspectRequest(request: ProviderRequest): Promise<InspectedRequest>;
@@ -234,4 +273,4 @@ declare function fetchGenerationMetadata(apiKey: string, generationId: string, b
  */
 declare const openrouter: ProviderFactoryWithOptions<typeof openrouterProviderOptions>;
 
-export { type GenerationMetadata, type OpenRouterConfig, OpenRouterProvider, type OpenRouterProviderOptions, fetchGenerationMetadata, openrouter, openrouterProviderOptions };
+export { type GenerationMetadata, type OpenRouterApiMode, type OpenRouterConfig, OpenRouterProvider, type OpenRouterProviderOptions, fetchGenerationMetadata, openrouter, openrouterProviderOptions };