agentic-qe 1.8.3 → 1.9.0

package/dist/contexts/DashboardContext.js

@@ -0,0 +1,187 @@
+"use strict";
+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.useDashboard = exports.DashboardProvider = void 0;
+const react_1 = __importStar(require("react"));
+const WebSocketClient_1 = require("../services/websocket/WebSocketClient");
+const DashboardContext = (0, react_1.createContext)(undefined);
+const DEFAULT_FILTERS = {
+    sessionId: null,
+    timeRange: {
+        start: null,
+        end: null,
+    },
+    agents: [],
+    searchTerm: '',
+};
+const DashboardProvider = ({ children }) => {
+    const [filters, setFilters] = (0, react_1.useState)(DEFAULT_FILTERS);
+    const [wsClient, setWsClient] = (0, react_1.useState)(null);
+    const [wsConnected, setWsConnected] = (0, react_1.useState)(false);
+    const [wsError, setWsError] = (0, react_1.useState)(null);
+    const [notifications, setNotifications] = (0, react_1.useState)([]);
+    const [activeView, setActiveView] = (0, react_1.useState)('overview');
+    // Initialize WebSocket connection
+    (0, react_1.useEffect)(() => {
+        const client = new WebSocketClient_1.WebSocketClient({
+            url: process.env.REACT_APP_WS_URL || 'ws://localhost:8081',
+            reconnectInterval: 3000,
+            maxReconnectAttempts: 5,
+        });
+        client.on('connect', () => {
+            setWsConnected(true);
+            setWsError(null);
+            addNotification({
+                type: 'success',
+                title: 'Connected',
+                message: 'WebSocket connection established',
+            });
+        });
+        client.on('disconnect', () => {
+            setWsConnected(false);
+            addNotification({
+                type: 'warning',
+                title: 'Disconnected',
+                message: 'WebSocket connection lost',
+            });
+        });
+        client.on('error', (error) => {
+            setWsError(error.message);
+            addNotification({
+                type: 'error',
+                title: 'Connection Error',
+                message: error.message,
+            });
+        });
+        client.on('event', (event) => {
+            // Notify on important events
+            if (event.metadata?.severity === 'high' || event.metadata?.quality_gate_failed) {
+                addNotification({
+                    type: event.metadata.quality_gate_failed ? 'error' : 'warning',
+                    title: `Event: ${event.type}`,
+                    message: event.metadata.quality_gate_failed
+                        ? `Quality gate violation: ${event.metadata.quality_gate_name}`
+                        : event.description || 'New event received',
+                });
+            }
+        });
+        client.connect();
+        setWsClient(client);
+        return () => {
+            client.disconnect();
+        };
+    }, []);
+    const updateFilters = (0, react_1.useCallback)((newFilters) => {
+        setFilters((prev) => ({ ...prev, ...newFilters }));
+    }, []);
+    const resetFilters = (0, react_1.useCallback)(() => {
+        setFilters(DEFAULT_FILTERS);
+    }, []);
+    const addNotification = (0, react_1.useCallback)((notification) => {
+        const newNotification = {
+            ...notification,
+            id: `notif-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+            timestamp: new Date(),
+            read: false,
+        };
+        setNotifications((prev) => [newNotification, ...prev].slice(0, 50)); // Keep last 50
+    }, []);
+    const markNotificationRead = (0, react_1.useCallback)((id) => {
+        setNotifications((prev) => prev.map((notif) => (notif.id === id ? { ...notif, read: true } : notif)));
+    }, []);
+    const clearNotifications = (0, react_1.useCallback)(() => {
+        setNotifications([]);
+    }, []);
+    const exportData = (0, react_1.useCallback)(() => {
+        // Export all data to JSON
+        const data = {
+            filters,
+            notifications,
+            timestamp: new Date().toISOString(),
+        };
+        const blob = new Blob([JSON.stringify(data, null, 2)], { type: 'application/json' });
+        const url = URL.createObjectURL(blob);
+        const a = document.createElement('a');
+        a.href = url;
+        a.download = `dashboard-export-${new Date().toISOString()}.json`;
+        document.body.appendChild(a);
+        a.click();
+        document.body.removeChild(a);
+        URL.revokeObjectURL(url);
+        addNotification({
+            type: 'success',
+            title: 'Export Complete',
+            message: 'Dashboard data exported successfully',
+        });
+    }, [filters, notifications, addNotification]);
+    const refreshData = (0, react_1.useCallback)(() => {
+        // Trigger refresh event
+        if (wsClient && wsConnected) {
+            wsClient.send({ type: 'refresh', timestamp: new Date().toISOString() });
+        }
+        addNotification({
+            type: 'info',
+            title: 'Refreshing',
+            message: 'Data refresh requested',
+        });
+    }, [wsClient, wsConnected, addNotification]);
+    const value = {
+        filters,
+        updateFilters,
+        resetFilters,
+        wsClient,
+        wsConnected,
+        wsError,
+        notifications,
+        addNotification,
+        markNotificationRead,
+        clearNotifications,
+        activeView,
+        setActiveView,
+        exportData,
+        refreshData,
+    };
+    return react_1.default.createElement(DashboardContext.Provider, { value: value }, children);
+};
+exports.DashboardProvider = DashboardProvider;
+const useDashboard = () => {
+    const context = (0, react_1.useContext)(DashboardContext);
+    if (context === undefined) {
+        throw new Error('useDashboard must be used within a DashboardProvider');
+    }
+    return context;
+};
+exports.useDashboard = useDashboard;
+//# sourceMappingURL=DashboardContext.js.map

package/dist/contexts/DashboardContext.js.map

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

package/dist/core/memory/MemoryManagerFactory.d.ts

@@ -0,0 +1,77 @@
+/**
+ * MemoryManagerFactory - Singleton Pattern for Shared Memory Management
+ *
+ * Resolves the persistence issue where multiple SwarmMemoryManager instances
+ * cause data fragmentation - data written to one instance is not visible to others.
+ *
+ * Key Issues Fixed:
+ * 1. Multiple isolated instances (MCP server, AgentRegistry, Phase2Tools each created their own)
+ * 2. sql.js persistence model requires explicit save()/close() calls
+ * 3. Ensures all components share the same database connection
+ *
+ * @module MemoryManagerFactory
+ * @version 1.0.0
+ */
+import { SwarmMemoryManager } from './SwarmMemoryManager.js';
+/**
+ * Resolve database path - ensures we use an absolute path in user's project
+ *
+ * Database should be in the USER'S project directory (process.cwd()),
+ * NOT in the package installation directory.
+ */
+export declare function resolveDbPath(inputPath?: string): string;
+/**
+ * Ensure the database directory exists
+ */
+export declare function ensureDbDirectoryExists(dbPath: string): void;
+/**
+ * Get the shared SwarmMemoryManager singleton
+ *
+ * Ensures all components use the same database connection for consistent
+ * persistence across MCP server, AgentRegistry, handlers, and agents.
+ *
+ * @param dbPath Optional database path (relative paths resolved from cwd)
+ * @returns Shared SwarmMemoryManager instance
+ */
+export declare function getSharedMemoryManager(dbPath?: string): SwarmMemoryManager;
+/**
+ * Initialize the shared memory manager asynchronously
+ *
+ * This method ensures only ONE initialization happens even if called multiple times.
+ * All callers will receive the same initialized instance.
+ *
+ * @param dbPath Optional database path
+ * @returns Promise that resolves to the initialized SwarmMemoryManager
+ */
+export declare function initializeSharedMemoryManager(dbPath?: string): Promise<SwarmMemoryManager>;
+/**
+ * Check if shared memory manager is initialized
+ */
+export declare function hasSharedMemoryManager(): boolean;
+/**
+ * Get the path of the current shared memory manager
+ */
+export declare function getSharedMemoryManagerPath(): string | null;
+/**
+ * Reset the shared memory manager singleton
+ *
+ * Use with caution - this should only be called during testing or
+ * when explicitly changing database paths.
+ */
+export declare function resetSharedMemoryManager(): Promise<void>;
+/**
+ * Get database path info for debugging
+ */
+export declare function getDbPathInfo(): {
+    defaultPath: string;
+    currentSharedPath: string | null;
+    processCwd: string;
+    envPath: string | undefined;
+};
+/**
+ * Setup process exit handlers to ensure database is properly closed
+ *
+ * This is critical for sql.js which only persists to disk on close()
+ */
+export declare function setupExitHandlers(): void;
+//# sourceMappingURL=MemoryManagerFactory.d.ts.map

package/dist/core/memory/MemoryManagerFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MemoryManagerFactory.d.ts","sourceRoot":"","sources":["../../../src/core/memory/MemoryManagerFactory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAO7D;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA6BxD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAW5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CA0B1E;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CA8BhG;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAEhD;AAED;;GAEG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,GAAG,IAAI,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,IAAI,CAAC,CAY9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B,CAOA;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CA2CxC"}

package/dist/core/memory/MemoryManagerFactory.js

@@ -0,0 +1,270 @@
+"use strict";
+/**
+ * MemoryManagerFactory - Singleton Pattern for Shared Memory Management
+ *
+ * Resolves the persistence issue where multiple SwarmMemoryManager instances
+ * cause data fragmentation - data written to one instance is not visible to others.
+ *
+ * Key Issues Fixed:
+ * 1. Multiple isolated instances (MCP server, AgentRegistry, Phase2Tools each created their own)
+ * 2. sql.js persistence model requires explicit save()/close() calls
+ * 3. Ensures all components share the same database connection
+ *
+ * @module MemoryManagerFactory
+ * @version 1.0.0
+ */
+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.resolveDbPath = resolveDbPath;
+exports.ensureDbDirectoryExists = ensureDbDirectoryExists;
+exports.getSharedMemoryManager = getSharedMemoryManager;
+exports.initializeSharedMemoryManager = initializeSharedMemoryManager;
+exports.hasSharedMemoryManager = hasSharedMemoryManager;
+exports.getSharedMemoryManagerPath = getSharedMemoryManagerPath;
+exports.resetSharedMemoryManager = resetSharedMemoryManager;
+exports.getDbPathInfo = getDbPathInfo;
+exports.setupExitHandlers = setupExitHandlers;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const SwarmMemoryManager_js_1 = require("./SwarmMemoryManager.js");
+// Singleton instances
+let sharedMemoryManager = null;
+let sharedMemoryManagerPath = null;
+let initializationPromise = null;
+/**
+ * Resolve database path - ensures we use an absolute path in user's project
+ *
+ * Database should be in the USER'S project directory (process.cwd()),
+ * NOT in the package installation directory.
+ */
+function resolveDbPath(inputPath) {
+    // If no path provided, use default in user's project
+    if (!inputPath) {
+        return path.join(process.cwd(), '.agentic-qe', 'memory.db');
+    }
+    // Special case: in-memory database
+    if (inputPath === ':memory:') {
+        return inputPath;
+    }
+    // Check environment variable override
+    const envPath = process.env.AQE_DB_PATH;
+    if (envPath) {
+        // If absolute, use as-is
+        if (path.isAbsolute(envPath)) {
+            return envPath;
+        }
+        // If relative, resolve from cwd
+        return path.join(process.cwd(), envPath);
+    }
+    // If already absolute, return as-is
+    if (path.isAbsolute(inputPath)) {
+        return inputPath;
+    }
+    // Convert relative path to absolute using cwd (user's project)
+    return path.join(process.cwd(), inputPath);
+}
+/**
+ * Ensure the database directory exists
+ */
+function ensureDbDirectoryExists(dbPath) {
+    if (dbPath === ':memory:') {
+        return;
+    }
+    const dbDir = path.dirname(dbPath);
+    if (!fs.existsSync(dbDir)) {
+        fs.mkdirSync(dbDir, { recursive: true });
+        console.log(`[MemoryManagerFactory] Created database directory: ${dbDir}`);
+    }
+}
+/**
+ * Get the shared SwarmMemoryManager singleton
+ *
+ * Ensures all components use the same database connection for consistent
+ * persistence across MCP server, AgentRegistry, handlers, and agents.
+ *
+ * @param dbPath Optional database path (relative paths resolved from cwd)
+ * @returns Shared SwarmMemoryManager instance
+ */
+function getSharedMemoryManager(dbPath) {
+    const resolvedPath = resolveDbPath(dbPath);
+    // If singleton exists with same path, return it
+    if (sharedMemoryManager && sharedMemoryManagerPath === resolvedPath) {
+        return sharedMemoryManager;
+    }
+    // If singleton exists with different path, warn but return existing
+    // (prevents multiple database connections causing fragmentation)
+    if (sharedMemoryManager && sharedMemoryManagerPath !== resolvedPath) {
+        console.warn(`[MemoryManagerFactory] Memory manager already initialized with path: ${sharedMemoryManagerPath}. ` +
+            `Ignoring new path: ${resolvedPath}. Use resetSharedMemoryManager() to change path.`);
+        return sharedMemoryManager;
+    }
+    // Create new singleton
+    ensureDbDirectoryExists(resolvedPath);
+    console.log(`[MemoryManagerFactory] Creating shared memory manager at: ${resolvedPath}`);
+    sharedMemoryManager = new SwarmMemoryManager_js_1.SwarmMemoryManager(resolvedPath);
+    sharedMemoryManagerPath = resolvedPath;
+    return sharedMemoryManager;
+}
+/**
+ * Initialize the shared memory manager asynchronously
+ *
+ * This method ensures only ONE initialization happens even if called multiple times.
+ * All callers will receive the same initialized instance.
+ *
+ * @param dbPath Optional database path
+ * @returns Promise that resolves to the initialized SwarmMemoryManager
+ */
+async function initializeSharedMemoryManager(dbPath) {
+    // If already initializing, return the existing promise
+    if (initializationPromise) {
+        return initializationPromise;
+    }
+    // If already initialized, return the instance
+    if (sharedMemoryManager) {
+        const resolvedPath = resolveDbPath(dbPath);
+        if (sharedMemoryManagerPath === resolvedPath) {
+            return sharedMemoryManager;
+        }
+    }
+    // Start initialization
+    initializationPromise = (async () => {
+        const manager = getSharedMemoryManager(dbPath);
+        await manager.initialize();
+        console.log(`[MemoryManagerFactory] Shared memory manager initialized at: ${sharedMemoryManagerPath}`);
+        return manager;
+    })();
+    try {
+        const result = await initializationPromise;
+        return result;
+    }
+    catch (error) {
+        // Reset on failure so it can be retried
+        initializationPromise = null;
+        throw error;
+    }
+}
+/**
+ * Check if shared memory manager is initialized
+ */
+function hasSharedMemoryManager() {
+    return sharedMemoryManager !== null;
+}
+/**
+ * Get the path of the current shared memory manager
+ */
+function getSharedMemoryManagerPath() {
+    return sharedMemoryManagerPath;
+}
+/**
+ * Reset the shared memory manager singleton
+ *
+ * Use with caution - this should only be called during testing or
+ * when explicitly changing database paths.
+ */
+async function resetSharedMemoryManager() {
+    if (sharedMemoryManager) {
+        try {
+            await sharedMemoryManager.close();
+        }
+        catch (error) {
+            console.warn('[MemoryManagerFactory] Error closing memory manager:', error);
+        }
+        sharedMemoryManager = null;
+        sharedMemoryManagerPath = null;
+        initializationPromise = null;
+        console.log('[MemoryManagerFactory] Shared memory manager reset');
+    }
+}
+/**
+ * Get database path info for debugging
+ */
+function getDbPathInfo() {
+    return {
+        defaultPath: resolveDbPath(),
+        currentSharedPath: sharedMemoryManagerPath,
+        processCwd: process.cwd(),
+        envPath: process.env.AQE_DB_PATH
+    };
+}
+/**
+ * Setup process exit handlers to ensure database is properly closed
+ *
+ * This is critical for sql.js which only persists to disk on close()
+ */
+function setupExitHandlers() {
+    const cleanup = async () => {
+        if (sharedMemoryManager) {
+            console.log('[MemoryManagerFactory] Closing database on process exit...');
+            try {
+                await sharedMemoryManager.close();
+                console.log('[MemoryManagerFactory] Database closed successfully');
+            }
+            catch (error) {
+                console.error('[MemoryManagerFactory] Error closing database:', error);
+            }
+        }
+    };
+    // Handle normal exit
+    process.on('exit', () => {
+        // Can't use async here, but close() should be synchronous for better-sqlite3
+        if (sharedMemoryManager) {
+            try {
+                // SwarmMemoryManager.close() is async but better-sqlite3 close is sync
+                sharedMemoryManager.db?.close?.();
+            }
+            catch (error) {
+                console.error('[MemoryManagerFactory] Error on exit:', error);
+            }
+        }
+    });
+    // Handle termination signals
+    process.on('SIGINT', async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    process.on('SIGTERM', async () => {
+        await cleanup();
+        process.exit(0);
+    });
+    // Handle uncaught exceptions
+    process.on('uncaughtException', async (error) => {
+        console.error('[MemoryManagerFactory] Uncaught exception:', error);
+        await cleanup();
+        process.exit(1);
+    });
+}
+// Setup exit handlers when module is loaded
+setupExitHandlers();
+//# sourceMappingURL=MemoryManagerFactory.js.map

package/dist/core/memory/MemoryManagerFactory.js.map

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

package/dist/core/memory/SwarmMemoryManager.d.ts

@@ -180,6 +180,7 @@ export declare class SwarmMemoryManager {
     private initialized;
     private accessControl;
     private aclCache;
+    private patternCache;
     private agentDBManager;
     private lastModifiedTimestamps;
     private readonly TTL_POLICY;
@@ -188,6 +189,16 @@ export declare class SwarmMemoryManager {
     private queryOne;
     private queryAll;
     initialize(): Promise<void>;
+    /**
+     * Store a key-value pair in memory with OpenTelemetry instrumentation
+     *
+     * Automatically instruments the memory store operation with distributed tracing.
+     * Records namespace, key, value size, TTL, and operation performance metrics.
+     *
+     * @param key - Memory key
+     * @param value - Value to store (will be JSON serialized)
+     * @param options - Store options including partition, TTL, access control
+     */
     store(key: string, value: any, options?: StoreOptions): Promise<void>;
     /**
      * Alias for store() method to maintain compatibility with MemoryStore interface
@@ -199,8 +210,38 @@ export declare class SwarmMemoryManager {
      * Supports both options object and partition string
      */
     get(key: string, options?: RetrieveOptions | string): Promise<any>;
+    /**
+     * Retrieve a value from memory with OpenTelemetry instrumentation
+     *
+     * Automatically instruments the memory retrieve operation with distributed tracing.
+     * Records namespace, key, whether the value was found, value size, and performance metrics.
+     *
+     * @param key - Memory key
+     * @param options - Retrieve options including partition, agentId for access control
+     * @returns Retrieved value or null if not found
+     */
     retrieve(key: string, options?: RetrieveOptions): Promise<any>;
+    /**
+     * Query/search memory entries by pattern with OpenTelemetry instrumentation
+     *
+     * Automatically instruments the memory search operation with distributed tracing.
+     * Records namespace, search pattern, result count, and performance metrics.
+     *
+     * @param pattern - SQL LIKE pattern for key matching
+     * @param options - Retrieve options including partition, agentId for access control
+     * @returns Array of matching memory entries
+     */
     query(pattern: string, options?: RetrieveOptions): Promise<MemoryEntry[]>;
+    /**
+     * Delete a key from memory with OpenTelemetry instrumentation
+     *
+     * Automatically instruments the memory delete operation with distributed tracing.
+     * Records namespace, key, and operation performance metrics.
+     *
+     * @param key - Memory key to delete
+     * @param partition - Memory partition (namespace)
+     * @param options - Delete options including agentId for access control
+     */
     delete(key: string, partition?: string, options?: DeleteOptions): Promise<void>;
     clear(partition?: string): Promise<void>;
     postHint(hint: {
@@ -239,6 +280,11 @@ export declare class SwarmMemoryManager {
     storePattern(pattern: Pattern): Promise<string>;
     getPattern(patternName: string): Promise<Pattern>;
     incrementPatternUsage(patternName: string): Promise<void>;
+    /**
+     * Invalidate pattern cache for a specific agent
+     * Call this after any pattern mutation to maintain cache coherence
+     */
+    private invalidatePatternCacheForAgent;
     queryPatternsByConfidence(threshold: number): Promise<Pattern[]>;
     /**
      * Query patterns by agent ID and minimum confidence
@@ -247,7 +293,19 @@ export declare class SwarmMemoryManager {
      * @param minConfidence Minimum confidence threshold (default: 0)
      * @returns Array of patterns belonging to the agent
      */
+    /**
+     * Escape special LIKE pattern characters to prevent SQL injection
+     */
+    private escapeLikePattern;
     queryPatternsByAgent(agentId: string, minConfidence?: number): Promise<Pattern[]>;
+    /**
+     * Get pattern cache statistics for monitoring
+     */
+    getPatternCacheStats(): import("./PatternCache").CacheStats;
+    /**
+     * Clear pattern cache (useful after bulk updates)
+     */
+    clearPatternCache(): void;
     createConsensusProposal(proposal: ConsensusProposal): Promise<void>;
     getConsensusProposal(id: string): Promise<ConsensusProposal>;
     voteOnConsensus(proposalId: string, agentId: string): Promise<boolean>;