@standardagents/openrouter 0.14.1 → 0.15.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { LLMProviderInterface, ProviderFactoryConfig, ModelCapabilities, ProviderModelInfo, ProviderRequest, ProviderResponse, ProviderStreamChunk, ResponseSummary, InspectedRequest, ProviderFactoryWithOptions } from '@standardagents/spec';
+import { LLMProviderInterface, ProviderFactoryConfig, ToolDefinition, ToolArgs, ToolTenvs, ModelCapabilities, ProviderModelInfo, ProviderRequest, ProviderResponse, ProviderStreamChunk, ResponseSummary, InspectedRequest, ProviderFactoryWithOptions } from '@standardagents/spec';
 import { z } from 'zod';
 
 /**
@@ -35,6 +35,17 @@ import { z } from 'zod';
  *   useResponsesApi: true,
  * }
  * ```
+ *
+ * @example
+ * ```typescript
+ * // Configure OpenRouter provider-executed server tools
+ * providerOptions: {
+ *   serverTools: {
+ *     web_search: { max_results: 5 },
+ *     datetime: { timezone: 'America/New_York' },
+ *   },
+ * }
+ * ```
  */
 declare const openrouterProviderOptions: z.ZodObject<{
     provider: z.ZodOptional<z.ZodObject<{
@@ -95,6 +106,12 @@ declare const openrouterProviderOptions: z.ZodObject<{
         enforce_distillable_text: z.ZodOptional<z.ZodBoolean>;
     }, z.core.$loose>>;
     useResponsesApi: z.ZodOptional<z.ZodBoolean>;
+    serverTools: z.ZodOptional<z.ZodObject<{
+        web_search: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        web_fetch: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        datetime: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+        image_generation: z.ZodOptional<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    }, z.core.$strip>>;
 }, z.core.$loose>;
 /**
  * TypeScript type for OpenRouter provider options.
@@ -129,6 +146,8 @@ declare class OpenRouterProvider implements LLMProviderInterface {
     private client;
     private config;
     constructor(config: OpenRouterConfig);
+    private static readonly SERVER_TOOL_RESULT;
+    private static readonly TOOLS;
     /**
      * Determine which API to use for a request.
      * Checks request-level providerOptions first, then falls back to config.
@@ -136,7 +155,12 @@ declare class OpenRouterProvider implements LLMProviderInterface {
      */
     private getApiMode;
     private getClient;
+    private applyConfiguredProvidersToResponses;
+    private hasOpenRouterServerTools;
+    private toSdkResponsesRequest;
+    private throwOpenRouterFetchError;
     supportsModel(_modelId: string): boolean;
+    getTools(_modelId?: string): Record<string, ToolDefinition<any, ToolArgs | null, ToolTenvs | null>>;
     /**
      * Get the icon for a model as a data URI.
      * Extracts the AI lab/organization from the model ID prefix and returns