@openrouter/sdk 0.12.2 → 0.12.4

package/esm/models/responsesrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { ApplyPatchServerTool, ApplyPatchServerTool$Outbound } from "./applypatchservertool.js";
 import { AutoRouterPlugin, AutoRouterPlugin$Outbound } from "./autorouterplugin.js";
+import { ChatSearchModelsServerTool, ChatSearchModelsServerTool$Outbound } from "./chatsearchmodelsservertool.js";
 import { CodeInterpreterServerTool, CodeInterpreterServerTool$Outbound } from "./codeinterpreterservertool.js";
 import { CodexLocalShellTool, CodexLocalShellTool$Outbound } from "./codexlocalshelltool.js";
 import { ComputerUseServerTool, ComputerUseServerTool$Outbound } from "./computeruseservertool.js";
@@ -55,13 +56,15 @@ export type ResponsesRequestToolFunction = {
 };
 export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | FileSearchServerTool | ComputerUseServerTool | CodeInterpreterServerTool | McpServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | CustomTool | (DatetimeServerTool & {
     type: "openrouter:datetime";
+}) | (ChatSearchModelsServerTool & {
+    type: "openrouter:experimental__search_models";
 }) | WebSearchServerToolOpenRouter;
 /**
  * Request schema for Responses endpoint
  */
 export type ResponsesRequest = {
     background?: boolean | null | undefined;
-    frequencyPenalty?: number | undefined;
+    frequencyPenalty?: number | null | undefined;
     /**
      * Provider-specific image configuration options. Keys and values vary by model/provider. See https://openrouter.ai/docs/features/multimodal/image-generation for more details.
      */
@@ -74,8 +77,8 @@ export type ResponsesRequest = {
      */
     input?: InputsUnion | undefined;
     instructions?: string | null | undefined;
-    maxOutputTokens?: number | undefined;
-    maxToolCalls?: number | undefined;
+    maxOutputTokens?: number | null | undefined;
+    maxToolCalls?: number | null | undefined;
     /**
      * Metadata key-value pairs for the request. Keys must be ≤64 characters and cannot contain brackets. Values must be ≤512 characters. Maximum 16 pairs allowed.
      */
@@ -93,7 +96,7 @@ export type ResponsesRequest = {
      * Plugins you want to enable for this request, including their settings.
      */
     plugins?: Array<AutoRouterPlugin | ContextCompressionPlugin | FileParserPlugin | ModerationPlugin | ResponseHealingPlugin | WebSearchPlugin> | undefined;
-    presencePenalty?: number | undefined;
+    presencePenalty?: number | null | undefined;
     previousResponseId?: string | null | undefined;
     prompt?: StoredPromptTemplate | null | undefined;
     promptCacheKey?: string | null | undefined;
@@ -113,7 +116,7 @@ export type ResponsesRequest = {
     sessionId?: string | undefined;
     store?: false | undefined;
     stream?: boolean | undefined;
-    temperature?: number | undefined;
+    temperature?: number | null | undefined;
     /**
      * Text output configuration including format and verbosity
      */
@@ -121,10 +124,12 @@ export type ResponsesRequest = {
     toolChoice?: OpenAIResponsesToolChoiceUnion | undefined;
     tools?: Array<ResponsesRequestToolFunction | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | FileSearchServerTool | ComputerUseServerTool | CodeInterpreterServerTool | McpServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | CustomTool | (DatetimeServerTool & {
         type: "openrouter:datetime";
+    }) | (ChatSearchModelsServerTool & {
+        type: "openrouter:experimental__search_models";
     }) | WebSearchServerToolOpenRouter> | undefined;
     topK?: number | undefined;
-    topLogprobs?: number | undefined;
-    topP?: number | undefined;
+    topLogprobs?: number | null | undefined;
+    topP?: number | null | undefined;
     /**
      * Metadata for observability and tracing. Known keys (trace_id, trace_name, span_name, generation_name, parent_span_id) have special handling. Additional keys are passed through as custom metadata to configured broadcast destinations.
      */
@@ -163,6 +168,8 @@ export declare function responsesRequestToolFunctionToJSON(responsesRequestToolF
 /** @internal */
 export type ResponsesRequestToolUnion$Outbound = ResponsesRequestToolFunction$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | FileSearchServerTool$Outbound | ComputerUseServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | CustomTool$Outbound | (DatetimeServerTool$Outbound & {
     type: "openrouter:datetime";
+}) | (ChatSearchModelsServerTool$Outbound & {
+    type: "openrouter:experimental__search_models";
 }) | WebSearchServerToolOpenRouter$Outbound;
 /** @internal */
 export declare const ResponsesRequestToolUnion$outboundSchema: z.ZodType<ResponsesRequestToolUnion$Outbound, ResponsesRequestToolUnion>;
@@ -170,15 +177,15 @@ export declare function responsesRequestToolUnionToJSON(responsesRequestToolUnio
 /** @internal */
 export type ResponsesRequest$Outbound = {
     background?: boolean | null | undefined;
-    frequency_penalty?: number | undefined;
+    frequency_penalty?: number | null | undefined;
     image_config?: {
         [k: string]: string | number;
     } | undefined;
     include?: Array<string> | null | undefined;
     input?: InputsUnion$Outbound | undefined;
     instructions?: string | null | undefined;
-    max_output_tokens?: number | undefined;
-    max_tool_calls?: number | undefined;
+    max_output_tokens?: number | null | undefined;
+    max_tool_calls?: number | null | undefined;
     metadata?: {
         [k: string]: string;
     } | null | undefined;
@@ -187,7 +194,7 @@ export type ResponsesRequest$Outbound = {
     models?: Array<string> | undefined;
     parallel_tool_calls?: boolean | null | undefined;
     plugins?: Array<AutoRouterPlugin$Outbound | ContextCompressionPlugin$Outbound | FileParserPlugin$Outbound | ModerationPlugin$Outbound | ResponseHealingPlugin$Outbound | WebSearchPlugin$Outbound> | undefined;
-    presence_penalty?: number | undefined;
+    presence_penalty?: number | null | undefined;
     previous_response_id?: string | null | undefined;
     prompt?: StoredPromptTemplate$Outbound | null | undefined;
     prompt_cache_key?: string | null | undefined;
@@ -198,15 +205,17 @@ export type ResponsesRequest$Outbound = {
     session_id?: string | undefined;
     store: false;
     stream: boolean;
-    temperature?: number | undefined;
+    temperature?: number | null | undefined;
     text?: TextExtendedConfig$Outbound | undefined;
     tool_choice?: OpenAIResponsesToolChoiceUnion$Outbound | undefined;
     tools?: Array<ResponsesRequestToolFunction$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | FileSearchServerTool$Outbound | ComputerUseServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | CustomTool$Outbound | (DatetimeServerTool$Outbound & {
         type: "openrouter:datetime";
+    }) | (ChatSearchModelsServerTool$Outbound & {
+        type: "openrouter:experimental__search_models";
     }) | WebSearchServerToolOpenRouter$Outbound> | undefined;
     top_k?: number | undefined;
-    top_logprobs?: number | undefined;
-    top_p?: number | undefined;
+    top_logprobs?: number | null | undefined;
+    top_p?: number | null | undefined;
     trace?: TraceConfig$Outbound | undefined;
     truncation?: string | null | undefined;
     user?: string | undefined;

package/esm/models/responsesrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { ApplyPatchServerTool$outboundSchema, } from "./applypatchservertool.js";
 import { AutoRouterPlugin$outboundSchema, } from "./autorouterplugin.js";
+import { ChatSearchModelsServerTool$outboundSchema, } from "./chatsearchmodelsservertool.js";
 import { CodeInterpreterServerTool$outboundSchema, } from "./codeinterpreterservertool.js";
 import { CodexLocalShellTool$outboundSchema, } from "./codexlocalshelltool.js";
 import { ComputerUseServerTool$outboundSchema, } from "./computeruseservertool.js";
@@ -90,6 +91,7 @@ export const ResponsesRequestToolUnion$outboundSchema = z.union([
     ApplyPatchServerTool$outboundSchema,
     CustomTool$outboundSchema,
     DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
+    ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
     WebSearchServerToolOpenRouter$outboundSchema,
 ]);
 export function responsesRequestToolUnionToJSON(responsesRequestToolUnion) {
@@ -98,14 +100,14 @@ export function responsesRequestToolUnionToJSON(responsesRequestToolUnion) {
 /** @internal */
 export const ResponsesRequest$outboundSchema = z.object({
     background: z.nullable(z.boolean()).optional(),
-    frequencyPenalty: z.number().optional(),
+    frequencyPenalty: z.nullable(z.number()).optional(),
     imageConfig: z.record(z.string(), z.union([z.string(), z.number()]))
         .optional(),
     include: z.nullable(z.array(ResponseIncludesEnum$outboundSchema)).optional(),
     input: InputsUnion$outboundSchema.optional(),
     instructions: z.nullable(z.string()).optional(),
-    maxOutputTokens: z.int().optional(),
-    maxToolCalls: z.int().optional(),
+    maxOutputTokens: z.nullable(z.int()).optional(),
+    maxToolCalls: z.nullable(z.int()).optional(),
     metadata: z.nullable(z.record(z.string(), z.string())).optional(),
     modalities: z.array(OutputModalityEnum$outboundSchema).optional(),
     model: z.string().optional(),
@@ -119,7 +121,7 @@ export const ResponsesRequest$outboundSchema = z.object({
         ResponseHealingPlugin$outboundSchema,
         WebSearchPlugin$outboundSchema,
     ])).optional(),
-    presencePenalty: z.number().optional(),
+    presencePenalty: z.nullable(z.number()).optional(),
     previousResponseId: z.nullable(z.string()).optional(),
     prompt: z.nullable(StoredPromptTemplate$outboundSchema).optional(),
     promptCacheKey: z.nullable(z.string()).optional(),
@@ -130,7 +132,7 @@ export const ResponsesRequest$outboundSchema = z.object({
     sessionId: z.string().optional(),
     store: z.literal(false).default(false),
     stream: z.boolean().default(false),
-    temperature: z.number().optional(),
+    temperature: z.nullable(z.number()).optional(),
     text: TextExtendedConfig$outboundSchema.optional(),
     toolChoice: OpenAIResponsesToolChoiceUnion$outboundSchema.optional(),
     tools: z.array(z.union([
@@ -149,11 +151,12 @@ export const ResponsesRequest$outboundSchema = z.object({
         ApplyPatchServerTool$outboundSchema,
         CustomTool$outboundSchema,
         DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
+        ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
         WebSearchServerToolOpenRouter$outboundSchema,
     ])).optional(),
     topK: z.int().optional(),
-    topLogprobs: z.int().optional(),
-    topP: z.number().optional(),
+    topLogprobs: z.nullable(z.int()).optional(),
+    topP: z.nullable(z.number()).optional(),
     trace: TraceConfig$outboundSchema.optional(),
     truncation: z.nullable(OpenAIResponsesTruncation$outboundSchema).optional(),
     user: z.string().optional(),

package/esm/models/searchmodelsservertoolconfig.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod/v4";
+/**
+ * Configuration for the openrouter:experimental__search_models server tool
+ */
+export type SearchModelsServerToolConfig = {
+    /**
+     * Maximum number of models to return. Defaults to 5, max 20.
+     */
+    maxResults?: number | undefined;
+};
+/** @internal */
+export type SearchModelsServerToolConfig$Outbound = {
+    max_results?: number | undefined;
+};
+/** @internal */
+export declare const SearchModelsServerToolConfig$outboundSchema: z.ZodType<SearchModelsServerToolConfig$Outbound, SearchModelsServerToolConfig>;
+export declare function searchModelsServerToolConfigToJSON(searchModelsServerToolConfig: SearchModelsServerToolConfig): string;
+//# sourceMappingURL=searchmodelsservertoolconfig.d.ts.map

package/esm/models/searchmodelsservertoolconfig.js

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: f15358a543a6
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+/** @internal */
+export const SearchModelsServerToolConfig$outboundSchema = z.object({
+    maxResults: z.int().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        maxResults: "max_results",
+    });
+});
+export function searchModelsServerToolConfigToJSON(searchModelsServerToolConfig) {
+    return JSON.stringify(SearchModelsServerToolConfig$outboundSchema.parse(searchModelsServerToolConfig));
+}
+//# sourceMappingURL=searchmodelsservertoolconfig.js.map

package/esm/models/updateguardrailrequest.d.ts

@@ -28,7 +28,7 @@ export type UpdateGuardrailRequest = {
     /**
      * New spending limit in USD
      */
-    limitUsd?: number | undefined;
+    limitUsd?: number | null | undefined;
     /**
      * New name for the guardrail
      */
@@ -46,7 +46,7 @@ export type UpdateGuardrailRequest$Outbound = {
     enforce_zdr?: boolean | null | undefined;
     ignored_models?: Array<string> | null | undefined;
     ignored_providers?: Array<string> | null | undefined;
-    limit_usd?: number | undefined;
+    limit_usd?: number | null | undefined;
     name?: string | undefined;
     reset_interval?: string | null | undefined;
 };

package/esm/models/updateguardrailrequest.js

@@ -13,7 +13,7 @@ export const UpdateGuardrailRequest$outboundSchema = z.object({
     enforceZdr: z.nullable(z.boolean()).optional(),
     ignoredModels: z.nullable(z.array(z.string())).optional(),
     ignoredProviders: z.nullable(z.array(z.string())).optional(),
-    limitUsd: z.number().optional(),
+    limitUsd: z.nullable(z.number()).optional(),
     name: z.string().optional(),
     resetInterval: z.nullable(GuardrailInterval$outboundSchema).optional(),
 }).transform((v) => {

package/esm/models/usage.d.ts

@@ -8,7 +8,7 @@ export type OutputTokensDetails = {
     reasoningTokens: number;
 };
 export type CostDetails = {
-    upstreamInferenceCost?: number | undefined;
+    upstreamInferenceCost?: number | null | undefined;
     upstreamInferenceInputCost: number;
     upstreamInferenceOutputCost: number;
 };
@@ -24,7 +24,7 @@ export type Usage = {
     /**
      * Cost of the completion
      */
-    cost?: number | undefined;
+    cost?: number | null | undefined;
     costDetails?: CostDetails | undefined;
     /**
      * Whether a request was made using a Bring Your Own Key configuration

package/esm/models/usage.js

@@ -30,7 +30,7 @@ export function outputTokensDetailsFromJSON(jsonString) {
 /** @internal */
 export const CostDetails$inboundSchema = z
     .object({
-    upstream_inference_cost: z.number().optional(),
+    upstream_inference_cost: z.nullable(z.number()).optional(),
     upstream_inference_input_cost: z.number(),
     upstream_inference_output_cost: z.number(),
 }).transform((v) => {
@@ -50,7 +50,7 @@ export const Usage$inboundSchema = z.object({
     output_tokens: z.int(),
     output_tokens_details: z.lazy(() => OutputTokensDetails$inboundSchema),
     total_tokens: z.int(),
-    cost: z.number().optional(),
+    cost: z.nullable(z.number()).optional(),
     cost_details: z.lazy(() => CostDetails$inboundSchema).optional(),
     is_byok: z.boolean().optional(),
 }).transform((v) => {

package/esm/models/videogenerationusage.d.ts

@@ -8,7 +8,7 @@ export type VideoGenerationUsage = {
     /**
      * The cost of the video generation in USD.
      */
-    cost?: number | undefined;
+    cost?: number | null | undefined;
     /**
      * Whether the request was made using a Bring Your Own Key configuration.
      */

package/esm/models/videogenerationusage.js

@@ -7,7 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 /** @internal */
 export const VideoGenerationUsage$inboundSchema = z.object({
-    cost: z.number().optional(),
+    cost: z.nullable(z.number()).optional(),
     is_byok: z.boolean().optional(),
 }).transform((v) => {
     return remap$(v, {

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 300+ language models through a unified API.",
   "keywords": [
@@ -69,15 +69,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit",
     "compile": "tsc",
+    "postinstall": "node scripts/check-types.js || true",
     "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
-    "typecheck": "tsc --noEmit",
-    "typecheck:transit": "exit 0",
-    "postinstall": "node scripts/check-types.js || true",
-    "prepare": "npm run build",
-    "test:watch": "vitest --watch --project unit"
+    "test:watch": "vitest --watch --project unit",
+    "typecheck:transit": "exit 0"
   },
   "peerDependencies": {},
   "devDependencies": {