agenthub-multiagent-mcp 1.45.0 → 1.47.0

package/dist/channel.js

@@ -20,6 +20,7 @@ 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";
+import { buildChannelNotification, buildReplyBody, channelEnabled } from "./channelLib.js";
 // =============================================================================
 // Config
 // =============================================================================
@@ -27,6 +28,11 @@ 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:");
+// Phase B kill switch (add-inbox-push-bridge §2.1): the plugin is OFF unless
+// AGENTHUB_INBOX_CHANNEL_ENABLED is explicitly truthy. When off it still serves
+// MCP (so `--channels server:agenthub-channel` doesn't error) but opens no
+// WebSocket and emits no notifications.
+const ENABLED = channelEnabled();
 // =============================================================================
 // MCP Server with channel capability
 // =============================================================================
@@ -88,30 +94,26 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             return { content: [{ type: "text", text: "Error: message_id and body are required" }] };
         }
         try {
+            // Resolve the original sender so the reply is addressed correctly and the
+            // original message transitions to `responded` (the reply_to POST does that
+            // server-side — no separate status PATCH needed). Mirrors
+            // mcp__agenthub__reply. (add-inbox-push-bridge §2.2)
+            const origResp = await fetch(`${API_URL}/api/messages/${messageId}`, {
+                headers: { "X-API-Key": API_KEY },
+            });
+            if (!origResp.ok) {
+                return { content: [{ type: "text", text: `Reply failed: could not load original message (HTTP ${origResp.status})` }] };
+            }
+            const original = (await origResp.json());
             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,
-                }),
+                body: JSON.stringify(buildReplyBody(original, AGENT_ID, body, 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}` }] };
+                return { content: [{ type: "text", text: `Reply sent to ${original.from_agent}.` }] };
             }
+            return { content: [{ type: "text", text: `Reply failed: HTTP ${resp.status}` }] };
         }
         catch (err) {
             return { content: [{ type: "text", text: `Reply failed: ${err}` }] };
@@ -139,7 +141,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 let ws = null;
 let reconnectAttempts = 0;
 function connectWebSocket() {
-    if (!AGENT_ID || !API_KEY)
+    if (!ENABLED || !AGENT_ID || !API_KEY)
         return;
     const url = `${WS_URL}/ws/agents/${AGENT_ID}`;
     ws = new WebSocket(url, { headers: { "X-API-Key": API_KEY } });
@@ -153,47 +155,18 @@ function connectWebSocket() {
                 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,
-                        },
-                    },
-                });
+            // ACK every inbound message event (incl. self) so the server can advance
+            // delivery state, even when we don't surface it as a channel turn.
+            if (msg.type === "message" && msg.message?.id) {
+                ws?.send(JSON.stringify({ type: "ack", message_id: msg.message.id, timestamp: new Date().toISOString() }));
             }
-            if (msg.type === "task" && msg.task) {
-                const t = msg.task;
+            // Decide what (if anything) to inject into the session. Returns null for
+            // self-messages and event types we don't push.
+            const note = buildChannelNotification(msg, AGENT_ID);
+            if (note) {
                 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,
-                        },
-                    },
+                    params: { content: note.content, meta: note.meta },
                 });
             }
         }
@@ -210,10 +183,12 @@ function connectWebSocket() {
     });
 }
 function scheduleReconnect() {
+    // Never permanently give up (add-inbox-push-bridge §2.3): a dormant channel
+    // must self-heal when the server returns. Backoff is capped at 30s; the
+    // exponent is clamped so attempt counts can't overflow Math.pow. The Phase A
+    // SessionStart poll remains the delivery floor during any outage.
     reconnectAttempts++;
-    if (reconnectAttempts > 10)
-        return; // Give up after 10 attempts
-    const delay = Math.min(1000 * Math.pow(2, reconnectAttempts - 1), 30000);
+    const delay = Math.min(1000 * Math.pow(2, Math.min(reconnectAttempts - 1, 5)), 30000);
     setTimeout(connectWebSocket, delay);
 }
 // =============================================================================
@@ -222,8 +197,9 @@ function scheduleReconnect() {
 async function main() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    // Connect WebSocket after MCP is ready
-    if (AGENT_ID && API_KEY) {
+    // Connect WebSocket after MCP is ready — only when the channel is enabled and
+    // credentials are present. Disabled is a clean no-op (MCP serves, no socket).
+    if (ENABLED && AGENT_ID && API_KEY) {
         connectWebSocket();
     }
 }

package/dist/channel.js.map

@@ -1 +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,EAAE,CAAC;IAC9C,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAE/D,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"}
+{"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;AAC3B,OAAO,EAAE,wBAAwB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE3F,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,6EAA6E;AAC7E,gFAAgF;AAChF,2EAA2E;AAC3E,wCAAwC;AACxC,MAAM,OAAO,GAAG,cAAc,EAAE,CAAC;AAEjC,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,0EAA0E;YAC1E,2EAA2E;YAC3E,0DAA0D;YAC1D,qDAAqD;YACrD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,iBAAiB,SAAS,EAAE,EAAE;gBACnE,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE;aAClC,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,uDAAuD,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC;YACnI,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4C,CAAC;YAEpF,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,cAAc,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;aAC1E,CAAC,CAAC;YAEH,IAAI,IAAI,CAAC,EAAE,EAAE,CAAC;gBACZ,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,iBAAiB,QAAQ,CAAC,UAAU,GAAG,EAAE,CAAC,EAAE,CAAC;YACjG,CAAC;YACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,sBAAsB,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QAC7F,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,OAAO,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO;QAAE,OAAO;IAE9C,MAAM,GAAG,GAAG,GAAG,MAAM,cAAc,QAAQ,EAAE,CAAC;IAC9C,EAAE,GAAG,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;IAE/D,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,yEAAyE;YACzE,mEAAmE;YACnE,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,EAAE,CAAC;gBAC9C,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC;YAC7G,CAAC;YAED,yEAAyE;YACzE,+CAA+C;YAC/C,MAAM,IAAI,GAAG,wBAAwB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YACrD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,MAAM,CAAC,YAAY,CAAC;oBACxB,MAAM,EAAE,8BAA8B;oBACtC,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE;iBACnD,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,4EAA4E;IAC5E,wEAAwE;IACxE,6EAA6E;IAC7E,kEAAkE;IAClE,iBAAiB,EAAE,CAAC;IACpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,iBAAiB,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACtF,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,8EAA8E;IAC9E,8EAA8E;IAC9E,IAAI,OAAO,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;QACnC,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/dist/channelLib.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Pure helpers for the AgentHub channel plugin (add-inbox-push-bridge).
+ *
+ * Extracted from channel.ts so the WS→notification mapping, kill switch, and
+ * reply-body construction are unit-testable without opening a socket or running
+ * the MCP server. channel.ts wires these into the live plugin.
+ */
+export interface ChannelNotification {
+    content: string;
+    meta: Record<string, unknown>;
+}
+/**
+ * Phase B kill switch (§2.1). The plugin is OFF unless
+ * AGENTHUB_INBOX_CHANNEL_ENABLED is explicitly truthy. Independent of
+ * AGENTHUB_AUTO_INBOX (the Phase A SessionStart poll), which stays the floor.
+ */
+export declare function channelEnabled(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Map a raw AgentHub WS event to a channel notification, or null when nothing
+ * should be surfaced (self-message, or an event type we don't push). The caller
+ * still ACKs message events even when this returns null (self-filter case).
+ */
+export declare function buildChannelNotification(msg: unknown, agentId: string): ChannelNotification | null;
+/**
+ * Build the reply POST body (§2.2). Mirrors mcp__agenthub__reply semantics: the
+ * recipient resolves to the ORIGINAL sender (never empty) and the reply carries
+ * reply_to, which is what transitions the original message to `responded`
+ * server-side. The old plugin posted to_agent:"" then PATCHed status to `read`,
+ * which left the original un-responded — fixed here.
+ */
+export declare function buildReplyBody(original: {
+    from_agent: string;
+    subject: string;
+}, agentId: string, body: string, messageId: string): {
+    from_agent: string;
+    to_agent: string;
+    type: "response";
+    subject: string;
+    body: string;
+    reply_to: string;
+};
+//# sourceMappingURL=channelLib.d.ts.map

package/dist/channelLib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelLib.d.ts","sourceRoot":"","sources":["../src/channelLib.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAE5E;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,EACZ,OAAO,EAAE,MAAM,GACd,mBAAmB,GAAG,IAAI,CAuC5B;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EACjD,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB;IACD,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CASA"}

package/dist/channelLib.js

@@ -0,0 +1,74 @@
+/**
+ * Pure helpers for the AgentHub channel plugin (add-inbox-push-bridge).
+ *
+ * Extracted from channel.ts so the WS→notification mapping, kill switch, and
+ * reply-body construction are unit-testable without opening a socket or running
+ * the MCP server. channel.ts wires these into the live plugin.
+ */
+/**
+ * Phase B kill switch (§2.1). The plugin is OFF unless
+ * AGENTHUB_INBOX_CHANNEL_ENABLED is explicitly truthy. Independent of
+ * AGENTHUB_AUTO_INBOX (the Phase A SessionStart poll), which stays the floor.
+ */
+export function channelEnabled(env = process.env) {
+    return /^(1|true|yes|on)$/i.test((env.AGENTHUB_INBOX_CHANNEL_ENABLED || "").trim());
+}
+/**
+ * Map a raw AgentHub WS event to a channel notification, or null when nothing
+ * should be surfaced (self-message, or an event type we don't push). The caller
+ * still ACKs message events even when this returns null (self-filter case).
+ */
+export function buildChannelNotification(msg, agentId) {
+    if (!msg || typeof msg !== "object")
+        return null;
+    const m = msg;
+    if (m.type === "message" && m.message) {
+        const msgObj = m.message;
+        // Never echo a message the agent itself sent.
+        if (msgObj.from_agent === agentId)
+            return null;
+        const priority = msgObj.priority === "urgent" ? " [URGENT]" : msgObj.priority === "high" ? " [HIGH]" : "";
+        const content = `📨 Message from ${msgObj.from_agent}${priority}\n` +
+            `Subject: ${msgObj.subject}\n\n${msgObj.body}\n\n` +
+            `Message ID: ${msgObj.id}\n` +
+            `Use agenthub_reply with this message_id to respond.`;
+        return {
+            content,
+            meta: {
+                source: "agenthub",
+                from: msgObj.from_agent,
+                subject: msgObj.subject,
+                message_id: msgObj.id,
+                type: msgObj.type,
+                priority: msgObj.priority,
+            },
+        };
+    }
+    if (m.type === "task" && m.task) {
+        const t = m.task;
+        return {
+            content: `📋 New task assigned by ${t.assigned_by}\n\n${t.task}\n\n` +
+                `Task ID: ${t.id}\nPriority: ${t.priority}`,
+            meta: { source: "agenthub", from: t.assigned_by, task_id: t.id, type: "task", priority: t.priority },
+        };
+    }
+    return null;
+}
+/**
+ * Build the reply POST body (§2.2). Mirrors mcp__agenthub__reply semantics: the
+ * recipient resolves to the ORIGINAL sender (never empty) and the reply carries
+ * reply_to, which is what transitions the original message to `responded`
+ * server-side. The old plugin posted to_agent:"" then PATCHed status to `read`,
+ * which left the original un-responded — fixed here.
+ */
+export function buildReplyBody(original, agentId, body, messageId) {
+    return {
+        from_agent: agentId,
+        to_agent: original.from_agent,
+        type: "response",
+        subject: `Re: ${original.subject}`,
+        body: body.slice(0, 5000),
+        reply_to: messageId,
+    };
+}
+//# sourceMappingURL=channelLib.js.map

package/dist/channelLib.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelLib.js","sourceRoot":"","sources":["../src/channelLib.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,MAAyB,OAAO,CAAC,GAAG;IACjE,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;AACtF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAY,EACZ,OAAe;IAEf,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,CAAC,GAAG,GAAmD,CAAC;IAE9D,IAAI,CAAC,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC;QACzB,8CAA8C;QAC9C,IAAI,MAAM,CAAC,UAAU,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/C,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,KAAK,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3F,MAAM,OAAO,GACX,mBAAmB,MAAM,CAAC,UAAU,GAAG,QAAQ,IAAI;YACnD,YAAY,MAAM,CAAC,OAAO,OAAO,MAAM,CAAC,IAAI,MAAM;YAClD,eAAe,MAAM,CAAC,EAAE,IAAI;YAC5B,qDAAqD,CAAC;QACxD,OAAO;YACL,OAAO;YACP,IAAI,EAAE;gBACJ,MAAM,EAAE,UAAU;gBAClB,IAAI,EAAE,MAAM,CAAC,UAAU;gBACvB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,UAAU,EAAE,MAAM,CAAC,EAAE;gBACrB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;aAC1B;SACF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QACjB,OAAO;YACL,OAAO,EACL,2BAA2B,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,IAAI,MAAM;gBAC3D,YAAY,CAAC,CAAC,EAAE,eAAe,CAAC,CAAC,QAAQ,EAAE;YAC7C,IAAI,EAAE,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE;SACrG,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAiD,EACjD,OAAe,EACf,IAAY,EACZ,SAAiB;IASjB,OAAO;QACL,UAAU,EAAE,OAAO;QACnB,QAAQ,EAAE,QAAQ,CAAC,UAAU;QAC7B,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,OAAO,QAAQ,CAAC,OAAO,EAAE;QAClC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;QACzB,QAAQ,EAAE,SAAS;KACpB,CAAC;AACJ,CAAC"}

package/dist/channelLib.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channelLib.test.d.ts.map

package/dist/channelLib.test.d.ts.map

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

package/dist/channelLib.test.js

@@ -0,0 +1,67 @@
+import { describe, it, expect } from "vitest";
+import { buildChannelNotification, buildReplyBody, channelEnabled } from "./channelLib.js";
+// add-inbox-push-bridge §4 — hardening tests for the channel plugin's pure logic.
+describe("channelEnabled (kill switch §2.1)", () => {
+    it("is off when unset", () => {
+        expect(channelEnabled({})).toBe(false);
+    });
+    it("is off for falsey strings", () => {
+        for (const v of ["", "false", "0", "no", "off", "  "]) {
+            expect(channelEnabled({ AGENTHUB_INBOX_CHANNEL_ENABLED: v })).toBe(false);
+        }
+    });
+    it("is on only for explicit truthy values (case-insensitive, trimmed)", () => {
+        for (const v of ["true", "TRUE", "1", "yes", "on", " true "]) {
+            expect(channelEnabled({ AGENTHUB_INBOX_CHANNEL_ENABLED: v })).toBe(true);
+        }
+    });
+});
+describe("buildChannelNotification (§4.1)", () => {
+    const agentId = "me";
+    it("maps an inbound message to a channel notification", () => {
+        const note = buildChannelNotification({
+            type: "message",
+            message: { id: "m1", from_agent: "alice", subject: "Hi", body: "ping", priority: "normal", type: "question" },
+        }, agentId);
+        expect(note).not.toBeNull();
+        expect(note.content).toContain("Message from alice");
+        expect(note.content).toContain("ping");
+        expect(note.content).toContain("m1");
+        expect(note.meta).toMatchObject({ source: "agenthub", from: "alice", message_id: "m1" });
+    });
+    it("surfaces priority for urgent/high", () => {
+        const urgent = buildChannelNotification({ type: "message", message: { id: "m2", from_agent: "alice", subject: "x", body: "y", priority: "urgent" } }, agentId);
+        expect(urgent.content).toContain("[URGENT]");
+    });
+    it("returns null for a self-message (no echo)", () => {
+        const note = buildChannelNotification({ type: "message", message: { id: "m3", from_agent: agentId, subject: "x", body: "y" } }, agentId);
+        expect(note).toBeNull();
+    });
+    it("maps a task event", () => {
+        const note = buildChannelNotification({ type: "task", task: { id: "t1", assigned_by: "boss", task: "do it", priority: "high" } }, agentId);
+        expect(note).not.toBeNull();
+        expect(note.content).toContain("New task assigned by boss");
+        expect(note.meta).toMatchObject({ task_id: "t1", type: "task" });
+    });
+    it("returns null for unknown / malformed events", () => {
+        expect(buildChannelNotification({ type: "pong" }, agentId)).toBeNull();
+        expect(buildChannelNotification({ type: "message" }, agentId)).toBeNull(); // no message body
+        expect(buildChannelNotification(null, agentId)).toBeNull();
+        expect(buildChannelNotification("nope", agentId)).toBeNull();
+    });
+});
+describe("buildReplyBody (reply correctness §2.2)", () => {
+    it("addresses the reply to the original sender and carries reply_to", () => {
+        const body = buildReplyBody({ from_agent: "alice", subject: "Hi" }, "me", "thanks", "m1");
+        expect(body.to_agent).toBe("alice"); // NOT "" — the old bug
+        expect(body.from_agent).toBe("me");
+        expect(body.type).toBe("response");
+        expect(body.subject).toBe("Re: Hi");
+        expect(body.reply_to).toBe("m1"); // reply_to is what marks the original `responded`
+    });
+    it("truncates the body to 5000 chars", () => {
+        const body = buildReplyBody({ from_agent: "a", subject: "s" }, "me", "x".repeat(6000), "m1");
+        expect(body.body.length).toBe(5000);
+    });
+});
+//# sourceMappingURL=channelLib.test.js.map

package/dist/channelLib.test.js.map

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

package/dist/channelSetup.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Interactive-session wiring for the AgentHub channel plugin
+ * (add-inbox-push-bridge §3). Builds the `agenthub-channel` MCP-server entry and
+ * merges it idempotently into a project's MCP config, so a normal `claude`
+ * session can opt in via `--channels server:agenthub-channel`.
+ *
+ * Pure + filesystem helpers are split so the merge logic is unit-testable.
+ */
+export declare const CHANNEL_SERVER_NAME = "agenthub-channel";
+export interface McpServerEntry {
+    type: "stdio";
+    command: string;
+    args: string[];
+    env: Record<string, string>;
+}
+export interface ChannelEntryOptions {
+    url: string;
+    apiKey: string;
+    agentId: string;
+    /** Defaults to true (explicit opt-in). false writes the entry but keeps the
+     *  plugin a no-op via the §2.1 kill switch — safe to install while disabled. */
+    enabled?: boolean;
+}
+/**
+ * The MCP-server entry that makes `server:agenthub-channel` resolvable. Runs the
+ * published `agenthub-channel` bin via npx (same distribution as the main MCP),
+ * carrying the agent's existing AgentHub creds + the kill switch.
+ */
+export declare function channelMcpServerEntry(opts: ChannelEntryOptions): McpServerEntry;
+/**
+ * Idempotently set the channel server entry under `mcpServers`, preserving every
+ * other server. Re-running with the same opts produces the same config.
+ */
+export declare function mergeChannelServer(config: Record<string, unknown>, entry: McpServerEntry, name?: string): Record<string, unknown>;
+/**
+ * Read a JSON MCP-config file (or start from {} if absent/empty), merge the
+ * channel entry, and write it back with 2-space indent. Returns whether the file
+ * was newly created and whether the channel entry already matched (no-op).
+ */
+export declare function applyChannelToConfigFile(filePath: string, opts: ChannelEntryOptions, name?: string): {
+    created: boolean;
+    unchanged: boolean;
+};
+//# sourceMappingURL=channelSetup.d.ts.map

package/dist/channelSetup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelSetup.d.ts","sourceRoot":"","sources":["../src/channelSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,eAAO,MAAM,mBAAmB,qBAAqB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB;oFACgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,CAc/E;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,cAAc,EACrB,IAAI,GAAE,MAA4B,GACjC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,EACzB,IAAI,GAAE,MAA4B,GACjC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAgB1C"}

package/dist/channelSetup.js

@@ -0,0 +1,61 @@
+/**
+ * Interactive-session wiring for the AgentHub channel plugin
+ * (add-inbox-push-bridge §3). Builds the `agenthub-channel` MCP-server entry and
+ * merges it idempotently into a project's MCP config, so a normal `claude`
+ * session can opt in via `--channels server:agenthub-channel`.
+ *
+ * Pure + filesystem helpers are split so the merge logic is unit-testable.
+ */
+import * as fs from "fs";
+export const CHANNEL_SERVER_NAME = "agenthub-channel";
+/**
+ * The MCP-server entry that makes `server:agenthub-channel` resolvable. Runs the
+ * published `agenthub-channel` bin via npx (same distribution as the main MCP),
+ * carrying the agent's existing AgentHub creds + the kill switch.
+ */
+export function channelMcpServerEntry(opts) {
+    return {
+        type: "stdio",
+        command: "npx",
+        args: ["-y", "-p", "agenthub-multiagent-mcp@latest", CHANNEL_SERVER_NAME],
+        env: {
+            AGENTHUB_URL: opts.url,
+            AGENTHUB_API_KEY: opts.apiKey,
+            AGENTHUB_AGENT_ID: opts.agentId,
+            // §3.2 — the opt-in is safe even when disabled: the plugin no-ops unless
+            // this is truthy (see channelEnabled / §2.1).
+            AGENTHUB_INBOX_CHANNEL_ENABLED: opts.enabled === false ? "false" : "true",
+        },
+    };
+}
+/**
+ * Idempotently set the channel server entry under `mcpServers`, preserving every
+ * other server. Re-running with the same opts produces the same config.
+ */
+export function mergeChannelServer(config, entry, name = CHANNEL_SERVER_NAME) {
+    const existing = config.mcpServers || {};
+    return { ...config, mcpServers: { ...existing, [name]: entry } };
+}
+/**
+ * Read a JSON MCP-config file (or start from {} if absent/empty), merge the
+ * channel entry, and write it back with 2-space indent. Returns whether the file
+ * was newly created and whether the channel entry already matched (no-op).
+ */
+export function applyChannelToConfigFile(filePath, opts, name = CHANNEL_SERVER_NAME) {
+    let config = {};
+    let created = true;
+    if (fs.existsSync(filePath)) {
+        created = false;
+        const raw = fs.readFileSync(filePath, "utf-8").trim();
+        if (raw) {
+            config = JSON.parse(raw);
+        }
+    }
+    const entry = channelMcpServerEntry(opts);
+    const before = JSON.stringify(config.mcpServers?.[name]);
+    const merged = mergeChannelServer(config, entry, name);
+    const after = JSON.stringify(merged.mcpServers[name]);
+    fs.writeFileSync(filePath, JSON.stringify(merged, null, 2));
+    return { created, unchanged: before === after };
+}
+//# sourceMappingURL=channelSetup.js.map

package/dist/channelSetup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channelSetup.js","sourceRoot":"","sources":["../src/channelSetup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CAAC;AAkBtD;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAyB;IAC7D,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,gCAAgC,EAAE,mBAAmB,CAAC;QACzE,GAAG,EAAE;YACH,YAAY,EAAE,IAAI,CAAC,GAAG;YACtB,gBAAgB,EAAE,IAAI,CAAC,MAAM;YAC7B,iBAAiB,EAAE,IAAI,CAAC,OAAO;YAC/B,yEAAyE;YACzE,8CAA8C;YAC9C,8BAA8B,EAAE,IAAI,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM;SAC1E;KACF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA+B,EAC/B,KAAqB,EACrB,OAAe,mBAAmB;IAElC,MAAM,QAAQ,GAAI,MAAM,CAAC,UAAkD,IAAI,EAAE,CAAC;IAClF,OAAO,EAAE,GAAG,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,QAAQ,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;AACnE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAgB,EAChB,IAAyB,EACzB,OAAe,mBAAmB;IAElC,IAAI,MAAM,GAA4B,EAAE,CAAC;IACzC,IAAI,OAAO,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAG,KAAK,CAAC;QAChB,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;QACtD,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IAC1C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAE,MAAM,CAAC,UAAsC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAE,MAAM,CAAC,UAAsC,CAAC,IAAI,CAAC,CAAC,CAAC;IACnF,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,KAAK,EAAE,CAAC;AAClD,CAAC"}

package/dist/channelSetup.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=channelSetup.test.d.ts.map

package/dist/channelSetup.test.d.ts.map

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

package/dist/channelSetup.test.js

@@ -0,0 +1,75 @@
+import { describe, it, expect, beforeEach, afterEach } from "vitest";
+import * as fs from "fs";
+import * as os from "os";
+import * as path from "path";
+import { channelMcpServerEntry, mergeChannelServer, applyChannelToConfigFile, CHANNEL_SERVER_NAME, } from "./channelSetup.js";
+// add-inbox-push-bridge §3 — interactive-session wiring helpers.
+const OPTS = { url: "https://h.example.com", apiKey: "k123", agentId: "agent-x" };
+describe("channelMcpServerEntry", () => {
+    it("builds a stdio npx entry carrying creds + opt-in", () => {
+        const e = channelMcpServerEntry(OPTS);
+        expect(e.type).toBe("stdio");
+        expect(e.command).toBe("npx");
+        expect(e.args).toContain(CHANNEL_SERVER_NAME);
+        expect(e.env.AGENTHUB_URL).toBe("https://h.example.com");
+        expect(e.env.AGENTHUB_API_KEY).toBe("k123");
+        expect(e.env.AGENTHUB_AGENT_ID).toBe("agent-x");
+        expect(e.env.AGENTHUB_INBOX_CHANNEL_ENABLED).toBe("true");
+    });
+    it("respects the kill switch when installed disabled (§3.2)", () => {
+        const e = channelMcpServerEntry({ ...OPTS, enabled: false });
+        expect(e.env.AGENTHUB_INBOX_CHANNEL_ENABLED).toBe("false");
+    });
+});
+describe("mergeChannelServer", () => {
+    it("adds the channel server while preserving existing servers", () => {
+        const before = { mcpServers: { agenthub: { command: "npx" } }, other: 1 };
+        const merged = mergeChannelServer(before, channelMcpServerEntry(OPTS));
+        expect(merged.mcpServers.agenthub).toEqual({ command: "npx" }); // preserved
+        expect(merged.mcpServers[CHANNEL_SERVER_NAME]).toBeDefined();
+        expect(merged.other).toBe(1);
+    });
+    it("is idempotent — re-merging the same entry yields the same config", () => {
+        const entry = channelMcpServerEntry(OPTS);
+        const once = mergeChannelServer({}, entry);
+        const twice = mergeChannelServer(once, entry);
+        expect(JSON.stringify(twice)).toBe(JSON.stringify(once));
+    });
+});
+describe("applyChannelToConfigFile", () => {
+    let dir;
+    let file;
+    beforeEach(() => {
+        dir = fs.mkdtempSync(path.join(os.tmpdir(), "channel-setup-"));
+        file = path.join(dir, ".mcp.json");
+    });
+    afterEach(() => {
+        fs.rmSync(dir, { recursive: true, force: true });
+    });
+    it("creates a config file when none exists", () => {
+        const r = applyChannelToConfigFile(file, OPTS);
+        expect(r.created).toBe(true);
+        const written = JSON.parse(fs.readFileSync(file, "utf-8"));
+        expect(written.mcpServers[CHANNEL_SERVER_NAME].env.AGENTHUB_AGENT_ID).toBe("agent-x");
+    });
+    it("merges into an existing config without clobbering other servers", () => {
+        fs.writeFileSync(file, JSON.stringify({ mcpServers: { agenthub: { command: "npx", args: [] } } }));
+        const r = applyChannelToConfigFile(file, OPTS);
+        expect(r.created).toBe(false);
+        const written = JSON.parse(fs.readFileSync(file, "utf-8"));
+        expect(written.mcpServers.agenthub).toBeDefined(); // preserved
+        expect(written.mcpServers[CHANNEL_SERVER_NAME]).toBeDefined();
+    });
+    it("is idempotent — second apply reports unchanged", () => {
+        applyChannelToConfigFile(file, OPTS);
+        const second = applyChannelToConfigFile(file, OPTS);
+        expect(second.unchanged).toBe(true);
+    });
+    it("tolerates an empty file", () => {
+        fs.writeFileSync(file, "");
+        const r = applyChannelToConfigFile(file, OPTS);
+        expect(r.created).toBe(false);
+        expect(JSON.parse(fs.readFileSync(file, "utf-8")).mcpServers[CHANNEL_SERVER_NAME]).toBeDefined();
+    });
+});
+//# sourceMappingURL=channelSetup.test.js.map

package/dist/channelSetup.test.js.map

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

package/dist/client.d.ts

@@ -200,6 +200,12 @@ export declare class ApiClient {
      */
     employeeSlackDM(toUser: string, text: string): Promise<unknown>;
     deliverFile(messageId: string, filePath: string, comment?: string): Promise<unknown>;
+    /**
+     * Upload a local file to an arbitrary Slack channel or DM (add-slack-file-upload).
+     * target is a channel id (C…/G…), a #channel-name, or a user id (U…/W…, DM).
+     * Reads the file locally and base64-encodes it — same contract as deliverFile.
+     */
+    uploadSlackFile(target: string, filePath: string, comment?: string): Promise<unknown>;
     registerAgent(id: string, name?: string, owner?: string, workingDir?: string, model?: string, projectKey?: string): Promise<{
         agent_id: string;
         name: string;