@openrouter/sdk 1.2.13 → 1.2.15

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: "1.2.13";
+    readonly sdkVersion: "1.2.15";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.2.13 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.2.15 2.914.0 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: "1.2.13",
+    sdkVersion: "1.2.15",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.2.13 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.2.15 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/chatwebsearchshorthand.d.ts

@@ -3,6 +3,7 @@ import { OpenEnum } from "../types/enums.js";
 import { SearchQualityLevel } from "./searchqualitylevel.js";
 import { WebSearchConfig, WebSearchConfig$Outbound } from "./websearchconfig.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
 export declare const ChatWebSearchShorthandType: {
     readonly WebSearch: "web_search";
@@ -43,6 +44,10 @@ export type ChatWebSearchShorthand = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     parameters?: WebSearchConfig | undefined;
     /**
      * How much context to retrieve per result. Applies to Exa, Parallel, and Perplexity engines; ignored with native provider search and Firecrawl. For Exa, pins a fixed per-result character cap (low=5,000, medium=15,000, high=30,000); when omitted, Exa picks an adaptive size per query and document (typically ~2,000–4,000 characters per result). For Parallel, controls the total characters across all results; when omitted, Parallel uses its own default size. For Perplexity, maps directly to the Search API's native search_context_size parameter. Overridden by `max_characters` when both are set.
@@ -65,6 +70,7 @@ export type ChatWebSearchShorthand$Outbound = {
     max_results?: number | undefined;
     max_total_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     parameters?: WebSearchConfig$Outbound | undefined;
     search_context_size?: string | undefined;
     type: string;

package/esm/models/chatwebsearchshorthand.js

@@ -8,6 +8,7 @@ import * as openEnums from "../types/enums.js";
 import { SearchQualityLevel$outboundSchema, } from "./searchqualitylevel.js";
 import { WebSearchConfig$outboundSchema, } from "./websearchconfig.js";
 import { WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchMode$outboundSchema, } from "./websearchmode.js";
 import { WebSearchUserLocationServerTool$outboundSchema, } from "./websearchuserlocationservertool.js";
 export const ChatWebSearchShorthandType = {
     WebSearch: "web_search",
@@ -26,6 +27,7 @@ export const ChatWebSearchShorthand$outboundSchema = z.object({
     maxResults: z.int().optional(),
     maxTotalResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     parameters: WebSearchConfig$outboundSchema.optional(),
     searchContextSize: SearchQualityLevel$outboundSchema.optional(),
     type: ChatWebSearchShorthandType$outboundSchema,

package/esm/models/index.d.ts

@@ -581,6 +581,7 @@ export * from "./websearchconfig.js";
 export * from "./websearchdomainfilter.js";
 export * from "./websearchengine.js";
 export * from "./websearchengineenum.js";
+export * from "./websearchmode.js";
 export * from "./websearchplugin.js";
 export * from "./websearchservertool.js";
 export * from "./websearchservertoolconfig.js";

package/esm/models/index.js

@@ -585,6 +585,7 @@ export * from "./websearchconfig.js";
 export * from "./websearchdomainfilter.js";
 export * from "./websearchengine.js";
 export * from "./websearchengineenum.js";
+export * from "./websearchmode.js";
 export * from "./websearchplugin.js";
 export * from "./websearchservertool.js";
 export * from "./websearchservertoolconfig.js";

package/esm/models/inputreference.d.ts

@@ -3,7 +3,7 @@ import { ContentPartAudio, ContentPartAudio$Outbound } from "./contentpartaudio.
 import { ContentPartImage, ContentPartImage$Outbound } from "./contentpartimage.js";
 import { ContentPartVideo, ContentPartVideo$Outbound } from "./contentpartvideo.js";
 /**
- * A reference asset used to guide video generation. Image references are supported by all providers; audio and video references are only honored by providers that support them (currently BytePlus Seedance 2.0).
+ * A reference asset used to guide video generation. Image references are supported by all providers; audio and video references are only honored by providers that support them (including BytePlus Seedance generation 2 and newer).
  */
 export type InputReference = ContentPartAudio | (ContentPartImage & {
     type: "image_url";

package/esm/models/legacywebsearchservertool.d.ts

@@ -5,6 +5,7 @@ import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import { SearchContextSizeEnum } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter, WebSearchDomainFilter$Outbound } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 import { WebSearchUserLocation, WebSearchUserLocation$Outbound } from "./websearchuserlocation.js";
 export declare const LegacyWebSearchServerToolType: {
     readonly WebSearch: "web_search";
@@ -27,6 +28,10 @@ export type LegacyWebSearchServerTool = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     /**
      * Size of the search context for web search tools
      */
@@ -49,6 +54,7 @@ export type LegacyWebSearchServerTool$Outbound = {
     filters?: WebSearchDomainFilter$Outbound | null | undefined;
     max_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_context_size?: string | undefined;
     type: string;
     user_location?: WebSearchUserLocation$Outbound | null | undefined;

package/esm/models/legacywebsearchservertool.js

@@ -8,6 +8,7 @@ import { safeParse } from "../lib/schemas.js";
 import { SearchContextSizeEnum$inboundSchema, SearchContextSizeEnum$outboundSchema, } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter$inboundSchema, WebSearchDomainFilter$outboundSchema, } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum$inboundSchema, WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchMode$inboundSchema, WebSearchMode$outboundSchema, } from "./websearchmode.js";
 import { WebSearchUserLocation$inboundSchema, WebSearchUserLocation$outboundSchema, } from "./websearchuserlocation.js";
 export const LegacyWebSearchServerToolType = {
     WebSearch: "web_search",
@@ -22,6 +23,7 @@ export const LegacyWebSearchServerTool$inboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$inboundSchema).optional(),
     max_results: z.int().optional(),
     max_uses: z.int().optional(),
+    mode: WebSearchMode$inboundSchema.optional(),
     search_context_size: SearchContextSizeEnum$inboundSchema.optional(),
     type: LegacyWebSearchServerToolType$inboundSchema,
     user_location: z.nullable(WebSearchUserLocation$inboundSchema).optional(),
@@ -39,6 +41,7 @@ export const LegacyWebSearchServerTool$outboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$outboundSchema).optional(),
     maxResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchContextSize: SearchContextSizeEnum$outboundSchema.optional(),
     type: LegacyWebSearchServerToolType$outboundSchema,
     userLocation: z.nullable(WebSearchUserLocation$outboundSchema).optional(),

package/esm/models/preview20250311websearchservertool.d.ts

@@ -6,6 +6,7 @@ import { PreviewWebSearchUserLocation, PreviewWebSearchUserLocation$Outbound } f
 import { SearchContextSizeEnum } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter, WebSearchDomainFilter$Outbound } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 export declare const Preview20250311WebSearchServerToolType: {
     readonly WebSearchPreview20250311: "web_search_preview_2025_03_11";
 };
@@ -27,6 +28,10 @@ export type Preview20250311WebSearchServerTool = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     /**
      * Size of the search context for web search tools
      */
@@ -46,6 +51,7 @@ export type Preview20250311WebSearchServerTool$Outbound = {
     filters?: WebSearchDomainFilter$Outbound | null | undefined;
     max_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_context_size?: string | undefined;
     type: string;
     user_location?: PreviewWebSearchUserLocation$Outbound | null | undefined;

package/esm/models/preview20250311websearchservertool.js

@@ -9,6 +9,7 @@ import { PreviewWebSearchUserLocation$inboundSchema, PreviewWebSearchUserLocatio
 import { SearchContextSizeEnum$inboundSchema, SearchContextSizeEnum$outboundSchema, } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter$inboundSchema, WebSearchDomainFilter$outboundSchema, } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum$inboundSchema, WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchMode$inboundSchema, WebSearchMode$outboundSchema, } from "./websearchmode.js";
 export const Preview20250311WebSearchServerToolType = {
     WebSearchPreview20250311: "web_search_preview_2025_03_11",
 };
@@ -22,6 +23,7 @@ export const Preview20250311WebSearchServerTool$inboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$inboundSchema).optional(),
     max_results: z.int().optional(),
     max_uses: z.int().optional(),
+    mode: WebSearchMode$inboundSchema.optional(),
     search_context_size: SearchContextSizeEnum$inboundSchema.optional(),
     type: Preview20250311WebSearchServerToolType$inboundSchema,
     user_location: z.nullable(PreviewWebSearchUserLocation$inboundSchema)
@@ -40,6 +42,7 @@ export const Preview20250311WebSearchServerTool$outboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$outboundSchema).optional(),
     maxResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchContextSize: SearchContextSizeEnum$outboundSchema.optional(),
     type: Preview20250311WebSearchServerToolType$outboundSchema,
     userLocation: z.nullable(PreviewWebSearchUserLocation$outboundSchema)

package/esm/models/previewwebsearchservertool.d.ts

@@ -6,6 +6,7 @@ import { PreviewWebSearchUserLocation, PreviewWebSearchUserLocation$Outbound } f
 import { SearchContextSizeEnum } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter, WebSearchDomainFilter$Outbound } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 export declare const PreviewWebSearchServerToolType: {
     readonly WebSearchPreview: "web_search_preview";
 };
@@ -27,6 +28,10 @@ export type PreviewWebSearchServerTool = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     /**
      * Size of the search context for web search tools
      */
@@ -46,6 +51,7 @@ export type PreviewWebSearchServerTool$Outbound = {
     filters?: WebSearchDomainFilter$Outbound | null | undefined;
     max_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_context_size?: string | undefined;
     type: string;
     user_location?: PreviewWebSearchUserLocation$Outbound | null | undefined;

package/esm/models/previewwebsearchservertool.js

@@ -9,6 +9,7 @@ import { PreviewWebSearchUserLocation$inboundSchema, PreviewWebSearchUserLocatio
 import { SearchContextSizeEnum$inboundSchema, SearchContextSizeEnum$outboundSchema, } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter$inboundSchema, WebSearchDomainFilter$outboundSchema, } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum$inboundSchema, WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchMode$inboundSchema, WebSearchMode$outboundSchema, } from "./websearchmode.js";
 export const PreviewWebSearchServerToolType = {
     WebSearchPreview: "web_search_preview",
 };
@@ -22,6 +23,7 @@ export const PreviewWebSearchServerTool$inboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$inboundSchema).optional(),
     max_results: z.int().optional(),
     max_uses: z.int().optional(),
+    mode: WebSearchMode$inboundSchema.optional(),
     search_context_size: SearchContextSizeEnum$inboundSchema.optional(),
     type: PreviewWebSearchServerToolType$inboundSchema,
     user_location: z.nullable(PreviewWebSearchUserLocation$inboundSchema)
@@ -40,6 +42,7 @@ export const PreviewWebSearchServerTool$outboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$outboundSchema).optional(),
     maxResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchContextSize: SearchContextSizeEnum$outboundSchema.optional(),
     type: PreviewWebSearchServerToolType$outboundSchema,
     userLocation: z.nullable(PreviewWebSearchUserLocation$outboundSchema)

package/esm/models/videogenerationrequest.d.ts

@@ -465,7 +465,7 @@ export type VideoGenerationRequest = {
      */
     generateAudio?: boolean | undefined;
     /**
-     * Reference assets to guide video generation. Accepts image, audio, and video references. Audio and video references are only honored by providers that support them (currently BytePlus Seedance 2.0); other providers use image references and ignore the rest.
+     * Reference assets to guide video generation. Accepts image, audio, and video references. Audio and video references are only honored by providers that support them (including BytePlus Seedance generation 2 and newer); other providers use image references and ignore the rest.
      */
     inputReferences?: Array<InputReference> | undefined;
     model: string;

package/esm/models/websearchconfig.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4";
 import { SearchQualityLevel } from "./searchqualitylevel.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
 export type WebSearchConfig = {
     /**
@@ -31,6 +32,10 @@ export type WebSearchConfig = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     /**
      * How much context to retrieve per result. Applies to Exa, Parallel, and Perplexity engines; ignored with native provider search and Firecrawl. For Exa, pins a fixed per-result character cap (low=5,000, medium=15,000, high=30,000); when omitted, Exa picks an adaptive size per query and document (typically ~2,000–4,000 characters per result). For Parallel, controls the total characters across all results; when omitted, Parallel uses its own default size. For Perplexity, maps directly to the Search API's native search_context_size parameter. Overridden by `max_characters` when both are set.
      */
@@ -49,6 +54,7 @@ export type WebSearchConfig$Outbound = {
     max_results?: number | undefined;
     max_total_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_context_size?: string | undefined;
     user_location?: WebSearchUserLocationServerTool$Outbound | undefined;
 };

package/esm/models/websearchconfig.js

@@ -6,6 +6,7 @@ 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 { WebSearchMode$outboundSchema, } from "./websearchmode.js";
 import { WebSearchUserLocationServerTool$outboundSchema, } from "./websearchuserlocationservertool.js";
 /** @internal */
 export const WebSearchConfig$outboundSchema = z.object({
@@ -16,6 +17,7 @@ export const WebSearchConfig$outboundSchema = z.object({
     maxResults: z.int().optional(),
     maxTotalResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchContextSize: SearchQualityLevel$outboundSchema.optional(),
     userLocation: WebSearchUserLocationServerTool$outboundSchema.optional(),
 }).transform((v) => {

package/esm/models/websearchmode.d.ts

@@ -0,0 +1,25 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+ */
+export declare const WebSearchMode: {
+    readonly Instant: "instant";
+    readonly Fast: "fast";
+    readonly Auto: "auto";
+    readonly DeepLite: "deep-lite";
+    readonly Deep: "deep";
+    readonly DeepReasoning: "deep-reasoning";
+    readonly Turbo: "turbo";
+    readonly Basic: "basic";
+    readonly Advanced: "advanced";
+};
+/**
+ * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+ */
+export type WebSearchMode = OpenEnum<typeof WebSearchMode>;
+/** @internal */
+export declare const WebSearchMode$inboundSchema: z.ZodType<WebSearchMode, unknown>;
+/** @internal */
+export declare const WebSearchMode$outboundSchema: z.ZodType<string, WebSearchMode>;
+//# sourceMappingURL=websearchmode.d.ts.map

package/esm/models/websearchmode.js

@@ -0,0 +1,24 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 8aa8c62cf243
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+ */
+export const WebSearchMode = {
+    Instant: "instant",
+    Fast: "fast",
+    Auto: "auto",
+    DeepLite: "deep-lite",
+    Deep: "deep",
+    DeepReasoning: "deep-reasoning",
+    Turbo: "turbo",
+    Basic: "basic",
+    Advanced: "advanced",
+};
+/** @internal */
+export const WebSearchMode$inboundSchema = openEnums.inboundSchema(WebSearchMode);
+/** @internal */
+export const WebSearchMode$outboundSchema = openEnums.outboundSchema(WebSearchMode);
+//# sourceMappingURL=websearchmode.js.map

package/esm/models/websearchplugin.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4";
 import { ClosedEnum } from "../types/enums.js";
 import { WebSearchEngine } from "./websearchengine.js";
+import { WebSearchMode } from "./websearchmode.js";
 export declare const WebSearchPluginType: {
     readonly Approximate: "approximate";
 };
@@ -38,6 +39,10 @@ export type WebSearchPlugin = {
      * Maximum number of times the model can invoke web search in a single turn. Passed through to native providers that support it (e.g. Anthropic).
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     searchPrompt?: string | undefined;
     userLocation?: UserLocation | null | undefined;
 };
@@ -63,6 +68,7 @@ export type WebSearchPlugin$Outbound = {
     include_domains?: Array<string> | undefined;
     max_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_prompt?: string | undefined;
     user_location?: UserLocation$Outbound | null | undefined;
 };

package/esm/models/websearchplugin.js

@@ -5,6 +5,7 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import { WebSearchEngine$outboundSchema, } from "./websearchengine.js";
+import { WebSearchMode$outboundSchema, } from "./websearchmode.js";
 export const WebSearchPluginType = {
     Approximate: "approximate",
 };
@@ -30,6 +31,7 @@ export const WebSearchPlugin$outboundSchema = z.object({
     includeDomains: z.array(z.string()).optional(),
     maxResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchPrompt: z.string().optional(),
     userLocation: z.nullable(z.lazy(() => UserLocation$outboundSchema))
         .optional(),

package/esm/models/websearchservertool.d.ts

@@ -5,6 +5,7 @@ import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import { SearchContextSizeEnum } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter, WebSearchDomainFilter$Outbound } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 import { WebSearchUserLocation, WebSearchUserLocation$Outbound } from "./websearchuserlocation.js";
 export declare const WebSearchServerToolType: {
     readonly WebSearch20250826: "web_search_2025_08_26";
@@ -27,6 +28,10 @@ export type WebSearchServerTool = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     /**
      * Size of the search context for web search tools
      */
@@ -49,6 +54,7 @@ export type WebSearchServerTool$Outbound = {
     filters?: WebSearchDomainFilter$Outbound | null | undefined;
     max_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_context_size?: string | undefined;
     type: string;
     user_location?: WebSearchUserLocation$Outbound | null | undefined;

package/esm/models/websearchservertool.js

@@ -8,6 +8,7 @@ import { safeParse } from "../lib/schemas.js";
 import { SearchContextSizeEnum$inboundSchema, SearchContextSizeEnum$outboundSchema, } from "./searchcontextsizeenum.js";
 import { WebSearchDomainFilter$inboundSchema, WebSearchDomainFilter$outboundSchema, } from "./websearchdomainfilter.js";
 import { WebSearchEngineEnum$inboundSchema, WebSearchEngineEnum$outboundSchema, } from "./websearchengineenum.js";
+import { WebSearchMode$inboundSchema, WebSearchMode$outboundSchema, } from "./websearchmode.js";
 import { WebSearchUserLocation$inboundSchema, WebSearchUserLocation$outboundSchema, } from "./websearchuserlocation.js";
 export const WebSearchServerToolType = {
     WebSearch20250826: "web_search_2025_08_26",
@@ -22,6 +23,7 @@ export const WebSearchServerTool$inboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$inboundSchema).optional(),
     max_results: z.int().optional(),
     max_uses: z.int().optional(),
+    mode: WebSearchMode$inboundSchema.optional(),
     search_context_size: SearchContextSizeEnum$inboundSchema.optional(),
     type: WebSearchServerToolType$inboundSchema,
     user_location: z.nullable(WebSearchUserLocation$inboundSchema).optional(),
@@ -39,6 +41,7 @@ export const WebSearchServerTool$outboundSchema = z.object({
     filters: z.nullable(WebSearchDomainFilter$outboundSchema).optional(),
     maxResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchContextSize: SearchContextSizeEnum$outboundSchema.optional(),
     type: WebSearchServerToolType$outboundSchema,
     userLocation: z.nullable(WebSearchUserLocation$outboundSchema).optional(),

package/esm/models/websearchservertoolconfig.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4";
 import { SearchQualityLevel } from "./searchqualitylevel.js";
 import { WebSearchEngineEnum } from "./websearchengineenum.js";
+import { WebSearchMode } from "./websearchmode.js";
 import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
 /**
  * Configuration for the openrouter:web_search server tool
@@ -34,6 +35,10 @@ export type WebSearchServerToolConfig = {
      * Maximum number of web searches the model may perform in a single request. Once reached, further search calls return an error result instead of executing. Applies to the Exa, Firecrawl, Parallel, and Perplexity engines. With native provider search, forwarded only to Anthropic (as `max_uses`); other native search providers have no equivalent parameter and ignore it.
      */
     maxUses?: number | undefined;
+    /**
+     * Engine-native search mode. Exa supports instant, fast, auto (default), deep-lite, deep, and deep-reasoning. Parallel supports turbo (default), basic, and advanced. Modes unsupported by the selected engine are ignored.
+     */
+    mode?: WebSearchMode | undefined;
     /**
      * How much context to retrieve per result. Applies to Exa, Parallel, and Perplexity engines; ignored with native provider search and Firecrawl. For Exa, pins a fixed per-result character cap (low=5,000, medium=15,000, high=30,000); when omitted, Exa picks an adaptive size per query and document (typically ~2,000–4,000 characters per result). For Parallel, controls the total characters across all results; when omitted, Parallel uses its own default size. For Perplexity, maps directly to the Search API's native search_context_size parameter. Overridden by `max_characters` when both are set.
      */
@@ -52,6 +57,7 @@ export type WebSearchServerToolConfig$Outbound = {
     max_results?: number | undefined;
     max_total_results?: number | undefined;
     max_uses?: number | undefined;
+    mode?: string | undefined;
     search_context_size?: string | undefined;
     user_location?: WebSearchUserLocationServerTool$Outbound | undefined;
 };

package/esm/models/websearchservertoolconfig.js

@@ -6,6 +6,7 @@ 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 { WebSearchMode$outboundSchema, } from "./websearchmode.js";
 import { WebSearchUserLocationServerTool$outboundSchema, } from "./websearchuserlocationservertool.js";
 /** @internal */
 export const WebSearchServerToolConfig$outboundSchema = z.object({
@@ -16,6 +17,7 @@ export const WebSearchServerToolConfig$outboundSchema = z.object({
     maxResults: z.int().optional(),
     maxTotalResults: z.int().optional(),
     maxUses: z.int().optional(),
+    mode: WebSearchMode$outboundSchema.optional(),
     searchContextSize: SearchQualityLevel$outboundSchema.optional(),
     userLocation: WebSearchUserLocationServerTool$outboundSchema.optional(),
 }).transform((v) => {

package/jsr.json

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

package/package.json

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