@openrouter/sdk 0.12.79 → 0.13.13

package/esm/models/videogenerationrequest.d.ts

@@ -1,11 +1,11 @@
 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
  */
-export declare const AspectRatio: {
+export declare const VideoGenerationRequestAspectRatio: {
     readonly OneHundredAndSixtyNine: "16:9";
     readonly NineHundredAndSixteen: "9:16";
     readonly Eleven: "1:1";
@@ -19,11 +19,11 @@ export declare const AspectRatio: {
 /**
  * Aspect ratio of the generated video
  */
-export type AspectRatio = OpenEnum<typeof AspectRatio>;
+export type VideoGenerationRequestAspectRatio = OpenEnum<typeof VideoGenerationRequestAspectRatio>;
 /**
- * Provider-specific options keyed by provider slug. The options for the matched provider are spread into the upstream request body.
+ * Provider-specific options keyed by provider slug. Only options for the matched provider are forwarded; the rest are ignored. Unrecognized keys are silently dropped.
  */
-export type Options = {
+export type VideoGenerationRequestOptions = {
     oneai?: {
         [k: string]: any | null;
     } | undefined;
@@ -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;
@@ -171,6 +174,9 @@ export type Options = {
     inceptron?: {
         [k: string]: any | null;
     } | undefined;
+    inferactVllm?: {
+        [k: string]: any | null;
+    } | undefined;
     inferenceNet?: {
         [k: string]: any | null;
     } | undefined;
@@ -303,6 +309,9 @@ export type Options = {
     replicate?: {
         [k: string]: any | null;
     } | undefined;
+    sakanaAi?: {
+        [k: string]: any | null;
+    } | undefined;
     sambanova?: {
         [k: string]: any | null;
     } | undefined;
@@ -336,6 +345,9 @@ export type Options = {
     targon?: {
         [k: string]: any | null;
     } | undefined;
+    tenstorrent?: {
+        [k: string]: any | null;
+    } | undefined;
     together?: {
         [k: string]: any | null;
     } | undefined;
@@ -351,6 +363,9 @@ export type Options = {
     venice?: {
         [k: string]: any | null;
     } | undefined;
+    wafer?: {
+        [k: string]: any | null;
+    } | undefined;
     wandb?: {
         [k: string]: any | null;
     } | undefined;
@@ -368,12 +383,12 @@ export type Options = {
  * Provider-specific passthrough configuration
  */
 export type VideoGenerationRequestProvider = {
-    options?: Options | undefined;
+    options?: VideoGenerationRequestOptions | undefined;
 };
 /**
  * Resolution of the generated video
  */
-export declare const Resolution: {
+export declare const VideoGenerationRequestResolution: {
     readonly FourHundredAndEightyp: "480p";
     readonly SevenHundredAndTwentyp: "720p";
     readonly OneThousandAndEightyp: "1080p";
@@ -384,12 +399,12 @@ export declare const Resolution: {
 /**
  * Resolution of the generated video
  */
-export type Resolution = OpenEnum<typeof Resolution>;
+export type VideoGenerationRequestResolution = OpenEnum<typeof VideoGenerationRequestResolution>;
 export type VideoGenerationRequest = {
     /**
      * Aspect ratio of the generated video
      */
-    aspectRatio?: AspectRatio | undefined;
+    aspectRatio?: VideoGenerationRequestAspectRatio | undefined;
     /**
      * URL to receive a webhook notification when the video generation job completes. Overrides the workspace-level default callback URL if set. Must be HTTPS.
      */
@@ -407,9 +422,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;
     /**
@@ -419,7 +434,7 @@ export type VideoGenerationRequest = {
     /**
      * Resolution of the generated video
      */
-    resolution?: Resolution | undefined;
+    resolution?: VideoGenerationRequestResolution | undefined;
     /**
      * If specified, the generation will sample deterministically, such that repeated requests with the same seed and parameters should return the same result. Determinism is not guaranteed for all providers.
      */
@@ -430,9 +445,9 @@ export type VideoGenerationRequest = {
     size?: string | undefined;
 };
 /** @internal */
-export declare const AspectRatio$outboundSchema: z.ZodType<string, AspectRatio>;
+export declare const VideoGenerationRequestAspectRatio$outboundSchema: z.ZodType<string, VideoGenerationRequestAspectRatio>;
 /** @internal */
-export type Options$Outbound = {
+export type VideoGenerationRequestOptions$Outbound = {
     "01ai"?: {
         [k: string]: any | null;
     } | undefined;
@@ -523,6 +538,9 @@ export type Options$Outbound = {
     darkbloom?: {
         [k: string]: any | null;
     } | undefined;
+    decart?: {
+        [k: string]: any | null;
+    } | undefined;
     deepinfra?: {
         [k: string]: any | null;
     } | undefined;
@@ -580,6 +598,9 @@ export type Options$Outbound = {
     inceptron?: {
         [k: string]: any | null;
     } | undefined;
+    "inferact-vllm"?: {
+        [k: string]: any | null;
+    } | undefined;
     "inference-net"?: {
         [k: string]: any | null;
     } | undefined;
@@ -712,6 +733,9 @@ export type Options$Outbound = {
     replicate?: {
         [k: string]: any | null;
     } | undefined;
+    "sakana-ai"?: {
+        [k: string]: any | null;
+    } | undefined;
     sambanova?: {
         [k: string]: any | null;
     } | undefined;
@@ -745,6 +769,9 @@ export type Options$Outbound = {
     targon?: {
         [k: string]: any | null;
     } | undefined;
+    tenstorrent?: {
+        [k: string]: any | null;
+    } | undefined;
     together?: {
         [k: string]: any | null;
     } | undefined;
@@ -760,6 +787,9 @@ export type Options$Outbound = {
     venice?: {
         [k: string]: any | null;
     } | undefined;
+    wafer?: {
+        [k: string]: any | null;
+    } | undefined;
     wandb?: {
         [k: string]: any | null;
     } | undefined;
@@ -774,17 +804,17 @@ export type Options$Outbound = {
     } | undefined;
 };
 /** @internal */
-export declare const Options$outboundSchema: z.ZodType<Options$Outbound, Options>;
-export declare function optionsToJSON(options: Options): string;
+export declare const VideoGenerationRequestOptions$outboundSchema: z.ZodType<VideoGenerationRequestOptions$Outbound, VideoGenerationRequestOptions>;
+export declare function videoGenerationRequestOptionsToJSON(videoGenerationRequestOptions: VideoGenerationRequestOptions): string;
 /** @internal */
 export type VideoGenerationRequestProvider$Outbound = {
-    options?: Options$Outbound | undefined;
+    options?: VideoGenerationRequestOptions$Outbound | undefined;
 };
 /** @internal */
 export declare const VideoGenerationRequestProvider$outboundSchema: z.ZodType<VideoGenerationRequestProvider$Outbound, VideoGenerationRequestProvider>;
 export declare function videoGenerationRequestProviderToJSON(videoGenerationRequestProvider: VideoGenerationRequestProvider): string;
 /** @internal */
-export declare const Resolution$outboundSchema: z.ZodType<string, Resolution>;
+export declare const VideoGenerationRequestResolution$outboundSchema: z.ZodType<string, VideoGenerationRequestResolution>;
 /** @internal */
 export type VideoGenerationRequest$Outbound = {
     aspect_ratio?: string | undefined;
@@ -792,7 +822,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,12 +5,12 @@
 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
  */
-export const AspectRatio = {
+export const VideoGenerationRequestAspectRatio = {
     OneHundredAndSixtyNine: "16:9",
     NineHundredAndSixteen: "9:16",
     Eleven: "1:1",
@@ -24,7 +24,7 @@ export const AspectRatio = {
 /**
  * Resolution of the generated video
  */
-export const Resolution = {
+export const VideoGenerationRequestResolution = {
     FourHundredAndEightyp: "480p",
     SevenHundredAndTwentyp: "720p",
     OneThousandAndEightyp: "1080p",
@@ -33,10 +33,9 @@ export const Resolution = {
     FourK: "4K",
 };
 /** @internal */
-export const AspectRatio$outboundSchema = openEnums.outboundSchema(AspectRatio);
+export const VideoGenerationRequestAspectRatio$outboundSchema = openEnums.outboundSchema(VideoGenerationRequestAspectRatio);
 /** @internal */
-export const Options$outboundSchema = z
-    .object({
+export const VideoGenerationRequestOptions$outboundSchema = z.object({
     oneai: z.record(z.string(), z.nullable(z.any())).optional(),
     ai21: z.record(z.string(), z.nullable(z.any())).optional(),
     aionLabs: z.record(z.string(), z.nullable(z.any())).optional(),
@@ -67,6 +66,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(),
@@ -86,6 +86,7 @@ export const Options$outboundSchema = z
     hyperbolicQuantized: z.record(z.string(), z.nullable(z.any())).optional(),
     inception: z.record(z.string(), z.nullable(z.any())).optional(),
     inceptron: z.record(z.string(), z.nullable(z.any())).optional(),
+    inferactVllm: z.record(z.string(), z.nullable(z.any())).optional(),
     inferenceNet: z.record(z.string(), z.nullable(z.any())).optional(),
     infermatic: z.record(z.string(), z.nullable(z.any())).optional(),
     inflection: z.record(z.string(), z.nullable(z.any())).optional(),
@@ -130,6 +131,7 @@ export const Options$outboundSchema = z
     reka: z.record(z.string(), z.nullable(z.any())).optional(),
     relace: z.record(z.string(), z.nullable(z.any())).optional(),
     replicate: z.record(z.string(), z.nullable(z.any())).optional(),
+    sakanaAi: z.record(z.string(), z.nullable(z.any())).optional(),
     sambanova: z.record(z.string(), z.nullable(z.any())).optional(),
     sambanovaCloaked: z.record(z.string(), z.nullable(z.any())).optional(),
     seed: z.record(z.string(), z.nullable(z.any())).optional(),
@@ -141,11 +143,13 @@ export const Options$outboundSchema = z
     streamlake: z.record(z.string(), z.nullable(z.any())).optional(),
     switchpoint: z.record(z.string(), z.nullable(z.any())).optional(),
     targon: z.record(z.string(), z.nullable(z.any())).optional(),
+    tenstorrent: z.record(z.string(), z.nullable(z.any())).optional(),
     together: z.record(z.string(), z.nullable(z.any())).optional(),
     togetherLite: z.record(z.string(), z.nullable(z.any())).optional(),
     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(),
@@ -163,43 +167,46 @@ export const Options$outboundSchema = z
         googleAiStudio: "google-ai-studio",
         googleVertex: "google-vertex",
         hyperbolicQuantized: "hyperbolic-quantized",
+        inferactVllm: "inferact-vllm",
         inferenceNet: "inference-net",
         ioNet: "io-net",
         lynnPrivate: "lynn-private",
         mancerOld: "mancer-old",
         nexAgi: "nex-agi",
         openInference: "open-inference",
+        sakanaAi: "sakana-ai",
         sambanovaCloaked: "sambanova-cloaked",
         sfCompute: "sf-compute",
         togetherLite: "together-lite",
         zAi: "z-ai",
     });
 });
-export function optionsToJSON(options) {
-    return JSON.stringify(Options$outboundSchema.parse(options));
+export function videoGenerationRequestOptionsToJSON(videoGenerationRequestOptions) {
+    return JSON.stringify(VideoGenerationRequestOptions$outboundSchema.parse(videoGenerationRequestOptions));
 }
 /** @internal */
 export const VideoGenerationRequestProvider$outboundSchema = z.object({
-    options: z.lazy(() => Options$outboundSchema).optional(),
+    options: z.lazy(() => VideoGenerationRequestOptions$outboundSchema)
+        .optional(),
 });
 export function videoGenerationRequestProviderToJSON(videoGenerationRequestProvider) {
     return JSON.stringify(VideoGenerationRequestProvider$outboundSchema.parse(videoGenerationRequestProvider));
 }
 /** @internal */
-export const Resolution$outboundSchema = openEnums.outboundSchema(Resolution);
+export const VideoGenerationRequestResolution$outboundSchema = openEnums.outboundSchema(VideoGenerationRequestResolution);
 /** @internal */
 export const VideoGenerationRequest$outboundSchema = z.object({
-    aspectRatio: AspectRatio$outboundSchema.optional(),
+    aspectRatio: VideoGenerationRequestAspectRatio$outboundSchema.optional(),
     callbackUrl: z.string().optional(),
     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)
         .optional(),
-    resolution: Resolution$outboundSchema.optional(),
+    resolution: VideoGenerationRequestResolution$outboundSchema.optional(),
     seed: z.int().optional(),
     size: z.string().optional(),
 }).transform((v) => {

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. Perplexity supports a maximum of 20; values above 20 are clamped.
      */
     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. Perplexity supports a maximum of 20; values above 20 are clamped.
      */
     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. Perplexity supports a maximum of 20; values above 20 are clamped.
      */
     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/models/workspacebudget.d.ts

@@ -0,0 +1,48 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+/**
+ * Interval at which spend resets. Null means a lifetime (one-time) budget.
+ */
+export declare const ResetInterval: {
+    readonly Daily: "daily";
+    readonly Weekly: "weekly";
+    readonly Monthly: "monthly";
+};
+/**
+ * Interval at which spend resets. Null means a lifetime (one-time) budget.
+ */
+export type ResetInterval = OpenEnum<typeof ResetInterval>;
+export type WorkspaceBudget = {
+    /**
+     * ISO 8601 timestamp of when the budget was created
+     */
+    createdAt: string;
+    /**
+     * Unique identifier for the budget
+     */
+    id: string;
+    /**
+     * Spending limit in USD for this interval
+     */
+    limitUsd: number;
+    /**
+     * Interval at which spend resets. Null means a lifetime (one-time) budget.
+     */
+    resetInterval: ResetInterval | null;
+    /**
+     * ISO 8601 timestamp of when the budget was last updated
+     */
+    updatedAt: string;
+    /**
+     * ID of the workspace the budget belongs to
+     */
+    workspaceId: string;
+};
+/** @internal */
+export declare const ResetInterval$inboundSchema: z.ZodType<ResetInterval, unknown>;
+/** @internal */
+export declare const WorkspaceBudget$inboundSchema: z.ZodType<WorkspaceBudget, unknown>;
+export declare function workspaceBudgetFromJSON(jsonString: string): SafeParseResult<WorkspaceBudget, SDKValidationError>;
+//# sourceMappingURL=workspacebudget.d.ts.map

package/esm/models/workspacebudget.js

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ede50342c11d
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import * as openEnums from "../types/enums.js";
+/**
+ * Interval at which spend resets. Null means a lifetime (one-time) budget.
+ */
+export const ResetInterval = {
+    Daily: "daily",
+    Weekly: "weekly",
+    Monthly: "monthly",
+};
+/** @internal */
+export const ResetInterval$inboundSchema = openEnums.inboundSchema(ResetInterval);
+/** @internal */
+export const WorkspaceBudget$inboundSchema = z.object({
+    created_at: z.string(),
+    id: z.string(),
+    limit_usd: z.number(),
+    reset_interval: z.nullable(ResetInterval$inboundSchema),
+    updated_at: z.string(),
+    workspace_id: z.string(),
+}).transform((v) => {
+    return remap$(v, {
+        "created_at": "createdAt",
+        "limit_usd": "limitUsd",
+        "reset_interval": "resetInterval",
+        "updated_at": "updatedAt",
+        "workspace_id": "workspaceId",
+    });
+});
+export function workspaceBudgetFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => WorkspaceBudget$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'WorkspaceBudget' from JSON`);
+}
+//# sourceMappingURL=workspacebudget.js.map