@claude-flow/cli 3.5.24 → 3.5.26

package/dist/src/mcp-tools/ruvllm-tools.js

@@ -0,0 +1,283 @@
+/**
+ * RuVector LLM WASM MCP Tools
+ *
+ * Exposes @ruvector/ruvllm-wasm operations via MCP protocol.
+ * All tools gracefully degrade when the WASM package is not installed.
+ */
+async function loadRuvllmWasm() {
+    return import('../ruvector/ruvllm-wasm.js');
+}
+export const ruvllmWasmTools = [
+    {
+        name: 'ruvllm_status',
+        description: 'Get ruvllm-wasm availability and initialization status.',
+        inputSchema: { type: 'object', properties: {} },
+        handler: async () => {
+            try {
+                const mod = await loadRuvllmWasm();
+                const status = await mod.getRuvllmStatus();
+                return { content: [{ type: 'text', text: JSON.stringify(status, null, 2) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_hnsw_create',
+        description: 'Create a WASM HNSW router for semantic pattern routing. Max ~11 patterns (v2.0.1 limit).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                dimensions: { type: 'number', description: 'Embedding dimensions (e.g., 64, 128, 384)' },
+                maxPatterns: { type: 'number', description: 'Max patterns capacity (limit ~11 in v2.0.1)' },
+                efSearch: { type: 'number', description: 'HNSW ef search parameter (higher = more accurate, slower)' },
+            },
+            required: ['dimensions', 'maxPatterns'],
+        },
+        handler: async (args) => {
+            try {
+                const mod = await loadRuvllmWasm();
+                const router = await mod.createHnswRouter({
+                    dimensions: args.dimensions,
+                    maxPatterns: args.maxPatterns,
+                    efSearch: args.efSearch,
+                });
+                // Store router in module-level registry
+                const id = `hnsw-${Date.now().toString(36)}`;
+                hnswRouters.set(id, router);
+                return { content: [{ type: 'text', text: JSON.stringify({ success: true, routerId: id, dimensions: args.dimensions, maxPatterns: args.maxPatterns }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_hnsw_add',
+        description: 'Add a pattern to an HNSW router. Embedding must match router dimensions.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                routerId: { type: 'string', description: 'HNSW router ID from ruvllm_hnsw_create' },
+                name: { type: 'string', description: 'Pattern name/label' },
+                embedding: { type: 'array', description: 'Float array embedding vector' },
+                metadata: { type: 'object', description: 'Optional metadata object' },
+            },
+            required: ['routerId', 'name', 'embedding'],
+        },
+        handler: async (args) => {
+            try {
+                const router = hnswRouters.get(args.routerId);
+                if (!router)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `Router not found: ${args.routerId}` }) }], isError: true };
+                const embedding = new Float32Array(args.embedding);
+                const ok = router.addPattern({
+                    name: args.name,
+                    embedding,
+                    metadata: args.metadata,
+                });
+                return { content: [{ type: 'text', text: JSON.stringify({ success: ok, patternCount: router.patternCount() }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_hnsw_route',
+        description: 'Route a query embedding to nearest patterns in HNSW index.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                routerId: { type: 'string', description: 'HNSW router ID' },
+                query: { type: 'array', description: 'Query embedding vector' },
+                k: { type: 'number', description: 'Number of nearest neighbors (default: 3)' },
+            },
+            required: ['routerId', 'query'],
+        },
+        handler: async (args) => {
+            try {
+                const router = hnswRouters.get(args.routerId);
+                if (!router)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `Router not found: ${args.routerId}` }) }], isError: true };
+                const query = new Float32Array(args.query);
+                const results = router.route(query, args.k ?? 3);
+                return { content: [{ type: 'text', text: JSON.stringify({ results }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_sona_create',
+        description: 'Create a SONA instant adaptation loop (<1ms adaptation cycles).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                hiddenDim: { type: 'number', description: 'Hidden dimension (default: 64)' },
+                learningRate: { type: 'number', description: 'Learning rate (default: 0.01)' },
+                patternCapacity: { type: 'number', description: 'Max stored patterns' },
+            },
+        },
+        handler: async (args) => {
+            try {
+                const mod = await loadRuvllmWasm();
+                const sona = await mod.createSonaInstant({
+                    hiddenDim: args.hiddenDim,
+                    learningRate: args.learningRate,
+                    patternCapacity: args.patternCapacity,
+                });
+                const id = `sona-${Date.now().toString(36)}`;
+                sonaInstances.set(id, sona);
+                return { content: [{ type: 'text', text: JSON.stringify({ success: true, sonaId: id }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_sona_adapt',
+        description: 'Run SONA instant adaptation with a quality signal.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                sonaId: { type: 'string', description: 'SONA instance ID' },
+                quality: { type: 'number', description: 'Quality signal (0.0-1.0)' },
+            },
+            required: ['sonaId', 'quality'],
+        },
+        handler: async (args) => {
+            try {
+                const sona = sonaInstances.get(args.sonaId);
+                if (!sona)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `SONA not found: ${args.sonaId}` }) }], isError: true };
+                sona.adapt(args.quality);
+                return { content: [{ type: 'text', text: JSON.stringify({ success: true, stats: sona.stats() }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_microlora_create',
+        description: 'Create a MicroLoRA adapter (ultra-lightweight LoRA, ranks 1-4).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                inputDim: { type: 'number', description: 'Input dimension' },
+                outputDim: { type: 'number', description: 'Output dimension' },
+                rank: { type: 'number', description: 'LoRA rank (1-4, default: 2)' },
+                alpha: { type: 'number', description: 'LoRA alpha scaling (default: 1.0)' },
+            },
+            required: ['inputDim', 'outputDim'],
+        },
+        handler: async (args) => {
+            try {
+                const mod = await loadRuvllmWasm();
+                const lora = await mod.createMicroLora({
+                    inputDim: args.inputDim,
+                    outputDim: args.outputDim,
+                    rank: args.rank,
+                    alpha: args.alpha,
+                });
+                const id = `lora-${Date.now().toString(36)}`;
+                loraInstances.set(id, lora);
+                return { content: [{ type: 'text', text: JSON.stringify({ success: true, loraId: id }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_microlora_adapt',
+        description: 'Adapt MicroLoRA weights with quality feedback.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                loraId: { type: 'string', description: 'MicroLoRA instance ID' },
+                quality: { type: 'number', description: 'Quality signal (0.0-1.0)' },
+                learningRate: { type: 'number', description: 'Learning rate (default: 0.01)' },
+                success: { type: 'boolean', description: 'Whether the adaptation was successful (default: true)' },
+            },
+            required: ['loraId', 'quality'],
+        },
+        handler: async (args) => {
+            try {
+                const lora = loraInstances.get(args.loraId);
+                if (!lora)
+                    return { content: [{ type: 'text', text: JSON.stringify({ error: `MicroLoRA not found: ${args.loraId}` }) }], isError: true };
+                lora.adapt(args.quality, args.learningRate, args.success);
+                return { content: [{ type: 'text', text: JSON.stringify({ success: true, stats: lora.stats() }) }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_chat_format',
+        description: 'Format chat messages using a template (llama3, mistral, chatml, phi, gemma, or auto-detect).',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                messages: {
+                    type: 'array',
+                    description: 'Array of {role, content} message objects',
+                },
+                template: { type: 'string', description: 'Template preset (llama3, mistral, chatml, phi, gemma) or model ID for auto-detection' },
+            },
+            required: ['messages', 'template'],
+        },
+        handler: async (args) => {
+            try {
+                const mod = await loadRuvllmWasm();
+                const messages = args.messages;
+                const templateStr = args.template;
+                const presets = ['llama3', 'mistral', 'chatml', 'phi', 'gemma'];
+                const template = presets.includes(templateStr)
+                    ? templateStr
+                    : { modelId: templateStr };
+                const formatted = await mod.formatChat(messages, template);
+                return { content: [{ type: 'text', text: formatted }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+    {
+        name: 'ruvllm_generate_config',
+        description: 'Create a generation config (maxTokens, temperature, topP, etc.) as JSON.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                maxTokens: { type: 'number', description: 'Max tokens to generate' },
+                temperature: { type: 'number', description: 'Sampling temperature (note: f32 precision)' },
+                topP: { type: 'number', description: 'Top-p sampling' },
+                topK: { type: 'number', description: 'Top-k sampling' },
+                repetitionPenalty: { type: 'number', description: 'Repetition penalty' },
+                stopSequences: { type: 'array', description: 'Stop sequences' },
+            },
+        },
+        handler: async (args) => {
+            try {
+                const mod = await loadRuvllmWasm();
+                const config = await mod.createGenerateConfig(args);
+                return { content: [{ type: 'text', text: config }] };
+            }
+            catch (err) {
+                return { content: [{ type: 'text', text: JSON.stringify({ error: String(err) }) }], isError: true };
+            }
+        },
+    },
+];
+// ── Instance Registries ──────────────────────────────────────
+const hnswRouters = new Map();
+const sonaInstances = new Map();
+const loraInstances = new Map();
+//# sourceMappingURL=ruvllm-tools.js.map

package/dist/src/mcp-tools/ruvllm-tools.js.map

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

package/dist/src/mcp-tools/swarm-tools.d.ts

@@ -1,7 +1,8 @@
 /**
  * Swarm MCP Tools for CLI
  *
- * Tool definitions for swarm coordination.
+ * 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[];

package/dist/src/mcp-tools/swarm-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"swarm-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/swarm-tools.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAO,MAAM,UAAU,EAAE,OAAO,EAgG/B,CAAC"}
+{"version":3,"file":"swarm-tools.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/swarm-tools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AA0D1C,eAAO,MAAM,UAAU,EAAE,OAAO,EAuQ/B,CAAC"}

package/dist/src/mcp-tools/swarm-tools.js

@@ -1,82 +1,212 @@
 /**
  * Swarm MCP Tools for CLI
  *
- * Tool definitions for swarm coordination.
+ * 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',
+        description: 'Initialize a swarm with persistent state tracking',
         category: 'swarm',
         inputSchema: {
             type: 'object',
             properties: {
-                topology: { type: 'string', description: 'Swarm topology type' },
-                maxAgents: { type: 'number', description: 'Maximum number of agents' },
-                config: { type: 'object', description: 'Swarm configuration' },
+                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 = input.maxAgents || 15;
+            const maxAgents = Math.min(Math.max(input.maxAgents || 15, 1), 50);
+            const strategy = input.strategy || 'specialized';
             const config = (input.config || {});
-            return {
-                success: true,
-                swarmId: `swarm-${Date.now()}`,
+            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,
-                initializedAt: new Date().toISOString(),
+                maxAgents,
+                status: 'running',
+                agents: [],
+                tasks: [],
                 config: {
                     topology,
                     maxAgents,
-                    currentAgents: 0,
+                    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',
+        description: 'Get swarm status from persistent state',
         category: 'swarm',
         inputSchema: {
             type: 'object',
             properties: {
-                swarmId: { type: 'string', description: 'Swarm ID' },
+                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: input.swarmId,
-                status: 'running',
-                agentCount: 0,
-                taskCount: 0,
+                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',
+        description: 'Shutdown a swarm and update persistent state',
         category: 'swarm',
         inputSchema: {
             type: 'object',
             properties: {
-                swarmId: { type: 'string', description: 'Swarm ID' },
-                graceful: { type: 'boolean', description: 'Graceful shutdown' },
+                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: input.swarmId,
+                swarmId: target.swarmId,
                 terminated: true,
+                graceful: input.graceful ?? true,
+                agentsTerminated: target.agents.length,
+                terminatedAt: target.updatedAt,
             };
         },
     },
     {
         name: 'swarm_health',
-        description: 'Check swarm health status',
+        description: 'Check swarm health status with real state inspection',
         category: 'swarm',
         inputSchema: {
             type: 'object',
@@ -85,15 +215,71 @@ export const swarmTools = [
             },
         },
         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',
-                swarmId: input.swarmId || 'default',
-                checks: [
-                    { name: 'coordinator', status: 'ok', message: 'Coordinator responding' },
-                    { name: 'agents', status: 'ok', message: 'Agent pool healthy' },
-                    { name: 'memory', status: 'ok', message: 'Memory backend connected' },
-                    { name: 'messaging', status: 'ok', message: 'Message bus active' },
-                ],
+                status: healthy ? 'healthy' : 'degraded',
+                healthy,
+                swarmId: target.swarmId,
+                topology: target.topology,
+                agentCount: target.agents.length,
+                checks,
                 checkedAt: new Date().toISOString(),
             };
         },