@openrouter/sdk 0.12.34 → 0.12.79

package/esm/models/byokkey.js

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 7f8b3abf1e77
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { BYOKProviderSlug$inboundSchema, } from "./byokproviderslug.js";
+/** @internal */
+export const BYOKKey$inboundSchema = z.object({
+    allowed_api_key_hashes: z.nullable(z.array(z.string())),
+    allowed_models: z.nullable(z.array(z.string())),
+    allowed_user_ids: z.nullable(z.array(z.string())),
+    created_at: z.string(),
+    disabled: z.boolean(),
+    id: z.string(),
+    is_fallback: z.boolean(),
+    label: z.string(),
+    name: z.nullable(z.string()).optional(),
+    provider: BYOKProviderSlug$inboundSchema,
+    sort_order: z.int(),
+    workspace_id: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        "allowed_api_key_hashes": "allowedApiKeyHashes",
+        "allowed_models": "allowedModels",
+        "allowed_user_ids": "allowedUserIds",
+        "created_at": "createdAt",
+        "is_fallback": "isFallback",
+        "sort_order": "sortOrder",
+        "workspace_id": "workspaceId",
+    });
+});
+export function byokKeyFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => BYOKKey$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'BYOKKey' from JSON`);
+}
+//# sourceMappingURL=byokkey.js.map

package/esm/models/byokproviderslug.d.ts

@@ -0,0 +1,98 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * The upstream provider this credential authenticates against, as a lowercase slug (e.g. `openai`, `anthropic`, `amazon-bedrock`).
+ */
+export declare const BYOKProviderSlug: {
+    readonly Ai21: "ai21";
+    readonly AionLabs: "aion-labs";
+    readonly Akashml: "akashml";
+    readonly Alibaba: "alibaba";
+    readonly AmazonBedrock: "amazon-bedrock";
+    readonly AmazonNova: "amazon-nova";
+    readonly Ambient: "ambient";
+    readonly Anthropic: "anthropic";
+    readonly ArceeAi: "arcee-ai";
+    readonly AtlasCloud: "atlas-cloud";
+    readonly Avian: "avian";
+    readonly Azure: "azure";
+    readonly Baidu: "baidu";
+    readonly Baseten: "baseten";
+    readonly BlackForestLabs: "black-forest-labs";
+    readonly Byteplus: "byteplus";
+    readonly Cerebras: "cerebras";
+    readonly Chutes: "chutes";
+    readonly Cirrascale: "cirrascale";
+    readonly Clarifai: "clarifai";
+    readonly Cloudflare: "cloudflare";
+    readonly Cohere: "cohere";
+    readonly Crusoe: "crusoe";
+    readonly Darkbloom: "darkbloom";
+    readonly Deepinfra: "deepinfra";
+    readonly Deepseek: "deepseek";
+    readonly Dekallm: "dekallm";
+    readonly Digitalocean: "digitalocean";
+    readonly Featherless: "featherless";
+    readonly Fireworks: "fireworks";
+    readonly Friendli: "friendli";
+    readonly Gmicloud: "gmicloud";
+    readonly GoogleAiStudio: "google-ai-studio";
+    readonly GoogleVertex: "google-vertex";
+    readonly Groq: "groq";
+    readonly Hyperbolic: "hyperbolic";
+    readonly Inception: "inception";
+    readonly Inceptron: "inceptron";
+    readonly InferenceNet: "inference-net";
+    readonly Infermatic: "infermatic";
+    readonly Inflection: "inflection";
+    readonly IoNet: "io-net";
+    readonly Ionstream: "ionstream";
+    readonly Liquid: "liquid";
+    readonly Mancer: "mancer";
+    readonly Mara: "mara";
+    readonly Minimax: "minimax";
+    readonly Mistral: "mistral";
+    readonly Modelrun: "modelrun";
+    readonly Modular: "modular";
+    readonly Moonshotai: "moonshotai";
+    readonly Morph: "morph";
+    readonly Ncompass: "ncompass";
+    readonly Nebius: "nebius";
+    readonly NexAgi: "nex-agi";
+    readonly Nextbit: "nextbit";
+    readonly Novita: "novita";
+    readonly Nvidia: "nvidia";
+    readonly OpenInference: "open-inference";
+    readonly Openai: "openai";
+    readonly Parasail: "parasail";
+    readonly Perceptron: "perceptron";
+    readonly Perplexity: "perplexity";
+    readonly Phala: "phala";
+    readonly Poolside: "poolside";
+    readonly Recraft: "recraft";
+    readonly Reka: "reka";
+    readonly Relace: "relace";
+    readonly Sambanova: "sambanova";
+    readonly Seed: "seed";
+    readonly Siliconflow: "siliconflow";
+    readonly Sourceful: "sourceful";
+    readonly Stepfun: "stepfun";
+    readonly Streamlake: "streamlake";
+    readonly Switchpoint: "switchpoint";
+    readonly Together: "together";
+    readonly Upstage: "upstage";
+    readonly Venice: "venice";
+    readonly Wandb: "wandb";
+    readonly Xai: "xai";
+    readonly Xiaomi: "xiaomi";
+    readonly ZAi: "z-ai";
+};
+/**
+ * The upstream provider this credential authenticates against, as a lowercase slug (e.g. `openai`, `anthropic`, `amazon-bedrock`).
+ */
+export type BYOKProviderSlug = OpenEnum<typeof BYOKProviderSlug>;
+/** @internal */
+export declare const BYOKProviderSlug$inboundSchema: z.ZodType<BYOKProviderSlug, unknown>;
+/** @internal */
+export declare const BYOKProviderSlug$outboundSchema: z.ZodType<string, BYOKProviderSlug>;
+//# sourceMappingURL=byokproviderslug.d.ts.map

package/esm/models/byokproviderslug.js

@@ -0,0 +1,97 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f8e7a5a4b0a2
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * The upstream provider this credential authenticates against, as a lowercase slug (e.g. `openai`, `anthropic`, `amazon-bedrock`).
+ */
+export const BYOKProviderSlug = {
+    Ai21: "ai21",
+    AionLabs: "aion-labs",
+    Akashml: "akashml",
+    Alibaba: "alibaba",
+    AmazonBedrock: "amazon-bedrock",
+    AmazonNova: "amazon-nova",
+    Ambient: "ambient",
+    Anthropic: "anthropic",
+    ArceeAi: "arcee-ai",
+    AtlasCloud: "atlas-cloud",
+    Avian: "avian",
+    Azure: "azure",
+    Baidu: "baidu",
+    Baseten: "baseten",
+    BlackForestLabs: "black-forest-labs",
+    Byteplus: "byteplus",
+    Cerebras: "cerebras",
+    Chutes: "chutes",
+    Cirrascale: "cirrascale",
+    Clarifai: "clarifai",
+    Cloudflare: "cloudflare",
+    Cohere: "cohere",
+    Crusoe: "crusoe",
+    Darkbloom: "darkbloom",
+    Deepinfra: "deepinfra",
+    Deepseek: "deepseek",
+    Dekallm: "dekallm",
+    Digitalocean: "digitalocean",
+    Featherless: "featherless",
+    Fireworks: "fireworks",
+    Friendli: "friendli",
+    Gmicloud: "gmicloud",
+    GoogleAiStudio: "google-ai-studio",
+    GoogleVertex: "google-vertex",
+    Groq: "groq",
+    Hyperbolic: "hyperbolic",
+    Inception: "inception",
+    Inceptron: "inceptron",
+    InferenceNet: "inference-net",
+    Infermatic: "infermatic",
+    Inflection: "inflection",
+    IoNet: "io-net",
+    Ionstream: "ionstream",
+    Liquid: "liquid",
+    Mancer: "mancer",
+    Mara: "mara",
+    Minimax: "minimax",
+    Mistral: "mistral",
+    Modelrun: "modelrun",
+    Modular: "modular",
+    Moonshotai: "moonshotai",
+    Morph: "morph",
+    Ncompass: "ncompass",
+    Nebius: "nebius",
+    NexAgi: "nex-agi",
+    Nextbit: "nextbit",
+    Novita: "novita",
+    Nvidia: "nvidia",
+    OpenInference: "open-inference",
+    Openai: "openai",
+    Parasail: "parasail",
+    Perceptron: "perceptron",
+    Perplexity: "perplexity",
+    Phala: "phala",
+    Poolside: "poolside",
+    Recraft: "recraft",
+    Reka: "reka",
+    Relace: "relace",
+    Sambanova: "sambanova",
+    Seed: "seed",
+    Siliconflow: "siliconflow",
+    Sourceful: "sourceful",
+    Stepfun: "stepfun",
+    Streamlake: "streamlake",
+    Switchpoint: "switchpoint",
+    Together: "together",
+    Upstage: "upstage",
+    Venice: "venice",
+    Wandb: "wandb",
+    Xai: "xai",
+    Xiaomi: "xiaomi",
+    ZAi: "z-ai",
+};
+/** @internal */
+export const BYOKProviderSlug$inboundSchema = openEnums.inboundSchema(BYOKProviderSlug);
+/** @internal */
+export const BYOKProviderSlug$outboundSchema = openEnums.outboundSchema(BYOKProviderSlug);
+//# sourceMappingURL=byokproviderslug.js.map

package/esm/models/chatrequest.d.ts

@@ -15,12 +15,15 @@ import { ChatToolChoice, ChatToolChoice$Outbound } from "./chattoolchoice.js";
 import { ContextCompressionPlugin, ContextCompressionPlugin$Outbound } from "./contextcompressionplugin.js";
 import { FileParserPlugin, FileParserPlugin$Outbound } from "./fileparserplugin.js";
 import { FormatJsonObjectConfig, FormatJsonObjectConfig$Outbound } from "./formatjsonobjectconfig.js";
+import { FusionPlugin, FusionPlugin$Outbound } from "./fusionplugin.js";
 import { ImageConfig, ImageConfig$Outbound } from "./imageconfig.js";
 import { ModerationPlugin, ModerationPlugin$Outbound } from "./moderationplugin.js";
 import { ParetoRouterPlugin, ParetoRouterPlugin$Outbound } from "./paretorouterplugin.js";
 import { ProviderPreferences, ProviderPreferences$Outbound } from "./providerpreferences.js";
 import { ResponseHealingPlugin, ResponseHealingPlugin$Outbound } from "./responsehealingplugin.js";
+import { StopServerToolsWhenCondition, StopServerToolsWhenCondition$Outbound } from "./stopservertoolswhencondition.js";
 import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
+import { WebFetchPlugin, WebFetchPlugin$Outbound } from "./webfetchplugin.js";
 import { WebSearchPlugin, WebSearchPlugin$Outbound } from "./websearchplugin.js";
 export declare const Modality: {
     readonly Text: "text";
@@ -28,11 +31,11 @@ export declare const Modality: {
     readonly Audio: "audio";
 };
 export type Modality = OpenEnum<typeof Modality>;
-export type ChatRequestPlugin = AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | WebSearchPlugin;
+export type ChatRequestPlugin = AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | FusionPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | WebSearchPlugin | WebFetchPlugin;
 /**
  * Constrains effort on reasoning for reasoning models
  */
-export declare const Effort: {
+export declare const ChatRequestEffort: {
     readonly Xhigh: "xhigh";
     readonly High: "high";
     readonly Medium: "medium";
@@ -43,15 +46,15 @@ export declare const Effort: {
 /**
  * Constrains effort on reasoning for reasoning models
  */
-export type Effort = OpenEnum<typeof Effort>;
+export type ChatRequestEffort = OpenEnum<typeof ChatRequestEffort>;
 /**
  * Configuration options for reasoning models
  */
-export type Reasoning = {
+export type ChatRequestReasoning = {
     /**
      * Constrains effort on reasoning for reasoning models
      */
-    effort?: Effort | null | undefined;
+    effort?: ChatRequestEffort | null | undefined;
     summary?: ChatReasoningSummaryVerbosityEnum | null | undefined;
 };
 /**
@@ -80,6 +83,9 @@ export type Stop = string | Array<string> | any;
  * Chat completion request parameters
  */
 export type ChatRequest = {
+    /**
+     * Enable automatic prompt caching. When set at the top level, the system automatically applies cache breakpoints to the last cacheable block in the request. Currently supported for Anthropic Claude models.
+     */
     cacheControl?: AnthropicCacheControlDirective | undefined;
     /**
      * Debug options for inspecting request transformations (streaming only)
@@ -142,7 +148,7 @@ export type ChatRequest = {
     /**
      * Plugins you want to enable for this request, including their settings.
      */
-    plugins?: Array<AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | WebSearchPlugin> | undefined;
+    plugins?: Array<AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | FusionPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | WebSearchPlugin | WebFetchPlugin> | undefined;
     /**
      * Presence penalty (-2.0 to 2.0)
      */
@@ -154,7 +160,7 @@ export type ChatRequest = {
     /**
      * Configuration options for reasoning models
      */
-    reasoning?: Reasoning | undefined;
+    reasoning?: ChatRequestReasoning | undefined;
     /**
      * Response format configuration
      */
@@ -168,13 +174,17 @@ export type ChatRequest = {
      */
     serviceTier?: ChatRequestServiceTier | null | undefined;
     /**
-     * A unique identifier for grouping related requests (e.g., a conversation or agent workflow) for observability. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 256 characters.
+     * A unique identifier for grouping related requests (e.g., a conversation or agent workflow). When provided, OpenRouter uses it as the sticky routing key, routing all requests in the session to the same provider to maximize prompt cache hits. Also used for observability grouping. If provided in both the request body and the x-session-id header, the body value takes precedence. Maximum of 256 characters.
      */
     sessionId?: string | undefined;
     /**
      * Stop sequences (up to 4)
      */
     stop?: string | Array<string> | any | null | undefined;
+    /**
+     * Stop conditions for the server-tool agent loop. Any condition firing halts the loop (OR logic). When set, this overrides `max_tool_calls`.
+     */
+    stopServerToolsWhen?: Array<StopServerToolsWhenCondition> | undefined;
     /**
      * Enable streaming response
      */
@@ -215,20 +225,20 @@ export type ChatRequest = {
 /** @internal */
 export declare const Modality$outboundSchema: z.ZodType<string, Modality>;
 /** @internal */
-export type ChatRequestPlugin$Outbound = AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound;
+export type ChatRequestPlugin$Outbound = AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | FusionPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound | WebFetchPlugin$Outbound;
 /** @internal */
 export declare const ChatRequestPlugin$outboundSchema: z.ZodType<ChatRequestPlugin$Outbound, ChatRequestPlugin>;
 export declare function chatRequestPluginToJSON(chatRequestPlugin: ChatRequestPlugin): string;
 /** @internal */
-export declare const Effort$outboundSchema: z.ZodType<string, Effort>;
+export declare const ChatRequestEffort$outboundSchema: z.ZodType<string, ChatRequestEffort>;
 /** @internal */
-export type Reasoning$Outbound = {
+export type ChatRequestReasoning$Outbound = {
     effort?: string | null | undefined;
     summary?: string | null | undefined;
 };
 /** @internal */
-export declare const Reasoning$outboundSchema: z.ZodType<Reasoning$Outbound, Reasoning>;
-export declare function reasoningToJSON(reasoning: Reasoning): string;
+export declare const ChatRequestReasoning$outboundSchema: z.ZodType<ChatRequestReasoning$Outbound, ChatRequestReasoning>;
+export declare function chatRequestReasoningToJSON(chatRequestReasoning: ChatRequestReasoning): string;
 /** @internal */
 export type ResponseFormat$Outbound = ChatFormatGrammarConfig$Outbound | FormatJsonObjectConfig$Outbound | ChatFormatJsonSchemaConfig$Outbound | ChatFormatPythonConfig$Outbound | ChatFormatTextConfig$Outbound;
 /** @internal */
@@ -263,15 +273,16 @@ export type ChatRequest$Outbound = {
     model?: string | undefined;
     models?: Array<string> | undefined;
     parallel_tool_calls?: boolean | null | undefined;
-    plugins?: Array<AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound> | undefined;
+    plugins?: Array<AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | FusionPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound | WebFetchPlugin$Outbound> | undefined;
     presence_penalty?: number | null | undefined;
     provider?: ProviderPreferences$Outbound | null | undefined;
-    reasoning?: Reasoning$Outbound | undefined;
+    reasoning?: ChatRequestReasoning$Outbound | undefined;
     response_format?: ChatFormatGrammarConfig$Outbound | FormatJsonObjectConfig$Outbound | ChatFormatJsonSchemaConfig$Outbound | ChatFormatPythonConfig$Outbound | ChatFormatTextConfig$Outbound | undefined;
     seed?: number | null | undefined;
     service_tier?: string | null | undefined;
     session_id?: string | undefined;
     stop?: string | Array<string> | any | null | undefined;
+    stop_server_tools_when?: Array<StopServerToolsWhenCondition$Outbound> | undefined;
     stream: boolean;
     stream_options?: ChatStreamOptions$Outbound | null | undefined;
     temperature?: number | null | undefined;

package/esm/models/chatrequest.js

@@ -20,12 +20,15 @@ import { ChatToolChoice$outboundSchema, } from "./chattoolchoice.js";
 import { ContextCompressionPlugin$outboundSchema, } from "./contextcompressionplugin.js";
 import { FileParserPlugin$outboundSchema, } from "./fileparserplugin.js";
 import { FormatJsonObjectConfig$outboundSchema, } from "./formatjsonobjectconfig.js";
+import { FusionPlugin$outboundSchema, } from "./fusionplugin.js";
 import { ImageConfig$outboundSchema, } from "./imageconfig.js";
 import { ModerationPlugin$outboundSchema, } from "./moderationplugin.js";
 import { ParetoRouterPlugin$outboundSchema, } from "./paretorouterplugin.js";
 import { ProviderPreferences$outboundSchema, } from "./providerpreferences.js";
 import { ResponseHealingPlugin$outboundSchema, } from "./responsehealingplugin.js";
+import { StopServerToolsWhenCondition$outboundSchema, } from "./stopservertoolswhencondition.js";
 import { TraceConfig$outboundSchema, } from "./traceconfig.js";
+import { WebFetchPlugin$outboundSchema, } from "./webfetchplugin.js";
 import { WebSearchPlugin$outboundSchema, } from "./websearchplugin.js";
 export const Modality = {
     Text: "text",
@@ -35,7 +38,7 @@ export const Modality = {
 /**
  * Constrains effort on reasoning for reasoning models
  */
-export const Effort = {
+export const ChatRequestEffort = {
     Xhigh: "xhigh",
     High: "high",
     Medium: "medium",
@@ -61,25 +64,26 @@ export const ChatRequestPlugin$outboundSchema = z.union([
     AutoRouterPlugin$outboundSchema,
     ContextCompressionPlugin$outboundSchema,
     FileParserPlugin$outboundSchema,
+    FusionPlugin$outboundSchema,
     ModerationPlugin$outboundSchema,
     ParetoRouterPlugin$outboundSchema,
     ResponseHealingPlugin$outboundSchema,
     WebSearchPlugin$outboundSchema,
+    WebFetchPlugin$outboundSchema,
 ]);
 export function chatRequestPluginToJSON(chatRequestPlugin) {
     return JSON.stringify(ChatRequestPlugin$outboundSchema.parse(chatRequestPlugin));
 }
 /** @internal */
-export const Effort$outboundSchema = openEnums
-    .outboundSchema(Effort);
+export const ChatRequestEffort$outboundSchema = openEnums.outboundSchema(ChatRequestEffort);
 /** @internal */
-export const Reasoning$outboundSchema = z.object({
-    effort: z.nullable(Effort$outboundSchema).optional(),
+export const ChatRequestReasoning$outboundSchema = z.object({
+    effort: z.nullable(ChatRequestEffort$outboundSchema).optional(),
     summary: z.nullable(ChatReasoningSummaryVerbosityEnum$outboundSchema)
         .optional(),
 });
-export function reasoningToJSON(reasoning) {
-    return JSON.stringify(Reasoning$outboundSchema.parse(reasoning));
+export function chatRequestReasoningToJSON(chatRequestReasoning) {
+    return JSON.stringify(ChatRequestReasoning$outboundSchema.parse(chatRequestReasoning));
 }
 /** @internal */
 export const ResponseFormat$outboundSchema = z.union([
@@ -123,14 +127,16 @@ export const ChatRequest$outboundSchema = z.object({
         AutoRouterPlugin$outboundSchema,
         ContextCompressionPlugin$outboundSchema,
         FileParserPlugin$outboundSchema,
+        FusionPlugin$outboundSchema,
         ModerationPlugin$outboundSchema,
         ParetoRouterPlugin$outboundSchema,
         ResponseHealingPlugin$outboundSchema,
         WebSearchPlugin$outboundSchema,
+        WebFetchPlugin$outboundSchema,
     ])).optional(),
     presencePenalty: z.nullable(z.number()).optional(),
     provider: z.nullable(ProviderPreferences$outboundSchema).optional(),
-    reasoning: z.lazy(() => Reasoning$outboundSchema).optional(),
+    reasoning: z.lazy(() => ChatRequestReasoning$outboundSchema).optional(),
     responseFormat: z.union([
         ChatFormatGrammarConfig$outboundSchema,
         FormatJsonObjectConfig$outboundSchema,
@@ -143,6 +149,8 @@ export const ChatRequest$outboundSchema = z.object({
     sessionId: z.string().optional(),
     stop: z.nullable(z.union([z.string(), z.array(z.string()), z.any()]))
         .optional(),
+    stopServerToolsWhen: z.array(StopServerToolsWhenCondition$outboundSchema)
+        .optional(),
     stream: z.boolean().default(false),
     streamOptions: z.nullable(ChatStreamOptions$outboundSchema).optional(),
     temperature: z.nullable(z.number()).optional(),
@@ -165,6 +173,7 @@ export const ChatRequest$outboundSchema = z.object({
         responseFormat: "response_format",
         serviceTier: "service_tier",
         sessionId: "session_id",
+        stopServerToolsWhen: "stop_server_tools_when",
         streamOptions: "stream_options",
         toolChoice: "tool_choice",
         topLogprobs: "top_logprobs",

package/esm/models/chatservertoolchoice.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod/v4";
+/**
+ * OpenRouter extension: force a specific server tool by naming it directly in `tool_choice.type` instead of wrapping it in `{ type: "function", function: { name } }`.
+ */
+export type ChatServerToolChoice = {
+    /**
+     * OpenRouter server-tool type to force (e.g. `openrouter:web_search`, `web_search`, `web_search_preview`).
+     */
+    type: string;
+};
+/** @internal */
+export type ChatServerToolChoice$Outbound = {
+    type: string;
+};
+/** @internal */
+export declare const ChatServerToolChoice$outboundSchema: z.ZodType<ChatServerToolChoice$Outbound, ChatServerToolChoice>;
+export declare function chatServerToolChoiceToJSON(chatServerToolChoice: ChatServerToolChoice): string;
+//# sourceMappingURL=chatservertoolchoice.d.ts.map

package/esm/models/chatservertoolchoice.js

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 19d195c10298
+ */
+import * as z from "zod/v4";
+/** @internal */
+export const ChatServerToolChoice$outboundSchema = z.object({
+    type: z.string(),
+});
+export function chatServerToolChoiceToJSON(chatServerToolChoice) {
+    return JSON.stringify(ChatServerToolChoice$outboundSchema.parse(chatServerToolChoice));
+}
+//# sourceMappingURL=chatservertoolchoice.js.map

package/esm/models/chattoolchoice.d.ts

@@ -1,6 +1,7 @@
 import * as z from "zod/v4";
 import { ClosedEnum } from "../types/enums.js";
 import { ChatNamedToolChoice, ChatNamedToolChoice$Outbound } from "./chatnamedtoolchoice.js";
+import { ChatServerToolChoice, ChatServerToolChoice$Outbound } from "./chatservertoolchoice.js";
 export declare const ChatToolChoiceRequired: {
     readonly Required: "required";
 };
@@ -16,7 +17,7 @@ export type ChatToolChoiceNone = ClosedEnum<typeof ChatToolChoiceNone>;
 /**
  * Tool choice configuration
  */
-export type ChatToolChoice = ChatNamedToolChoice | ChatToolChoiceNone | ChatToolChoiceAuto | ChatToolChoiceRequired;
+export type ChatToolChoice = ChatNamedToolChoice | ChatServerToolChoice | ChatToolChoiceNone | ChatToolChoiceAuto | ChatToolChoiceRequired;
 /** @internal */
 export declare const ChatToolChoiceRequired$outboundSchema: z.ZodEnum<typeof ChatToolChoiceRequired>;
 /** @internal */
@@ -24,7 +25,7 @@ export declare const ChatToolChoiceAuto$outboundSchema: z.ZodEnum<typeof ChatToo
 /** @internal */
 export declare const ChatToolChoiceNone$outboundSchema: z.ZodEnum<typeof ChatToolChoiceNone>;
 /** @internal */
-export type ChatToolChoice$Outbound = ChatNamedToolChoice$Outbound | string | string | string;
+export type ChatToolChoice$Outbound = ChatNamedToolChoice$Outbound | ChatServerToolChoice$Outbound | string | string | string;
 /** @internal */
 export declare const ChatToolChoice$outboundSchema: z.ZodType<ChatToolChoice$Outbound, ChatToolChoice>;
 export declare function chatToolChoiceToJSON(chatToolChoice: ChatToolChoice): string;

package/esm/models/chattoolchoice.js

@@ -4,6 +4,7 @@
  */
 import * as z from "zod/v4";
 import { ChatNamedToolChoice$outboundSchema, } from "./chatnamedtoolchoice.js";
+import { ChatServerToolChoice$outboundSchema, } from "./chatservertoolchoice.js";
 export const ChatToolChoiceRequired = {
     Required: "required",
 };
@@ -22,6 +23,7 @@ export const ChatToolChoiceNone$outboundSchema = z.enum(ChatToolChoiceNone);
 /** @internal */
 export const ChatToolChoice$outboundSchema = z.union([
     ChatNamedToolChoice$outboundSchema,
+    ChatServerToolChoice$outboundSchema,
     ChatToolChoiceNone$outboundSchema,
     ChatToolChoiceAuto$outboundSchema,
     ChatToolChoiceRequired$outboundSchema,

package/esm/models/chatwebsearchshorthand.d.ts

@@ -32,12 +32,12 @@ export type ChatWebSearchShorthand = {
      */
     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.
+     * 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. Defaults to 50 when not specified.
      */
     maxTotalResults?: number | undefined;
     parameters?: WebSearchConfig | 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.
+     * 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.
      */
     searchContextSize?: SearchQualityLevel | undefined;
     type: ChatWebSearchShorthandType;

package/esm/models/compactionitem.d.ts

@@ -0,0 +1,26 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+export declare const CompactionItemType: {
+    readonly Compaction: "compaction";
+};
+export type CompactionItemType = ClosedEnum<typeof CompactionItemType>;
+/**
+ * A context compaction marker with encrypted summary
+ */
+export type CompactionItem = {
+    encryptedContent: string;
+    id?: string | null | undefined;
+    type: CompactionItemType;
+};
+/** @internal */
+export declare const CompactionItemType$outboundSchema: z.ZodEnum<typeof CompactionItemType>;
+/** @internal */
+export type CompactionItem$Outbound = {
+    encrypted_content: string;
+    id?: string | null | undefined;
+    type: string;
+};
+/** @internal */
+export declare const CompactionItem$outboundSchema: z.ZodType<CompactionItem$Outbound, CompactionItem>;
+export declare function compactionItemToJSON(compactionItem: CompactionItem): string;
+//# sourceMappingURL=compactionitem.d.ts.map

package/esm/models/compactionitem.js

@@ -0,0 +1,25 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 0c9fb29a5c84
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+export const CompactionItemType = {
+    Compaction: "compaction",
+};
+/** @internal */
+export const CompactionItemType$outboundSchema = z.enum(CompactionItemType);
+/** @internal */
+export const CompactionItem$outboundSchema = z.object({
+    encryptedContent: z.string(),
+    id: z.nullable(z.string()).optional(),
+    type: CompactionItemType$outboundSchema,
+}).transform((v) => {
+    return remap$(v, {
+        encryptedContent: "encrypted_content",
+    });
+});
+export function compactionItemToJSON(compactionItem) {
+    return JSON.stringify(CompactionItem$outboundSchema.parse(compactionItem));
+}
+//# sourceMappingURL=compactionitem.js.map

package/esm/models/contentfilterbuiltinentry.d.ts

@@ -12,7 +12,7 @@ export type ContentFilterBuiltinEntry = {
      */
     action: ContentFilterBuiltinAction;
     /**
-     * Optional label used in redaction placeholders (e.g. "[PROMPT_INJECTION]")
+     * Read-only, system-assigned redaction placeholder derived from the slug (e.g. "[EMAIL]", "[PHONE]"). Not settable by the caller.
      */
     label?: string | undefined;
     /**
@@ -22,14 +22,5 @@ export type ContentFilterBuiltinEntry = {
 };
 /** @internal */
 export declare const ContentFilterBuiltinEntry$inboundSchema: z.ZodType<ContentFilterBuiltinEntry, unknown>;
-/** @internal */
-export type ContentFilterBuiltinEntry$Outbound = {
-    action: string;
-    label?: string | undefined;
-    slug: string;
-};
-/** @internal */
-export declare const ContentFilterBuiltinEntry$outboundSchema: z.ZodType<ContentFilterBuiltinEntry$Outbound, ContentFilterBuiltinEntry>;
-export declare function contentFilterBuiltinEntryToJSON(contentFilterBuiltinEntry: ContentFilterBuiltinEntry): string;
 export declare function contentFilterBuiltinEntryFromJSON(jsonString: string): SafeParseResult<ContentFilterBuiltinEntry, SDKValidationError>;
 //# sourceMappingURL=contentfilterbuiltinentry.d.ts.map