@openrouter/sdk 0.12.26 → 0.12.27

package/esm/lib/config.d.ts

@@ -49,8 +49,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "0.12.26";
+    readonly sdkVersion: "0.12.27";
     readonly genVersion: "2.879.1";
-    readonly userAgent: "speakeasy-sdk/typescript 0.12.26 2.879.1 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.12.27 2.879.1 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -26,8 +26,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "0.12.26",
+    sdkVersion: "0.12.27",
     genVersion: "2.879.1",
-    userAgent: "speakeasy-sdk/typescript 0.12.26 2.879.1 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.12.27 2.879.1 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/chatwebsearchshorthand.d.ts

@@ -16,7 +16,7 @@ export type ChatWebSearchShorthandType = OpenEnum<typeof ChatWebSearchShorthandT
  */
 export type ChatWebSearchShorthand = {
     /**
-     * Limit search results to these domains. Supported by Exa, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Firecrawl or Perplexity.
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
      */
     allowedDomains?: Array<string> | undefined;
     /**
@@ -24,7 +24,7 @@ export type ChatWebSearchShorthand = {
      */
     engine?: WebSearchEngineEnum | undefined;
     /**
-     * Exclude search results from these domains. Supported by Exa, Parallel, Anthropic, and xAI. Not supported with Firecrawl, OpenAI (silently ignored), or Perplexity.
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains.
      */
     excludedDomains?: Array<string> | undefined;
     /**

package/esm/models/index.d.ts

@@ -290,6 +290,7 @@ export * from "./websearchengine.js";
 export * from "./websearchengineenum.js";
 export * from "./websearchplugin.js";
 export * from "./websearchservertool.js";
+export * from "./websearchservertoolconfig.js";
 export * from "./websearchservertoolopenrouter.js";
 export * from "./websearchsource.js";
 export * from "./websearchstatus.js";

package/esm/models/index.js

@@ -294,6 +294,7 @@ export * from "./websearchengine.js";
 export * from "./websearchengineenum.js";
 export * from "./websearchplugin.js";
 export * from "./websearchservertool.js";
+export * from "./websearchservertoolconfig.js";
 export * from "./websearchservertoolopenrouter.js";
 export * from "./websearchsource.js";
 export * from "./websearchstatus.js";

package/esm/models/websearchconfig.d.ts

@@ -4,7 +4,7 @@ import { WebSearchEngineEnum } from "./websearchengineenum.js";
 import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
 export type WebSearchConfig = {
     /**
-     * Limit search results to these domains. Supported by Exa, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Firecrawl or Perplexity.
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
      */
     allowedDomains?: Array<string> | undefined;
     /**
@@ -12,7 +12,7 @@ export type WebSearchConfig = {
      */
     engine?: WebSearchEngineEnum | undefined;
     /**
-     * Exclude search results from these domains. Supported by Exa, Parallel, Anthropic, and xAI. Not supported with Firecrawl, OpenAI (silently ignored), or Perplexity.
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains.
      */
     excludedDomains?: Array<string> | undefined;
     /**

package/esm/models/websearchservertoolconfig.d.ts

@@ -0,0 +1,51 @@
+import * as z from "zod/v4";
+import { SearchQualityLevel } from "./searchqualitylevel.js";
+import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
+/**
+ * Configuration for the openrouter:web_search server tool
+ */
+export type WebSearchServerToolConfig = {
+    /**
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
+     */
+    allowedDomains?: Array<string> | undefined;
+    /**
+     * Which search engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in search. "exa" forces the Exa search API. "firecrawl" uses Firecrawl (requires BYOK). "parallel" uses the Parallel search API.
+     */
+    engine?: WebSearchEngineEnum | undefined;
+    /**
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Anthropic, and xAI. Not supported with OpenAI (silently ignored) or Perplexity. Cannot be used with allowed_domains.
+     */
+    excludedDomains?: Array<string> | undefined;
+    /**
+     * Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, and Parallel engines; ignored with native provider search.
+     */
+    maxResults?: number | undefined;
+    /**
+     * Maximum total number of search results across all search calls in a single request. Once this limit is reached, the tool will stop returning new results. Useful for controlling cost and context size in agentic loops.
+     */
+    maxTotalResults?: number | undefined;
+    /**
+     * How much context to retrieve per result. Defaults to medium (15000 chars). Applies to Exa and Parallel engines; ignored with native provider search and Firecrawl.
+     */
+    searchContextSize?: SearchQualityLevel | undefined;
+    /**
+     * Approximate user location for location-biased results.
+     */
+    userLocation?: WebSearchUserLocationServerTool | undefined;
+};
+/** @internal */
+export type WebSearchServerToolConfig$Outbound = {
+    allowed_domains?: Array<string> | undefined;
+    engine?: string | undefined;
+    excluded_domains?: Array<string> | undefined;
+    max_results?: number | undefined;
+    max_total_results?: number | undefined;
+    search_context_size?: string | undefined;
+    user_location?: WebSearchUserLocationServerTool$Outbound | undefined;
+};
+/** @internal */
+export declare const WebSearchServerToolConfig$outboundSchema: z.ZodType<WebSearchServerToolConfig$Outbound, WebSearchServerToolConfig>;
+export declare function webSearchServerToolConfigToJSON(webSearchServerToolConfig: WebSearchServerToolConfig): string;
+//# sourceMappingURL=websearchservertoolconfig.d.ts.map

package/esm/models/websearchservertoolconfig.js

@@ -0,0 +1,32 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 900e829383d7
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { SearchQualityLevel$outboundSchema, } from "./searchqualitylevel.js";
+import { WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchUserLocationServerTool$outboundSchema, } from "./websearchuserlocationservertool.js";
+/** @internal */
+export const WebSearchServerToolConfig$outboundSchema = z.object({
+    allowedDomains: z.array(z.string()).optional(),
+    engine: WebSearchEngineEnum$outboundSchema.optional(),
+    excludedDomains: z.array(z.string()).optional(),
+    maxResults: z.int().optional(),
+    maxTotalResults: z.int().optional(),
+    searchContextSize: SearchQualityLevel$outboundSchema.optional(),
+    userLocation: WebSearchUserLocationServerTool$outboundSchema.optional(),
+}).transform((v) => {
+    return remap$(v, {
+        allowedDomains: "allowed_domains",
+        excludedDomains: "excluded_domains",
+        maxResults: "max_results",
+        maxTotalResults: "max_total_results",
+        searchContextSize: "search_context_size",
+        userLocation: "user_location",
+    });
+});
+export function webSearchServerToolConfigToJSON(webSearchServerToolConfig) {
+    return JSON.stringify(WebSearchServerToolConfig$outboundSchema.parse(webSearchServerToolConfig));
+}
+//# sourceMappingURL=websearchservertoolconfig.js.map

package/esm/models/websearchservertoolopenrouter.d.ts

@@ -1,32 +1,18 @@
 import * as z from "zod/v4";
-export type ParametersT = {
-    /**
-     * Maximum number of search results to return per search call. Defaults to 5.
-     */
-    maxResults?: number | undefined;
-    /**
-     * Maximum total number of search results across all search calls in a single request. Once this limit is reached, the tool will stop returning new results.
-     */
-    maxTotalResults?: number | undefined;
-};
+import { WebSearchServerToolConfig, WebSearchServerToolConfig$Outbound } from "./websearchservertoolconfig.js";
 /**
  * OpenRouter built-in server tool: searches the web for current information
  */
 export type WebSearchServerToolOpenRouter = {
-    parameters?: ParametersT | undefined;
+    /**
+     * Configuration for the openrouter:web_search server tool
+     */
+    parameters?: WebSearchServerToolConfig | undefined;
     type: "openrouter:web_search";
 };
 /** @internal */
-export type ParametersT$Outbound = {
-    max_results?: number | undefined;
-    max_total_results?: number | undefined;
-};
-/** @internal */
-export declare const ParametersT$outboundSchema: z.ZodType<ParametersT$Outbound, ParametersT>;
-export declare function parametersToJSON(parametersT: ParametersT): string;
-/** @internal */
 export type WebSearchServerToolOpenRouter$Outbound = {
-    parameters?: ParametersT$Outbound | undefined;
+    parameters?: WebSearchServerToolConfig$Outbound | undefined;
     type: "openrouter:web_search";
 };
 /** @internal */

package/esm/models/websearchservertoolopenrouter.js

@@ -3,23 +3,10 @@
  * @generated-id: 99dffefc1c11
  */
 import * as z from "zod/v4";
-import { remap as remap$ } from "../lib/primitives.js";
-/** @internal */
-export const ParametersT$outboundSchema = z.object({
-    maxResults: z.int().optional(),
-    maxTotalResults: z.int().optional(),
-}).transform((v) => {
-    return remap$(v, {
-        maxResults: "max_results",
-        maxTotalResults: "max_total_results",
-    });
-});
-export function parametersToJSON(parametersT) {
-    return JSON.stringify(ParametersT$outboundSchema.parse(parametersT));
-}
+import { WebSearchServerToolConfig$outboundSchema, } from "./websearchservertoolconfig.js";
 /** @internal */
 export const WebSearchServerToolOpenRouter$outboundSchema = z.object({
-    parameters: z.lazy(() => ParametersT$outboundSchema).optional(),
+    parameters: WebSearchServerToolConfig$outboundSchema.optional(),
     type: z.literal("openrouter:web_search"),
 });
 export function webSearchServerToolOpenRouterToJSON(webSearchServerToolOpenRouter) {

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.26",
+  "version": "0.12.27",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.26",
+  "version": "0.12.27",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [
@@ -69,15 +69,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test:watch": "vitest --watch --project unit",
-    "typecheck": "tsc --noEmit",
-    "typecheck:transit": "exit 0",
     "compile": "tsc",
-    "postinstall": "node scripts/check-types.js || true",
     "prepare": "npm run build",
     "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e",
-    "test:transit": "exit 0"
+    "test:transit": "exit 0",
+    "postinstall": "node scripts/check-types.js || true",
+    "test:watch": "vitest --watch --project unit",
+    "typecheck": "tsc --noEmit",
+    "typecheck:transit": "exit 0"
   },
   "peerDependencies": {},
   "devDependencies": {