@providerprotocol/ai 0.0.20 → 0.0.22

package/dist/openrouter/index.d.ts

@@ -1,29 +1,4 @@
-import { d as Provider, f as ModelReference, b as LLMHandler, c as EmbeddingHandler } from '../provider-BBMBZuGn.js';
-
-/**
- * @fileoverview OpenRouter Embeddings API Handler
- *
- * This module implements the embedding handler for OpenRouter's embeddings API.
- * OpenRouter provides access to multiple embedding providers through an OpenAI-compatible endpoint.
- *
- * @see {@link https://openrouter.ai/docs/api/reference/embeddings OpenRouter Embeddings API Reference}
- * @module providers/openrouter/embed
- */
-
-/**
- * OpenRouter embedding parameters.
- * Passed through unchanged to the API.
- */
-interface OpenRouterEmbedParams {
-    /** Output dimensions (model-dependent) */
-    dimensions?: number;
-    /** Encoding format: 'float' or 'base64' */
-    encoding_format?: 'float' | 'base64';
-    /** A unique identifier representing your end-user */
-    user?: string;
-    /** Input type hint for some models */
-    input_type?: string;
-}
+import { g as Provider } from '../provider-DWEAzeM5.js';
 
 /**
  * OpenRouter-specific types for the Unified Provider Protocol.
@@ -255,10 +230,30 @@ type OpenRouterResponseFormat = {
 };
 
 /**
- * Union type for both Completions and Responses API parameter types.
- * Used internally to type the modalities handler.
+ * @fileoverview OpenRouter Embeddings API Handler
+ *
+ * This module implements the embedding handler for OpenRouter's embeddings API.
+ * OpenRouter provides access to multiple embedding providers through an OpenAI-compatible endpoint.
+ *
+ * @see {@link https://openrouter.ai/docs/api/reference/embeddings OpenRouter Embeddings API Reference}
+ * @module providers/openrouter/embed
+ */
+
+/**
+ * OpenRouter embedding parameters.
+ * Passed through unchanged to the API.
  */
-type OpenRouterLLMParamsUnion = OpenRouterCompletionsParams | OpenRouterResponsesParams;
+interface OpenRouterEmbedParams {
+    /** Output dimensions (model-dependent) */
+    dimensions?: number;
+    /** Encoding format: 'float' or 'base64' */
+    encoding_format?: 'float' | 'base64';
+    /** A unique identifier representing your end-user */
+    user?: string;
+    /** Input type hint for some models */
+    input_type?: string;
+}
+
 /**
  * Configuration options for creating an OpenRouter model reference.
  *
@@ -297,30 +292,10 @@ interface OpenRouterProviderOptions {
  * const model = openrouter('anthropic/claude-3.5-sonnet', { api: 'completions' });
  * ```
  */
-interface OpenRouterProvider extends Provider<OpenRouterProviderOptions> {
-    /**
-     * Creates a model reference for the specified model ID.
-     *
-     * @param modelId - The OpenRouter model identifier in `provider/model` format
-     *                  (e.g., 'openai/gpt-4o', 'anthropic/claude-3.5-sonnet',
-     *                  'meta-llama/llama-3.1-70b-instruct')
-     * @param options - Optional configuration including API selection
-     * @returns A model reference that can be passed to llm()
-     */
-    (modelId: string, options?: OpenRouterProviderOptions): ModelReference<OpenRouterProviderOptions>;
-    /** Provider identifier. Always 'openrouter'. */
-    readonly name: 'openrouter';
-    /** Semantic version of this provider implementation. */
-    readonly version: string;
-    /**
-     * Supported modalities for this provider.
-     * OpenRouter supports LLM (text generation) and Embedding.
-     */
-    readonly modalities: {
-        llm: LLMHandler<OpenRouterLLMParamsUnion>;
-        embedding: EmbeddingHandler<OpenRouterEmbedParams>;
-    };
-}
+/**
+ * Type alias for the OpenRouter provider with its options.
+ */
+type OpenRouterProvider = Provider<OpenRouterProviderOptions>;
 /**
  * OpenRouter provider singleton.
  *

package/dist/openrouter/index.js

@@ -1,21 +1,27 @@
+import {
+  parseJsonResponse
+} from "../chunk-I2VHCGQE.js";
 import {
   AssistantMessage,
+  createProvider,
+  generateId,
   isAssistantMessage,
   isToolResultMessage,
   isUserMessage
-} from "../chunk-UMKWXGO3.js";
+} from "../chunk-M4BMM5IB.js";
 import {
   parseSSEStream
-} from "../chunk-Z7RBRCRN.js";
+} from "../chunk-NWS5IKNR.js";
 import {
   resolveApiKey
-} from "../chunk-P5IRTEM5.js";
+} from "../chunk-7WYBJPJJ.js";
 import {
   UPPError,
   doFetch,
   doStreamFetch,
-  normalizeHttpError
-} from "../chunk-U3FZWV4U.js";
+  normalizeHttpError,
+  toError
+} from "../chunk-RFWLEFAB.js";
 
 // src/providers/openrouter/transform.completions.ts
 function transformRequest(request, modelId) {
@@ -52,11 +58,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)) {
@@ -71,6 +87,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",
+      "INVALID_REQUEST",
+      "openrouter",
+      "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"',
+        "INVALID_REQUEST",
+        "openrouter",
+        "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',
+        "INVALID_REQUEST",
+        "openrouter",
+        "llm"
+      );
+    }
+    if (candidate.cache_control !== void 0 && !isValidCacheControl(candidate.cache_control)) {
+      throw new UPPError(
+        "Invalid cache_control for OpenRouter system prompt",
+        "INVALID_REQUEST",
+        "openrouter",
+        "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");
 }
@@ -224,11 +288,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,
@@ -390,11 +455,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,
@@ -497,7 +563,7 @@ function createCompletionsLLMHandler() {
             "openrouter",
             "llm"
           );
-          const data = await response.json();
+          const data = await parseJsonResponse(response, "openrouter", "llm");
           return transformResponse(data);
         },
         stream(request) {
@@ -522,7 +588,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)) {
@@ -583,8 +650,9 @@ function createCompletionsLLMHandler() {
               }
               responseResolve(buildResponseFromState(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -635,12 +703,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);
@@ -654,6 +733,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",
+      "INVALID_REQUEST",
+      "openrouter",
+      "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"',
+        "INVALID_REQUEST",
+        "openrouter",
+        "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',
+        "INVALID_REQUEST",
+        "openrouter",
+        "llm"
+      );
+    }
+    if (candidate.cache_control !== void 0 && !isValidCacheControl2(candidate.cache_control)) {
+      throw new UPPError(
+        "Invalid cache_control for OpenRouter system prompt",
+        "INVALID_REQUEST",
+        "openrouter",
+        "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");
 }
@@ -685,7 +812,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",
@@ -831,17 +958,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
         }
       }
@@ -1124,17 +1252,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
         }
       }
@@ -1228,7 +1357,7 @@ 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,
@@ -1260,7 +1389,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)) {
@@ -1321,8 +1451,9 @@ function createResponsesLLMHandler() {
               }
               responseResolve(buildResponseFromState2(state));
             } catch (error) {
-              responseReject(error);
-              throw error;
+              const err = toError(error);
+              responseReject(err);
+              throw err;
             }
           }
           return {
@@ -1431,7 +1562,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,
@@ -1448,46 +1579,22 @@ function createEmbeddingHandler() {
 }
 
 // src/providers/openrouter/index.ts
-function createOpenRouterProvider() {
-  let currentApiMode = "completions";
-  const completionsHandler = createCompletionsLLMHandler();
-  const responsesHandler = createResponsesLLMHandler();
-  const embeddingHandler = createEmbeddingHandler();
-  const fn = function(modelId, options) {
-    const apiMode = options?.api ?? "completions";
-    currentApiMode = apiMode;
-    return { modelId, provider };
-  };
-  const modalities = {
-    get llm() {
-      return currentApiMode === "responses" ? responsesHandler : completionsHandler;
-    },
-    embedding: embeddingHandler
-  };
-  Object.defineProperties(fn, {
-    name: {
-      value: "openrouter",
-      writable: false,
-      configurable: true
-    },
-    version: {
-      value: "1.0.0",
-      writable: false,
-      configurable: true
-    },
-    modalities: {
-      value: modalities,
-      writable: false,
-      configurable: true
-    }
-  });
-  const provider = fn;
-  completionsHandler._setProvider?.(provider);
-  responsesHandler._setProvider?.(provider);
-  embeddingHandler._setProvider?.(provider);
-  return provider;
-}
-var openrouter = createOpenRouterProvider();
+var llmResolver = {
+  handlers: {
+    completions: createCompletionsLLMHandler(),
+    responses: createResponsesLLMHandler()
+  },
+  defaultMode: "completions",
+  getMode: (options) => options?.api ?? "completions"
+};
+var openrouter = createProvider({
+  name: "openrouter",
+  version: "1.0.0",
+  handlers: {
+    llm: llmResolver,
+    embedding: createEmbeddingHandler()
+  }
+});
 export {
   openrouter
 };