@providerprotocol/ai 0.0.21 → 0.0.23

package/dist/openrouter/index.d.ts

@@ -1,4 +1,4 @@
-import { g as Provider } from '../provider-DGQHYE6I.js';
+import { g as Provider } from '../provider-DR1yins0.js';
 
 /**
  * OpenRouter-specific types for the Unified Provider Protocol.

package/dist/openrouter/index.js

@@ -1,22 +1,32 @@
+import {
+  parseJsonResponse
+} from "../chunk-Z6DKC37J.js";
+import {
+  StreamEventType
+} from "../chunk-73IIE3QT.js";
 import {
   AssistantMessage,
   createProvider,
+  generateId,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-M4BMM5IB.js";
+} from "../chunk-MF5ETY5O.js";
 import {
   parseSSEStream
-} from "../chunk-Z7RBRCRN.js";
+} from "../chunk-NWS5IKNR.js";
 import {
   resolveApiKey
-} from "../chunk-Y3GBJNA2.js";
+} from "../chunk-55X3W2MN.js";
 import {
+  ErrorCode,
+  ModalityType,
   UPPError,
   doFetch,
   doStreamFetch,
-  normalizeHttpError
-} from "../chunk-EDENPF3E.js";
+  normalizeHttpError,
+  toError
+} from "../chunk-QNJO7DSD.js";
 
 // src/providers/openrouter/transform.completions.ts
 function transformRequest(request, modelId) {
@@ -53,11 +63,21 @@ function transformRequest(request, modelId) {
 }
 function transformMessages(messages, system) {
   const result = [];
-  if (system) {
-    result.push({
-      role: "system",
-      content: system
-    });
+  if (system !== void 0 && system !== null) {
+    const normalizedSystem = normalizeSystem(system);
+    if (typeof normalizedSystem === "string") {
+      if (normalizedSystem.length > 0) {
+        result.push({
+          role: "system",
+          content: normalizedSystem
+        });
+      }
+    } else if (normalizedSystem.length > 0) {
+      result.push({
+        role: "system",
+        content: normalizedSystem
+      });
+    }
   }
   for (const message of messages) {
     if (isToolResultMessage(message)) {
@@ -72,6 +92,54 @@ function transformMessages(messages, system) {
   }
   return result;
 }
+function normalizeSystem(system) {
+  if (typeof system === "string") return system;
+  if (!Array.isArray(system)) {
+    throw new UPPError(
+      "System prompt must be a string or an array of text blocks",
+      ErrorCode.InvalidRequest,
+      "openrouter",
+      ModalityType.LLM
+    );
+  }
+  const blocks = [];
+  for (const block of system) {
+    if (!block || typeof block !== "object") {
+      throw new UPPError(
+        'System prompt array must contain objects with type "text"',
+        ErrorCode.InvalidRequest,
+        "openrouter",
+        ModalityType.LLM
+      );
+    }
+    const candidate = block;
+    if (candidate.type !== "text" || typeof candidate.text !== "string") {
+      throw new UPPError(
+        'OpenRouter system blocks must be of type "text" with a string text field',
+        ErrorCode.InvalidRequest,
+        "openrouter",
+        ModalityType.LLM
+      );
+    }
+    if (candidate.cache_control !== void 0 && !isValidCacheControl(candidate.cache_control)) {
+      throw new UPPError(
+        "Invalid cache_control for OpenRouter system prompt",
+        ErrorCode.InvalidRequest,
+        "openrouter",
+        ModalityType.LLM
+      );
+    }
+    blocks.push(block);
+  }
+  return blocks;
+}
+function isValidCacheControl(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  if (candidate.type !== "ephemeral") return false;
+  if (candidate.ttl !== void 0 && candidate.ttl !== "1h") return false;
+  return true;
+}
 function filterValidContent(content) {
   return content.filter((c) => c && typeof c.type === "string");
 }
@@ -225,11 +293,12 @@ function transformResponse(data) {
       });
     }
   }
+  const responseId = data.id || generateId();
   const message = new AssistantMessage(
     content,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: data.id,
+      id: responseId,
       metadata: {
         openrouter: {
           model: data.model,
@@ -300,7 +369,7 @@ function transformStreamEvent(chunk, state) {
   const events = [];
   if (chunk.id && !state.id) {
     state.id = chunk.id;
-    events.push({ type: "message_start", index: 0, delta: {} });
+    events.push({ type: StreamEventType.MessageStart, index: 0, delta: {} });
   }
   if (chunk.model) {
     state.model = chunk.model;
@@ -310,7 +379,7 @@ function transformStreamEvent(chunk, state) {
     if (choice.delta.content) {
       state.text += choice.delta.content;
       events.push({
-        type: "text_delta",
+        type: StreamEventType.TextDelta,
         index: 0,
         delta: { text: choice.delta.content }
       });
@@ -332,7 +401,7 @@ function transformStreamEvent(chunk, state) {
         if (toolCallDelta.function?.arguments) {
           toolCall.arguments += toolCallDelta.function.arguments;
           events.push({
-            type: "tool_call_delta",
+            type: StreamEventType.ToolCallDelta,
             index,
             delta: {
               toolCallId: toolCall.id,
@@ -350,7 +419,7 @@ function transformStreamEvent(chunk, state) {
     }
     if (choice.finish_reason) {
       state.finishReason = choice.finish_reason;
-      events.push({ type: "message_stop", index: 0, delta: {} });
+      events.push({ type: StreamEventType.MessageStop, index: 0, delta: {} });
     }
   }
   if (chunk.usage) {
@@ -391,11 +460,12 @@ function buildResponseFromState(state) {
       arguments: args
     });
   }
+  const messageId = state.id || generateId();
   const message = new AssistantMessage(
     content,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: state.id,
+      id: messageId,
       metadata: {
         openrouter: {
           model: state.model,
@@ -455,9 +525,9 @@ function createCompletionsLLMHandler() {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider() or have _setProvider called.",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "openrouter",
-          "llm"
+          ModalityType.LLM
         );
       }
       const model = {
@@ -498,7 +568,7 @@ function createCompletionsLLMHandler() {
             "openrouter",
             "llm"
           );
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "openrouter", "llm");
           return transformResponse(data);
         },
         stream(request) {
@@ -523,7 +593,8 @@ function createCompletionsLLMHandler() {
               body.stream_options = { include_usage: true };
               const headers = {
                 "Content-Type": "application/json",
-                Authorization: `Bearer ${apiKey}`
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "text/event-stream"
               };
               if (request.config.headers) {
                 for (const [key, value] of Object.entries(request.config.headers)) {
@@ -552,9 +623,9 @@ function createCompletionsLLMHandler() {
               if (!response.body) {
                 const error = new UPPError(
                   "No response body for streaming request",
-                  "PROVIDER_ERROR",
+                  ErrorCode.ProviderError,
                   "openrouter",
-                  "llm"
+                  ModalityType.LLM
                 );
                 responseReject(error);
                 throw error;
@@ -569,9 +640,9 @@ function createCompletionsLLMHandler() {
                     const errorData = chunk.error;
                     const error = new UPPError(
                       errorData.message ?? "Unknown error",
-                      "PROVIDER_ERROR",
+                      ErrorCode.ProviderError,
                       "openrouter",
-                      "llm"
+                      ModalityType.LLM
                     );
                     responseReject(error);
                     throw error;
@@ -584,8 +655,9 @@ function createCompletionsLLMHandler() {
               }
               responseResolve(buildResponseFromState(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -636,12 +708,23 @@ function transformRequest2(request, modelId) {
 }
 function transformInputItems(messages, system) {
   const result = [];
-  if (system) {
-    result.push({
-      type: "message",
-      role: "system",
-      content: system
-    });
+  if (system !== void 0 && system !== null) {
+    const normalizedSystem = normalizeSystem2(system);
+    if (typeof normalizedSystem === "string") {
+      if (normalizedSystem.length > 0) {
+        result.push({
+          type: "message",
+          role: "system",
+          content: normalizedSystem
+        });
+      }
+    } else if (normalizedSystem.length > 0) {
+      result.push({
+        type: "message",
+        role: "system",
+        content: normalizedSystem
+      });
+    }
   }
   for (const message of messages) {
     const items = transformMessage2(message);
@@ -655,6 +738,54 @@ function transformInputItems(messages, system) {
   }
   return result;
 }
+function normalizeSystem2(system) {
+  if (typeof system === "string") return system;
+  if (!Array.isArray(system)) {
+    throw new UPPError(
+      "System prompt must be a string or an array of text blocks",
+      ErrorCode.InvalidRequest,
+      "openrouter",
+      ModalityType.LLM
+    );
+  }
+  const blocks = [];
+  for (const block of system) {
+    if (!block || typeof block !== "object") {
+      throw new UPPError(
+        'System prompt array must contain objects with type "text"',
+        ErrorCode.InvalidRequest,
+        "openrouter",
+        ModalityType.LLM
+      );
+    }
+    const candidate = block;
+    if (candidate.type !== "text" || typeof candidate.text !== "string") {
+      throw new UPPError(
+        'OpenRouter system blocks must be of type "text" with a string text field',
+        ErrorCode.InvalidRequest,
+        "openrouter",
+        ModalityType.LLM
+      );
+    }
+    if (candidate.cache_control !== void 0 && !isValidCacheControl2(candidate.cache_control)) {
+      throw new UPPError(
+        "Invalid cache_control for OpenRouter system prompt",
+        ErrorCode.InvalidRequest,
+        "openrouter",
+        ModalityType.LLM
+      );
+    }
+    blocks.push(block);
+  }
+  return blocks;
+}
+function isValidCacheControl2(value) {
+  if (!value || typeof value !== "object") return false;
+  const candidate = value;
+  if (candidate.type !== "ephemeral") return false;
+  if (candidate.ttl !== void 0 && candidate.ttl !== "1h") return false;
+  return true;
+}
 function filterValidContent2(content) {
   return content.filter((c) => c && typeof c.type === "string");
 }
@@ -686,7 +817,7 @@ function transformMessage2(message) {
       text: c.text,
       annotations: []
     }));
-    const messageId = message.id ?? `msg_${Date.now()}`;
+    const messageId = message.id || generateId();
     if (contentParts.length > 0) {
       items.push({
         type: "message",
@@ -832,17 +963,18 @@ function transformResponse2(data) {
       }
     }
   }
+  const responseId = data.id || generateId();
   const message = new AssistantMessage(
     content,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: data.id,
+      id: responseId,
       metadata: {
         openrouter: {
           model: data.model,
           status: data.status,
           // Store response_id for multi-turn tool calling
-          response_id: data.id,
+          response_id: responseId,
           functionCallItems: functionCallItems.length > 0 ? functionCallItems : void 0
         }
       }
@@ -893,7 +1025,7 @@ function transformStreamEvent2(event, state) {
     case "response.created":
       state.id = event.response.id;
       state.model = event.response.model;
-      events.push({ type: "message_start", index: 0, delta: {} });
+      events.push({ type: StreamEventType.MessageStart, index: 0, delta: {} });
       break;
     case "response.in_progress":
       state.status = "in_progress";
@@ -922,11 +1054,11 @@ function transformStreamEvent2(event, state) {
           }
         }
       }
-      events.push({ type: "message_stop", index: 0, delta: {} });
+      events.push({ type: StreamEventType.MessageStop, index: 0, delta: {} });
       break;
     case "response.failed":
       state.status = "failed";
-      events.push({ type: "message_stop", index: 0, delta: {} });
+      events.push({ type: StreamEventType.MessageStop, index: 0, delta: {} });
       break;
     case "response.output_item.added":
       if (event.item.type === "function_call") {
@@ -943,7 +1075,7 @@ function transformStreamEvent2(event, state) {
         state.toolCalls.set(event.output_index, existing);
       }
       events.push({
-        type: "content_block_start",
+        type: StreamEventType.ContentBlockStart,
         index: event.output_index,
         delta: {}
       });
@@ -969,7 +1101,7 @@ function transformStreamEvent2(event, state) {
             if (!existingText && content.text) {
               state.textByIndex.set(event.output_index, content.text);
               events.push({
-                type: "text_delta",
+                type: StreamEventType.TextDelta,
                 index: event.output_index,
                 delta: { text: content.text }
               });
@@ -983,7 +1115,7 @@ function transformStreamEvent2(event, state) {
         }
       }
       events.push({
-        type: "content_block_stop",
+        type: StreamEventType.ContentBlockStop,
         index: event.output_index,
         delta: {}
       });
@@ -994,7 +1126,7 @@ function transformStreamEvent2(event, state) {
       const currentText = state.textByIndex.get(event.output_index) ?? "";
       state.textByIndex.set(event.output_index, currentText + textDelta);
       events.push({
-        type: "text_delta",
+        type: StreamEventType.TextDelta,
         index: event.output_index,
         delta: { text: textDelta }
       });
@@ -1011,7 +1143,7 @@ function transformStreamEvent2(event, state) {
       const currentRefusal = state.textByIndex.get(event.output_index) ?? "";
       state.textByIndex.set(event.output_index, currentRefusal + event.delta);
       events.push({
-        type: "text_delta",
+        type: StreamEventType.TextDelta,
         index: event.output_index,
         delta: { text: event.delta }
       });
@@ -1035,7 +1167,7 @@ function transformStreamEvent2(event, state) {
       }
       toolCall.arguments += event.delta;
       events.push({
-        type: "tool_call_delta",
+        type: StreamEventType.ToolCallDelta,
         index: event.output_index,
         delta: {
           toolCallId: toolCall.callId ?? toolCall.itemId ?? "",
@@ -1063,7 +1195,7 @@ function transformStreamEvent2(event, state) {
     }
     case "response.reasoning.delta":
       events.push({
-        type: "reasoning_delta",
+        type: StreamEventType.ReasoningDelta,
         index: 0,
         delta: { text: event.delta }
       });
@@ -1125,17 +1257,18 @@ function buildResponseFromState2(state) {
       });
     }
   }
+  const responseId = state.id || generateId();
   const message = new AssistantMessage(
     content,
     toolCalls.length > 0 ? toolCalls : void 0,
     {
-      id: state.id,
+      id: responseId,
       metadata: {
         openrouter: {
           model: state.model,
           status: state.status,
           // Store response_id for multi-turn tool calling
-          response_id: state.id,
+          response_id: responseId,
           functionCallItems: functionCallItems.length > 0 ? functionCallItems : void 0
         }
       }
@@ -1186,9 +1319,9 @@ function createResponsesLLMHandler() {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider() or have _setProvider called.",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "openrouter",
-          "llm"
+          ModalityType.LLM
         );
       }
       const model = {
@@ -1229,13 +1362,13 @@ function createResponsesLLMHandler() {
             "openrouter",
             "llm"
           );
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "openrouter", "llm");
           if (data.status === "failed" && data.error) {
             throw new UPPError(
               data.error.message,
-              "PROVIDER_ERROR",
+              ErrorCode.ProviderError,
               "openrouter",
-              "llm"
+              ModalityType.LLM
             );
           }
           return transformResponse2(data);
@@ -1261,7 +1394,8 @@ function createResponsesLLMHandler() {
               body.stream = true;
               const headers = {
                 "Content-Type": "application/json",
-                Authorization: `Bearer ${apiKey}`
+                Authorization: `Bearer ${apiKey}`,
+                Accept: "text/event-stream"
               };
               if (request.config.headers) {
                 for (const [key, value] of Object.entries(request.config.headers)) {
@@ -1290,9 +1424,9 @@ function createResponsesLLMHandler() {
               if (!response.body) {
                 const error = new UPPError(
                   "No response body for streaming request",
-                  "PROVIDER_ERROR",
+                  ErrorCode.ProviderError,
                   "openrouter",
-                  "llm"
+                  ModalityType.LLM
                 );
                 responseReject(error);
                 throw error;
@@ -1307,9 +1441,9 @@ function createResponsesLLMHandler() {
                     const errorEvent = event;
                     const error = new UPPError(
                       errorEvent.error.message,
-                      "PROVIDER_ERROR",
+                      ErrorCode.ProviderError,
                       "openrouter",
-                      "llm"
+                      ModalityType.LLM
                     );
                     responseReject(error);
                     throw error;
@@ -1322,8 +1456,9 @@ function createResponsesLLMHandler() {
               }
               responseResolve(buildResponseFromState2(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -1364,9 +1499,9 @@ function createEmbeddingHandler() {
       if (!providerRef) {
         throw new UPPError(
           "Provider reference not set. Handler must be used with createProvider().",
-          "INVALID_REQUEST",
+          ErrorCode.InvalidRequest,
           "openrouter",
-          "embedding"
+          ModalityType.Embedding
         );
       }
       const model = {
@@ -1394,9 +1529,9 @@ function createEmbeddingHandler() {
             }
             throw new UPPError(
               "OpenRouter embeddings only support text input",
-              "INVALID_REQUEST",
+              ErrorCode.InvalidRequest,
               "openrouter",
-              "embedding"
+              ModalityType.Embedding
             );
           });
           const body = {
@@ -1432,7 +1567,7 @@ function createEmbeddingHandler() {
             body: JSON.stringify(body),
             signal: request.signal
           }, request.config, "openrouter", "embedding");
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "openrouter", "embedding");
           return {
             embeddings: data.data.map((d) => ({
               vector: d.embedding,