agent-inbox 0.1.8 → 0.1.9

package/dist/mcp/mcp-proxy.js

@@ -0,0 +1,280 @@
+/**
+ * mcp-proxy.ts — MCP server that proxies all tools to an existing inbox IPC socket.
+ *
+ * Instead of creating its own storage/router, this connects to a running
+ * agent-inbox IPC server (e.g., the sidecar's inbox instance) and translates
+ * MCP tool calls into IPC commands.
+ *
+ * This ensures a single source of truth for messages, agents, and routing.
+ */
+import * as net from "node:net";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const IPC_TIMEOUT_MS = 5000;
+const CONNECT_RETRY_MS = 500;
+const CONNECT_MAX_RETRIES = 10;
+export class InboxMcpProxy {
+    socketPath;
+    defaultAgentId;
+    defaultScope;
+    mcp;
+    constructor(socketPath, defaultAgentId = "anonymous", defaultScope = "default") {
+        this.socketPath = socketPath;
+        this.defaultAgentId = defaultAgentId;
+        this.defaultScope = defaultScope;
+        this.mcp = new McpServer({
+            name: "agent-inbox",
+            version: "0.1.0",
+        });
+        this.registerTools();
+    }
+    /**
+     * Send an IPC command to the inbox socket and return the response.
+     * Retries connection if socket is not yet available.
+     */
+    async sendIpc(command) {
+        let lastError = null;
+        for (let attempt = 0; attempt < CONNECT_MAX_RETRIES; attempt++) {
+            try {
+                return await this.sendIpcOnce(command);
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                // Only retry on connection errors (socket not ready yet)
+                if (lastError.message.includes("ENOENT") || lastError.message.includes("ECONNREFUSED")) {
+                    if (attempt < CONNECT_MAX_RETRIES - 1) {
+                        await new Promise((r) => setTimeout(r, CONNECT_RETRY_MS));
+                        continue;
+                    }
+                }
+                break;
+            }
+        }
+        return { ok: false, error: `Inbox unavailable: ${lastError?.message ?? "unknown error"}` };
+    }
+    sendIpcOnce(command) {
+        return new Promise((resolve, reject) => {
+            const client = net.createConnection(this.socketPath);
+            let buffer = "";
+            let settled = false;
+            const timer = setTimeout(() => {
+                if (!settled) {
+                    settled = true;
+                    client.destroy();
+                    reject(new Error("IPC timeout"));
+                }
+            }, IPC_TIMEOUT_MS);
+            client.on("connect", () => {
+                client.write(JSON.stringify(command) + "\n");
+            });
+            client.on("data", (data) => {
+                buffer += data.toString();
+                const newlineIdx = buffer.indexOf("\n");
+                if (newlineIdx !== -1) {
+                    clearTimeout(timer);
+                    settled = true;
+                    const line = buffer.slice(0, newlineIdx).trim();
+                    client.destroy();
+                    try {
+                        resolve(JSON.parse(line));
+                    }
+                    catch {
+                        reject(new Error("Invalid IPC response"));
+                    }
+                }
+            });
+            client.on("error", (err) => {
+                if (!settled) {
+                    clearTimeout(timer);
+                    settled = true;
+                    reject(err);
+                }
+            });
+        });
+    }
+    registerTools() {
+        this.mcp.tool("send_message", "Send a message to one or more agents. Supports replies (inReplyTo), threading (threadTag), and federated addressing (agent@system).", {
+            to: z
+                .union([z.string(), z.array(z.string())])
+                .describe("Recipient agent ID(s). Use 'agent@system' for federated addressing."),
+            body: z
+                .string()
+                .optional()
+                .describe("Plain text message body (shorthand for content)"),
+            content: z
+                .object({ type: z.string() })
+                .passthrough()
+                .optional()
+                .describe("Structured message content"),
+            from: z
+                .string()
+                .optional()
+                .describe("Sender agent ID (defaults to caller)"),
+            threadTag: z
+                .string()
+                .optional()
+                .describe("Thread tag for grouping related messages"),
+            inReplyTo: z
+                .string()
+                .optional()
+                .describe("Message ID this is a reply to"),
+            importance: z
+                .enum(["low", "normal", "high", "urgent"])
+                .optional()
+                .describe("Message importance level"),
+            subject: z.string().optional().describe("Message subject"),
+        }, async ({ to, body, content, from, threadTag, inReplyTo, importance, subject }) => {
+            const payload = content ?? body ?? "";
+            const senderId = from ?? this.defaultAgentId;
+            const resp = await this.sendIpc({
+                action: "send",
+                from: senderId,
+                to,
+                payload,
+                threadTag,
+                inReplyTo,
+                importance,
+                subject,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(resp.ok
+                            ? { ok: true, messageId: resp.messageId }
+                            : { ok: false, error: resp.error }),
+                    },
+                ],
+            };
+        });
+        this.mcp.tool("check_inbox", "Check inbox for messages addressed to an agent. Auto-registers the agent if not already registered.", {
+            agentId: z.string().describe("Agent ID to check inbox for"),
+            unreadOnly: z
+                .boolean()
+                .optional()
+                .describe("Only return unread messages (default true)"),
+            limit: z
+                .number()
+                .optional()
+                .describe("Max messages to return"),
+        }, async ({ agentId, unreadOnly, limit }) => {
+            const resp = await this.sendIpc({
+                action: "check_inbox",
+                agentId,
+                unreadOnly: unreadOnly ?? true,
+                clear: true, // Mark as read after retrieval
+            });
+            if (!resp.ok) {
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify({ ok: false, error: resp.error }) },
+                    ],
+                };
+            }
+            let messages = resp.messages ?? [];
+            if (limit && messages.length > limit) {
+                messages = messages.slice(0, limit);
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            count: messages.length,
+                            messages: messages.map((m) => ({
+                                id: m.id,
+                                from: m.sender_id,
+                                subject: m.subject,
+                                content: m.content,
+                                threadTag: m.thread_tag,
+                                importance: m.importance,
+                                createdAt: m.created_at,
+                                inReplyTo: m.in_reply_to,
+                            })),
+                        }),
+                    },
+                ],
+            };
+        });
+        this.mcp.tool("read_thread", "Read all messages in a thread (by thread_tag)", {
+            threadTag: z.string().describe("Thread tag to read"),
+            scope: z
+                .string()
+                .optional()
+                .describe("Scope (defaults to 'default')"),
+        }, async ({ threadTag, scope }) => {
+            const resp = await this.sendIpc({
+                action: "read_thread",
+                threadTag,
+                scope: scope ?? this.defaultScope,
+            });
+            if (!resp.ok) {
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify({ ok: false, error: resp.error }) },
+                    ],
+                };
+            }
+            const messages = resp.messages ?? [];
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            threadTag,
+                            count: messages.length,
+                            messages: messages.map((m) => ({
+                                id: m.id,
+                                from: m.sender_id,
+                                content: m.content,
+                                createdAt: m.created_at,
+                                inReplyTo: m.in_reply_to,
+                            })),
+                        }),
+                    },
+                ],
+            };
+        });
+        this.mcp.tool("list_agents", "List agents registered in the inbox (local and optionally federated)", {
+            scope: z.string().optional().describe("Filter by scope"),
+            includeFederated: z
+                .boolean()
+                .optional()
+                .describe("Include agents known from federation routing table"),
+        }, async ({ scope, includeFederated }) => {
+            const resp = await this.sendIpc({
+                action: "list_agents",
+                scope,
+                includeFederated,
+            });
+            if (!resp.ok) {
+                return {
+                    content: [
+                        { type: "text", text: JSON.stringify({ ok: false, error: resp.error }) },
+                    ],
+                };
+            }
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            count: resp.count ?? resp.agents?.length ?? 0,
+                            agents: resp.agents ?? [],
+                        }),
+                    },
+                ],
+            };
+        });
+    }
+    async start() {
+        const transport = new StdioServerTransport();
+        await this.mcp.connect(transport);
+    }
+    /** Expose for testing */
+    get server() {
+        return this.mcp;
+    }
+}
+//# sourceMappingURL=mcp-proxy.js.map

package/dist/mcp/mcp-proxy.js.map

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

package/dist/mesh/delivery-bridge.d.ts

@@ -0,0 +1,47 @@
+/**
+ * DeliveryHandler bridge: connects agentic-mesh's MapServer message routing
+ * to agent-inbox's storage layer.
+ *
+ * When MapServer's MessageRouter resolves a message to a local agent,
+ * it calls `deliverToAgent()`. This bridge translates the MAP Message
+ * into an agent-inbox Message and stores it, triggering the full inbox
+ * pipeline (traceability, push notifications, etc.).
+ *
+ * For `forwardToPeer()` and `routeToFederation()`, we delegate back to
+ * the previous (default) handler so MeshPeer's own transport handles it.
+ */
+import { EventEmitter } from "node:events";
+import type { Storage } from "../storage/interface.js";
+import type { MapMessage } from "./type-mapper.js";
+/**
+ * Subset of agentic-mesh's DeliveryHandler interface.
+ * We define it here to avoid importing the full package at compile time.
+ */
+export interface MeshDeliveryHandler {
+    deliverToAgent(agentId: string, message: MapMessage): Promise<boolean>;
+    forwardToPeer(peerId: string, agentIds: string[], message: MapMessage): Promise<boolean>;
+    routeToFederation?(systemId: string, agentIds: string[], message: MapMessage): Promise<boolean>;
+}
+export declare class DeliveryBridge implements MeshDeliveryHandler {
+    private storage;
+    private events;
+    private scope;
+    private previousHandler?;
+    constructor(storage: Storage, events: EventEmitter, scope?: string, previousHandler?: MeshDeliveryHandler | undefined);
+    /**
+     * Called by MapServer's MessageRouter when a message is resolved
+     * to a local agent. Translates and stores in agent-inbox.
+     */
+    deliverToAgent(agentId: string, message: MapMessage): Promise<boolean>;
+    /**
+     * Forward to a connected peer. Delegates to the previous handler
+     * (MeshPeer's default transport handles actual peer forwarding).
+     */
+    forwardToPeer(peerId: string, agentIds: string[], message: MapMessage): Promise<boolean>;
+    /**
+     * Route to a federated system. Delegates to the previous handler
+     * (FederationGateway handles cross-mesh routing).
+     */
+    routeToFederation(systemId: string, agentIds: string[], message: MapMessage): Promise<boolean>;
+}
+//# sourceMappingURL=delivery-bridge.d.ts.map

package/dist/mesh/delivery-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-bridge.d.ts","sourceRoot":"","sources":["../../src/mesh/delivery-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAMnD;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACvE,aAAa,CACX,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,iBAAiB,CAAC,CAChB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAMD,qBAAa,cAAe,YAAW,mBAAmB;IAEtD,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,KAAK;IACb,OAAO,CAAC,eAAe,CAAC;gBAHhB,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,YAAY,EACpB,KAAK,GAAE,MAAkB,EACzB,eAAe,CAAC,EAAE,mBAAmB,YAAA;IAG/C;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IAwB5E;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,OAAO,CAAC;IAOnB;;;OAGG;IACG,iBAAiB,CACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,OAAO,CAAC;CAMpB"}

package/dist/mesh/delivery-bridge.js

@@ -0,0 +1,73 @@
+/**
+ * DeliveryHandler bridge: connects agentic-mesh's MapServer message routing
+ * to agent-inbox's storage layer.
+ *
+ * When MapServer's MessageRouter resolves a message to a local agent,
+ * it calls `deliverToAgent()`. This bridge translates the MAP Message
+ * into an agent-inbox Message and stores it, triggering the full inbox
+ * pipeline (traceability, push notifications, etc.).
+ *
+ * For `forwardToPeer()` and `routeToFederation()`, we delegate back to
+ * the previous (default) handler so MeshPeer's own transport handles it.
+ */
+import { mapMessageToInbox } from "./type-mapper.js";
+// ---------------------------------------------------------------------------
+// DeliveryBridge
+// ---------------------------------------------------------------------------
+export class DeliveryBridge {
+    storage;
+    events;
+    scope;
+    previousHandler;
+    constructor(storage, events, scope = "default", previousHandler) {
+        this.storage = storage;
+        this.events = events;
+        this.scope = scope;
+        this.previousHandler = previousHandler;
+    }
+    /**
+     * Called by MapServer's MessageRouter when a message is resolved
+     * to a local agent. Translates and stores in agent-inbox.
+     */
+    async deliverToAgent(agentId, message) {
+        try {
+            const inboxMsg = mapMessageToInbox(message, this.scope);
+            // Ensure the target agent is in the recipients list
+            const hasAgent = inboxMsg.recipients.some((r) => r.agent_id === agentId);
+            if (!hasAgent) {
+                inboxMsg.recipients.push({
+                    agent_id: agentId,
+                    kind: "to",
+                    delivered_at: new Date().toISOString(),
+                });
+            }
+            this.storage.putMessage(inboxMsg);
+            this.events.emit("message.created", inboxMsg);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Forward to a connected peer. Delegates to the previous handler
+     * (MeshPeer's default transport handles actual peer forwarding).
+     */
+    async forwardToPeer(peerId, agentIds, message) {
+        if (this.previousHandler) {
+            return this.previousHandler.forwardToPeer(peerId, agentIds, message);
+        }
+        return false;
+    }
+    /**
+     * Route to a federated system. Delegates to the previous handler
+     * (FederationGateway handles cross-mesh routing).
+     */
+    async routeToFederation(systemId, agentIds, message) {
+        if (this.previousHandler?.routeToFederation) {
+            return this.previousHandler.routeToFederation(systemId, agentIds, message);
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=delivery-bridge.js.map

package/dist/mesh/delivery-bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-bridge.js","sourceRoot":"","sources":["../../src/mesh/delivery-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAyBrD,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E,MAAM,OAAO,cAAc;IAEf;IACA;IACA;IACA;IAJV,YACU,OAAgB,EAChB,MAAoB,EACpB,QAAgB,SAAS,EACzB,eAAqC;QAHrC,YAAO,GAAP,OAAO,CAAS;QAChB,WAAM,GAAN,MAAM,CAAc;QACpB,UAAK,GAAL,KAAK,CAAoB;QACzB,oBAAe,GAAf,eAAe,CAAsB;IAC5C,CAAC;IAEJ;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,OAAe,EAAE,OAAmB;QACvD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAExD,oDAAoD;YACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,UAAU,CAAC,IAAI,CACvC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAC9B,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC;oBACvB,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,IAAI;oBACV,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACvC,CAAC,CAAC;YACL,CAAC;YAED,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CACjB,MAAc,EACd,QAAkB,EAClB,OAAmB;QAEnB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QACvE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,iBAAiB,CACrB,QAAgB,EAChB,QAAkB,EAClB,OAAmB;QAEnB,IAAI,IAAI,CAAC,eAAe,EAAE,iBAAiB,EAAE,CAAC;YAC5C,OAAO,IAAI,CAAC,eAAe,CAAC,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF"}

package/dist/mesh/mesh-connector.d.ts

@@ -0,0 +1,29 @@
+import type { MapAgentConnectionClass, MapConnection } from "../map/map-client.js";
+import type { MeshContextLike } from "./mesh-transport.js";
+/**
+ * Factory for creating MeshTransport connections to remote peers.
+ *
+ * Implements MapAgentConnectionClass so it can be injected into
+ * ConnectionManager alongside (or instead of) the MAP SDK class.
+ *
+ * Usage:
+ * ```ts
+ * const connector = new MeshConnector(mesh, "my-peer-id");
+ * const conn = await connector.connect("remote-peer-id");
+ * ```
+ */
+export declare class MeshConnector implements MapAgentConnectionClass {
+    private mesh;
+    private localPeerId;
+    private channelName;
+    constructor(mesh: MeshContextLike, localPeerId: string, channelName?: string);
+    /**
+     * Create a MeshTransport connection to a remote peer.
+     *
+     * The `server` parameter is the remote peer ID (not a URL).
+     * The `opts` parameter is ignored — mesh peers don't need
+     * MAP handshake parameters.
+     */
+    connect(server: string, _opts?: unknown): Promise<MapConnection>;
+}
+//# sourceMappingURL=mesh-connector.d.ts.map

package/dist/mesh/mesh-connector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-connector.d.ts","sourceRoot":"","sources":["../../src/mesh/mesh-connector.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAG3D;;;;;;;;;;;GAWG;AACH,qBAAa,aAAc,YAAW,uBAAuB;IAEzD,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW;gBAFX,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAA6B;IAGpD;;;;;;OAMG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC;CAUvE"}

package/dist/mesh/mesh-connector.js

@@ -0,0 +1,36 @@
+import { MeshTransport, DEFAULT_CHANNEL_NAME } from "./mesh-transport.js";
+/**
+ * Factory for creating MeshTransport connections to remote peers.
+ *
+ * Implements MapAgentConnectionClass so it can be injected into
+ * ConnectionManager alongside (or instead of) the MAP SDK class.
+ *
+ * Usage:
+ * ```ts
+ * const connector = new MeshConnector(mesh, "my-peer-id");
+ * const conn = await connector.connect("remote-peer-id");
+ * ```
+ */
+export class MeshConnector {
+    mesh;
+    localPeerId;
+    channelName;
+    constructor(mesh, localPeerId, channelName = DEFAULT_CHANNEL_NAME) {
+        this.mesh = mesh;
+        this.localPeerId = localPeerId;
+        this.channelName = channelName;
+    }
+    /**
+     * Create a MeshTransport connection to a remote peer.
+     *
+     * The `server` parameter is the remote peer ID (not a URL).
+     * The `opts` parameter is ignored — mesh peers don't need
+     * MAP handshake parameters.
+     */
+    async connect(server, _opts) {
+        const transport = new MeshTransport(this.mesh, this.localPeerId, server, this.channelName);
+        await transport.open();
+        return transport;
+    }
+}
+//# sourceMappingURL=mesh-connector.js.map

package/dist/mesh/mesh-connector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-connector.js","sourceRoot":"","sources":["../../src/mesh/mesh-connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE1E;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IAEd;IACA;IACA;IAHV,YACU,IAAqB,EACrB,WAAmB,EACnB,cAAsB,oBAAoB;QAF1C,SAAI,GAAJ,IAAI,CAAiB;QACrB,gBAAW,GAAX,WAAW,CAAQ;QACnB,gBAAW,GAAX,WAAW,CAA+B;IACjD,CAAC;IAEJ;;;;;;OAMG;IACH,KAAK,CAAC,OAAO,CAAC,MAAc,EAAE,KAAe;QAC3C,MAAM,SAAS,GAAG,IAAI,aAAa,CACjC,IAAI,CAAC,IAAI,EACT,IAAI,CAAC,WAAW,EAChB,MAAM,EACN,IAAI,CAAC,WAAW,CACjB,CAAC;QACF,MAAM,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,OAAO,SAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/mesh/mesh-transport.d.ts

@@ -0,0 +1,70 @@
+import type { MapConnection, IncomingMapMessage } from "../map/map-client.js";
+/** Subset of agentic-mesh PeerInfo used by MeshTransport. */
+export interface MeshPeerInfo {
+    id: string;
+    name?: string;
+    groups: string[];
+}
+/** Subset of agentic-mesh IMessageChannel<T>. */
+export interface MeshChannel<T> {
+    readonly name: string;
+    readonly isOpen: boolean;
+    open(): Promise<void>;
+    close(): Promise<void>;
+    send(peerId: string, message: T): boolean;
+    on(event: string | symbol, listener: (...args: any[]) => void): this;
+    off(event: string | symbol, listener: (...args: any[]) => void): this;
+}
+/** Subset of agentic-mesh MeshContext used by MeshTransport. */
+export interface MeshContextLike {
+    createChannel<T>(name: string): MeshChannel<T>;
+    _getPeerId(): string;
+}
+/**
+ * Payload exchanged over the mesh channel between agent-inbox instances.
+ * Flat structure that maps 1-to-1 with IncomingMapMessage.
+ */
+export interface InboxWireMessage {
+    to?: {
+        agentId?: string;
+        scope?: string;
+    };
+    payload: unknown;
+    from: string;
+    timestamp?: string;
+    meta?: Record<string, unknown>;
+}
+/** Default channel name used for agent-inbox federation traffic.
+ *  Uses the "proto:" prefix to distinguish protocol channels from
+ *  application channels on the same mesh. */
+export declare const DEFAULT_CHANNEL_NAME = "proto:agent-inbox";
+/**
+ * Implements the MapConnection interface over an agentic-mesh MessageChannel.
+ *
+ * Each instance represents a connection to a single remote peer. Multiple
+ * MeshTransport instances share the same underlying channel (one channel
+ * per mesh, not per peer) and filter incoming messages by remotePeerId.
+ */
+export declare class MeshTransport implements MapConnection {
+    private mesh;
+    private localPeerId;
+    private remotePeerId;
+    private channel;
+    private handlers;
+    private messageListener;
+    private closed;
+    readonly systemName: string;
+    constructor(mesh: MeshContextLike, localPeerId: string, remotePeerId: string, channelName?: string);
+    /**
+     * Open the underlying channel and start listening for messages.
+     * Must be called before send() or onMessage().
+     */
+    open(): Promise<void>;
+    send(to: {
+        agentId?: string;
+        scope?: string;
+    }, payload: unknown, meta?: Record<string, unknown>): Promise<void>;
+    onMessage(handler: (msg: IncomingMapMessage) => void): void;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=mesh-transport.d.ts.map

package/dist/mesh/mesh-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-transport.d.ts","sourceRoot":"","sources":["../../src/mesh/mesh-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EACnB,MAAM,sBAAsB,CAAC;AAS9B,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,iDAAiD;AACjD,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC;IAE1C,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;IAErE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,GAAG,IAAI,CAAC;CACvE;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/C,UAAU,IAAI,MAAM,CAAC;CACtB;AAMD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAMD;;6CAE6C;AAC7C,eAAO,MAAM,oBAAoB,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,qBAAa,aAAc,YAAW,aAAa;IAQ/C,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,YAAY;IATtB,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAA6C;IAC7D,OAAO,CAAC,eAAe,CAA0E;IACjG,OAAO,CAAC,MAAM,CAAS;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;gBAGlB,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EAC5B,WAAW,GAAE,MAA6B;IAM5C;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrB,IAAI,CACR,EAAE,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,EACxC,OAAO,EAAE,OAAO,EAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAmBhB,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,IAAI,GAAG,IAAI;IAIrD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAQlC"}

package/dist/mesh/mesh-transport.js

@@ -0,0 +1,92 @@
+// ---------------------------------------------------------------------------
+// MeshTransport
+// ---------------------------------------------------------------------------
+/** Default channel name used for agent-inbox federation traffic.
+ *  Uses the "proto:" prefix to distinguish protocol channels from
+ *  application channels on the same mesh. */
+export const DEFAULT_CHANNEL_NAME = "proto:agent-inbox";
+/**
+ * Implements the MapConnection interface over an agentic-mesh MessageChannel.
+ *
+ * Each instance represents a connection to a single remote peer. Multiple
+ * MeshTransport instances share the same underlying channel (one channel
+ * per mesh, not per peer) and filter incoming messages by remotePeerId.
+ */
+export class MeshTransport {
+    mesh;
+    localPeerId;
+    remotePeerId;
+    channel;
+    handlers = [];
+    messageListener = null;
+    closed = false;
+    systemName;
+    constructor(mesh, localPeerId, remotePeerId, channelName = DEFAULT_CHANNEL_NAME) {
+        this.mesh = mesh;
+        this.localPeerId = localPeerId;
+        this.remotePeerId = remotePeerId;
+        this.systemName = remotePeerId;
+        this.channel = mesh.createChannel(channelName);
+    }
+    /**
+     * Open the underlying channel and start listening for messages.
+     * Must be called before send() or onMessage().
+     */
+    async open() {
+        if (!this.channel.isOpen) {
+            await this.channel.open();
+        }
+        this.messageListener = (message, from) => {
+            if (this.closed)
+                return;
+            // Only process messages from our remote peer
+            if (from.id !== this.remotePeerId)
+                return;
+            const incoming = wireToIncoming(message);
+            for (const handler of this.handlers) {
+                handler(incoming);
+            }
+        };
+        this.channel.on("message", this.messageListener);
+    }
+    async send(to, payload, meta) {
+        if (this.closed) {
+            throw new Error("MeshTransport is closed");
+        }
+        const wire = {
+            to,
+            payload,
+            from: this.localPeerId,
+            timestamp: new Date().toISOString(),
+            meta,
+        };
+        const sent = this.channel.send(this.remotePeerId, wire);
+        if (!sent) {
+            throw new Error(`Failed to send to peer "${this.remotePeerId}" — peer may be offline`);
+        }
+    }
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    async disconnect() {
+        this.closed = true;
+        if (this.messageListener) {
+            this.channel.off("message", this.messageListener);
+            this.messageListener = null;
+        }
+        this.handlers = [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function wireToIncoming(wire) {
+    return {
+        from: wire.from,
+        to: wire.to,
+        payload: wire.payload,
+        timestamp: wire.timestamp,
+        meta: wire.meta,
+    };
+}
+//# sourceMappingURL=mesh-transport.js.map