@jambonz/llm 0.6.7 → 0.6.9

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { S as ServiceAccountJson, A as AuthSpec, a as AuthKindSchema, P as PromptRequest, b as AdapterFactory, c as AdapterManifest, C as CreateLlmArgs, L as LlmAdapter } from './types-dbgrfviJ.cjs';
-export { d as ApiKeyAuth, e as AuthKind, f as AzureOpenAIApiKeyAuth, B as BedrockApiKeyAuth, g as BedrockIamAuth, h as ClientOptions, i as ContentBlock, F as FinishReason, j as FormField, k as FormFieldType, G as GoogleApiKeyAuth, l as GoogleServiceAccountAuth, J as JsonSchema, m as LlmEvent, M as Message, n as ModelCapabilities, o as ModelInfo, R as Role, T as Tool, p as ToolCallEvent, U as Usage, V as VertexServiceAccountAuth } from './types-dbgrfviJ.cjs';
+import { S as ServiceAccountJson, A as AuthSpec, a as AuthKindSchema, P as PromptRequest, b as AdapterFactory, c as AdapterManifest, C as CreateLlmArgs, L as LlmAdapter } from './types-C_yrWq_0.cjs';
+export { d as ApiKeyAuth, e as AuthKind, f as AzureOpenAIApiKeyAuth, B as BedrockApiKeyAuth, g as BedrockIamAuth, h as ClientOptions, i as ContentBlock, F as FinishReason, j as FormField, k as FormFieldType, G as GoogleApiKeyAuth, l as GoogleServiceAccountAuth, J as JsonSchema, m as LlmEvent, M as Message, n as ModelCapabilities, o as ModelInfo, R as Role, T as Tool, p as ToolCallEvent, U as Usage, V as VendorCategory, q as VertexServiceAccountAuth } from './types-C_yrWq_0.cjs';
 
 /**
  * The loose "DB-shape" input accepted by `normalizeAuth`.
@@ -101,12 +101,19 @@ declare function unregisterAdapter(vendor: string): void;
  */
 declare function getAdapterFactory<A extends AuthSpec = AuthSpec>(vendor: string): AdapterFactory<A>;
 /**
- * List all registered vendor ids, sorted alphabetically.
+ * Get the manifest for any registered vendor, adapter-backed or
+ * credential-only. Throws if unknown vendor. Use this (not
+ * `getAdapterFactory`) where only the credential shape matters.
+ */
+declare function getVendorManifest(vendor: string): AdapterManifest;
+/**
+ * List all registered adapter vendor ids, sorted alphabetically.
+ * Credential-only vendors are not included: they cannot be passed to `createLlm`.
  */
 declare function listVendors(): string[];
 /**
- * Return an aggregated manifest for all registered adapters. Used by
- * api-server's /llm-vendors/manifest endpoint.
+ * Return an aggregated manifest for all registered vendors, credential-only
+ * ones included. Used by api-server's /llm-vendors/manifest endpoint.
  */
 declare function getManifest(): {
     vendors: AdapterManifest[];
@@ -121,6 +128,8 @@ declare function getManifest(): {
  * Consumers use:
  *   - `createLlm({vendor, auth, client?})` to get a ready-to-stream adapter instance.
  *   - `getManifest()` to enumerate registered vendors (used by api-server).
+ *   - `getVendorManifest(vendor)` for one vendor's manifest, including
+ *     credential-only vendors (e.g. `harness`) that have no adapter.
  *   - `normalizeAuth(vendor, rawCred)` to convert DB-shape creds to AuthSpec.
  *   - `pickAuthKind(vendor, rawCred)` to pick the right manifest authKind for
  *     a raw credential (used by api-server's `encryptCredential`).
@@ -129,4 +138,4 @@ declare function getManifest(): {
 
 declare function createLlm<A extends AuthSpec = AuthSpec>(args: CreateLlmArgs<A>): Promise<LlmAdapter<A>>;
 
-export { AdapterFactory, AdapterManifest, AuthKindSchema, AuthSpec, CreateLlmArgs, LlmAdapter, PromptRequest, type RawCredential, type RawCredentialLoose, ServiceAccountJson, assertValidRequest, createLlm, getAdapterFactory, getManifest, listVendors, normalizeAuth, pickAuthKind, registerAdapter, replaceAdapter, unregisterAdapter };
+export { AdapterFactory, AdapterManifest, AuthKindSchema, AuthSpec, CreateLlmArgs, LlmAdapter, PromptRequest, type RawCredential, type RawCredentialLoose, ServiceAccountJson, assertValidRequest, createLlm, getAdapterFactory, getManifest, getVendorManifest, listVendors, normalizeAuth, pickAuthKind, registerAdapter, replaceAdapter, unregisterAdapter };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as ServiceAccountJson, A as AuthSpec, a as AuthKindSchema, P as PromptRequest, b as AdapterFactory, c as AdapterManifest, C as CreateLlmArgs, L as LlmAdapter } from './types-dbgrfviJ.js';
-export { d as ApiKeyAuth, e as AuthKind, f as AzureOpenAIApiKeyAuth, B as BedrockApiKeyAuth, g as BedrockIamAuth, h as ClientOptions, i as ContentBlock, F as FinishReason, j as FormField, k as FormFieldType, G as GoogleApiKeyAuth, l as GoogleServiceAccountAuth, J as JsonSchema, m as LlmEvent, M as Message, n as ModelCapabilities, o as ModelInfo, R as Role, T as Tool, p as ToolCallEvent, U as Usage, V as VertexServiceAccountAuth } from './types-dbgrfviJ.js';
+import { S as ServiceAccountJson, A as AuthSpec, a as AuthKindSchema, P as PromptRequest, b as AdapterFactory, c as AdapterManifest, C as CreateLlmArgs, L as LlmAdapter } from './types-C_yrWq_0.js';
+export { d as ApiKeyAuth, e as AuthKind, f as AzureOpenAIApiKeyAuth, B as BedrockApiKeyAuth, g as BedrockIamAuth, h as ClientOptions, i as ContentBlock, F as FinishReason, j as FormField, k as FormFieldType, G as GoogleApiKeyAuth, l as GoogleServiceAccountAuth, J as JsonSchema, m as LlmEvent, M as Message, n as ModelCapabilities, o as ModelInfo, R as Role, T as Tool, p as ToolCallEvent, U as Usage, V as VendorCategory, q as VertexServiceAccountAuth } from './types-C_yrWq_0.js';
 
 /**
  * The loose "DB-shape" input accepted by `normalizeAuth`.
@@ -101,12 +101,19 @@ declare function unregisterAdapter(vendor: string): void;
  */
 declare function getAdapterFactory<A extends AuthSpec = AuthSpec>(vendor: string): AdapterFactory<A>;
 /**
- * List all registered vendor ids, sorted alphabetically.
+ * Get the manifest for any registered vendor, adapter-backed or
+ * credential-only. Throws if unknown vendor. Use this (not
+ * `getAdapterFactory`) where only the credential shape matters.
+ */
+declare function getVendorManifest(vendor: string): AdapterManifest;
+/**
+ * List all registered adapter vendor ids, sorted alphabetically.
+ * Credential-only vendors are not included: they cannot be passed to `createLlm`.
  */
 declare function listVendors(): string[];
 /**
- * Return an aggregated manifest for all registered adapters. Used by
- * api-server's /llm-vendors/manifest endpoint.
+ * Return an aggregated manifest for all registered vendors, credential-only
+ * ones included. Used by api-server's /llm-vendors/manifest endpoint.
  */
 declare function getManifest(): {
     vendors: AdapterManifest[];
@@ -121,6 +128,8 @@ declare function getManifest(): {
  * Consumers use:
  *   - `createLlm({vendor, auth, client?})` to get a ready-to-stream adapter instance.
  *   - `getManifest()` to enumerate registered vendors (used by api-server).
+ *   - `getVendorManifest(vendor)` for one vendor's manifest, including
+ *     credential-only vendors (e.g. `harness`) that have no adapter.
  *   - `normalizeAuth(vendor, rawCred)` to convert DB-shape creds to AuthSpec.
  *   - `pickAuthKind(vendor, rawCred)` to pick the right manifest authKind for
  *     a raw credential (used by api-server's `encryptCredential`).
@@ -129,4 +138,4 @@ declare function getManifest(): {
 
 declare function createLlm<A extends AuthSpec = AuthSpec>(args: CreateLlmArgs<A>): Promise<LlmAdapter<A>>;
 
-export { AdapterFactory, AdapterManifest, AuthKindSchema, AuthSpec, CreateLlmArgs, LlmAdapter, PromptRequest, type RawCredential, type RawCredentialLoose, ServiceAccountJson, assertValidRequest, createLlm, getAdapterFactory, getManifest, listVendors, normalizeAuth, pickAuthKind, registerAdapter, replaceAdapter, unregisterAdapter };
+export { AdapterFactory, AdapterManifest, AuthKindSchema, AuthSpec, CreateLlmArgs, LlmAdapter, PromptRequest, type RawCredential, type RawCredentialLoose, ServiceAccountJson, assertValidRequest, createLlm, getAdapterFactory, getManifest, getVendorManifest, listVendors, normalizeAuth, pickAuthKind, registerAdapter, replaceAdapter, unregisterAdapter };

package/dist/index.js

@@ -1,7 +1,8 @@
 // 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.`
     );
@@ -13,6 +14,15 @@ 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 replaceAdapter(factory) {
   registry.set(factory.vendor, factory);
 }
@@ -22,6 +32,11 @@ function unregisterAdapter(vendor) {
 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}`
@@ -29,11 +44,22 @@ function getAdapterFactory(vendor) {
   }
   return factory;
 }
+function getVendorManifest(vendor) {
+  const manifest = registry.get(vendor)?.manifest ?? credentialVendors.get(vendor);
+  if (!manifest) {
+    const known = [...registry.keys(), ...credentialVendors.keys()].sort().join(", ") || "(none)";
+    throw new Error(`Unknown vendor '${vendor}'. Registered vendors: ${known}`);
+  }
+  return manifest;
+}
 function listVendors() {
   return Array.from(registry.keys()).sort();
 }
 function getManifest() {
-  const vendors = Array.from(registry.values()).map((f) => f.manifest).sort((a, b) => a.vendor.localeCompare(b.vendor));
+  const vendors = [
+    ...Array.from(registry.values()).map((f) => f.manifest),
+    ...credentialVendors.values()
+  ].map((m) => ({ ...m, category: m.category ?? "llm" })).sort((a, b) => a.vendor.localeCompare(b.vendor));
   return { vendors };
 }
 
@@ -3725,6 +3751,92 @@ var openRouterFactory = {
   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,
+  category: "llm"
+};
+
+// src/vendors/dialogflow-ces.ts
+var dialogflowCesManifest = {
+  vendor: "dialogflow_ces",
+  displayName: "Dialogflow CES",
+  authKinds: [
+    {
+      kind: "googleServiceAccount",
+      displayName: "Service Account JSON",
+      fields: [
+        {
+          name: "credentials",
+          label: "Service Account Key (JSON)",
+          type: "json-file",
+          required: true,
+          help: "The key of a service account allowed to run your CES agents (Customer Engagement Suite)."
+        }
+      ]
+    }
+  ],
+  knownModels: [],
+  supportsModelListing: false,
+  docsUrl: "https://cloud.google.com/customer-engagement-ai/conversational-agents/ps",
+  credentialOnly: true,
+  category: "hosted"
+};
+
+// src/vendors/openai-s2s.ts
+var openaiS2sManifest = {
+  vendor: "openai_s2s",
+  displayName: "OpenAI Realtime",
+  authKinds: [
+    {
+      kind: "apiKey",
+      displayName: "API Key",
+      fields: [
+        {
+          name: "apiKey",
+          label: "API Key",
+          type: "password",
+          required: true,
+          help: "An OpenAI API key with access to the Realtime API."
+        }
+      ]
+    }
+  ],
+  knownModels: [],
+  supportsModelListing: false,
+  docsUrl: "https://platform.openai.com/docs/guides/realtime",
+  credentialOnly: true,
+  category: "s2s"
+};
+
 // src/adapters/index.ts
 registerAdapter(openAIFactory);
 registerAdapter(deepseekFactory);
@@ -3742,6 +3854,9 @@ registerAdapter(azureOpenAIFactory);
 registerAdapter(groqFactory);
 registerAdapter(huggingfaceFactory);
 registerAdapter(openRouterFactory);
+registerCredentialVendor(harnessManifest);
+registerCredentialVendor(openaiS2sManifest);
+registerCredentialVendor(dialogflowCesManifest);
 
 // src/normalize-auth.ts
 function normalizeAuth(vendor, raw) {
@@ -3889,8 +4004,7 @@ function parseServiceKey(value) {
 
 // src/pick-auth-kind.ts
 function pickAuthKind(vendor, raw) {
-  const factory = getAdapterFactory(vendor);
-  const { authKinds } = factory.manifest;
+  const { authKinds } = getVendorManifest(vendor);
   if (authKinds.length === 1) {
     return authKinds[0];
   }
@@ -3950,6 +4064,7 @@ export {
   createLlm,
   getAdapterFactory,
   getManifest,
+  getVendorManifest,
   listVendors,
   normalizeAuth,
   pickAuthKind,