claude-flow 2.7.0-alpha.13 → 2.7.0-alpha.14

package/dist/reasoningbank/reasoningbank-adapter.js

@@ -0,0 +1,365 @@
+/**
+ * ReasoningBank Adapter for Claude-Flow (Node.js Backend)
+ *
+ * Uses agentic-flow@1.5.13 Node.js backend with SQLite for persistent storage
+ * Provides semantic search via embeddings and MMR ranking
+ *
+ * Backend: SQLite with better-sqlite3
+ * Features: Persistent storage, semantic search, memory consolidation
+ */
+import * as ReasoningBank from 'agentic-flow/reasoningbank';
+import { v4 as uuidv4 } from 'uuid';
+// Backend instance (singleton)
+let backendInitialized = false;
+let initPromise = null;
+// Query result cache (LRU)
+const queryCache = new Map();
+const CACHE_SIZE = 100;
+const CACHE_TTL = 60000; // 60 seconds
+/**
+ * Initialize ReasoningBank Node.js backend
+ * @returns {Promise<boolean>}
+ */
+async function ensureInitialized() {
+    if (backendInitialized) {
+        return true;
+    }
+    if (initPromise) {
+        return initPromise;
+    }
+    initPromise = (async () => {
+        try {
+            // Initialize Node.js backend with SQLite database
+            await ReasoningBank.initialize();
+            backendInitialized = true;
+            console.log('[ReasoningBank] Node.js backend initialized successfully');
+            return true;
+        }
+        catch (error) {
+            console.error('[ReasoningBank] Backend initialization failed:', error);
+            throw new Error(`Failed to initialize ReasoningBank: ${error.message}`);
+        }
+    })();
+    return initPromise;
+}
+/**
+ * Initialize ReasoningBank database (Node.js version)
+ */
+export async function initializeReasoningBank() {
+    // Initialize the Node.js backend
+    await ensureInitialized();
+    return true;
+}
+/**
+ * Store a memory in ReasoningBank (Node.js backend with SQLite)
+ *
+ * Maps claude-flow memory model to ReasoningBank pattern model:
+ * - key -> title
+ * - value -> content (searchable text)
+ * - namespace -> domain
+ * - confidence -> confidence score
+ */
+export async function storeMemory(key, value, options = {}) {
+    await ensureInitialized();
+    try {
+        const memoryId = options.id || uuidv4();
+        // Map our memory model to ReasoningBank pattern model
+        const memory = {
+            id: memoryId,
+            type: 'reasoning_memory',
+            pattern_data: {
+                title: key,
+                content: value,
+                domain: options.namespace || 'default',
+                agent: options.agent || 'memory-agent',
+                task_type: options.type || 'fact',
+                // Store original values for compatibility
+                original_key: key,
+                original_value: value,
+                namespace: options.namespace || 'default'
+            },
+            confidence: options.confidence || 0.8,
+            usage_count: 0
+        };
+        // Store memory using Node.js backend
+        ReasoningBank.db.upsertMemory(memory);
+        // Generate and store embedding for semantic search
+        try {
+            const embedding = await ReasoningBank.computeEmbedding(value);
+            ReasoningBank.db.upsertEmbedding({
+                id: memoryId,
+                model: 'text-embedding-3-small', // Default model
+                dims: embedding.length,
+                vector: embedding
+            });
+        }
+        catch (embeddingError) {
+            console.warn('[ReasoningBank] Failed to generate embedding:', embeddingError.message);
+            // Continue without embedding - memory is still stored
+        }
+        // Invalidate query cache when new memory is added
+        queryCache.clear();
+        return memoryId;
+    }
+    catch (error) {
+        console.error('[ReasoningBank] storeMemory failed:', error);
+        throw new Error(`Failed to store memory: ${error.message}`);
+    }
+}
+/**
+ * Query memories from ReasoningBank (Node.js backend with semantic search)
+ *
+ * Uses retrieveMemories for semantic search via embeddings and MMR ranking
+ * Fallback to database query if semantic search fails
+ */
+export async function queryMemories(searchQuery, options = {}) {
+    // Check cache first
+    const cached = getCachedQuery(searchQuery, options);
+    if (cached) {
+        return cached;
+    }
+    await ensureInitialized();
+    const limit = options.limit || 10;
+    // Accept both 'namespace' and 'domain' for compatibility
+    const namespace = options.namespace || options.domain || 'default';
+    try {
+        // Try semantic search first using retrieveMemories
+        const results = await ReasoningBank.retrieveMemories(searchQuery, {
+            domain: namespace,
+            agent: options.agent || 'query-agent',
+            k: limit,
+            minConfidence: options.minConfidence || 0.3
+        });
+        // Map backend results to our memory format
+        // retrieveMemories returns: { id, title, content, description, score, components }
+        const memories = results.map(memory => ({
+            id: memory.id,
+            key: memory.title || 'unknown',
+            value: memory.content || memory.description || '',
+            namespace: namespace, // Use the namespace from our query
+            confidence: memory.components?.reliability || 0.8,
+            usage_count: memory.usage_count || 0,
+            created_at: memory.created_at || new Date().toISOString(),
+            score: memory.score || 0,
+            // Include original pattern for debugging
+            _pattern: memory
+        }));
+        // If no results, try direct database query as fallback
+        if (memories.length === 0) {
+            console.warn('[ReasoningBank] Semantic search returned 0 results, trying database fallback');
+            const fallbackResults = ReasoningBank.db.fetchMemoryCandidates({
+                domain: namespace,
+                minConfidence: options.minConfidence || 0.3
+            });
+            const fallbackMemories = fallbackResults.slice(0, limit).map(memory => ({
+                id: memory.id,
+                key: memory.pattern_data?.title || memory.pattern_data?.original_key || 'unknown',
+                value: memory.pattern_data?.content || memory.pattern_data?.original_value || '',
+                namespace: memory.pattern_data?.domain || memory.pattern_data?.namespace || 'default',
+                confidence: memory.confidence || 0.8,
+                usage_count: memory.usage_count || 0,
+                created_at: memory.created_at || new Date().toISOString()
+            }));
+            // Cache and return fallback results
+            setCachedQuery(searchQuery, options, fallbackMemories);
+            return fallbackMemories;
+        }
+        // Cache successful results
+        setCachedQuery(searchQuery, options, memories);
+        return memories;
+    }
+    catch (error) {
+        console.warn('[ReasoningBank] Query failed, trying database fallback:', error.message);
+        try {
+            // Final fallback: direct database query
+            const fallbackResults = ReasoningBank.db.fetchMemoryCandidates({
+                domain: namespace,
+                minConfidence: options.minConfidence || 0.3
+            });
+            const fallbackMemories = fallbackResults.slice(0, limit).map(memory => ({
+                id: memory.id,
+                key: memory.pattern_data?.title || 'unknown',
+                value: memory.pattern_data?.content || '',
+                namespace: memory.pattern_data?.domain || 'default',
+                confidence: memory.confidence || 0.8,
+                usage_count: memory.usage_count || 0,
+                created_at: memory.created_at || new Date().toISOString()
+            }));
+            setCachedQuery(searchQuery, options, fallbackMemories);
+            return fallbackMemories;
+        }
+        catch (fallbackError) {
+            console.error('[ReasoningBank] All query methods failed:', fallbackError);
+            return [];
+        }
+    }
+}
+/**
+ * List all memories (using Node.js backend database query)
+ */
+export async function listMemories(options = {}) {
+    await ensureInitialized();
+    const limit = options.limit || 10;
+    const namespace = options.namespace;
+    try {
+        let memories;
+        if (namespace && namespace !== 'default') {
+            // Filter by namespace/domain
+            const allMemories = ReasoningBank.db.getAllActiveMemories();
+            memories = allMemories
+                .filter(m => m.pattern_data?.domain === namespace)
+                .slice(0, limit);
+        }
+        else {
+            // Get all active memories
+            memories = ReasoningBank.db.getAllActiveMemories().slice(0, limit);
+        }
+        return memories.map(memory => ({
+            id: memory.id,
+            key: memory.pattern_data?.title || memory.pattern_data?.original_key || 'unknown',
+            value: memory.pattern_data?.content || memory.pattern_data?.original_value || '',
+            namespace: memory.pattern_data?.domain || memory.pattern_data?.namespace || 'default',
+            confidence: memory.confidence || 0.8,
+            usage_count: memory.usage_count || 0,
+            created_at: memory.created_at || new Date().toISOString()
+        }));
+    }
+    catch (error) {
+        console.error('[ReasoningBank] listMemories failed:', error);
+        return [];
+    }
+}
+/**
+ * Get ReasoningBank statistics (Node.js backend)
+ */
+export async function getStatus() {
+    await ensureInitialized();
+    try {
+        const db = ReasoningBank.db.getDb();
+        // Count patterns
+        const patterns = db.prepare("SELECT COUNT(*) as count FROM patterns WHERE type = 'reasoning_memory'").get();
+        const embeddings = db.prepare("SELECT COUNT(*) as count FROM pattern_embeddings").get();
+        const trajectories = db.prepare("SELECT COUNT(*) as count FROM task_trajectories").get();
+        const links = db.prepare("SELECT COUNT(*) as count FROM pattern_links").get();
+        // Get average confidence
+        const avgConf = db.prepare("SELECT AVG(confidence) as avg FROM patterns WHERE type = 'reasoning_memory'").get();
+        // Count unique domains
+        const domains = db.prepare("SELECT COUNT(DISTINCT json_extract(pattern_data, '$.domain')) as count FROM patterns WHERE type = 'reasoning_memory'").get();
+        return {
+            total_memories: patterns.count || 0,
+            total_categories: domains.count || 0,
+            storage_backend: 'SQLite (Node.js)',
+            database_path: process.env.CLAUDE_FLOW_DB_PATH || '.swarm/memory.db',
+            performance: 'SQLite with persistent storage',
+            avg_confidence: avgConf.avg || 0.8,
+            total_embeddings: embeddings.count || 0,
+            total_trajectories: trajectories.count || 0,
+            total_links: links.count || 0
+        };
+    }
+    catch (error) {
+        console.error('[ReasoningBank] getStatus failed:', error);
+        return {
+            total_memories: 0,
+            error: error.message
+        };
+    }
+}
+/**
+ * Check which ReasoningBank tables are present (Node.js backend)
+ */
+export async function checkReasoningBankTables() {
+    try {
+        await ensureInitialized();
+        const db = ReasoningBank.db.getDb();
+        const tables = db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name LIKE 'pattern%'").all();
+        const tableNames = tables.map(t => t.name);
+        const requiredTables = ['patterns', 'pattern_embeddings', 'pattern_links', 'task_trajectories'];
+        const missingTables = requiredTables.filter(t => !tableNames.includes(t));
+        return {
+            exists: true,
+            existingTables: tableNames,
+            missingTables: missingTables,
+            requiredTables: requiredTables,
+            backend: 'SQLite (Node.js)',
+            note: missingTables.length > 0 ? 'Some tables are missing - run migrations' : 'All tables present'
+        };
+    }
+    catch (error) {
+        return {
+            exists: false,
+            existingTables: [],
+            missingTables: [],
+            requiredTables: [],
+            error: error.message
+        };
+    }
+}
+/**
+ * Migrate existing database (Node.js backend - run migrations)
+ */
+export async function migrateReasoningBank() {
+    try {
+        await ReasoningBank.db.runMigrations();
+        return {
+            success: true,
+            message: 'Database migrations completed successfully',
+            migrated: true,
+            database_path: process.env.CLAUDE_FLOW_DB_PATH || '.swarm/memory.db'
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Migration failed: ${error.message}`,
+            error: error.message
+        };
+    }
+}
+/**
+ * Get cached query results
+ */
+function getCachedQuery(searchQuery, options) {
+    const cacheKey = JSON.stringify({ searchQuery, options });
+    const cached = queryCache.get(cacheKey);
+    if (cached && Date.now() - cached.timestamp < CACHE_TTL) {
+        return cached.results;
+    }
+    return null;
+}
+/**
+ * Set cached query results (LRU eviction)
+ */
+function setCachedQuery(searchQuery, options, results) {
+    const cacheKey = JSON.stringify({ searchQuery, options });
+    // LRU eviction
+    if (queryCache.size >= CACHE_SIZE) {
+        const firstKey = queryCache.keys().next().value;
+        queryCache.delete(firstKey);
+    }
+    queryCache.set(cacheKey, {
+        results,
+        timestamp: Date.now()
+    });
+}
+/**
+ * Close database connection and cleanup resources
+ * Should be called when done with ReasoningBank operations
+ */
+export function cleanup() {
+    try {
+        if (backendInitialized) {
+            // Clear embedding cache (prevents memory leaks)
+            ReasoningBank.clearEmbeddingCache();
+            // Close database connection
+            ReasoningBank.db.closeDb();
+            backendInitialized = false;
+            initPromise = null;
+            console.log('[ReasoningBank] Database connection closed');
+        }
+    }
+    catch (error) {
+        console.error('[ReasoningBank] Cleanup failed:', error.message);
+    }
+}
+//# sourceMappingURL=reasoningbank-adapter.js.map

package/dist/reasoningbank/reasoningbank-adapter.js.map

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

package/dist/sdk/query-control.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Real-Time Query Control
+ * Claude-Flow v2.5-alpha.130
+ *
+ * Implements real-time control of running agent queries:
+ * - Pause/resume execution
+ * - Terminate agents dynamically
+ * - Change model or permissions mid-execution
+ * - Monitor agent status in real-time
+ */
+import { type Query, type PermissionMode, type ModelInfo } from '@anthropic-ai/claude-code/sdk';
+import { EventEmitter } from 'events';
+export interface QueryControlOptions {
+    allowPause?: boolean;
+    allowModelChange?: boolean;
+    allowPermissionChange?: boolean;
+    monitoringInterval?: number;
+}
+export interface ControlledQuery {
+    queryId: string;
+    agentId: string;
+    query: Query;
+    status: 'running' | 'paused' | 'terminated' | 'completed' | 'failed';
+    isPaused: boolean;
+    canControl: boolean;
+    startTime: number;
+    pausedAt?: number;
+    resumedAt?: number;
+    terminatedAt?: number;
+    currentModel?: string;
+    permissionMode?: PermissionMode;
+}
+export interface QueryControlCommand {
+    type: 'pause' | 'resume' | 'terminate' | 'changeModel' | 'changePermissions';
+    queryId: string;
+    params?: {
+        model?: string;
+        permissionMode?: PermissionMode;
+        reason?: string;
+    };
+}
+export interface QueryStatusUpdate {
+    queryId: string;
+    status: ControlledQuery['status'];
+    timestamp: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * RealTimeQueryController - Control running queries dynamically
+ * Enables pause, resume, terminate, and configuration changes during execution
+ */
+export declare class RealTimeQueryController extends EventEmitter {
+    private logger;
+    private controlledQueries;
+    private monitoringIntervals;
+    private commandQueue;
+    private options;
+    constructor(options?: QueryControlOptions);
+    /**
+     * Register a query for control
+     */
+    registerQuery(queryId: string, agentId: string, query: Query): ControlledQuery;
+    /**
+     * Pause a running query
+     * Note: SDK interrupt() will stop the query, not pause it
+     * True pause/resume requires custom implementation
+     */
+    pauseQuery(queryId: string, reason?: string): Promise<boolean>;
+    /**
+     * Resume a paused query
+     * Note: Actual resume requires storing state and restarting
+     */
+    resumeQuery(queryId: string): Promise<boolean>;
+    /**
+     * Terminate a query immediately
+     */
+    terminateQuery(queryId: string, reason?: string): Promise<boolean>;
+    /**
+     * Change model for a running query
+     */
+    changeModel(queryId: string, model: string): Promise<boolean>;
+    /**
+     * Change permission mode for a running query
+     */
+    changePermissionMode(queryId: string, mode: PermissionMode): Promise<boolean>;
+    /**
+     * Get supported models for a query
+     */
+    getSupportedModels(queryId: string): Promise<ModelInfo[]>;
+    /**
+     * Execute a control command
+     */
+    executeCommand(command: QueryControlCommand): Promise<boolean>;
+    /**
+     * Queue a command for execution
+     */
+    queueCommand(command: QueryControlCommand): void;
+    /**
+     * Process queued commands for a query
+     */
+    processQueuedCommands(queryId: string): Promise<void>;
+    /**
+     * Get query status
+     */
+    getQueryStatus(queryId: string): ControlledQuery | undefined;
+    /**
+     * Get all controlled queries
+     */
+    getAllQueries(): Map<string, ControlledQuery>;
+    /**
+     * Start monitoring a query
+     */
+    private startMonitoring;
+    /**
+     * Stop monitoring a query
+     */
+    private stopMonitoring;
+    /**
+     * Unregister a query
+     */
+    unregisterQuery(queryId: string): void;
+    /**
+     * Cleanup completed queries
+     */
+    cleanup(olderThan?: number): void;
+    /**
+     * Shutdown controller
+     */
+    shutdown(): void;
+}
+//# sourceMappingURL=query-control.d.ts.map

package/dist/sdk/query-control.d.ts.map

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