@openrouter/sdk 0.12.20 → 0.12.22

package/esm/models/usage.d.ts

@@ -7,7 +7,7 @@ export type InputTokensDetails = {
 export type OutputTokensDetails = {
     reasoningTokens: number;
 };
-export type CostDetails = {
+export type UsageCostDetails = {
     upstreamInferenceCost?: number | null | undefined;
     upstreamInferenceInputCost: number;
     upstreamInferenceOutputCost: number;
@@ -25,7 +25,7 @@ export type Usage = {
      * Cost of the completion
      */
     cost?: number | null | undefined;
-    costDetails?: CostDetails | undefined;
+    costDetails?: UsageCostDetails | undefined;
     /**
      * Whether a request was made using a Bring Your Own Key configuration
      */
@@ -38,8 +38,8 @@ export declare function inputTokensDetailsFromJSON(jsonString: string): SafePars
 export declare const OutputTokensDetails$inboundSchema: z.ZodType<OutputTokensDetails, unknown>;
 export declare function outputTokensDetailsFromJSON(jsonString: string): SafeParseResult<OutputTokensDetails, SDKValidationError>;
 /** @internal */
-export declare const CostDetails$inboundSchema: z.ZodType<CostDetails, unknown>;
-export declare function costDetailsFromJSON(jsonString: string): SafeParseResult<CostDetails, SDKValidationError>;
+export declare const UsageCostDetails$inboundSchema: z.ZodType<UsageCostDetails, unknown>;
+export declare function usageCostDetailsFromJSON(jsonString: string): SafeParseResult<UsageCostDetails, SDKValidationError>;
 /** @internal */
 export declare const Usage$inboundSchema: z.ZodType<Usage, unknown>;
 export declare function usageFromJSON(jsonString: string): SafeParseResult<Usage, SDKValidationError>;

package/esm/models/usage.js

@@ -28,8 +28,7 @@ export function outputTokensDetailsFromJSON(jsonString) {
     return safeParse(jsonString, (x) => OutputTokensDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'OutputTokensDetails' from JSON`);
 }
 /** @internal */
-export const CostDetails$inboundSchema = z
-    .object({
+export const UsageCostDetails$inboundSchema = z.object({
     upstream_inference_cost: z.nullable(z.number()).optional(),
     upstream_inference_input_cost: z.number(),
     upstream_inference_output_cost: z.number(),
@@ -40,8 +39,8 @@ export const CostDetails$inboundSchema = z
         "upstream_inference_output_cost": "upstreamInferenceOutputCost",
     });
 });
-export function costDetailsFromJSON(jsonString) {
-    return safeParse(jsonString, (x) => CostDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'CostDetails' from JSON`);
+export function usageCostDetailsFromJSON(jsonString) {
+    return safeParse(jsonString, (x) => UsageCostDetails$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'UsageCostDetails' from JSON`);
 }
 /** @internal */
 export const Usage$inboundSchema = z.object({
@@ -51,7 +50,7 @@ export const Usage$inboundSchema = z.object({
     output_tokens_details: z.lazy(() => OutputTokensDetails$inboundSchema),
     total_tokens: z.int(),
     cost: z.nullable(z.number()).optional(),
-    cost_details: z.lazy(() => CostDetails$inboundSchema).optional(),
+    cost_details: z.lazy(() => UsageCostDetails$inboundSchema).optional(),
     is_byok: z.boolean().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/videogenerationrequest.d.ts

@@ -268,6 +268,9 @@ export type VideoGenerationRequestOptions = {
     phala?: {
         [k: string]: any | null;
     } | undefined;
+    poolside?: {
+        [k: string]: any | null;
+    } | undefined;
     recraft?: {
         [k: string]: any | null;
     } | undefined;
@@ -376,6 +379,10 @@ export type VideoGenerationRequest = {
      * Aspect ratio of the generated video
      */
     aspectRatio?: AspectRatio | undefined;
+    /**
+     * URL to receive a webhook notification when the video generation job completes. Overrides the workspace-level default callback URL if set. Must be HTTPS.
+     */
+    callbackUrl?: string | undefined;
     /**
      * Duration of the generated video in seconds
      */
@@ -661,6 +668,9 @@ export type VideoGenerationRequestOptions$Outbound = {
     phala?: {
         [k: string]: any | null;
     } | undefined;
+    poolside?: {
+        [k: string]: any | null;
+    } | undefined;
     recraft?: {
         [k: string]: any | null;
     } | undefined;
@@ -755,6 +765,7 @@ export declare const Resolution$outboundSchema: z.ZodType<string, Resolution>;
 /** @internal */
 export type VideoGenerationRequest$Outbound = {
     aspect_ratio?: string | undefined;
+    callback_url?: string | undefined;
     duration?: number | undefined;
     frame_images?: Array<FrameImage$Outbound> | undefined;
     generate_audio?: boolean | undefined;

package/esm/models/videogenerationrequest.js

@@ -116,6 +116,7 @@ export const VideoGenerationRequestOptions$outboundSchema = z.object({
     parasail: z.record(z.string(), z.nullable(z.any())).optional(),
     perplexity: z.record(z.string(), z.nullable(z.any())).optional(),
     phala: z.record(z.string(), z.nullable(z.any())).optional(),
+    poolside: z.record(z.string(), z.nullable(z.any())).optional(),
     recraft: z.record(z.string(), z.nullable(z.any())).optional(),
     recursal: z.record(z.string(), z.nullable(z.any())).optional(),
     reflection: z.record(z.string(), z.nullable(z.any())).optional(),
@@ -183,6 +184,7 @@ export const Resolution$outboundSchema = openEnums.outboundSchema(Resolution);
 /** @internal */
 export const VideoGenerationRequest$outboundSchema = z.object({
     aspectRatio: AspectRatio$outboundSchema.optional(),
+    callbackUrl: z.string().optional(),
     duration: z.int().optional(),
     frameImages: z.array(FrameImage$outboundSchema).optional(),
     generateAudio: z.boolean().optional(),
@@ -197,6 +199,7 @@ export const VideoGenerationRequest$outboundSchema = z.object({
 }).transform((v) => {
     return remap$(v, {
         aspectRatio: "aspect_ratio",
+        callbackUrl: "callback_url",
         frameImages: "frame_images",
         generateAudio: "generate_audio",
         inputReferences: "input_references",

package/esm/models/websearchplugin.d.ts

@@ -1,5 +1,20 @@
 import * as z from "zod/v4";
+import { ClosedEnum } from "../types/enums.js";
 import { WebSearchEngine } from "./websearchengine.js";
+export declare const WebSearchPluginType: {
+    readonly Approximate: "approximate";
+};
+export type WebSearchPluginType = ClosedEnum<typeof WebSearchPluginType>;
+/**
+ * Approximate user location for location-biased search results. Passed through to native providers that support it (e.g. Anthropic).
+ */
+export type UserLocation = {
+    city?: string | null | undefined;
+    country?: string | null | undefined;
+    region?: string | null | undefined;
+    timezone?: string | null | undefined;
+    type: WebSearchPluginType;
+};
 export type WebSearchPlugin = {
     /**
      * Set to false to disable the web-search plugin for this request. Defaults to true.
@@ -19,9 +34,27 @@ export type WebSearchPlugin = {
      */
     includeDomains?: Array<string> | undefined;
     maxResults?: number | undefined;
+    /**
+     * Maximum number of times the model can invoke web search in a single turn. Passed through to native providers that support it (e.g. Anthropic).
+     */
+    maxUses?: number | undefined;
     searchPrompt?: string | undefined;
+    userLocation?: UserLocation | null | undefined;
 };
 /** @internal */
+export declare const WebSearchPluginType$outboundSchema: z.ZodEnum<typeof WebSearchPluginType>;
+/** @internal */
+export type UserLocation$Outbound = {
+    city?: string | null | undefined;
+    country?: string | null | undefined;
+    region?: string | null | undefined;
+    timezone?: string | null | undefined;
+    type: string;
+};
+/** @internal */
+export declare const UserLocation$outboundSchema: z.ZodType<UserLocation$Outbound, UserLocation>;
+export declare function userLocationToJSON(userLocation: UserLocation): string;
+/** @internal */
 export type WebSearchPlugin$Outbound = {
     enabled?: boolean | undefined;
     engine?: string | undefined;
@@ -29,7 +62,9 @@ export type WebSearchPlugin$Outbound = {
     id: "web";
     include_domains?: Array<string> | undefined;
     max_results?: number | undefined;
+    max_uses?: number | undefined;
     search_prompt?: string | undefined;
+    user_location?: UserLocation$Outbound | null | undefined;
 };
 /** @internal */
 export declare const WebSearchPlugin$outboundSchema: z.ZodType<WebSearchPlugin$Outbound, WebSearchPlugin>;

package/esm/models/websearchplugin.js

@@ -5,6 +5,22 @@
 import * as z from "zod/v4";
 import { remap as remap$ } from "../lib/primitives.js";
 import { WebSearchEngine$outboundSchema, } from "./websearchengine.js";
+export const WebSearchPluginType = {
+    Approximate: "approximate",
+};
+/** @internal */
+export const WebSearchPluginType$outboundSchema = z.enum(WebSearchPluginType);
+/** @internal */
+export const UserLocation$outboundSchema = z.object({
+    city: z.nullable(z.string()).optional(),
+    country: z.nullable(z.string()).optional(),
+    region: z.nullable(z.string()).optional(),
+    timezone: z.nullable(z.string()).optional(),
+    type: WebSearchPluginType$outboundSchema,
+});
+export function userLocationToJSON(userLocation) {
+    return JSON.stringify(UserLocation$outboundSchema.parse(userLocation));
+}
 /** @internal */
 export const WebSearchPlugin$outboundSchema = z.object({
     enabled: z.boolean().optional(),
@@ -13,13 +29,18 @@ export const WebSearchPlugin$outboundSchema = z.object({
     id: z.literal("web"),
     includeDomains: z.array(z.string()).optional(),
     maxResults: z.int().optional(),
+    maxUses: z.int().optional(),
     searchPrompt: z.string().optional(),
+    userLocation: z.nullable(z.lazy(() => UserLocation$outboundSchema))
+        .optional(),
 }).transform((v) => {
     return remap$(v, {
         excludeDomains: "exclude_domains",
         includeDomains: "include_domains",
         maxResults: "max_results",
+        maxUses: "max_uses",
         searchPrompt: "search_prompt",
+        userLocation: "user_location",
     });
 });
 export function webSearchPluginToJSON(webSearchPlugin) {

package/esm/models/websearchuserlocationservertool.d.ts

@@ -8,20 +8,20 @@ export type WebSearchUserLocationServerToolType = ClosedEnum<typeof WebSearchUse
  * Approximate user location for location-biased results.
  */
 export type WebSearchUserLocationServerTool = {
-    city?: string | undefined;
-    country?: string | undefined;
-    region?: string | undefined;
-    timezone?: string | undefined;
+    city?: string | null | undefined;
+    country?: string | null | undefined;
+    region?: string | null | undefined;
+    timezone?: string | null | undefined;
     type?: WebSearchUserLocationServerToolType | undefined;
 };
 /** @internal */
 export declare const WebSearchUserLocationServerToolType$outboundSchema: z.ZodEnum<typeof WebSearchUserLocationServerToolType>;
 /** @internal */
 export type WebSearchUserLocationServerTool$Outbound = {
-    city?: string | undefined;
-    country?: string | undefined;
-    region?: string | undefined;
-    timezone?: string | undefined;
+    city?: string | null | undefined;
+    country?: string | null | undefined;
+    region?: string | null | undefined;
+    timezone?: string | null | undefined;
     type?: string | undefined;
 };
 /** @internal */

package/esm/models/websearchuserlocationservertool.js

@@ -10,10 +10,10 @@ export const WebSearchUserLocationServerToolType = {
 export const WebSearchUserLocationServerToolType$outboundSchema = z.enum(WebSearchUserLocationServerToolType);
 /** @internal */
 export const WebSearchUserLocationServerTool$outboundSchema = z.object({
-    city: z.string().optional(),
-    country: z.string().optional(),
-    region: z.string().optional(),
-    timezone: z.string().optional(),
+    city: z.nullable(z.string()).optional(),
+    country: z.nullable(z.string()).optional(),
+    region: z.nullable(z.string()).optional(),
+    timezone: z.nullable(z.string()).optional(),
     type: WebSearchUserLocationServerToolType$outboundSchema.optional(),
 });
 export function webSearchUserLocationServerToolToJSON(webSearchUserLocationServerTool) {

package/esm/models/workspace.d.ts

@@ -30,6 +30,14 @@ export type Workspace = {
      * Unique identifier for the workspace
      */
     id: string;
+    /**
+     * Optional array of API key IDs to filter I/O logging. Null means all keys are logged.
+     */
+    ioLoggingApiKeyIds: Array<number> | null;
+    /**
+     * Sampling rate for I/O logging (0.0001-1). 1 means 100% of requests are logged.
+     */
+    ioLoggingSamplingRate: number;
     /**
      * Whether data discount logging is enabled for this workspace
      */

package/esm/models/workspace.js

@@ -14,6 +14,8 @@ export const Workspace$inboundSchema = z.object({
     default_text_model: z.nullable(z.string()),
     description: z.nullable(z.string()),
     id: z.string(),
+    io_logging_api_key_ids: z.nullable(z.array(z.int())),
+    io_logging_sampling_rate: z.number(),
     is_data_discount_logging_enabled: z.boolean(),
     is_observability_broadcast_enabled: z.boolean(),
     is_observability_io_logging_enabled: z.boolean(),
@@ -27,6 +29,8 @@ export const Workspace$inboundSchema = z.object({
         "default_image_model": "defaultImageModel",
         "default_provider_sort": "defaultProviderSort",
         "default_text_model": "defaultTextModel",
+        "io_logging_api_key_ids": "ioLoggingApiKeyIds",
+        "io_logging_sampling_rate": "ioLoggingSamplingRate",
         "is_data_discount_logging_enabled": "isDataDiscountLoggingEnabled",
         "is_observability_broadcast_enabled": "isObservabilityBroadcastEnabled",
         "is_observability_io_logging_enabled": "isObservabilityIoLoggingEnabled",

package/jsr.json

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrouter/sdk",
-  "version": "0.12.20",
+  "version": "0.12.22",
   "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,14 +69,14 @@
     "lint": "eslint --cache --max-warnings=0 src",
     "build": "tsc",
     "prepublishOnly": "npm run build",
-    "test:transit": "exit 0",
-    "compile": "tsc",
+    "typecheck": "tsc --noEmit",
     "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",
-    "typecheck": "tsc --noEmit",
     "typecheck:transit": "exit 0",
+    "compile": "tsc",
+    "test": "vitest --run --project unit",
     "test:e2e": "vitest --run --project e2e"
   },
   "peerDependencies": {},