@openrouter/sdk 1.2.52 → 1.2.54

package/esm/funcs/embeddingsGenerate.d.ts

@@ -14,5 +14,5 @@ import { Result } from "../types/fp.js";
  * @remarks
  * Submits an embedding request to the embeddings router
  */
-export declare function embeddingsGenerate(client: OpenRouterCore, request: operations.CreateEmbeddingsRequest, options?: RequestOptions): APIPromise<Result<operations.CreateEmbeddingsResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
+export declare function embeddingsGenerate(client: OpenRouterCore, request: operations.CreateEmbeddingsRequest, options?: RequestOptions): APIPromise<Result<operations.CreateEmbeddingsResponse, errors.BadRequestResponseError | errors.UnauthorizedResponseError | errors.PaymentRequiredResponseError | errors.NotFoundResponseError | errors.RequestTimeoutResponseError | errors.PayloadTooLargeResponseError | errors.TooManyRequestsResponseError | errors.InternalServerResponseError | errors.BadGatewayResponseError | errors.ServiceUnavailableResponseError | errors.EdgeNetworkTimeoutResponseError | errors.ProviderOverloadedResponseError | OpenRouterError | ResponseValidationError | ConnectionError | RequestAbortedError | RequestTimeoutError | InvalidRequestError | UnexpectedClientError | SDKValidationError>>;
 //# sourceMappingURL=embeddingsGenerate.d.ts.map

package/esm/funcs/embeddingsGenerate.js

@@ -90,7 +90,7 @@ async function $do(client, request, options) {
     };
     const [result] = await M.match(M.json(200, operations.CreateEmbeddingsResponse$inboundSchema), M.text(200, operations.CreateEmbeddingsResponse$inboundSchema, {
         ctype: "text/event-stream",
-    }), M.jsonErr(400, errors.BadRequestResponseError$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(402, errors.PaymentRequiredResponseError$inboundSchema), M.jsonErr(404, errors.NotFoundResponseError$inboundSchema), M.jsonErr(429, errors.TooManyRequestsResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.jsonErr(502, errors.BadGatewayResponseError$inboundSchema), M.jsonErr(503, errors.ServiceUnavailableResponseError$inboundSchema), M.jsonErr(524, errors.EdgeNetworkTimeoutResponseError$inboundSchema), M.jsonErr(529, errors.ProviderOverloadedResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
+    }), M.jsonErr(400, errors.BadRequestResponseError$inboundSchema), M.jsonErr(401, errors.UnauthorizedResponseError$inboundSchema), M.jsonErr(402, errors.PaymentRequiredResponseError$inboundSchema), M.jsonErr(404, errors.NotFoundResponseError$inboundSchema), M.jsonErr(408, errors.RequestTimeoutResponseError$inboundSchema), M.jsonErr(413, errors.PayloadTooLargeResponseError$inboundSchema), M.jsonErr(429, errors.TooManyRequestsResponseError$inboundSchema), M.jsonErr(500, errors.InternalServerResponseError$inboundSchema), M.jsonErr(502, errors.BadGatewayResponseError$inboundSchema), M.jsonErr(503, errors.ServiceUnavailableResponseError$inboundSchema), M.jsonErr(524, errors.EdgeNetworkTimeoutResponseError$inboundSchema), M.jsonErr(529, errors.ProviderOverloadedResponseError$inboundSchema), M.fail("4XX"), M.fail("5XX"))(response, req, { extraFields: responseFields });
     if (!result.ok) {
         return [result, { status: "complete", request: req, response }];
     }

package/esm/lib/config.d.ts

@@ -50,8 +50,8 @@ export declare function serverURLFromOptions(options: SDKOptions): URL | null;
 export declare const SDK_METADATA: {
     readonly language: "typescript";
     readonly openapiDocVersion: "1.0.0";
-    readonly sdkVersion: "1.2.52";
+    readonly sdkVersion: "1.2.54";
     readonly genVersion: "2.914.0";
-    readonly userAgent: "speakeasy-sdk/typescript 1.2.52 2.914.0 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 1.2.54 2.914.0 1.0.0 @openrouter/sdk";
 };
 //# sourceMappingURL=config.d.ts.map

package/esm/lib/config.js

@@ -29,8 +29,8 @@ export function serverURLFromOptions(options) {
 export const SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "1.0.0",
-    sdkVersion: "1.2.52",
+    sdkVersion: "1.2.54",
     genVersion: "2.914.0",
-    userAgent: "speakeasy-sdk/typescript 1.2.52 2.914.0 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 1.2.54 2.914.0 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/additionaltoolsitem.d.ts

@@ -23,6 +23,7 @@ import { SearchModelsServerToolOpenRouter, SearchModelsServerToolOpenRouter$Outb
 import { ShellServerTool, ShellServerTool$Outbound } from "./shellservertool.js";
 import { ShellServerToolOpenRouter, ShellServerToolOpenRouter$Outbound } from "./shellservertoolopenrouter.js";
 import { SubagentServerToolOpenRouter, SubagentServerToolOpenRouter$Outbound } from "./subagentservertoolopenrouter.js";
+import { ToolSearchServerTool, ToolSearchServerTool$Outbound } from "./toolsearchservertool.js";
 import { WebFetchServerTool, WebFetchServerTool$Outbound } from "./webfetchservertool.js";
 import { WebSearchServerTool, WebSearchServerTool$Outbound } from "./websearchservertool.js";
 import { WebSearchServerToolOpenRouter, WebSearchServerToolOpenRouter$Outbound } from "./websearchservertoolopenrouter.js";
@@ -58,8 +59,12 @@ export type AdditionalToolsItemToolFunction = {
     } | null;
     strict?: boolean | null | undefined;
     type: AdditionalToolsItemTypeFunction;
+    /**
+     * Withhold this tool from the model until `openrouter:tool_search` finds it. Requires the tool search server tool; at least one tool must remain non-deferred.
+     */
+    deferLoading?: boolean | undefined;
 };
-export type AdditionalToolsItemToolUnion = ComputerUseServerTool | NamespaceTool | AdditionalToolsItemToolFunction | FileSearchServerTool | CodeInterpreterServerTool | McpServerTool | CustomTool | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | AdvisorServerToolOpenRouter | SubagentServerToolOpenRouter | DatetimeServerTool | FilesServerTool | FusionServerToolOpenRouter | ImageGenerationServerToolOpenRouter | SearchModelsServerToolOpenRouter | WebFetchServerTool | WebSearchServerToolOpenRouter | ApplyPatchServerToolOpenRouter | BashServerTool | ShellServerToolOpenRouter | AdditionalToolsItemTool;
+export type AdditionalToolsItemToolUnion = ComputerUseServerTool | NamespaceTool | AdditionalToolsItemToolFunction | FileSearchServerTool | CodeInterpreterServerTool | McpServerTool | CustomTool | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | AdvisorServerToolOpenRouter | SubagentServerToolOpenRouter | DatetimeServerTool | FilesServerTool | FusionServerToolOpenRouter | ImageGenerationServerToolOpenRouter | SearchModelsServerToolOpenRouter | WebFetchServerTool | WebSearchServerToolOpenRouter | ApplyPatchServerToolOpenRouter | BashServerTool | ShellServerToolOpenRouter | ToolSearchServerTool | AdditionalToolsItemTool;
 export declare const TypeAdditionalTools: {
     readonly AdditionalTools: "additional_tools";
 };
@@ -70,7 +75,7 @@ export type TypeAdditionalTools = ClosedEnum<typeof TypeAdditionalTools>;
 export type AdditionalToolsItem = {
     id?: string | null | undefined;
     role: AdditionalToolsItemRole;
-    tools: Array<ComputerUseServerTool | NamespaceTool | AdditionalToolsItemToolFunction | FileSearchServerTool | CodeInterpreterServerTool | McpServerTool | CustomTool | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | AdvisorServerToolOpenRouter | SubagentServerToolOpenRouter | DatetimeServerTool | FilesServerTool | FusionServerToolOpenRouter | ImageGenerationServerToolOpenRouter | SearchModelsServerToolOpenRouter | WebFetchServerTool | WebSearchServerToolOpenRouter | ApplyPatchServerToolOpenRouter | BashServerTool | ShellServerToolOpenRouter | AdditionalToolsItemTool>;
+    tools: Array<ComputerUseServerTool | NamespaceTool | AdditionalToolsItemToolFunction | FileSearchServerTool | CodeInterpreterServerTool | McpServerTool | CustomTool | PreviewWebSearchServerTool | Preview20250311WebSearchServerTool | LegacyWebSearchServerTool | WebSearchServerTool | ImageGenerationServerTool | CodexLocalShellTool | ShellServerTool | ApplyPatchServerTool | AdvisorServerToolOpenRouter | SubagentServerToolOpenRouter | DatetimeServerTool | FilesServerTool | FusionServerToolOpenRouter | ImageGenerationServerToolOpenRouter | SearchModelsServerToolOpenRouter | WebFetchServerTool | WebSearchServerToolOpenRouter | ApplyPatchServerToolOpenRouter | BashServerTool | ShellServerToolOpenRouter | ToolSearchServerTool | AdditionalToolsItemTool>;
     type: TypeAdditionalTools;
 };
 /** @internal */
@@ -94,12 +99,13 @@ export type AdditionalToolsItemToolFunction$Outbound = {
     } | null;
     strict?: boolean | null | undefined;
     type: string;
+    defer_loading?: boolean | undefined;
 };
 /** @internal */
 export declare const AdditionalToolsItemToolFunction$outboundSchema: z.ZodType<AdditionalToolsItemToolFunction$Outbound, AdditionalToolsItemToolFunction>;
 export declare function additionalToolsItemToolFunctionToJSON(additionalToolsItemToolFunction: AdditionalToolsItemToolFunction): string;
 /** @internal */
-export type AdditionalToolsItemToolUnion$Outbound = ComputerUseServerTool$Outbound | NamespaceTool$Outbound | AdditionalToolsItemToolFunction$Outbound | FileSearchServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | CustomTool$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | AdvisorServerToolOpenRouter$Outbound | SubagentServerToolOpenRouter$Outbound | DatetimeServerTool$Outbound | FilesServerTool$Outbound | FusionServerToolOpenRouter$Outbound | ImageGenerationServerToolOpenRouter$Outbound | SearchModelsServerToolOpenRouter$Outbound | WebFetchServerTool$Outbound | WebSearchServerToolOpenRouter$Outbound | ApplyPatchServerToolOpenRouter$Outbound | BashServerTool$Outbound | ShellServerToolOpenRouter$Outbound | AdditionalToolsItemTool$Outbound;
+export type AdditionalToolsItemToolUnion$Outbound = ComputerUseServerTool$Outbound | NamespaceTool$Outbound | AdditionalToolsItemToolFunction$Outbound | FileSearchServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | CustomTool$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | AdvisorServerToolOpenRouter$Outbound | SubagentServerToolOpenRouter$Outbound | DatetimeServerTool$Outbound | FilesServerTool$Outbound | FusionServerToolOpenRouter$Outbound | ImageGenerationServerToolOpenRouter$Outbound | SearchModelsServerToolOpenRouter$Outbound | WebFetchServerTool$Outbound | WebSearchServerToolOpenRouter$Outbound | ApplyPatchServerToolOpenRouter$Outbound | BashServerTool$Outbound | ShellServerToolOpenRouter$Outbound | ToolSearchServerTool$Outbound | AdditionalToolsItemTool$Outbound;
 /** @internal */
 export declare const AdditionalToolsItemToolUnion$outboundSchema: z.ZodType<AdditionalToolsItemToolUnion$Outbound, AdditionalToolsItemToolUnion>;
 export declare function additionalToolsItemToolUnionToJSON(additionalToolsItemToolUnion: AdditionalToolsItemToolUnion): string;
@@ -109,7 +115,7 @@ export declare const TypeAdditionalTools$outboundSchema: z.ZodEnum<typeof TypeAd
 export type AdditionalToolsItem$Outbound = {
     id?: string | null | undefined;
     role: string;
-    tools: Array<ComputerUseServerTool$Outbound | NamespaceTool$Outbound | AdditionalToolsItemToolFunction$Outbound | FileSearchServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | CustomTool$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | AdvisorServerToolOpenRouter$Outbound | SubagentServerToolOpenRouter$Outbound | DatetimeServerTool$Outbound | FilesServerTool$Outbound | FusionServerToolOpenRouter$Outbound | ImageGenerationServerToolOpenRouter$Outbound | SearchModelsServerToolOpenRouter$Outbound | WebFetchServerTool$Outbound | WebSearchServerToolOpenRouter$Outbound | ApplyPatchServerToolOpenRouter$Outbound | BashServerTool$Outbound | ShellServerToolOpenRouter$Outbound | AdditionalToolsItemTool$Outbound>;
+    tools: Array<ComputerUseServerTool$Outbound | NamespaceTool$Outbound | AdditionalToolsItemToolFunction$Outbound | FileSearchServerTool$Outbound | CodeInterpreterServerTool$Outbound | McpServerTool$Outbound | CustomTool$Outbound | PreviewWebSearchServerTool$Outbound | Preview20250311WebSearchServerTool$Outbound | LegacyWebSearchServerTool$Outbound | WebSearchServerTool$Outbound | ImageGenerationServerTool$Outbound | CodexLocalShellTool$Outbound | ShellServerTool$Outbound | ApplyPatchServerTool$Outbound | AdvisorServerToolOpenRouter$Outbound | SubagentServerToolOpenRouter$Outbound | DatetimeServerTool$Outbound | FilesServerTool$Outbound | FusionServerToolOpenRouter$Outbound | ImageGenerationServerToolOpenRouter$Outbound | SearchModelsServerToolOpenRouter$Outbound | WebFetchServerTool$Outbound | WebSearchServerToolOpenRouter$Outbound | ApplyPatchServerToolOpenRouter$Outbound | BashServerTool$Outbound | ShellServerToolOpenRouter$Outbound | ToolSearchServerTool$Outbound | AdditionalToolsItemTool$Outbound>;
     type: string;
 };
 /** @internal */

package/esm/models/additionaltoolsitem.js

@@ -28,6 +28,7 @@ import { SearchModelsServerToolOpenRouter$outboundSchema, } from "./searchmodels
 import { ShellServerTool$outboundSchema, } from "./shellservertool.js";
 import { ShellServerToolOpenRouter$outboundSchema, } from "./shellservertoolopenrouter.js";
 import { SubagentServerToolOpenRouter$outboundSchema, } from "./subagentservertoolopenrouter.js";
+import { ToolSearchServerTool$outboundSchema, } from "./toolsearchservertool.js";
 import { WebFetchServerTool$outboundSchema, } from "./webfetchservertool.js";
 import { WebSearchServerTool$outboundSchema, } from "./websearchservertool.js";
 import { WebSearchServerToolOpenRouter$outboundSchema, } from "./websearchservertoolopenrouter.js";
@@ -73,6 +74,11 @@ export const AdditionalToolsItemToolFunction$outboundSchema = z.object({
     parameters: z.nullable(z.record(z.string(), z.any())),
     strict: z.nullable(z.boolean()).optional(),
     type: AdditionalToolsItemTypeFunction$outboundSchema,
+    deferLoading: z.boolean().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        deferLoading: "defer_loading",
+    });
 });
 export function additionalToolsItemToolFunctionToJSON(additionalToolsItemToolFunction) {
     return JSON.stringify(AdditionalToolsItemToolFunction$outboundSchema.parse(additionalToolsItemToolFunction));
@@ -106,6 +112,7 @@ export const AdditionalToolsItemToolUnion$outboundSchema = z.union([
     ApplyPatchServerToolOpenRouter$outboundSchema,
     BashServerTool$outboundSchema,
     ShellServerToolOpenRouter$outboundSchema,
+    ToolSearchServerTool$outboundSchema,
     z.lazy(() => AdditionalToolsItemTool$outboundSchema),
 ]);
 export function additionalToolsItemToolUnionToJSON(additionalToolsItemToolUnion) {
@@ -145,6 +152,7 @@ export const AdditionalToolsItem$outboundSchema = z.object({
         ApplyPatchServerToolOpenRouter$outboundSchema,
         BashServerTool$outboundSchema,
         ShellServerToolOpenRouter$outboundSchema,
+        ToolSearchServerTool$outboundSchema,
         z.lazy(() => AdditionalToolsItemTool$outboundSchema),
     ])),
     type: TypeAdditionalTools$outboundSchema,

package/esm/models/index.d.ts

@@ -555,6 +555,8 @@ export * from "./textdoneevent.js";
 export * from "./textextendedconfig.js";
 export * from "./toolcallstatus.js";
 export * from "./toolchoiceallowed.js";
+export * from "./toolsearchservertool.js";
+export * from "./toolsearchservertoolconfig.js";
 export * from "./toomanyrequestsresponseerrordata.js";
 export * from "./topproviderinfo.js";
 export * from "./traceconfig.js";

package/esm/models/index.js

@@ -559,6 +559,8 @@ export * from "./textdoneevent.js";
 export * from "./textextendedconfig.js";
 export * from "./toolcallstatus.js";
 export * from "./toolchoiceallowed.js";
+export * from "./toolsearchservertool.js";
+export * from "./toolsearchservertoolconfig.js";
 export * from "./toomanyrequestsresponseerrordata.js";
 export * from "./topproviderinfo.js";
 export * from "./traceconfig.js";

package/esm/models/messagesrequest.d.ts

@@ -31,6 +31,7 @@ import { ProviderPreferences, ProviderPreferences$Outbound } from "./providerpre
 import { ResponseHealingPlugin, ResponseHealingPlugin$Outbound } from "./responsehealingplugin.js";
 import { ShellServerToolOpenRouter, ShellServerToolOpenRouter$Outbound } from "./shellservertoolopenrouter.js";
 import { StopServerToolsWhenCondition, StopServerToolsWhenCondition$Outbound } from "./stopservertoolswhencondition.js";
+import { ToolSearchServerTool, ToolSearchServerTool$Outbound } from "./toolsearchservertool.js";
 import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 import { WebFetchPlugin, WebFetchPlugin$Outbound } from "./webfetchplugin.js";
 import { WebFetchServerTool, WebFetchServerTool$Outbound } from "./webfetchservertool.js";
@@ -248,7 +249,7 @@ export type ToolCustom = {
     name: string;
     type?: ToolTypeCustom | undefined;
 };
-export type MessagesRequestToolUnion = ToolAdvisor20260301 | ToolCustom | ToolBash20250124 | ToolTextEditor20250124 | ToolWebSearch20250305 | ToolWebSearch20260209 | AnthropicToolSearchToolBm25 | AnthropicToolSearchToolRegex | BashServerTool | DatetimeServerTool | ImageGenerationServerToolOpenRouter | MessagesSearchModelsServerTool | WebFetchServerTool | OpenRouterWebSearchServerTool | MessagesRequestTool | ShellServerToolOpenRouter;
+export type MessagesRequestToolUnion = ToolAdvisor20260301 | ToolCustom | ToolBash20250124 | ToolTextEditor20250124 | ToolWebSearch20250305 | ToolWebSearch20260209 | AnthropicToolSearchToolBm25 | AnthropicToolSearchToolRegex | BashServerTool | DatetimeServerTool | ImageGenerationServerToolOpenRouter | MessagesSearchModelsServerTool | WebFetchServerTool | OpenRouterWebSearchServerTool | MessagesRequestTool | ShellServerToolOpenRouter | ToolSearchServerTool;
 /**
  * Request schema for Anthropic Messages API endpoint
  */
@@ -295,7 +296,7 @@ export type MessagesRequest = {
     temperature?: number | undefined;
     thinking?: ThinkingEnabled | ThinkingDisabled | ThinkingAdaptive | undefined;
     toolChoice?: ToolChoiceAuto | ToolChoiceAny | ToolChoiceNone | ToolChoiceTool | undefined;
-    tools?: Array<ToolAdvisor20260301 | ToolCustom | ToolBash20250124 | ToolTextEditor20250124 | ToolWebSearch20250305 | ToolWebSearch20260209 | AnthropicToolSearchToolBm25 | AnthropicToolSearchToolRegex | BashServerTool | DatetimeServerTool | ImageGenerationServerToolOpenRouter | MessagesSearchModelsServerTool | WebFetchServerTool | OpenRouterWebSearchServerTool | MessagesRequestTool | ShellServerToolOpenRouter> | undefined;
+    tools?: Array<ToolAdvisor20260301 | ToolCustom | ToolBash20250124 | ToolTextEditor20250124 | ToolWebSearch20250305 | ToolWebSearch20260209 | AnthropicToolSearchToolBm25 | AnthropicToolSearchToolRegex | BashServerTool | DatetimeServerTool | ImageGenerationServerToolOpenRouter | MessagesSearchModelsServerTool | WebFetchServerTool | OpenRouterWebSearchServerTool | MessagesRequestTool | ShellServerToolOpenRouter | ToolSearchServerTool> | undefined;
     topK?: number | undefined;
     topP?: number | undefined;
     /**
@@ -582,7 +583,7 @@ export type ToolCustom$Outbound = {
 export declare const ToolCustom$outboundSchema: z.ZodType<ToolCustom$Outbound, ToolCustom>;
 export declare function toolCustomToJSON(toolCustom: ToolCustom): string;
 /** @internal */
-export type MessagesRequestToolUnion$Outbound = ToolAdvisor20260301$Outbound | ToolCustom$Outbound | ToolBash20250124$Outbound | ToolTextEditor20250124$Outbound | ToolWebSearch20250305$Outbound | ToolWebSearch20260209$Outbound | AnthropicToolSearchToolBm25$Outbound | AnthropicToolSearchToolRegex$Outbound | BashServerTool$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | MessagesSearchModelsServerTool$Outbound | WebFetchServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | MessagesRequestTool$Outbound | ShellServerToolOpenRouter$Outbound;
+export type MessagesRequestToolUnion$Outbound = ToolAdvisor20260301$Outbound | ToolCustom$Outbound | ToolBash20250124$Outbound | ToolTextEditor20250124$Outbound | ToolWebSearch20250305$Outbound | ToolWebSearch20260209$Outbound | AnthropicToolSearchToolBm25$Outbound | AnthropicToolSearchToolRegex$Outbound | BashServerTool$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | MessagesSearchModelsServerTool$Outbound | WebFetchServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | MessagesRequestTool$Outbound | ShellServerToolOpenRouter$Outbound | ToolSearchServerTool$Outbound;
 /** @internal */
 export declare const MessagesRequestToolUnion$outboundSchema: z.ZodType<MessagesRequestToolUnion$Outbound, MessagesRequestToolUnion>;
 export declare function messagesRequestToolUnionToJSON(messagesRequestToolUnion: MessagesRequestToolUnion): string;
@@ -609,7 +610,7 @@ export type MessagesRequest$Outbound = {
     temperature?: number | undefined;
     thinking?: ThinkingEnabled$Outbound | ThinkingDisabled$Outbound | ThinkingAdaptive$Outbound | undefined;
     tool_choice?: ToolChoiceAuto$Outbound | ToolChoiceAny$Outbound | ToolChoiceNone$Outbound | ToolChoiceTool$Outbound | undefined;
-    tools?: Array<ToolAdvisor20260301$Outbound | ToolCustom$Outbound | ToolBash20250124$Outbound | ToolTextEditor20250124$Outbound | ToolWebSearch20250305$Outbound | ToolWebSearch20260209$Outbound | AnthropicToolSearchToolBm25$Outbound | AnthropicToolSearchToolRegex$Outbound | BashServerTool$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | MessagesSearchModelsServerTool$Outbound | WebFetchServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | MessagesRequestTool$Outbound | ShellServerToolOpenRouter$Outbound> | undefined;
+    tools?: Array<ToolAdvisor20260301$Outbound | ToolCustom$Outbound | ToolBash20250124$Outbound | ToolTextEditor20250124$Outbound | ToolWebSearch20250305$Outbound | ToolWebSearch20260209$Outbound | AnthropicToolSearchToolBm25$Outbound | AnthropicToolSearchToolRegex$Outbound | BashServerTool$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | MessagesSearchModelsServerTool$Outbound | WebFetchServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | MessagesRequestTool$Outbound | ShellServerToolOpenRouter$Outbound | ToolSearchServerTool$Outbound> | undefined;
     top_k?: number | undefined;
     top_p?: number | undefined;
     trace?: TraceConfig$Outbound | undefined;

package/esm/models/messagesrequest.js

@@ -36,6 +36,7 @@ import { ProviderPreferences$outboundSchema, } from "./providerpreferences.js";
 import { ResponseHealingPlugin$outboundSchema, } from "./responsehealingplugin.js";
 import { ShellServerToolOpenRouter$outboundSchema, } from "./shellservertoolopenrouter.js";
 import { StopServerToolsWhenCondition$outboundSchema, } from "./stopservertoolswhencondition.js";
+import { ToolSearchServerTool$outboundSchema, } from "./toolsearchservertool.js";
 import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 import { WebFetchPlugin$outboundSchema, } from "./webfetchplugin.js";
 import { WebFetchServerTool$outboundSchema, } from "./webfetchservertool.js";
@@ -518,6 +519,7 @@ export const MessagesRequestToolUnion$outboundSchema = z.union([
     OpenRouterWebSearchServerTool$outboundSchema,
     z.lazy(() => MessagesRequestTool$outboundSchema),
     ShellServerToolOpenRouter$outboundSchema,
+    ToolSearchServerTool$outboundSchema,
 ]);
 export function messagesRequestToolUnionToJSON(messagesRequestToolUnion) {
     return JSON.stringify(MessagesRequestToolUnion$outboundSchema.parse(messagesRequestToolUnion));
@@ -586,6 +588,7 @@ export const MessagesRequest$outboundSchema = z.object({
         OpenRouterWebSearchServerTool$outboundSchema,
         z.lazy(() => MessagesRequestTool$outboundSchema),
         ShellServerToolOpenRouter$outboundSchema,
+        ToolSearchServerTool$outboundSchema,
     ])).optional(),
     topK: z.int().optional(),
     topP: z.number().optional(),

package/esm/models/openresponsesresult.d.ts

@@ -46,6 +46,10 @@ export type OpenResponsesResultToolFunction = {
     } | null;
     strict?: boolean | null | undefined;
     type: "function";
+    /**
+     * Withhold this tool from the model until `openrouter:tool_search` finds it. Requires the tool search server tool; at least one tool must remain non-deferred.
+     */
+    deferLoading?: boolean | undefined;
 };
 export type OpenResponsesResultToolUnion = OpenResponsesResultToolFunction | (PreviewWebSearchServerTool & {
     type: "web_search_preview";

package/esm/models/openresponsesresult.js

@@ -46,6 +46,11 @@ export const OpenResponsesResultToolFunction$inboundSchema = z.object({
     parameters: z.nullable(z.record(z.string(), z.any())),
     strict: z.nullable(z.boolean()).optional(),
     type: z.literal("function"),
+    defer_loading: z.boolean().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        "defer_loading": "deferLoading",
+    });
 });
 export function openResponsesResultToolFunctionFromJSON(jsonString) {
     return safeParse(jsonString, (x) => OpenResponsesResultToolFunction$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'OpenResponsesResultToolFunction' from JSON`);

package/esm/models/responsesrequest.d.ts

@@ -48,6 +48,7 @@ import { StopServerToolsWhenCondition, StopServerToolsWhenCondition$Outbound } f
 import { StoredPromptTemplate, StoredPromptTemplate$Outbound } from "./storedprompttemplate.js";
 import { SubagentServerToolOpenRouter, SubagentServerToolOpenRouter$Outbound } from "./subagentservertoolopenrouter.js";
 import { TextExtendedConfig, TextExtendedConfig$Outbound } from "./textextendedconfig.js";
+import { ToolSearchServerTool, ToolSearchServerTool$Outbound } from "./toolsearchservertool.js";
 import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 import { WebFetchPlugin, WebFetchPlugin$Outbound } from "./webfetchplugin.js";
 import { WebFetchServerTool, WebFetchServerTool$Outbound } from "./webfetchservertool.js";
@@ -95,6 +96,10 @@ export type ResponsesRequestToolFunction = {
     } | null;
     strict?: boolean | null | undefined;
     type: "function";
+    /**
+     * Withhold this tool from the model until `openrouter:tool_search` finds it. Requires the tool search server tool; at least one tool must remain non-deferred.
+     */
+    deferLoading?: boolean | undefined;
 };
 export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | (PreviewWebSearchServerTool & {
     type: "web_search_preview";
@@ -148,6 +153,8 @@ export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | (PreviewW
     type: "openrouter:bash";
 }) | (ShellServerToolOpenRouter & {
     type: "openrouter:shell";
+}) | (ToolSearchServerTool & {
+    type: "openrouter:tool_search";
 });
 /**
  * Request schema for Responses endpoint
@@ -292,6 +299,8 @@ export type ResponsesRequest = {
         type: "openrouter:bash";
     }) | (ShellServerToolOpenRouter & {
         type: "openrouter:shell";
+    }) | (ToolSearchServerTool & {
+        type: "openrouter:tool_search";
     })> | undefined;
     topK?: number | undefined;
     topLogprobs?: number | null | undefined;
@@ -334,6 +343,7 @@ export type ResponsesRequestToolFunction$Outbound = {
     } | null;
     strict?: boolean | null | undefined;
     type: "function";
+    defer_loading?: boolean | undefined;
 };
 /** @internal */
 export declare const ResponsesRequestToolFunction$outboundSchema: z.ZodType<ResponsesRequestToolFunction$Outbound, ResponsesRequestToolFunction>;
@@ -391,6 +401,8 @@ export type ResponsesRequestToolUnion$Outbound = ResponsesRequestToolFunction$Ou
     type: "openrouter:bash";
 }) | (ShellServerToolOpenRouter$Outbound & {
     type: "openrouter:shell";
+}) | (ToolSearchServerTool$Outbound & {
+    type: "openrouter:tool_search";
 });
 /** @internal */
 export declare const ResponsesRequestToolUnion$outboundSchema: z.ZodType<ResponsesRequestToolUnion$Outbound, ResponsesRequestToolUnion>;
@@ -485,6 +497,8 @@ export type ResponsesRequest$Outbound = {
         type: "openrouter:bash";
     }) | (ShellServerToolOpenRouter$Outbound & {
         type: "openrouter:shell";
+    }) | (ToolSearchServerTool$Outbound & {
+        type: "openrouter:tool_search";
     })> | undefined;
     top_k?: number | undefined;
     top_logprobs?: number | null | undefined;

package/esm/models/responsesrequest.js

@@ -53,6 +53,7 @@ import { StopServerToolsWhenCondition$outboundSchema, } from "./stopservertoolsw
 import { StoredPromptTemplate$outboundSchema, } from "./storedprompttemplate.js";
 import { SubagentServerToolOpenRouter$outboundSchema, } from "./subagentservertoolopenrouter.js";
 import { TextExtendedConfig$outboundSchema, } from "./textextendedconfig.js";
+import { ToolSearchServerTool$outboundSchema, } from "./toolsearchservertool.js";
 import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 import { WebFetchPlugin$outboundSchema, } from "./webfetchplugin.js";
 import { WebFetchServerTool$outboundSchema, } from "./webfetchservertool.js";
@@ -111,6 +112,11 @@ export const ResponsesRequestToolFunction$outboundSchema = z.object({
     parameters: z.nullable(z.record(z.string(), z.any())),
     strict: z.nullable(z.boolean()).optional(),
     type: z.literal("function"),
+    deferLoading: z.boolean().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        deferLoading: "defer_loading",
+    });
 });
 export function responsesRequestToolFunctionToJSON(responsesRequestToolFunction) {
     return JSON.stringify(ResponsesRequestToolFunction$outboundSchema.parse(responsesRequestToolFunction));
@@ -144,6 +150,7 @@ export const ResponsesRequestToolUnion$outboundSchema = z.union([
     ApplyPatchServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:apply_patch") })),
     BashServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:bash") })),
     ShellServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:shell") })),
+    ToolSearchServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:tool_search") })),
 ]);
 export function responsesRequestToolUnionToJSON(responsesRequestToolUnion) {
     return JSON.stringify(ResponsesRequestToolUnion$outboundSchema.parse(responsesRequestToolUnion));
@@ -223,6 +230,7 @@ export const ResponsesRequest$outboundSchema = z.object({
         ApplyPatchServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:apply_patch") })),
         BashServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:bash") })),
         ShellServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:shell") })),
+        ToolSearchServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:tool_search") })),
     ])).optional(),
     topK: z.int().optional(),
     topLogprobs: z.nullable(z.int()).optional(),

package/esm/models/toolsearchservertool.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { ToolSearchServerToolConfig, ToolSearchServerToolConfig$Outbound } from "./toolsearchservertoolconfig.js";
+export declare const ToolSearchServerToolType: {
+    readonly OpenrouterToolSearch: "openrouter:tool_search";
+};
+export type ToolSearchServerToolType = ClosedEnum<typeof ToolSearchServerToolType>;
+/**
+ * OpenRouter built-in server tool: finds tools marked `defer_loading` and makes them callable
+ */
+export type ToolSearchServerTool = {
+    /**
+     * Configuration for the openrouter:tool_search server tool
+     */
+    parameters?: ToolSearchServerToolConfig | undefined;
+    type: ToolSearchServerToolType;
+};
+/** @internal */
+export declare const ToolSearchServerToolType$outboundSchema: z.ZodEnum<typeof ToolSearchServerToolType>;
+/** @internal */
+export type ToolSearchServerTool$Outbound = {
+    parameters?: ToolSearchServerToolConfig$Outbound | undefined;
+    type: string;
+};
+/** @internal */
+export declare const ToolSearchServerTool$outboundSchema: z.ZodType<ToolSearchServerTool$Outbound, ToolSearchServerTool>;
+export declare function toolSearchServerToolToJSON(toolSearchServerTool: ToolSearchServerTool): string;
+//# sourceMappingURL=toolsearchservertool.d.ts.map

package/esm/models/toolsearchservertool.js

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: de3e685fadd8
+ */
+import * as z from "zod/v4";
+import { ToolSearchServerToolConfig$outboundSchema, } from "./toolsearchservertoolconfig.js";
+export const ToolSearchServerToolType = {
+    OpenrouterToolSearch: "openrouter:tool_search",
+};
+/** @internal */
+export const ToolSearchServerToolType$outboundSchema = z.enum(ToolSearchServerToolType);
+/** @internal */
+export const ToolSearchServerTool$outboundSchema = z.object({
+    parameters: ToolSearchServerToolConfig$outboundSchema.optional(),
+    type: ToolSearchServerToolType$outboundSchema,
+});
+export function toolSearchServerToolToJSON(toolSearchServerTool) {
+    return JSON.stringify(ToolSearchServerTool$outboundSchema.parse(toolSearchServerTool));
+}
+//# sourceMappingURL=toolsearchservertool.js.map

package/esm/models/toolsearchservertoolconfig.d.ts

@@ -0,0 +1,18 @@
+import * as z from "zod/v4";
+/**
+ * Configuration for the openrouter:tool_search server tool
+ */
+export type ToolSearchServerToolConfig = {
+    /**
+     * Maximum tools returned by one search. Defaults to 5.
+     */
+    maxResults?: number | undefined;
+};
+/** @internal */
+export type ToolSearchServerToolConfig$Outbound = {
+    max_results?: number | undefined;
+};
+/** @internal */
+export declare const ToolSearchServerToolConfig$outboundSchema: z.ZodType<ToolSearchServerToolConfig$Outbound, ToolSearchServerToolConfig>;
+export declare function toolSearchServerToolConfigToJSON(toolSearchServerToolConfig: ToolSearchServerToolConfig): string;
+//# sourceMappingURL=toolsearchservertoolconfig.d.ts.map

package/esm/models/toolsearchservertoolconfig.js

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

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "1.2.52",
+  "version": "1.2.54",
   "author": "OpenRouter",
   "description": "The OpenRouter TypeScript SDK is a type-safe toolkit for building AI applications with access to 400+ language models through a unified API.",
   "keywords": [
@@ -21,8 +21,8 @@
   "license": "Apache-2.0",
   "packageManager": "pnpm@10.22.0",
   "publishConfig": {
-    "provenance": true,
-    "access": "public"
+    "access": "public",
+    "provenance": true
   },
   "type": "module",
   "main": "./esm/index.js",
@@ -73,15 +73,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "prepare": "npm run build",
-    "test:e2e": "vitest --run --project e2e",
-    "test:watch": "vitest --watch --project unit",
-    "typecheck": "tsc --noEmit",
-    "typecheck:transit": "exit 0",
     "postinstall": "node scripts/check-types.js || true",
     "test": "vitest --run --project unit",
+    "test:e2e": "vitest --run --project e2e",
     "test:transit": "exit 0",
-    "compile": "tsc"
+    "test:watch": "vitest --watch --project unit",
+    "typecheck:transit": "exit 0",
+    "compile": "tsc",
+    "prepare": "npm run build",
+    "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {},
   "devDependencies": {