agenthub-multiagent-mcp 1.9.1 → 1.10.1

package/dist/daemon.d.ts

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * AgentHub Daemon — Persistent bridge for autonomous Claude Code agents
+ *
+ * Maintains a WebSocket connection to AgentHub and spawns Claude Code
+ * sessions to handle incoming messages. This solves the "idle agent"
+ * problem where no hooks fire because there's no user interaction.
+ *
+ * Usage:
+ *   agenthub-daemon --agent-id <id> --project-dir <path>
+ *   agenthub-daemon --agent-id krishi-dev --project-dir /home/user/project
+ *
+ * Environment:
+ *   AGENTHUB_URL       - AgentHub server URL (default: https://agenthub.contetial.com)
+ *   AGENTHUB_API_KEY   - API key for authentication (required)
+ *
+ * The daemon:
+ *   1. Connects to AgentHub via WebSocket
+ *   2. Listens for incoming messages and tasks
+ *   3. Spawns `claude` CLI to process each message
+ *   4. Sends the response back to AgentHub
+ *   5. Reconnects automatically on disconnection
+ */
+export {};
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;;GAqBG"}

package/dist/daemon.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+/**
+ * AgentHub Daemon — Persistent bridge for autonomous Claude Code agents
+ *
+ * Maintains a WebSocket connection to AgentHub and spawns Claude Code
+ * sessions to handle incoming messages. This solves the "idle agent"
+ * problem where no hooks fire because there's no user interaction.
+ *
+ * Usage:
+ *   agenthub-daemon --agent-id <id> --project-dir <path>
+ *   agenthub-daemon --agent-id krishi-dev --project-dir /home/user/project
+ *
+ * Environment:
+ *   AGENTHUB_URL       - AgentHub server URL (default: https://agenthub.contetial.com)
+ *   AGENTHUB_API_KEY   - API key for authentication (required)
+ *
+ * The daemon:
+ *   1. Connects to AgentHub via WebSocket
+ *   2. Listens for incoming messages and tasks
+ *   3. Spawns `claude` CLI to process each message
+ *   4. Sends the response back to AgentHub
+ *   5. Reconnects automatically on disconnection
+ */
+import WebSocket from "ws";
+import { spawn } from "child_process";
+// Parse CLI arguments
+const args = process.argv.slice(2);
+function getArg(name) {
+    const idx = args.indexOf(`--${name}`);
+    return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
+const AGENT_ID = getArg("agent-id") || process.env.AGENTHUB_AGENT_ID || "";
+const PROJECT_DIR = getArg("project-dir") || process.cwd();
+const API_KEY = process.env.AGENTHUB_API_KEY || "";
+const API_URL = process.env.AGENTHUB_URL || "https://agenthub.contetial.com";
+const WS_URL = API_URL.replace(/^https:/, "wss:").replace(/^http:/, "ws:");
+const MAX_CONCURRENT = parseInt(getArg("max-concurrent") || "1", 10);
+const CLAUDE_CMD = getArg("claude-cmd") || "claude";
+if (!AGENT_ID) {
+    console.error("Error: --agent-id or AGENTHUB_AGENT_ID required");
+    process.exit(1);
+}
+if (!API_KEY) {
+    console.error("Error: AGENTHUB_API_KEY environment variable required");
+    process.exit(1);
+}
+// State
+let ws = null;
+let reconnectAttempts = 0;
+let activeProcesses = 0;
+let isShuttingDown = false;
+function log(msg, ...extra) {
+    const ts = new Date().toISOString();
+    console.log(`[${ts}] [agenthub-daemon] ${msg}`, ...extra);
+}
+function logError(msg, ...extra) {
+    const ts = new Date().toISOString();
+    console.error(`[${ts}] [agenthub-daemon] ${msg}`, ...extra);
+}
+/**
+ * Connect to AgentHub WebSocket
+ */
+function connect() {
+    if (isShuttingDown)
+        return;
+    const url = `${WS_URL}/ws/agents/${AGENT_ID}?api_key=${API_KEY}`;
+    log(`Connecting to AgentHub as "${AGENT_ID}"...`);
+    ws = new WebSocket(url);
+    ws.on("open", () => {
+        log("WebSocket connected");
+        reconnectAttempts = 0;
+    });
+    ws.on("message", (data) => {
+        try {
+            const msg = JSON.parse(data.toString());
+            handleWSMessage(msg);
+        }
+        catch (err) {
+            logError("Failed to parse WebSocket message:", err);
+        }
+    });
+    ws.on("close", (code, reason) => {
+        log(`WebSocket closed (code: ${code}, reason: ${reason.toString()})`);
+        ws = null;
+        scheduleReconnect();
+    });
+    ws.on("error", (err) => {
+        logError("WebSocket error:", err.message);
+    });
+}
+/**
+ * Schedule reconnection with exponential backoff
+ */
+function scheduleReconnect() {
+    if (isShuttingDown)
+        return;
+    reconnectAttempts++;
+    const delay = Math.min(1000 * Math.pow(2, reconnectAttempts - 1), 30000);
+    log(`Reconnecting in ${delay}ms (attempt ${reconnectAttempts})...`);
+    setTimeout(() => {
+        if (!isShuttingDown)
+            connect();
+    }, delay);
+}
+/**
+ * Handle incoming WebSocket messages
+ */
+function handleWSMessage(msg) {
+    // Respond to pings
+    if (msg.type === "ping") {
+        ws?.send(JSON.stringify({ type: "pong", timestamp: new Date().toISOString() }));
+        return;
+    }
+    // Handle incoming message
+    if (msg.type === "message" && msg.message) {
+        const m = msg.message;
+        log(`Message from ${m.from_agent}: ${m.subject}`);
+        // Acknowledge receipt
+        ws?.send(JSON.stringify({ type: "ack", message_id: m.id, timestamp: new Date().toISOString() }));
+        // Process with Claude
+        processWithClaude(`You received a message on AgentHub.\n\nFrom: ${m.from_agent}\nSubject: ${m.subject}\nType: ${m.type}\nPriority: ${m.priority}\n\nBody:\n${m.body}\n\nPlease review and respond using the reply tool with message_id="${m.id}".`, m.id);
+        return;
+    }
+    // Handle incoming task
+    if (msg.type === "task" && msg.task) {
+        const t = msg.task;
+        log(`Task from ${t.assigned_by}: ${t.task}`);
+        processWithClaude(`You have been assigned a new task on AgentHub.\n\nTask: ${t.task}\nAssigned by: ${t.assigned_by}\nPriority: ${t.priority}\nTask ID: ${t.id}\n\nPlease accept this task using accept_task with task_id="${t.id}", then start working on it.`, undefined);
+        return;
+    }
+}
+/**
+ * Spawn Claude Code CLI to process a message
+ */
+function processWithClaude(prompt, messageId) {
+    if (activeProcesses >= MAX_CONCURRENT) {
+        log(`Skipping — already processing ${activeProcesses} message(s) (max: ${MAX_CONCURRENT})`);
+        // Still mark as read if possible
+        if (messageId)
+            markRead(messageId);
+        return;
+    }
+    activeProcesses++;
+    log(`Spawning Claude Code (active: ${activeProcesses}/${MAX_CONCURRENT})...`);
+    const child = spawn(CLAUDE_CMD, [
+        "-p",
+        prompt,
+        "--dangerously-skip-permissions",
+    ], {
+        cwd: PROJECT_DIR,
+        env: {
+            ...process.env,
+            AGENTHUB_AGENT_ID: AGENT_ID,
+        },
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 300_000, // 5 minute timeout
+        shell: true, // Required on Windows where claude is a shell script wrapper
+    });
+    let stdout = "";
+    let stderr = "";
+    child.stdout?.on("data", (data) => {
+        stdout += data.toString();
+    });
+    child.stderr?.on("data", (data) => {
+        stderr += data.toString();
+    });
+    child.on("close", (code) => {
+        activeProcesses--;
+        if (code === 0) {
+            log(`Claude completed successfully (output: ${stdout.length} chars)`);
+            // If this was a message, send a reply with Claude's response
+            if (messageId && stdout.trim()) {
+                sendReply(messageId, stdout.trim());
+            }
+        }
+        else {
+            logError(`Claude exited with code ${code}`);
+            if (stderr)
+                logError(`stderr: ${stderr.slice(0, 500)}`);
+        }
+    });
+    child.on("error", (err) => {
+        activeProcesses--;
+        logError(`Failed to spawn Claude:`, err.message);
+    });
+}
+/**
+ * Send a reply back to AgentHub
+ */
+async function sendReply(messageId, body) {
+    try {
+        const response = await fetch(`${API_URL}/api/messages`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": API_KEY,
+            },
+            body: JSON.stringify({
+                from_agent: AGENT_ID,
+                to_agent: "", // Will be resolved from reply_to
+                type: "response",
+                subject: "Re: (auto-response)",
+                body: body.slice(0, 5000), // Limit response length
+                reply_to: messageId,
+            }),
+        });
+        if (response.ok) {
+            log(`Reply sent for message ${messageId}`);
+        }
+        else {
+            logError(`Reply failed: HTTP ${response.status}`);
+        }
+    }
+    catch (err) {
+        logError(`Reply failed:`, err);
+    }
+}
+/**
+ * Mark a message as read
+ */
+async function markRead(messageId) {
+    try {
+        await fetch(`${API_URL}/api/messages/${messageId}/read`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                "X-API-Key": API_KEY,
+            },
+            body: JSON.stringify({ agent_id: AGENT_ID }),
+        });
+    }
+    catch {
+        // Non-fatal
+    }
+}
+/**
+ * Graceful shutdown
+ */
+function shutdown() {
+    log("Shutting down...");
+    isShuttingDown = true;
+    ws?.close();
+    // Wait for active processes to finish
+    if (activeProcesses > 0) {
+        log(`Waiting for ${activeProcesses} active process(es)...`);
+        const check = setInterval(() => {
+            if (activeProcesses === 0) {
+                clearInterval(check);
+                process.exit(0);
+            }
+        }, 1000);
+        // Force exit after 30 seconds
+        setTimeout(() => process.exit(1), 30000);
+    }
+    else {
+        process.exit(0);
+    }
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+// Start
+log(`AgentHub Daemon starting`);
+log(`  Agent: ${AGENT_ID}`);
+log(`  Project: ${PROJECT_DIR}`);
+log(`  Server: ${API_URL}`);
+log(`  Max concurrent: ${MAX_CONCURRENT}`);
+connect();
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

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

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "agenthub-multiagent-mcp",
-  "version": "1.9.1",
+  "version": "1.10.1",
   "description": "MCP server for AgentHub multi-agent communication",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
     "agenthub-multiagent-mcp": "./dist/index.js",
-    "agenthub-hook": "./dist/planHookCli.js"
+    "agenthub-hook": "./dist/planHookCli.js",
+    "agenthub-daemon": "./dist/daemon.js"
   },
   "scripts": {
     "build": "tsc",

package/src/daemon.ts

@@ -0,0 +1,317 @@
+#!/usr/bin/env node
+/**
+ * AgentHub Daemon — Persistent bridge for autonomous Claude Code agents
+ *
+ * Maintains a WebSocket connection to AgentHub and spawns Claude Code
+ * sessions to handle incoming messages. This solves the "idle agent"
+ * problem where no hooks fire because there's no user interaction.
+ *
+ * Usage:
+ *   agenthub-daemon --agent-id <id> --project-dir <path>
+ *   agenthub-daemon --agent-id krishi-dev --project-dir /home/user/project
+ *
+ * Environment:
+ *   AGENTHUB_URL       - AgentHub server URL (default: https://agenthub.contetial.com)
+ *   AGENTHUB_API_KEY   - API key for authentication (required)
+ *
+ * The daemon:
+ *   1. Connects to AgentHub via WebSocket
+ *   2. Listens for incoming messages and tasks
+ *   3. Spawns `claude` CLI to process each message
+ *   4. Sends the response back to AgentHub
+ *   5. Reconnects automatically on disconnection
+ */
+
+import WebSocket from "ws";
+import { spawn } from "child_process";
+
+// Parse CLI arguments
+const args = process.argv.slice(2);
+function getArg(name: string): string | undefined {
+  const idx = args.indexOf(`--${name}`);
+  return idx !== -1 && idx + 1 < args.length ? args[idx + 1] : undefined;
+}
+
+const AGENT_ID = getArg("agent-id") || process.env.AGENTHUB_AGENT_ID || "";
+const PROJECT_DIR = getArg("project-dir") || process.cwd();
+const API_KEY = process.env.AGENTHUB_API_KEY || "";
+const API_URL = process.env.AGENTHUB_URL || "https://agenthub.contetial.com";
+const WS_URL = API_URL.replace(/^https:/, "wss:").replace(/^http:/, "ws:");
+const MAX_CONCURRENT = parseInt(getArg("max-concurrent") || "1", 10);
+const CLAUDE_CMD = getArg("claude-cmd") || "claude";
+
+if (!AGENT_ID) {
+  console.error("Error: --agent-id or AGENTHUB_AGENT_ID required");
+  process.exit(1);
+}
+if (!API_KEY) {
+  console.error("Error: AGENTHUB_API_KEY environment variable required");
+  process.exit(1);
+}
+
+// State
+let ws: WebSocket | null = null;
+let reconnectAttempts = 0;
+let activeProcesses = 0;
+let isShuttingDown = false;
+
+function log(msg: string, ...extra: unknown[]): void {
+  const ts = new Date().toISOString();
+  console.log(`[${ts}] [agenthub-daemon] ${msg}`, ...extra);
+}
+
+function logError(msg: string, ...extra: unknown[]): void {
+  const ts = new Date().toISOString();
+  console.error(`[${ts}] [agenthub-daemon] ${msg}`, ...extra);
+}
+
+/**
+ * Connect to AgentHub WebSocket
+ */
+function connect(): void {
+  if (isShuttingDown) return;
+
+  const url = `${WS_URL}/ws/agents/${AGENT_ID}?api_key=${API_KEY}`;
+  log(`Connecting to AgentHub as "${AGENT_ID}"...`);
+
+  ws = new WebSocket(url);
+
+  ws.on("open", () => {
+    log("WebSocket connected");
+    reconnectAttempts = 0;
+  });
+
+  ws.on("message", (data: WebSocket.Data) => {
+    try {
+      const msg = JSON.parse(data.toString());
+      handleWSMessage(msg);
+    } catch (err) {
+      logError("Failed to parse WebSocket message:", err);
+    }
+  });
+
+  ws.on("close", (code: number, reason: Buffer) => {
+    log(`WebSocket closed (code: ${code}, reason: ${reason.toString()})`);
+    ws = null;
+    scheduleReconnect();
+  });
+
+  ws.on("error", (err: Error) => {
+    logError("WebSocket error:", err.message);
+  });
+}
+
+/**
+ * Schedule reconnection with exponential backoff
+ */
+function scheduleReconnect(): void {
+  if (isShuttingDown) return;
+
+  reconnectAttempts++;
+  const delay = Math.min(1000 * Math.pow(2, reconnectAttempts - 1), 30000);
+  log(`Reconnecting in ${delay}ms (attempt ${reconnectAttempts})...`);
+
+  setTimeout(() => {
+    if (!isShuttingDown) connect();
+  }, delay);
+}
+
+/**
+ * Handle incoming WebSocket messages
+ */
+function handleWSMessage(msg: {
+  type: string;
+  message?: {
+    id: string;
+    from_agent: string;
+    subject: string;
+    body: string;
+    type: string;
+    priority: string;
+  };
+  task?: {
+    id: string;
+    task: string;
+    assigned_by: string;
+    priority: string;
+  };
+}): void {
+  // Respond to pings
+  if (msg.type === "ping") {
+    ws?.send(JSON.stringify({ type: "pong", timestamp: new Date().toISOString() }));
+    return;
+  }
+
+  // Handle incoming message
+  if (msg.type === "message" && msg.message) {
+    const m = msg.message;
+    log(`Message from ${m.from_agent}: ${m.subject}`);
+
+    // Acknowledge receipt
+    ws?.send(JSON.stringify({ type: "ack", message_id: m.id, timestamp: new Date().toISOString() }));
+
+    // Process with Claude
+    processWithClaude(
+      `You received a message on AgentHub.\n\nFrom: ${m.from_agent}\nSubject: ${m.subject}\nType: ${m.type}\nPriority: ${m.priority}\n\nBody:\n${m.body}\n\nPlease review and respond using the reply tool with message_id="${m.id}".`,
+      m.id
+    );
+    return;
+  }
+
+  // Handle incoming task
+  if (msg.type === "task" && msg.task) {
+    const t = msg.task;
+    log(`Task from ${t.assigned_by}: ${t.task}`);
+
+    processWithClaude(
+      `You have been assigned a new task on AgentHub.\n\nTask: ${t.task}\nAssigned by: ${t.assigned_by}\nPriority: ${t.priority}\nTask ID: ${t.id}\n\nPlease accept this task using accept_task with task_id="${t.id}", then start working on it.`,
+      undefined
+    );
+    return;
+  }
+}
+
+/**
+ * Spawn Claude Code CLI to process a message
+ */
+function processWithClaude(prompt: string, messageId: string | undefined): void {
+  if (activeProcesses >= MAX_CONCURRENT) {
+    log(`Skipping — already processing ${activeProcesses} message(s) (max: ${MAX_CONCURRENT})`);
+    // Still mark as read if possible
+    if (messageId) markRead(messageId);
+    return;
+  }
+
+  activeProcesses++;
+  log(`Spawning Claude Code (active: ${activeProcesses}/${MAX_CONCURRENT})...`);
+
+  const child = spawn(CLAUDE_CMD, [
+    "-p",
+    prompt,
+    "--dangerously-skip-permissions",
+  ], {
+    cwd: PROJECT_DIR,
+    env: {
+      ...process.env,
+      AGENTHUB_AGENT_ID: AGENT_ID,
+    },
+    stdio: ["pipe", "pipe", "pipe"],
+    timeout: 300_000, // 5 minute timeout
+    shell: true, // Required on Windows where claude is a shell script wrapper
+  });
+
+  let stdout = "";
+  let stderr = "";
+
+  child.stdout?.on("data", (data: Buffer) => {
+    stdout += data.toString();
+  });
+
+  child.stderr?.on("data", (data: Buffer) => {
+    stderr += data.toString();
+  });
+
+  child.on("close", (code: number | null) => {
+    activeProcesses--;
+
+    if (code === 0) {
+      log(`Claude completed successfully (output: ${stdout.length} chars)`);
+
+      // If this was a message, send a reply with Claude's response
+      if (messageId && stdout.trim()) {
+        sendReply(messageId, stdout.trim());
+      }
+    } else {
+      logError(`Claude exited with code ${code}`);
+      if (stderr) logError(`stderr: ${stderr.slice(0, 500)}`);
+    }
+  });
+
+  child.on("error", (err: Error) => {
+    activeProcesses--;
+    logError(`Failed to spawn Claude:`, err.message);
+  });
+}
+
+/**
+ * Send a reply back to AgentHub
+ */
+async function sendReply(messageId: string, body: string): Promise<void> {
+  try {
+    const response = await fetch(`${API_URL}/api/messages`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": API_KEY,
+      },
+      body: JSON.stringify({
+        from_agent: AGENT_ID,
+        to_agent: "", // Will be resolved from reply_to
+        type: "response",
+        subject: "Re: (auto-response)",
+        body: body.slice(0, 5000), // Limit response length
+        reply_to: messageId,
+      }),
+    });
+
+    if (response.ok) {
+      log(`Reply sent for message ${messageId}`);
+    } else {
+      logError(`Reply failed: HTTP ${response.status}`);
+    }
+  } catch (err) {
+    logError(`Reply failed:`, err);
+  }
+}
+
+/**
+ * Mark a message as read
+ */
+async function markRead(messageId: string): Promise<void> {
+  try {
+    await fetch(`${API_URL}/api/messages/${messageId}/read`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "X-API-Key": API_KEY,
+      },
+      body: JSON.stringify({ agent_id: AGENT_ID }),
+    });
+  } catch {
+    // Non-fatal
+  }
+}
+
+/**
+ * Graceful shutdown
+ */
+function shutdown(): void {
+  log("Shutting down...");
+  isShuttingDown = true;
+  ws?.close();
+  // Wait for active processes to finish
+  if (activeProcesses > 0) {
+    log(`Waiting for ${activeProcesses} active process(es)...`);
+    const check = setInterval(() => {
+      if (activeProcesses === 0) {
+        clearInterval(check);
+        process.exit(0);
+      }
+    }, 1000);
+    // Force exit after 30 seconds
+    setTimeout(() => process.exit(1), 30000);
+  } else {
+    process.exit(0);
+  }
+}
+
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);
+
+// Start
+log(`AgentHub Daemon starting`);
+log(`  Agent: ${AGENT_ID}`);
+log(`  Project: ${PROJECT_DIR}`);
+log(`  Server: ${API_URL}`);
+log(`  Max concurrent: ${MAX_CONCURRENT}`);
+connect();