mcp-coordinator 0.2.1 → 0.3.0

package/dist/src/tools/dependencies-tools.js

@@ -0,0 +1,27 @@
+import { z } from "zod";
+/**
+ * S1: dependency map MCP tools (3 tools).
+ * set_dependency_map, get_blast_radius, get_module_info.
+ */
+export function registerDependenciesTools(server, services, _mcpLog) {
+    const { depMap } = services;
+    server.tool("set_dependency_map", "Load module dependency graph", {
+        modules: z.string(), // JSON DependencyMap
+    }, async ({ modules }) => {
+        const map = JSON.parse(modules);
+        depMap.setMap(map);
+        return { content: [{ type: "text", text: "ok" }] };
+    });
+    server.tool("get_blast_radius", "Calculate impact of changes to a module", {
+        module_id: z.string(),
+    }, async ({ module_id }) => {
+        const radius = depMap.getBlastRadius(module_id);
+        return { content: [{ type: "text", text: JSON.stringify(radius) }] };
+    });
+    server.tool("get_module_info", "Get module dependency info", {
+        module_id: z.string(),
+    }, async ({ module_id }) => {
+        const info = depMap.getModuleInfo(module_id);
+        return { content: [{ type: "text", text: JSON.stringify(info) }] };
+    });
+}

package/dist/src/tools/files-tools.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CoordinatorServices } from "../server-setup.js";
+import type { Logger } from "../logger.js";
+/**
+ * S1: file tracking MCP tools (3 tools).
+ * hot_files, get_session_files, check_file_conflict.
+ */
+export declare function registerFilesTools(server: McpServer, services: CoordinatorServices, _mcpLog: Logger): void;

package/dist/src/tools/files-tools.js

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/**
+ * S1: file tracking MCP tools (3 tools).
+ * hot_files, get_session_files, check_file_conflict.
+ */
+export function registerFilesTools(server, services, _mcpLog) {
+    const { fileTracker } = services;
+    server.tool("hot_files", "List files modified by multiple agents", {
+        since_minutes: z.number().optional(),
+    }, async ({ since_minutes }) => {
+        const files = fileTracker.getHotFiles(since_minutes || 30);
+        return { content: [{ type: "text", text: JSON.stringify(files) }] };
+    });
+    server.tool("get_session_files", "Get files modified in a session", {
+        session_id: z.string(),
+    }, async ({ session_id }) => {
+        const files = fileTracker.getBySession(session_id);
+        return { content: [{ type: "text", text: JSON.stringify(files) }] };
+    });
+    server.tool("check_file_conflict", "Check if another agent is editing a file", {
+        file_path: z.string(),
+        agent_id: z.string(),
+        within_minutes: z.number().optional(),
+    }, async ({ file_path, agent_id, within_minutes }) => {
+        const result = fileTracker.checkFileConflict(file_path, agent_id, within_minutes || 30);
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    });
+}

package/dist/src/tools/mqtt-tools.d.ts

@@ -0,0 +1,9 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CoordinatorServices } from "../server-setup.js";
+import type { Logger } from "../logger.js";
+/**
+ * S1: MQTT listener MCP tools (3 tools).
+ * wait_for_message, get_queued_messages, mqtt_publish.
+ * Replaces what used to be a standalone mqtt-mcp-bridge sidecar.
+ */
+export declare function registerMqttTools(server: McpServer, services: CoordinatorServices, _mcpLog: Logger): void;

package/dist/src/tools/mqtt-tools.js

@@ -0,0 +1,33 @@
+import { z } from "zod";
+/**
+ * S1: MQTT listener MCP tools (3 tools).
+ * wait_for_message, get_queued_messages, mqtt_publish.
+ * Replaces what used to be a standalone mqtt-mcp-bridge sidecar.
+ */
+export function registerMqttTools(server, services, _mcpLog) {
+    const { mqttBridge } = services;
+    server.tool("wait_for_message", "Block until an MQTT consultation message arrives or timeout", {
+        agent_id: z.string(),
+        timeout_seconds: z.number().optional(),
+    }, async ({ agent_id, timeout_seconds }) => {
+        const timeoutMs = (timeout_seconds || 15) * 1000;
+        const msg = await mqttBridge.waitForMessage(agent_id, timeoutMs);
+        if (msg) {
+            return { content: [{ type: "text", text: JSON.stringify(msg) }] };
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ timeout: true }) }] };
+    });
+    server.tool("get_queued_messages", "Get all queued MQTT messages without blocking", {
+        agent_id: z.string(),
+    }, async ({ agent_id }) => {
+        const messages = mqttBridge.getQueuedMessages(agent_id);
+        return { content: [{ type: "text", text: JSON.stringify(messages) }] };
+    });
+    server.tool("mqtt_publish", "Publish a message to an MQTT topic", {
+        topic: z.string(),
+        payload: z.string(),
+    }, async ({ topic, payload }) => {
+        mqttBridge.mqttPublish(topic, payload);
+        return { content: [{ type: "text", text: "published" }] };
+    });
+}

package/dist/src/tools/status-tools.d.ts

@@ -0,0 +1,8 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { CoordinatorServices } from "../server-setup.js";
+import type { Logger } from "../logger.js";
+/**
+ * S1: status + coordination helper MCP tools (2 tools).
+ * coordinator_status, wait_for_peers.
+ */
+export declare function registerStatusTools(server: McpServer, services: CoordinatorServices, mcpLog: Logger): void;

package/dist/src/tools/status-tools.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+/**
+ * S1: status + coordination helper MCP tools (2 tools).
+ * coordinator_status, wait_for_peers.
+ */
+export function registerStatusTools(server, services, mcpLog) {
+    const { registry, consultation, fileTracker, mqttBridge } = services;
+    server.tool("coordinator_status", "Full system status", {}, async () => {
+        const online = registry.listOnline();
+        const openThreads = consultation.listThreads({ status: "open" });
+        const resolvingThreads = consultation.listThreads({ status: "resolving" });
+        const hotFiles = fileTracker.getHotFiles(30);
+        const status = {
+            agents_online: online.length,
+            agents: online.map((a) => ({ id: a.id, name: a.name, modules: JSON.parse(a.modules) })),
+            open_threads: openThreads.length,
+            resolving_threads: resolvingThreads.length,
+            hot_files: hotFiles.length,
+            mqtt_connected: mqttBridge.isConnected(),
+        };
+        mcpLog.debug({ tool: "coordinator_status", agents_online: online.length, open_threads: openThreads.length }, "Tool called");
+        return { content: [{ type: "text", text: JSON.stringify(status) }] };
+    });
+    server.tool("wait_for_peers", "Block until at least N other online agents are registered, or timeout. Use before the first announce_work to avoid the race where one agent announces before peers have booted.", {
+        agent_id: z.string(),
+        min_peers: z.number().optional(),
+        timeout_seconds: z.number().optional(),
+    }, async ({ agent_id, min_peers, timeout_seconds }) => {
+        const targetPeers = min_peers ?? 1;
+        const timeoutMs = (timeout_seconds ?? 30) * 1000;
+        const pollIntervalMs = 1000;
+        const startedAt = Date.now();
+        mcpLog.info({ tool: "wait_for_peers", agent_id, min_peers: targetPeers, timeout_seconds: timeoutMs / 1000 }, "Tool called");
+        while (Date.now() - startedAt < timeoutMs) {
+            const peers = registry.listOnline().filter((a) => a.id !== agent_id);
+            if (peers.length >= targetPeers) {
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                ready: true,
+                                online_peers: peers.map((p) => ({ id: p.id, name: p.name })),
+                                waited_ms: Date.now() - startedAt,
+                            }),
+                        }],
+                };
+            }
+            await new Promise((r) => setTimeout(r, pollIntervalMs));
+        }
+        const finalPeers = registry.listOnline().filter((a) => a.id !== agent_id);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        ready: false,
+                        timeout: true,
+                        online_peers: finalPeers.map((p) => ({ id: p.id, name: p.name })),
+                        waited_ms: Date.now() - startedAt,
+                    }),
+                }],
+        };
+    });
+}

package/package.json

@@ -1,80 +1,81 @@
-{
-  "name": "mcp-coordinator",
-  "version": "0.2.1",
-  "description": "Embedded MQTT broker + MCP server for multi-agent coordination",
-  "type": "module",
-  "license": "MIT",
-  "author": "Maxime Gagnon",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/swoofer/mcp-coordinator.git"
-  },
-  "homepage": "https://swoofer.github.io/mcp-coordinator",
-  "bugs": {
-    "url": "https://github.com/swoofer/mcp-coordinator/issues"
-  },
-  "keywords": [
-    "mcp",
-    "mqtt",
-    "broker",
-    "multi-agent",
-    "coordination",
-    "claude",
-    "anthropic"
-  ],
-  "main": "./dist/src/index.js",
-  "types": "./dist/src/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/src/index.d.ts",
-      "default": "./dist/src/index.js"
-    },
-    "./types": {
-      "types": "./dist/src/types.d.ts",
-      "default": "./dist/src/types.js"
-    }
-  },
-  "bin": {
-    "mcp-coordinator": "./dist/cli/index.js"
-  },
-  "files": [
-    "dist/src/",
-    "dist/cli/",
-    "dashboard/",
-    "LICENSE",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "cli": "tsx cli/index.ts",
-    "start": "node dist/src/serve-http.js",
-    "dev": "tsx src/serve-http.ts",
-    "dev:stdio": "tsx src/index.ts",
-    "prepublishOnly": "npm run build && npm test"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.12.0",
-    "aedes": "^1.0.2",
-    "better-sqlite3": "^12.8.0",
-    "commander": "^14.0.3",
-    "jose": "^6.2.2",
-    "mqtt": "^5.15.0",
-    "pino": "^10.3.1",
-    "ws": "^8.20.0",
-    "zod": "^3.23.0"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/node": "^22.0.0",
-    "@types/ws": "^8.18.1",
-    "pino-pretty": "^13.1.3",
-    "tsx": "^4.19.0",
-    "typescript": "^5.7.0",
-    "vitest": "^4.1.0"
-  },
-  "engines": {
-    "node": ">=20"
-  }
-}
+{
+  "name": "mcp-coordinator",
+  "version": "0.3.0",
+  "mcpName": "io.github.swoofer/mcp-coordinator",
+  "description": "Embedded MQTT broker + MCP server for multi-agent coordination",
+  "type": "module",
+  "license": "MIT",
+  "author": "Maxime Gagnon",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/swoofer/mcp-coordinator.git"
+  },
+  "homepage": "https://swoofer.github.io/mcp-coordinator",
+  "bugs": {
+    "url": "https://github.com/swoofer/mcp-coordinator/issues"
+  },
+  "keywords": [
+    "mcp",
+    "mqtt",
+    "broker",
+    "multi-agent",
+    "coordination",
+    "claude",
+    "anthropic"
+  ],
+  "main": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./types": {
+      "types": "./dist/src/types.d.ts",
+      "default": "./dist/src/types.js"
+    }
+  },
+  "bin": {
+    "mcp-coordinator": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist/src/",
+    "dist/cli/",
+    "dashboard/",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "cli": "tsx cli/index.ts",
+    "start": "node dist/src/serve-http.js",
+    "dev": "tsx src/serve-http.ts",
+    "dev:stdio": "tsx src/index.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "aedes": "^1.0.2",
+    "better-sqlite3": "^12.8.0",
+    "commander": "^14.0.3",
+    "jose": "^6.2.2",
+    "mqtt": "^5.15.0",
+    "pino": "^10.3.1",
+    "ws": "^8.20.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.18.1",
+    "pino-pretty": "^13.1.3",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vitest": "^4.1.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}