@jambonz/llm 0.6.6 → 0.6.8

package/dist/test-kit/index.d.cts

@@ -1,4 +1,4 @@
-import { b as AdapterFactory, e as AuthKind, A as AuthSpec, L as LlmAdapter, d as ApiKeyAuth, h as ClientOptions, P as PromptRequest, m as LlmEvent, M as Message, p as ToolCallEvent, o as ModelInfo, c as AdapterManifest } from '../types-dbgrfviJ.cjs';
+import { b as AdapterFactory, e as AuthKind, A as AuthSpec, L as LlmAdapter, d as ApiKeyAuth, h as ClientOptions, P as PromptRequest, m as LlmEvent, M as Message, p as ToolCallEvent, o as ModelInfo, c as AdapterManifest } from '../types-4l2etrW-.cjs';
 
 /**
  * Named scenarios the harness must be able to stage. Each scenario configures

package/dist/test-kit/index.d.ts

@@ -1,4 +1,4 @@
-import { b as AdapterFactory, e as AuthKind, A as AuthSpec, L as LlmAdapter, d as ApiKeyAuth, h as ClientOptions, P as PromptRequest, m as LlmEvent, M as Message, p as ToolCallEvent, o as ModelInfo, c as AdapterManifest } from '../types-dbgrfviJ.js';
+import { b as AdapterFactory, e as AuthKind, A as AuthSpec, L as LlmAdapter, d as ApiKeyAuth, h as ClientOptions, P as PromptRequest, m as LlmEvent, M as Message, p as ToolCallEvent, o as ModelInfo, c as AdapterManifest } from '../types-4l2etrW-.js';
 
 /**
  * Named scenarios the harness must be able to stage. Each scenario configures

package/dist/test-kit/index.js

@@ -3,8 +3,9 @@ import { afterEach, beforeEach, describe, expect, it } from "vitest";
 
 // src/registry.ts
 var registry = /* @__PURE__ */ new Map();
+var credentialVendors = /* @__PURE__ */ new Map();
 function registerAdapter(factory) {
-  if (registry.has(factory.vendor)) {
+  if (registry.has(factory.vendor) || credentialVendors.has(factory.vendor)) {
     throw new Error(
       `Adapter already registered for vendor '${factory.vendor}'. Use replaceAdapter() if you intended to override.`
     );
@@ -16,9 +17,23 @@ function registerAdapter(factory) {
   }
   registry.set(factory.vendor, factory);
 }
+function registerCredentialVendor(manifest) {
+  if (!manifest.credentialOnly) {
+    throw new Error(`Vendor '${manifest.vendor}' manifest is not marked credentialOnly.`);
+  }
+  if (registry.has(manifest.vendor) || credentialVendors.has(manifest.vendor)) {
+    throw new Error(`Vendor '${manifest.vendor}' is already registered.`);
+  }
+  credentialVendors.set(manifest.vendor, manifest);
+}
 function getAdapterFactory(vendor) {
   const factory = registry.get(vendor);
   if (!factory) {
+    if (credentialVendors.has(vendor)) {
+      throw new Error(
+        `Vendor '${vendor}' is credential-only: @jambonz/llm has no adapter for it.`
+      );
+    }
     const known = Array.from(registry.keys()).sort().join(", ") || "(none)";
     throw new Error(
       `Unknown vendor '${vendor}'. Registered vendors: ${known}`
@@ -28,6 +43,7 @@ function getAdapterFactory(vendor) {
 }
 function _resetRegistryForTests() {
   registry.clear();
+  credentialVendors.clear();
 }
 
 // src/adapters/openai/adapter.ts
@@ -3545,6 +3561,212 @@ var huggingfaceFactory = {
   create: () => new HuggingfaceAdapter()
 };
 
+// src/adapters/openrouter/manifest.ts
+var OPENROUTER_KNOWN_MODELS = [
+  {
+    id: "anthropic/claude-haiku-5.5",
+    displayName: "Claude Haiku 5.5 (OpenRouter)",
+    capabilities: {
+      streaming: true,
+      tools: true,
+      vision: true,
+      systemPrompt: true,
+      maxContextTokens: 1e6
+    }
+  },
+  {
+    id: "anthropic/claude-sonnet-5.5",
+    displayName: "Claude Sonnet 5.5 (OpenRouter)",
+    capabilities: {
+      streaming: true,
+      tools: true,
+      vision: true,
+      systemPrompt: true,
+      maxContextTokens: 1e6
+    }
+  },
+  {
+    id: "openai/gpt-5.4-mini",
+    displayName: "GPT-5.4 Mini (OpenRouter)",
+    capabilities: {
+      streaming: true,
+      tools: true,
+      vision: true,
+      systemPrompt: true,
+      maxContextTokens: 4e5
+    }
+  },
+  {
+    id: "openai/gpt-4.1-mini",
+    displayName: "GPT-4.1 Mini (OpenRouter)",
+    capabilities: {
+      streaming: true,
+      tools: true,
+      vision: true,
+      systemPrompt: true,
+      maxContextTokens: 1047576
+    }
+  },
+  {
+    id: "google/gemini-3.5-flash",
+    displayName: "Gemini 3.5 Flash (OpenRouter)",
+    capabilities: {
+      streaming: true,
+      tools: true,
+      vision: true,
+      systemPrompt: true,
+      maxContextTokens: 1048576
+    }
+  },
+  {
+    id: "meta-llama/llama-3.3-70b-instruct",
+    displayName: "Llama 3.3 70B Instruct (OpenRouter)",
+    capabilities: {
+      streaming: true,
+      tools: true,
+      vision: false,
+      systemPrompt: true,
+      maxContextTokens: 131072
+    }
+  }
+];
+var openRouterManifest = {
+  vendor: "openrouter",
+  displayName: "OpenRouter",
+  authKinds: [
+    {
+      kind: "apiKey",
+      displayName: "API Key",
+      fields: [
+        {
+          name: "apiKey",
+          label: "API Key",
+          type: "password",
+          required: true,
+          help: "Get an API key from https://openrouter.ai/settings/keys"
+        },
+        {
+          name: "baseURL",
+          label: "Base URL",
+          type: "url",
+          required: false,
+          default: "https://openrouter.ai/api/v1",
+          help: "Override only for proxies. Default points at OpenRouter's production endpoint."
+        }
+      ]
+    }
+  ],
+  knownModels: OPENROUTER_KNOWN_MODELS,
+  // /models is public; the adapter enriches it with OpenRouter's own capability metadata.
+  supportsModelListing: true,
+  docsUrl: "https://openrouter.ai/docs/api_reference/overview"
+};
+
+// src/adapters/openrouter/adapter.ts
+var OPENROUTER_METADATA_EXTRACTOR = makeMetadataExtractor([
+  { header: "x-generation-id", key: "request_id" }
+]);
+var OPENROUTER_ATTRIBUTION_HEADERS = {
+  "HTTP-Referer": "https://jambonz.org",
+  "X-OpenRouter-Title": "jambonz"
+};
+var OpenRouterAdapter = class extends OpenAIAdapter {
+  vendor = openRouterManifest.vendor;
+  init(auth, client) {
+    super.init(
+      {
+        ...auth,
+        baseURL: auth.baseURL ?? "https://openrouter.ai/api/v1"
+      },
+      client
+    );
+    this.client = this.ensureClient().withOptions({
+      defaultHeaders: OPENROUTER_ATTRIBUTION_HEADERS
+    });
+  }
+  stream(req) {
+    return streamFromOpenAI(this.ensureClient(), req, {
+      knownModels: this.knownModels(),
+      vendorMetadataExtractor: OPENROUTER_METADATA_EXTRACTOR,
+      // Verified accepted by OpenRouter (forwarded to OpenAI-family upstreams).
+      includeCacheKey: true,
+      openRouterAutoCache: this.isOpenRouter
+    });
+  }
+  async listAvailableModels() {
+    const result = await this.ensureClient().models.list();
+    const out = [];
+    for (const m of result.data) {
+      if (m.id.endsWith(":batch")) continue;
+      const outputs = m.architecture?.output_modalities;
+      if (outputs && !outputs.includes("text")) continue;
+      const known = this.knownModels().find((k) => k.id === m.id);
+      if (known) {
+        out.push(known);
+        continue;
+      }
+      out.push({
+        id: m.id,
+        ...m.name ? { displayName: m.name } : {},
+        capabilities: {
+          streaming: true,
+          tools: m.supported_parameters?.includes("tools") ?? true,
+          vision: m.architecture?.input_modalities?.includes("image") ?? false,
+          systemPrompt: true,
+          ...m.context_length ? { maxContextTokens: m.context_length } : {}
+        }
+      });
+    }
+    return out;
+  }
+  async testCredential() {
+    await this.ensureClient().get("/key");
+  }
+  knownModels() {
+    return openRouterManifest.knownModels;
+  }
+};
+
+// src/adapters/openrouter/factory.ts
+var openRouterFactory = {
+  vendor: openRouterManifest.vendor,
+  manifest: openRouterManifest,
+  create: () => new OpenRouterAdapter()
+};
+
+// src/vendors/harness.ts
+var harnessManifest = {
+  vendor: "harness",
+  displayName: "Harness",
+  authKinds: [
+    {
+      // Only the form schema matters for a credential-only vendor; no
+      // AuthSpec is ever built from it.
+      kind: "apiKey",
+      displayName: "API Key",
+      fields: [
+        {
+          name: "url",
+          label: "WebSocket URL",
+          type: "url",
+          required: true,
+          help: "wss:// URL of your harness. ws:// is accepted only for a private or localhost address."
+        },
+        {
+          name: "apiKey",
+          label: "API Key",
+          type: "password",
+          required: true,
+          help: 'Sent to the harness as "Authorization: Bearer <key>" when each call connects.'
+        }
+      ]
+    }
+  ],
+  knownModels: [],
+  supportsModelListing: false,
+  credentialOnly: true
+};
+
 // src/adapters/index.ts
 registerAdapter(openAIFactory);
 registerAdapter(deepseekFactory);
@@ -3561,6 +3783,8 @@ registerAdapter(bedrockFactory);
 registerAdapter(azureOpenAIFactory);
 registerAdapter(groqFactory);
 registerAdapter(huggingfaceFactory);
+registerAdapter(openRouterFactory);
+registerCredentialVendor(harnessManifest);
 
 // src/index.ts
 async function createLlm(args) {