@openrouter/sdk 1.2.124 → 1.2.126

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

package/esm/models/imagegenerationrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { ContentPartImage, ContentPartImage$Outbound } from "./contentpartimage.js";
 import { ImageGenerationProviderPreferences, ImageGenerationProviderPreferences$Outbound } from "./imagegenerationproviderpreferences.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Normalized aspect ratio of the generated image. Providers clamp to their supported subset.
  */
@@ -148,6 +149,10 @@ export type ImageGenerationRequest = {
      * If true, partial images are streamed as SSE events as they become available. Only supported by providers with native streaming (currently OpenAI). Non-streaming providers ignore this flag and return a buffered response.
      */
     stream?: boolean | 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.
+     */
+    trace?: TraceConfig | undefined;
     /**
      * A stable identifier for your end-users. Used to help detect and prevent abuse. Never sent to providers verbatim: for providers whose data policy requires user IDs, it is folded into a hashed, per-account upstream user identifier.
      */
@@ -179,6 +184,7 @@ export type ImageGenerationRequest$Outbound = {
     seed?: number | undefined;
     size?: string | undefined;
     stream?: boolean | undefined;
+    trace?: TraceConfig$Outbound | undefined;
     user?: string | undefined;
 };
 /** @internal */

package/esm/models/imagegenerationrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { ContentPartImage$outboundSchema, } from "./contentpartimage.js";
 import { ImageGenerationProviderPreferences$outboundSchema, } from "./imagegenerationproviderpreferences.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Normalized aspect ratio of the generated image. Providers clamp to their supported subset.
  */
@@ -99,6 +100,7 @@ export const ImageGenerationRequest$outboundSchema = z.object({
     seed: z.int().optional(),
     size: z.string().optional(),
     stream: z.boolean().optional(),
+    trace: TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/operations/createembeddings.d.ts

@@ -79,6 +79,10 @@ export type CreateEmbeddingsRequestBody = {
      */
     model: string;
     provider?: models.ProviderPreferences | 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.
+     */
+    trace?: models.TraceConfig | undefined;
     /**
      * A unique identifier for the end-user
      */
@@ -259,6 +263,7 @@ export type CreateEmbeddingsRequestBody$Outbound = {
     input_type?: string | undefined;
     model: string;
     provider?: models.ProviderPreferences$Outbound | null | undefined;
+    trace?: models.TraceConfig$Outbound | undefined;
     user?: string | undefined;
 };
 /** @internal */

package/esm/models/operations/createembeddings.js

@@ -100,6 +100,7 @@ export const CreateEmbeddingsRequestBody$outboundSchema = z.object({
     inputType: z.string().optional(),
     model: z.string(),
     provider: z.nullable(models.ProviderPreferences$outboundSchema).optional(),
+    trace: models.TraceConfig$outboundSchema.optional(),
     user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/operations/creatererank.d.ts

@@ -61,6 +61,14 @@ export type CreateRerankRequestBody = {
      * Number of most relevant documents to return
      */
     topN?: number | 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.
+     */
+    trace?: models.TraceConfig | undefined;
+    /**
+     * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
+     */
+    user?: string | undefined;
 };
 export type CreateRerankRequest = {
     /**
@@ -177,6 +185,8 @@ export type CreateRerankRequestBody$Outbound = {
     provider?: models.ProviderPreferences$Outbound | null | undefined;
     query: string;
     top_n?: number | undefined;
+    trace?: models.TraceConfig$Outbound | undefined;
+    user?: string | undefined;
 };
 /** @internal */
 export declare const CreateRerankRequestBody$outboundSchema: z.ZodType<CreateRerankRequestBody$Outbound, CreateRerankRequestBody>;

package/esm/models/operations/creatererank.js

@@ -27,6 +27,8 @@ export const CreateRerankRequestBody$outboundSchema = z.object({
     provider: z.nullable(models.ProviderPreferences$outboundSchema).optional(),
     query: z.string(),
     topN: z.int().optional(),
+    trace: models.TraceConfig$outboundSchema.optional(),
+    user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {
         topN: "top_n",

package/esm/models/speechrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { ProviderOptions, ProviderOptions$Outbound } from "./provideroptions.js";
 import { SpeechInputReference, SpeechInputReference$Outbound } from "./speechinputreference.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Provider-specific passthrough configuration
  */
@@ -50,6 +51,14 @@ export type SpeechRequest = {
      * Playback speed multiplier. Only used by models that support it (e.g. OpenAI TTS). Ignored by other providers.
      */
     speed?: number | 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.
+     */
+    trace?: TraceConfig | undefined;
+    /**
+     * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
+     */
+    user?: string | undefined;
     /**
      * Voice identifier (provider-specific).
      */
@@ -72,6 +81,8 @@ export type SpeechRequest$Outbound = {
     provider?: SpeechRequestProvider$Outbound | undefined;
     response_format: string;
     speed?: number | undefined;
+    trace?: TraceConfig$Outbound | undefined;
+    user?: string | undefined;
     voice?: string | undefined;
 };
 /** @internal */

package/esm/models/speechrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { ProviderOptions$outboundSchema, } from "./provideroptions.js";
 import { SpeechInputReference$outboundSchema, } from "./speechinputreference.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Audio output format
  */
@@ -31,6 +32,8 @@ export const SpeechRequest$outboundSchema = z.object({
     provider: z.lazy(() => SpeechRequestProvider$outboundSchema).optional(),
     responseFormat: SpeechRequestResponseFormat$outboundSchema.default("pcm"),
     speed: z.number().optional(),
+    trace: TraceConfig$outboundSchema.optional(),
+    user: z.string().optional(),
     voice: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {

package/esm/models/sttrequest.d.ts

@@ -3,6 +3,7 @@ import { OpenEnum } from "../types/enums.js";
 import { ProviderOptions, ProviderOptions$Outbound } from "./provideroptions.js";
 import { STTInputAudio, STTInputAudio$Outbound } from "./sttinputaudio.js";
 import { STTTimestampGranularity } from "./stttimestampgranularity.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Provider-specific passthrough configuration
  */
@@ -55,6 +56,14 @@ export type STTRequest = {
      * Timestamp detail levels to include when response_format is "verbose_json". "segment" returns segment-level timestamps; "word" additionally returns word-level timestamps in the words array. Ignored unless response_format is "verbose_json".
      */
     timestampGranularities?: Array<STTTimestampGranularity> | 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.
+     */
+    trace?: TraceConfig | undefined;
+    /**
+     * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
+     */
+    user?: string | undefined;
 };
 /** @internal */
 export type STTRequestProvider$Outbound = {
@@ -74,6 +83,8 @@ export type STTRequest$Outbound = {
     response_format?: string | undefined;
     temperature?: number | undefined;
     timestamp_granularities?: Array<string> | undefined;
+    trace?: TraceConfig$Outbound | undefined;
+    user?: string | undefined;
 };
 /** @internal */
 export declare const STTRequest$outboundSchema: z.ZodType<STTRequest$Outbound, STTRequest>;

package/esm/models/sttrequest.js

@@ -8,6 +8,7 @@ import * as openEnums from "../types/enums.js";
 import { ProviderOptions$outboundSchema, } from "./provideroptions.js";
 import { STTInputAudio$outboundSchema, } from "./sttinputaudio.js";
 import { STTTimestampGranularity$outboundSchema, } from "./stttimestampgranularity.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Output format. "json" (default) returns { text, usage }. "verbose_json" additionally returns task, language, duration, and segment-level timestamps; only supported by OpenAI-compatible providers.
  */
@@ -34,6 +35,8 @@ export const STTRequest$outboundSchema = z.object({
     temperature: z.number().optional(),
     timestampGranularities: z.array(STTTimestampGranularity$outboundSchema)
         .optional(),
+    trace: TraceConfig$outboundSchema.optional(),
+    user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {
         inputAudio: "input_audio",

package/esm/models/videogenerationrequest.d.ts

@@ -2,6 +2,7 @@ import * as z from "zod/v4";
 import { OpenEnum } from "../types/enums.js";
 import { FrameImage, FrameImage$Outbound } from "./frameimage.js";
 import { InputReference, InputReference$Outbound } from "./inputreference.js";
+import { TraceConfig, TraceConfig$Outbound } from "./traceconfig.js";
 /**
  * Aspect ratio of the generated video
  */
@@ -520,10 +521,18 @@ export type VideoGenerationRequest = {
      * Exact pixel dimensions of the generated video in "WIDTHxHEIGHT" format (e.g. "1280x720"). Interchangeable with resolution + aspect_ratio.
      */
     size?: string | 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.
+     */
+    trace?: TraceConfig | undefined;
     /**
      * Upscale factor for video upscaling models only. This parameter is not supported by video generation models.
      */
     upscaleFactor?: number | undefined;
+    /**
+     * A unique identifier representing your end-user. Forwarded to Broadcast and private logging as the end-user id; never sent to the provider.
+     */
+    user?: string | undefined;
 };
 /** @internal */
 export declare const VideoGenerationRequestAspectRatio$outboundSchema: z.ZodType<string, VideoGenerationRequestAspectRatio>;
@@ -980,7 +989,9 @@ export type VideoGenerationRequest$Outbound = {
     resolution?: string | undefined;
     seed?: number | undefined;
     size?: string | undefined;
+    trace?: TraceConfig$Outbound | undefined;
     upscale_factor?: number | undefined;
+    user?: string | undefined;
 };
 /** @internal */
 export declare const VideoGenerationRequest$outboundSchema: z.ZodType<VideoGenerationRequest$Outbound, VideoGenerationRequest>;

package/esm/models/videogenerationrequest.js

@@ -7,6 +7,7 @@ import { remap as remap$ } from "../lib/primitives.js";
 import * as openEnums from "../types/enums.js";
 import { FrameImage$outboundSchema, } from "./frameimage.js";
 import { InputReference$outboundSchema, } from "./inputreference.js";
+import { TraceConfig$outboundSchema, } from "./traceconfig.js";
 /**
  * Aspect ratio of the generated video
  */
@@ -241,7 +242,9 @@ export const VideoGenerationRequest$outboundSchema = z.object({
     resolution: VideoGenerationRequestResolution$outboundSchema.optional(),
     seed: z.int().optional(),
     size: z.string().optional(),
+    trace: TraceConfig$outboundSchema.optional(),
     upscaleFactor: z.number().optional(),
+    user: z.string().optional(),
 }).transform((v) => {
     return remap$(v, {
         aspectRatio: "aspect_ratio",

package/jsr.json

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

package/package.json

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