@backendkit-labs/agent-core 0.14.0

package/dist/reflection/reflection-engine.js

@@ -0,0 +1,352 @@
+"use strict";
+/**
+ * @description ReflectionEngine — Orquestador universal del sistema de auto-mejora.
+ *
+ * Pipeline: Feedback → Catalog → Pattern Detection → Policy Promotion → Prevention
+ *
+ * Opera sobre 5 dominios: audit, test, commit, agent, bootstrap.
+ * Cada dominio tiene sus propios failureTypes y hooks de captura,
+ * pero comparten el mismo pipeline de deteccion y promocion.
+ *
+ * @example
+ * ```ts
+ * const engine = new ReflectionEngine({ projectRoot: process.cwd() });
+ * await engine.initialize();
+ * await engine.reflect(); // escanea todos los dominios
+ * console.log(engine.getStats());
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReflectionEngine = void 0;
+const path = __importStar(require("path"));
+const path_1 = require("path");
+const os = __importStar(require("os"));
+const fs = __importStar(require("fs/promises"));
+const atomic_write_1 = require("../shared/utils/atomic-write");
+const failure_catalog_1 = require("./failure-catalog");
+const pattern_detector_1 = require("./pattern-detector");
+const policy_promoter_1 = require("./policy-promoter");
+const types_1 = require("./types");
+// ── ReflectionEngine ─────────────────────────────────────────────────────────
+class ReflectionEngine {
+    catalog;
+    detector;
+    promoter;
+    config;
+    registry;
+    appName;
+    projectRoot;
+    onProjectContextUpdate;
+    onEngineInsights;
+    lastPatterns = [];
+    lastPromotedRules = [];
+    pendingReflections = new Set();
+    projectDir;
+    constructor(options) {
+        const projectRoot = options?.projectRoot ?? process.cwd();
+        const useGlobal = options?.useGlobalDir ?? true;
+        this.appName = options?.appName ?? 'bk-agent';
+        this.projectRoot = projectRoot;
+        this.onProjectContextUpdate = options?.onProjectContextUpdate;
+        this.onEngineInsights = options?.onEngineInsights;
+        this.catalog = new failure_catalog_1.FailureCatalog({ projectRoot, useGlobalDir: useGlobal, appName: this.appName });
+        this.detector = new pattern_detector_1.PatternDetector(this.catalog);
+        this.promoter = useGlobal
+            ? new policy_promoter_1.PolicyPromoter({ appName: this.appName })
+            : new policy_promoter_1.PolicyPromoter({ manifestPath: path.join(projectRoot, `.${this.appName}`, 'manifest.yaml') });
+        this.config = {
+            ...(0, types_1.defaultReflectionConfig)(),
+            ...options?.config,
+        };
+        if (options?.registry) {
+            this.registry = options.registry;
+            this.promoter.setRegistry(options.registry);
+        }
+    }
+    // ── Inicializacion ─────────────────────────────────────────────────────────
+    /**
+     * @description Inicializa el engine: carga el catalogo de fallos y el registry desde disco.
+     * Siempre llamar antes de usar el engine.
+     */
+    async initialize() {
+        await this.catalog.load();
+        if (this.registry) {
+            await this.registry.load();
+        }
+    }
+    /**
+     * @description Conecta un DomainRegistry al engine despues de la construccion.
+     * El registry se cargara en el siguiente llamado a initialize() o inmediatamente si
+     * el engine ya esta inicializado.
+     */
+    async connectRegistry(registry) {
+        this.registry = registry;
+        this.promoter.setRegistry(registry);
+        await registry.load();
+    }
+    /**
+     * @description Devuelve el DomainRegistry conectado, si existe.
+     */
+    getRegistry() {
+        return this.registry;
+    }
+    /**
+     * @description Conecta el engine con el directorio de memoria del proyecto.
+     * Una vez conectado, reflect() y AuditHook actualizaran los archivos de memoria.
+     */
+    connectMemory(projectDir) {
+        this.projectDir = projectDir;
+    }
+    /**
+     * @description Devuelve el directorio de memoria conectado, si existe.
+     */
+    getProjectDir() {
+        return this.projectDir;
+    }
+    // ── Pipeline de reflexion ──────────────────────────────────────────────────
+    /**
+     * @description Ejecuta el pipeline completo de reflexion para todos los dominios
+     * (o solo los activos segun config):
+     * 1. Escanea el catalogo buscando patrones >= promotionThreshold
+     * 2. Promueve los patrones no promovidos aun a policyRules
+     * 3. Devuelve los patrones detectados y las reglas promovidas
+     */
+    async reflect(options) {
+        const threshold = options?.threshold ?? this.config.promotionThreshold;
+        const autoPromote = options?.autoPromote ?? this.config.autoPromote;
+        // Registry tiene prioridad: usa sus dominios activos (built-ins + custom habilitados)
+        const activeDomains = options?.domain
+            ? [options.domain]
+            : (this.registry?.getActiveDomains() ?? this.config.activeDomains);
+        // 1. Escanear dominios activos
+        const allPatterns = [];
+        for (const domain of activeDomains) {
+            const patterns = await this.detector.scanByDomain(domain, threshold);
+            allPatterns.push(...patterns);
+        }
+        this.lastPatterns = allPatterns;
+        // 2. Promover patrones no promovidos aun
+        const promotedRules = [];
+        if (autoPromote && this.config.enabled) {
+            // H-05: Contar reglas auto-generadas existentes para verificar limite maximo
+            const existingRules = await this.promoter.getExistingRules();
+            let autoGeneratedCount = existingRules.filter(r => r.autoGenerated === true).length;
+            const maxRules = this.config.maxAutoGeneratedRules;
+            for (const pattern of allPatterns) {
+                if (pattern.failureType.startsWith('unknown_'))
+                    continue;
+                // H-05: Solo auto-promover patrones de severidad high o critical
+                if (pattern.severity !== 'high' && pattern.severity !== 'critical')
+                    continue;
+                // H-05: Verificar umbral minimo explicito
+                if (pattern.count < this.config.promotionThreshold)
+                    continue;
+                const existing = await this.promoter.findRule(pattern.domain, pattern.failureType);
+                if (existing) {
+                    pattern.promotedToPolicy = true;
+                    pattern.policyRuleId = existing.id;
+                    continue;
+                }
+                // H-05: No promover si se alcanzo el limite maximo de reglas auto-generadas
+                if (autoGeneratedCount >= maxRules) {
+                    console.warn(`[ReflectionEngine] Limite de reglas auto-generadas alcanzado (${autoGeneratedCount}/${maxRules}). ` +
+                        `No se promueve '${pattern.failureType}' (${pattern.domain}).`);
+                    continue;
+                }
+                const rule = await this.promoter.promote(pattern);
+                promotedRules.push(rule);
+                pattern.promotedToPolicy = true;
+                pattern.promotedAt = new Date().toISOString();
+                pattern.policyRuleId = rule.id;
+                autoGeneratedCount++; // incrementar contador local para este batch
+            }
+        }
+        this.lastPromotedRules = promotedRules;
+        if (this.projectDir && promotedRules.length > 0 && this.onProjectContextUpdate) {
+            const policyLines = promotedRules.map(r => `- [${r.id}] ${r.name}`).join('\n');
+            await this.onProjectContextUpdate(this.projectDir, { notas: `Patrones auto-promovidos:\n${policyLines}` })
+                .catch(() => { });
+        }
+        if (this.projectDir && allPatterns.length > 0 && this.onEngineInsights) {
+            const insights = allPatterns.map(p => ({
+                failureType: p.failureType,
+                domain: p.domain,
+                severity: p.severity,
+                count: p.count,
+                recommendedAction: p.recommendedAction,
+            }));
+            await this.onEngineInsights(this.projectDir, insights)
+                .catch(() => { });
+        }
+        // 3. Calcular estadisticas
+        const stats = await this.calculateStats(activeDomains);
+        return { patterns: allPatterns, promotedRules, stats };
+    }
+    /**
+     * @description Ejecuta reflexion solo para un dominio especifico.
+     * Util cuando un hook reporta un incidente y se quiere analizar inmediatamente.
+     */
+    async reflectByDomain(domain) {
+        return this.reflect({ domain });
+    }
+    // ── Registro de incidentes (desde hooks) ───────────────────────────────────
+    /**
+     * @description Registra un incidente en el catalogo y ejecuta reflexion
+     * inmediata para el dominio al que pertenece.
+     *
+     * Este es el metodo principal que los hooks deben llamar.
+     *
+     * @param record - Datos del incidente (sin ID, se genera automaticamente)
+     * @returns El FailureRecord completo y los patrones detectados
+     */
+    async reportIncident(record) {
+        const fullRecord = { ...record, id: (0, types_1.generateFailureId)() };
+        await this.catalog.addRecord(fullRecord);
+        this.pendingReflections.add(record.domain);
+        return { record: fullRecord, patterns: [] };
+    }
+    /**
+     * @description Ejecuta la reflexion acumulada de todos los dominios con incidentes pendientes.
+     * Llamar al cerrar un sprint o al final de una sesion.
+     */
+    async flushReflections() {
+        const allPatterns = [];
+        const allRules = [];
+        for (const domain of this.pendingReflections) {
+            const { patterns, promotedRules } = await this.reflectByDomain(domain);
+            allPatterns.push(...patterns);
+            allRules.push(...promotedRules);
+        }
+        this.pendingReflections.clear();
+        await this.maybeUpdateAgentMd(allPatterns);
+        return { patterns: allPatterns, promotedRules: allRules };
+    }
+    async maybeUpdateAgentMd(patterns) {
+        const promoted = patterns.filter(p => (p.severity === 'high' || p.severity === 'critical') && !p.promotedToPolicy);
+        if (promoted.length === 0)
+            return;
+        const agentMdPath = (0, path_1.join)(this.projectRoot, 'AGENT.md');
+        const lesson = this.formatLessonsBlock(promoted);
+        // Leer, verificar duplicados y escribir en una sola operacion atomica
+        // para evitar race conditions entre readFile y atomicWrite
+        const current = await fs.readFile(agentMdPath, 'utf-8').catch(() => '');
+        if (promoted.every(p => current.includes(p.failureType)))
+            return;
+        await (0, atomic_write_1.atomicWrite)(agentMdPath, current + '\n\n' + lesson);
+    }
+    formatLessonsBlock(patterns) {
+        const date = new Date().toISOString().slice(0, 10);
+        const lines = patterns.map(p => `- **${p.failureType}** (${p.domain}, ${p.severity}): ${p.recommendedAction}`);
+        return `## Lessons Learned — ${date}\n\n${lines.join('\n')}\n`;
+    }
+    // ── Consultas ──────────────────────────────────────────────────────────────
+    /**
+     * @description Obtiene los patrones detectados en la ultima reflexion.
+     */
+    getLastPatterns() {
+        return [...this.lastPatterns];
+    }
+    /**
+     * @description Obtiene las reglas promovidas en la ultima reflexion.
+     */
+    getLastPromotedRules() {
+        return [...this.lastPromotedRules];
+    }
+    /**
+     * @description Obtiene el catalogo de fallos para operaciones directas.
+     */
+    getCatalog() {
+        return this.catalog;
+    }
+    /**
+     * @description Obtiene el detector de patrones.
+     */
+    getDetector() {
+        return this.detector;
+    }
+    /**
+     * @description Obtiene el promoter de politicas.
+     */
+    getPromoter() {
+        return this.promoter;
+    }
+    /**
+     * @description Obtiene la ruta del archivo de lecciones aprendidas.
+     * Util para que el AgentLoop pueda cargar el memo e inyectarlo en los agentes.
+     */
+    getLessonsMemoPath() {
+        const home = process.env.USERPROFILE ?? process.env.HOME ?? os.homedir();
+        const projectKey = this.projectRoot
+            .replace(/[/\\]$/, '')
+            .replace(/:[/\\]/g, '--')
+            .replace(/[^a-zA-Z0-9-]/g, '-');
+        return path.join(home, `.${this.appName}`, 'projects', projectKey, 'audits', 'lecciones-aprendidas.md');
+    }
+    // ── Estadisticas ───────────────────────────────────────────────────────────
+    /**
+     * @description Calcula estadisticas del Reflection Engine.
+     */
+    async getStats() {
+        const activeDomains = this.config.activeDomains;
+        return this.calculateStats(activeDomains);
+    }
+    async calculateStats(domains) {
+        const domainCounts = await this.catalog.getDomainCounts();
+        const totalIncidents = await this.catalog.totalRecords();
+        const unresolved = await this.catalog.findUnresolved();
+        const countsByDomain = {};
+        for (const domain of domains) {
+            countsByDomain[domain] = domainCounts[domain] ?? 0;
+        }
+        const patternsByDomain = {};
+        for (const domain of domains) {
+            const patterns = await this.detector.scanByDomain(domain);
+            patternsByDomain[domain] = patterns.length;
+        }
+        return {
+            enabled: this.config.enabled,
+            promotionThreshold: this.config.promotionThreshold,
+            activeDomains: [...domains],
+            totalIncidents,
+            unresolvedCount: unresolved.length,
+            countsByDomain,
+            patternsByDomain,
+            lastReflectionAt: new Date().toISOString(),
+        };
+    }
+}
+exports.ReflectionEngine = ReflectionEngine;
+//# sourceMappingURL=reflection-engine.js.map

package/dist/reflection/reflection-engine.js.map

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

package/dist/reflection/types.d.ts

@@ -0,0 +1,106 @@
+/**
+ * @description Base types for the universal Reflection Engine.
+ *
+ * Defines contracts for FailureRecord, DetectedPattern and the structures
+ * connecting the feedback system with deterministic policy promotion.
+ *
+ * 5 built-in domains: audit, test, commit, agent, bootstrap
+ * Custom domains: registered via DomainRegistry and activated per project.
+ * Golden rule: >=3 occurrences of the same failureType -> promotion to policyRule
+ */
+export interface PolicyCondition {
+    actionType?: string | string[];
+    riskLevel?: string | string[];
+    domain?: string | string[];
+    keywords?: string[];
+    [key: string]: unknown;
+}
+export interface PolicyAction {
+    mustInclude?: string[];
+    mustPass?: string[];
+    mustExecute?: string[];
+    requireArchitectureReview?: boolean;
+    requireSecurityReview?: boolean;
+    requireQaApproval?: boolean;
+    [key: string]: unknown;
+}
+export interface PolicyRule {
+    if: PolicyCondition;
+    then: PolicyAction;
+}
+export interface AuditFinding {
+    id?: string;
+    dimension: string;
+    hallazgo: string;
+    severidad: 'critical' | 'high' | 'medium' | 'low';
+    evidencia?: string;
+    recomendacion?: string;
+    agenteResponsable: string;
+    resolvedAt?: string;
+}
+export type ReflectionDomain = 'audit' | 'test' | 'commit' | 'agent' | 'bootstrap';
+export type AnyDomain = ReflectionDomain | (string & {});
+export declare const FAILURE_TYPES_BY_DOMAIN: Record<ReflectionDomain, readonly string[]>;
+export type FailureType = typeof FAILURE_TYPES_BY_DOMAIN[ReflectionDomain][number];
+export interface FailureRecord {
+    id: string;
+    domain: AnyDomain;
+    failureType: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    dimension: string;
+    gate: string;
+    agenteResponsable: string;
+    hallazgo: string;
+    recomendacion: string;
+    archivos: string[];
+    fecha: string;
+    resolvedByCommit?: string;
+    resolvedAt?: string;
+    contextRaw?: string;
+}
+export interface DetectedPattern {
+    failureType: string;
+    domain: AnyDomain;
+    count: number;
+    firstSeen: string;
+    lastSeen: string;
+    severity: 'critical' | 'high' | 'medium' | 'low';
+    recordIds: string[];
+    dominantDimension: string;
+    dominantGate: string;
+    recommendedAction: string;
+    promotedToPolicy: boolean;
+    promotedAt?: string;
+    policyRuleId?: string;
+}
+export interface ManifestPolicyRule extends PolicyRule {
+    id: string;
+    name: string;
+    trigger: {
+        domain: AnyDomain;
+        pattern: string;
+        minOccurrences: number;
+    };
+    autoGenerated: boolean;
+    sourceADR?: string;
+    createdAt: string;
+    engineVersion: string;
+    outcomes?: {
+        success: number;
+        failure: number;
+        lastSeen: string;
+    };
+}
+export interface ReflectionConfig {
+    enabled: boolean;
+    promotionThreshold: number;
+    autoPromote: boolean;
+    maxAutoGeneratedRules: number;
+    autoGenerateAdr: boolean;
+    activeDomains: AnyDomain[];
+    manifestPath: string;
+}
+export declare function defaultReflectionConfig(): ReflectionConfig;
+export declare function generateFailureId(): string;
+export declare function generatePolicyRuleId(domain: AnyDomain, number: number): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/reflection/types.d.ts.map

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

package/dist/reflection/types.js

@@ -0,0 +1,64 @@
+"use strict";
+/**
+ * @description Base types for the universal Reflection Engine.
+ *
+ * Defines contracts for FailureRecord, DetectedPattern and the structures
+ * connecting the feedback system with deterministic policy promotion.
+ *
+ * 5 built-in domains: audit, test, commit, agent, bootstrap
+ * Custom domains: registered via DomainRegistry and activated per project.
+ * Golden rule: >=3 occurrences of the same failureType -> promotion to policyRule
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FAILURE_TYPES_BY_DOMAIN = void 0;
+exports.defaultReflectionConfig = defaultReflectionConfig;
+exports.generateFailureId = generateFailureId;
+exports.generatePolicyRuleId = generatePolicyRuleId;
+exports.FAILURE_TYPES_BY_DOMAIN = {
+    audit: [
+        'missing_rollback', 'connection_leak', 'security_vulnerability',
+        'missing_test_coverage', 'incomplete_error_handling', 'missing_documentation',
+        'architecture_violation', 'missing_logging', 'unvalidated_input', 'hardcoded_secret',
+    ],
+    test: [
+        'tsc_noEmit_type_error', 'jest_timeout', 'coverage_below_threshold', 'flaky_test',
+        'missing_test_for_use_case', 'test_without_assertion',
+        'integration_test_without_container', 'property_test_missing',
+    ],
+    commit: [
+        'unknown_failure', 'missing_type', 'wrong_scope', 'message_too_long',
+        'missing_issue_reference', 'coverage_not_run', 'typecheck_failed_before_commit',
+        'test_failed_before_commit', 'branch_naming_invalid',
+    ],
+    agent: [
+        'wrong_agent_selected', 'agent_timeout', 'agent_hallucination',
+        'missing_agent_for_domain', 'tool_execution_failed', 'delegation_failed',
+        'response_rejected_by_evaluator',
+    ],
+    bootstrap: [
+        'missing_config_yaml', 'wrong_project_type_detected', 'memory_load_failure',
+        'manifest_corrupt', 'seed_config_failed', 'agent_profile_load_failed', 'vault_sync_failed',
+    ],
+};
+function defaultReflectionConfig() {
+    return {
+        enabled: true,
+        promotionThreshold: 3,
+        autoPromote: true,
+        maxAutoGeneratedRules: 20,
+        autoGenerateAdr: true,
+        activeDomains: ['audit', 'test', 'commit', 'agent', 'bootstrap'],
+        manifestPath: 'manifest.yaml',
+    };
+}
+// ── Helpers ──────────────────────────────────────────────────────────────────
+function generateFailureId() {
+    const timestamp = Date.now().toString(36);
+    const random = Math.random().toString(36).substring(2, 8);
+    return `fail_${timestamp}_${random}`;
+}
+function generatePolicyRuleId(domain, number) {
+    const prefix = domain.toUpperCase().slice(0, 4);
+    return `POL-${prefix}-${String(number).padStart(3, '0')}`;
+}
+//# sourceMappingURL=types.js.map

package/dist/reflection/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/reflection/types.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAiJH,0DAUC;AAID,8CAIC;AAED,oDAGC;AA1HY,QAAA,uBAAuB,GAAgD;IAChF,KAAK,EAAE;QACH,kBAAkB,EAAE,iBAAiB,EAAE,wBAAwB;QAC/D,uBAAuB,EAAE,2BAA2B,EAAE,uBAAuB;QAC7E,wBAAwB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,kBAAkB;KAC9E;IACV,IAAI,EAAE;QACF,uBAAuB,EAAE,cAAc,EAAE,0BAA0B,EAAE,YAAY;QACjF,2BAA2B,EAAE,wBAAwB;QACrD,oCAAoC,EAAE,uBAAuB;KACvD;IACV,MAAM,EAAE;QACJ,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,kBAAkB;QACpE,yBAAyB,EAAE,kBAAkB,EAAE,gCAAgC;QAC/E,2BAA2B,EAAE,uBAAuB;KAC9C;IACV,KAAK,EAAE;QACH,sBAAsB,EAAE,eAAe,EAAE,qBAAqB;QAC9D,0BAA0B,EAAE,uBAAuB,EAAE,mBAAmB;QACxE,gCAAgC;KAC1B;IACV,SAAS,EAAE;QACP,qBAAqB,EAAE,6BAA6B,EAAE,qBAAqB;QAC3E,kBAAkB,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,mBAAmB;KACpF;CACb,CAAC;AA0EF,SAAgB,uBAAuB;IACnC,OAAO;QACH,OAAO,EAAE,IAAI;QACb,kBAAkB,EAAE,CAAC;QACrB,WAAW,EAAE,IAAI;QACjB,qBAAqB,EAAE,EAAE;QACzB,eAAe,EAAE,IAAI;QACrB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAgB;QAC/E,YAAY,EAAE,eAAe;KAChC,CAAC;AACN,CAAC;AAED,gFAAgF;AAEhF,SAAgB,iBAAiB;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,OAAO,QAAQ,SAAS,IAAI,MAAM,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,oBAAoB,CAAC,MAAiB,EAAE,MAAc;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChD,OAAO,OAAO,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9D,CAAC"}

package/dist/shared/llm/resilient-client.d.ts

@@ -0,0 +1,40 @@
+import { CircuitBreakerState } from '@backendkit-labs/circuit-breaker';
+import type { LLMChatClient } from '../../orchestration/intent-detector';
+export interface ResilientLLMClientOptions {
+    client: LLMChatClient;
+    /** Circuit breaker name, e.g. 'openai', 'deepseek'. Default: 'llm-provider' */
+    name?: string;
+    /** % of failures in the sliding window to open the circuit. Default: 50 */
+    failureThreshold?: number;
+    /** Minimum calls before thresholds are evaluated. Default: 5 */
+    minimumCalls?: number;
+    /** ms to wait in OPEN before transitioning to HALF_OPEN. Default: 30_000 */
+    openTimeoutMs?: number;
+    /** Called on every state transition — use for logging or alerting */
+    onStateChange?: (from: CircuitBreakerState, to: CircuitBreakerState) => void;
+}
+/**
+ * Wraps any LLMChatClient with a CircuitBreaker.
+ *
+ * When the provider fails repeatedly the circuit opens and subsequent calls
+ * return { content: null } immediately instead of waiting for timeouts.
+ * After openTimeoutMs the circuit transitions to HALF_OPEN and lets a probe
+ * call through to test recovery.
+ *
+ * Pair with ResilientLLMClient + retry for full resilience:
+ *   retry handles transient blips; circuit breaker handles sustained outages.
+ */
+export declare class ResilientLLMClient implements LLMChatClient {
+    private readonly breaker;
+    private readonly inner;
+    constructor(opts: ResilientLLMClientOptions);
+    chat(messages: Array<{
+        role: string;
+        content: string;
+    }>, tools?: unknown, temperature?: number): Promise<{
+        content: string | null;
+    }>;
+    getMetrics(): import("@backendkit-labs/circuit-breaker").CircuitBreakerMetrics;
+    getState(): CircuitBreakerState;
+}
+//# sourceMappingURL=resilient-client.d.ts.map

package/dist/shared/llm/resilient-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-client.d.ts","sourceRoot":"","sources":["../../../src/shared/llm/resilient-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2C,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAChH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,MAAM,WAAW,yBAAyB;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,+EAA+E;IAC/E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gEAAgE;IAChE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4EAA4E;IAC5E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qEAAqE;IACrE,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE,mBAAmB,KAAK,IAAI,CAAC;CAChF;AAED;;;;;;;;;;GAUG;AACH,qBAAa,kBAAmB,YAAW,aAAa;IACpD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAE1B,IAAI,EAAE,yBAAyB;IAwBrC,IAAI,CACN,QAAQ,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAClD,KAAK,CAAC,EAAE,OAAO,EACf,WAAW,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IActC,UAAU;IAIV,QAAQ,IAAI,mBAAmB;CAGlC"}

package/dist/shared/llm/resilient-client.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResilientLLMClient = void 0;
+const circuit_breaker_1 = require("@backendkit-labs/circuit-breaker");
+/**
+ * Wraps any LLMChatClient with a CircuitBreaker.
+ *
+ * When the provider fails repeatedly the circuit opens and subsequent calls
+ * return { content: null } immediately instead of waiting for timeouts.
+ * After openTimeoutMs the circuit transitions to HALF_OPEN and lets a probe
+ * call through to test recovery.
+ *
+ * Pair with ResilientLLMClient + retry for full resilience:
+ *   retry handles transient blips; circuit breaker handles sustained outages.
+ */
+class ResilientLLMClient {
+    breaker;
+    inner;
+    constructor(opts) {
+        this.inner = opts.client;
+        this.breaker = new circuit_breaker_1.CircuitBreaker({
+            name: opts.name ?? 'llm-provider',
+            failureThreshold: opts.failureThreshold ?? 50,
+            slowCallThreshold: 100, // disabled — LLM calls are slow by nature
+            slowCallDurationMs: 120_000, // 2 min threshold for "slow"
+            minimumCalls: opts.minimumCalls ?? 5,
+            slidingWindowSize: 10,
+            halfOpenMaxCalls: 2,
+            openTimeoutMs: opts.openTimeoutMs ?? 30_000,
+            isFailure: (err) => {
+                // HTTP 4xx (auth, quota) → handled by retry, not a circuit failure
+                if (err && typeof err === 'object' && 'status' in err) {
+                    const status = err.status;
+                    return status >= 500;
+                }
+                // Network errors and 5xx open the circuit
+                return true;
+            },
+            onStateChange: opts.onStateChange,
+        });
+    }
+    async chat(messages, tools, temperature) {
+        return this.breaker.execute(() => this.inner.chat(messages, tools, temperature), (err) => {
+            if (err instanceof circuit_breaker_1.CircuitBreakerOpenError) {
+                // Circuit is open — fail fast with null, caller decides fallback
+                return { content: null };
+            }
+            // Infrastructure error that opened the circuit — let retry handle it
+            throw err;
+        });
+    }
+    getMetrics() {
+        return this.breaker.getMetrics();
+    }
+    getState() {
+        return this.breaker.getState();
+    }
+}
+exports.ResilientLLMClient = ResilientLLMClient;
+//# sourceMappingURL=resilient-client.js.map

package/dist/shared/llm/resilient-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resilient-client.js","sourceRoot":"","sources":["../../../src/shared/llm/resilient-client.ts"],"names":[],"mappings":";;;AAAA,sEAAgH;AAiBhH;;;;;;;;;;GAUG;AACH,MAAa,kBAAkB;IACV,OAAO,CAAiB;IACxB,KAAK,CAAgB;IAEtC,YAAY,IAA+B;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,gCAAc,CAAC;YAC9B,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,cAAc;YACjC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;YAC7C,iBAAiB,EAAE,GAAG,EAAO,0CAA0C;YACvE,kBAAkB,EAAE,OAAO,EAAE,6BAA6B;YAC1D,YAAY,EAAE,IAAI,CAAC,YAAY,IAAI,CAAC;YACpC,iBAAiB,EAAE,EAAE;YACrB,gBAAgB,EAAE,CAAC;YACnB,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,MAAM;YAC3C,SAAS,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,mEAAmE;gBACnE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,QAAQ,IAAI,GAAG,EAAE,CAAC;oBACpD,MAAM,MAAM,GAAI,GAA0B,CAAC,MAAM,CAAC;oBAClD,OAAO,MAAM,IAAI,GAAG,CAAC;gBACzB,CAAC;gBACD,0CAA0C;gBAC1C,OAAO,IAAI,CAAC;YAChB,CAAC;YACD,aAAa,EAAE,IAAI,CAAC,aAAa;SACpC,CAAC,CAAC;IACP,CAAC;IAED,KAAK,CAAC,IAAI,CACN,QAAkD,EAClD,KAAe,EACf,WAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CACvB,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,WAAW,CAAC,EACnD,CAAC,GAAG,EAAE,EAAE;YACJ,IAAI,GAAG,YAAY,yCAAuB,EAAE,CAAC;gBACzC,iEAAiE;gBACjE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC7B,CAAC;YACD,qEAAqE;YACrE,MAAM,GAAG,CAAC;QACd,CAAC,CACJ,CAAC;IACN,CAAC;IAED,UAAU;QACN,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;IACrC,CAAC;IAED,QAAQ;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;IACnC,CAAC;CACJ;AArDD,gDAqDC"}