macro-agent 0.2.5 → 0.2.6

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

@@ -0,0 +1,263 @@
+/**
+ * LocalPeerTransport - Unix socket-based transport for same-machine peer communication
+ *
+ * Provides an IPC-based implementation of PeerTransport for macro-agents
+ * running on the same machine but in different processes.
+ *
+ * Each peer creates a Unix socket server at a known path (based on peer ID).
+ * To communicate with a peer, it connects to that peer's socket.
+ */
+import * as net from "net";
+import * as fs from "fs";
+import * as path from "path";
+import { nanoid } from "nanoid";
+// ─────────────────────────────────────────────────────────────────
+// LocalPeerTransport
+// ─────────────────────────────────────────────────────────────────
+export class LocalPeerTransport {
+    peerId;
+    socketDir;
+    requestTimeout;
+    server = null;
+    connections = new Map();
+    pendingRequests = new Map();
+    handler = null;
+    constructor(config) {
+        this.peerId = config.peerId;
+        this.socketDir = config.socketDir ?? "/tmp/macro-agent-peers";
+        this.requestTimeout = config.requestTimeout ?? 30000;
+    }
+    /**
+     * Start the transport server and begin listening for connections
+     */
+    async start(handler) {
+        this.handler = handler;
+        // Ensure socket directory exists
+        if (!fs.existsSync(this.socketDir)) {
+            fs.mkdirSync(this.socketDir, { recursive: true });
+        }
+        const socketPath = this.getSocketPath(this.peerId);
+        // Remove stale socket file if it exists
+        if (fs.existsSync(socketPath)) {
+            fs.unlinkSync(socketPath);
+        }
+        return new Promise((resolve, reject) => {
+            this.server = net.createServer((socket) => {
+                this.handleIncomingConnection(socket);
+            });
+            this.server.on("error", (err) => {
+                reject(err);
+            });
+            this.server.listen(socketPath, () => {
+                resolve();
+            });
+        });
+    }
+    /**
+     * Stop the transport server and close all connections
+     */
+    async stop() {
+        // Close all peer connections
+        for (const [peerId, socket] of this.connections) {
+            socket.destroy();
+            this.connections.delete(peerId);
+        }
+        // Close server
+        if (this.server) {
+            return new Promise((resolve) => {
+                this.server.close(() => {
+                    // Clean up socket file
+                    const socketPath = this.getSocketPath(this.peerId);
+                    if (fs.existsSync(socketPath)) {
+                        fs.unlinkSync(socketPath);
+                    }
+                    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.writeMessage(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.writeMessage(socket, wireMessage);
+        });
+    }
+    // ─────────────────────────────────────────────────────────────────
+    // Private Methods
+    // ─────────────────────────────────────────────────────────────────
+    getSocketPath(peerId) {
+        // Sanitize peer ID for use in filename
+        const safePeerId = peerId.replace(/[^a-zA-Z0-9_-]/g, "_");
+        return path.join(this.socketDir, `${safePeerId}.sock`);
+    }
+    extractPeerId(address) {
+        // Address format: "peerId" or "peerId/agentId"
+        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.destroyed) {
+            return existing;
+        }
+        // Create new connection
+        const socketPath = this.getSocketPath(peerId);
+        return new Promise((resolve, reject) => {
+            const socket = net.createConnection(socketPath, () => {
+                this.connections.set(peerId, socket);
+                this.setupSocketHandlers(socket, peerId);
+                resolve(socket);
+            });
+            socket.on("error", (err) => {
+                reject(new Error(`Failed to connect to peer ${peerId}: ${err.message}`));
+            });
+        });
+    }
+    handleIncomingConnection(socket) {
+        let buffer = "";
+        let remotePeerId = null;
+        socket.on("data", (data) => {
+            buffer += data.toString();
+            // Process complete messages (newline-delimited JSON)
+            let newlineIndex;
+            while ((newlineIndex = buffer.indexOf("\n")) !== -1) {
+                const messageStr = buffer.substring(0, newlineIndex);
+                buffer = buffer.substring(newlineIndex + 1);
+                try {
+                    const wireMessage = JSON.parse(messageStr);
+                    // Track the remote peer ID from first message
+                    if (!remotePeerId) {
+                        remotePeerId = this.extractPeerId(wireMessage.from);
+                        this.connections.set(remotePeerId, socket);
+                    }
+                    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) {
+        let buffer = "";
+        socket.on("data", (data) => {
+            buffer += data.toString();
+            let newlineIndex;
+            while ((newlineIndex = buffer.indexOf("\n")) !== -1) {
+                const messageStr = buffer.substring(0, newlineIndex);
+                buffer = buffer.substring(newlineIndex + 1);
+                try {
+                    const wireMessage = JSON.parse(messageStr);
+                    this.handleWireMessage(wireMessage, socket);
+                }
+                catch (err) {
+                    console.error("Failed to parse message:", err);
+                }
+            }
+        });
+        socket.on("close", () => {
+            this.connections.delete(peerId);
+        });
+        socket.on("error", (err) => {
+            console.error(`Socket error for peer ${peerId}:`, err);
+            this.connections.delete(peerId);
+        });
+    }
+    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) => {
+                        // Send response back
+                        const responseMessage = {
+                            type: "response",
+                            id: wireMessage.id, // Use same ID for correlation
+                            from: this.peerId,
+                            payload: response,
+                        };
+                        this.writeMessage(socket, responseMessage);
+                    });
+                }
+                break;
+            case "response":
+                // Resolve pending request
+                const pending = this.pendingRequests.get(wireMessage.id);
+                if (pending) {
+                    clearTimeout(pending.timeout);
+                    this.pendingRequests.delete(wireMessage.id);
+                    pending.resolve(wireMessage.payload);
+                }
+                break;
+        }
+    }
+    writeMessage(socket, message) {
+        // Newline-delimited JSON
+        socket.write(JSON.stringify(message) + "\n");
+    }
+}
+/**
+ * Create a LocalPeerTransport instance
+ */
+export function createLocalTransport(config) {
+    return new LocalPeerTransport(config);
+}
+//# sourceMappingURL=local-transport.js.map

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

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

package/dist/peer/transports/websocket-transport.d.ts

@@ -0,0 +1,86 @@
+/**
+ * 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 type { PeerTransport, PeerHandler, PeerMessage, PeerRequest, PeerResponse, PeerAddress } from "../types.js";
+export interface PeerRegistryEntry {
+    /** Peer's unique ID */
+    peerId: string;
+    /** WebSocket URL to connect to this peer (e.g., "ws://host:port") */
+    url: string;
+}
+export interface WebSocketTransportConfig {
+    /** This peer's unique ID */
+    peerId: string;
+    /** Port to listen on for incoming connections */
+    port: number;
+    /** Host to bind to (defaults to "0.0.0.0") */
+    host?: string;
+    /** Registry of known peers */
+    peerRegistry?: PeerRegistryEntry[];
+    /** Timeout for requests in ms (defaults to 30000) */
+    requestTimeout?: number;
+    /** Reconnection delay in ms (defaults to 5000) */
+    reconnectDelay?: number;
+    /** Maximum reconnection attempts (defaults to 3) */
+    maxReconnectAttempts?: number;
+}
+export declare class WebSocketPeerTransport implements PeerTransport {
+    private peerId;
+    private port;
+    private host;
+    private peerRegistry;
+    private requestTimeout;
+    private reconnectDelay;
+    private maxReconnectAttempts;
+    private server;
+    private connections;
+    private pendingRequests;
+    private handler;
+    private stopped;
+    constructor(config: WebSocketTransportConfig);
+    /**
+     * Add or update a peer in the registry
+     */
+    registerPeer(peerId: string, url: string): void;
+    /**
+     * Remove a peer from the registry
+     */
+    unregisterPeer(peerId: string): void;
+    /**
+     * Start the transport server and begin listening for connections
+     */
+    start(handler: PeerHandler): Promise<void>;
+    /**
+     * Stop the transport server and close all connections
+     */
+    stop(): Promise<void>;
+    /**
+     * Send a message to a peer (fire-and-forget)
+     */
+    sendMessage(to: PeerAddress, message: PeerMessage): Promise<void>;
+    /**
+     * Send a request to a peer and wait for response
+     */
+    sendRequest(to: PeerAddress, request: PeerRequest): Promise<PeerResponse>;
+    private extractPeerId;
+    private getOrCreateConnection;
+    private connectToPeer;
+    private handleIncomingConnection;
+    private setupSocketHandlers;
+    private scheduleReconnect;
+    private handleWireMessage;
+    private sendWireMessage;
+}
+/**
+ * Create a WebSocketPeerTransport instance
+ */
+export declare function createWebSocketTransport(config: WebSocketTransportConfig): WebSocketPeerTransport;
+//# sourceMappingURL=websocket-transport.d.ts.map

package/dist/peer/transports/websocket-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-transport.d.ts","sourceRoot":"","sources":["../../../src/peer/transports/websocket-transport.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,OAAO,KAAK,EACV,aAAa,EACb,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,EACZ,WAAW,EACZ,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,iBAAiB;IAChC,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,qEAAqE;IACrE,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,wBAAwB;IACvC,4BAA4B;IAC5B,MAAM,EAAE,MAAM,CAAC;IAEf,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IAEb,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,8BAA8B;IAC9B,YAAY,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAEnC,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,kDAAkD;IAClD,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,oDAAoD;IACpD,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAwBD,qBAAa,sBAAuB,YAAW,aAAa;IAC1D,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAkC;IACtD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,oBAAoB,CAAS;IAErC,OAAO,CAAC,MAAM,CAAgC;IAC9C,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,eAAe,CAAkD;IACzE,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,OAAO,CAAkB;gBAErB,MAAM,EAAE,wBAAwB;IAgB5C;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAI/C;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IASpC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBhD;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvE;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC;IAoC/E,OAAO,CAAC,aAAa;YAKP,qBAAqB;IAgBnC,OAAO,CAAC,aAAa;IA8BrB,OAAO,CAAC,wBAAwB;IAiDhC,OAAO,CAAC,mBAAmB;IAqB3B,OAAO,CAAC,iBAAiB;IAkCzB,OAAO,CAAC,iBAAiB;IA2CzB,OAAO,CAAC,eAAe;CAOxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,wBAAwB,GAC/B,sBAAsB,CAExB"}