odd-flow 1.0.0

package/v3/@claude-flow/cli/dist/src/mcp-tools/session-tools.js

@@ -0,0 +1,315 @@
+/**
+ * Session MCP Tools for CLI
+ *
+ * Tool definitions for session management with file persistence.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, unlinkSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+// Storage paths
+const STORAGE_DIR = '.claude-flow';
+const SESSION_DIR = 'sessions';
+function getSessionDir() {
+    return join(process.cwd(), STORAGE_DIR, SESSION_DIR);
+}
+function getSessionPath(sessionId) {
+    // Sanitize sessionId to prevent path traversal
+    const safeId = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+    return join(getSessionDir(), `${safeId}.json`);
+}
+function ensureSessionDir() {
+    const dir = getSessionDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+}
+function loadSession(sessionId) {
+    try {
+        const path = getSessionPath(sessionId);
+        if (existsSync(path)) {
+            const data = readFileSync(path, 'utf-8');
+            return JSON.parse(data);
+        }
+    }
+    catch {
+        // Return null on error
+    }
+    return null;
+}
+function saveSession(session) {
+    ensureSessionDir();
+    writeFileSync(getSessionPath(session.sessionId), JSON.stringify(session, null, 2), { encoding: 'utf-8', mode: 0o600 });
+}
+function listSessions() {
+    ensureSessionDir();
+    const dir = getSessionDir();
+    const files = readdirSync(dir).filter(f => f.endsWith('.json'));
+    const sessions = [];
+    for (const file of files) {
+        try {
+            const data = readFileSync(join(dir, file), 'utf-8');
+            sessions.push(JSON.parse(data));
+        }
+        catch {
+            // Skip invalid files
+        }
+    }
+    return sessions;
+}
+// Load related stores for session data
+function loadRelatedStores(options) {
+    const data = {};
+    if (options.includeMemory) {
+        try {
+            const memoryPath = join(process.cwd(), STORAGE_DIR, 'memory', 'store.json');
+            if (existsSync(memoryPath)) {
+                data.memory = JSON.parse(readFileSync(memoryPath, 'utf-8'));
+            }
+        }
+        catch { /* ignore */ }
+    }
+    if (options.includeTasks) {
+        try {
+            const taskPath = join(process.cwd(), STORAGE_DIR, 'tasks', 'store.json');
+            if (existsSync(taskPath)) {
+                data.tasks = JSON.parse(readFileSync(taskPath, 'utf-8'));
+            }
+        }
+        catch { /* ignore */ }
+    }
+    if (options.includeAgents) {
+        try {
+            const agentPath = join(process.cwd(), STORAGE_DIR, 'agents', 'store.json');
+            if (existsSync(agentPath)) {
+                data.agents = JSON.parse(readFileSync(agentPath, 'utf-8'));
+            }
+        }
+        catch { /* ignore */ }
+    }
+    return data;
+}
+export const sessionTools = [
+    {
+        name: 'session_save',
+        description: 'Save current session state',
+        category: 'session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Session name' },
+                description: { type: 'string', description: 'Session description' },
+                includeMemory: { type: 'boolean', description: 'Include memory in session' },
+                includeTasks: { type: 'boolean', description: 'Include tasks in session' },
+                includeAgents: { type: 'boolean', description: 'Include agents in session' },
+            },
+            required: ['name'],
+        },
+        handler: async (input) => {
+            const sessionId = `session-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            // Load related data based on options
+            const data = loadRelatedStores({
+                includeMemory: input.includeMemory,
+                includeTasks: input.includeTasks,
+                includeAgents: input.includeAgents,
+            });
+            // Calculate stats
+            const stats = {
+                tasks: data.tasks ? Object.keys(data.tasks.tasks || {}).length : 0,
+                agents: data.agents ? Object.keys(data.agents.agents || {}).length : 0,
+                memoryEntries: data.memory ? Object.keys(data.memory.entries || {}).length : 0,
+                totalSize: 0,
+            };
+            const session = {
+                sessionId,
+                name: input.name,
+                description: input.description,
+                savedAt: new Date().toISOString(),
+                stats,
+                data: Object.keys(data).length > 0 ? data : undefined,
+            };
+            // Calculate size
+            const sessionJson = JSON.stringify(session);
+            session.stats.totalSize = Buffer.byteLength(sessionJson, 'utf-8');
+            saveSession(session);
+            return {
+                sessionId,
+                name: session.name,
+                savedAt: session.savedAt,
+                stats: session.stats,
+                path: getSessionPath(sessionId),
+            };
+        },
+    },
+    {
+        name: 'session_restore',
+        description: 'Restore a saved session',
+        category: 'session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionId: { type: 'string', description: 'Session ID to restore' },
+                name: { type: 'string', description: 'Session name to restore' },
+            },
+        },
+        handler: async (input) => {
+            let session = null;
+            // Try to find by sessionId first
+            if (input.sessionId) {
+                session = loadSession(input.sessionId);
+            }
+            // Try to find by name if sessionId not found
+            if (!session && input.name) {
+                const sessions = listSessions();
+                session = sessions.find(s => s.name === input.name) || null;
+            }
+            // Try to find latest if no params
+            if (!session && !input.sessionId && !input.name) {
+                const sessions = listSessions();
+                if (sessions.length > 0) {
+                    sessions.sort((a, b) => new Date(b.savedAt).getTime() - new Date(a.savedAt).getTime());
+                    session = sessions[0];
+                }
+            }
+            if (session) {
+                // Restore data to respective stores
+                if (session.data?.memory) {
+                    const memoryDir = join(process.cwd(), STORAGE_DIR, 'memory');
+                    if (!existsSync(memoryDir))
+                        mkdirSync(memoryDir, { recursive: true });
+                    writeFileSync(join(memoryDir, 'store.json'), JSON.stringify(session.data.memory, null, 2), { encoding: 'utf-8', mode: 0o600 });
+                }
+                if (session.data?.tasks) {
+                    const taskDir = join(process.cwd(), STORAGE_DIR, 'tasks');
+                    if (!existsSync(taskDir))
+                        mkdirSync(taskDir, { recursive: true });
+                    writeFileSync(join(taskDir, 'store.json'), JSON.stringify(session.data.tasks, null, 2), { encoding: 'utf-8', mode: 0o600 });
+                }
+                if (session.data?.agents) {
+                    const agentDir = join(process.cwd(), STORAGE_DIR, 'agents');
+                    if (!existsSync(agentDir))
+                        mkdirSync(agentDir, { recursive: true });
+                    writeFileSync(join(agentDir, 'store.json'), JSON.stringify(session.data.agents, null, 2), { encoding: 'utf-8', mode: 0o600 });
+                }
+                return {
+                    sessionId: session.sessionId,
+                    name: session.name,
+                    restored: true,
+                    restoredAt: new Date().toISOString(),
+                    stats: session.stats,
+                };
+            }
+            return {
+                sessionId: input.sessionId || input.name || 'latest',
+                restored: false,
+                error: 'Session not found',
+            };
+        },
+    },
+    {
+        name: 'session_list',
+        description: 'List saved sessions',
+        category: 'session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                limit: { type: 'number', description: 'Maximum sessions to return' },
+                sortBy: { type: 'string', description: 'Sort field (date, name, size)' },
+            },
+        },
+        handler: async (input) => {
+            let sessions = listSessions();
+            // Sort
+            const sortBy = input.sortBy || 'date';
+            if (sortBy === 'date') {
+                sessions.sort((a, b) => new Date(b.savedAt).getTime() - new Date(a.savedAt).getTime());
+            }
+            else if (sortBy === 'name') {
+                sessions.sort((a, b) => a.name.localeCompare(b.name));
+            }
+            else if (sortBy === 'size') {
+                sessions.sort((a, b) => b.stats.totalSize - a.stats.totalSize);
+            }
+            // Apply limit
+            const limit = input.limit || 10;
+            sessions = sessions.slice(0, limit);
+            return {
+                sessions: sessions.map(s => ({
+                    sessionId: s.sessionId,
+                    name: s.name,
+                    description: s.description,
+                    savedAt: s.savedAt,
+                    stats: s.stats,
+                })),
+                total: sessions.length,
+                limit,
+            };
+        },
+    },
+    {
+        name: 'session_delete',
+        description: 'Delete a saved session',
+        category: 'session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionId: { type: 'string', description: 'Session ID to delete' },
+            },
+            required: ['sessionId'],
+        },
+        handler: async (input) => {
+            const sessionId = input.sessionId;
+            const path = getSessionPath(sessionId);
+            if (existsSync(path)) {
+                unlinkSync(path);
+                return {
+                    sessionId,
+                    deleted: true,
+                    deletedAt: new Date().toISOString(),
+                };
+            }
+            return {
+                sessionId,
+                deleted: false,
+                error: 'Session not found',
+            };
+        },
+    },
+    {
+        name: 'session_info',
+        description: 'Get detailed session information',
+        category: 'session',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sessionId: { type: 'string', description: 'Session ID' },
+            },
+            required: ['sessionId'],
+        },
+        handler: async (input) => {
+            const sessionId = input.sessionId;
+            const session = loadSession(sessionId);
+            if (session) {
+                const path = getSessionPath(sessionId);
+                const stat = statSync(path);
+                return {
+                    sessionId: session.sessionId,
+                    name: session.name,
+                    description: session.description,
+                    savedAt: session.savedAt,
+                    stats: session.stats,
+                    fileSize: stat.size,
+                    path,
+                    hasData: {
+                        memory: !!session.data?.memory,
+                        tasks: !!session.data?.tasks,
+                        agents: !!session.data?.agents,
+                    },
+                };
+            }
+            return {
+                sessionId,
+                error: 'Session not found',
+            };
+        },
+    },
+];
+//# sourceMappingURL=session-tools.js.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Swarm MCP Tools for CLI
+ *
+ * Tool definitions for swarm coordination with file-based state persistence.
+ * Replaces previous stub implementations with real state tracking.
+ */
+import type { MCPTool } from './types.js';
+export declare const swarmTools: MCPTool[];
+//# sourceMappingURL=swarm-tools.d.ts.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/swarm-tools.js

@@ -0,0 +1,288 @@
+/**
+ * Swarm MCP Tools for CLI
+ *
+ * Tool definitions for swarm coordination with file-based state persistence.
+ * Replaces previous stub implementations with real state tracking.
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// Swarm state persistence
+const SWARM_DIR = '.claude-flow/swarm';
+const SWARM_STATE_FILE = 'swarm-state.json';
+function getSwarmDir() {
+    return join(process.cwd(), SWARM_DIR);
+}
+function getSwarmStatePath() {
+    return join(getSwarmDir(), SWARM_STATE_FILE);
+}
+function ensureSwarmDir() {
+    const dir = getSwarmDir();
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
+    }
+}
+function loadSwarmStore() {
+    try {
+        const path = getSwarmStatePath();
+        if (existsSync(path)) {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+    }
+    catch { /* return default */ }
+    return { swarms: {}, version: '3.0.0' };
+}
+function saveSwarmStore(store) {
+    ensureSwarmDir();
+    writeFileSync(getSwarmStatePath(), JSON.stringify(store, null, 2), 'utf-8');
+}
+// Input validation
+const VALID_TOPOLOGIES = new Set([
+    'hierarchical', 'mesh', 'hierarchical-mesh', 'ring', 'star', 'hybrid', 'adaptive',
+]);
+export const swarmTools = [
+    {
+        name: 'swarm_init',
+        description: 'Initialize a swarm with persistent state tracking',
+        category: 'swarm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                topology: { type: 'string', description: 'Swarm topology type (hierarchical, mesh, hierarchical-mesh, ring, star, hybrid, adaptive)' },
+                maxAgents: { type: 'number', description: 'Maximum number of agents (1-50)' },
+                strategy: { type: 'string', description: 'Agent strategy (specialized, balanced, adaptive)' },
+                config: { type: 'object', description: 'Additional swarm configuration' },
+            },
+        },
+        handler: async (input) => {
+            const topology = input.topology || 'hierarchical-mesh';
+            const maxAgents = Math.min(Math.max(input.maxAgents || 15, 1), 50);
+            const strategy = input.strategy || 'specialized';
+            const config = (input.config || {});
+            if (!VALID_TOPOLOGIES.has(topology)) {
+                return {
+                    success: false,
+                    error: `Invalid topology: ${topology}. Valid: ${[...VALID_TOPOLOGIES].join(', ')}`,
+                };
+            }
+            const swarmId = `swarm-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+            const now = new Date().toISOString();
+            const swarmState = {
+                swarmId,
+                topology,
+                maxAgents,
+                status: 'running',
+                agents: [],
+                tasks: [],
+                config: {
+                    topology,
+                    maxAgents,
+                    strategy,
+                    communicationProtocol: config.communicationProtocol || 'message-bus',
+                    autoScaling: config.autoScaling ?? true,
+                    consensusMechanism: config.consensusMechanism || 'majority',
+                },
+                createdAt: now,
+                updatedAt: now,
+            };
+            const store = loadSwarmStore();
+            store.swarms[swarmId] = swarmState;
+            saveSwarmStore(store);
+            return {
+                success: true,
+                swarmId,
+                topology,
+                strategy,
+                maxAgents,
+                initializedAt: now,
+                config: swarmState.config,
+                persisted: true,
+            };
+        },
+    },
+    {
+        name: 'swarm_status',
+        description: 'Get swarm status from persistent state',
+        category: 'swarm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                swarmId: { type: 'string', description: 'Swarm ID (omit for most recent)' },
+            },
+        },
+        handler: async (input) => {
+            const store = loadSwarmStore();
+            const swarmId = input.swarmId;
+            if (swarmId && store.swarms[swarmId]) {
+                const swarm = store.swarms[swarmId];
+                return {
+                    swarmId: swarm.swarmId,
+                    status: swarm.status,
+                    topology: swarm.topology,
+                    maxAgents: swarm.maxAgents,
+                    agentCount: swarm.agents.length,
+                    taskCount: swarm.tasks.length,
+                    config: swarm.config,
+                    createdAt: swarm.createdAt,
+                    updatedAt: swarm.updatedAt,
+                };
+            }
+            // Return most recent swarm if no ID specified
+            const swarmIds = Object.keys(store.swarms);
+            if (swarmIds.length === 0) {
+                return {
+                    status: 'no_swarm',
+                    message: 'No active swarms. Use swarm_init to create one.',
+                    totalSwarms: 0,
+                };
+            }
+            const latest = swarmIds
+                .map(id => store.swarms[id])
+                .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime())[0];
+            return {
+                swarmId: latest.swarmId,
+                status: latest.status,
+                topology: latest.topology,
+                maxAgents: latest.maxAgents,
+                agentCount: latest.agents.length,
+                taskCount: latest.tasks.length,
+                config: latest.config,
+                createdAt: latest.createdAt,
+                updatedAt: latest.updatedAt,
+                totalSwarms: swarmIds.length,
+            };
+        },
+    },
+    {
+        name: 'swarm_shutdown',
+        description: 'Shutdown a swarm and update persistent state',
+        category: 'swarm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                swarmId: { type: 'string', description: 'Swarm ID to shutdown' },
+                graceful: { type: 'boolean', description: 'Graceful shutdown (default: true)' },
+            },
+        },
+        handler: async (input) => {
+            const store = loadSwarmStore();
+            const swarmId = input.swarmId;
+            // Find the swarm
+            let target;
+            if (swarmId && store.swarms[swarmId]) {
+                target = store.swarms[swarmId];
+            }
+            else {
+                // Shutdown most recent running swarm
+                const running = Object.values(store.swarms)
+                    .filter(s => s.status === 'running')
+                    .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+                target = running[0];
+            }
+            if (!target) {
+                return {
+                    success: false,
+                    error: swarmId ? `Swarm ${swarmId} not found` : 'No running swarms to shutdown',
+                };
+            }
+            if (target.status === 'terminated') {
+                return {
+                    success: false,
+                    swarmId: target.swarmId,
+                    error: 'Swarm already terminated',
+                };
+            }
+            target.status = 'terminated';
+            target.updatedAt = new Date().toISOString();
+            saveSwarmStore(store);
+            return {
+                success: true,
+                swarmId: target.swarmId,
+                terminated: true,
+                graceful: input.graceful ?? true,
+                agentsTerminated: target.agents.length,
+                terminatedAt: target.updatedAt,
+            };
+        },
+    },
+    {
+        name: 'swarm_health',
+        description: 'Check swarm health status with real state inspection',
+        category: 'swarm',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                swarmId: { type: 'string', description: 'Swarm ID to check' },
+            },
+        },
+        handler: async (input) => {
+            const store = loadSwarmStore();
+            const swarmId = input.swarmId;
+            // Find the swarm
+            let target;
+            if (swarmId) {
+                target = store.swarms[swarmId];
+                if (!target) {
+                    return {
+                        status: 'not_found',
+                        healthy: false,
+                        checks: [
+                            { name: 'swarm_exists', status: 'fail', message: `Swarm ${swarmId} not found` },
+                        ],
+                        checkedAt: new Date().toISOString(),
+                    };
+                }
+            }
+            else {
+                const running = Object.values(store.swarms)
+                    .filter(s => s.status === 'running')
+                    .sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+                target = running[0];
+            }
+            if (!target) {
+                return {
+                    status: 'no_swarm',
+                    healthy: false,
+                    checks: [
+                        { name: 'swarm_exists', status: 'fail', message: 'No active swarm found' },
+                    ],
+                    checkedAt: new Date().toISOString(),
+                };
+            }
+            const isRunning = target.status === 'running';
+            const stateFileExists = existsSync(getSwarmStatePath());
+            const checks = [
+                {
+                    name: 'coordinator',
+                    status: isRunning ? 'ok' : 'warn',
+                    message: isRunning ? 'Coordinator active' : `Swarm status: ${target.status}`,
+                },
+                {
+                    name: 'agents',
+                    status: target.agents.length > 0 ? 'ok' : 'info',
+                    message: `${target.agents.length} agents registered (max: ${target.maxAgents})`,
+                },
+                {
+                    name: 'persistence',
+                    status: stateFileExists ? 'ok' : 'warn',
+                    message: stateFileExists ? 'State file persisted' : 'State file missing',
+                },
+                {
+                    name: 'topology',
+                    status: 'ok',
+                    message: `Topology: ${target.topology}`,
+                },
+            ];
+            const healthy = isRunning && stateFileExists;
+            return {
+                status: healthy ? 'healthy' : 'degraded',
+                healthy,
+                swarmId: target.swarmId,
+                topology: target.topology,
+                agentCount: target.agents.length,
+                checks,
+                checkedAt: new Date().toISOString(),
+            };
+        },
+    },
+];
+//# sourceMappingURL=swarm-tools.js.map

package/v3/@claude-flow/cli/dist/src/mcp-tools/system-tools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * System MCP Tools for CLI
+ *
+ * V2 Compatibility - System monitoring tools: status, metrics, health
+ *
+ * ✅ Uses REAL system metrics via Node.js APIs:
+ * - process.memoryUsage() for real memory stats
+ * - process.cpuUsage() for real CPU stats
+ * - os module for system information
+ */
+import type { MCPTool } from './types.js';
+export declare const systemTools: MCPTool[];
+//# sourceMappingURL=system-tools.d.ts.map