macro-agent 0.2.4 → 0.2.6

package/dist/peer/transports/websocket-transport.js

@@ -0,0 +1,338 @@
+/**
+ * WebSocketPeerTransport - WebSocket-based transport for distributed peer communication
+ *
+ * Provides a WebSocket implementation of PeerTransport for macro-agents
+ * running on different machines across a network.
+ *
+ * Features:
+ * - Config-based peer registry for peer discovery
+ * - Connection pooling and automatic reconnection
+ * - Graceful error handling for network failures
+ */
+import { WebSocket, WebSocketServer } from "ws";
+import { nanoid } from "nanoid";
+// ─────────────────────────────────────────────────────────────────
+// WebSocketPeerTransport
+// ─────────────────────────────────────────────────────────────────
+export class WebSocketPeerTransport {
+    peerId;
+    port;
+    host;
+    peerRegistry = new Map(); // peerId -> url
+    requestTimeout;
+    reconnectDelay;
+    maxReconnectAttempts;
+    server = null;
+    connections = new Map();
+    pendingRequests = new Map();
+    handler = null;
+    stopped = false;
+    constructor(config) {
+        this.peerId = config.peerId;
+        this.port = config.port;
+        this.host = config.host ?? "0.0.0.0";
+        this.requestTimeout = config.requestTimeout ?? 30000;
+        this.reconnectDelay = config.reconnectDelay ?? 5000;
+        this.maxReconnectAttempts = config.maxReconnectAttempts ?? 3;
+        // Populate peer registry
+        if (config.peerRegistry) {
+            for (const entry of config.peerRegistry) {
+                this.peerRegistry.set(entry.peerId, entry.url);
+            }
+        }
+    }
+    /**
+     * Add or update a peer in the registry
+     */
+    registerPeer(peerId, url) {
+        this.peerRegistry.set(peerId, url);
+    }
+    /**
+     * Remove a peer from the registry
+     */
+    unregisterPeer(peerId) {
+        this.peerRegistry.delete(peerId);
+        const conn = this.connections.get(peerId);
+        if (conn) {
+            conn.socket.close();
+            this.connections.delete(peerId);
+        }
+    }
+    /**
+     * Start the transport server and begin listening for connections
+     */
+    async start(handler) {
+        this.handler = handler;
+        this.stopped = false;
+        return new Promise((resolve, reject) => {
+            this.server = new WebSocketServer({
+                port: this.port,
+                host: this.host,
+            });
+            this.server.on("connection", (socket) => {
+                this.handleIncomingConnection(socket);
+            });
+            this.server.on("error", (err) => {
+                reject(err);
+            });
+            this.server.on("listening", () => {
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the transport server and close all connections
+     */
+    async stop() {
+        // Mark as stopped to prevent reconnection attempts
+        this.stopped = true;
+        // Close all peer connections
+        for (const [peerId, conn] of this.connections) {
+            conn.socket.close();
+            this.connections.delete(peerId);
+        }
+        // Close server
+        if (this.server) {
+            return new Promise((resolve) => {
+                this.server.close(() => {
+                    this.server = null;
+                    resolve();
+                });
+            });
+        }
+    }
+    /**
+     * Send a message to a peer (fire-and-forget)
+     */
+    async sendMessage(to, message) {
+        const peerId = this.extractPeerId(to);
+        const socket = await this.getOrCreateConnection(peerId);
+        const wireMessage = {
+            type: "message",
+            id: `msg_${nanoid(12)}`,
+            from: this.peerId,
+            payload: message,
+        };
+        this.sendWireMessage(socket, wireMessage);
+    }
+    /**
+     * Send a request to a peer and wait for response
+     */
+    async sendRequest(to, request) {
+        const peerId = this.extractPeerId(to);
+        const socket = await this.getOrCreateConnection(peerId);
+        const requestId = `req_${nanoid(12)}`;
+        const wireMessage = {
+            type: "request",
+            id: requestId,
+            from: this.peerId,
+            payload: request,
+        };
+        return new Promise((resolve) => {
+            // Set up timeout
+            const timeout = setTimeout(() => {
+                this.pendingRequests.delete(requestId);
+                resolve({
+                    error: {
+                        code: -32000,
+                        message: "Request timeout",
+                    },
+                });
+            }, request.timeout ?? this.requestTimeout);
+            // Store pending request
+            this.pendingRequests.set(requestId, { resolve, timeout });
+            // Send request
+            this.sendWireMessage(socket, wireMessage);
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Private Methods
+    // ─────────────────────────────────────────────────────────────────
+    extractPeerId(address) {
+        const slashIndex = address.indexOf("/");
+        return slashIndex === -1 ? address : address.substring(0, slashIndex);
+    }
+    async getOrCreateConnection(peerId) {
+        // Check for existing connection
+        const existing = this.connections.get(peerId);
+        if (existing && existing.socket.readyState === WebSocket.OPEN) {
+            return existing.socket;
+        }
+        // Look up peer URL in registry
+        const url = this.peerRegistry.get(peerId);
+        if (!url) {
+            throw new Error(`Unknown peer: ${peerId}. Add to peer registry first.`);
+        }
+        return this.connectToPeer(peerId, url);
+    }
+    connectToPeer(peerId, url) {
+        return new Promise((resolve, reject) => {
+            const socket = new WebSocket(url);
+            socket.on("open", () => {
+                // Send identification message
+                const identifyMessage = {
+                    type: "identify",
+                    id: `id_${nanoid(12)}`,
+                    from: this.peerId,
+                    payload: { peerId: this.peerId },
+                };
+                this.sendWireMessage(socket, identifyMessage);
+                this.connections.set(peerId, {
+                    socket,
+                    peerId,
+                    reconnectAttempts: 0,
+                });
+                this.setupSocketHandlers(socket, peerId);
+                resolve(socket);
+            });
+            socket.on("error", (err) => {
+                reject(new Error(`Failed to connect to peer ${peerId}: ${err.message}`));
+            });
+        });
+    }
+    handleIncomingConnection(socket) {
+        let remotePeerId = null;
+        socket.on("message", (data) => {
+            try {
+                const wireMessage = JSON.parse(data.toString());
+                // Handle identification
+                if (wireMessage.type === "identify") {
+                    const payload = wireMessage.payload;
+                    remotePeerId = payload.peerId;
+                    this.connections.set(remotePeerId, {
+                        socket,
+                        peerId: remotePeerId,
+                        reconnectAttempts: 0,
+                    });
+                    return;
+                }
+                // Track peer ID from messages
+                if (!remotePeerId) {
+                    remotePeerId = this.extractPeerId(wireMessage.from);
+                    this.connections.set(remotePeerId, {
+                        socket,
+                        peerId: remotePeerId,
+                        reconnectAttempts: 0,
+                    });
+                }
+                this.handleWireMessage(wireMessage, socket);
+            }
+            catch (err) {
+                console.error("Failed to parse incoming message:", err);
+            }
+        });
+        socket.on("close", () => {
+            if (remotePeerId) {
+                this.connections.delete(remotePeerId);
+            }
+        });
+        socket.on("error", (err) => {
+            console.error("Socket error:", err);
+            if (remotePeerId) {
+                this.connections.delete(remotePeerId);
+            }
+        });
+    }
+    setupSocketHandlers(socket, peerId) {
+        socket.on("message", (data) => {
+            try {
+                const wireMessage = JSON.parse(data.toString());
+                this.handleWireMessage(wireMessage, socket);
+            }
+            catch (err) {
+                console.error("Failed to parse message:", err);
+            }
+        });
+        socket.on("close", () => {
+            this.connections.delete(peerId);
+            this.scheduleReconnect(peerId);
+        });
+        socket.on("error", (err) => {
+            console.error(`Socket error for peer ${peerId}:`, err);
+            this.connections.delete(peerId);
+        });
+    }
+    scheduleReconnect(peerId) {
+        // Don't reconnect if transport is stopped
+        if (this.stopped)
+            return;
+        const url = this.peerRegistry.get(peerId);
+        if (!url)
+            return;
+        const existingConn = this.connections.get(peerId);
+        const attempts = existingConn?.reconnectAttempts ?? 0;
+        if (attempts >= this.maxReconnectAttempts) {
+            console.log(`Max reconnection attempts reached for peer ${peerId}`);
+            return;
+        }
+        setTimeout(async () => {
+            // Check again in case transport was stopped while waiting
+            if (this.stopped)
+                return;
+            try {
+                await this.connectToPeer(peerId, url);
+                console.log(`Reconnected to peer ${peerId}`);
+            }
+            catch (err) {
+                console.error(`Reconnection failed for peer ${peerId}:`, err);
+                // Update reconnect attempts
+                const conn = this.connections.get(peerId);
+                if (conn) {
+                    conn.reconnectAttempts = attempts + 1;
+                }
+                this.scheduleReconnect(peerId);
+            }
+        }, this.reconnectDelay);
+    }
+    handleWireMessage(wireMessage, socket) {
+        switch (wireMessage.type) {
+            case "message":
+                if (this.handler) {
+                    this.handler.handleMessage(wireMessage.from, wireMessage.payload);
+                }
+                break;
+            case "request":
+                if (this.handler) {
+                    const request = wireMessage.payload;
+                    this.handler
+                        .handleRequest(wireMessage.from, request)
+                        .then((response) => {
+                        const responseMessage = {
+                            type: "response",
+                            id: wireMessage.id,
+                            from: this.peerId,
+                            payload: response,
+                        };
+                        this.sendWireMessage(socket, responseMessage);
+                    });
+                }
+                break;
+            case "response":
+                const pending = this.pendingRequests.get(wireMessage.id);
+                if (pending) {
+                    clearTimeout(pending.timeout);
+                    this.pendingRequests.delete(wireMessage.id);
+                    pending.resolve(wireMessage.payload);
+                }
+                break;
+            case "identify":
+                // Already handled in connection setup
+                break;
+        }
+    }
+    sendWireMessage(socket, message) {
+        if (socket.readyState === WebSocket.OPEN) {
+            socket.send(JSON.stringify(message));
+        }
+        else {
+            console.error("Cannot send message: socket not open");
+        }
+    }
+}
+/**
+ * Create a WebSocketPeerTransport instance
+ */
+export function createWebSocketTransport(config) {
+    return new WebSocketPeerTransport(config);
+}
+//# sourceMappingURL=websocket-transport.js.map

package/dist/peer/transports/websocket-transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.js","sourceRoot":"","sources":["../../../src/peer/transports/websocket-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,IAAI,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AA+DhC,oEAAoE;AACpE,yBAAyB;AACzB,oEAAoE;AAEpE,MAAM,OAAO,sBAAsB;IACzB,MAAM,CAAS;IACf,IAAI,CAAS;IACb,IAAI,CAAS;IACb,YAAY,GAAwB,IAAI,GAAG,EAAE,CAAC,CAAC,gBAAgB;IAC/D,cAAc,CAAS;IACvB,cAAc,CAAS;IACvB,oBAAoB,CAAS;IAE7B,MAAM,GAA2B,IAAI,CAAC;IACtC,WAAW,GAAgC,IAAI,GAAG,EAAE,CAAC;IACrD,eAAe,GAAwC,IAAI,GAAG,EAAE,CAAC;IACjE,OAAO,GAAuB,IAAI,CAAC;IACnC,OAAO,GAAY,KAAK,CAAC;IAEjC,YAAY,MAAgC;QAC1C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,SAAS,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,KAAK,CAAC;QACrD,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,IAAI,CAAC;QACpD,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,oBAAoB,IAAI,CAAC,CAAC;QAE7D,yBAAyB;QACzB,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;YACxB,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;gBACxC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAc,EAAE,GAAW;QACtC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc;QAC3B,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,IAAI,EAAE,CAAC;YACT,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,OAAoB;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QAErB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAe,CAAC;gBAChC,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI,EAAE,IAAI,CAAC,IAAI;aAChB,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,MAAM,EAAE,EAAE;gBACtC,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBAC9B,MAAM,CAAC,GAAG,CAAC,CAAC;YACd,CAAC,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;gBAC/B,OAAO,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,mDAAmD;QACnD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QAEpB,6BAA6B;QAC7B,KAAK,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YACpB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,eAAe;QACf,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;gBAC7B,IAAI,CAAC,MAAO,CAAC,KAAK,CAAC,GAAG,EAAE;oBACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;oBACnB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,EAAe,EAAE,OAAoB;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAExD,MAAM,WAAW,GAAgB;YAC/B,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE;YACvB,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,OAAO,EAAE,OAAO;SACjB,CAAC;QAEF,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW,CAAC,EAAe,EAAE,OAAoB;QACrD,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;QACtC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,CAAC;QAExD,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACtC,MAAM,WAAW,GAAgB;YAC/B,IAAI,EAAE,SAAS;YACf,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,OAAO,EAAE,OAAO;SACjB,CAAC;QAEF,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,iBAAiB;YACjB,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;gBAC9B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACvC,OAAO,CAAC;oBACN,KAAK,EAAE;wBACL,IAAI,EAAE,CAAC,KAAK;wBACZ,OAAO,EAAE,iBAAiB;qBAC3B;iBACF,CAAC,CAAC;YACL,CAAC,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,CAAC;YAE3C,wBAAwB;YACxB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;YAE1D,eAAe;YACf,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,oEAAoE;IACpE,kBAAkB;IAClB,oEAAoE;IAE5D,aAAa,CAAC,OAAoB;QACxC,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACxC,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;IACxE,CAAC;IAEO,KAAK,CAAC,qBAAqB,CAAC,MAAc;QAChD,gCAAgC;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YAC9D,OAAO,QAAQ,CAAC,MAAM,CAAC;QACzB,CAAC;QAED,+BAA+B;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CAAC,iBAAiB,MAAM,+BAA+B,CAAC,CAAC;QAC1E,CAAC;QAED,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAEO,aAAa,CAAC,MAAc,EAAE,GAAW;QAC/C,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC;YAElC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;gBACrB,8BAA8B;gBAC9B,MAAM,eAAe,GAAgB;oBACnC,IAAI,EAAE,UAAU;oBAChB,EAAE,EAAE,MAAM,MAAM,CAAC,EAAE,CAAC,EAAE;oBACtB,IAAI,EAAE,IAAI,CAAC,MAAM;oBACjB,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE;iBACjC,CAAC;gBACF,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;gBAE9C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,EAAE;oBAC3B,MAAM;oBACN,MAAM;oBACN,iBAAiB,EAAE,CAAC;iBACrB,CAAC,CAAC;gBAEH,IAAI,CAAC,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBACzC,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACzB,MAAM,CAAC,IAAI,KAAK,CAAC,6BAA6B,MAAM,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YAC3E,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,wBAAwB,CAAC,MAAiB;QAChD,IAAI,YAAY,GAAkB,IAAI,CAAC;QAEvC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAE7D,wBAAwB;gBACxB,IAAI,WAAW,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;oBACpC,MAAM,OAAO,GAAG,WAAW,CAAC,OAA6B,CAAC;oBAC1D,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;oBAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE;wBACjC,MAAM;wBACN,MAAM,EAAE,YAAY;wBACpB,iBAAiB,EAAE,CAAC;qBACrB,CAAC,CAAC;oBACH,OAAO;gBACT,CAAC;gBAED,8BAA8B;gBAC9B,IAAI,CAAC,YAAY,EAAE,CAAC;oBAClB,YAAY,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;oBACpD,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,YAAY,EAAE;wBACjC,MAAM;wBACN,MAAM,EAAE,YAAY;wBACpB,iBAAiB,EAAE,CAAC;qBACrB,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,GAAG,CAAC,CAAC;YAC1D,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC;YACpC,IAAI,YAAY,EAAE,CAAC;gBACjB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,mBAAmB,CAAC,MAAiB,EAAE,MAAc;QAC3D,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAC5B,IAAI,CAAC;gBACH,MAAM,WAAW,GAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAC7D,IAAI,CAAC,iBAAiB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC9C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,0BAA0B,EAAE,GAAG,CAAC,CAAC;YACjD,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;YACtB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YAChC,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACzB,OAAO,CAAC,KAAK,CAAC,yBAAyB,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;YACvD,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CAAC,MAAc;QACtC,0CAA0C;QAC1C,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,GAAG;YAAE,OAAO;QAEjB,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,YAAY,EAAE,iBAAiB,IAAI,CAAC,CAAC;QAEtD,IAAI,QAAQ,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1C,OAAO,CAAC,GAAG,CAAC,8CAA8C,MAAM,EAAE,CAAC,CAAC;YACpE,OAAO;QACT,CAAC;QAED,UAAU,CAAC,KAAK,IAAI,EAAE;YACpB,0DAA0D;YAC1D,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO;YAEzB,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBACtC,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,EAAE,CAAC,CAAC;YAC/C,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,KAAK,CAAC,gCAAgC,MAAM,GAAG,EAAE,GAAG,CAAC,CAAC;gBAC9D,4BAA4B;gBAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;gBAC1C,IAAI,IAAI,EAAE,CAAC;oBACT,IAAI,CAAC,iBAAiB,GAAG,QAAQ,GAAG,CAAC,CAAC;gBACxC,CAAC;gBACD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;YACjC,CAAC;QACH,CAAC,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1B,CAAC;IAEO,iBAAiB,CAAC,WAAwB,EAAE,MAAiB;QACnE,QAAQ,WAAW,CAAC,IAAI,EAAE,CAAC;YACzB,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,IAAI,CAAC,OAAO,CAAC,aAAa,CACxB,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,OAAsB,CACnC,CAAC;gBACJ,CAAC;gBACD,MAAM;YAER,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;oBACjB,MAAM,OAAO,GAAG,WAAW,CAAC,OAAsB,CAAC;oBACnD,IAAI,CAAC,OAAO;yBACT,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC;yBACxC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE;wBACjB,MAAM,eAAe,GAAgB;4BACnC,IAAI,EAAE,UAAU;4BAChB,EAAE,EAAE,WAAW,CAAC,EAAE;4BAClB,IAAI,EAAE,IAAI,CAAC,MAAM;4BACjB,OAAO,EAAE,QAAQ;yBAClB,CAAC;wBACF,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;oBAChD,CAAC,CAAC,CAAC;gBACP,CAAC;gBACD,MAAM;YAER,KAAK,UAAU;gBACb,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;gBACzD,IAAI,OAAO,EAAE,CAAC;oBACZ,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;oBAC9B,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;oBAC5C,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,OAAuB,CAAC,CAAC;gBACvD,CAAC;gBACD,MAAM;YAER,KAAK,UAAU;gBACb,sCAAsC;gBACtC,MAAM;QACV,CAAC;IACH,CAAC;IAEO,eAAe,CAAC,MAAiB,EAAE,OAAoB;QAC7D,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,IAAI,EAAE,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CACtC,MAAgC;IAEhC,OAAO,IAAI,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAC5C,CAAC"}

package/dist/peer/types.d.ts

@@ -0,0 +1,268 @@
+/**
+ * Peer communication type definitions
+ *
+ * These types define the interfaces for inter-macro-agent communication.
+ * The design is transport-agnostic - the client injects the actual transport
+ * implementation via callbacks.
+ */
+import type { AgentId } from "../store/types/index.js";
+/**
+ * Peer address format: "peerId" or "peerId/agentId"
+ * - "peerId" routes to the root agent of that peer
+ * - "peerId/agentId" routes to a specific internal agent within the peer
+ */
+export type PeerAddress = string;
+/**
+ * Parsed peer address
+ */
+export interface ParsedPeerAddress {
+    peerId: string;
+    agentId?: AgentId;
+}
+/**
+ * Message sent between peers (fire-and-forget)
+ */
+export interface PeerMessage {
+    /** Message type for routing/handling */
+    type: string;
+    /** Message payload */
+    payload: unknown;
+    /** Optional metadata */
+    metadata?: {
+        /** Correlation ID for relating messages to requests/tasks */
+        correlationId?: string;
+        /** Timestamp when message was created */
+        timestamp?: number;
+        /** Additional metadata */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Request sent to a peer (expects response)
+ */
+export interface PeerRequest {
+    /** Request method name */
+    method: string;
+    /** Request parameters */
+    params?: unknown;
+    /** Timeout hint in milliseconds (not enforced by macro-agent) */
+    timeout?: number;
+}
+/**
+ * Response from a peer request
+ */
+export interface PeerResponse {
+    /** Success result */
+    result?: unknown;
+    /** Error if request failed */
+    error?: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+/**
+ * Transport interface that the client provides to macro-agent.
+ * The client is responsible for the actual network/IPC communication.
+ */
+export interface PeerTransport {
+    /**
+     * Send a fire-and-forget message to a peer.
+     * @param address - Peer address ("peerId" or "peerId/agentId")
+     * @param message - The message to send
+     */
+    sendMessage(address: PeerAddress, message: PeerMessage): Promise<void>;
+    /**
+     * Send a request to a peer and wait for response.
+     * @param address - Peer address ("peerId" or "peerId/agentId")
+     * @param request - The request to send
+     * @returns The peer's response
+     */
+    sendRequest(address: PeerAddress, request: PeerRequest): Promise<PeerResponse>;
+}
+/**
+ * Handler interface that macro-agent provides to the client for routing inbound messages.
+ */
+export interface PeerHandler {
+    /**
+     * Handle an inbound message from a peer.
+     * @param from - Source peer address
+     * @param message - The received message
+     */
+    handleMessage(from: PeerAddress, message: PeerMessage): void;
+    /**
+     * Handle an inbound request from a peer.
+     * @param from - Source peer address
+     * @param request - The received request
+     * @returns Response to send back to the peer
+     */
+    handleRequest(from: PeerAddress, request: PeerRequest): Promise<PeerResponse>;
+}
+/**
+ * Configuration for peer message persistence
+ */
+export interface PeerConfig {
+    /** Whether to persist peer messages in EventStore (default: false) */
+    persistMessages?: boolean;
+    /** Whether to persist peer requests in EventStore (default: false) */
+    persistRequests?: boolean;
+    /** Default timeout for requests in milliseconds (default: 30000) */
+    defaultRequestTimeout?: number;
+}
+/**
+ * Internal representation of a pending request
+ */
+export interface PendingRequest {
+    /** Unique request ID */
+    requestId: string;
+    /** Source peer address */
+    from: PeerAddress;
+    /** The request */
+    request: PeerRequest;
+    /** Resolve function for the response promise */
+    resolve: (response: PeerResponse) => void;
+    /** Timeout handle */
+    timeout: ReturnType<typeof setTimeout>;
+    /** Target agent ID within this macro-agent */
+    targetAgentId: AgentId;
+    /** Timestamp when request was received */
+    timestamp: number;
+}
+/**
+ * Message as it appears in an agent's inbox (with peer source prefix)
+ */
+export interface PeerInboxMessage {
+    /** Original message ID or generated ID */
+    id: string;
+    /** Source in format "peer:peerId" or "peer:peerId/agentId" */
+    from: string;
+    /** Message type */
+    type: string;
+    /** Message payload */
+    payload: unknown;
+    /** Timestamp */
+    timestamp: number;
+    /** Correlation ID if provided */
+    correlationId?: string;
+    /** Whether this is a request requiring a response */
+    isRequest?: boolean;
+    /** Request ID if this is a request */
+    requestId?: string;
+}
+/**
+ * Error thrown when peer operations fail
+ */
+export declare class PeerError extends Error {
+    readonly code: PeerErrorCode;
+    readonly details?: unknown | undefined;
+    constructor(message: string, code: PeerErrorCode, details?: unknown | undefined);
+}
+export type PeerErrorCode = "NO_TRANSPORT" | "INVALID_ADDRESS" | "AGENT_NOT_FOUND" | "REQUEST_TIMEOUT" | "REQUEST_NOT_FOUND" | "TRANSPORT_ERROR" | "CAPABILITY_DENIED";
+/**
+ * Capability grant for task delegation pattern.
+ * Allows a peer to delegate discrete tasks.
+ */
+export interface TaskDelegationCapability {
+    type: "task-delegation";
+    /** Maximum concurrent tasks this peer can delegate (optional) */
+    maxConcurrentTasks?: number;
+}
+/**
+ * Capability grant for federated hierarchy pattern.
+ * Allows establishing parent-child relationships.
+ */
+export interface FederatedHierarchyCapability {
+    type: "federated-hierarchy";
+    /** Can query the agent hierarchy */
+    canQueryAgents: boolean;
+    /** Can mount remote agents locally */
+    canMount: boolean;
+    /** Can subscribe to status updates */
+    canSubscribeStatus: boolean;
+    /** Restrict to specific agent IDs (optional) */
+    allowedAgentIds?: string[];
+}
+/**
+ * Capability grant for transparent encapsulation pattern.
+ * Allows registering as encapsulated child or accepting encapsulated children.
+ */
+export interface EncapsulationCapability {
+    type: "encapsulation";
+    /** Can register as an encapsulated child */
+    canActAsChild: boolean;
+    /** Can accept encapsulated children */
+    canActAsParent: boolean;
+}
+/**
+ * Union of all capability grant types
+ */
+export type CapabilityGrant = TaskDelegationCapability | FederatedHierarchyCapability | EncapsulationCapability;
+/**
+ * Type helper to extract capability type string
+ */
+export type CapabilityType = CapabilityGrant["type"];
+/**
+ * Full capability set for a peer
+ */
+export interface PeerCapabilities {
+    /** Peer ID these capabilities apply to */
+    peerId: string;
+    /** Granted capabilities */
+    grants: CapabilityGrant[];
+    /** When capabilities were issued (ms since epoch) */
+    issuedAt: number;
+    /** When capabilities expire (ms since epoch, optional) */
+    expiresAt?: number;
+    /** Who issued these capabilities (for audit trail) */
+    issuedBy?: string;
+}
+/**
+ * Options for granting capabilities
+ */
+export interface GrantCapabilityOptions {
+    /** Time until expiration in milliseconds */
+    expiresIn?: number;
+    /** Issuer identifier for audit trail */
+    issuedBy?: string;
+}
+/**
+ * Disconnect behavior options for federation
+ */
+export type FederationDisconnectBehavior = "orphan" | "abort" | "reconnect";
+/**
+ * Configuration for federation failure handling
+ */
+export interface FederationConfig {
+    /** Behavior when parent disconnects (for child) */
+    onParentDisconnect: FederationDisconnectBehavior;
+    /** Behavior when child disconnects (for parent) */
+    onChildDisconnect: FederationDisconnectBehavior;
+    /** Timeout in ms before giving up on reconnection */
+    reconnectTimeout?: number;
+    /** Maximum reconnection attempts */
+    maxReconnectAttempts?: number;
+}
+/**
+ * Error detail level for encapsulation facade
+ */
+export type ErrorDetailLevel = "opaque" | "summary" | "full";
+/**
+ * Configuration for encapsulation facade
+ */
+export interface FacadeConfig {
+    /** How much error detail to expose to parent */
+    errorDetail: ErrorDetailLevel;
+    /** Display name in parent's hierarchy */
+    name?: string;
+    /** Advertised capabilities */
+    capabilities?: string[];
+}
+/**
+ * Default federation configuration
+ */
+export declare const DEFAULT_FEDERATION_CONFIG: FederationConfig;
+/**
+ * Default facade configuration
+ */
+export declare const DEFAULT_FACADE_CONFIG: FacadeConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/peer/types.d.ts.map

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

package/dist/peer/types.js

@@ -0,0 +1,36 @@
+/**
+ * Peer communication type definitions
+ *
+ * These types define the interfaces for inter-macro-agent communication.
+ * The design is transport-agnostic - the client injects the actual transport
+ * implementation via callbacks.
+ */
+/**
+ * Error thrown when peer operations fail
+ */
+export class PeerError extends Error {
+    code;
+    details;
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = "PeerError";
+    }
+}
+/**
+ * Default federation configuration
+ */
+export const DEFAULT_FEDERATION_CONFIG = {
+    onParentDisconnect: "orphan",
+    onChildDisconnect: "orphan",
+    reconnectTimeout: 30000,
+    maxReconnectAttempts: 3,
+};
+/**
+ * Default facade configuration
+ */
+export const DEFAULT_FACADE_CONFIG = {
+    errorDetail: "summary",
+};
+//# sourceMappingURL=types.js.map

package/dist/peer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/peer/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA+JH;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAGhB;IACA;IAHlB,YACE,OAAe,EACC,IAAmB,EACnB,OAAiB;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAe;QACnB,YAAO,GAAP,OAAO,CAAU;QAGjC,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC;IAC1B,CAAC;CACF;AA0ID;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAqB;IACzD,kBAAkB,EAAE,QAAQ;IAC5B,iBAAiB,EAAE,QAAQ;IAC3B,gBAAgB,EAAE,KAAK;IACvB,oBAAoB,EAAE,CAAC;CACxB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,WAAW,EAAE,SAAS;CACvB,CAAC"}