@hoilab/ada-cli 0.85.0 → 0.85.3

package/dist/core/config-viva/cache-negativa.js

@@ -0,0 +1,78 @@
+/**
+ * C07 — Negative-cache con TTL para valores de config que son comandos
+ * (`!cmd`) (AUDITORIA-OMP.md C07).
+ *
+ * Problema en resolve-config-value.ts: `commandResultCache` guarda el
+ * resultado AUNQUE sea undefined y para SIEMPRE (vida del proceso). Un
+ * password manager bloqueado o una red caída en el momento de la primera
+ * lectura desactiva la clave para siempre, además sin límite de re-ejecuciones
+ * cuando se decide no cachear.
+ *
+ * Este envoltorio corrige la dirección que falta:
+ *  - éxito  → caché positiva permanente (misma semántica que upstream);
+ *  - fallo (undefined O throw) → caché NEGATIVA con TTL configurable
+ *    (30s por defecto): dentro del TTL no se re-ejecuta el comando; expirado,
+ *    la siguiente lectura vuelve a intentarlo.
+ *
+ * Pensado sobre `resolveConfigValueUncached` (que nunca cachea) para no
+ * depender del Map interno de upstream.
+ */
+/** TTL por defecto de los fallos: 30 s (C07). */
+export const TTL_CACHE_NEGATIVA_DEFECTO_MS = 30_000;
+/**
+ * Envuelve `resolver` con caché positiva permanente + negativa con TTL.
+ * Un throw del resolver se trata como fallo cacheable (C07: "exit != 0 o
+ * throw"), no se propaga.
+ */
+export function resolverConCacheNegativa(resolver, opciones = {}) {
+    const ttlMs = opciones.ttlMs ?? TTL_CACHE_NEGATIVA_DEFECTO_MS;
+    const ahora = opciones.ahora ?? Date.now;
+    const positivos = new Map();
+    // clave → timestamp de expiración del fallo.
+    const negativos = new Map();
+    const stats = {
+        ejecuciones: 0,
+        aciertosPositivos: 0,
+        fallosServidosDeCache: 0,
+        fallosCacheados: 0,
+    };
+    const resuelto = (clave) => {
+        const positivo = positivos.get(clave);
+        if (positivo !== undefined) {
+            stats.aciertosPositivos++;
+            return positivo;
+        }
+        const expiracion = negativos.get(clave);
+        if (expiracion !== undefined) {
+            if (ahora() < expiracion) {
+                stats.fallosServidosDeCache++;
+                return undefined;
+            }
+            negativos.delete(clave);
+        }
+        stats.ejecuciones++;
+        let valor;
+        try {
+            valor = resolver(clave);
+        }
+        catch {
+            valor = undefined;
+        }
+        if (valor !== undefined) {
+            positivos.set(clave, valor);
+        }
+        else {
+            negativos.set(clave, ahora() + ttlMs);
+            stats.fallosCacheados++;
+        }
+        return valor;
+    };
+    const conExtras = resuelto;
+    conExtras.limpiar = () => {
+        positivos.clear();
+        negativos.clear();
+    };
+    conExtras.estadisticas = () => ({ ...stats });
+    return conExtras;
+}
+//# sourceMappingURL=cache-negativa.js.map

package/dist/core/config-viva/cache-negativa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-negativa.js","sourceRoot":"","sources":["../../../src/core/config-viva/cache-negativa.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iDAAiD;AACjD,MAAM,CAAC,MAAM,6BAA6B,GAAG,MAAM,CAAC;AA2BpD;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACvC,QAA+C,EAC/C,WAAkC,EAAE;IAEpC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,6BAA6B,CAAC;IAC9D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IAEzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,6CAA6C;IAC7C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,MAAM,KAAK,GAA8B;QACxC,WAAW,EAAE,CAAC;QACd,iBAAiB,EAAE,CAAC;QACpB,qBAAqB,EAAE,CAAC;QACxB,eAAe,EAAE,CAAC;KAClB,CAAC;IAEF,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAsB,EAAE;QACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC;QACjB,CAAC;QAED,MAAM,UAAU,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,KAAK,EAAE,GAAG,UAAU,EAAE,CAAC;gBAC1B,KAAK,CAAC,qBAAqB,EAAE,CAAC;gBAC9B,OAAO,SAAS,CAAC;YAClB,CAAC;YACD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAED,KAAK,CAAC,WAAW,EAAE,CAAC;QACpB,IAAI,KAAyB,CAAC;QAC9B,IAAI,CAAC;YACJ,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACR,KAAK,GAAG,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACzB,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;YACtC,KAAK,CAAC,eAAe,EAAE,CAAC;QACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,QAAoC,CAAC;IACvD,SAAS,CAAC,OAAO,GAAG,GAAG,EAAE;QACxB,SAAS,CAAC,KAAK,EAAE,CAAC;QAClB,SAAS,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC,CAAC;IACF,SAAS,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC;IAC9C,OAAO,SAAS,CAAC;AAClB,CAAC"}

package/dist/core/config-viva/headers-vivos.d.ts

@@ -0,0 +1,41 @@
+/**
+ * C07 — Headers vivos (AUDITORIA-OMP.md `createLiveConfigHeaders`).
+ *
+ * Algunos proveedores rotan tokens (vault, aws sigv4, scripts propios): sus
+ * headers de config son `!cmd` y el valor de hace 5 minutos ya no vale.
+ * Resolver en CADA lectura martilla el comando; resolver UNA vez congela un
+ * token muerto. Compromiso: snapshot re-resuelto como mucho cada TTL (5s).
+ *
+ * PUNTO EXACTO DE INTEGRACIÓN CON provider-composer (requiere hunk upstream;
+ * presupuesto agotado — patrón C01/D07, se documenta en vez de tocar):
+ *   src/core/provider-composer.ts, `composeApiKeyAuth` → `resolve()`
+ *   (línea ~361) y `composeOAuthAuth` → `toAuth()` (~382), hoy:
+ *       const headers = resolveHeadersOrThrow(rawHeaders, ...);
+ *   quedaría:
+ *       const headers = crearHeadersVivos(
+ *           () => resolveHeadersOrThrow(rawHeaders, `provider "${providerId}"`, headerEnv),
+ *           { ttlMs: 5000 },
+ *       ).get();
+ *   El `.get()` se evalúa por petición (resolve()/toAuth() corren por
+ *   request), así que el token rota con retardo máximo de ttlMs.
+ */
+/** TTL por defecto del snapshot: 5000 ms. */
+export declare const TTL_HEADERS_VIVOS_DEFECTO_MS = 5000;
+export interface OpcionesHeadersVivos {
+    /** Edad máxima del snapshot antes de re-resolver. Default 5000. */
+    ttlMs?: number;
+    /** Reloj inyectable (tests). Default Date.now. */
+    ahora?: () => number;
+}
+export interface HeadersVivos {
+    /**
+     * Devuelve el snapshot de headers, re-resolviendo si el anterior tiene más
+     * de ttlMs. Un fallo del resolver NO se cachea como éxito: devuelve lo que
+     * dé (posiblemente undefined) y la siguiente lectura fuera de TTL reintenta.
+     */
+    get(): Record<string, string> | undefined;
+    /** Descarta el snapshot: la próxima get() re-resuelve seguro. */
+    limpiar(): void;
+}
+export declare function crearHeadersVivos(resolver: () => Record<string, string> | undefined, opciones?: OpcionesHeadersVivos): HeadersVivos;
+//# sourceMappingURL=headers-vivos.d.ts.map

package/dist/core/config-viva/headers-vivos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers-vivos.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/headers-vivos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,4BAA4B,OAAQ,CAAC;AAElD,MAAM,WAAW,oBAAoB;IACpC,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC5B;;;;OAIG;IACH,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC1C,iEAAiE;IACjE,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAClD,QAAQ,GAAE,oBAAyB,GACjC,YAAY,CAmBd"}

package/dist/core/config-viva/headers-vivos.js

@@ -0,0 +1,43 @@
+/**
+ * C07 — Headers vivos (AUDITORIA-OMP.md `createLiveConfigHeaders`).
+ *
+ * Algunos proveedores rotan tokens (vault, aws sigv4, scripts propios): sus
+ * headers de config son `!cmd` y el valor de hace 5 minutos ya no vale.
+ * Resolver en CADA lectura martilla el comando; resolver UNA vez congela un
+ * token muerto. Compromiso: snapshot re-resuelto como mucho cada TTL (5s).
+ *
+ * PUNTO EXACTO DE INTEGRACIÓN CON provider-composer (requiere hunk upstream;
+ * presupuesto agotado — patrón C01/D07, se documenta en vez de tocar):
+ *   src/core/provider-composer.ts, `composeApiKeyAuth` → `resolve()`
+ *   (línea ~361) y `composeOAuthAuth` → `toAuth()` (~382), hoy:
+ *       const headers = resolveHeadersOrThrow(rawHeaders, ...);
+ *   quedaría:
+ *       const headers = crearHeadersVivos(
+ *           () => resolveHeadersOrThrow(rawHeaders, `provider "${providerId}"`, headerEnv),
+ *           { ttlMs: 5000 },
+ *       ).get();
+ *   El `.get()` se evalúa por petición (resolve()/toAuth() corren por
+ *   request), así que el token rota con retardo máximo de ttlMs.
+ */
+/** TTL por defecto del snapshot: 5000 ms. */
+export const TTL_HEADERS_VIVOS_DEFECTO_MS = 5_000;
+export function crearHeadersVivos(resolver, opciones = {}) {
+    const ttlMs = opciones.ttlMs ?? TTL_HEADERS_VIVOS_DEFECTO_MS;
+    const ahora = opciones.ahora ?? Date.now;
+    let snapshot;
+    let resueltoEn = Number.NEGATIVE_INFINITY;
+    return {
+        get() {
+            if (ahora() - resueltoEn < ttlMs)
+                return snapshot;
+            snapshot = resolver();
+            resueltoEn = ahora();
+            return snapshot;
+        },
+        limpiar() {
+            snapshot = undefined;
+            resueltoEn = Number.NEGATIVE_INFINITY;
+        },
+    };
+}
+//# sourceMappingURL=headers-vivos.js.map

package/dist/core/config-viva/headers-vivos.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers-vivos.js","sourceRoot":"","sources":["../../../src/core/config-viva/headers-vivos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,6CAA6C;AAC7C,MAAM,CAAC,MAAM,4BAA4B,GAAG,KAAK,CAAC;AAoBlD,MAAM,UAAU,iBAAiB,CAChC,QAAkD,EAClD,WAAiC,EAAE;IAEnC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,4BAA4B,CAAC;IAC7D,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IAEzC,IAAI,QAA4C,CAAC;IACjD,IAAI,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAE1C,OAAO;QACN,GAAG;YACF,IAAI,KAAK,EAAE,GAAG,UAAU,GAAG,KAAK;gBAAE,OAAO,QAAQ,CAAC;YAClD,QAAQ,GAAG,QAAQ,EAAE,CAAC;YACtB,UAAU,GAAG,KAAK,EAAE,CAAC;YACrB,OAAO,QAAQ,CAAC;QACjB,CAAC;QACD,OAAO;YACN,QAAQ,GAAG,SAAS,CAAC;YACrB,UAAU,GAAG,MAAM,CAAC,iBAAiB,CAAC;QACvC,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/core/config-viva/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Config viva (C05+C07, AUDITORIA-OMP.md).
+ *
+ * - C05: settings con ámbito de ruta ({pathPrefix, values} por cwd).
+ * - C07: negative-cache TTL 30s para `!cmd` + headers vivos re-resueltos.
+ *
+ * Consumidor real mínimo: proveedor de capability "config-viva" (proveedor.ts)
+ * que combina ámbito + caché negativa. La integración con provider-composer
+ * para headers vivos está documentada en headers-vivos.ts (requeriría hunk
+ * upstream; presupuesto agotado — patrón C01/D07).
+ */
+export { type CapaAmbito, resolverValorPorAmbito, type ValorAmbito, type ValorConAmbito, } from "./ambito.ts";
+export { type EstadisticasCacheNegativa, type OpcionesCacheNegativa, type ResolverConCacheNegativa, resolverConCacheNegativa, TTL_CACHE_NEGATIVA_DEFECTO_MS, } from "./cache-negativa.ts";
+export { crearHeadersVivos, type HeadersVivos, type OpcionesHeadersVivos, TTL_HEADERS_VIVOS_DEFECTO_MS, } from "./headers-vivos.ts";
+export { CAPABILITY_CONFIG_VIVA, cacheComandosConfigViva, crearProveedorConfigViva, definirDefinitionConfigViva, type OpcionesProveedorConfigViva, reiniciarCacheComandos, type ValorConfigViva, } from "./proveedor.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/config-viva/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACN,KAAK,UAAU,EACf,sBAAsB,EACtB,KAAK,WAAW,EAChB,KAAK,cAAc,GACnB,MAAM,aAAa,CAAC;AACrB,OAAO,EACN,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,iBAAiB,EACjB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,4BAA4B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAC3B,KAAK,2BAA2B,EAChC,sBAAsB,EACtB,KAAK,eAAe,GACpB,MAAM,gBAAgB,CAAC"}

package/dist/core/config-viva/index.js

@@ -0,0 +1,16 @@
+/**
+ * Config viva (C05+C07, AUDITORIA-OMP.md).
+ *
+ * - C05: settings con ámbito de ruta ({pathPrefix, values} por cwd).
+ * - C07: negative-cache TTL 30s para `!cmd` + headers vivos re-resueltos.
+ *
+ * Consumidor real mínimo: proveedor de capability "config-viva" (proveedor.ts)
+ * que combina ámbito + caché negativa. La integración con provider-composer
+ * para headers vivos está documentada en headers-vivos.ts (requeriría hunk
+ * upstream; presupuesto agotado — patrón C01/D07).
+ */
+export { resolverValorPorAmbito, } from "./ambito.js";
+export { resolverConCacheNegativa, TTL_CACHE_NEGATIVA_DEFECTO_MS, } from "./cache-negativa.js";
+export { crearHeadersVivos, TTL_HEADERS_VIVOS_DEFECTO_MS, } from "./headers-vivos.js";
+export { CAPABILITY_CONFIG_VIVA, cacheComandosConfigViva, crearProveedorConfigViva, definirDefinitionConfigViva, reiniciarCacheComandos, } from "./proveedor.js";
+//# sourceMappingURL=index.js.map

package/dist/core/config-viva/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/config-viva/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEN,sBAAsB,GAGtB,MAAM,aAAa,CAAC;AACrB,OAAO,EAIN,wBAAwB,EACxB,6BAA6B,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,iBAAiB,EAGjB,4BAA4B,GAC5B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,sBAAsB,EACtB,uBAAuB,EACvB,wBAAwB,EACxB,2BAA2B,EAE3B,sBAAsB,GAEtB,MAAM,gBAAgB,CAAC"}

package/dist/core/config-viva/proveedor.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Wiring C05+C07: consumidor real mínimo de config-viva sobre el registro de
+ * capabilities (B01). Cada clave pedida se resuelve por ámbito de ruta para el
+ * cwd del LoadContext; los valores `!cmd` pasan por la caché negativa (TTL 30s)
+ * en vez del cache-permanente-de-fallos de upstream.
+ *
+ * Consumidor verificable: `loadCapability(CAPABILITY_CONFIG_VIVA)` tras
+ * `defineCapability(definirDefinitionConfigViva())` + `registerProvider(...)`
+ * devuelve los valores resueltos con su SourceMeta, y las estadísticas de la
+ * caché permiten contar ejecuciones reales.
+ */
+import type { CapabilityDefinition, CapabilityProvider } from "../capability/index.ts";
+import type { CapaAmbito } from "./ambito.ts";
+import { type ResolverConCacheNegativa } from "./cache-negativa.ts";
+/** ID de la capability registrada en el registry global. */
+export declare const CAPABILITY_CONFIG_VIVA = "config-viva";
+/** Un valor de settings resuelto para un cwd concreto. */
+export interface ValorConfigViva {
+    clave: string;
+    /** Valor resuelto; ausente si era `!cmd` y falló (fallo en caché negativa). */
+    valor?: string;
+    /** true si el origen era un comando `!cmd`. */
+    deComando: boolean;
+}
+export interface OpcionesProveedorConfigViva {
+    /** Claves de settings a resolver (p.ej. ["enabledModels"]). */
+    claves: string[];
+    /**
+     * Capas ordenadas de MÁS a MENOS prioritaria (proyecto primero, global
+     * última) — ver resolverValorPorAmbito.
+     */
+    capas: ReadonlyArray<CapaAmbito>;
+    /** TTL de la caché negativa para `!cmd`. Default 30_000. */
+    ttlMs?: number;
+    /** Reloj inyectable (tests). */
+    ahora?: () => number;
+}
+export declare function cacheComandosConfigViva(opciones?: Pick<OpcionesProveedorConfigViva, "ttlMs" | "ahora">): ResolverConCacheNegativa;
+/** Reinicia la caché de comandos del proceso (tests). */
+export declare function reiniciarCacheComandos(): void;
+/**
+ * Provider de capability "config-viva": resuelve las claves pedidas para el
+ * cwd del contexto usando ámbito de ruta + caché negativa.
+ */
+export declare function crearProveedorConfigViva(opciones: OpcionesProveedorConfigViva): CapabilityProvider<ValorConfigViva>;
+/** Definición de capability: dedup first-wins por clave de settings. */
+export declare function definirDefinitionConfigViva(): CapabilityDefinition<ValorConfigViva>;
+//# sourceMappingURL=proveedor.d.ts.map

package/dist/core/config-viva/proveedor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proveedor.d.ts","sourceRoot":"","sources":["../../../src/core/config-viva/proveedor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EACX,oBAAoB,EACpB,kBAAkB,EAIlB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,OAAO,EAAE,KAAK,wBAAwB,EAA4B,MAAM,qBAAqB,CAAC;AAE9F,4DAA4D;AAC5D,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,0DAA0D;AAC1D,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,+EAA+E;IAC/E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,SAAS,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,2BAA2B;IAC3C,+DAA+D;IAC/D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,KAAK,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACjC,4DAA4D;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gCAAgC;IAChC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACrB;AAQD,wBAAgB,uBAAuB,CAAC,QAAQ,GAAE,IAAI,CAAC,2BAA2B,EAAE,OAAO,GAAG,OAAO,CAAM,4BAK1G;AAED,yDAAyD;AACzD,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAmBD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,2BAA2B,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAoBnH;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,IAAI,oBAAoB,CAAC,eAAe,CAAC,CAOnF"}

package/dist/core/config-viva/proveedor.js

@@ -0,0 +1,78 @@
+/**
+ * Wiring C05+C07: consumidor real mínimo de config-viva sobre el registro de
+ * capabilities (B01). Cada clave pedida se resuelve por ámbito de ruta para el
+ * cwd del LoadContext; los valores `!cmd` pasan por la caché negativa (TTL 30s)
+ * en vez del cache-permanente-de-fallos de upstream.
+ *
+ * Consumidor verificable: `loadCapability(CAPABILITY_CONFIG_VIVA)` tras
+ * `defineCapability(definirDefinitionConfigViva())` + `registerProvider(...)`
+ * devuelve los valores resueltos con su SourceMeta, y las estadísticas de la
+ * caché permiten contar ejecuciones reales.
+ */
+import { isCommandConfigValue, resolveConfigValueUncached } from "../resolve-config-value.js";
+import { resolverValorPorAmbito } from "./ambito.js";
+import { resolverConCacheNegativa } from "./cache-negativa.js";
+/** ID de la capability registrada en el registry global. */
+export const CAPABILITY_CONFIG_VIVA = "config-viva";
+/**
+ * Caché compartida del proceso, indexada por el PROPIO comando (dos claves de
+ * settings con el mismo `!cmd` comparten TTL y estadísticas).
+ */
+let cacheComandos;
+export function cacheComandosConfigViva(opciones = {}) {
+    if (!cacheComandos) {
+        cacheComandos = resolverConCacheNegativa((comando) => resolveConfigValueUncached(`!${comando}`), opciones);
+    }
+    return cacheComandos;
+}
+/** Reinicia la caché de comandos del proceso (tests). */
+export function reiniciarCacheComandos() {
+    cacheComandos?.limpiar();
+    cacheComandos = undefined;
+}
+function resolverClave(clave, ctx, opciones) {
+    const bruto = resolverValorPorAmbito(clave, ctx.cwd, opciones.capas);
+    if (bruto === undefined || typeof bruto !== "string")
+        return undefined;
+    if (!isCommandConfigValue(bruto)) {
+        return { clave, valor: bruto, deComando: false };
+    }
+    const cache = cacheComandosConfigViva(opciones);
+    const valor = cache(bruto.slice(1));
+    return { clave, ...(valor !== undefined ? { valor } : {}), deComando: true };
+}
+/**
+ * Provider de capability "config-viva": resuelve las claves pedidas para el
+ * cwd del contexto usando ámbito de ruta + caché negativa.
+ */
+export function crearProveedorConfigViva(opciones) {
+    return {
+        id: "config-viva",
+        displayName: "Config viva (ámbito de ruta + caché negativa)",
+        description: "Resuelve claves de settings por prefijo de ruta; los !cmd fallidos se reintentan tras el TTL.",
+        priority: 100,
+        async load(ctx) {
+            const items = [];
+            for (const clave of opciones.claves) {
+                const resuelto = resolverClave(clave, ctx, opciones);
+                if (resuelto) {
+                    items.push({
+                        ...resuelto,
+                        _source: { provider: "config-viva", providerName: "Config viva", path: ctx.cwd, level: "native" },
+                    });
+                }
+            }
+            return { items };
+        },
+    };
+}
+/** Definición de capability: dedup first-wins por clave de settings. */
+export function definirDefinitionConfigViva() {
+    return {
+        id: CAPABILITY_CONFIG_VIVA,
+        displayName: "Config viva",
+        description: "Valores de settings vivos resueltos por cwd.",
+        key: (item) => item.clave,
+    };
+}
+//# sourceMappingURL=proveedor.js.map

package/dist/core/config-viva/proveedor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proveedor.js","sourceRoot":"","sources":["../../../src/core/config-viva/proveedor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AASH,OAAO,EAAE,oBAAoB,EAAE,0BAA0B,EAAE,MAAM,4BAA4B,CAAC;AAE9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAiC,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAE9F,4DAA4D;AAC5D,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAyBpD;;;GAGG;AACH,IAAI,aAAmD,CAAC;AAExD,MAAM,UAAU,uBAAuB,CAAC,WAAiE,EAAE;IAC1G,IAAI,CAAC,aAAa,EAAE,CAAC;QACpB,aAAa,GAAG,wBAAwB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,0BAA0B,CAAC,IAAI,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,aAAa,CAAC;AACtB,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,sBAAsB;IACrC,aAAa,EAAE,OAAO,EAAE,CAAC;IACzB,aAAa,GAAG,SAAS,CAAC;AAC3B,CAAC;AAED,SAAS,aAAa,CACrB,KAAa,EACb,GAAgB,EAChB,QAAqC;IAErC,MAAM,KAAK,GAAG,sBAAsB,CAAU,KAAK,EAAE,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAEvE,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,KAAK,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AAC9E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAqC;IAC7E,OAAO;QACN,EAAE,EAAE,aAAa;QACjB,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE,+FAA+F;QAC5G,QAAQ,EAAE,GAAG;QACb,KAAK,CAAC,IAAI,CAAC,GAAgB;YAC1B,MAAM,KAAK,GAAqD,EAAE,CAAC;YACnE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC;gBACrD,IAAI,QAAQ,EAAE,CAAC;oBACd,KAAK,CAAC,IAAI,CAAC;wBACV,GAAG,QAAQ;wBACX,OAAO,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,YAAY,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE;qBACjG,CAAC,CAAC;gBACJ,CAAC;YACF,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,CAAC;QAClB,CAAC;KACD,CAAC;AACH,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,2BAA2B;IAC1C,OAAO;QACN,EAAE,EAAE,sBAAsB;QAC1B,WAAW,EAAE,aAAa;QAC1B,WAAW,EAAE,8CAA8C;QAC3D,GAAG,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK;KACzB,CAAC;AACH,CAAC"}

package/dist/core/context-breakdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-breakdown.d.ts","sourceRoot":"","sources":["../../src/core/context-breakdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,kEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAC1B,cAAc,GACd,iBAAiB,GACjB,QAAQ,GACR,UAAU,GACV,cAAc,GACd,QAAQ,GACR,cAAc,CAAC;AAElB,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,wCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,oDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,gEAA+D;IAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,kEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,6EAA4E;IAC5E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gEAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,gEAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAQD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAmC5E;AAED,uFAAsF;AACtF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAQhE,CAAC","sourcesContent":["/**\n * Desglose de qué está llenando la ventana de contexto.\n *\n * POR QUÉ IMPORTA AQUÍ MÁS QUE EN OTROS PRODUCTOS: con caché por prefijo, el\n * coste de un cambio depende de su POSICIÓN, no de su tamaño. Saber que las\n * definiciones de tools ocupan 11 K y van delante te dice que tocarlas invalida\n * todo lo que viene detrás. Sin este desglose, optimizar la caché es a ciegas.\n *\n * HONESTIDAD DEL DATO — la parte que las referencias no resuelven:\n *\n * El único número REAL es el total, que lo da el proveedor en el `usage` de la\n * última respuesta. Los trozos se estiman con `chars/4`, que es una heurística.\n * Presentar estimaciones como si fueran medidas sería mentir con precisión\n * falsa, así que:\n *\n *   - Si hay total real, se REPARTE ese total según las proporciones estimadas.\n *     El total cuadra siempre y el reparto se marca como estimado.\n *   - Si no lo hay (recién compactado, antes de la primera respuesta), se\n *     devuelve la suma de estimaciones y se dice que TODO es estimado.\n */\n\n/** Categorías. El orden es el del prompt: lo estable primero. */\nexport type CategoriaContexto =\n\t| \"systemPrompt\"\n\t| \"toolDefinitions\"\n\t| \"skills\"\n\t| \"mcpTools\"\n\t| \"contextFiles\"\n\t| \"memory\"\n\t| \"conversation\";\n\nexport interface PiezaContexto {\n\tcategoria: CategoriaContexto;\n\t/** Tokens atribuidos. Estimados salvo que `exacto` sea true. */\n\ttokens: number;\n\t/** Fracción del total, entre 0 y 1. */\n\tfraccion: number;\n}\n\nexport interface DesgloseContexto {\n\t/** Total de tokens en contexto. Exacto si vino del proveedor. */\n\ttotal: number;\n\tcontextWindow: number;\n\t/** Fracción de la ventana ocupada, entre 0 y 1. */\n\tocupacion: number;\n\t/**\n\t * True cuando `total` viene del `usage` del proveedor. False significa que\n\t * todo el desglose, total incluido, es una estimación.\n\t */\n\ttotalExacto: boolean;\n\tpiezas: PiezaContexto[];\n}\n\n/**\n * Estimación de tokens de un texto.\n *\n * `chars/4` es la misma heurística que ya usa la compactación\n * (`compaction.ts:estimateTokens`). Se mantiene idéntica a propósito: dos\n * estimadores distintos darían cifras que no cuadran entre la barra de contexto\n * y el momento en que salta la compactación, y el usuario no tendría forma de\n * saber cuál creer.\n */\nexport function estimarTokensTexto(texto: string): number {\n\treturn Math.ceil(texto.length / 4);\n}\n\nexport interface EntradaDesglose {\n\tcontextWindow: number;\n\t/** Tokens reales del proveedor. `null` = desconocido (p. ej. tras compactar). */\n\ttokensReales: number | null;\n\tsystemPrompt: string;\n\t/** Nombre + descripción + esquema serializado de cada tool. */\n\ttoolDefinitions: string[];\n\t/** Nombre + descripción de cada skill visible para el modelo. */\n\tskills: string[];\n\t/** Definiciones de tools MCP, aparte porque son las que más se disparan. */\n\tmcpTools: string[];\n\t/** Ficheros de contexto inyectados (AGENTS.md y compañía). */\n\tcontextFiles: string[];\n\t/** Bloques de memoria inyectados. */\n\tmemory: string[];\n\t/** Tokens de la conversación, ya estimados por el llamante. */\n\tconversationTokens: number;\n}\n\nfunction sumar(textos: string[]): number {\n\tlet total = 0;\n\tfor (const t of textos) total += estimarTokensTexto(t);\n\treturn total;\n}\n\n/**\n * Construye el desglose.\n *\n * Las categorías con cero tokens se omiten: una lista con seis ceros no informa\n * de nada y esconde las dos que sí pesan.\n */\nexport function construirDesglose(entrada: EntradaDesglose): DesgloseContexto {\n\tconst crudos: Array<[CategoriaContexto, number]> = [\n\t\t[\"systemPrompt\", estimarTokensTexto(entrada.systemPrompt)],\n\t\t[\"toolDefinitions\", sumar(entrada.toolDefinitions)],\n\t\t[\"skills\", sumar(entrada.skills)],\n\t\t[\"mcpTools\", sumar(entrada.mcpTools)],\n\t\t[\"contextFiles\", sumar(entrada.contextFiles)],\n\t\t[\"memory\", sumar(entrada.memory)],\n\t\t[\"conversation\", Math.max(0, entrada.conversationTokens)],\n\t];\n\n\tconst sumaEstimada = crudos.reduce((s, [, n]) => s + n, 0);\n\tconst totalExacto = entrada.tokensReales !== null && entrada.tokensReales > 0;\n\tconst total = totalExacto ? (entrada.tokensReales as number) : sumaEstimada;\n\n\t// Reparto proporcional sobre el total real. Si la suma estimada es cero no se\n\t// puede repartir nada: se devuelven las piezas a cero en vez de dividir por\n\t// cero y producir NaN, que en la interfaz se vería como \"—\" o como 0 aleatorio.\n\tconst escala = totalExacto && sumaEstimada > 0 ? (entrada.tokensReales as number) / sumaEstimada : 1;\n\n\tconst piezas: PiezaContexto[] = crudos\n\t\t.filter(([, n]) => n > 0)\n\t\t.map(([categoria, n]) => {\n\t\t\tconst tokens = Math.round(n * escala);\n\t\t\treturn { categoria, tokens, fraccion: total > 0 ? tokens / total : 0 };\n\t\t})\n\t\t.sort((a, b) => b.tokens - a.tokens);\n\n\treturn {\n\t\ttotal,\n\t\tcontextWindow: entrada.contextWindow,\n\t\tocupacion: entrada.contextWindow > 0 ? Math.min(1, total / entrada.contextWindow) : 0,\n\t\ttotalExacto,\n\t\tpiezas,\n\t};\n}\n\n/** Etiquetas legibles. La interfaz traduce; esto es el orden y el nombre canónico. */\nexport const ETIQUETAS_CONTEXTO: Record<CategoriaContexto, string> = {\n\tsystemPrompt: \"System prompt\",\n\ttoolDefinitions: \"Tool definitions\",\n\tskills: \"Skills\",\n\tmcpTools: \"MCP tools\",\n\tcontextFiles: \"Context files\",\n\tmemory: \"Memory\",\n\tconversation: \"Conversation\",\n};\n"]}
+{"version":3,"file":"context-breakdown.d.ts","sourceRoot":"","sources":["../../src/core/context-breakdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iEAAiE;AACjE,MAAM,MAAM,iBAAiB,GAC1B,cAAc,GACd,iBAAiB,GACjB,QAAQ,GACR,UAAU,GACV,cAAc,GACd,QAAQ,GACR,cAAc,CAAC;AAElB,MAAM,WAAW,aAAa;IAC7B,SAAS,EAAE,iBAAiB,CAAC;IAC7B,gEAAgE;IAChE,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAChC,iEAAiE;IACjE,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,MAAM,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAExD;AAED,MAAM,WAAW,eAAe;IAC/B,aAAa,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,4EAA4E;IAC5E,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,+DAA+D;IAC/D,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAQD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,eAAe,GAAG,gBAAgB,CAmC5E;AAED,sFAAsF;AACtF,eAAO,MAAM,kBAAkB,EAAE,MAAM,CAAC,iBAAiB,EAAE,MAAM,CAQhE,CAAC"}

package/dist/core/context-breakdown.js.map

@@ -1 +1 @@
-{"version":3,"file":"context-breakdown.js","sourceRoot":"","sources":["../../src/core/context-breakdown.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Desglose de qué está llenando la ventana de contexto.\n *\n * POR QUÉ IMPORTA AQUÍ MÁS QUE EN OTROS PRODUCTOS: con caché por prefijo, el\n * coste de un cambio depende de su POSICIÓN, no de su tamaño. Saber que las\n * definiciones de tools ocupan 11 K y van delante te dice que tocarlas invalida\n * todo lo que viene detrás. Sin este desglose, optimizar la caché es a ciegas.\n *\n * HONESTIDAD DEL DATO — la parte que las referencias no resuelven:\n *\n * El único número REAL es el total, que lo da el proveedor en el `usage` de la\n * última respuesta. Los trozos se estiman con `chars/4`, que es una heurística.\n * Presentar estimaciones como si fueran medidas sería mentir con precisión\n * falsa, así que:\n *\n *   - Si hay total real, se REPARTE ese total según las proporciones estimadas.\n *     El total cuadra siempre y el reparto se marca como estimado.\n *   - Si no lo hay (recién compactado, antes de la primera respuesta), se\n *     devuelve la suma de estimaciones y se dice que TODO es estimado.\n */\n\n/** Categorías. El orden es el del prompt: lo estable primero. */\nexport type CategoriaContexto =\n\t| \"systemPrompt\"\n\t| \"toolDefinitions\"\n\t| \"skills\"\n\t| \"mcpTools\"\n\t| \"contextFiles\"\n\t| \"memory\"\n\t| \"conversation\";\n\nexport interface PiezaContexto {\n\tcategoria: CategoriaContexto;\n\t/** Tokens atribuidos. Estimados salvo que `exacto` sea true. */\n\ttokens: number;\n\t/** Fracción del total, entre 0 y 1. */\n\tfraccion: number;\n}\n\nexport interface DesgloseContexto {\n\t/** Total de tokens en contexto. Exacto si vino del proveedor. */\n\ttotal: number;\n\tcontextWindow: number;\n\t/** Fracción de la ventana ocupada, entre 0 y 1. */\n\tocupacion: number;\n\t/**\n\t * True cuando `total` viene del `usage` del proveedor. False significa que\n\t * todo el desglose, total incluido, es una estimación.\n\t */\n\ttotalExacto: boolean;\n\tpiezas: PiezaContexto[];\n}\n\n/**\n * Estimación de tokens de un texto.\n *\n * `chars/4` es la misma heurística que ya usa la compactación\n * (`compaction.ts:estimateTokens`). Se mantiene idéntica a propósito: dos\n * estimadores distintos darían cifras que no cuadran entre la barra de contexto\n * y el momento en que salta la compactación, y el usuario no tendría forma de\n * saber cuál creer.\n */\nexport function estimarTokensTexto(texto: string): number {\n\treturn Math.ceil(texto.length / 4);\n}\n\nexport interface EntradaDesglose {\n\tcontextWindow: number;\n\t/** Tokens reales del proveedor. `null` = desconocido (p. ej. tras compactar). */\n\ttokensReales: number | null;\n\tsystemPrompt: string;\n\t/** Nombre + descripción + esquema serializado de cada tool. */\n\ttoolDefinitions: string[];\n\t/** Nombre + descripción de cada skill visible para el modelo. */\n\tskills: string[];\n\t/** Definiciones de tools MCP, aparte porque son las que más se disparan. */\n\tmcpTools: string[];\n\t/** Ficheros de contexto inyectados (AGENTS.md y compañía). */\n\tcontextFiles: string[];\n\t/** Bloques de memoria inyectados. */\n\tmemory: string[];\n\t/** Tokens de la conversación, ya estimados por el llamante. */\n\tconversationTokens: number;\n}\n\nfunction sumar(textos: string[]): number {\n\tlet total = 0;\n\tfor (const t of textos) total += estimarTokensTexto(t);\n\treturn total;\n}\n\n/**\n * Construye el desglose.\n *\n * Las categorías con cero tokens se omiten: una lista con seis ceros no informa\n * de nada y esconde las dos que sí pesan.\n */\nexport function construirDesglose(entrada: EntradaDesglose): DesgloseContexto {\n\tconst crudos: Array<[CategoriaContexto, number]> = [\n\t\t[\"systemPrompt\", estimarTokensTexto(entrada.systemPrompt)],\n\t\t[\"toolDefinitions\", sumar(entrada.toolDefinitions)],\n\t\t[\"skills\", sumar(entrada.skills)],\n\t\t[\"mcpTools\", sumar(entrada.mcpTools)],\n\t\t[\"contextFiles\", sumar(entrada.contextFiles)],\n\t\t[\"memory\", sumar(entrada.memory)],\n\t\t[\"conversation\", Math.max(0, entrada.conversationTokens)],\n\t];\n\n\tconst sumaEstimada = crudos.reduce((s, [, n]) => s + n, 0);\n\tconst totalExacto = entrada.tokensReales !== null && entrada.tokensReales > 0;\n\tconst total = totalExacto ? (entrada.tokensReales as number) : sumaEstimada;\n\n\t// Reparto proporcional sobre el total real. Si la suma estimada es cero no se\n\t// puede repartir nada: se devuelven las piezas a cero en vez de dividir por\n\t// cero y producir NaN, que en la interfaz se vería como \"—\" o como 0 aleatorio.\n\tconst escala = totalExacto && sumaEstimada > 0 ? (entrada.tokensReales as number) / sumaEstimada : 1;\n\n\tconst piezas: PiezaContexto[] = crudos\n\t\t.filter(([, n]) => n > 0)\n\t\t.map(([categoria, n]) => {\n\t\t\tconst tokens = Math.round(n * escala);\n\t\t\treturn { categoria, tokens, fraccion: total > 0 ? tokens / total : 0 };\n\t\t})\n\t\t.sort((a, b) => b.tokens - a.tokens);\n\n\treturn {\n\t\ttotal,\n\t\tcontextWindow: entrada.contextWindow,\n\t\tocupacion: entrada.contextWindow > 0 ? Math.min(1, total / entrada.contextWindow) : 0,\n\t\ttotalExacto,\n\t\tpiezas,\n\t};\n}\n\n/** Etiquetas legibles. La interfaz traduce; esto es el orden y el nombre canónico. */\nexport const ETIQUETAS_CONTEXTO: Record<CategoriaContexto, string> = {\n\tsystemPrompt: \"System prompt\",\n\ttoolDefinitions: \"Tool definitions\",\n\tskills: \"Skills\",\n\tmcpTools: \"MCP tools\",\n\tcontextFiles: \"Context files\",\n\tmemory: \"Memory\",\n\tconversation: \"Conversation\",\n};\n"]}
+{"version":3,"file":"context-breakdown.js","sourceRoot":"","sources":["../../src/core/context-breakdown.ts"],"names":[],"mappings":"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"}

package/dist/core/credenciales/cliente.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cliente.d.ts","sourceRoot":"","sources":["../../../src/core/credenciales/cliente.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,kGAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;IAExC,YAAY,QAAQ,EAAE,qBAAqB,EAI1C;IAED,OAAO,CAAC,SAAS;IAIjB;;;;;;OAMG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAcvG;IAED,mGAAkG;IAC5F,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAWpF;IAED,2EAAyE;IACnE,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAOxC;IAED,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAO9B;CACD","sourcesContent":["/**\n * Cliente del broker de credenciales.\n *\n * Regla de diseño, y es la que hace verificable \"el cliente no tiene el token\n * en su proceso\": el secreto que devuelve `resolverCredencial` NUNCA se asigna\n * a un campo de esta clase. Sale de la función, el llamador decide qué hacer\n * con él, y esta instancia no guarda nada más que la URL y el bearer del\n * broker (que no son el secreto de ningún proveedor). Ningún método escribe a\n * disco — la credencial vive, como mucho, en la pila de quien la usó para una\n * sola petición.\n */\n\nexport interface OpcionesClienteBroker {\n\turl: string;\n\ttoken: string;\n\t/** Nombre identificador de este cliente, para que el libro de sesión diga quién pidió qué. */\n\tcliente?: string;\n}\n\nexport interface CredencialResuelta {\n\tid: string;\n\tvalor: string;\n}\n\nexport type ResultadoDeUso = { ok: true } | { ok: false; estadoHttp?: number; mensaje: string };\n\nexport interface EfectoDeUso {\n\tclase: string;\n\testado: \"activa\" | \"bloqueada\";\n}\n\nexport interface FilaSnapshot {\n\tid: string;\n\tproveedor: string;\n\testado: \"activa\" | \"bloqueada\";\n\tmotivoBloqueo?: string;\n}\n\nexport class ClienteBroker {\n\tprivate readonly url: string;\n\tprivate readonly token: string;\n\tprivate readonly nombreCliente?: string;\n\n\tconstructor(opciones: OpcionesClienteBroker) {\n\t\tthis.url = opciones.url.replace(/\\/$/, \"\");\n\t\tthis.token = opciones.token;\n\t\tthis.nombreCliente = opciones.cliente;\n\t}\n\n\tprivate cabeceras(): Record<string, string> {\n\t\treturn { \"content-type\": \"application/json\", authorization: `Bearer ${this.token}` };\n\t}\n\n\t/**\n\t * Pide una credencial al broker y la devuelve para uso inmediato.\n\t *\n\t * `null` = el broker no tiene ninguna credencial activa para ese proveedor\n\t * (todas bloqueadas, o proveedor sin dar de alta) — \"no hay nada\", que se\n\t * distingue de una excepción, que es \"no he podido hablar con el broker\".\n\t */\n\tasync resolverCredencial(proveedor: string, promptCacheKey?: string): Promise<CredencialResuelta | null> {\n\t\tconst respuesta = await fetch(`${this.url}/v1/credential`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.cabeceras(),\n\t\t\tbody: JSON.stringify({ proveedor, promptCacheKey, cliente: this.nombreCliente }),\n\t\t});\n\t\tif (respuesta.status === 404) return null;\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new Error(`broker /v1/credential: ${respuesta.status} ${await respuesta.text()}`);\n\t\t}\n\t\tconst datos = (await respuesta.json()) as { id: string; valor: string };\n\t\t// Deliberado: no `this.ultimaCredencial = datos` ni nada parecido. El\n\t\t// valor cruza esta función y desaparece de aquí.\n\t\treturn { id: datos.id, valor: datos.valor };\n\t}\n\n\t/** Reporta cómo fue usar una credencial ya entregada. El broker distingue 401 de 429 con esto. */\n\tasync reportarUso(id: string, resultado: ResultadoDeUso): Promise<EfectoDeUso | null> {\n\t\tconst respuesta = await fetch(`${this.url}/v1/usage`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.cabeceras(),\n\t\t\tbody: JSON.stringify({ id, ...resultado }),\n\t\t});\n\t\tif (respuesta.status === 404) return null;\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new Error(`broker /v1/usage: ${respuesta.status} ${await respuesta.text()}`);\n\t\t}\n\t\treturn (await respuesta.json()) as EfectoDeUso;\n\t}\n\n\t/** Vista del pool sin secretos: qué credenciales hay y en qué estado. */\n\tasync snapshot(): Promise<FilaSnapshot[]> {\n\t\tconst respuesta = await fetch(`${this.url}/v1/snapshot`, { headers: this.cabeceras() });\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new Error(`broker /v1/snapshot: ${respuesta.status} ${await respuesta.text()}`);\n\t\t}\n\t\tconst datos = (await respuesta.json()) as { credenciales: FilaSnapshot[] };\n\t\treturn datos.credenciales;\n\t}\n\n\t/** Liveness sin bearer. `false` en cualquier fallo de red, no lanza. */\n\tasync salud(): Promise<boolean> {\n\t\ttry {\n\t\t\tconst respuesta = await fetch(`${this.url}/v1/health`);\n\t\t\treturn respuesta.ok;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"cliente.d.ts","sourceRoot":"","sources":["../../../src/core/credenciales/cliente.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,qBAAqB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,WAAW,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAE5B,QAAQ,EAAE,qBAAqB;IAM3C,OAAO,CAAC,SAAS;IAIjB;;;;;;OAMG;IACG,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAgBxG,kGAAkG;IAC5F,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAarF,yEAAyE;IACnE,QAAQ,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IASzC,wEAAwE;IAClE,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;CAQ/B"}

package/dist/core/credenciales/cliente.js.map

@@ -1 +1 @@
-{"version":3,"file":"cliente.js","sourceRoot":"","sources":["../../../src/core/credenciales/cliente.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Cliente del broker de credenciales.\n *\n * Regla de diseño, y es la que hace verificable \"el cliente no tiene el token\n * en su proceso\": el secreto que devuelve `resolverCredencial` NUNCA se asigna\n * a un campo de esta clase. Sale de la función, el llamador decide qué hacer\n * con él, y esta instancia no guarda nada más que la URL y el bearer del\n * broker (que no son el secreto de ningún proveedor). Ningún método escribe a\n * disco — la credencial vive, como mucho, en la pila de quien la usó para una\n * sola petición.\n */\n\nexport interface OpcionesClienteBroker {\n\turl: string;\n\ttoken: string;\n\t/** Nombre identificador de este cliente, para que el libro de sesión diga quién pidió qué. */\n\tcliente?: string;\n}\n\nexport interface CredencialResuelta {\n\tid: string;\n\tvalor: string;\n}\n\nexport type ResultadoDeUso = { ok: true } | { ok: false; estadoHttp?: number; mensaje: string };\n\nexport interface EfectoDeUso {\n\tclase: string;\n\testado: \"activa\" | \"bloqueada\";\n}\n\nexport interface FilaSnapshot {\n\tid: string;\n\tproveedor: string;\n\testado: \"activa\" | \"bloqueada\";\n\tmotivoBloqueo?: string;\n}\n\nexport class ClienteBroker {\n\tprivate readonly url: string;\n\tprivate readonly token: string;\n\tprivate readonly nombreCliente?: string;\n\n\tconstructor(opciones: OpcionesClienteBroker) {\n\t\tthis.url = opciones.url.replace(/\\/$/, \"\");\n\t\tthis.token = opciones.token;\n\t\tthis.nombreCliente = opciones.cliente;\n\t}\n\n\tprivate cabeceras(): Record<string, string> {\n\t\treturn { \"content-type\": \"application/json\", authorization: `Bearer ${this.token}` };\n\t}\n\n\t/**\n\t * Pide una credencial al broker y la devuelve para uso inmediato.\n\t *\n\t * `null` = el broker no tiene ninguna credencial activa para ese proveedor\n\t * (todas bloqueadas, o proveedor sin dar de alta) — \"no hay nada\", que se\n\t * distingue de una excepción, que es \"no he podido hablar con el broker\".\n\t */\n\tasync resolverCredencial(proveedor: string, promptCacheKey?: string): Promise<CredencialResuelta | null> {\n\t\tconst respuesta = await fetch(`${this.url}/v1/credential`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.cabeceras(),\n\t\t\tbody: JSON.stringify({ proveedor, promptCacheKey, cliente: this.nombreCliente }),\n\t\t});\n\t\tif (respuesta.status === 404) return null;\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new Error(`broker /v1/credential: ${respuesta.status} ${await respuesta.text()}`);\n\t\t}\n\t\tconst datos = (await respuesta.json()) as { id: string; valor: string };\n\t\t// Deliberado: no `this.ultimaCredencial = datos` ni nada parecido. El\n\t\t// valor cruza esta función y desaparece de aquí.\n\t\treturn { id: datos.id, valor: datos.valor };\n\t}\n\n\t/** Reporta cómo fue usar una credencial ya entregada. El broker distingue 401 de 429 con esto. */\n\tasync reportarUso(id: string, resultado: ResultadoDeUso): Promise<EfectoDeUso | null> {\n\t\tconst respuesta = await fetch(`${this.url}/v1/usage`, {\n\t\t\tmethod: \"POST\",\n\t\t\theaders: this.cabeceras(),\n\t\t\tbody: JSON.stringify({ id, ...resultado }),\n\t\t});\n\t\tif (respuesta.status === 404) return null;\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new Error(`broker /v1/usage: ${respuesta.status} ${await respuesta.text()}`);\n\t\t}\n\t\treturn (await respuesta.json()) as EfectoDeUso;\n\t}\n\n\t/** Vista del pool sin secretos: qué credenciales hay y en qué estado. */\n\tasync snapshot(): Promise<FilaSnapshot[]> {\n\t\tconst respuesta = await fetch(`${this.url}/v1/snapshot`, { headers: this.cabeceras() });\n\t\tif (!respuesta.ok) {\n\t\t\tthrow new Error(`broker /v1/snapshot: ${respuesta.status} ${await respuesta.text()}`);\n\t\t}\n\t\tconst datos = (await respuesta.json()) as { credenciales: FilaSnapshot[] };\n\t\treturn datos.credenciales;\n\t}\n\n\t/** Liveness sin bearer. `false` en cualquier fallo de red, no lanza. */\n\tasync salud(): Promise<boolean> {\n\t\ttry {\n\t\t\tconst respuesta = await fetch(`${this.url}/v1/health`);\n\t\t\treturn respuesta.ok;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n}\n"]}
+{"version":3,"file":"cliente.js","sourceRoot":"","sources":["../../../src/core/credenciales/cliente.ts"],"names":[],"mappings":"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"}

package/dist/core/credenciales/pool.d.ts

@@ -59,6 +59,29 @@ export interface FilaPublica {
     estado: EstadoCredencial;
     motivoBloqueo?: string;
 }
+/**
+ * Contexto que el pool entrega al selector en cada elección: todo lo que un
+ * ranking necesita para decidir sin conocer las tripas del pool. Los usos
+ * viven en memoria del proceso; las huellas son SHA-256 del valor — nunca
+ * la clave.
+ */
+export interface ContextoSeleccion {
+    /** id -> usos reportados desde el arranque (ok y fallos: un 429 también cansa). */
+    usoReciente: Record<string, number>;
+    /** Siguiente credencial según el round-robin interno del pool. */
+    rotacion(): string | null;
+    /** Huella del valor de una credencial, o `undefined` si el id es desconocido. */
+    huella(id: string): string | undefined;
+    /** Id de la credencial pegada a esta sesión, si sigue activa. */
+    pegajosaId?: string;
+}
+/**
+ * Hook opcional de selección: elige ENTRE las filas activas que recibe, y su
+ * veredicto es final. `null` = ninguna activa sirve ahora (p. ej. todas
+ * enfriadas por rate-limit): el pool devuelve `null` — NO se cuela al
+ * round-robin propio, porque entregaría justo la cuenta que descansa.
+ */
+export type SelectorDeCredencial = (candidatos: readonly FilaPublica[], contexto: ContextoSeleccion) => string | null;
 export declare class CredencialPool {
     private readonly porId;
     private readonly porProveedor;
@@ -66,7 +89,12 @@ export declare class CredencialPool {
     private readonly pegajosidad;
     /** Cursor de reparto round-robin por proveedor, para las peticiones sin pegajosidad. */
     private readonly cursores;
-    constructor(credenciales: Record<string, CredencialDelPool[]>);
+    /** Contador de usos reportados por credencial (memoria; alimenta el ranking). */
+    private readonly usos;
+    private readonly selector?;
+    constructor(credenciales: Record<string, CredencialDelPool[]>, opciones?: {
+        selector?: SelectorDeCredencial;
+    });
     private clavePegajosidad;
     private siguiente;
     /**
@@ -82,6 +110,13 @@ export declare class CredencialPool {
      * bloqueadas, y decirlo así es lo que distingue esto de un fallo del pool.
      */
     elegir(proveedor: string, promptCacheKey?: string): CredencialElegida | null;
+    private filaPegadaActiva;
+    private usosSnapshot;
+    /**
+     * Huella SHA-256 del valor de una credencial: lo único que sale del valor
+     * hacia registros de rate-limit o diagnóstico. `undefined` = id desconocido.
+     */
+    huellaDe(id: string): string | undefined;
     /**
      * Registra el resultado de usar una credencial ya entregada.
      *

package/dist/core/credenciales/pool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/core/credenciales/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,kFAAiF;AACjF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAQtD,sFAAqF;AACrF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,4FAAyF;AACzF,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,+EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IAEtD,YAAY,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAM5D;IAED,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,SAAS;IAMjB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI,CAqB3E;IAED;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,WAAW,GAAG,IAAI,CAyBnE;IAED,kEAAiE;IACjE,QAAQ,IAAI,WAAW,EAAE,CAOxB;CACD","sourcesContent":["/**\n * Piscina de credenciales por proveedor.\n *\n * El hueco que esto tapa: hoy cada desarrollador tiene sus claves en su propio\n * portátil. `oh-my-pi` (packages/ai/src/auth-broker de ese repo) resuelve esto\n * con un servidor que guarda las credenciales y las reparte; lo que se copia\n * aquí de su diseño son dos decisiones concretas, no el código:\n *\n * 1. **Conmutación a una hermana cuando una cuenta falla de verdad.** Un 401\n *    (`credencial-invalida` o `sin-credencial` en la taxonomía de\n *    `../errores/proveedor.ts`) saca la credencial del pool: la siguiente\n *    petición usa otra. Un 429 (`limite-de-tasa`) NO la saca — la cuenta sigue\n *    siendo buena, solo está ocupada un rato. Confundir los dos es el fallo\n *    que quema cuentas sanas: se ha visto documentado en el propio\n *    `errores/proveedor.ts` como el error más caro de mezclar.\n * 2. **Pegajosidad por sesión vía `prompt_cache_key`.** Sin esto, repartir\n *    entre cuentas rompería el caché de prompts del proveedor en cada turno —\n *    cada petición de la misma conversación pagaría el prefijo entero de\n *    nuevo. Una `prompt_cache_key` se queda pegada a la misma credencial\n *    mientras esa credencial siga activa; solo se realoja cuando la que tenía\n *    pegada se bloquea.\n *\n * Lo que NO se copia: el pool vive en memoria del proceso `ada-cli serve\n * --broker`, no en SQLite. Reiniciar el broker olvida qué estaba bloqueado y\n * la pegajosidad — aceptable para el alcance de hoy (equipos pequeños, un\n * broker por equipo); si hace falta sobrevivir a reinicios, el punto de\n * extensión es cargar/guardar `estado()` a un fichero en `iniciar`/`cerrar`.\n */\n\nimport { clasificarError } from \"../errores/proveedor.ts\";\n\n/** Una credencial tal como la da quien configura el pool: sin estado todavía. */\nexport interface CredencialDelPool {\n\tid: string;\n\tproveedor: string;\n\tvalor: string;\n}\n\nexport type EstadoCredencial = \"activa\" | \"bloqueada\";\n\ninterface Fila extends CredencialDelPool {\n\testado: EstadoCredencial;\n\tmotivoBloqueo?: string;\n\tbloqueadaEn?: number;\n}\n\n/** Lo que se le enseña a un cliente que pide credencial: el secreto, para usarlo. */\nexport interface CredencialElegida {\n\tid: string;\n\tproveedor: string;\n\tvalor: string;\n}\n\n/** Lo que reporta el cliente tras usar una credencial. */\nexport type ResultadoDeUso = { ok: true } | { ok: false; estadoHttp?: number; mensaje: string };\n\n/** Lo que devuelve `marcarUso`: la clase de error (o \"ok\") y el estado resultante. */\nexport interface EfectoDeUso {\n\tclase: string;\n\testado: EstadoCredencial;\n}\n\n/** Fila sin el secreto — lo que se puede enseñar por `/v1/snapshot` sin filtrar nada. */\nexport interface FilaPublica {\n\tid: string;\n\tproveedor: string;\n\testado: EstadoCredencial;\n\tmotivoBloqueo?: string;\n}\n\nexport class CredencialPool {\n\tprivate readonly porId = new Map<string, Fila>();\n\tprivate readonly porProveedor = new Map<string, Fila[]>();\n\t/** `proveedor\\0promptCacheKey` -> id de la credencial pegada a esa sesión. */\n\tprivate readonly pegajosidad = new Map<string, string>();\n\t/** Cursor de reparto round-robin por proveedor, para las peticiones sin pegajosidad. */\n\tprivate readonly cursores = new Map<string, number>();\n\n\tconstructor(credenciales: Record<string, CredencialDelPool[]>) {\n\t\tfor (const [proveedor, lista] of Object.entries(credenciales)) {\n\t\t\tconst filas = lista.map((c): Fila => ({ ...c, proveedor, estado: \"activa\" }));\n\t\t\tthis.porProveedor.set(proveedor, filas);\n\t\t\tfor (const fila of filas) this.porId.set(fila.id, fila);\n\t\t}\n\t}\n\n\tprivate clavePegajosidad(proveedor: string, promptCacheKey: string): string {\n\t\treturn `${proveedor} ${promptCacheKey}`;\n\t}\n\n\tprivate siguiente(proveedor: string, activas: Fila[]): Fila {\n\t\tconst cursor = this.cursores.get(proveedor) ?? 0;\n\t\tthis.cursores.set(proveedor, cursor + 1);\n\t\treturn activas[cursor % activas.length];\n\t}\n\n\t/**\n\t * Elige una credencial activa para `proveedor`.\n\t *\n\t * Sin `promptCacheKey`: reparto round-robin entre las activas. Con\n\t * `promptCacheKey`: si la sesión ya tenía una credencial pegada y sigue\n\t * activa, se reutiliza (no rompe el caché de prompts); si no, se elige una\n\t * nueva y se fija para las próximas llamadas con la misma clave.\n\t *\n\t * `null` = no hay ninguna credencial activa para ese proveedor. Es \"no hay\n\t * nada\", no \"no he podido\" — todas las filas existen, todas están\n\t * bloqueadas, y decirlo así es lo que distingue esto de un fallo del pool.\n\t */\n\telegir(proveedor: string, promptCacheKey?: string): CredencialElegida | null {\n\t\tconst filas = this.porProveedor.get(proveedor) ?? [];\n\t\tconst activas = filas.filter((f) => f.estado === \"activa\");\n\t\tif (activas.length === 0) return null;\n\n\t\tif (promptCacheKey) {\n\t\t\tconst clave = this.clavePegajosidad(proveedor, promptCacheKey);\n\t\t\tconst idPegado = this.pegajosidad.get(clave);\n\t\t\tconst fila = idPegado ? this.porId.get(idPegado) : undefined;\n\t\t\tif (fila && fila.estado === \"activa\") {\n\t\t\t\treturn { id: fila.id, proveedor, valor: fila.valor };\n\t\t\t}\n\t\t\t// Sin pegajosidad válida (primera vez, o la que tenía pegada se bloqueó):\n\t\t\t// elige una hermana y la fija para las próximas peticiones de esta sesión.\n\t\t\tconst elegida = this.siguiente(proveedor, activas);\n\t\t\tthis.pegajosidad.set(clave, elegida.id);\n\t\t\treturn { id: elegida.id, proveedor, valor: elegida.valor };\n\t\t}\n\n\t\tconst elegida = this.siguiente(proveedor, activas);\n\t\treturn { id: elegida.id, proveedor, valor: elegida.valor };\n\t}\n\n\t/**\n\t * Registra el resultado de usar una credencial ya entregada.\n\t *\n\t * `null` = id desconocido (no hay tal credencial en el pool) — se distingue\n\t * de \"la marcó y sigue activa\" para que quien llama pueda contestar 404 en\n\t * vez de fingir un 200.\n\t */\n\tmarcarUso(id: string, resultado: ResultadoDeUso): EfectoDeUso | null {\n\t\tconst fila = this.porId.get(id);\n\t\tif (!fila) return null;\n\n\t\tif (resultado.ok) return { clase: \"ok\", estado: fila.estado };\n\n\t\tconst clasificado = clasificarError({ mensaje: resultado.mensaje, estado: resultado.estadoHttp });\n\n\t\t// Solo un 401/403 de credencial mala saca la fila del pool. Un 429\n\t\t// (`limite-de-tasa`) deja `fila.estado` intacto a propósito: es la\n\t\t// distinción que pide la tarea, y confundirla quema cuentas que solo\n\t\t// estaban ocupadas.\n\t\tif (clasificado.clase === \"credencial-invalida\" || clasificado.clase === \"sin-credencial\") {\n\t\t\tfila.estado = \"bloqueada\";\n\t\t\tfila.motivoBloqueo = clasificado.clase;\n\t\t\tfila.bloqueadaEn = Date.now();\n\t\t\t// Toda sesión pegada a esta credencial se suelta: la próxima `elegir`\n\t\t\t// con la misma prompt_cache_key tiene que caer en una hermana, no\n\t\t\t// seguir devolviendo la que ya sabemos que está mala.\n\t\t\tfor (const [clave, idPegado] of this.pegajosidad) {\n\t\t\t\tif (idPegado === id) this.pegajosidad.delete(clave);\n\t\t\t}\n\t\t}\n\n\t\treturn { clase: clasificado.clase, estado: fila.estado };\n\t}\n\n\t/** Vista pública del pool: sin secretos, para `/v1/snapshot`. */\n\tsnapshot(): FilaPublica[] {\n\t\treturn [...this.porId.values()].map((f) => ({\n\t\t\tid: f.id,\n\t\t\tproveedor: f.proveedor,\n\t\t\testado: f.estado,\n\t\t\tmotivoBloqueo: f.motivoBloqueo,\n\t\t}));\n\t}\n}\n"]}
+{"version":3,"file":"pool.d.ts","sourceRoot":"","sources":["../../../src/core/credenciales/pool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAKH,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAQtD,qFAAqF;AACrF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,MAAM,MAAM,cAAc,GAAG;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEhG,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,gBAAgB,CAAC;CACzB;AAED,yFAAyF;AACzF,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,gBAAgB,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,mFAAmF;IACnF,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,kEAAkE;IAClE,QAAQ,IAAI,MAAM,GAAG,IAAI,CAAC;IAC1B,iFAAiF;IACjF,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,EAAE,QAAQ,EAAE,iBAAiB,KAAK,MAAM,GAAG,IAAI,CAAC;AAMtH,qBAAa,cAAc;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA2B;IACjD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA6B;IAC1D,8EAA8E;IAC9E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,wFAAwF;IACxF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAuB;gBAErC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,EAAE,CAAC,EAAE,QAAQ,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,oBAAoB,CAAA;KAAE;IAS7G,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,SAAS;IAMjB;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IA4C5E,OAAO,CAAC,gBAAgB;IAMxB,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAKxC;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,GAAG,WAAW,GAAG,IAAI;IAgCpE,iEAAiE;IACjE,QAAQ,IAAI,WAAW,EAAE;CAGzB"}