npm - agenthub-multiagent-mcp - Versions diffs - 1.10.5 → 1.10.6 - Mend

agenthub-multiagent-mcp 1.10.5 → 1.10.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/dist/channel.d.ts ADDED Viewed

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+/**
+ * AgentHub Channel Plugin — real-time message injection into Claude Code sessions
+ *
+ * This is an MCP server with the claude/channel capability. When a message
+ * arrives for the agent via WebSocket, it emits a channel notification that
+ * appears immediately in the active Claude Code session.
+ *
+ * Usage:
+ *   claude --channels server:agenthub-channel
+ *
+ * Or via --dangerously-load-development-channels during development.
+ *
+ * Environment:
+ *   AGENTHUB_URL       - Server URL (default: https://agenthub.contetial.com)
+ *   AGENTHUB_API_KEY   - API key for authentication
+ *   AGENTHUB_AGENT_ID  - Agent ID for this session
+ */
+export {};
+//# sourceMappingURL=channel.d.ts.map

package/dist/channel.d.ts.map ADDED Viewed

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

package/dist/channel.js ADDED Viewed

@@ -0,0 +1,231 @@
+#!/usr/bin/env node
+/**
+ * AgentHub Channel Plugin — real-time message injection into Claude Code sessions
+ *
+ * This is an MCP server with the claude/channel capability. When a message
+ * arrives for the agent via WebSocket, it emits a channel notification that
+ * appears immediately in the active Claude Code session.
+ *
+ * Usage:
+ *   claude --channels server:agenthub-channel
+ *
+ * Or via --dangerously-load-development-channels during development.
+ *
+ * Environment:
+ *   AGENTHUB_URL       - Server URL (default: https://agenthub.contetial.com)
+ *   AGENTHUB_API_KEY   - API key for authentication
+ *   AGENTHUB_AGENT_ID  - Agent ID for this session
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import WebSocket from "ws";
+// =============================================================================
+// Config
+// =============================================================================
+const API_URL = process.env.AGENTHUB_URL || "https://agenthub.contetial.com";
+const API_KEY = process.env.AGENTHUB_API_KEY || "";
+const AGENT_ID = process.env.AGENTHUB_AGENT_ID || "";
+const WS_URL = API_URL.replace(/^https:/, "wss:").replace(/^http:/, "ws:");
+// =============================================================================
+// MCP Server with channel capability
+// =============================================================================
+const server = new Server({ name: "agenthub-channel", version: "1.0.0" }, {
+    capabilities: {
+        experimental: { "claude/channel": {} },
+        tools: {},
+    },
+    instructions: `You are connected to AgentHub as agent "${AGENT_ID}".
+Messages from other agents will appear as channel events.
+When you receive a message, respond using the agenthub_reply tool with the message_id and your response.
+Be helpful and respond concisely to incoming messages.`,
+});
+// =============================================================================
+// Tools: reply + mark_read
+// =============================================================================
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+    tools: [
+        {
+            name: "agenthub_reply",
+            description: "Reply to an AgentHub message that arrived via channel notification",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    message_id: {
+                        type: "string",
+                        description: "The message ID to reply to (from the channel event)",
+                    },
+                    body: {
+                        type: "string",
+                        description: "Your reply text",
+                    },
+                },
+                required: ["message_id", "body"],
+            },
+        },
+        {
+            name: "agenthub_mark_read",
+            description: "Mark an AgentHub message as read without replying",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    message_id: {
+                        type: "string",
+                        description: "The message ID to mark as read",
+                    },
+                },
+                required: ["message_id"],
+            },
+        },
+    ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    if (name === "agenthub_reply") {
+        const messageId = args?.message_id;
+        const body = args?.body;
+        if (!messageId || !body) {
+            return { content: [{ type: "text", text: "Error: message_id and body are required" }] };
+        }
+        try {
+            const resp = 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 filled from reply_to context
+                    type: "response",
+                    subject: "Re: (via channel)",
+                    body: body.slice(0, 5000),
+                    reply_to: messageId,
+                }),
+            });
+            if (resp.ok) {
+                // Also mark as read
+                await fetch(`${API_URL}/api/messages/${messageId}/status`, {
+                    method: "PATCH",
+                    headers: { "Content-Type": "application/json", "X-API-Key": API_KEY },
+                    body: JSON.stringify({ status: "read" }),
+                });
+                return { content: [{ type: "text", text: `Reply sent successfully.` }] };
+            }
+            else {
+                return { content: [{ type: "text", text: `Reply failed: HTTP ${resp.status}` }] };
+            }
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Reply failed: ${err}` }] };
+        }
+    }
+    if (name === "agenthub_mark_read") {
+        const messageId = args?.message_id;
+        try {
+            await fetch(`${API_URL}/api/messages/${messageId}/status`, {
+                method: "PATCH",
+                headers: { "Content-Type": "application/json", "X-API-Key": API_KEY },
+                body: JSON.stringify({ status: "read" }),
+            });
+            return { content: [{ type: "text", text: "Marked as read." }] };
+        }
+        catch (err) {
+            return { content: [{ type: "text", text: `Failed: ${err}` }] };
+        }
+    }
+    return { content: [{ type: "text", text: `Unknown tool: ${name}` }] };
+});
+// =============================================================================
+// WebSocket: connect to AgentHub and emit channel notifications
+// =============================================================================
+let ws = null;
+let reconnectAttempts = 0;
+function connectWebSocket() {
+    if (!AGENT_ID || !API_KEY)
+        return;
+    const url = `${WS_URL}/ws/agents/${AGENT_ID}?api_key=${API_KEY}`;
+    ws = new WebSocket(url);
+    ws.on("open", () => {
+        reconnectAttempts = 0;
+    });
+    ws.on("message", async (data) => {
+        try {
+            const msg = JSON.parse(data.toString());
+            if (msg.type === "ping") {
+                ws?.send(JSON.stringify({ type: "pong", timestamp: new Date().toISOString() }));
+                return;
+            }
+            if (msg.type === "message" && msg.message) {
+                const m = msg.message;
+                // Ignore messages from self
+                if (m.from_agent === AGENT_ID) {
+                    ws?.send(JSON.stringify({ type: "ack", message_id: m.id, timestamp: new Date().toISOString() }));
+                    return;
+                }
+                // ACK the message
+                ws?.send(JSON.stringify({ type: "ack", message_id: m.id, timestamp: new Date().toISOString() }));
+                // Emit channel notification — this injects into the active session
+                const priority = m.priority === "urgent" ? " [URGENT]" : m.priority === "high" ? " [HIGH]" : "";
+                const content = `📨 Message from ${m.from_agent}${priority}\nSubject: ${m.subject}\n\n${m.body}\n\nMessage ID: ${m.id}\nUse agenthub_reply with this message_id to respond.`;
+                await server.notification({
+                    method: "notifications/claude/channel",
+                    params: {
+                        content,
+                        meta: {
+                            source: "agenthub",
+                            from: m.from_agent,
+                            subject: m.subject,
+                            message_id: m.id,
+                            type: m.type,
+                            priority: m.priority,
+                        },
+                    },
+                });
+            }
+            if (msg.type === "task" && msg.task) {
+                const t = msg.task;
+                await server.notification({
+                    method: "notifications/claude/channel",
+                    params: {
+                        content: `📋 New task assigned by ${t.assigned_by}\n\n${t.task}\n\nTask ID: ${t.id}\nPriority: ${t.priority}`,
+                        meta: {
+                            source: "agenthub",
+                            from: t.assigned_by,
+                            task_id: t.id,
+                            type: "task",
+                            priority: t.priority,
+                        },
+                    },
+                });
+            }
+        }
+        catch {
+            // Parse errors — ignore
+        }
+    });
+    ws.on("close", () => {
+        ws = null;
+        scheduleReconnect();
+    });
+    ws.on("error", () => {
+        // Error will trigger close
+    });
+}
+function scheduleReconnect() {
+    reconnectAttempts++;
+    if (reconnectAttempts > 10)
+        return; // Give up after 10 attempts
+    const delay = Math.min(1000 * Math.pow(2, reconnectAttempts - 1), 30000);
+    setTimeout(connectWebSocket, delay);
+}
+// =============================================================================
+// Start
+// =============================================================================
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Connect WebSocket after MCP is ready
+    if (AGENT_ID && API_KEY) {
+        connectWebSocket();
+    }
+}
+main().catch(() => process.exit(1));
+//# sourceMappingURL=channel.js.map

package/dist/channel.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"channel.js","sourceRoot":"","sources":["../src/channel.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,SAAS,MAAM,IAAI,CAAC;AAE3B,gFAAgF;AAChF,SAAS;AACT,gFAAgF;AAEhF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,gCAAgC,CAAC;AAC7E,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;AACnD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,EAAE,CAAC;AACrD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;AAE3E,gFAAgF;AAChF,qCAAqC;AACrC,gFAAgF;AAEhF,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C;IACE,YAAY,EAAE;QACZ,YAAY,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE;QACtC,KAAK,EAAE,EAAE;KACV;IACD,YAAY,EAAE,2CAA2C,QAAQ;;;uDAGd;CACpD,CACF,CAAC;AAEF,gFAAgF;AAChF,2BAA2B;AAC3B,gFAAgF;AAEhF,MAAM,CAAC,iBAAiB,CAAC,sBAAsB,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC;IAC5D,KAAK,EAAE;QACL;YACE,IAAI,EAAE,gBAAgB;YACtB,WAAW,EAAE,oEAAoE;YACjF,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qDAAqD;qBACnE;oBACD,IAAI,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iBAAiB;qBAC/B;iBACF;gBACD,QAAQ,EAAE,CAAC,YAAY,EAAE,MAAM,CAAC;aACjC;SACF;QACD;YACE,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,mDAAmD;YAChE,WAAW,EAAE;gBACX,IAAI,EAAE,QAAiB;gBACvB,UAAU,EAAE;oBACV,UAAU,EAAE;wBACV,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,gCAAgC;qBAC9C;iBACF;gBACD,QAAQ,EAAE,CAAC,YAAY,CAAC;aACzB;SACF;KACF;CACF,CAAC,CAAC,CAAC;AAEJ,MAAM,CAAC,iBAAiB,CAAC,qBAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,IAAI,KAAK,gBAAgB,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,IAAI,EAAE,UAAoB,CAAC;QAC7C,MAAM,IAAI,GAAG,IAAI,EAAE,IAAc,CAAC;QAElC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,EAAE,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,yCAAyC,EAAE,CAAC,EAAE,CAAC;QACnG,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,eAAe,EAAE;gBAClD,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE;gBACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,UAAU,EAAE,QAAQ;oBACpB,QAAQ,EAAE,EAAE,EAAE,uCAAuC;oBACrD,IAAI,EAAE,UAAU;oBAChB,OAAO,EAAE,mBAAmB;oBAC5B,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;oBACzB,QAAQ,EAAE,SAAS;iBACpB,CAAC;aACH,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,oBAAoB;gBACpB,MAAM,KAAK,CAAC,GAAG,OAAO,iBAAiB,SAAS,SAAS,EAAE;oBACzD,MAAM,EAAE,OAAO;oBACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE;oBACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;iBACzC,CAAC,CAAC;gBACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC,EAAE,CAAC;YACpF,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YAC7F,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QAChF,CAAC;IACH,CAAC;IAED,IAAI,IAAI,KAAK,oBAAoB,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,IAAI,EAAE,UAAoB,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,GAAG,OAAO,iBAAiB,SAAS,SAAS,EAAE;gBACzD,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,OAAO,EAAE;gBACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;aACzC,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC,EAAE,CAAC;QAC3E,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,WAAW,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;AACjF,CAAC,CAAC,CAAC;AAEH,gFAAgF;AAChF,gEAAgE;AAChE,gFAAgF;AAEhF,IAAI,EAAE,GAAqB,IAAI,CAAC;AAChC,IAAI,iBAAiB,GAAG,CAAC,CAAC;AAE1B,SAAS,gBAAgB;IACvB,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;QAAE,OAAO;IAElC,MAAM,GAAG,GAAG,GAAG,MAAM,cAAc,QAAQ,YAAY,OAAO,EAAE,CAAC;IACjE,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;IAExB,EAAE,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACjB,iBAAiB,GAAG,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,IAAoB,EAAE,EAAE;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAExC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACxB,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;gBAChF,OAAO;YACT,CAAC;YAED,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;gBAC1C,MAAM,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC;gBAEtB,4BAA4B;gBAC5B,IAAI,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;oBAC9B,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;oBACjG,OAAO;gBACT,CAAC;gBAED,kBAAkB;gBAClB,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;gBAEjG,mEAAmE;gBACnE,MAAM,QAAQ,GAAG,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;gBAChG,MAAM,OAAO,GAAG,mBAAmB,CAAC,CAAC,UAAU,GAAG,QAAQ,cAAc,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,IAAI,mBAAmB,CAAC,CAAC,EAAE,uDAAuD,CAAC;gBAE7K,MAAM,MAAM,CAAC,YAAY,CAAC;oBACxB,MAAM,EAAE,8BAA8B;oBACtC,MAAM,EAAE;wBACN,OAAO;wBACP,IAAI,EAAE;4BACJ,MAAM,EAAE,UAAU;4BAClB,IAAI,EAAE,CAAC,CAAC,UAAU;4BAClB,OAAO,EAAE,CAAC,CAAC,OAAO;4BAClB,UAAU,EAAE,CAAC,CAAC,EAAE;4BAChB,IAAI,EAAE,CAAC,CAAC,IAAI;4BACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;yBACrB;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;YAED,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;gBACpC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;gBAEnB,MAAM,MAAM,CAAC,YAAY,CAAC;oBACxB,MAAM,EAAE,8BAA8B;oBACtC,MAAM,EAAE;wBACN,OAAO,EAAE,2BAA2B,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,IAAI,gBAAgB,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;wBAC7G,IAAI,EAAE;4BACJ,MAAM,EAAE,UAAU;4BAClB,IAAI,EAAE,CAAC,CAAC,WAAW;4BACnB,OAAO,EAAE,CAAC,CAAC,EAAE;4BACb,IAAI,EAAE,MAAM;4BACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;yBACrB;qBACF;iBACF,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,EAAE,GAAG,IAAI,CAAC;QACV,iBAAiB,EAAE,CAAC;IACtB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QAClB,2BAA2B;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB;IACxB,iBAAiB,EAAE,CAAC;IACpB,IAAI,iBAAiB,GAAG,EAAE;QAAE,OAAO,CAAC,4BAA4B;IAChE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,iBAAiB,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACzE,UAAU,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AACtC,CAAC;AAED,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,uCAAuC;IACvC,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACxB,gBAAgB,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "agenthub-multiagent-mcp",
-  "version": "1.10.5",
+  "version": "1.10.6",
   "description": "MCP server for AgentHub multi-agent communication",
   "type": "module",
   "main": "dist/index.js",
@@ -9,7 +9,8 @@
     "agenthub-hook": "./dist/planHookCli.js",
     "agenthub-daemon": "./dist/daemon.js",
     "agenthub-worker": "./dist/worker.js",
-    "agenthub-setup": "./dist/setup.js"
+    "agenthub-setup": "./dist/setup.js",
+    "agenthub-channel": "./dist/channel.js"
   },
   "scripts": {
     "build": "tsc",

package/src/channel.ts ADDED Viewed

@@ -0,0 +1,265 @@
+#!/usr/bin/env node
+/**
+ * AgentHub Channel Plugin — real-time message injection into Claude Code sessions
+ *
+ * This is an MCP server with the claude/channel capability. When a message
+ * arrives for the agent via WebSocket, it emits a channel notification that
+ * appears immediately in the active Claude Code session.
+ *
+ * Usage:
+ *   claude --channels server:agenthub-channel
+ *
+ * Or via --dangerously-load-development-channels during development.
+ *
+ * Environment:
+ *   AGENTHUB_URL       - Server URL (default: https://agenthub.contetial.com)
+ *   AGENTHUB_API_KEY   - API key for authentication
+ *   AGENTHUB_AGENT_ID  - Agent ID for this session
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import WebSocket from "ws";
+// =============================================================================
+// Config
+// =============================================================================
+const API_URL = process.env.AGENTHUB_URL || "https://agenthub.contetial.com";
+const API_KEY = process.env.AGENTHUB_API_KEY || "";
+const AGENT_ID = process.env.AGENTHUB_AGENT_ID || "";
+const WS_URL = API_URL.replace(/^https:/, "wss:").replace(/^http:/, "ws:");
+// =============================================================================
+// MCP Server with channel capability
+// =============================================================================
+const server = new Server(
+  { name: "agenthub-channel", version: "1.0.0" },
+  {
+    capabilities: {
+      experimental: { "claude/channel": {} },
+      tools: {},
+    },
+    instructions: `You are connected to AgentHub as agent "${AGENT_ID}".
+Messages from other agents will appear as channel events.
+When you receive a message, respond using the agenthub_reply tool with the message_id and your response.
+Be helpful and respond concisely to incoming messages.`,
+  }
+);
+// =============================================================================
+// Tools: reply + mark_read
+// =============================================================================
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "agenthub_reply",
+      description: "Reply to an AgentHub message that arrived via channel notification",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          message_id: {
+            type: "string",
+            description: "The message ID to reply to (from the channel event)",
+          },
+          body: {
+            type: "string",
+            description: "Your reply text",
+          },
+        },
+        required: ["message_id", "body"],
+      },
+    },
+    {
+      name: "agenthub_mark_read",
+      description: "Mark an AgentHub message as read without replying",
+      inputSchema: {
+        type: "object" as const,
+        properties: {
+          message_id: {
+            type: "string",
+            description: "The message ID to mark as read",
+          },
+        },
+        required: ["message_id"],
+      },
+    },
+  ],
+}));
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+  if (name === "agenthub_reply") {
+    const messageId = args?.message_id as string;
+    const body = args?.body as string;
+    if (!messageId || !body) {
+      return { content: [{ type: "text" as const, text: "Error: message_id and body are required" }] };
+    }
+    try {
+      const resp = 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 filled from reply_to context
+          type: "response",
+          subject: "Re: (via channel)",
+          body: body.slice(0, 5000),
+          reply_to: messageId,
+        }),
+      });
+      if (resp.ok) {
+        // Also mark as read
+        await fetch(`${API_URL}/api/messages/${messageId}/status`, {
+          method: "PATCH",
+          headers: { "Content-Type": "application/json", "X-API-Key": API_KEY },
+          body: JSON.stringify({ status: "read" }),
+        });
+        return { content: [{ type: "text" as const, text: `Reply sent successfully.` }] };
+      } else {
+        return { content: [{ type: "text" as const, text: `Reply failed: HTTP ${resp.status}` }] };
+      }
+    } catch (err) {
+      return { content: [{ type: "text" as const, text: `Reply failed: ${err}` }] };
+    }
+  }
+  if (name === "agenthub_mark_read") {
+    const messageId = args?.message_id as string;
+    try {
+      await fetch(`${API_URL}/api/messages/${messageId}/status`, {
+        method: "PATCH",
+        headers: { "Content-Type": "application/json", "X-API-Key": API_KEY },
+        body: JSON.stringify({ status: "read" }),
+      });
+      return { content: [{ type: "text" as const, text: "Marked as read." }] };
+    } catch (err) {
+      return { content: [{ type: "text" as const, text: `Failed: ${err}` }] };
+    }
+  }
+  return { content: [{ type: "text" as const, text: `Unknown tool: ${name}` }] };
+});
+// =============================================================================
+// WebSocket: connect to AgentHub and emit channel notifications
+// =============================================================================
+let ws: WebSocket | null = null;
+let reconnectAttempts = 0;
+function connectWebSocket(): void {
+  if (!AGENT_ID || !API_KEY) return;
+  const url = `${WS_URL}/ws/agents/${AGENT_ID}?api_key=${API_KEY}`;
+  ws = new WebSocket(url);
+  ws.on("open", () => {
+    reconnectAttempts = 0;
+  });
+  ws.on("message", async (data: WebSocket.Data) => {
+    try {
+      const msg = JSON.parse(data.toString());
+      if (msg.type === "ping") {
+        ws?.send(JSON.stringify({ type: "pong", timestamp: new Date().toISOString() }));
+        return;
+      }
+      if (msg.type === "message" && msg.message) {
+        const m = msg.message;
+        // Ignore messages from self
+        if (m.from_agent === AGENT_ID) {
+          ws?.send(JSON.stringify({ type: "ack", message_id: m.id, timestamp: new Date().toISOString() }));
+          return;
+        }
+        // ACK the message
+        ws?.send(JSON.stringify({ type: "ack", message_id: m.id, timestamp: new Date().toISOString() }));
+        // Emit channel notification — this injects into the active session
+        const priority = m.priority === "urgent" ? " [URGENT]" : m.priority === "high" ? " [HIGH]" : "";
+        const content = `📨 Message from ${m.from_agent}${priority}\nSubject: ${m.subject}\n\n${m.body}\n\nMessage ID: ${m.id}\nUse agenthub_reply with this message_id to respond.`;
+        await server.notification({
+          method: "notifications/claude/channel",
+          params: {
+            content,
+            meta: {
+              source: "agenthub",
+              from: m.from_agent,
+              subject: m.subject,
+              message_id: m.id,
+              type: m.type,
+              priority: m.priority,
+            },
+          },
+        });
+      }
+      if (msg.type === "task" && msg.task) {
+        const t = msg.task;
+        await server.notification({
+          method: "notifications/claude/channel",
+          params: {
+            content: `📋 New task assigned by ${t.assigned_by}\n\n${t.task}\n\nTask ID: ${t.id}\nPriority: ${t.priority}`,
+            meta: {
+              source: "agenthub",
+              from: t.assigned_by,
+              task_id: t.id,
+              type: "task",
+              priority: t.priority,
+            },
+          },
+        });
+      }
+    } catch {
+      // Parse errors — ignore
+    }
+  });
+  ws.on("close", () => {
+    ws = null;
+    scheduleReconnect();
+  });
+  ws.on("error", () => {
+    // Error will trigger close
+  });
+}
+function scheduleReconnect(): void {
+  reconnectAttempts++;
+  if (reconnectAttempts > 10) return; // Give up after 10 attempts
+  const delay = Math.min(1000 * Math.pow(2, reconnectAttempts - 1), 30000);
+  setTimeout(connectWebSocket, delay);
+}
+// =============================================================================
+// Start
+// =============================================================================
+async function main(): Promise<void> {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  // Connect WebSocket after MCP is ready
+  if (AGENT_ID && API_KEY) {
+    connectWebSocket();
+  }
+}
+main().catch(() => process.exit(1));