agentic-qe 2.7.4 → 2.8.1

package/dist/nervous-system/persistence/NervousSystemPersistenceManager.js

@@ -0,0 +1,411 @@
+"use strict";
+/**
+ * Nervous System Persistence Manager
+ *
+ * Coordinates persistence across all nervous system components.
+ * Provides a unified API for saving and restoring agent nervous system state.
+ *
+ * @module nervous-system/persistence/NervousSystemPersistenceManager
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NervousSystemPersistenceManager = void 0;
+exports.createNervousSystemPersistenceManager = createNervousSystemPersistenceManager;
+exports.getSharedPersistenceManager = getSharedPersistenceManager;
+exports.resetSharedPersistenceManager = resetSharedPersistenceManager;
+const events_1 = require("events");
+const SQLiteNervousSystemStore_js_1 = require("./SQLiteNervousSystemStore.js");
+const Logger_js_1 = require("../../utils/Logger.js");
+/**
+ * Manages persistence of nervous system state across agents
+ */
+class NervousSystemPersistenceManager extends events_1.EventEmitter {
+    constructor(config = {}) {
+        super();
+        this.initialized = false;
+        this.autoSaveTimer = null;
+        // Track pending state changes for auto-save
+        this.pendingStates = new Map();
+        // Track agents registered for auto-save
+        this.registeredAgents = new Set();
+        this.logger = Logger_js_1.Logger.getInstance();
+        this.config = {
+            store: config.store ?? null,
+            autoSaveIntervalMs: config.autoSaveIntervalMs ?? 0,
+            debug: config.debug ?? false,
+            dbPath: config.dbPath ?? '.agentic-qe/memory.db',
+        };
+        // Create default store if not provided
+        if (!this.config.store) {
+            this.store = (0, SQLiteNervousSystemStore_js_1.createSQLiteNervousSystemStore)({ dbPath: this.config.dbPath });
+        }
+        else {
+            this.store = this.config.store;
+        }
+    }
+    /**
+     * Initialize the persistence manager
+     */
+    async initialize() {
+        if (this.initialized)
+            return;
+        try {
+            await this.store.initialize();
+            // Start auto-save timer if configured
+            if (this.config.autoSaveIntervalMs > 0) {
+                this.startAutoSave();
+            }
+            this.initialized = true;
+            this.logger.info('NervousSystemPersistenceManager initialized', {
+                storeType: this.store.getStoreInfo().type,
+                autoSaveInterval: this.config.autoSaveIntervalMs,
+            });
+        }
+        catch (error) {
+            this.logger.error('Failed to initialize NervousSystemPersistenceManager:', error);
+            throw error;
+        }
+    }
+    /**
+     * Shutdown the persistence manager
+     */
+    async shutdown() {
+        if (!this.initialized)
+            return;
+        try {
+            // Stop auto-save
+            this.stopAutoSave();
+            // Flush any pending state
+            await this.flushPendingStates();
+            // Shutdown store
+            await this.store.shutdown();
+            this.initialized = false;
+            this.logger.info('NervousSystemPersistenceManager shutdown complete');
+        }
+        catch (error) {
+            this.logger.error('Error during NervousSystemPersistenceManager shutdown:', error);
+        }
+    }
+    /**
+     * Ensure manager is initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('NervousSystemPersistenceManager not initialized. Call initialize() first.');
+        }
+    }
+    // ============================================
+    // HDC State Operations
+    // ============================================
+    /**
+     * Save HDC memory state
+     */
+    async saveHdcState(agentId, state) {
+        this.ensureInitialized();
+        try {
+            await this.store.saveHdcState(agentId, state);
+            const sizeBytes = JSON.stringify(state).length;
+            this.emit('state:saved', { agentId, component: 'hdc', sizeBytes });
+            if (this.config.debug) {
+                this.logger.debug('Saved HDC state', { agentId, patterns: state.patterns.length });
+            }
+        }
+        catch (error) {
+            this.emit('error', { agentId, operation: 'saveHdcState', error: error });
+            throw error;
+        }
+    }
+    /**
+     * Load HDC memory state
+     */
+    async loadHdcState(agentId) {
+        this.ensureInitialized();
+        try {
+            const state = await this.store.loadHdcState(agentId);
+            if (state) {
+                this.emit('state:loaded', { agentId, component: 'hdc' });
+            }
+            return state;
+        }
+        catch (error) {
+            this.emit('error', { agentId, operation: 'loadHdcState', error: error });
+            throw error;
+        }
+    }
+    // ============================================
+    // BTSP State Operations
+    // ============================================
+    /**
+     * Save BTSP learner state
+     */
+    async saveBtspState(agentId, state) {
+        this.ensureInitialized();
+        try {
+            await this.store.saveBtspState(agentId, state);
+            const sizeBytes = JSON.stringify(state).length;
+            this.emit('state:saved', { agentId, component: 'btsp', sizeBytes });
+            if (this.config.debug) {
+                this.logger.debug('Saved BTSP state', { agentId, associations: state.associationCount });
+            }
+        }
+        catch (error) {
+            this.emit('error', { agentId, operation: 'saveBtspState', error: error });
+            throw error;
+        }
+    }
+    /**
+     * Load BTSP learner state
+     */
+    async loadBtspState(agentId) {
+        this.ensureInitialized();
+        try {
+            const state = await this.store.loadBtspState(agentId);
+            if (state) {
+                this.emit('state:loaded', { agentId, component: 'btsp' });
+            }
+            return state;
+        }
+        catch (error) {
+            this.emit('error', { agentId, operation: 'loadBtspState', error: error });
+            throw error;
+        }
+    }
+    // ============================================
+    // Circadian State Operations
+    // ============================================
+    /**
+     * Save circadian controller state
+     */
+    async saveCircadianState(agentId, state) {
+        this.ensureInitialized();
+        try {
+            await this.store.saveCircadianState(agentId, state);
+            const sizeBytes = JSON.stringify(state).length;
+            this.emit('state:saved', { agentId, component: 'circadian', sizeBytes });
+            if (this.config.debug) {
+                this.logger.debug('Saved Circadian state', { agentId, phase: state.state.phase });
+            }
+        }
+        catch (error) {
+            this.emit('error', { agentId, operation: 'saveCircadianState', error: error });
+            throw error;
+        }
+    }
+    /**
+     * Load circadian controller state
+     */
+    async loadCircadianState(agentId) {
+        this.ensureInitialized();
+        try {
+            const state = await this.store.loadCircadianState(agentId);
+            if (state) {
+                this.emit('state:loaded', { agentId, component: 'circadian' });
+            }
+            return state;
+        }
+        catch (error) {
+            this.emit('error', { agentId, operation: 'loadCircadianState', error: error });
+            throw error;
+        }
+    }
+    // ============================================
+    // Bulk Operations
+    // ============================================
+    /**
+     * Save all nervous system state for an agent
+     */
+    async saveAllState(agentId, state) {
+        this.ensureInitialized();
+        const promises = [];
+        if (state.hdc) {
+            promises.push(this.saveHdcState(agentId, state.hdc));
+        }
+        if (state.btsp) {
+            promises.push(this.saveBtspState(agentId, state.btsp));
+        }
+        if (state.circadian) {
+            promises.push(this.saveCircadianState(agentId, state.circadian));
+        }
+        await Promise.all(promises);
+    }
+    /**
+     * Load all nervous system state for an agent
+     */
+    async loadAllState(agentId) {
+        this.ensureInitialized();
+        const [hdc, btsp, circadian] = await Promise.all([
+            this.loadHdcState(agentId),
+            this.loadBtspState(agentId),
+            this.loadCircadianState(agentId),
+        ]);
+        return { hdc, btsp, circadian };
+    }
+    /**
+     * Delete all state for an agent
+     */
+    async deleteAllState(agentId) {
+        this.ensureInitialized();
+        await this.store.deleteAllState(agentId);
+        this.emit('state:deleted', { agentId });
+        // Remove from pending and registered
+        this.pendingStates.delete(agentId);
+        this.registeredAgents.delete(agentId);
+    }
+    /**
+     * List all agents with stored state
+     */
+    async listAgents() {
+        this.ensureInitialized();
+        return this.store.listAgents();
+    }
+    /**
+     * Get metadata about stored state
+     */
+    async getStateMetadata(agentId, component) {
+        this.ensureInitialized();
+        return this.store.getStateMetadata(agentId, component);
+    }
+    // ============================================
+    // Auto-Save Management
+    // ============================================
+    /**
+     * Register an agent for auto-save
+     */
+    registerForAutoSave(agentId) {
+        this.registeredAgents.add(agentId);
+        if (!this.pendingStates.has(agentId)) {
+            this.pendingStates.set(agentId, {});
+        }
+    }
+    /**
+     * Unregister an agent from auto-save
+     */
+    unregisterFromAutoSave(agentId) {
+        this.registeredAgents.delete(agentId);
+        this.pendingStates.delete(agentId);
+    }
+    /**
+     * Queue state for auto-save
+     */
+    queueStateForAutoSave(agentId, state) {
+        if (!this.registeredAgents.has(agentId)) {
+            this.registerForAutoSave(agentId);
+        }
+        const pending = this.pendingStates.get(agentId) || {};
+        if (state.hdc)
+            pending.hdc = state.hdc;
+        if (state.btsp)
+            pending.btsp = state.btsp;
+        if (state.circadian)
+            pending.circadian = state.circadian;
+        this.pendingStates.set(agentId, pending);
+    }
+    /**
+     * Start auto-save timer
+     */
+    startAutoSave() {
+        if (this.autoSaveTimer) {
+            clearInterval(this.autoSaveTimer);
+        }
+        this.autoSaveTimer = setInterval(async () => {
+            await this.flushPendingStates();
+        }, this.config.autoSaveIntervalMs);
+        this.logger.debug('Auto-save started', { intervalMs: this.config.autoSaveIntervalMs });
+    }
+    /**
+     * Stop auto-save timer
+     */
+    stopAutoSave() {
+        if (this.autoSaveTimer) {
+            clearInterval(this.autoSaveTimer);
+            this.autoSaveTimer = null;
+        }
+    }
+    /**
+     * Flush all pending state to storage
+     */
+    async flushPendingStates() {
+        for (const [agentId, pending] of this.pendingStates.entries()) {
+            const savedComponents = [];
+            try {
+                if (pending.hdc) {
+                    await this.store.saveHdcState(agentId, pending.hdc);
+                    savedComponents.push('hdc');
+                    delete pending.hdc;
+                }
+                if (pending.btsp) {
+                    await this.store.saveBtspState(agentId, pending.btsp);
+                    savedComponents.push('btsp');
+                    delete pending.btsp;
+                }
+                if (pending.circadian) {
+                    await this.store.saveCircadianState(agentId, pending.circadian);
+                    savedComponents.push('circadian');
+                    delete pending.circadian;
+                }
+                if (savedComponents.length > 0) {
+                    this.emit('auto-save', { agentId, savedComponents });
+                    if (this.config.debug) {
+                        this.logger.debug('Auto-saved state', { agentId, components: savedComponents });
+                    }
+                }
+            }
+            catch (error) {
+                this.logger.error('Auto-save failed', { agentId, error });
+                this.emit('error', { agentId, operation: 'autoSave', error: error });
+            }
+        }
+    }
+    // ============================================
+    // Store Information
+    // ============================================
+    /**
+     * Get information about the underlying store
+     */
+    getStoreInfo() {
+        return this.store.getStoreInfo();
+    }
+    /**
+     * Get statistics about the persistence manager
+     */
+    getStats() {
+        return {
+            initialized: this.initialized,
+            registeredAgents: this.registeredAgents.size,
+            pendingStates: this.pendingStates.size,
+            autoSaveEnabled: this.config.autoSaveIntervalMs > 0,
+            autoSaveIntervalMs: this.config.autoSaveIntervalMs,
+            storeType: this.store.getStoreInfo().type,
+        };
+    }
+}
+exports.NervousSystemPersistenceManager = NervousSystemPersistenceManager;
+/**
+ * Factory function to create persistence manager
+ */
+function createNervousSystemPersistenceManager(config) {
+    return new NervousSystemPersistenceManager(config);
+}
+/**
+ * Singleton instance for shared use
+ */
+let sharedManager = null;
+/**
+ * Get or create shared persistence manager instance
+ */
+async function getSharedPersistenceManager(config) {
+    if (!sharedManager) {
+        sharedManager = createNervousSystemPersistenceManager(config);
+        await sharedManager.initialize();
+    }
+    return sharedManager;
+}
+/**
+ * Reset shared instance (for testing)
+ */
+async function resetSharedPersistenceManager() {
+    if (sharedManager) {
+        await sharedManager.shutdown();
+        sharedManager = null;
+    }
+}
+//# sourceMappingURL=NervousSystemPersistenceManager.js.map

package/dist/nervous-system/persistence/NervousSystemPersistenceManager.js.map

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

package/dist/nervous-system/persistence/SQLiteNervousSystemStore.d.ts

@@ -0,0 +1,98 @@
+/**
+ * SQLite Nervous System Store
+ *
+ * Persists nervous system component state to SQLite database.
+ * Uses the existing SwarmMemoryManager's database connection.
+ *
+ * @module nervous-system/persistence/SQLiteNervousSystemStore
+ */
+import type Database from 'better-sqlite3';
+import type { INervousSystemStore, NervousSystemComponent, HdcSerializedState, BTSPSerializedState, CircadianSerializedState, StoredStateMetadata } from './INervousSystemStore.js';
+/**
+ * Configuration for SQLiteNervousSystemStore
+ */
+export interface SQLiteNervousSystemStoreConfig {
+    /** Database instance to use (from SwarmMemoryManager) */
+    db?: Database.Database;
+    /** Path to database file (if db not provided) */
+    dbPath?: string;
+    /** Table name prefix (default: 'nervous_system') */
+    tablePrefix?: string;
+}
+/**
+ * SQLite implementation of nervous system state storage
+ */
+export declare class SQLiteNervousSystemStore implements INervousSystemStore {
+    private readonly logger;
+    private db;
+    private readonly config;
+    private initialized;
+    private stmtSaveState;
+    private stmtLoadState;
+    private stmtDeleteState;
+    private stmtDeleteAllState;
+    private stmtListAgents;
+    private stmtGetMetadata;
+    constructor(config?: SQLiteNervousSystemStoreConfig);
+    /**
+     * Initialize the store - create tables if needed
+     */
+    initialize(): Promise<void>;
+    /**
+     * Create required tables
+     */
+    private createTables;
+    /**
+     * Prepare SQL statements for reuse
+     */
+    private prepareStatements;
+    /**
+     * Ensure store is initialized
+     */
+    private ensureInitialized;
+    /**
+     * Shutdown the store
+     */
+    shutdown(): Promise<void>;
+    saveHdcState(agentId: string, state: HdcSerializedState): Promise<void>;
+    loadHdcState(agentId: string): Promise<HdcSerializedState | null>;
+    deleteHdcState(agentId: string): Promise<void>;
+    saveBtspState(agentId: string, state: BTSPSerializedState): Promise<void>;
+    loadBtspState(agentId: string): Promise<BTSPSerializedState | null>;
+    deleteBtspState(agentId: string): Promise<void>;
+    saveCircadianState(agentId: string, state: CircadianSerializedState): Promise<void>;
+    loadCircadianState(agentId: string): Promise<CircadianSerializedState | null>;
+    deleteCircadianState(agentId: string): Promise<void>;
+    deleteAllState(agentId: string): Promise<void>;
+    listAgents(): Promise<string[]>;
+    getStateMetadata(agentId: string, component?: NervousSystemComponent): Promise<StoredStateMetadata[]>;
+    getStoreInfo(): {
+        type: 'sqlite' | 'supabase' | 'file' | 'memory';
+        version: string;
+        location?: string;
+    };
+    /**
+     * Pack HDC state into a single binary buffer
+     * Format:
+     *   [4 bytes: dimension]
+     *   [4 bytes: num type codebook entries]
+     *   [... type codebook entries: key length (2) + key + vector (1250)]
+     *   [4 bytes: num domain codebook entries]
+     *   [... domain codebook entries]
+     *   [4 bytes: num framework codebook entries]
+     *   [... framework codebook entries]
+     *   [4 × 1250 bytes: role vectors]
+     *   [4 bytes: num patterns]
+     *   [... patterns: key length (2) + key + vector (1250)]
+     */
+    private packHdcBinaryData;
+    /**
+     * Unpack HDC state from binary buffer
+     */
+    private unpackHdcBinaryData;
+}
+/**
+ * Factory function to create SQLite store
+ */
+export declare function createSQLiteNervousSystemStore(config?: SQLiteNervousSystemStoreConfig): SQLiteNervousSystemStore;
+//# sourceMappingURL=SQLiteNervousSystemStore.d.ts.map

package/dist/nervous-system/persistence/SQLiteNervousSystemStore.d.ts.map

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