@openrouter/sdk 0.13.20 → 0.13.22

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.13.20";
+    readonly sdkVersion: "0.13.22";
     readonly genVersion: "2.884.4";
-    readonly userAgent: "speakeasy-sdk/typescript 0.13.20 2.884.4 1.0.0 @openrouter/sdk";
+    readonly userAgent: "speakeasy-sdk/typescript 0.13.22 2.884.4 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.13.20",
+    sdkVersion: "0.13.22",
     genVersion: "2.884.4",
-    userAgent: "speakeasy-sdk/typescript 0.13.20 2.884.4 1.0.0 @openrouter/sdk",
+    userAgent: "speakeasy-sdk/typescript 0.13.22 2.884.4 1.0.0 @openrouter/sdk",
 };
 //# sourceMappingURL=config.js.map

package/esm/models/chatcontentimage.d.ts

@@ -3,20 +3,21 @@ import { OpenEnum } from "../types/enums.js";
 import { Result as SafeParseResult } from "../types/fp.js";
 import { SDKValidationError } from "./errors/sdkvalidationerror.js";
 /**
- * Image detail level for vision models
+ * Image detail level for vision models. `original` is an OpenRouter extension (not in the OpenAI Chat Completions spec) requesting true original-resolution media; it is downgraded to `high` for providers that lack an original-resolution tier.
  */
 export declare const ChatContentImageDetail: {
     readonly Auto: "auto";
     readonly Low: "low";
     readonly High: "high";
+    readonly Original: "original";
 };
 /**
- * Image detail level for vision models
+ * Image detail level for vision models. `original` is an OpenRouter extension (not in the OpenAI Chat Completions spec) requesting true original-resolution media; it is downgraded to `high` for providers that lack an original-resolution tier.
  */
 export type ChatContentImageDetail = OpenEnum<typeof ChatContentImageDetail>;
 export type ChatContentImageImageUrl = {
     /**
-     * Image detail level for vision models
+     * Image detail level for vision models. `original` is an OpenRouter extension (not in the OpenAI Chat Completions spec) requesting true original-resolution media; it is downgraded to `high` for providers that lack an original-resolution tier.
      */
     detail?: ChatContentImageDetail | undefined;
     /**

package/esm/models/chatcontentimage.js

@@ -7,12 +7,13 @@ import { remap as remap$ } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
 import * as openEnums from "../types/enums.js";
 /**
- * Image detail level for vision models
+ * Image detail level for vision models. `original` is an OpenRouter extension (not in the OpenAI Chat Completions spec) requesting true original-resolution media; it is downgraded to `high` for providers that lack an original-resolution tier.
  */
 export const ChatContentImageDetail = {
     Auto: "auto",
     Low: "low",
     High: "high",
+    Original: "original",
 };
 /** @internal */
 export const ChatContentImageDetail$inboundSchema = openEnums.inboundSchema(ChatContentImageDetail);

package/esm/models/chatfunctiontool.d.ts

@@ -6,6 +6,7 @@ import { ChatContentCacheControl, ChatContentCacheControl$Outbound } from "./cha
 import { ChatSearchModelsServerTool, ChatSearchModelsServerTool$Outbound } from "./chatsearchmodelsservertool.js";
 import { ChatWebSearchShorthand, ChatWebSearchShorthand$Outbound } from "./chatwebsearchshorthand.js";
 import { DatetimeServerTool, DatetimeServerTool$Outbound } from "./datetimeservertool.js";
+import { FilesServerTool, FilesServerTool$Outbound } from "./filesservertool.js";
 import { ImageGenerationServerToolOpenRouter, ImageGenerationServerToolOpenRouter$Outbound } from "./imagegenerationservertoolopenrouter.js";
 import { OpenRouterWebSearchServerTool, OpenRouterWebSearchServerTool$Outbound } from "./openrouterwebsearchservertool.js";
 import { SubagentServerToolOpenRouter, SubagentServerToolOpenRouter$Outbound } from "./subagentservertoolopenrouter.js";
@@ -51,7 +52,7 @@ export type ChatFunctionToolFunction = {
 /**
  * Tool definition for function calling (regular function or OpenRouter built-in server tool)
  */
-export type ChatFunctionTool = ChatFunctionToolFunction | AdvisorServerToolOpenRouter | BashServerTool | DatetimeServerTool | ImageGenerationServerToolOpenRouter | ChatSearchModelsServerTool | SubagentServerToolOpenRouter | WebFetchServerTool | OpenRouterWebSearchServerTool | ChatWebSearchShorthand;
+export type ChatFunctionTool = ChatFunctionToolFunction | AdvisorServerToolOpenRouter | BashServerTool | DatetimeServerTool | FilesServerTool | ImageGenerationServerToolOpenRouter | ChatSearchModelsServerTool | SubagentServerToolOpenRouter | WebFetchServerTool | OpenRouterWebSearchServerTool | ChatWebSearchShorthand;
 /** @internal */
 export type ChatFunctionToolFunctionFunction$Outbound = {
     description?: string | undefined;
@@ -76,7 +77,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 | AdvisorServerToolOpenRouter$Outbound | BashServerTool$Outbound | DatetimeServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | ChatSearchModelsServerTool$Outbound | SubagentServerToolOpenRouter$Outbound | WebFetchServerTool$Outbound | OpenRouterWebSearchServerTool$Outbound | ChatWebSearchShorthand$Outbound;
+export type ChatFunctionTool$Outbound = ChatFunctionToolFunction$Outbound | AdvisorServerToolOpenRouter$Outbound | BashServerTool$Outbound | DatetimeServerTool$Outbound | FilesServerTool$Outbound | ImageGenerationServerToolOpenRouter$Outbound | ChatSearchModelsServerTool$Outbound | SubagentServerToolOpenRouter$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 { ChatContentCacheControl$outboundSchema, } from "./chatcontentcachecontr
 import { ChatSearchModelsServerTool$outboundSchema, } from "./chatsearchmodelsservertool.js";
 import { ChatWebSearchShorthand$outboundSchema, } from "./chatwebsearchshorthand.js";
 import { DatetimeServerTool$outboundSchema, } from "./datetimeservertool.js";
+import { FilesServerTool$outboundSchema, } from "./filesservertool.js";
 import { ImageGenerationServerToolOpenRouter$outboundSchema, } from "./imagegenerationservertoolopenrouter.js";
 import { OpenRouterWebSearchServerTool$outboundSchema, } from "./openrouterwebsearchservertool.js";
 import { SubagentServerToolOpenRouter$outboundSchema, } from "./subagentservertoolopenrouter.js";
@@ -48,6 +49,7 @@ export const ChatFunctionTool$outboundSchema = z.union([
     AdvisorServerToolOpenRouter$outboundSchema,
     BashServerTool$outboundSchema,
     DatetimeServerTool$outboundSchema,
+    FilesServerTool$outboundSchema,
     ImageGenerationServerToolOpenRouter$outboundSchema,
     ChatSearchModelsServerTool$outboundSchema,
     SubagentServerToolOpenRouter$outboundSchema,

package/esm/models/filesservertool.d.ts

@@ -0,0 +1,28 @@
+import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
+import { FilesServerToolConfig, FilesServerToolConfig$Outbound } from "./filesservertoolconfig.js";
+export declare const FilesServerToolType: {
+    readonly OpenrouterFiles: "openrouter:files";
+};
+export type FilesServerToolType = ClosedEnum<typeof FilesServerToolType>;
+/**
+ * OpenRouter built-in server tool: read, write, edit, and list workspace files via the Files API. Requires the `x-openrouter-file-ids: openrouter` request header.
+ */
+export type FilesServerTool = {
+    /**
+     * Configuration for the openrouter:files server tool
+     */
+    parameters?: FilesServerToolConfig | undefined;
+    type: FilesServerToolType;
+};
+/** @internal */
+export declare const FilesServerToolType$outboundSchema: z.ZodEnum<typeof FilesServerToolType>;
+/** @internal */
+export type FilesServerTool$Outbound = {
+    parameters?: FilesServerToolConfig$Outbound | undefined;
+    type: string;
+};
+/** @internal */
+export declare const FilesServerTool$outboundSchema: z.ZodType<FilesServerTool$Outbound, FilesServerTool>;
+export declare function filesServerToolToJSON(filesServerTool: FilesServerTool): string;
+//# sourceMappingURL=filesservertool.d.ts.map

package/esm/models/filesservertool.js

@@ -0,0 +1,20 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 3e85b948793d
+ */
+import * as z from "zod/v4";
+import { FilesServerToolConfig$outboundSchema, } from "./filesservertoolconfig.js";
+export const FilesServerToolType = {
+    OpenrouterFiles: "openrouter:files",
+};
+/** @internal */
+export const FilesServerToolType$outboundSchema = z.enum(FilesServerToolType);
+/** @internal */
+export const FilesServerTool$outboundSchema = z.object({
+    parameters: FilesServerToolConfig$outboundSchema.optional(),
+    type: FilesServerToolType$outboundSchema,
+});
+export function filesServerToolToJSON(filesServerTool) {
+    return JSON.stringify(FilesServerTool$outboundSchema.parse(filesServerTool));
+}
+//# sourceMappingURL=filesservertool.js.map

package/esm/models/filesservertoolconfig.d.ts

@@ -0,0 +1,11 @@
+import * as z from "zod/v4";
+/**
+ * Configuration for the openrouter:files server tool
+ */
+export type FilesServerToolConfig = {};
+/** @internal */
+export type FilesServerToolConfig$Outbound = {};
+/** @internal */
+export declare const FilesServerToolConfig$outboundSchema: z.ZodType<FilesServerToolConfig$Outbound, FilesServerToolConfig>;
+export declare function filesServerToolConfigToJSON(filesServerToolConfig: FilesServerToolConfig): string;
+//# sourceMappingURL=filesservertoolconfig.d.ts.map

package/esm/models/filesservertoolconfig.js

@@ -0,0 +1,11 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 9e169d1b0b62
+ */
+import * as z from "zod/v4";
+/** @internal */
+export const FilesServerToolConfig$outboundSchema = z.object({});
+export function filesServerToolConfigToJSON(filesServerToolConfig) {
+    return JSON.stringify(FilesServerToolConfig$outboundSchema.parse(filesServerToolConfig));
+}
+//# sourceMappingURL=filesservertoolconfig.js.map

package/esm/models/index.d.ts

@@ -187,6 +187,8 @@ export * from "./filemetadata.js";
 export * from "./fileparserplugin.js";
 export * from "./filepath.js";
 export * from "./filesearchservertool.js";
+export * from "./filesservertool.js";
+export * from "./filesservertoolconfig.js";
 export * from "./forbiddenresponseerrordata.js";
 export * from "./formatjsonobjectconfig.js";
 export * from "./formatjsonschemaconfig.js";

package/esm/models/index.js

@@ -191,6 +191,8 @@ export * from "./filemetadata.js";
 export * from "./fileparserplugin.js";
 export * from "./filepath.js";
 export * from "./filesearchservertool.js";
+export * from "./filesservertool.js";
+export * from "./filesservertoolconfig.js";
 export * from "./forbiddenresponseerrordata.js";
 export * from "./formatjsonobjectconfig.js";
 export * from "./formatjsonschemaconfig.js";

package/esm/models/responsesrequest.d.ts

@@ -16,6 +16,7 @@ import { CustomTool, CustomTool$Outbound } from "./customtool.js";
 import { DatetimeServerTool, DatetimeServerTool$Outbound } from "./datetimeservertool.js";
 import { FileParserPlugin, FileParserPlugin$Outbound } from "./fileparserplugin.js";
 import { FileSearchServerTool, FileSearchServerTool$Outbound } from "./filesearchservertool.js";
+import { FilesServerTool, FilesServerTool$Outbound } from "./filesservertool.js";
 import { FusionPlugin, FusionPlugin$Outbound } from "./fusionplugin.js";
 import { FusionServerToolOpenRouter, FusionServerToolOpenRouter$Outbound } from "./fusionservertoolopenrouter.js";
 import { ImageConfig, ImageConfig$Outbound } from "./imageconfig.js";
@@ -74,6 +75,8 @@ export type ResponsesRequestToolUnion = ResponsesRequestToolFunction | PreviewWe
     type: "openrouter:subagent";
 }) | (DatetimeServerTool & {
     type: "openrouter:datetime";
+}) | (FilesServerTool & {
+    type: "openrouter:files";
 }) | FusionServerToolOpenRouter | (ImageGenerationServerToolOpenRouter & {
     type: "openrouter:image_generation";
 }) | (ChatSearchModelsServerTool & {
@@ -164,6 +167,8 @@ export type ResponsesRequest = {
         type: "openrouter:subagent";
     }) | (DatetimeServerTool & {
         type: "openrouter:datetime";
+    }) | (FilesServerTool & {
+        type: "openrouter:files";
     }) | FusionServerToolOpenRouter | (ImageGenerationServerToolOpenRouter & {
         type: "openrouter:image_generation";
     }) | (ChatSearchModelsServerTool & {
@@ -213,6 +218,8 @@ export type ResponsesRequestToolUnion$Outbound = ResponsesRequestToolFunction$Ou
     type: "openrouter:subagent";
 }) | (DatetimeServerTool$Outbound & {
     type: "openrouter:datetime";
+}) | (FilesServerTool$Outbound & {
+    type: "openrouter:files";
 }) | FusionServerToolOpenRouter$Outbound | (ImageGenerationServerToolOpenRouter$Outbound & {
     type: "openrouter:image_generation";
 }) | (ChatSearchModelsServerTool$Outbound & {
@@ -268,6 +275,8 @@ export type ResponsesRequest$Outbound = {
         type: "openrouter:subagent";
     }) | (DatetimeServerTool$Outbound & {
         type: "openrouter:datetime";
+    }) | (FilesServerTool$Outbound & {
+        type: "openrouter:files";
     }) | FusionServerToolOpenRouter$Outbound | (ImageGenerationServerToolOpenRouter$Outbound & {
         type: "openrouter:image_generation";
     }) | (ChatSearchModelsServerTool$Outbound & {

package/esm/models/responsesrequest.js

@@ -21,6 +21,7 @@ import { CustomTool$outboundSchema, } from "./customtool.js";
 import { DatetimeServerTool$outboundSchema, } from "./datetimeservertool.js";
 import { FileParserPlugin$outboundSchema, } from "./fileparserplugin.js";
 import { FileSearchServerTool$outboundSchema, } from "./filesearchservertool.js";
+import { FilesServerTool$outboundSchema, } from "./filesservertool.js";
 import { FusionPlugin$outboundSchema, } from "./fusionplugin.js";
 import { FusionServerToolOpenRouter$outboundSchema, } from "./fusionservertoolopenrouter.js";
 import { ImageConfig$outboundSchema, } from "./imageconfig.js";
@@ -106,6 +107,7 @@ export const ResponsesRequestToolUnion$outboundSchema = z.union([
     AdvisorServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:advisor") })),
     SubagentServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:subagent") })),
     DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
+    FilesServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:files") })),
     FusionServerToolOpenRouter$outboundSchema,
     ImageGenerationServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:image_generation") })),
     ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),
@@ -180,6 +182,7 @@ export const ResponsesRequest$outboundSchema = z.object({
         AdvisorServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:advisor") })),
         SubagentServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:subagent") })),
         DatetimeServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:datetime") })),
+        FilesServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:files") })),
         FusionServerToolOpenRouter$outboundSchema,
         ImageGenerationServerToolOpenRouter$outboundSchema.and(z.object({ type: z.literal("openrouter:image_generation") })),
         ChatSearchModelsServerTool$outboundSchema.and(z.object({ type: z.literal("openrouter:experimental__search_models") })),

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.13.20",
+  "version": "0.13.22",
   "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": {
-    "access": "public",
-    "provenance": true
+    "provenance": true,
+    "access": "public"
   },
   "type": "module",
   "main": "./esm/index.js",
@@ -73,15 +73,15 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test:e2e": "vitest --run --project e2e",
-    "test:watch": "vitest --watch --project unit",
+    "postinstall": "node scripts/check-types.js || true",
     "prepare": "npm run build",
-    "test:transit": "exit 0",
-    "typecheck": "tsc --noEmit",
+    "test:watch": "vitest --watch --project unit",
     "typecheck:transit": "exit 0",
     "compile": "tsc",
-    "postinstall": "node scripts/check-types.js || true",
-    "test": "vitest --run --project unit"
+    "test": "vitest --run --project unit",
+    "test:e2e": "vitest --run --project e2e",
+    "test:transit": "exit 0",
+    "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {},
   "devDependencies": {