adonis-ai-kit 1.1.0 → 1.2.0

package/dist/src/error_classifier.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error_classifier.d.ts","sourceRoot":"","sources":["../../src/error_classifier.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;CACf;AA2CD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,mBAAmB,CA0C5F"}
+{"version":3,"file":"error_classifier.d.ts","sourceRoot":"","sources":["../../src/error_classifier.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,MAAM,MAAM,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,SAAS,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,4EAA4E;IAC5E,UAAU,EAAE,UAAU,CAAA;IACtB,6GAA6G;IAC7G,eAAe,EAAE,OAAO,CAAA;CACzB;AA+DD;;;;;;GAMG;AACH,MAAM,MAAM,UAAU,GAClB,YAAY,GACZ,YAAY,GACZ,SAAS,GACT,YAAY,GACZ,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,qBAAqB,GACrB,SAAS,CAAA;AAkBb;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CA0B7D;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEhE;AAUD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAEtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,WAAW,GAAG,mBAAmB,CAqC5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAyBrE"}

package/dist/src/error_classifier.js

@@ -1,5 +1,4 @@
 import { AiException, ProviderUnavailableError } from './errors.js';
-const RETRYABLE_STATUS = new Set([408, 409, 425, 429]);
 const NETWORK_CODES = new Set([
     'ECONNRESET',
     'ECONNREFUSED',
@@ -27,54 +26,181 @@ const FATAL_NAMES = new Set([
     'AI_LoadAPIKeyError',
     'ZodError',
 ]);
-function statusOf(err) {
-    const candidates = [err.statusCode, err.status, err.response?.status, err.cause?.statusCode, err.cause?.status];
-    return candidates.find((c) => typeof c === 'number');
+const NETWORK_MESSAGE = /fetch failed|network|socket hang up|timed? ?out|connection (reset|refused|closed)/i;
+/**
+ * Returns the first value `pick` extracts from the error or from its `cause` / `lastError`
+ * chain (AI SDK `RetryError` keeps the real failure in `lastError`), looking at most `depth` levels down.
+ */
+function findErrorField(error, pick, depth = 5) {
+    if (error === null || typeof error !== 'object')
+        return undefined;
+    const node = error;
+    const own = pick(node);
+    if (own !== undefined)
+        return own;
+    if (depth <= 0)
+        return undefined;
+    return findErrorField(node.cause, pick, depth - 1) ?? findErrorField(node.lastError, pick, depth - 1);
+}
+const asNumber = (v) => (typeof v === 'number' ? v : undefined);
+function statusOf(error) {
+    return findErrorField(error, (n) => asNumber(n.statusCode) ?? asNumber(n.status) ?? asNumber(n.response?.status));
+}
+function codeOf(error) {
+    return findErrorField(error, (n) => (typeof n.code === 'string' ? n.code : undefined));
+}
+function classByStatusCode(status, message) {
+    if (status === 429)
+        return 'rate_limit';
+    if (status === 529 || status === 409 || status === 425)
+        return 'overloaded';
+    if (status === 408)
+        return 'timeout';
+    if (status === 401 || status === 403)
+        return 'auth_error';
+    if (status === 404)
+        return 'model_not_found';
+    if (status === 400) {
+        if (message.includes('too long') || message.includes('max_tokens') || message.includes('context length')) {
+            return 'prompt_too_long';
+        }
+        return 'invalid_request';
+    }
+    if (status >= 500)
+        return 'server_error';
+    return 'unknown';
+}
+/**
+ * Classifies an error into the fine-grained {@link ErrorClass} taxonomy.
+ * The HTTP status and error code are looked up through the `cause` / `lastError` chain.
+ */
+export function classifyErrorClass(error) {
+    const isObject = error !== null && typeof error === 'object';
+    const name = isObject ? error.name : undefined;
+    const message = isObject ? String(error.message ?? '') : '';
+    const status = statusOf(error);
+    if (status !== undefined)
+        return classByStatusCode(status, message);
+    if (name === 'AI_NoOutputGeneratedError' || name === 'NoOutputGeneratedError') {
+        if (message.includes('403') || message.includes('401'))
+            return 'auth_error';
+        if (message.includes('429'))
+            return 'rate_limit';
+        if (message.includes('500') || message.includes('502') || message.includes('503'))
+            return 'server_error';
+        return 'no_output_generated';
+    }
+    if (name === 'TimeoutError')
+        return 'timeout';
+    const code = codeOf(error);
+    if (code && NETWORK_CODES.has(code))
+        return 'network_error';
+    if (message.includes('fetch failed') || message.includes('ECONNREFUSED') || message.includes('ENOTFOUND')) {
+        return 'network_error';
+    }
+    if (message.includes('timeout') || message.includes('ETIMEDOUT'))
+        return 'timeout';
+    if (message.includes('too long') || message.includes('context length'))
+        return 'prompt_too_long';
+    return 'unknown';
 }
-function codeOf(err) {
-    const c = err.code ?? err.cause?.code;
-    return typeof c === 'string' ? c : undefined;
+const RETRYABLE_ERROR_CLASSES = new Set([
+    'rate_limit',
+    'overloaded',
+    'timeout',
+    'server_error',
+    'network_error',
+    'prompt_too_long',
+    'no_output_generated',
+]);
+/**
+ * Whether an error class is transient and therefore eligible for fallback routing.
+ */
+export function isRetryableError(errorClass) {
+    return RETRYABLE_ERROR_CLASSES.has(errorClass);
+}
+const BREAKER_ERROR_CLASSES = new Set([
+    'rate_limit',
+    'overloaded',
+    'timeout',
+    'server_error',
+    'network_error',
+]);
+/**
+ * Whether an error class reflects upstream health and should count against the circuit breaker.
+ * `prompt_too_long` and `no_output_generated` fall back to another model but never open the breaker.
+ */
+export function countsAsBreakerFailure(errorClass) {
+    return BREAKER_ERROR_CLASSES.has(errorClass);
 }
 /**
  * Classifies an error for fallback / circuit-breaker decisions.
  * `abortSignal` is the caller's signal: when it is aborted the failure is the caller's doing.
  */
 export function classifyError(error, abortSignal) {
+    const outcome = (kind, reason, errorClass = 'unknown') => ({
+        kind,
+        reason,
+        errorClass,
+        countsAsFailure: kind === 'retryable' && countsAsBreakerFailure(errorClass),
+    });
     if (abortSignal?.aborted)
-        return { kind: 'fatal', reason: 'aborted by caller' };
-    if (error instanceof ProviderUnavailableError) {
-        return { kind: 'skip', reason: 'circuit breaker open' };
-    }
+        return outcome('fatal', 'aborted by caller');
+    if (error instanceof ProviderUnavailableError)
+        return outcome('skip', 'circuit breaker open');
     if (error instanceof AiException &&
         (error.code === 'E_AI_MISSING_DEPENDENCY' || error.code === 'E_AI_CONFIG_ERROR')) {
-        return { kind: 'skip', reason: error.code };
-    }
-    if (error === null || typeof error !== 'object') {
-        return { kind: 'fatal', reason: 'unknown error' };
+        return outcome('skip', error.code);
     }
+    if (error === null || typeof error !== 'object')
+        return outcome('fatal', 'unknown error');
     const err = error;
     if (err.name === 'AbortError')
-        return { kind: 'fatal', reason: 'aborted' };
+        return outcome('fatal', 'aborted');
     if (FATAL_NAMES.has(err.name))
-        return { kind: 'fatal', reason: `validation (${err.name})` };
-    const status = statusOf(err);
-    if (status !== undefined) {
-        if (status >= 500 || RETRYABLE_STATUS.has(status)) {
-            return { kind: 'retryable', reason: `HTTP ${status}` };
+        return outcome('fatal', `validation (${err.name})`);
+    const errorClass = classifyErrorClass(error);
+    if (isRetryableError(errorClass))
+        return outcome('retryable', errorClass, errorClass);
+    if (errorClass !== 'unknown')
+        return outcome('fatal', errorClass, errorClass);
+    // Unclassified: keep the loose heuristics, but never override an explicit HTTP status.
+    if (statusOf(error) === undefined) {
+        if (NETWORK_MESSAGE.test(typeof err.message === 'string' ? err.message : '')) {
+            return outcome('retryable', 'network', 'network_error');
         }
-        return { kind: 'fatal', reason: `HTTP ${status}` };
+        if (err.isRetryable === true)
+            return outcome('retryable', 'provider marked retryable');
     }
-    if (err.name === 'TimeoutError')
-        return { kind: 'retryable', reason: 'timeout' };
-    const code = codeOf(err);
-    if (code && NETWORK_CODES.has(code))
-        return { kind: 'retryable', reason: `network (${code})` };
-    const message = typeof err.message === 'string' ? err.message : '';
-    if (/fetch failed|network|socket hang up|timed? ?out|connection (reset|refused|closed)/i.test(message)) {
-        return { kind: 'retryable', reason: 'network' };
+    return outcome('fatal', 'unclassified error');
+}
+/**
+ * Human-readable message for an error class, safe to show to an operator.
+ */
+export function getUserFriendlyMessage(errorClass) {
+    switch (errorClass) {
+        case 'rate_limit':
+            return 'Rate limited by API provider';
+        case 'overloaded':
+            return 'API provider overloaded';
+        case 'timeout':
+            return 'API request timed out';
+        case 'auth_error':
+            return 'API authentication failed — check API key';
+        case 'model_not_found':
+            return 'Model not found — check LLM_MODEL config';
+        case 'prompt_too_long':
+            return 'Context too large for model — consider compaction';
+        case 'invalid_request':
+            return 'Invalid API request';
+        case 'server_error':
+            return 'API server error';
+        case 'network_error':
+            return 'Network error — check connectivity';
+        case 'no_output_generated':
+            return 'Model produced no output — transient error, will retry';
+        default:
+            return 'Unknown API error';
     }
-    if (err.isRetryable === true)
-        return { kind: 'retryable', reason: 'provider marked retryable' };
-    return { kind: 'fatal', reason: 'unclassified error' };
 }
 //# sourceMappingURL=error_classifier.js.map

package/dist/src/error_classifier.js.map

@@ -1 +1 @@
-{"version":3,"file":"error_classifier.js","sourceRoot":"","sources":["../../src/error_classifier.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"error_classifier.js","sourceRoot":"","sources":["../../src/error_classifier.ts"],"names":[],"mappings":"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"}

package/dist/src/guard/registry.d.ts

@@ -7,6 +7,12 @@ export interface ToolAccessOptions {
     timeoutMs?: number;
     /** Agent whose permission matrix applies in `getToolsByList()`. */
     agentName?: string;
+    /**
+     * Per-call permission map. When given, it is the only source of permissions for this call:
+     * tools missing from it get the registry's `defaultPermission`. The agent matrix is neither
+     * read nor modified, so nothing leaks into later calls.
+     */
+    permissions?: Record<string, ToolPermission>;
 }
 export interface WrapToolOptions extends ToolAccessOptions {
     /**

package/dist/src/guard/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/guard/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAG5D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,cAAc,CAAA;CACnC;AAED;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,kBAAkB,CAAyC;IACnE,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAQ;gBAEX,IAAI,GAAE,mBAAwB;IAM1C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,CAAC,EAAE,cAAc,GAAG,IAAI;IAQ1F,aAAa,CACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,iBAAiB,CAAC,EAAE,cAAc,GACjC,IAAI;IAOP,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IASzF,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAcvE;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc;IA8F3F;;;OAGG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAWjC;;;OAGG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAiBjC,OAAO,CAAC,WAAW;CAuBpB"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/guard/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,cAAc,EACd,cAAc,EACf,MAAM,YAAY,CAAA;AACnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAG5D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAA;CAC7C;AAED,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD;;;;;OAKG;IACH,UAAU,CAAC,EAAE,cAAc,CAAA;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,cAAc,CAAA;CACnC;AASD;;;;;;GAMG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAyC;IACtD,OAAO,CAAC,gBAAgB,CAAsD;IAC9E,OAAO,CAAC,kBAAkB,CAAyC;IACnE,OAAO,CAAC,YAAY,CAAa;IACjC,OAAO,CAAC,iBAAiB,CAAgB;IACzC,OAAO,CAAC,MAAM,CAAC,CAAQ;gBAEX,IAAI,GAAE,mBAAwB;IAM1C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI/B,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,iBAAiB,CAAC,EAAE,cAAc,GAAG,IAAI;IAQ1F,aAAa,CACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACrC,iBAAiB,CAAC,EAAE,cAAc,GACjC,IAAI;IAOP,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,GAAG,IAAI;IASzF,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,cAAc;IAcvE;;;OAGG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc;IA8F3F;;;OAGG;IACH,gBAAgB,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAWjC;;;OAGG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,GAAE,iBAAsB,GAC9B,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAiBjC,OAAO,CAAC,WAAW;CA2BpB"}

package/dist/src/guard/registry.js

@@ -1,4 +1,10 @@
 import { PolicyViolationError } from './errors.js';
+/** A tool description may be a function (AI SDK v7); fall back to the tool name then. */
+function describeTool(tool, fallback) {
+    return typeof tool.description === 'string' && tool.description.length > 0
+        ? tool.description
+        : fallback;
+}
 /**
  * Registry for managing AI agent tools, access permissions, policy guards,
  * and Human-in-the-loop confirmation hooks.
@@ -102,7 +108,7 @@ export class ToolRegistry {
                         const confirmation = await options.confirmation.waitForResponse({
                             sessionId: options.sessionId,
                             toolName: name,
-                            action: tool.description || name,
+                            action: describeTool(tool, name),
                             params: args ?? {},
                         }, options.timeoutMs, execOptions?.abortSignal);
                         if (confirmation.status !== 'approved') {
@@ -166,7 +172,11 @@ export class ToolRegistry {
         return result;
     }
     resolveTool(agentName, name, tool, options) {
-        const permission = this.getAgentPermission(agentName, name);
+        const permission = options.permissions
+            ? Object.hasOwn(options.permissions, name)
+                ? options.permissions[name]
+                : this.defaultPermission
+            : this.getAgentPermission(agentName, name);
         if (permission === 'deny') {
             return null;
         }

package/dist/src/guard/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/guard/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/guard/registry.ts"],"names":[],"mappings":"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"}

package/dist/src/guard/types.d.ts

@@ -1,16 +1,15 @@
-export interface Logger {
-    info(message: string, ...args: unknown[]): void;
-    warn(message: string, ...args: unknown[]): void;
-    error(message: string, ...args: unknown[]): void;
-    debug?(message: string, ...args: unknown[]): void;
-}
+export type { Logger } from '../logger.js';
 export type ToolPermission = 'allow' | 'ask' | 'deny';
 /**
  * Structural shape of an AI SDK tool (v5+: `inputSchema`; legacy v4 tools used `parameters`).
  * Extra keys (`outputSchema`, `providerOptions`, ...) are preserved when a tool is wrapped.
  */
 export interface ToolDefinition<TArgs = any, TResult = any> {
-    description?: string;
+    /**
+     * Tool description. AI SDK v7 also allows a function that builds the description
+     * from the call context, so both shapes are accepted.
+     */
+    description?: string | ((options: any) => string);
     inputSchema?: unknown;
     /** @deprecated AI SDK v4 name of `inputSchema`. */
     parameters?: unknown;

package/dist/src/guard/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/guard/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAChD,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAClD;AAED,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAErD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACxD,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IACpE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAErD;;OAEG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAEhD;;;OAGG;IACH,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/guard/types.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAA;AAErD;;;GAGG;AACH,MAAM,WAAW,cAAc,CAAC,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,GAAG;IACxD;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,KAAK,MAAM,CAAC,CAAA;IACjD,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,mDAAmD;IACnD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAA;IACpE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC9D,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,OAAO,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;IACvD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,CAAA;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAAA;IAErD;;OAEG;IACH,MAAM,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;IAEhD;;;OAGG;IACH,OAAO,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAEhC;;OAEG;IACH,OAAO,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,MAAM,CAAA;IAChB,QAAQ,EAAE,OAAO,CAAA;CAClB"}

package/dist/src/index.d.ts

@@ -1,5 +1,7 @@
 export * from './types.js';
+export type { Logger } from './logger.js';
 export * from './errors.js';
+export * from './error_classifier.js';
 export * from './circuit_breaker.js';
 export * from './define_config.js';
 export * from './ai_manager.js';
@@ -9,5 +11,6 @@ export * from './acp/index.js';
 export * from './agents/index.js';
 export * from './guard/index.js';
 export * from './budget/index.js';
-export type { ToolPermission, Logger } from './guard/index.js';
+export * from './models/index.js';
+export type { ToolPermission } from './guard/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AAGjC,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,YAAY,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACzC,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AAGjC,YAAY,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/index.js

@@ -1,5 +1,6 @@
 export * from './types.js';
 export * from './errors.js';
+export * from './error_classifier.js';
 export * from './circuit_breaker.js';
 export * from './define_config.js';
 export * from './ai_manager.js';
@@ -9,4 +10,5 @@ export * from './acp/index.js';
 export * from './agents/index.js';
 export * from './guard/index.js';
 export * from './budget/index.js';
+export * from './models/index.js';
 //# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAA;AAE1B,cAAc,aAAa,CAAA;AAC3B,cAAc,uBAAuB,CAAA;AACrC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}

package/dist/src/logger.d.ts

@@ -0,0 +1,7 @@
+export interface Logger {
+    debug?(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CACjD"}

package/dist/src/logger.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.js.map

package/dist/src/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/logger.ts"],"names":[],"mappings":""}

package/dist/src/models/catalog_resolver.d.ts

@@ -0,0 +1,24 @@
+import type { AcpRuntimeOptions } from '../acp/types.js';
+import type { ModelsDevCatalog } from '../catalog/models_dev.js';
+import type { ResolvedModel } from './types.js';
+export interface ModelResolver {
+    resolve(ref?: string): Promise<ResolvedModel>;
+}
+export interface CatalogModelResolverOptions {
+    catalog: {
+        load(): Promise<ModelsDevCatalog>;
+    };
+    /** Model reference used when `resolve()` is called without one. */
+    defaultModelRef?: () => string | undefined;
+    /** Provider to use for refs that are not provider-prefixed. */
+    explicitProvider?: () => string | undefined;
+    /** Default: the first non-empty `process.env[name]`. */
+    getApiKey?: (envNames: string[]) => string | undefined;
+    acp?: AcpRuntimeOptions;
+}
+export declare class CatalogModelResolver implements ModelResolver {
+    private readonly options;
+    constructor(options: CatalogModelResolverOptions);
+    resolve(ref?: string): Promise<ResolvedModel>;
+}
+//# sourceMappingURL=catalog_resolver.d.ts.map

package/dist/src/models/catalog_resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_resolver.d.ts","sourceRoot":"","sources":["../../../src/models/catalog_resolver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE;QAAE,IAAI,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAA;KAAE,CAAA;IAC9C,mEAAmE;IACnE,eAAe,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAC1C,+DAA+D;IAC/D,gBAAgB,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAA;IAC3C,wDAAwD;IACxD,SAAS,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,MAAM,GAAG,SAAS,CAAA;IACtD,GAAG,CAAC,EAAE,iBAAiB,CAAA;CACxB;AAYD,qBAAa,oBAAqB,YAAW,aAAa;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,2BAA2B;IAE3D,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;CAkDpD"}

package/dist/src/models/catalog_resolver.js

@@ -0,0 +1,66 @@
+import { buildAcpRuntimeConfig } from '../acp/acp_agents.js';
+import { parseModelRef } from './model_ref.js';
+import { resolveProviderNpm } from './protocols.js';
+const ACP_NPM = '@mcpc-tech/acp-ai-provider';
+function firstEnvValue(envNames) {
+    for (const name of envNames) {
+        const value = process.env[name];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+export class CatalogModelResolver {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async resolve(ref) {
+        const { options } = this;
+        const catalog = await options.catalog.load();
+        const resolved = ref || options.defaultModelRef?.();
+        const explicitProvider = options.explicitProvider?.();
+        let providerID;
+        let modelID;
+        if (resolved) {
+            const parsed = parseModelRef({
+                modelRef: resolved,
+                explicitProvider,
+                knownProviderIds: Object.keys(catalog),
+            });
+            providerID = parsed.providerId;
+            modelID = parsed.modelId;
+            if (!catalog[providerID])
+                throw new Error(`Unknown provider: ${providerID}`);
+        }
+        else {
+            providerID = explicitProvider || '';
+            if (!catalog[providerID])
+                throw new Error('A model or provider is required');
+            modelID = Object.keys(catalog[providerID].models)[0];
+        }
+        const provider = catalog[providerID];
+        if (!provider.models[modelID] && resolved && provider.models[resolved]) {
+            modelID = resolved;
+        }
+        const modelInfo = provider.models[modelID];
+        const apiKey = (options.getApiKey ?? firstEnvValue)(provider.env ?? []);
+        const npm = resolveProviderNpm({ npmPackage: provider.npm, protocol: provider.protocol });
+        if (provider.protocol === 'acp') {
+            const agentId = modelID || Object.keys(provider.models)[0];
+            const acpConfig = buildAcpRuntimeConfig(agentId, options.acp);
+            if (acpConfig) {
+                return { providerID, modelID: agentId, npm: npm || ACP_NPM, acpAgentId: agentId, acpConfig };
+            }
+        }
+        return {
+            providerID,
+            modelID,
+            apiUrl: provider.api,
+            npm,
+            apiKey,
+            headers: modelInfo?.headers,
+        };
+    }
+}
+//# sourceMappingURL=catalog_resolver.js.map

package/dist/src/models/catalog_resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog_resolver.js","sourceRoot":"","sources":["../../../src/models/catalog_resolver.ts"],"names":[],"mappings":"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"}

package/dist/src/models/index.d.ts

@@ -0,0 +1,14 @@
+export type { ResolvedModel } from './types.js';
+export { parseModelRef } from './model_ref.js';
+export type { ParseModelRefOptions, ParsedModelRef } from './model_ref.js';
+export { modelKeyFor, breakerKeyFor } from './keys.js';
+export { PROTOCOL_TO_NPM, resolveProviderNpm } from './protocols.js';
+export { BUILTIN_PROVIDER_EXPORTS, ProviderFactoryRegistry } from './provider_factories.js';
+export type { ProviderFactory } from './provider_factories.js';
+export { LanguageModelFactory } from './language_model_factory.js';
+export type { LanguageModelFactoryOptions } from './language_model_factory.js';
+export { CatalogModelResolver } from './catalog_resolver.js';
+export type { CatalogModelResolverOptions, ModelResolver } from './catalog_resolver.js';
+export { buildChainCandidates, runModelChain } from './model_chain.js';
+export type { ChainAttempt, ChainCandidate, FallbackEvent, ModelChainOptions, } from './model_chain.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/models/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAC9C,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC1E,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAC3F,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAA;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAClE,YAAY,EAAE,2BAA2B,EAAE,MAAM,6BAA6B,CAAA;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAC5D,YAAY,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACvF,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACtE,YAAY,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,iBAAiB,GAClB,MAAM,kBAAkB,CAAA"}

package/dist/src/models/index.js

@@ -0,0 +1,8 @@
+export { parseModelRef } from './model_ref.js';
+export { modelKeyFor, breakerKeyFor } from './keys.js';
+export { PROTOCOL_TO_NPM, resolveProviderNpm } from './protocols.js';
+export { BUILTIN_PROVIDER_EXPORTS, ProviderFactoryRegistry } from './provider_factories.js';
+export { LanguageModelFactory } from './language_model_factory.js';
+export { CatalogModelResolver } from './catalog_resolver.js';
+export { buildChainCandidates, runModelChain } from './model_chain.js';
+//# sourceMappingURL=index.js.map

package/dist/src/models/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/models/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AAE9C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AACpE,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAA;AAE3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAA;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAE5D,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/src/models/keys.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedModel } from './types.js';
+export declare function modelKeyFor(m: Pick<ResolvedModel, 'providerID' | 'modelID'>): string;
+/**
+ * Identity used for circuit-breaker lookups. Two credentials of the same
+ * provider/model are different failure domains, so a non-empty credential key
+ * wins; otherwise the plain `provider/model` key is used.
+ */
+export declare function breakerKeyFor(m: Pick<ResolvedModel, 'providerID' | 'modelID' | 'credentialKey'>): string;
+//# sourceMappingURL=keys.d.ts.map

package/dist/src/models/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../../../src/models/keys.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,wBAAgB,WAAW,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,SAAS,CAAC,GAAG,MAAM,CAEpF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAC3B,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,YAAY,GAAG,SAAS,GAAG,eAAe,CAAC,GACjE,MAAM,CAER"}

package/dist/src/models/keys.js

@@ -0,0 +1,12 @@
+export function modelKeyFor(m) {
+    return `${m.providerID}/${m.modelID}`;
+}
+/**
+ * Identity used for circuit-breaker lookups. Two credentials of the same
+ * provider/model are different failure domains, so a non-empty credential key
+ * wins; otherwise the plain `provider/model` key is used.
+ */
+export function breakerKeyFor(m) {
+    return m.credentialKey ? m.credentialKey : modelKeyFor(m);
+}
+//# sourceMappingURL=keys.js.map

package/dist/src/models/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/models/keys.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,WAAW,CAAC,CAAgD;IAC1E,OAAO,GAAG,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;AACvC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAC3B,CAAkE;IAElE,OAAO,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;AAC3D,CAAC"}