@openrouter/ai-sdk-provider 1.2.7 → 1.3.0

package/dist/internal/index.d.mts

@@ -91,7 +91,7 @@ type OpenRouterUsageAccounting = {
     };
     totalTokens: number;
     cost?: number;
-    costDetails: {
+    costDetails?: {
         upstreamInferenceCost: number;
     };
 };
@@ -224,6 +224,19 @@ type OpenRouterChatSettings = {
          */
         search_prompt?: string;
     };
+    /**
+     * Debug options for troubleshooting API requests.
+     * Only works with streaming requests.
+     * @see https://openrouter.ai/docs/api-reference/debugging
+     */
+    debug?: {
+        /**
+         * When true, echoes back the request body that was sent to the upstream provider.
+         * The debug data will be returned as the first chunk in the stream with a `debug.echo_upstream_body` field.
+         * Sensitive data like user IDs and base64 content will be redacted.
+         */
+        echo_upstream_body?: boolean;
+    };
     /**
      * Provider routing preferences to control request routing behavior
      */
@@ -259,7 +272,7 @@ type OpenRouterChatSettings = {
         /**
          * Sort providers by price, throughput, or latency
          */
-        sort?: models.Sort;
+        sort?: models.ProviderSort;
         /**
          * Maximum pricing you want to pay for this request
          */

package/dist/internal/index.d.ts

@@ -91,7 +91,7 @@ type OpenRouterUsageAccounting = {
     };
     totalTokens: number;
     cost?: number;
-    costDetails: {
+    costDetails?: {
         upstreamInferenceCost: number;
     };
 };
@@ -224,6 +224,19 @@ type OpenRouterChatSettings = {
          */
         search_prompt?: string;
     };
+    /**
+     * Debug options for troubleshooting API requests.
+     * Only works with streaming requests.
+     * @see https://openrouter.ai/docs/api-reference/debugging
+     */
+    debug?: {
+        /**
+         * When true, echoes back the request body that was sent to the upstream provider.
+         * The debug data will be returned as the first chunk in the stream with a `debug.echo_upstream_body` field.
+         * Sensitive data like user IDs and base64 content will be redacted.
+         */
+        echo_upstream_body?: boolean;
+    };
     /**
      * Provider routing preferences to control request routing behavior
      */
@@ -259,7 +272,7 @@ type OpenRouterChatSettings = {
         /**
          * Sort providers by price, throughput, or latency
          */
-        sort?: models.Sort;
+        sort?: models.ProviderSort;
         /**
          * Maximum pricing you want to pay for this request
          */

package/dist/internal/index.js

@@ -904,9 +904,9 @@ var ReasoningFormat = /* @__PURE__ */ ((ReasoningFormat2) => {
 // src/schemas/reasoning-details.ts
 var CommonReasoningDetailSchema = import_v4.z.object({
   id: import_v4.z.string().nullish(),
-  format: import_v4.z.nativeEnum(ReasoningFormat).nullish(),
+  format: import_v4.z.enum(ReasoningFormat).nullish(),
   index: import_v4.z.number().optional()
-}).passthrough();
+}).loose();
 var ReasoningDetailSummarySchema = import_v4.z.object({
   type: import_v4.z.literal("reasoning.summary" /* Summary */),
   summary: import_v4.z.string()
@@ -984,7 +984,7 @@ var OpenRouterProviderMetadataSchema = import_v43.z.object({
     cost: import_v43.z.number().optional(),
     costDetails: import_v43.z.object({
       upstreamInferenceCost: import_v43.z.number()
-    }).passthrough()
+    }).passthrough().optional()
   }).passthrough()
 }).passthrough();
 var OpenRouterProviderOptionsSchema = import_v43.z.object({
@@ -1103,9 +1103,8 @@ function getCacheControl(providerMetadata) {
   return (_c = (_b = (_a15 = openrouter == null ? void 0 : openrouter.cacheControl) != null ? _a15 : openrouter == null ? void 0 : openrouter.cache_control) != null ? _b : anthropic == null ? void 0 : anthropic.cacheControl) != null ? _c : anthropic == null ? void 0 : anthropic.cache_control;
 }
 function convertToOpenRouterChatMessages(prompt) {
-  var _a15, _b, _c, _d, _e, _f;
+  var _a15, _b, _c, _d, _e, _f, _g, _h;
   const messages = [];
-  const accumulatedReasoningDetails = [];
   for (const { role, content, providerOptions } of prompt) {
     switch (role) {
       case "system": {
@@ -1135,7 +1134,7 @@ function convertToOpenRouterChatMessages(prompt) {
         const messageCacheControl = getCacheControl(providerOptions);
         const contentParts = content.map(
           (part) => {
-            var _a16, _b2, _c2, _d2, _e2, _f2, _g;
+            var _a16, _b2, _c2, _d2, _e2, _f2, _g2;
             const cacheControl = (_a16 = getCacheControl(part.providerOptions)) != null ? _a16 : messageCacheControl;
             switch (part.type) {
               case "text":
@@ -1168,7 +1167,7 @@ function convertToOpenRouterChatMessages(prompt) {
                   };
                 }
                 const fileName = String(
-                  (_g = (_f2 = (_e2 = (_d2 = part.providerOptions) == null ? void 0 : _d2.openrouter) == null ? void 0 : _e2.filename) != null ? _f2 : part.filename) != null ? _g : ""
+                  (_g2 = (_f2 = (_e2 = (_d2 = part.providerOptions) == null ? void 0 : _d2.openrouter) == null ? void 0 : _e2.filename) != null ? _f2 : part.filename) != null ? _g2 : ""
                 );
                 const fileData = getFileUrl({
                   part,
@@ -1215,6 +1214,7 @@ function convertToOpenRouterChatMessages(prompt) {
         let text = "";
         let reasoning = "";
         const toolCalls = [];
+        const accumulatedReasoningDetails = [];
         for (const part of content) {
           switch (part.type) {
             case "text": {
@@ -1240,6 +1240,12 @@ function convertToOpenRouterChatMessages(prompt) {
             }
             case "reasoning": {
               reasoning += part.text;
+              const parsedPartProviderOptions = OpenRouterProviderOptionsSchema.safeParse(part.providerOptions);
+              if (parsedPartProviderOptions.success && ((_e = (_d = parsedPartProviderOptions.data) == null ? void 0 : _d.openrouter) == null ? void 0 : _e.reasoning_details)) {
+                accumulatedReasoningDetails.push(
+                  ...parsedPartProviderOptions.data.openrouter.reasoning_details
+                );
+              }
               break;
             }
             case "file":
@@ -1250,7 +1256,7 @@ function convertToOpenRouterChatMessages(prompt) {
           }
         }
         const parsedProviderOptions = OpenRouterProviderOptionsSchema.safeParse(providerOptions);
-        const messageReasoningDetails = parsedProviderOptions.success ? (_e = (_d = parsedProviderOptions.data) == null ? void 0 : _d.openrouter) == null ? void 0 : _e.reasoning_details : void 0;
+        const messageReasoningDetails = parsedProviderOptions.success ? (_g = (_f = parsedProviderOptions.data) == null ? void 0 : _f.openrouter) == null ? void 0 : _g.reasoning_details : void 0;
         const finalReasoningDetails = messageReasoningDetails && Array.isArray(messageReasoningDetails) && messageReasoningDetails.length > 0 ? messageReasoningDetails : accumulatedReasoningDetails.length > 0 ? accumulatedReasoningDetails : void 0;
         messages.push({
           role: "assistant",
@@ -1269,7 +1275,7 @@ function convertToOpenRouterChatMessages(prompt) {
             role: "tool",
             tool_call_id: toolResponse.toolCallId,
             content: content2,
-            cache_control: (_f = getCacheControl(providerOptions)) != null ? _f : getCacheControl(toolResponse.providerOptions)
+            cache_control: (_h = getCacheControl(providerOptions)) != null ? _h : getCacheControl(toolResponse.providerOptions)
           });
         }
         break;
@@ -1585,7 +1591,9 @@ var OpenRouterChatLanguageModel = class {
       plugins: this.settings.plugins,
       web_search_options: this.settings.web_search_options,
       // Provider routing settings:
-      provider: this.settings.provider
+      provider: this.settings.provider,
+      // Debug settings:
+      debug: this.settings.debug
     }, this.config.extraBody), this.settings.extraBody);
     if ((responseFormat == null ? void 0 : responseFormat.type) === "json" && responseFormat.schema != null) {
       return __spreadProps(__spreadValues({}, baseArgs), {
@@ -1620,7 +1628,7 @@ var OpenRouterChatLanguageModel = class {
     return baseArgs;
   }
   async doGenerate(options) {
-    var _a15, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y;
+    var _a15, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o, _p, _q, _r, _s, _t, _u, _v;
     const providerOptions = options.providerOptions || {};
     const openrouterOptions = providerOptions.openrouter || {};
     const args = __spreadValues(__spreadValues({}, this.getArgs(options)), openrouterOptions);
@@ -1787,21 +1795,24 @@ var OpenRouterChatLanguageModel = class {
         openrouter: OpenRouterProviderMetadataSchema.parse({
           provider: (_k = response.provider) != null ? _k : "",
           reasoning_details: (_l = choice.message.reasoning_details) != null ? _l : [],
-          usage: {
+          usage: __spreadValues(__spreadValues(__spreadValues({
             promptTokens: (_m = usageInfo.inputTokens) != null ? _m : 0,
             completionTokens: (_n = usageInfo.outputTokens) != null ? _n : 0,
             totalTokens: (_o = usageInfo.totalTokens) != null ? _o : 0,
-            cost: (_p = response.usage) == null ? void 0 : _p.cost,
+            cost: (_p = response.usage) == null ? void 0 : _p.cost
+          }, ((_r = (_q = response.usage) == null ? void 0 : _q.prompt_tokens_details) == null ? void 0 : _r.cached_tokens) != null ? {
             promptTokensDetails: {
-              cachedTokens: (_s = (_r = (_q = response.usage) == null ? void 0 : _q.prompt_tokens_details) == null ? void 0 : _r.cached_tokens) != null ? _s : 0
-            },
+              cachedTokens: response.usage.prompt_tokens_details.cached_tokens
+            }
+          } : {}), ((_t = (_s = response.usage) == null ? void 0 : _s.completion_tokens_details) == null ? void 0 : _t.reasoning_tokens) != null ? {
             completionTokensDetails: {
-              reasoningTokens: (_v = (_u = (_t = response.usage) == null ? void 0 : _t.completion_tokens_details) == null ? void 0 : _u.reasoning_tokens) != null ? _v : 0
-            },
+              reasoningTokens: response.usage.completion_tokens_details.reasoning_tokens
+            }
+          } : {}), ((_v = (_u = response.usage) == null ? void 0 : _u.cost_details) == null ? void 0 : _v.upstream_inference_cost) != null ? {
             costDetails: {
-              upstreamInferenceCost: (_y = (_x = (_w = response.usage) == null ? void 0 : _w.cost_details) == null ? void 0 : _x.upstream_inference_cost) != null ? _y : 0
+              upstreamInferenceCost: response.usage.cost_details.upstream_inference_cost
             }
-          }
+          } : {})
         })
       },
       request: { body: args },
@@ -1858,7 +1869,7 @@ var OpenRouterChatLanguageModel = class {
       stream: response.pipeThrough(
         new TransformStream({
           transform(chunk, controller) {
-            var _a16, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n;
+            var _a16, _b, _c, _d, _e, _f, _g, _h, _i, _j, _k, _l, _m, _n, _o;
             if (!chunk.success) {
               finishReason = "error";
               controller.enqueue({ type: "error", error: chunk.error });
@@ -1908,6 +1919,12 @@ var OpenRouterChatLanguageModel = class {
               }
               openrouterUsage.cost = value.usage.cost;
               openrouterUsage.totalTokens = value.usage.total_tokens;
+              const upstreamInferenceCost = (_c = value.usage.cost_details) == null ? void 0 : _c.upstream_inference_cost;
+              if (upstreamInferenceCost != null) {
+                openrouterUsage.costDetails = {
+                  upstreamInferenceCost
+                };
+              }
             }
             const choice = value.choices[0];
             if ((choice == null ? void 0 : choice.finish_reason) != null) {
@@ -1917,16 +1934,18 @@ var OpenRouterChatLanguageModel = class {
               return;
             }
             const delta = choice.delta;
-            const emitReasoningChunk = (chunkText) => {
+            const emitReasoningChunk = (chunkText, providerMetadata) => {
               if (!reasoningStarted) {
                 reasoningId = openrouterResponseId || generateId();
                 controller.enqueue({
+                  providerMetadata,
                   type: "reasoning-start",
                   id: reasoningId
                 });
                 reasoningStarted = true;
               }
               controller.enqueue({
+                providerMetadata,
                 type: "reasoning-delta",
                 delta: chunkText,
                 id: reasoningId || generateId()
@@ -1938,6 +1957,8 @@ var OpenRouterChatLanguageModel = class {
                   const lastDetail = accumulatedReasoningDetails[accumulatedReasoningDetails.length - 1];
                   if ((lastDetail == null ? void 0 : lastDetail.type) === "reasoning.text" /* Text */) {
                     lastDetail.text = (lastDetail.text || "") + (detail.text || "");
+                    lastDetail.signature = lastDetail.signature || detail.signature;
+                    lastDetail.format = lastDetail.format || detail.format;
                   } else {
                     accumulatedReasoningDetails.push(__spreadValues({}, detail));
                   }
@@ -1945,23 +1966,28 @@ var OpenRouterChatLanguageModel = class {
                   accumulatedReasoningDetails.push(detail);
                 }
               }
+              const reasoningMetadata = {
+                openrouter: {
+                  reasoning_details: delta.reasoning_details
+                }
+              };
               for (const detail of delta.reasoning_details) {
                 switch (detail.type) {
                   case "reasoning.text" /* Text */: {
                     if (detail.text) {
-                      emitReasoningChunk(detail.text);
+                      emitReasoningChunk(detail.text, reasoningMetadata);
                     }
                     break;
                   }
                   case "reasoning.encrypted" /* Encrypted */: {
                     if (detail.data) {
-                      emitReasoningChunk("[REDACTED]");
+                      emitReasoningChunk("[REDACTED]", reasoningMetadata);
                     }
                     break;
                   }
                   case "reasoning.summary" /* Summary */: {
                     if (detail.summary) {
-                      emitReasoningChunk(detail.summary);
+                      emitReasoningChunk(detail.summary, reasoningMetadata);
                     }
                     break;
                   }
@@ -2016,7 +2042,7 @@ var OpenRouterChatLanguageModel = class {
             }
             if (delta.tool_calls != null) {
               for (const toolCallDelta of delta.tool_calls) {
-                const index = (_c = toolCallDelta.index) != null ? _c : toolCalls.length - 1;
+                const index = (_d = toolCallDelta.index) != null ? _d : toolCalls.length - 1;
                 if (toolCalls[index] == null) {
                   if (toolCallDelta.type !== "function") {
                     throw new InvalidResponseDataError({
@@ -2030,7 +2056,7 @@ var OpenRouterChatLanguageModel = class {
                       message: `Expected 'id' to be a string.`
                     });
                   }
-                  if (((_d = toolCallDelta.function) == null ? void 0 : _d.name) == null) {
+                  if (((_e = toolCallDelta.function) == null ? void 0 : _e.name) == null) {
                     throw new InvalidResponseDataError({
                       data: toolCallDelta,
                       message: `Expected 'function.name' to be a string.`
@@ -2041,7 +2067,7 @@ var OpenRouterChatLanguageModel = class {
                     type: "function",
                     function: {
                       name: toolCallDelta.function.name,
-                      arguments: (_e = toolCallDelta.function.arguments) != null ? _e : ""
+                      arguments: (_f = toolCallDelta.function.arguments) != null ? _f : ""
                     },
                     inputStarted: false,
                     sent: false
@@ -2053,7 +2079,7 @@ var OpenRouterChatLanguageModel = class {
                       message: `Tool call at index ${index} is missing after creation.`
                     });
                   }
-                  if (((_f = toolCall2.function) == null ? void 0 : _f.name) != null && ((_g = toolCall2.function) == null ? void 0 : _g.arguments) != null && isParsableJson(toolCall2.function.arguments)) {
+                  if (((_g = toolCall2.function) == null ? void 0 : _g.name) != null && ((_h = toolCall2.function) == null ? void 0 : _h.arguments) != null && isParsableJson(toolCall2.function.arguments)) {
                     toolCall2.inputStarted = true;
                     controller.enqueue({
                       type: "tool-input-start",
@@ -2103,18 +2129,18 @@ var OpenRouterChatLanguageModel = class {
                     toolName: toolCall.function.name
                   });
                 }
-                if (((_h = toolCallDelta.function) == null ? void 0 : _h.arguments) != null) {
-                  toolCall.function.arguments += (_j = (_i = toolCallDelta.function) == null ? void 0 : _i.arguments) != null ? _j : "";
+                if (((_i = toolCallDelta.function) == null ? void 0 : _i.arguments) != null) {
+                  toolCall.function.arguments += (_k = (_j = toolCallDelta.function) == null ? void 0 : _j.arguments) != null ? _k : "";
                 }
                 controller.enqueue({
                   type: "tool-input-delta",
                   id: toolCall.id,
-                  delta: (_k = toolCallDelta.function.arguments) != null ? _k : ""
+                  delta: (_l = toolCallDelta.function.arguments) != null ? _l : ""
                 });
-                if (((_l = toolCall.function) == null ? void 0 : _l.name) != null && ((_m = toolCall.function) == null ? void 0 : _m.arguments) != null && isParsableJson(toolCall.function.arguments)) {
+                if (((_m = toolCall.function) == null ? void 0 : _m.name) != null && ((_n = toolCall.function) == null ? void 0 : _n.arguments) != null && isParsableJson(toolCall.function.arguments)) {
                   controller.enqueue({
                     type: "tool-call",
-                    toolCallId: (_n = toolCall.id) != null ? _n : generateId(),
+                    toolCallId: (_o = toolCall.id) != null ? _o : generateId(),
                     toolName: toolCall.function.name,
                     input: toolCall.function.arguments,
                     providerMetadata: {
@@ -2330,7 +2356,10 @@ var OpenRouterCompletionChunkSchema = import_v47.z.union([
         reasoning_tokens: import_v47.z.number()
       }).passthrough().nullish(),
       total_tokens: import_v47.z.number(),
-      cost: import_v47.z.number().optional()
+      cost: import_v47.z.number().optional(),
+      cost_details: import_v47.z.object({
+        upstream_inference_cost: import_v47.z.number().nullish()
+      }).passthrough().nullish()
     }).passthrough().nullish()
   }).passthrough(),
   OpenRouterErrorResponseSchema
@@ -2503,7 +2532,7 @@ var OpenRouterCompletionLanguageModel = class {
       stream: response.pipeThrough(
         new TransformStream({
           transform(chunk, controller) {
-            var _a15, _b;
+            var _a15, _b, _c;
             if (!chunk.success) {
               finishReason = "error";
               controller.enqueue({ type: "error", error: chunk.error });
@@ -2537,6 +2566,12 @@ var OpenRouterCompletionLanguageModel = class {
               }
               openrouterUsage.cost = value.usage.cost;
               openrouterUsage.totalTokens = value.usage.total_tokens;
+              const upstreamInferenceCost = (_c = value.usage.cost_details) == null ? void 0 : _c.upstream_inference_cost;
+              if (upstreamInferenceCost != null) {
+                openrouterUsage.costDetails = {
+                  upstreamInferenceCost
+                };
+              }
             }
             const choice = value.choices[0];
             if ((choice == null ? void 0 : choice.finish_reason) != null) {