@jambonz/llm 0.2.7 → 0.3.0

package/dist/{types-bq1XMi_T.d.cts → types-4d2QrlAe.d.cts}

@@ -269,6 +269,28 @@ interface LlmAdapter<A extends AuthSpec = AuthSpec> {
      * in that case.
      */
     listAvailableModels(): Promise<ModelInfo[]>;
+    /**
+     * Verify the credential this adapter was initialized with. This is an auth
+     * check, not a capability check — success means "the vendor accepts these
+     * credentials"; it does not imply any specific model is accessible.
+     *
+     * Each adapter picks the cheapest authenticated call available:
+     *   - Vendors with a list-models endpoint call it and discard the result.
+     *   - Vendors without a list-models endpoint (Vertex-OpenAI, the OpenAI-
+     *     compatible MaaS layer) mint a bearer token or hit a zero-cost auth
+     *     endpoint.
+     *
+     * Resolves on success, throws on failure. Failure messages should surface
+     * the vendor's own error (401/403 for bad credentials, 404 for missing
+     * project, etc.) so operators can diagnose without guessing.
+     *
+     * Callers (e.g., api-server's POST/PUT credential routes) use this instead
+     * of streaming a probe prompt. Avoid reaching for a stream probe as a
+     * fallback: it requires a specific model grant, which is an accidental
+     * coupling between "is this credential valid" and "does this account have
+     * Mistral/Llama/etc. enabled".
+     */
+    testCredential(): Promise<void>;
     /**
      * Optional: pre-establish connection to the vendor API. Useful for reducing
      * cold-start latency on the first prompt. No-op if not implemented.

package/dist/{types-bq1XMi_T.d.ts → types-4d2QrlAe.d.ts}

@@ -269,6 +269,28 @@ interface LlmAdapter<A extends AuthSpec = AuthSpec> {
      * in that case.
      */
     listAvailableModels(): Promise<ModelInfo[]>;
+    /**
+     * Verify the credential this adapter was initialized with. This is an auth
+     * check, not a capability check — success means "the vendor accepts these
+     * credentials"; it does not imply any specific model is accessible.
+     *
+     * Each adapter picks the cheapest authenticated call available:
+     *   - Vendors with a list-models endpoint call it and discard the result.
+     *   - Vendors without a list-models endpoint (Vertex-OpenAI, the OpenAI-
+     *     compatible MaaS layer) mint a bearer token or hit a zero-cost auth
+     *     endpoint.
+     *
+     * Resolves on success, throws on failure. Failure messages should surface
+     * the vendor's own error (401/403 for bad credentials, 404 for missing
+     * project, etc.) so operators can diagnose without guessing.
+     *
+     * Callers (e.g., api-server's POST/PUT credential routes) use this instead
+     * of streaming a probe prompt. Avoid reaching for a stream probe as a
+     * fallback: it requires a specific model grant, which is an accidental
+     * coupling between "is this credential valid" and "does this account have
+     * Mistral/Llama/etc. enabled".
+     */
+    testCredential(): Promise<void>;
     /**
      * Optional: pre-establish connection to the vendor API. Useful for reducing
      * cold-start latency on the first prompt. No-op if not implemented.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jambonz/llm",
-  "version": "0.2.7",
+  "version": "0.3.0",
   "description": "Voice-oriented LLM adapter library — a uniform interface for streaming chat completions from multiple LLM vendors, with first-class support for tool calls, AbortSignal interruption, and lossless history round-tripping.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -70,7 +70,6 @@
     }
   },
   "devDependencies": {
-    "@aws-sdk/client-bedrock": "^3.1036.0",
     "@eslint/js": "^9.17.0",
     "@types/node": "^22.10.0",
     "@vitest/coverage-v8": "^3.0.0",
@@ -85,6 +84,7 @@
   },
   "dependencies": {
     "@anthropic-ai/sdk": "^0.91.0",
+    "@aws-sdk/client-bedrock": "^3.1036.0",
     "@aws-sdk/client-bedrock-runtime": "^3.1036.0",
     "@google/genai": "^1.50.1",
     "google-auth-library": "^10.6.2",