@openrouter/sdk 1.4.25 → 1.5.0

package/esm/models/chatfunctiontool.js

@@ -22,10 +22,15 @@ export const ChatFunctionToolType = {
 };
 /** @internal */
 export const ChatFunctionToolFunctionFunction$outboundSchema = z.object({
+    deferLoading: z.boolean().optional(),
     description: z.string().optional(),
     name: z.string(),
     parameters: z.record(z.string(), z.any()).optional(),
     strict: z.nullable(z.boolean()).optional(),
+}).transform((v) => {
+    return remap$(v, {
+        deferLoading: "defer_loading",
+    });
 });
 export function chatFunctionToolFunctionFunctionToJSON(chatFunctionToolFunctionFunction) {
     return JSON.stringify(ChatFunctionToolFunctionFunction$outboundSchema.parse(chatFunctionToolFunctionFunction));
@@ -35,11 +40,13 @@ export const ChatFunctionToolType$outboundSchema = z.enum(ChatFunctionToolType);
 /** @internal */
 export const ChatFunctionToolFunction$outboundSchema = z.object({
     cacheControl: ChatContentCacheControl$outboundSchema.optional(),
+    deferLoading: z.boolean().optional(),
     function: z.lazy(() => ChatFunctionToolFunctionFunction$outboundSchema),
     type: ChatFunctionToolType$outboundSchema,
 }).transform((v) => {
     return remap$(v, {
         cacheControl: "cache_control",
+        deferLoading: "defer_loading",
     });
 });
 export function chatFunctionToolFunctionToJSON(chatFunctionToolFunction) {

package/esm/models/chatrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { AlignmentPlugin, AlignmentPlugin$Outbound } from "./alignmentplugin.js";
 import { AnthropicCacheControlDirective, AnthropicCacheControlDirective$Outbound } from "./anthropiccachecontroldirective.js";
+import { ArmorPlugin, ArmorPlugin$Outbound } from "./armorplugin.js";
 import { AutoBetaRouterPlugin, AutoBetaRouterPlugin$Outbound } from "./autobetarouterplugin.js";
 import { AutoRouterPlugin, AutoRouterPlugin$Outbound } from "./autorouterplugin.js";
 import { ChatDebugOptions, ChatDebugOptions$Outbound } from "./chatdebugoptions.js";
@@ -16,6 +17,7 @@ import { ChatReasoningSummaryVerbosityEnum } from "./chatreasoningsummaryverbosi
 import { ChatStreamOptions, ChatStreamOptions$Outbound } from "./chatstreamoptions.js";
 import { ChatToolChoice, ChatToolChoice$Outbound } from "./chattoolchoice.js";
 import { ContextCompressionPlugin, ContextCompressionPlugin$Outbound } from "./contextcompressionplugin.js";
+import { DeferredToolsControl, DeferredToolsControl$Outbound } from "./deferredtoolscontrol.js";
 import { FileParserPlugin, FileParserPlugin$Outbound } from "./fileparserplugin.js";
 import { FusionPlugin, FusionPlugin$Outbound } from "./fusionplugin.js";
 import { ImageConfig, ImageConfig$Outbound } from "./imageconfig.js";
@@ -37,7 +39,7 @@ export declare const Modality: {
     readonly Audio: "audio";
 };
 export type Modality = OpenEnum<typeof Modality>;
-export type ChatRequestPlugin = AlignmentPlugin | AutoBetaRouterPlugin | AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | FusionPlugin | JevRouterPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | SwitchyardRouterPlugin | WebSearchPlugin | WebFetchPlugin;
+export type ChatRequestPlugin = AlignmentPlugin | ArmorPlugin | AutoBetaRouterPlugin | AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | FusionPlugin | JevRouterPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | SwitchyardRouterPlugin | WebSearchPlugin | WebFetchPlugin;
 /**
  * Constrains effort on reasoning for reasoning models
  */
@@ -103,7 +105,7 @@ export type ChatRequestServiceTier = OpenEnum<typeof ChatRequestServiceTier>;
 /**
  * Stop sequences (up to 4)
  */
-export type Stop = string | Array<string>;
+export type ChatRequestStop = string | Array<string>;
 /**
  * Chat completion request parameters
  */
@@ -116,6 +118,10 @@ export type ChatRequest = {
      * Debug options for inspecting request transformations (streaming only)
      */
     debug?: ChatDebugOptions | undefined;
+    /**
+     * Opt-in versioned router-level deferred-tool protocol. Replay assistant reasoning unchanged on continuation; keep the catalog unchanged.
+     */
+    deferredTools?: DeferredToolsControl | undefined;
     /**
      * Frequency penalty (-2.0 to 2.0)
      */
@@ -177,7 +183,7 @@ export type ChatRequest = {
     /**
      * Plugins you want to enable for this request, including their settings.
      */
-    plugins?: Array<AlignmentPlugin | AutoBetaRouterPlugin | AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | FusionPlugin | JevRouterPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | SwitchyardRouterPlugin | WebSearchPlugin | WebFetchPlugin> | undefined;
+    plugins?: Array<AlignmentPlugin | ArmorPlugin | AutoBetaRouterPlugin | AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | FusionPlugin | JevRouterPlugin | ModerationPlugin | ParetoRouterPlugin | ResponseHealingPlugin | SwitchyardRouterPlugin | WebSearchPlugin | WebFetchPlugin> | undefined;
     /**
      * Static predicted output content. Supported models can use this to reduce latency when much of the response is known in advance.
      */
@@ -188,7 +194,7 @@ export type ChatRequest = {
     presencePenalty?: number | null | undefined;
     promptCacheKey?: string | null | undefined;
     /**
-     * Request-level prompt-cache controls. `mode: "explicit"` disables OpenAI-managed breakpoints so only blocks marked with `prompt_cache_breakpoint` are cached. Only supported by OpenAI GPT-5.6 and newer.
+     * Request-level prompt-cache controls. `mode: "explicit"` disables OpenAI-managed breakpoints so only blocks marked with `prompt_cache_breakpoint` are cached. `ttl` sets the minimum cache lifetime for every breakpoint the request writes: "30m" (default) or "12h" (billed at the higher 12h cache-write rate). Only supported by OpenAI GPT-5.6 and newer.
      */
     promptCacheOptions?: PromptCacheOptions | null | undefined;
     /**
@@ -279,7 +285,7 @@ export type ChatRequest = {
 /** @internal */
 export declare const Modality$outboundSchema: z.ZodType<string, Modality>;
 /** @internal */
-export type ChatRequestPlugin$Outbound = AlignmentPlugin$Outbound | AutoBetaRouterPlugin$Outbound | AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | FusionPlugin$Outbound | JevRouterPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | SwitchyardRouterPlugin$Outbound | WebSearchPlugin$Outbound | WebFetchPlugin$Outbound;
+export type ChatRequestPlugin$Outbound = AlignmentPlugin$Outbound | ArmorPlugin$Outbound | AutoBetaRouterPlugin$Outbound | AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | FusionPlugin$Outbound | JevRouterPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | SwitchyardRouterPlugin$Outbound | WebSearchPlugin$Outbound | WebFetchPlugin$Outbound;
 /** @internal */
 export declare const ChatRequestPlugin$outboundSchema: z.ZodType<ChatRequestPlugin$Outbound, ChatRequestPlugin>;
 export declare function chatRequestPluginToJSON(chatRequestPlugin: ChatRequestPlugin): string;
@@ -303,14 +309,15 @@ export declare function responseFormatToJSON(responseFormat: ResponseFormat): st
 /** @internal */
 export declare const ChatRequestServiceTier$outboundSchema: z.ZodType<string, ChatRequestServiceTier>;
 /** @internal */
-export type Stop$Outbound = string | Array<string>;
+export type ChatRequestStop$Outbound = string | Array<string>;
 /** @internal */
-export declare const Stop$outboundSchema: z.ZodType<Stop$Outbound, Stop>;
-export declare function stopToJSON(stop: Stop): string;
+export declare const ChatRequestStop$outboundSchema: z.ZodType<ChatRequestStop$Outbound, ChatRequestStop>;
+export declare function chatRequestStopToJSON(chatRequestStop: ChatRequestStop): string;
 /** @internal */
 export type ChatRequest$Outbound = {
     cache_control?: AnthropicCacheControlDirective$Outbound | undefined;
     debug?: ChatDebugOptions$Outbound | undefined;
+    deferred_tools?: DeferredToolsControl$Outbound | undefined;
     frequency_penalty?: number | null | undefined;
     image_config?: {
         [k: string]: ImageConfig$Outbound;
@@ -330,7 +337,7 @@ export type ChatRequest$Outbound = {
     model?: string | undefined;
     models?: Array<string> | undefined;
     parallel_tool_calls?: boolean | null | undefined;
-    plugins?: Array<AlignmentPlugin$Outbound | AutoBetaRouterPlugin$Outbound | AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | FusionPlugin$Outbound | JevRouterPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | SwitchyardRouterPlugin$Outbound | WebSearchPlugin$Outbound | WebFetchPlugin$Outbound> | undefined;
+    plugins?: Array<AlignmentPlugin$Outbound | ArmorPlugin$Outbound | AutoBetaRouterPlugin$Outbound | AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | FusionPlugin$Outbound | JevRouterPlugin$Outbound | ModerationPlugin$Outbound | ParetoRouterPlugin$Outbound | ResponseHealingPlugin$Outbound | SwitchyardRouterPlugin$Outbound | WebSearchPlugin$Outbound | WebFetchPlugin$Outbound> | undefined;
     prediction?: Prediction$Outbound | null | undefined;
     presence_penalty?: number | null | undefined;
     prompt_cache_key?: string | null | undefined;

package/esm/models/chatrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { AlignmentPlugin$outboundSchema, } from "./alignmentplugin.js";
 import { AnthropicCacheControlDirective$outboundSchema, } from "./anthropiccachecontroldirective.js";
+import { ArmorPlugin$outboundSchema, } from "./armorplugin.js";
 import { AutoBetaRouterPlugin$outboundSchema, } from "./autobetarouterplugin.js";
 import { AutoRouterPlugin$outboundSchema, } from "./autorouterplugin.js";
 import { ChatDebugOptions$outboundSchema, } from "./chatdebugoptions.js";
@@ -21,6 +22,7 @@ import { ChatReasoningSummaryVerbosityEnum$outboundSchema, } from "./chatreasoni
 import { ChatStreamOptions$outboundSchema, } from "./chatstreamoptions.js";
 import { ChatToolChoice$outboundSchema, } from "./chattoolchoice.js";
 import { ContextCompressionPlugin$outboundSchema, } from "./contextcompressionplugin.js";
+import { DeferredToolsControl$outboundSchema, } from "./deferredtoolscontrol.js";
 import { FileParserPlugin$outboundSchema, } from "./fileparserplugin.js";
 import { FusionPlugin$outboundSchema, } from "./fusionplugin.js";
 import { ImageConfig$outboundSchema, } from "./imageconfig.js";
@@ -83,6 +85,7 @@ export const Modality$outboundSchema = openEnums
 /** @internal */
 export const ChatRequestPlugin$outboundSchema = z.union([
     AlignmentPlugin$outboundSchema,
+    ArmorPlugin$outboundSchema,
     AutoBetaRouterPlugin$outboundSchema,
     AutoRouterPlugin$outboundSchema,
     ContextCompressionPlugin$outboundSchema,
@@ -126,17 +129,15 @@ export function responseFormatToJSON(responseFormat) {
 /** @internal */
 export const ChatRequestServiceTier$outboundSchema = openEnums.outboundSchema(ChatRequestServiceTier);
 /** @internal */
-export const Stop$outboundSchema = z.union([
-    z.string(),
-    z.array(z.string()),
-]);
-export function stopToJSON(stop) {
-    return JSON.stringify(Stop$outboundSchema.parse(stop));
+export const ChatRequestStop$outboundSchema = z.union([z.string(), z.array(z.string())]);
+export function chatRequestStopToJSON(chatRequestStop) {
+    return JSON.stringify(ChatRequestStop$outboundSchema.parse(chatRequestStop));
 }
 /** @internal */
 export const ChatRequest$outboundSchema = z.object({
     cacheControl: AnthropicCacheControlDirective$outboundSchema.optional(),
     debug: ChatDebugOptions$outboundSchema.optional(),
+    deferredTools: DeferredToolsControl$outboundSchema.optional(),
     frequencyPenalty: z.nullable(z.number()).optional(),
     imageConfig: z.record(z.string(), ImageConfig$outboundSchema).optional(),
     logitBias: z.nullable(z.record(z.string(), z.number())).optional(),
@@ -152,6 +153,7 @@ export const ChatRequest$outboundSchema = z.object({
     parallelToolCalls: z.nullable(z.boolean()).optional(),
     plugins: z.array(z.union([
         AlignmentPlugin$outboundSchema,
+        ArmorPlugin$outboundSchema,
         AutoBetaRouterPlugin$outboundSchema,
         AutoRouterPlugin$outboundSchema,
         ContextCompressionPlugin$outboundSchema,
@@ -201,6 +203,7 @@ export const ChatRequest$outboundSchema = z.object({
 }).transform((v) => {
     return remap$(v, {
         cacheControl: "cache_control",
+        deferredTools: "deferred_tools",
         frequencyPenalty: "frequency_penalty",
         imageConfig: "image_config",
         logitBias: "logit_bias",

package/esm/models/chatresult.d.ts

@@ -1,6 +1,8 @@
 import * as z from "zod/v4";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import { Alignment } from "./alignment.js";
+import { ArmorSafeguardResult } from "./armorsafeguardresult.js";
 import { ChatChoice } from "./chatchoice.js";
 import { ChatUsage } from "./chatusage.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
@@ -13,6 +15,10 @@ export type ChatResultObject = ClosedEnum<typeof ChatResultObject>;
  * Chat completion response
  */
 export type ChatResult = {
+    /**
+     * Beta. The result of the alignment plugin for this request; the shape may change.
+     */
+    alignment?: Alignment | undefined;
     /**
      * List of completion choices
      */
@@ -31,6 +37,10 @@ export type ChatResult = {
     model: string;
     object: ChatResultObject;
     openrouterMetadata?: OpenRouterMetadata | undefined;
+    /**
+     * OpenRouter Armor's verdict for each client tool call of this response, present whenever Armor evaluated the response (even when nothing was flagged). Independent of the `openrouter_metadata` opt-in.
+     */
+    safeguardResults?: Array<ArmorSafeguardResult> | undefined;
     /**
      * The service tier used by the upstream provider for this request
      */

package/esm/models/chatresult.js

@@ -5,6 +5,8 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
+import { Alignment$inboundSchema } from "./alignment.js";
+import { ArmorSafeguardResult$inboundSchema, } from "./armorsafeguardresult.js";
 import { ChatChoice$inboundSchema } from "./chatchoice.js";
 import { ChatUsage$inboundSchema } from "./chatusage.js";
 import { OpenRouterMetadata$inboundSchema, } from "./openroutermetadata.js";
@@ -16,18 +18,21 @@ export const ChatResultObject$inboundSchema = z.enum(ChatResultObject);
 /** @internal */
 export const ChatResult$inboundSchema = z
     .object({
+    alignment: Alignment$inboundSchema.optional(),
     choices: z.array(ChatChoice$inboundSchema),
     created: z.int(),
     id: z.string(),
     model: z.string(),
     object: ChatResultObject$inboundSchema,
     openrouter_metadata: OpenRouterMetadata$inboundSchema.optional(),
+    safeguard_results: z.array(ArmorSafeguardResult$inboundSchema).optional(),
     service_tier: z.nullable(z.string()).optional(),
     system_fingerprint: z.nullable(z.string()),
     usage: ChatUsage$inboundSchema.optional(),
 }).transform((v) => {
     return remap$(v, {
         "openrouter_metadata": "openrouterMetadata",
+        "safeguard_results": "safeguardResults",
         "service_tier": "serviceTier",
         "system_fingerprint": "systemFingerprint",
     });

package/esm/models/chatstreamchunk.d.ts

@@ -1,7 +1,9 @@
 import * as z from "zod/v4";
 import { ClosedEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
+import { Alignment } from "./alignment.js";
 import { ApiErrorType } from "./apierrortype.js";
+import { ArmorSafeguardResult } from "./armorsafeguardresult.js";
 import { ChatStreamChoice } from "./chatstreamchoice.js";
 import { ChatUsage } from "./chatusage.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
@@ -44,6 +46,7 @@ export type ChatStreamChunkObject = ClosedEnum<typeof ChatStreamChunkObject>;
  * Streaming chat completion chunk
  */
 export type ChatStreamChunk = {
+    alignment?: Alignment | undefined;
     /**
      * List of streaming chunk choices
      */
@@ -66,6 +69,10 @@ export type ChatStreamChunk = {
     model: string;
     object: ChatStreamChunkObject;
     openrouterMetadata?: OpenRouterMetadata | undefined;
+    /**
+     * OpenRouter Armor's verdict for each client tool call of this response, present whenever Armor evaluated the response (even when nothing was flagged). Independent of the `openrouter_metadata` opt-in.
+     */
+    safeguardResults?: Array<ArmorSafeguardResult> | undefined;
     /**
      * The service tier used by the upstream provider for this request
      */

package/esm/models/chatstreamchunk.js

@@ -5,7 +5,9 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
+import { Alignment$inboundSchema } from "./alignment.js";
 import { ApiErrorType$inboundSchema } from "./apierrortype.js";
+import { ArmorSafeguardResult$inboundSchema, } from "./armorsafeguardresult.js";
 import { ChatStreamChoice$inboundSchema, } from "./chatstreamchoice.js";
 import { ChatUsage$inboundSchema } from "./chatusage.js";
 import { OpenRouterMetadata$inboundSchema, } from "./openroutermetadata.js";
@@ -38,6 +40,7 @@ export function chatStreamChunkErrorFromJSON(jsonString) {
 export const ChatStreamChunkObject$inboundSchema = z.enum(ChatStreamChunkObject);
 /** @internal */
 export const ChatStreamChunk$inboundSchema = z.object({
+    alignment: Alignment$inboundSchema.optional(),
     choices: z.array(ChatStreamChoice$inboundSchema),
     created: z.int(),
     error: z.lazy(() => ChatStreamChunkError$inboundSchema).optional(),
@@ -45,12 +48,14 @@ export const ChatStreamChunk$inboundSchema = z.object({
     model: z.string(),
     object: ChatStreamChunkObject$inboundSchema,
     openrouter_metadata: OpenRouterMetadata$inboundSchema.optional(),
+    safeguard_results: z.array(ArmorSafeguardResult$inboundSchema).optional(),
     service_tier: z.nullable(z.string()).optional(),
     system_fingerprint: z.string().optional(),
     usage: ChatUsage$inboundSchema.optional(),
 }).transform((v) => {
     return remap$(v, {
         "openrouter_metadata": "openrouterMetadata",
+        "safeguard_results": "safeguardResults",
         "service_tier": "serviceTier",
         "system_fingerprint": "systemFingerprint",
     });

package/esm/models/chatwebsearchshorthand.d.ts

@@ -22,7 +22,7 @@ export type ChatWebSearchShorthand = {
      */
     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. "perplexity" uses the Perplexity Search API (raw ranked results).
+     * 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 the Firecrawl search API. "parallel" uses the Parallel search API. "perplexity" uses the Perplexity Search API (raw ranked results).
      */
     engine?: WebSearchEngineEnum | undefined;
     /**

package/esm/models/clientclosedrequestresponseerrordata.d.ts

@@ -0,0 +1,17 @@
+import * as z from "zod/v4";
+import { Result as SafeParseResult } from "../types/fp.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+/**
+ * Error data for ClientClosedRequestResponse
+ */
+export type ClientClosedRequestResponseErrorData = {
+    code: number;
+    message: string;
+    metadata?: {
+        [k: string]: any;
+    } | null | undefined;
+};
+/** @internal */
+export declare const ClientClosedRequestResponseErrorData$inboundSchema: z.ZodType<ClientClosedRequestResponseErrorData, unknown>;
+export declare function clientClosedRequestResponseErrorDataFromJSON(jsonString: string): SafeParseResult<ClientClosedRequestResponseErrorData, SDKValidationError>;
+//# sourceMappingURL=clientclosedrequestresponseerrordata.d.ts.map

package/esm/models/clientclosedrequestresponseerrordata.js

@@ -0,0 +1,16 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: ce503b476fc7
+ */
+import * as z from "zod/v4";
+import { safeParse } from "../lib/schemas.js";
+/** @internal */
+export const ClientClosedRequestResponseErrorData$inboundSchema = z.object({
+    code: z.int(),
+    message: z.string(),
+    metadata: z.nullable(z.record(z.string(), z.any())).optional(),
+});
+export function clientClosedRequestResponseErrorDataFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => ClientClosedRequestResponseErrorData$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'ClientClosedRequestResponseErrorData' from JSON`);
+}
+//# sourceMappingURL=clientclosedrequestresponseerrordata.js.map

package/esm/models/computeruseservertool.d.ts

@@ -2,14 +2,14 @@ import * as z from "zod/v4";
 import { ClosedEnum, OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
-export declare const Environment: {
+export declare const EnvironmentEnum: {
     readonly Windows: "windows";
     readonly Mac: "mac";
     readonly Linux: "linux";
     readonly Ubuntu: "ubuntu";
     readonly Browser: "browser";
 };
-export type Environment = OpenEnum<typeof Environment>;
+export type EnvironmentEnum = OpenEnum<typeof EnvironmentEnum>;
 export declare const ComputerUseServerToolType: {
     readonly ComputerUsePreview: "computer_use_preview";
 };
@@ -20,13 +20,13 @@ export type ComputerUseServerToolType = ClosedEnum<typeof ComputerUseServerToolT
 export type ComputerUseServerTool = {
     displayHeight: number;
     displayWidth: number;
-    environment: Environment;
+    environment: EnvironmentEnum;
     type: ComputerUseServerToolType;
 };
 /** @internal */
-export declare const Environment$inboundSchema: z.ZodType<Environment, unknown>;
+export declare const EnvironmentEnum$inboundSchema: z.ZodType<EnvironmentEnum, unknown>;
 /** @internal */
-export declare const Environment$outboundSchema: z.ZodType<string, Environment>;
+export declare const EnvironmentEnum$outboundSchema: z.ZodType<string, EnvironmentEnum>;
 /** @internal */
 export declare const ComputerUseServerToolType$inboundSchema: z.ZodEnum<typeof ComputerUseServerToolType>;
 /** @internal */

package/esm/models/computeruseservertool.js

@@ -6,7 +6,7 @@ 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";
-export const Environment = {
+export const EnvironmentEnum = {
     Windows: "windows",
     Mac: "mac",
     Linux: "linux",
@@ -17,9 +17,9 @@ export const ComputerUseServerToolType = {
     ComputerUsePreview: "computer_use_preview",
 };
 /** @internal */
-export const Environment$inboundSchema = openEnums.inboundSchema(Environment);
+export const EnvironmentEnum$inboundSchema = openEnums.inboundSchema(EnvironmentEnum);
 /** @internal */
-export const Environment$outboundSchema = openEnums.outboundSchema(Environment);
+export const EnvironmentEnum$outboundSchema = openEnums.outboundSchema(EnvironmentEnum);
 /** @internal */
 export const ComputerUseServerToolType$inboundSchema = z.enum(ComputerUseServerToolType);
 /** @internal */
@@ -28,7 +28,7 @@ export const ComputerUseServerToolType$outboundSchema = ComputerUseServerToolTyp
 export const ComputerUseServerTool$inboundSchema = z.object({
     display_height: z.int(),
     display_width: z.int(),
-    environment: Environment$inboundSchema,
+    environment: EnvironmentEnum$inboundSchema,
     type: ComputerUseServerToolType$inboundSchema,
 }).transform((v) => {
     return remap$(v, {
@@ -40,7 +40,7 @@ export const ComputerUseServerTool$inboundSchema = z.object({
 export const ComputerUseServerTool$outboundSchema = z.object({
     displayHeight: z.int(),
     displayWidth: z.int(),
-    environment: Environment$outboundSchema,
+    environment: EnvironmentEnum$outboundSchema,
     type: ComputerUseServerToolType$outboundSchema,
 }).transform((v) => {
     return remap$(v, {

package/esm/models/createbyokkeyrequest.d.ts

@@ -2,7 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { BYOKProviderSlug } from "./byokproviderslug.js";
 /**
- * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, Azure accepts `europe` or `us` and Anthropic accepts `us` only. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
  */
 export declare const CreateBYOKKeyRequestDeclaredRegion: {
     readonly Global: "global";
@@ -10,7 +10,7 @@ export declare const CreateBYOKKeyRequestDeclaredRegion: {
     readonly Us: "us";
 };
 /**
- * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, Azure accepts `europe` or `us` and Anthropic accepts `us` only. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
  */
 export type CreateBYOKKeyRequestDeclaredRegion = OpenEnum<typeof CreateBYOKKeyRequestDeclaredRegion>;
 export type CreateBYOKKeyRequest = {
@@ -27,7 +27,7 @@ export type CreateBYOKKeyRequest = {
      */
     allowedUserIds?: Array<string> | null | undefined;
     /**
-     * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+     * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, Azure accepts `europe` or `us` and Anthropic accepts `us` only. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
      */
     declaredRegion?: CreateBYOKKeyRequestDeclaredRegion | null | undefined;
     /**

package/esm/models/createbyokkeyrequest.js

@@ -7,7 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { BYOKProviderSlug$outboundSchema, } from "./byokproviderslug.js";
 /**
- * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, only Azure accepts `europe` or `us`. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
+ * Your declaration of the data region in which the upstream provider account behind this credential processes requests, used for routing eligibility on OpenRouter's regional hosts. `null` means undeclared and `global` is behaviorally identical: the credential follows the region OpenRouter records for the endpoint. `europe` or `us` lets requests to `eu.openrouter.ai` or `us.openrouter.ai` use this credential for that provider (private endpoints, endpoints pinned to another cloud region, cross-region inference profiles and video models are excluded). Self-declared and not verified by OpenRouter. For OpenAI and Fireworks the region comes from the key material (a `{"api_key": ..., "region": ...}` key), so the value must match the key's region. Among other providers, Azure accepts `europe` or `us` and Anthropic accepts `us` only. Defaults to the key's region for OpenAI and Fireworks, otherwise `null`.
  */
 export const CreateBYOKKeyRequestDeclaredRegion = {
     Global: "global",

package/esm/models/createexternaluserrequest.d.ts

@@ -0,0 +1,15 @@
+import * as z from "zod/v4";
+export type CreateExternalUserRequest = {
+    /**
+     * Immutable case-sensitive tracking string supplied as user on inference requests or as external.user on API keys: 1 to 512 characters, well-formed Unicode, no NUL, no surrounding whitespace. URL-encode it in resource paths; an ID of `.` or `..` cannot be addressed by path, so look it up with the list filter.
+     */
+    user: string;
+};
+/** @internal */
+export type CreateExternalUserRequest$Outbound = {
+    user: string;
+};
+/** @internal */
+export declare const CreateExternalUserRequest$outboundSchema: z.ZodType<CreateExternalUserRequest$Outbound, CreateExternalUserRequest>;
+export declare function createExternalUserRequestToJSON(createExternalUserRequest: CreateExternalUserRequest): string;
+//# sourceMappingURL=createexternaluserrequest.d.ts.map

package/esm/models/createexternaluserrequest.js

@@ -0,0 +1,13 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dabbf073ef0b
+ */
+import * as z from "zod/v4";
+/** @internal */
+export const CreateExternalUserRequest$outboundSchema = z.object({
+    user: z.string(),
+});
+export function createExternalUserRequestToJSON(createExternalUserRequest) {
+    return JSON.stringify(CreateExternalUserRequest$outboundSchema.parse(createExternalUserRequest));
+}
+//# sourceMappingURL=createexternaluserrequest.js.map

package/esm/models/createguardrailrequest.d.ts

@@ -4,6 +4,14 @@ import { ContentFilterEntry, ContentFilterEntry$Outbound } from "./contentfilter
 import { GuardrailDataRegion } from "./guardraildataregion.js";
 import { GuardrailInterval } from "./guardrailinterval.js";
 export type CreateGuardrailRequest = {
+    /**
+     * Whether ZDR-only requests to google/* models may use endpoints that may retain prompts for safety monitoring. false allows only zero-retention endpoints. A guardrail can only be more restrictive than the account setting. Inherits the account setting when not provided.
+     */
+    allowSafetyRetentionGoogle?: boolean | null | undefined;
+    /**
+     * Whether ZDR-only requests to models outside the named providers (for example open-weight models on Vertex) may use endpoints that may retain prompts for safety monitoring. false allows only zero-retention endpoints. A guardrail can only be more restrictive than the account setting. Inherits the account setting when not provided.
+     */
+    allowSafetyRetentionOther?: boolean | null | undefined;
     /**
      * Data regions through which requests governed by this guardrail must arrive. `global` is https://openrouter.ai, `europe` is https://eu.openrouter.ai, and `us` is https://us.openrouter.ai. Requests arriving through any other region are rejected. `null` leaves the ingress region unrestricted. When several guardrails apply (workspace default, member, API key), the effective regions are the intersection of every non-null value. An empty array is rejected.
      */
@@ -97,6 +105,8 @@ export type CreateGuardrailRequest = {
 };
 /** @internal */
 export type CreateGuardrailRequest$Outbound = {
+    allow_safety_retention_google?: boolean | null | undefined;
+    allow_safety_retention_other?: boolean | null | undefined;
     allowed_data_regions?: Array<string> | null | undefined;
     allowed_models?: Array<string> | null | undefined;
     allowed_providers?: Array<string> | null | undefined;

package/esm/models/createguardrailrequest.js

@@ -10,6 +10,8 @@ import { GuardrailDataRegion$outboundSchema, } from "./guardraildataregion.js";
 import { GuardrailInterval$outboundSchema, } from "./guardrailinterval.js";
 /** @internal */
 export const CreateGuardrailRequest$outboundSchema = z.object({
+    allowSafetyRetentionGoogle: z.nullable(z.boolean()).optional(),
+    allowSafetyRetentionOther: z.nullable(z.boolean()).optional(),
     allowedDataRegions: z.nullable(z.array(GuardrailDataRegion$outboundSchema))
         .optional(),
     allowedModels: z.nullable(z.array(z.string())).optional(),
@@ -36,6 +38,8 @@ export const CreateGuardrailRequest$outboundSchema = z.object({
     workspaceId: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {
+        allowSafetyRetentionGoogle: "allow_safety_retention_google",
+        allowSafetyRetentionOther: "allow_safety_retention_other",
         allowedDataRegions: "allowed_data_regions",
         allowedModels: "allowed_models",
         allowedProviders: "allowed_providers",

package/esm/models/createobservabilitydestinationrequest.d.ts

@@ -37,6 +37,10 @@ export type CreateObservabilityDestinationRequest = {
      * When true, include cost and billing generation metadata.
      */
     broadcastGenerationCost?: boolean | undefined;
+    /**
+     * Beta. When true, include openrouter_cost_allocation: per-token-kind usage and cost, sent only when they reconcile with the billed cost.
+     */
+    broadcastGenerationCostAllocation?: boolean | undefined;
     /**
      * When true, include identity generation metadata.
      */
@@ -90,6 +94,7 @@ export declare const CreateObservabilityDestinationRequestType$outboundSchema: z
 export type CreateObservabilityDestinationRequest$Outbound = {
     api_key_hashes?: Array<string> | null | undefined;
     broadcast_generation_cost: boolean;
+    broadcast_generation_cost_allocation: boolean;
     broadcast_generation_identity: boolean;
     broadcast_generation_request_context: boolean;
     config: {

package/esm/models/createobservabilitydestinationrequest.js

@@ -36,6 +36,7 @@ export const CreateObservabilityDestinationRequestType$outboundSchema = openEnum
 export const CreateObservabilityDestinationRequest$outboundSchema = z.object({
     apiKeyHashes: z.nullable(z.array(z.string())).optional(),
     broadcastGenerationCost: z.boolean().default(false),
+    broadcastGenerationCostAllocation: z.boolean().default(false),
     broadcastGenerationIdentity: z.boolean().default(false),
     broadcastGenerationRequestContext: z.boolean().default(false),
     config: z.record(z.string(), z.any()),
@@ -52,6 +53,7 @@ export const CreateObservabilityDestinationRequest$outboundSchema = z.object({
     return remap$(v, {
         apiKeyHashes: "api_key_hashes",
         broadcastGenerationCost: "broadcast_generation_cost",
+        broadcastGenerationCostAllocation: "broadcast_generation_cost_allocation",
         broadcastGenerationIdentity: "broadcast_generation_identity",
         broadcastGenerationRequestContext: "broadcast_generation_request_context",
         filterRules: "filter_rules",

package/esm/models/customtool.d.ts

@@ -29,6 +29,7 @@ export type CustomTool = {
      * Lets the model keep working after calling this tool instead of waiting for its output. The tool is still executed by the client; return the result in a later request as a `function_call_output` with the original `call_id`. Only honored by providers whose Responses API supports async tools; ignored elsewhere.
      */
     async?: boolean | undefined;
+    deferLoading?: boolean | undefined;
     description?: string | undefined;
     format?: FormatText | FormatGrammar | discriminatedUnionTypes.Unknown<"type"> | undefined;
     name: string;
@@ -77,6 +78,7 @@ export declare const CustomTool$inboundSchema: z.ZodType<CustomTool, unknown>;
 /** @internal */
 export type CustomTool$Outbound = {
     async?: boolean | undefined;
+    defer_loading?: boolean | undefined;
     description?: string | undefined;
     format?: FormatText$Outbound | FormatGrammar$Outbound | undefined;
     name: string;