@openrouter/sdk 0.12.79 → 0.13.13

package/esm/models/chatrequest.d.ts

@@ -36,6 +36,7 @@ export type ChatRequestPlugin = AutoRouterPlugin | ContextCompressionPlugin | Fi
  * Constrains effort on reasoning for reasoning models
  */
 export declare const ChatRequestEffort: {
+    readonly Max: "max";
     readonly Xhigh: "xhigh";
     readonly High: "high";
     readonly Medium: "medium";
@@ -57,6 +58,22 @@ export type ChatRequestReasoning = {
     effort?: ChatRequestEffort | null | undefined;
     summary?: ChatReasoningSummaryVerbosityEnum | null | undefined;
 };
+/**
+ * Shorthand for setting reasoning effort. Equivalent to setting reasoning.effort. Cannot be used simultaneously with reasoning.effort if they differ.
+ */
+export declare const ChatRequestReasoningEffort: {
+    readonly Max: "max";
+    readonly Xhigh: "xhigh";
+    readonly High: "high";
+    readonly Medium: "medium";
+    readonly Low: "low";
+    readonly Minimal: "minimal";
+    readonly None: "none";
+};
+/**
+ * Shorthand for setting reasoning effort. Equivalent to setting reasoning.effort. Cannot be used simultaneously with reasoning.effort if they differ.
+ */
+export type ChatRequestReasoningEffort = OpenEnum<typeof ChatRequestReasoningEffort>;
 /**
  * Response format configuration
  */
@@ -129,6 +146,10 @@ export type ChatRequest = {
     metadata?: {
         [k: string]: string;
     } | undefined;
+    /**
+     * Minimum probability threshold relative to the most likely token. Tokens with probability below min_p * (probability of top token) are filtered out. Not all providers support this parameter.
+     */
+    minP?: number | null | undefined;
     /**
      * Output modalities for the response. Supported values are "text", "image", and "audio".
      */
@@ -161,6 +182,14 @@ export type ChatRequest = {
      * Configuration options for reasoning models
      */
     reasoning?: ChatRequestReasoning | undefined;
+    /**
+     * Shorthand for setting reasoning effort. Equivalent to setting reasoning.effort. Cannot be used simultaneously with reasoning.effort if they differ.
+     */
+    reasoningEffort?: ChatRequestReasoningEffort | null | undefined;
+    /**
+     * Penalizes tokens based on how much they have already appeared in the text. A value of 1.0 means no penalty. Values above 1.0 penalize repeated tokens more strongly. Not all providers support this parameter.
+     */
+    repetitionPenalty?: number | null | undefined;
     /**
      * Response format configuration
      */
@@ -205,6 +234,14 @@ export type ChatRequest = {
      * Available tools for function calling
      */
     tools?: Array<ChatFunctionTool> | undefined;
+    /**
+     * Consider only tokens with "sufficiently high" probabilities based on the probability of the most likely token. Not all providers support this parameter.
+     */
+    topA?: number | null | undefined;
+    /**
+     * Limits the model to choose from the top K most likely tokens at each step. A value of 1 means the model will always pick the most likely next token. Not all providers support this parameter.
+     */
+    topK?: number | null | undefined;
     /**
      * Number of top log probabilities to return (0-20)
      */
@@ -240,6 +277,8 @@ export type ChatRequestReasoning$Outbound = {
 export declare const ChatRequestReasoning$outboundSchema: z.ZodType<ChatRequestReasoning$Outbound, ChatRequestReasoning>;
 export declare function chatRequestReasoningToJSON(chatRequestReasoning: ChatRequestReasoning): string;
 /** @internal */
+export declare const ChatRequestReasoningEffort$outboundSchema: z.ZodType<string, ChatRequestReasoningEffort>;
+/** @internal */
 export type ResponseFormat$Outbound = ChatFormatGrammarConfig$Outbound | FormatJsonObjectConfig$Outbound | ChatFormatJsonSchemaConfig$Outbound | ChatFormatPythonConfig$Outbound | ChatFormatTextConfig$Outbound;
 /** @internal */
 export declare const ResponseFormat$outboundSchema: z.ZodType<ResponseFormat$Outbound, ResponseFormat>;
@@ -269,6 +308,7 @@ export type ChatRequest$Outbound = {
     metadata?: {
         [k: string]: string;
     } | undefined;
+    min_p?: number | null | undefined;
     modalities?: Array<string> | undefined;
     model?: string | undefined;
     models?: Array<string> | undefined;
@@ -277,6 +317,8 @@ export type ChatRequest$Outbound = {
     presence_penalty?: number | null | undefined;
     provider?: ProviderPreferences$Outbound | null | undefined;
     reasoning?: ChatRequestReasoning$Outbound | undefined;
+    reasoning_effort?: string | null | undefined;
+    repetition_penalty?: number | null | undefined;
     response_format?: ChatFormatGrammarConfig$Outbound | FormatJsonObjectConfig$Outbound | ChatFormatJsonSchemaConfig$Outbound | ChatFormatPythonConfig$Outbound | ChatFormatTextConfig$Outbound | undefined;
     seed?: number | null | undefined;
     service_tier?: string | null | undefined;
@@ -288,6 +330,8 @@ export type ChatRequest$Outbound = {
     temperature?: number | null | undefined;
     tool_choice?: ChatToolChoice$Outbound | undefined;
     tools?: Array<ChatFunctionTool$Outbound> | undefined;
+    top_a?: number | null | undefined;
+    top_k?: number | null | undefined;
     top_logprobs?: number | null | undefined;
     top_p?: number | null | undefined;
     trace?: TraceConfig$Outbound | undefined;

package/esm/models/chatrequest.js

@@ -39,6 +39,19 @@ export const Modality = {
  * Constrains effort on reasoning for reasoning models
  */
 export const ChatRequestEffort = {
+    Max: "max",
+    Xhigh: "xhigh",
+    High: "high",
+    Medium: "medium",
+    Low: "low",
+    Minimal: "minimal",
+    None: "none",
+};
+/**
+ * Shorthand for setting reasoning effort. Equivalent to setting reasoning.effort. Cannot be used simultaneously with reasoning.effort if they differ.
+ */
+export const ChatRequestReasoningEffort = {
+    Max: "max",
     Xhigh: "xhigh",
     High: "high",
     Medium: "medium",
@@ -86,6 +99,8 @@ export function chatRequestReasoningToJSON(chatRequestReasoning) {
     return JSON.stringify(ChatRequestReasoning$outboundSchema.parse(chatRequestReasoning));
 }
 /** @internal */
+export const ChatRequestReasoningEffort$outboundSchema = openEnums.outboundSchema(ChatRequestReasoningEffort);
+/** @internal */
 export const ResponseFormat$outboundSchema = z.union([
     ChatFormatGrammarConfig$outboundSchema,
     FormatJsonObjectConfig$outboundSchema,
@@ -119,6 +134,7 @@ export const ChatRequest$outboundSchema = z.object({
     maxTokens: z.nullable(z.int()).optional(),
     messages: z.array(ChatMessages$outboundSchema),
     metadata: z.record(z.string(), z.string()).optional(),
+    minP: z.nullable(z.number()).optional(),
     modalities: z.array(Modality$outboundSchema).optional(),
     model: z.string().optional(),
     models: z.array(z.string()).optional(),
@@ -137,6 +153,9 @@ export const ChatRequest$outboundSchema = z.object({
     presencePenalty: z.nullable(z.number()).optional(),
     provider: z.nullable(ProviderPreferences$outboundSchema).optional(),
     reasoning: z.lazy(() => ChatRequestReasoning$outboundSchema).optional(),
+    reasoningEffort: z.nullable(ChatRequestReasoningEffort$outboundSchema)
+        .optional(),
+    repetitionPenalty: z.nullable(z.number()).optional(),
     responseFormat: z.union([
         ChatFormatGrammarConfig$outboundSchema,
         FormatJsonObjectConfig$outboundSchema,
@@ -156,6 +175,8 @@ export const ChatRequest$outboundSchema = z.object({
     temperature: z.nullable(z.number()).optional(),
     toolChoice: ChatToolChoice$outboundSchema.optional(),
     tools: z.array(ChatFunctionTool$outboundSchema).optional(),
+    topA: z.nullable(z.number()).optional(),
+    topK: z.nullable(z.int()).optional(),
     topLogprobs: z.nullable(z.int()).optional(),
     topP: z.nullable(z.number()).optional(),
     trace: TraceConfig$outboundSchema.optional(),
@@ -168,14 +189,19 @@ export const ChatRequest$outboundSchema = z.object({
         logitBias: "logit_bias",
         maxCompletionTokens: "max_completion_tokens",
         maxTokens: "max_tokens",
+        minP: "min_p",
         parallelToolCalls: "parallel_tool_calls",
         presencePenalty: "presence_penalty",
+        reasoningEffort: "reasoning_effort",
+        repetitionPenalty: "repetition_penalty",
         responseFormat: "response_format",
         serviceTier: "service_tier",
         sessionId: "session_id",
         stopServerToolsWhen: "stop_server_tools_when",
         streamOptions: "stream_options",
         toolChoice: "tool_choice",
+        topA: "top_a",
+        topK: "top_k",
         topLogprobs: "top_logprobs",
         topP: "top_p",
     });

package/esm/models/chatstreamchunk.d.ts

@@ -1,14 +1,28 @@
 import * as z from "zod/v4";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import { ApiErrorType } from "./apierrortype.js";
 import { ChatStreamChoice } from "./chatstreamchoice.js";
 import { ChatUsage } from "./chatusage.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 import { OpenRouterMetadata } from "./openroutermetadata.js";
+/**
+ * Structured error metadata
+ */
+export type ChatStreamChunkMetadata = {
+    /**
+     * Canonical OpenRouter error type, stable across all API formats
+     */
+    errorType: ApiErrorType;
+    /**
+     * Upstream provider-specific error code, when available
+     */
+    providerCode?: string | undefined;
+};
 /**
  * Error information
  */
-export type ErrorT = {
+export type ChatStreamChunkError = {
     /**
      * Error code
      */
@@ -17,6 +31,10 @@ export type ErrorT = {
      * Error message
      */
     message: string;
+    /**
+     * Structured error metadata
+     */
+    metadata?: ChatStreamChunkMetadata | undefined;
 };
 export declare const ChatStreamChunkObject: {
     readonly ChatCompletionChunk: "chat.completion.chunk";
@@ -37,7 +55,7 @@ export type ChatStreamChunk = {
     /**
      * Error information
      */
-    error?: ErrorT | undefined;
+    error?: ChatStreamChunkError | undefined;
     /**
      * Unique chunk identifier
      */
@@ -62,8 +80,11 @@ export type ChatStreamChunk = {
     usage?: ChatUsage | undefined;
 };
 /** @internal */
-export declare const ErrorT$inboundSchema: z.ZodType<ErrorT, unknown>;
-export declare function errorFromJSON(jsonString: string): SafeParseResult<ErrorT, SDKValidationError>;
+export declare const ChatStreamChunkMetadata$inboundSchema: z.ZodType<ChatStreamChunkMetadata, unknown>;
+export declare function chatStreamChunkMetadataFromJSON(jsonString: string): SafeParseResult<ChatStreamChunkMetadata, SDKValidationError>;
+/** @internal */
+export declare const ChatStreamChunkError$inboundSchema: z.ZodType<ChatStreamChunkError, unknown>;
+export declare function chatStreamChunkErrorFromJSON(jsonString: string): SafeParseResult<ChatStreamChunkError, SDKValidationError>;
 /** @internal */
 export declare const ChatStreamChunkObject$inboundSchema: z.ZodEnum<typeof ChatStreamChunkObject>;
 /** @internal */

package/esm/models/chatstreamchunk.js

@@ -5,6 +5,7 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
+import { ApiErrorType$inboundSchema } from "./apierrortype.js";
 import { ChatStreamChoice$inboundSchema, } from "./chatstreamchoice.js";
 import { ChatUsage$inboundSchema } from "./chatusage.js";
 import { OpenRouterMetadata$inboundSchema, } from "./openroutermetadata.js";
@@ -12,12 +13,26 @@ export const ChatStreamChunkObject = {
     ChatCompletionChunk: "chat.completion.chunk",
 };
 /** @internal */
-export const ErrorT$inboundSchema = z.object({
+export const ChatStreamChunkMetadata$inboundSchema = z.object({
+    error_type: ApiErrorType$inboundSchema,
+    provider_code: z.string().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        "error_type": "errorType",
+        "provider_code": "providerCode",
+    });
+});
+export function chatStreamChunkMetadataFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ChatStreamChunkMetadata$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ChatStreamChunkMetadata' from JSON`);
+}
+/** @internal */
+export const ChatStreamChunkError$inboundSchema = z.object({
     code: z.int(),
     message: z.string(),
+    metadata: z.lazy(() => ChatStreamChunkMetadata$inboundSchema).optional(),
 });
-export function errorFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => ErrorT$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ErrorT' from JSON`);
+export function chatStreamChunkErrorFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ChatStreamChunkError$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ChatStreamChunkError' from JSON`);
 }
 /** @internal */
 export const ChatStreamChunkObject$inboundSchema = z.enum(ChatStreamChunkObject);
@@ -25,7 +40,7 @@ export const ChatStreamChunkObject$inboundSchema = z.enum(ChatStreamChunkObject)
 export const ChatStreamChunk$inboundSchema = z.object({
     choices: z.array(ChatStreamChoice$inboundSchema),
     created: z.int(),
-    error: z.lazy(() => ErrorT$inboundSchema).optional(),
+    error: z.lazy(() => ChatStreamChunkError$inboundSchema).optional(),
     id: z.string(),
     model: z.string(),
     object: ChatStreamChunkObject$inboundSchema,

package/esm/models/chatusage.d.ts

@@ -5,7 +5,7 @@ import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 /**
  * Detailed completion token usage
  */
-export type CompletionTokensDetails = {
+export type ChatUsageCompletionTokensDetails = {
     /**
      * Accepted prediction tokens
      */
@@ -26,7 +26,7 @@ export type CompletionTokensDetails = {
 /**
  * Detailed prompt token usage
  */
-export type PromptTokensDetails = {
+export type ChatUsagePromptTokensDetails = {
     /**
      * Audio input tokens
      */
@@ -44,6 +44,23 @@ export type PromptTokensDetails = {
      */
     videoTokens?: number | undefined;
 };
+/**
+ * Usage for server-side tool execution (e.g., web search)
+ */
+export type ServerToolUseDetails = {
+    /**
+     * Number of OpenRouter server tool calls that executed and produced a result
+     */
+    toolCallsExecuted?: number | null | undefined;
+    /**
+     * Total number of OpenRouter server-orchestrated tool calls the model requested, across all tool types. Provider-native tools (e.g. native web search) are not counted here.
+     */
+    toolCallsRequested?: number | null | undefined;
+    /**
+     * Number of web searches performed by server-side tools. For server-orchestrated tool calls a web search is also counted in tool_calls_requested; provider-native web search may report web_search_requests only. Do not sum the two.
+     */
+    webSearchRequests?: number | null | undefined;
+};
 /**
  * Token usage statistics
  */
@@ -55,7 +72,7 @@ export type ChatUsage = {
     /**
      * Detailed completion token usage
      */
-    completionTokensDetails?: CompletionTokensDetails | null | undefined;
+    completionTokensDetails?: ChatUsageCompletionTokensDetails | null | undefined;
     /**
      * Cost of the completion
      */
@@ -75,18 +92,25 @@ export type ChatUsage = {
     /**
      * Detailed prompt token usage
      */
-    promptTokensDetails?: PromptTokensDetails | null | undefined;
+    promptTokensDetails?: ChatUsagePromptTokensDetails | null | undefined;
+    /**
+     * Usage for server-side tool execution (e.g., web search)
+     */
+    serverToolUseDetails?: ServerToolUseDetails | null | undefined;
     /**
      * Total number of tokens
      */
     totalTokens: number;
 };
 /** @internal */
-export declare const CompletionTokensDetails$inboundSchema: z.ZodType<CompletionTokensDetails, unknown>;
-export declare function completionTokensDetailsFromJSON(jsonString: string): SafeParseResult<CompletionTokensDetails, SDKValidationError>;
+export declare const ChatUsageCompletionTokensDetails$inboundSchema: z.ZodType<ChatUsageCompletionTokensDetails, unknown>;
+export declare function chatUsageCompletionTokensDetailsFromJSON(jsonString: string): SafeParseResult<ChatUsageCompletionTokensDetails, SDKValidationError>;
+/** @internal */
+export declare const ChatUsagePromptTokensDetails$inboundSchema: z.ZodType<ChatUsagePromptTokensDetails, unknown>;
+export declare function chatUsagePromptTokensDetailsFromJSON(jsonString: string): SafeParseResult<ChatUsagePromptTokensDetails, SDKValidationError>;
 /** @internal */
-export declare const PromptTokensDetails$inboundSchema: z.ZodType<PromptTokensDetails, unknown>;
-export declare function promptTokensDetailsFromJSON(jsonString: string): SafeParseResult<PromptTokensDetails, SDKValidationError>;
+export declare const ServerToolUseDetails$inboundSchema: z.ZodType<ServerToolUseDetails, unknown>;
+export declare function serverToolUseDetailsFromJSON(jsonString: string): SafeParseResult<ServerToolUseDetails, SDKValidationError>;
 /** @internal */
 export declare const ChatUsage$inboundSchema: z.ZodType<ChatUsage, unknown>;
 export declare function chatUsageFromJSON(jsonString: string): SafeParseResult<ChatUsage, SDKValidationError>;

package/esm/models/chatusage.js

@@ -7,7 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 import { CostDetails$inboundSchema } from "./costdetails.js";
 /** @internal */
-export const CompletionTokensDetails$inboundSchema = z.object({
+export const ChatUsageCompletionTokensDetails$inboundSchema = z.object({
     accepted_prediction_tokens: z.nullable(z.int()).optional(),
     audio_tokens: z.nullable(z.int()).optional(),
     reasoning_tokens: z.nullable(z.int()).optional(),
@@ -20,11 +20,11 @@ export const CompletionTokensDetails$inboundSchema = z.object({
         "rejected_prediction_tokens": "rejectedPredictionTokens",
     });
 });
-export function completionTokensDetailsFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => CompletionTokensDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'CompletionTokensDetails' from JSON`);
+export function chatUsageCompletionTokensDetailsFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ChatUsageCompletionTokensDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ChatUsageCompletionTokensDetails' from JSON`);
 }
 /** @internal */
-export const PromptTokensDetails$inboundSchema = z.object({
+export const ChatUsagePromptTokensDetails$inboundSchema = z.object({
     audio_tokens: z.int().optional(),
     cache_write_tokens: z.int().optional(),
     cached_tokens: z.int().optional(),
@@ -37,18 +37,34 @@ export const PromptTokensDetails$inboundSchema = z.object({
         "video_tokens": "videoTokens",
     });
 });
-export function promptTokensDetailsFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => PromptTokensDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'PromptTokensDetails' from JSON`);
+export function chatUsagePromptTokensDetailsFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ChatUsagePromptTokensDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ChatUsagePromptTokensDetails' from JSON`);
+}
+/** @internal */
+export const ServerToolUseDetails$inboundSchema = z.object({
+    tool_calls_executed: z.nullable(z.int()).optional(),
+    tool_calls_requested: z.nullable(z.int()).optional(),
+    web_search_requests: z.nullable(z.int()).optional(),
+}).transform((v) => {
+    return remap$(v, {
+        "tool_calls_executed": "toolCallsExecuted",
+        "tool_calls_requested": "toolCallsRequested",
+        "web_search_requests": "webSearchRequests",
+    });
+});
+export function serverToolUseDetailsFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ServerToolUseDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ServerToolUseDetails' from JSON`);
 }
 /** @internal */
 export const ChatUsage$inboundSchema = z.object({
     completion_tokens: z.int(),
-    completion_tokens_details: z.nullable(z.lazy(() => CompletionTokensDetails$inboundSchema)).optional(),
+    completion_tokens_details: z.nullable(z.lazy(() => ChatUsageCompletionTokensDetails$inboundSchema)).optional(),
     cost: z.nullable(z.number()).optional(),
     cost_details: z.nullable(CostDetails$inboundSchema).optional(),
     is_byok: z.boolean().optional(),
     prompt_tokens: z.int(),
-    prompt_tokens_details: z.nullable(z.lazy(() => PromptTokensDetails$inboundSchema)).optional(),
+    prompt_tokens_details: z.nullable(z.lazy(() => ChatUsagePromptTokensDetails$inboundSchema)).optional(),
+    server_tool_use_details: z.nullable(z.lazy(() => ServerToolUseDetails$inboundSchema)).optional(),
     total_tokens: z.int(),
 }).transform((v) => {
     return remap$(v, {
@@ -58,6 +74,7 @@ export const ChatUsage$inboundSchema = z.object({
         "is_byok": "isByok",
         "prompt_tokens": "promptTokens",
         "prompt_tokens_details": "promptTokensDetails",
+        "server_tool_use_details": "serverToolUseDetails",
         "total_tokens": "totalTokens",
     });
 });

package/esm/models/chatwebsearchshorthand.d.ts

@@ -16,19 +16,23 @@ export type ChatWebSearchShorthandType = OpenEnum<typeof ChatWebSearchShorthandT
  */
 export type ChatWebSearchShorthand = {
     /**
-     * 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.
+     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, and most native providers (Anthropic, OpenAI, xAI). 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.
+     * 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. "perplexity" uses the Perplexity Search API (raw ranked results).
      */
     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.
+     * Exclude search results from these domains. Supported by Exa, Firecrawl, Parallel, Perplexity, Anthropic, and xAI. Not supported with OpenAI (silently ignored). 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.
+     * Exact maximum number of characters of content per search result. Applies to the Exa, Parallel, and Perplexity engines; ignored with native provider search and Firecrawl. For Exa, caps highlight content per result. For Parallel, caps excerpt content per result (default 1,500 when omitted). For Perplexity, maps to the native `max_tokens_per_page` parameter (converted from characters to tokens) and trims the response to the exact character cap. When both `max_characters` and `search_context_size` are set, `max_characters` takes precedence. When omitted, falls back to `search_context_size` mapping (Exa) or engine defaults (Parallel, Perplexity).
+     */
+    maxCharacters?: number | undefined;
+    /**
+     * Maximum number of search results to return per search call. Defaults to 5. Applies to Exa, Firecrawl, Parallel, and Perplexity engines; ignored with native provider search. Perplexity supports a maximum of 20; values above 20 are clamped.
      */
     maxResults?: number | undefined;
     /**
@@ -37,7 +41,7 @@ export type ChatWebSearchShorthand = {
     maxTotalResults?: number | undefined;
     parameters?: WebSearchConfig | undefined;
     /**
-     * How much context to retrieve per result. Applies to Exa and Parallel 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.
+     * 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.
      */
     searchContextSize?: SearchQualityLevel | undefined;
     type: ChatWebSearchShorthandType;
@@ -53,6 +57,7 @@ export type ChatWebSearchShorthand$Outbound = {
     allowed_domains?: Array<string> | undefined;
     engine?: string | undefined;
     excluded_domains?: Array<string> | undefined;
+    max_characters?: number | undefined;
     max_results?: number | undefined;
     max_total_results?: number | undefined;
     parameters?: WebSearchConfig$Outbound | undefined;

package/esm/models/chatwebsearchshorthand.js

@@ -22,6 +22,7 @@ export const ChatWebSearchShorthand$outboundSchema = z.object({
     allowedDomains: z.array(z.string()).optional(),
     engine: WebSearchEngineEnum$outboundSchema.optional(),
     excludedDomains: z.array(z.string()).optional(),
+    maxCharacters: z.int().optional(),
     maxResults: z.int().optional(),
     maxTotalResults: z.int().optional(),
     parameters: WebSearchConfig$outboundSchema.optional(),
@@ -32,6 +33,7 @@ export const ChatWebSearchShorthand$outboundSchema = z.object({
     return remap$(v, {
         allowedDomains: "allowed_domains",
         excludedDomains: "excluded_domains",
+        maxCharacters: "max_characters",
         maxResults: "max_results",
         maxTotalResults: "max_total_results",
         searchContextSize: "search_context_size",

package/esm/models/containerautoenvironment.d.ts

@@ -0,0 +1,15 @@
+import * as z from "zod/v4";
+/**
+ * An OpenRouter-managed, auto-provisioned ephemeral container.
+ */
+export type ContainerAutoEnvironment = {
+    type: "container_auto";
+};
+/** @internal */
+export type ContainerAutoEnvironment$Outbound = {
+    type: "container_auto";
+};
+/** @internal */
+export declare const ContainerAutoEnvironment$outboundSchema: z.ZodType<ContainerAutoEnvironment$Outbound, ContainerAutoEnvironment>;
+export declare function containerAutoEnvironmentToJSON(containerAutoEnvironment: ContainerAutoEnvironment): string;
+//# sourceMappingURL=containerautoenvironment.d.ts.map

package/esm/models/containerautoenvironment.js

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 49526688017e
+ */
+import * as z from "zod/v4";
+/** @internal */
+export const ContainerAutoEnvironment$outboundSchema = z.object({
+    type: z.literal("container_auto"),
+});
+export function containerAutoEnvironmentToJSON(containerAutoEnvironment) {
+    return JSON.stringify(ContainerAutoEnvironment$outboundSchema.parse(containerAutoEnvironment));
+}
+//# sourceMappingURL=containerautoenvironment.js.map

package/esm/models/containerreferenceenvironment.d.ts

@@ -0,0 +1,20 @@
+import * as z from "zod/v4";
+/**
+ * Reference to a previously created container to reuse.
+ */
+export type ContainerReferenceEnvironment = {
+    /**
+     * Identifier of an existing container to reuse (max 20 characters).
+     */
+    containerId: string;
+    type: "container_reference";
+};
+/** @internal */
+export type ContainerReferenceEnvironment$Outbound = {
+    container_id: string;
+    type: "container_reference";
+};
+/** @internal */
+export declare const ContainerReferenceEnvironment$outboundSchema: z.ZodType<ContainerReferenceEnvironment$Outbound, ContainerReferenceEnvironment>;
+export declare function containerReferenceEnvironmentToJSON(containerReferenceEnvironment: ContainerReferenceEnvironment): string;
+//# sourceMappingURL=containerreferenceenvironment.d.ts.map

package/esm/models/containerreferenceenvironment.js

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 711d3c8b4418
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+/** @internal */
+export const ContainerReferenceEnvironment$outboundSchema = z.object({
+    containerId: z.string(),
+    type: z.literal("container_reference"),
+}).transform((v) => {
+    return remap$(v, {
+        containerId: "container_id",
+    });
+});
+export function containerReferenceEnvironmentToJSON(containerReferenceEnvironment) {
+    return JSON.stringify(ContainerReferenceEnvironment$outboundSchema.parse(containerReferenceEnvironment));
+}
+//# sourceMappingURL=containerreferenceenvironment.js.map

package/esm/models/contentfilterbuiltinentry.d.ts

@@ -3,6 +3,7 @@ import { Result as SafeParseResult } from "../types/fp.js";
 import { ContentFilterBuiltinAction } from "./contentfilterbuiltinaction.js";
 import { ContentFilterBuiltinSlug } from "./contentfilterbuiltinslug.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+import { PromptInjectionScanScope } from "./promptinjectionscanscope.js";
 /**
  * A builtin content filter entry. Builtin filters include PII detectors and the regex-based prompt injection detector.
  */
@@ -15,6 +16,10 @@ export type ContentFilterBuiltinEntry = {
      * Read-only, system-assigned redaction placeholder derived from the slug (e.g. "[EMAIL]", "[PHONE]"). Not settable by the caller.
      */
     label?: string | undefined;
+    /**
+     * Which message roles to scan for prompt injection. Only applies to the regex-prompt-injection builtin. Defaults to all_messages.
+     */
+    scanScope?: PromptInjectionScanScope | undefined;
     /**
      * The builtin filter identifier
      */

package/esm/models/contentfilterbuiltinentry.js

@@ -3,14 +3,21 @@
  * @generated-id: a4c9b1effbc1
  */
 import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 import { ContentFilterBuiltinAction$inboundSchema, } from "./contentfilterbuiltinaction.js";
 import { ContentFilterBuiltinSlug$inboundSchema, } from "./contentfilterbuiltinslug.js";
+import { PromptInjectionScanScope$inboundSchema, } from "./promptinjectionscanscope.js";
 /** @internal */
 export const ContentFilterBuiltinEntry$inboundSchema = z.object({
     action: ContentFilterBuiltinAction$inboundSchema,
     label: z.string().optional(),
+    scan_scope: PromptInjectionScanScope$inboundSchema.optional(),
     slug: ContentFilterBuiltinSlug$inboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        "scan_scope": "scanScope",
+    });
 });
 export function contentFilterBuiltinEntryFromJSON(jsonString) {
     return safeParse(jsonString, (x) => ContentFilterBuiltinEntry$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ContentFilterBuiltinEntry' from JSON`);

package/esm/models/contentfilterbuiltinentryinput.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4";
 import { ContentFilterBuiltinAction } from "./contentfilterbuiltinaction.js";
 import { ContentFilterBuiltinSlug } from "./contentfilterbuiltinslug.js";
+import { PromptInjectionScanScope } from "./promptinjectionscanscope.js";
 /**
  * A builtin content filter entry for create/update requests. Labels are system-assigned and cannot be set by the caller.
  */
@@ -15,6 +16,10 @@ export type ContentFilterBuiltinEntryInput = {
      * @deprecated field: This will be removed in a future release, please migrate away from it as soon as possible.
      */
     label?: string | undefined;
+    /**
+     * Which message roles to scan for prompt injection. Only applies to the regex-prompt-injection builtin. Defaults to all_messages.
+     */
+    scanScope?: PromptInjectionScanScope | undefined;
     /**
      * The builtin filter identifier
      */
@@ -24,6 +29,7 @@ export type ContentFilterBuiltinEntryInput = {
 export type ContentFilterBuiltinEntryInput$Outbound = {
     action: string;
     label?: string | undefined;
+    scan_scope?: string | undefined;
     slug: string;
 };
 /** @internal */