@openrouter/sdk 0.12.79 → 0.13.7

package/esm/models/subagentnestedtool.d.ts

@@ -0,0 +1,25 @@
+import * as z from "zod/v4";
+/**
+ * A tool made available to the subagent. Only OpenRouter server tools (e.g. openrouter:web_search) are supported; function tools are rejected because the worker has no way to execute them. The subagent tool may not list itself.
+ */
+export type SubagentNestedTool = {
+    parameters?: {
+        [k: string]: any | null;
+    } | undefined;
+    type: string;
+    additionalProperties?: {
+        [k: string]: any | null;
+    } | undefined;
+};
+/** @internal */
+export type SubagentNestedTool$Outbound = {
+    parameters?: {
+        [k: string]: any | null;
+    } | undefined;
+    type: string;
+    [additionalProperties: string]: unknown;
+};
+/** @internal */
+export declare const SubagentNestedTool$outboundSchema: z.ZodType<SubagentNestedTool$Outbound, SubagentNestedTool>;
+export declare function subagentNestedToolToJSON(subagentNestedTool: SubagentNestedTool): string;
+//# sourceMappingURL=subagentnestedtool.d.ts.map

package/esm/models/subagentnestedtool.js

@@ -0,0 +1,23 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9d5ec7df4bc2
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+/** @internal */
+export const SubagentNestedTool$outboundSchema = z.object({
+    parameters: z.record(z.string(), z.nullable(z.any())).optional(),
+    type: z.string(),
+    additionalProperties: z.record(z.string(), z.nullable(z.any())).optional(),
+}).transform((v) => {
+    return {
+        ...v.additionalProperties,
+        ...remap$(v, {
+            additionalProperties: null,
+        }),
+    };
+});
+export function subagentNestedToolToJSON(subagentNestedTool) {
+    return JSON.stringify(SubagentNestedTool$outboundSchema.parse(subagentNestedTool));
+}
+//# sourceMappingURL=subagentnestedtool.js.map

package/esm/models/subagentreasoning.d.ts

@@ -0,0 +1,41 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Reasoning effort level for the subagent call.
+ */
+export declare const SubagentReasoningEffort: {
+    readonly Xhigh: "xhigh";
+    readonly High: "high";
+    readonly Medium: "medium";
+    readonly Low: "low";
+    readonly Minimal: "minimal";
+    readonly None: "none";
+};
+/**
+ * Reasoning effort level for the subagent call.
+ */
+export type SubagentReasoningEffort = OpenEnum<typeof SubagentReasoningEffort>;
+/**
+ * Reasoning configuration forwarded to the subagent call. Use this to control reasoning effort and token budget for models that support extended thinking.
+ */
+export type SubagentReasoning = {
+    /**
+     * Reasoning effort level for the subagent call.
+     */
+    effort?: SubagentReasoningEffort | undefined;
+    /**
+     * Maximum number of reasoning tokens the subagent may use. Accepted and validated but not yet forwarded to the subagent call.
+     */
+    maxTokens?: number | undefined;
+};
+/** @internal */
+export declare const SubagentReasoningEffort$outboundSchema: z.ZodType<string, SubagentReasoningEffort>;
+/** @internal */
+export type SubagentReasoning$Outbound = {
+    effort?: string | undefined;
+    max_tokens?: number | undefined;
+};
+/** @internal */
+export declare const SubagentReasoning$outboundSchema: z.ZodType<SubagentReasoning$Outbound, SubagentReasoning>;
+export declare function subagentReasoningToJSON(subagentReasoning: SubagentReasoning): string;
+//# sourceMappingURL=subagentreasoning.d.ts.map

package/esm/models/subagentreasoning.js

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 916aba5c0712
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import * as openEnums from "../types/enums.js";
+/**
+ * Reasoning effort level for the subagent call.
+ */
+export const SubagentReasoningEffort = {
+    Xhigh: "xhigh",
+    High: "high",
+    Medium: "medium",
+    Low: "low",
+    Minimal: "minimal",
+    None: "none",
+};
+/** @internal */
+export const SubagentReasoningEffort$outboundSchema = openEnums.outboundSchema(SubagentReasoningEffort);
+/** @internal */
+export const SubagentReasoning$outboundSchema = z.object({
+    effort: SubagentReasoningEffort$outboundSchema.optional(),
+    maxTokens: z.int().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        maxTokens: "max_tokens",
+    });
+});
+export function subagentReasoningToJSON(subagentReasoning) {
+    return JSON.stringify(SubagentReasoning$outboundSchema.parse(subagentReasoning));
+}
+//# sourceMappingURL=subagentreasoning.js.map

package/esm/models/subagentservertoolconfig.d.ts

@@ -0,0 +1,50 @@
+import * as z from "zod/v4";
+import { SubagentNestedTool, SubagentNestedTool$Outbound } from "./subagentnestedtool.js";
+import { SubagentReasoning, SubagentReasoning$Outbound } from "./subagentreasoning.js";
+/**
+ * Configuration for the openrouter:subagent server tool.
+ */
+export type SubagentServerToolConfig = {
+    /**
+     * System instructions for the subagent. When omitted, the subagent responds with no system prompt of its own.
+     */
+    instructions?: string | undefined;
+    /**
+     * Maximum number of output tokens (including reasoning) the subagent may produce. When omitted, the provider's default applies.
+     */
+    maxCompletionTokens?: number | undefined;
+    /**
+     * Maximum number of tool-calling steps the subagent may take during its agentic loop. Capped at 25. Only relevant when the subagent is given tools. Accepted and validated but not yet enforced on the subagent call.
+     */
+    maxToolCalls?: number | undefined;
+    /**
+     * Slug of the model that executes delegated tasks (any OpenRouter model). Typically a smaller, cheaper, faster model than the one delegating. When omitted, the model from the outer API request is used. The subagent tool itself cannot be the subagent model.
+     */
+    model?: string | undefined;
+    /**
+     * Reasoning configuration forwarded to the subagent call. Use this to control reasoning effort and token budget for models that support extended thinking.
+     */
+    reasoning?: SubagentReasoning | undefined;
+    /**
+     * Sampling temperature forwarded to the subagent call. When omitted, the provider's default applies.
+     */
+    temperature?: number | undefined;
+    /**
+     * Tools the subagent may use while executing a delegated task. The subagent runs as an agentic sub-agent over these tools, then returns its outcome. Only OpenRouter server tools are supported — function tools are rejected — and the list must not include the subagent tool itself.
+     */
+    tools?: Array<SubagentNestedTool> | undefined;
+};
+/** @internal */
+export type SubagentServerToolConfig$Outbound = {
+    instructions?: string | undefined;
+    max_completion_tokens?: number | undefined;
+    max_tool_calls?: number | undefined;
+    model?: string | undefined;
+    reasoning?: SubagentReasoning$Outbound | undefined;
+    temperature?: number | undefined;
+    tools?: Array<SubagentNestedTool$Outbound> | undefined;
+};
+/** @internal */
+export declare const SubagentServerToolConfig$outboundSchema: z.ZodType<SubagentServerToolConfig$Outbound, SubagentServerToolConfig>;
+export declare function subagentServerToolConfigToJSON(subagentServerToolConfig: SubagentServerToolConfig): string;
+//# sourceMappingURL=subagentservertoolconfig.d.ts.map

package/esm/models/subagentservertoolconfig.js

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6f8ec51577e6
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { SubagentNestedTool$outboundSchema, } from "./subagentnestedtool.js";
+import { SubagentReasoning$outboundSchema, } from "./subagentreasoning.js";
+/** @internal */
+export const SubagentServerToolConfig$outboundSchema = z.object({
+    instructions: z.string().optional(),
+    maxCompletionTokens: z.int().optional(),
+    maxToolCalls: z.int().optional(),
+    model: z.string().optional(),
+    reasoning: SubagentReasoning$outboundSchema.optional(),
+    temperature: z.number().optional(),
+    tools: z.array(SubagentNestedTool$outboundSchema).optional(),
+}).transform((v) => {
+    return remap$(v, {
+        maxCompletionTokens: "max_completion_tokens",
+        maxToolCalls: "max_tool_calls",
+    });
+});
+export function subagentServerToolConfigToJSON(subagentServerToolConfig) {
+    return JSON.stringify(SubagentServerToolConfig$outboundSchema.parse(subagentServerToolConfig));
+}
+//# sourceMappingURL=subagentservertoolconfig.js.map

package/esm/models/subagentservertoolopenrouter.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { SubagentServerToolConfig, SubagentServerToolConfig$Outbound } from "./subagentservertoolconfig.js";
+export declare const SubagentServerToolOpenRouterType: {
+    readonly OpenrouterSubagent: "openrouter:subagent";
+};
+export type SubagentServerToolOpenRouterType = ClosedEnum<typeof SubagentServerToolOpenRouterType>;
+/**
+ * OpenRouter built-in server tool: delegates self-contained tasks to a smaller, cheaper, faster worker model (any OpenRouter model) mid-generation and returns its outcome. The worker may run as a sub-agent with its own tools.
+ */
+export type SubagentServerToolOpenRouter = {
+    /**
+     * Configuration for the openrouter:subagent server tool.
+     */
+    parameters?: SubagentServerToolConfig | undefined;
+    type: SubagentServerToolOpenRouterType;
+};
+/** @internal */
+export declare const SubagentServerToolOpenRouterType$outboundSchema: z.ZodEnum<typeof SubagentServerToolOpenRouterType>;
+/** @internal */
+export type SubagentServerToolOpenRouter$Outbound = {
+    parameters?: SubagentServerToolConfig$Outbound | undefined;
+    type: string;
+};
+/** @internal */
+export declare const SubagentServerToolOpenRouter$outboundSchema: z.ZodType<SubagentServerToolOpenRouter$Outbound, SubagentServerToolOpenRouter>;
+export declare function subagentServerToolOpenRouterToJSON(subagentServerToolOpenRouter: SubagentServerToolOpenRouter): string;
+//# sourceMappingURL=subagentservertoolopenrouter.d.ts.map

package/esm/models/subagentservertoolopenrouter.js

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: fe81bd2eaa91
+ */
+import * as z from "zod/v4";
+import { SubagentServerToolConfig$outboundSchema, } from "./subagentservertoolconfig.js";
+export const SubagentServerToolOpenRouterType = {
+    OpenrouterSubagent: "openrouter:subagent",
+};
+/** @internal */
+export const SubagentServerToolOpenRouterType$outboundSchema = z.enum(SubagentServerToolOpenRouterType);
+/** @internal */
+export const SubagentServerToolOpenRouter$outboundSchema = z.object({
+    parameters: SubagentServerToolConfig$outboundSchema.optional(),
+    type: SubagentServerToolOpenRouterType$outboundSchema,
+});
+export function subagentServerToolOpenRouterToJSON(subagentServerToolOpenRouter) {
+    return JSON.stringify(SubagentServerToolOpenRouter$outboundSchema.parse(subagentServerToolOpenRouter));
+}
+//# sourceMappingURL=subagentservertoolopenrouter.js.map

package/esm/models/updateobservabilitydestinationrequest.d.ts

@@ -25,7 +25,7 @@ export type UpdateObservabilityDestinationRequest = {
      */
     privacyMode?: boolean | undefined;
     /**
-     * Sampling rate between 0 and 1 (1 = 100%).
+     * Sampling rate between 0.0001 and 1 (1 = 100%).
      */
     samplingRate?: number | undefined;
 };

package/esm/models/urlcitation.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 export type URLCitation = {
+    content?: string | undefined;
     endIndex: number;
     startIndex: number;
     title: string;
@@ -12,6 +13,7 @@ export type URLCitation = {
 export declare const URLCitation$inboundSchema: z.ZodType<URLCitation, unknown>;
 /** @internal */
 export type URLCitation$Outbound = {
+    content?: string | undefined;
     end_index: number;
     start_index: number;
     title: string;

package/esm/models/urlcitation.js

@@ -8,6 +8,7 @@ import { safeParse } from "../lib/schemas.js";
 /** @internal */
 export const URLCitation$inboundSchema = z
     .object({
+    content: z.string().optional(),
     end_index: z.int(),
     start_index: z.int(),
     title: z.string(),
@@ -21,6 +22,7 @@ export const URLCitation$inboundSchema = z
 });
 /** @internal */
 export const URLCitation$outboundSchema = z.object({
+    content: z.string().optional(),
     endIndex: z.int(),
     startIndex: z.int(),
     title: z.string(),

package/esm/models/videogenerationrequest.d.ts

@@ -1,7 +1,7 @@
 import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
-import { ContentPartImage, ContentPartImage$Outbound } from "./contentpartimage.js";
 import { FrameImage, FrameImage$Outbound } from "./frameimage.js";
+import { InputReference, InputReference$Outbound } from "./inputreference.js";
 /**
  * Aspect ratio of the generated video
  */
@@ -114,6 +114,9 @@ export type Options = {
     darkbloom?: {
         [k: string]: any | null;
     } | undefined;
+    decart?: {
+        [k: string]: any | null;
+    } | undefined;
     deepinfra?: {
         [k: string]: any | null;
     } | undefined;
@@ -351,6 +354,9 @@ export type Options = {
     venice?: {
         [k: string]: any | null;
     } | undefined;
+    wafer?: {
+        [k: string]: any | null;
+    } | undefined;
     wandb?: {
         [k: string]: any | null;
     } | undefined;
@@ -407,9 +413,9 @@ export type VideoGenerationRequest = {
      */
     generateAudio?: boolean | undefined;
     /**
-     * Reference images to guide video generation
+     * 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.
      */
-    inputReferences?: Array<ContentPartImage> | undefined;
+    inputReferences?: Array<InputReference> | undefined;
     model: string;
     prompt: string;
     /**
@@ -523,6 +529,9 @@ export type Options$Outbound = {
     darkbloom?: {
         [k: string]: any | null;
     } | undefined;
+    decart?: {
+        [k: string]: any | null;
+    } | undefined;
     deepinfra?: {
         [k: string]: any | null;
     } | undefined;
@@ -760,6 +769,9 @@ export type Options$Outbound = {
     venice?: {
         [k: string]: any | null;
     } | undefined;
+    wafer?: {
+        [k: string]: any | null;
+    } | undefined;
     wandb?: {
         [k: string]: any | null;
     } | undefined;
@@ -792,7 +804,7 @@ export type VideoGenerationRequest$Outbound = {
     duration?: number | undefined;
     frame_images?: Array<FrameImage$Outbound> | undefined;
     generate_audio?: boolean | undefined;
-    input_references?: Array<ContentPartImage$Outbound> | undefined;
+    input_references?: Array<InputReference$Outbound> | undefined;
     model: string;
     prompt: string;
     provider?: VideoGenerationRequestProvider$Outbound | undefined;

package/esm/models/videogenerationrequest.js

@@ -5,8 +5,8 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
-import { ContentPartImage$outboundSchema, } from "./contentpartimage.js";
 import { FrameImage$outboundSchema, } from "./frameimage.js";
+import { InputReference$outboundSchema, } from "./inputreference.js";
 /**
  * Aspect ratio of the generated video
  */
@@ -67,6 +67,7 @@ export const Options$outboundSchema = z
     crucible: z.record(z.string(), z.nullable(z.any())).optional(),
     crusoe: z.record(z.string(), z.nullable(z.any())).optional(),
     darkbloom: z.record(z.string(), z.nullable(z.any())).optional(),
+    decart: z.record(z.string(), z.nullable(z.any())).optional(),
     deepinfra: z.record(z.string(), z.nullable(z.any())).optional(),
     deepseek: z.record(z.string(), z.nullable(z.any())).optional(),
     dekallm: z.record(z.string(), z.nullable(z.any())).optional(),
@@ -146,6 +147,7 @@ export const Options$outboundSchema = z
     ubicloud: z.record(z.string(), z.nullable(z.any())).optional(),
     upstage: z.record(z.string(), z.nullable(z.any())).optional(),
     venice: z.record(z.string(), z.nullable(z.any())).optional(),
+    wafer: z.record(z.string(), z.nullable(z.any())).optional(),
     wandb: z.record(z.string(), z.nullable(z.any())).optional(),
     xai: z.record(z.string(), z.nullable(z.any())).optional(),
     xiaomi: z.record(z.string(), z.nullable(z.any())).optional(),
@@ -194,7 +196,7 @@ export const VideoGenerationRequest$outboundSchema = z.object({
     duration: z.int().optional(),
     frameImages: z.array(FrameImage$outboundSchema).optional(),
     generateAudio: z.boolean().optional(),
-    inputReferences: z.array(ContentPartImage$outboundSchema).optional(),
+    inputReferences: z.array(InputReference$outboundSchema).optional(),
     model: z.string(),
     prompt: z.string(),
     provider: z.lazy(() => VideoGenerationRequestProvider$outboundSchema)

package/esm/models/websearchconfig.d.ts

@@ -4,19 +4,23 @@ import { WebSearchEngineEnum } from "./websearchengineenum.js";
 import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbound } from "./websearchuserlocationservertool.js";
 export type WebSearchConfig = {
     /**
-     * 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.
      */
     maxResults?: number | undefined;
     /**
@@ -24,7 +28,7 @@ export type WebSearchConfig = {
      */
     maxTotalResults?: number | 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;
     /**
@@ -37,6 +41,7 @@ export type WebSearchConfig$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;
     search_context_size?: string | undefined;

package/esm/models/websearchconfig.js

@@ -12,6 +12,7 @@ export const WebSearchConfig$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(),
     searchContextSize: SearchQualityLevel$outboundSchema.optional(),
@@ -20,6 +21,7 @@ export const WebSearchConfig$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/websearchengine.d.ts

@@ -8,6 +8,7 @@ export declare const WebSearchEngine: {
     readonly Exa: "exa";
     readonly Firecrawl: "firecrawl";
     readonly Parallel: "parallel";
+    readonly Perplexity: "perplexity";
 };
 /**
  * The search engine to use for web search.

package/esm/models/websearchengine.js

@@ -11,6 +11,7 @@ export const WebSearchEngine = {
     Exa: "exa",
     Firecrawl: "firecrawl",
     Parallel: "parallel",
+    Perplexity: "perplexity",
 };
 /** @internal */
 export const WebSearchEngine$outboundSchema = openEnums.outboundSchema(WebSearchEngine);

package/esm/models/websearchengineenum.d.ts

@@ -1,17 +1,18 @@
 import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 /**
- * 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).
  */
 export declare const WebSearchEngineEnum: {
-    readonly Auto: "auto";
     readonly Native: "native";
     readonly Exa: "exa";
     readonly Parallel: "parallel";
     readonly Firecrawl: "firecrawl";
+    readonly Perplexity: "perplexity";
+    readonly Auto: "auto";
 };
 /**
- * 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).
  */
 export type WebSearchEngineEnum = OpenEnum<typeof WebSearchEngineEnum>;
 /** @internal */

package/esm/models/websearchengineenum.js

@@ -4,14 +4,15 @@
  */
 import * as openEnums from "../types/enums.js";
 /**
- * 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).
  */
 export const WebSearchEngineEnum = {
-    Auto: "auto",
     Native: "native",
     Exa: "exa",
     Parallel: "parallel",
     Firecrawl: "firecrawl",
+    Perplexity: "perplexity",
+    Auto: "auto",
 };
 /** @internal */
 export const WebSearchEngineEnum$inboundSchema = openEnums.inboundSchema(WebSearchEngineEnum);

package/esm/models/websearchservertool.d.ts

@@ -10,12 +10,12 @@ import { WebSearchUserLocation, WebSearchUserLocation$Outbound } from "./websear
  */
 export type WebSearchServerTool = {
     /**
-     * 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;
     filters?: WebSearchDomainFilter | null | 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.
+     * 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.
      */
     maxResults?: number | undefined;
     /**

package/esm/models/websearchservertoolconfig.d.ts

@@ -7,19 +7,23 @@ import { WebSearchUserLocationServerTool, WebSearchUserLocationServerTool$Outbou
  */
 export type WebSearchServerToolConfig = {
     /**
-     * Limit search results to these domains. Supported by Exa, Firecrawl, Parallel, and most native providers (Anthropic, OpenAI, xAI). Not supported with Perplexity. Cannot be used with excluded_domains.
+     * 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.
      */
     maxResults?: number | undefined;
     /**
@@ -27,7 +31,7 @@ export type WebSearchServerToolConfig = {
      */
     maxTotalResults?: number | 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;
     /**
@@ -40,6 +44,7 @@ export type WebSearchServerToolConfig$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;
     search_context_size?: string | undefined;

package/esm/models/websearchservertoolconfig.js

@@ -12,6 +12,7 @@ export const WebSearchServerToolConfig$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(),
     searchContextSize: SearchQualityLevel$outboundSchema.optional(),
@@ -20,6 +21,7 @@ export const WebSearchServerToolConfig$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/sdk/beta.d.ts

@@ -1,6 +1,9 @@
 import { ClientSDK } from "../lib/sdks.js";
+import { BetaAnalytics } from "./betaanalytics.js";
 import { Responses } from "./responses.js";
 export declare class Beta extends ClientSDK {
+    private _analytics?;
+    get analytics(): BetaAnalytics;
     private _responses?;
     get responses(): Responses;
 }

package/esm/sdk/beta.js

@@ -3,8 +3,12 @@
  * @generated-id: afeac65e28f8
  */
 import { ClientSDK } from "../lib/sdks.js";
+import { BetaAnalytics } from "./betaanalytics.js";
 import { Responses } from "./responses.js";
 export class Beta extends ClientSDK {
+    get analytics() {
+        return (this._analytics ?? (this._analytics = new BetaAnalytics(this._options)));
+    }
     get responses() {
         return (this._responses ?? (this._responses = new Responses(this._options)));
     }