@openrouter/sdk 0.12.18 → 0.12.19

package/esm/lib/config.d.ts

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

package/esm/lib/config.js

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

package/esm/models/chatfunctiontool.d.ts

@@ -6,6 +6,7 @@ import { ChatWebSearchShorthand, ChatWebSearchShorthand$Outbound } from "./chatw
 import { DatetimeServerTool, DatetimeServerTool$Outbound } from "./datetimeservertool.js";
 import { ImageGenerationServerToolOpenRouter, ImageGenerationServerToolOpenRouter$Outbound } from "./imagegenerationservertoolopenrouter.js";
 import { OpenRouterWebSearchServerTool, OpenRouterWebSearchServerTool$Outbound } from "./openrouterwebsearchservertool.js";
+import { WebFetchServerTool, WebFetchServerTool$Outbound } from "./webfetchservertool.js";
 /**
  * Function definition for tool calling
  */
@@ -47,7 +48,7 @@ export type ChatFunctionToolFunction = {
 /**
  * Tool definition for function calling (regular function or OpenRouter built-in server tool)
  */
-export type ChatFunctionTool = ChatFunctionToolFunction | DatetimeServerTool | ImageGenerationServerToolOpenRouter | ChatSearchModelsServerTool | OpenRouterWebSearchServerTool | ChatWebSearchShorthand;
+export type ChatFunctionTool = ChatFunctionToolFunction | DatetimeServerTool | ImageGenerationServerToolOpenRouter | ChatSearchModelsServerTool | WebFetchServerTool | OpenRouterWebSearchServerTool | ChatWebSearchShorthand;
 /** @internal */
 export type ChatFunctionToolFunctionFunction$Outbound = {
     description?: string | undefined;
@@ -72,7 +73,7 @@ export type ChatFunctionToolFunction$Outbound = {
 export declare const ChatFunctionToolFunction$outboundSchema: z.ZodType<ChatFunctionToolFunction$Outbound, ChatFunctionToolFunction>;
 export declare function chatFunctionToolFunctionToJSON(chatFunctionToolFunction: ChatFunctionToolFunction): string;
 /** @internal */
-export type ChatFunctionTool$Outbound = ChatFunctionToolFunction$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | ChatSearchModelsServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | ChatWebSearchShorthand$Outbound;
+export type ChatFunctionTool$Outbound = ChatFunctionToolFunction$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | ChatSearchModelsServerTool$Outbound | WebFetchServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | ChatWebSearchShorthand$Outbound;
 /** @internal */
 export declare const ChatFunctionTool$outboundSchema: z.ZodType<ChatFunctionTool$Outbound, ChatFunctionTool>;
 export declare function chatFunctionToolToJSON(chatFunctionTool: ChatFunctionTool): string;

package/esm/models/chatfunctiontool.js

@@ -10,6 +10,7 @@ import { ChatWebSearchShorthand$outboundSchema, } from "./chatwebsearchshorthand
 import { DatetimeServerTool$outboundSchema, } from "./datetimeservertool.js";
 import { ImageGenerationServerToolOpenRouter$outboundSchema, } from "./imagegenerationservertoolopenrouter.js";
 import { OpenRouterWebSearchServerTool$outboundSchema, } from "./openrouterwebsearchservertool.js";
+import { WebFetchServerTool$outboundSchema, } from "./webfetchservertool.js";
 export const ChatFunctionToolType = {
     Function: "function",
 };
@@ -44,6 +45,7 @@ export const ChatFunctionTool$outboundSchema = z.union([
     DatetimeServerTool$outboundSchema,
     ImageGenerationServerToolOpenRouter$outboundSchema,
     ChatSearchModelsServerTool$outboundSchema,
+    WebFetchServerTool$outboundSchema,
     OpenRouterWebSearchServerTool$outboundSchema,
     ChatWebSearchShorthand$outboundSchema,
 ]);

package/esm/models/generationresponse.d.ts

@@ -101,6 +101,10 @@ export type GenerationResponseData = {
      * Native reasoning tokens as reported by provider
      */
     nativeTokensReasoning: number | null;
+    /**
+     * Number of web fetches performed
+     */
+    numFetches: number | null;
     /**
      * Number of audio inputs in the prompt
      */

package/esm/models/generationresponse.js

@@ -42,6 +42,7 @@ export const GenerationResponseData$inboundSchema = z.object({
     native_tokens_completion_images: z.nullable(z.int()),
     native_tokens_prompt: z.nullable(z.int()),
     native_tokens_reasoning: z.nullable(z.int()),
+    num_fetches: z.nullable(z.int()),
     num_input_audio_prompt: z.nullable(z.int()),
     num_media_completion: z.nullable(z.int()),
     num_media_prompt: z.nullable(z.int()),
@@ -79,6 +80,7 @@ export const GenerationResponseData$inboundSchema = z.object({
         "native_tokens_completion_images": "nativeTokensCompletionImages",
         "native_tokens_prompt": "nativeTokensPrompt",
         "native_tokens_reasoning": "nativeTokensReasoning",
+        "num_fetches": "numFetches",
         "num_input_audio_prompt": "numInputAudioPrompt",
         "num_media_completion": "numMediaCompletion",
         "num_media_prompt": "numMediaPrompt",

package/esm/models/index.d.ts

@@ -272,6 +272,9 @@ export * from "./videogenerationresponse.js";
 export * from "./videogenerationusage.js";
 export * from "./videomodel.js";
 export * from "./videomodelslistresponse.js";
+export * from "./webfetchengineenum.js";
+export * from "./webfetchservertool.js";
+export * from "./webfetchservertoolconfig.js";
 export * from "./websearchcallcompletedevent.js";
 export * from "./websearchcallinprogressevent.js";
 export * from "./websearchcallsearchingevent.js";

package/esm/models/index.js

@@ -276,6 +276,9 @@ export * from "./videogenerationresponse.js";
 export * from "./videogenerationusage.js";
 export * from "./videomodel.js";
 export * from "./videomodelslistresponse.js";
+export * from "./webfetchengineenum.js";
+export * from "./webfetchservertool.js";
+export * from "./webfetchservertoolconfig.js";
 export * from "./websearchcallcompletedevent.js";
 export * from "./websearchcallinprogressevent.js";
 export * from "./websearchcallsearchingevent.js";

package/esm/models/responsesrequest.d.ts

@@ -32,6 +32,7 @@ import { ShellServerTool, ShellServerTool$Outbound } from "./shellservertool.js"
 import { StoredPromptTemplate, StoredPromptTemplate$Outbound } from "./storedprompttemplate.js";
 import { TextExtendedConfig, TextExtendedConfig$Outbound } from "./textextendedconfig.js";
 import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
+import { WebFetchServerTool, WebFetchServerTool$Outbound } from "./webfetchservertool.js";
 import { WebSearchPlugin, WebSearchPlugin$Outbound } from "./websearchplugin.js";
 import { WebSearchServerTool, WebSearchServerTool$Outbound } from "./websearchservertool.js";
 import { WebSearchServerToolOpenRouter, WebSearchServerToolOpenRouter$Outbound } from "./websearchservertoolopenrouter.js";
@@ -62,6 +63,8 @@ export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | PreviewWe
     type: "openrouter:image_generation";
 }) | (ChatSearchModelsServerTool & {
     type: "openrouter:experimental__search_models";
+}) | (WebFetchServerTool & {
+    type: "openrouter:web_fetch";
 }) | WebSearchServerToolOpenRouter;
 /**
  * Request schema for Responses endpoint
@@ -132,6 +135,8 @@ export type ResponsesRequest = {
         type: "openrouter:image_generation";
     }) | (ChatSearchModelsServerTool & {
         type: "openrouter:experimental__search_models";
+    }) | (WebFetchServerTool & {
+        type: "openrouter:web_fetch";
     }) | WebSearchServerToolOpenRouter> | undefined;
     topK?: number | undefined;
     topLogprobs?: number | null | undefined;
@@ -173,6 +178,8 @@ export type ResponsesRequestToolUnion$Outbound = ResponsesRequestToolFunction$Ou
     type: "openrouter:image_generation";
 }) | (ChatSearchModelsServerTool$Outbound & {
     type: "openrouter:experimental__search_models";
+}) | (WebFetchServerTool$Outbound & {
+    type: "openrouter:web_fetch";
 }) | WebSearchServerToolOpenRouter$Outbound;
 /** @internal */
 export declare const ResponsesRequestToolUnion$outboundSchema: z.ZodType<ResponsesRequestToolUnion$Outbound, ResponsesRequestToolUnion>;
@@ -217,6 +224,8 @@ export type ResponsesRequest$Outbound = {
         type: "openrouter:image_generation";
     }) | (ChatSearchModelsServerTool$Outbound & {
         type: "openrouter:experimental__search_models";
+    }) | (WebFetchServerTool$Outbound & {
+        type: "openrouter:web_fetch";
     }) | WebSearchServerToolOpenRouter$Outbound> | undefined;
     top_k?: number | undefined;
     top_logprobs?: number | null | undefined;

package/esm/models/responsesrequest.js

@@ -37,6 +37,7 @@ import { ShellServerTool$outboundSchema, } from "./shellservertool.js";
 import { StoredPromptTemplate$outboundSchema, } from "./storedprompttemplate.js";
 import { TextExtendedConfig$outboundSchema, } from "./textextendedconfig.js";
 import { TraceConfig$outboundSchema, } from "./traceconfig.js";
+import { WebFetchServerTool$outboundSchema, } from "./webfetchservertool.js";
 import { WebSearchPlugin$outboundSchema, } from "./websearchplugin.js";
 import { WebSearchServerTool$outboundSchema, } from "./websearchservertool.js";
 import { WebSearchServerToolOpenRouter$outboundSchema, } from "./websearchservertoolopenrouter.js";
@@ -92,6 +93,7 @@ export const ResponsesRequestToolUnion$outboundSchema = z.union([
     DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
     ImageGenerationServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:image_generation") })),
     ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
+    WebFetchServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:web_fetch") })),
     WebSearchServerToolOpenRouter$outboundSchema,
 ]);
 export function responsesRequestToolUnionToJSON(responsesRequestToolUnion) {
@@ -153,6 +155,7 @@ export const ResponsesRequest$outboundSchema = z.object({
         DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
         ImageGenerationServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:image_generation") })),
         ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
+        WebFetchServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:web_fetch") })),
         WebSearchServerToolOpenRouter$outboundSchema,
     ])).optional(),
     topK: z.int().optional(),

package/esm/models/webfetchengineenum.d.ts

@@ -0,0 +1,19 @@
+import * as z from "zod/v4";
+import { OpenEnum } from "../types/enums.js";
+/**
+ * Which fetch engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in fetch. "exa" uses Exa Contents API (supports BYOK). "openrouter" uses direct HTTP fetch. "firecrawl" uses Firecrawl scrape (requires BYOK).
+ */
+export declare const WebFetchEngineEnum: {
+    readonly Auto: "auto";
+    readonly Native: "native";
+    readonly Openrouter: "openrouter";
+    readonly Firecrawl: "firecrawl";
+    readonly Exa: "exa";
+};
+/**
+ * Which fetch engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in fetch. "exa" uses Exa Contents API (supports BYOK). "openrouter" uses direct HTTP fetch. "firecrawl" uses Firecrawl scrape (requires BYOK).
+ */
+export type WebFetchEngineEnum = OpenEnum<typeof WebFetchEngineEnum>;
+/** @internal */
+export declare const WebFetchEngineEnum$outboundSchema: z.ZodType<string, WebFetchEngineEnum>;
+//# sourceMappingURL=webfetchengineenum.d.ts.map

package/esm/models/webfetchengineenum.js

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9cc8d81a8f6c
+ */
+import * as openEnums from "../types/enums.js";
+/**
+ * Which fetch engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in fetch. "exa" uses Exa Contents API (supports BYOK). "openrouter" uses direct HTTP fetch. "firecrawl" uses Firecrawl scrape (requires BYOK).
+ */
+export const WebFetchEngineEnum = {
+    Auto: "auto",
+    Native: "native",
+    Openrouter: "openrouter",
+    Firecrawl: "firecrawl",
+    Exa: "exa",
+};
+/** @internal */
+export const WebFetchEngineEnum$outboundSchema = openEnums.outboundSchema(WebFetchEngineEnum);
+//# sourceMappingURL=webfetchengineenum.js.map

package/esm/models/webfetchservertool.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { WebFetchServerToolConfig, WebFetchServerToolConfig$Outbound } from "./webfetchservertoolconfig.js";
+export declare const WebFetchServerToolType: {
+    readonly OpenrouterWebFetch: "openrouter:web_fetch";
+};
+export type WebFetchServerToolType = ClosedEnum<typeof WebFetchServerToolType>;
+/**
+ * OpenRouter built-in server tool: fetches full content from a URL (web page or PDF)
+ */
+export type WebFetchServerTool = {
+    /**
+     * Configuration for the openrouter:web_fetch server tool
+     */
+    parameters?: WebFetchServerToolConfig | undefined;
+    type: WebFetchServerToolType;
+};
+/** @internal */
+export declare const WebFetchServerToolType$outboundSchema: z.ZodEnum<typeof WebFetchServerToolType>;
+/** @internal */
+export type WebFetchServerTool$Outbound = {
+    parameters?: WebFetchServerToolConfig$Outbound | undefined;
+    type: string;
+};
+/** @internal */
+export declare const WebFetchServerTool$outboundSchema: z.ZodType<WebFetchServerTool$Outbound, WebFetchServerTool>;
+export declare function webFetchServerToolToJSON(webFetchServerTool: WebFetchServerTool): string;
+//# sourceMappingURL=webfetchservertool.d.ts.map

package/esm/models/webfetchservertool.js

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 6d6cb09da873
+ */
+import * as z from "zod/v4";
+import { WebFetchServerToolConfig$outboundSchema, } from "./webfetchservertoolconfig.js";
+export const WebFetchServerToolType = {
+    OpenrouterWebFetch: "openrouter:web_fetch",
+};
+/** @internal */
+export const WebFetchServerToolType$outboundSchema = z.enum(WebFetchServerToolType);
+/** @internal */
+export const WebFetchServerTool$outboundSchema = z.object({
+    parameters: WebFetchServerToolConfig$outboundSchema.optional(),
+    type: WebFetchServerToolType$outboundSchema,
+});
+export function webFetchServerToolToJSON(webFetchServerTool) {
+    return JSON.stringify(WebFetchServerTool$outboundSchema.parse(webFetchServerTool));
+}
+//# sourceMappingURL=webfetchservertool.js.map

package/esm/models/webfetchservertoolconfig.d.ts

@@ -0,0 +1,39 @@
+import * as z from "zod/v4";
+import { WebFetchEngineEnum } from "./webfetchengineenum.js";
+/**
+ * Configuration for the openrouter:web_fetch server tool
+ */
+export type WebFetchServerToolConfig = {
+    /**
+     * Only fetch from these domains.
+     */
+    allowedDomains?: Array<string> | undefined;
+    /**
+     * Never fetch from these domains.
+     */
+    blockedDomains?: Array<string> | undefined;
+    /**
+     * Which fetch engine to use. "auto" (default) uses native if the provider supports it, otherwise Exa. "native" forces the provider's built-in fetch. "exa" uses Exa Contents API (supports BYOK). "openrouter" uses direct HTTP fetch. "firecrawl" uses Firecrawl scrape (requires BYOK).
+     */
+    engine?: WebFetchEngineEnum | undefined;
+    /**
+     * Maximum content length in approximate tokens. Content exceeding this limit is truncated.
+     */
+    maxContentTokens?: number | undefined;
+    /**
+     * Maximum number of web fetches per request. Once exceeded, the tool returns an error.
+     */
+    maxUses?: number | undefined;
+};
+/** @internal */
+export type WebFetchServerToolConfig$Outbound = {
+    allowed_domains?: Array<string> | undefined;
+    blocked_domains?: Array<string> | undefined;
+    engine?: string | undefined;
+    max_content_tokens?: number | undefined;
+    max_uses?: number | undefined;
+};
+/** @internal */
+export declare const WebFetchServerToolConfig$outboundSchema: z.ZodType<WebFetchServerToolConfig$Outbound, WebFetchServerToolConfig>;
+export declare function webFetchServerToolConfigToJSON(webFetchServerToolConfig: WebFetchServerToolConfig): string;
+//# sourceMappingURL=webfetchservertoolconfig.d.ts.map

package/esm/models/webfetchservertoolconfig.js

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a65999aa9fc4
+ */
+import * as z from "zod/v4";
+import { remap as remap$ } from "../lib/primitives.js";
+import { WebFetchEngineEnum$outboundSchema, } from "./webfetchengineenum.js";
+/** @internal */
+export const WebFetchServerToolConfig$outboundSchema = z.object({
+    allowedDomains: z.array(z.string()).optional(),
+    blockedDomains: z.array(z.string()).optional(),
+    engine: WebFetchEngineEnum$outboundSchema.optional(),
+    maxContentTokens: z.int().optional(),
+    maxUses: z.int().optional(),
+}).transform((v) => {
+    return remap$(v, {
+        allowedDomains: "allowed_domains",
+        blockedDomains: "blocked_domains",
+        maxContentTokens: "max_content_tokens",
+        maxUses: "max_uses",
+    });
+});
+export function webFetchServerToolConfigToJSON(webFetchServerToolConfig) {
+    return JSON.stringify(WebFetchServerToolConfig$outboundSchema.parse(webFetchServerToolConfig));
+}
+//# sourceMappingURL=webfetchservertoolconfig.js.map

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.18",
+  "version": "0.12.19",
   "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",
-    "test:e2e": "vitest --run --project e2e",
-    "test:transit": "exit 0",
-    "typecheck": "tsc --noEmit",
-    "typecheck:transit": "exit 0",
     "compile": "tsc",
     "postinstall": "node scripts/check-types.js || true",
+    "prepare": "npm run build",
     "test": "vitest --run --project unit",
+    "test:transit": "exit 0",
     "test:watch": "vitest --watch --project unit",
-    "prepare": "npm run build"
+    "typecheck": "tsc --noEmit",
+    "test:e2e": "vitest --run --project e2e",
+    "typecheck:transit": "exit 0"
   },
   "peerDependencies": {},
   "devDependencies": {