agent-relay 1.0.8 → 1.0.11

package/dist/bridge/multi-project-client.js

@@ -0,0 +1,386 @@
+/**
+ * MultiProjectClient
+ * Connects to multiple project daemons simultaneously for cross-project orchestration.
+ */
+import net from 'node:net';
+import fs from 'node:fs';
+import { v4 as uuid } from 'uuid';
+import { PROTOCOL_VERSION, } from '../protocol/types.js';
+import { encodeFrame, FrameParser } from '../protocol/framing.js';
+export class MultiProjectClient {
+    projects;
+    connections = new Map();
+    leads = new Map();
+    options;
+    shuttingDown = false;
+    /** Handler for incoming messages */
+    onMessage;
+    /** Handler for connection state changes */
+    onProjectStateChange;
+    constructor(projects, options = {}) {
+        this.projects = projects;
+        this.options = {
+            agentName: options.agentName ?? '__BridgeClient',
+            reconnect: options.reconnect ?? true,
+            reconnectDelay: options.reconnectDelay ?? 1000,
+            maxReconnectDelay: options.maxReconnectDelay ?? 30000,
+            maxReconnectAttempts: options.maxReconnectAttempts ?? Infinity,
+        };
+    }
+    /**
+     * Connect to all project daemons
+     */
+    async connect() {
+        const connectPromises = this.projects.map((project) => this.connectToProject(project));
+        await Promise.all(connectPromises);
+    }
+    /**
+     * Connect to a single project daemon
+     */
+    connectToProject(project) {
+        return new Promise((resolve, reject) => {
+            // Check socket exists
+            if (!fs.existsSync(project.socketPath)) {
+                console.error(`[bridge] No daemon running for ${project.id} (${project.path})`);
+                console.error(`[bridge] Start with: cd ${project.path} && agent-relay up`);
+                reject(new Error(`No daemon for ${project.id}`));
+                return;
+            }
+            const socket = net.createConnection(project.socketPath, () => {
+                this.sendHello(conn);
+            });
+            const conn = {
+                config: project,
+                socket,
+                parser: new FrameParser(),
+                ready: false,
+            };
+            socket.on('data', (data) => this.handleData(conn, data));
+            socket.on('close', () => {
+                const wasReady = conn.ready;
+                conn.ready = false;
+                this.onProjectStateChange?.(project.id, false);
+                // Attempt reconnection if enabled and not shutting down
+                if (wasReady && this.options.reconnect && !this.shuttingDown) {
+                    this.scheduleReconnect(conn);
+                }
+            });
+            socket.on('error', (err) => {
+                console.error(`[bridge] Connection error for ${project.id}:`, err.message);
+                if (!conn.ready) {
+                    reject(err);
+                }
+            });
+            this.connections.set(project.id, conn);
+            // Wait for ready
+            const checkReady = setInterval(() => {
+                if (conn.ready) {
+                    clearInterval(checkReady);
+                    clearTimeout(timeout);
+                    resolve();
+                }
+            }, 10);
+            const timeout = setTimeout(() => {
+                if (!conn.ready) {
+                    clearInterval(checkReady);
+                    socket.destroy();
+                    reject(new Error(`Connection timeout for ${project.id}`));
+                }
+            }, 5000);
+        });
+    }
+    /**
+     * Send HELLO to a project daemon
+     */
+    sendHello(conn) {
+        const hello = {
+            v: PROTOCOL_VERSION,
+            type: 'HELLO',
+            id: uuid(),
+            ts: Date.now(),
+            payload: {
+                agent: this.options.agentName,
+                cli: 'bridge',
+                capabilities: {
+                    ack: true,
+                    resume: false,
+                    max_inflight: 256,
+                    supports_topics: true,
+                },
+            },
+        };
+        this.send(conn, hello);
+    }
+    /**
+     * Handle incoming data from a project connection
+     */
+    handleData(conn, data) {
+        try {
+            const frames = conn.parser.push(data);
+            for (const frame of frames) {
+                this.processFrame(conn, frame);
+            }
+        }
+        catch (err) {
+            console.error(`[bridge] Parse error for ${conn.config.id}:`, err);
+        }
+    }
+    /**
+     * Process a frame from a project daemon
+     */
+    processFrame(conn, envelope) {
+        switch (envelope.type) {
+            case 'WELCOME':
+                conn.ready = true;
+                console.log(`[bridge] Connected to ${conn.config.id}`);
+                this.onProjectStateChange?.(conn.config.id, true);
+                break;
+            case 'DELIVER':
+                this.handleDeliver(conn, envelope);
+                break;
+            case 'PING':
+                this.send(conn, {
+                    v: PROTOCOL_VERSION,
+                    type: 'PONG',
+                    id: uuid(),
+                    ts: Date.now(),
+                    payload: envelope.payload ?? {},
+                });
+                break;
+        }
+    }
+    /**
+     * Handle delivered message from a project
+     */
+    handleDeliver(conn, envelope) {
+        // Send ACK
+        this.send(conn, {
+            v: PROTOCOL_VERSION,
+            type: 'ACK',
+            id: uuid(),
+            ts: Date.now(),
+            payload: {
+                ack_id: envelope.id,
+                seq: envelope.delivery.seq,
+            },
+        });
+        // Notify handler
+        if (this.onMessage && envelope.from) {
+            this.onMessage(conn.config.id, envelope.from, envelope.payload, envelope.id);
+        }
+    }
+    /**
+     * Send envelope to a project daemon
+     */
+    send(conn, envelope) {
+        if (!conn.socket)
+            return false;
+        try {
+            const frame = encodeFrame(envelope);
+            conn.socket.write(frame);
+            return true;
+        }
+        catch (err) {
+            console.error(`[bridge] Send error for ${conn.config.id}:`, err);
+            return false;
+        }
+    }
+    /**
+     * Send message to a project
+     * @param projectId - Target project ID
+     * @param to - Agent name within the project (or '*' for broadcast, 'lead' for project lead)
+     * @param body - Message body
+     */
+    sendToProject(projectId, to, body) {
+        const conn = this.connections.get(projectId);
+        if (!conn?.ready) {
+            console.error(`[bridge] Cannot send to ${projectId}: not connected`);
+            return false;
+        }
+        // Resolve 'lead' to actual lead name
+        let targetAgent = to;
+        if (to === 'lead') {
+            const lead = this.leads.get(projectId);
+            if (lead) {
+                targetAgent = lead.name;
+            }
+            else {
+                // Fallback to configured lead name
+                targetAgent = conn.config.leadName;
+            }
+        }
+        const envelope = {
+            v: PROTOCOL_VERSION,
+            type: 'SEND',
+            id: uuid(),
+            ts: Date.now(),
+            to: targetAgent,
+            payload: {
+                kind: 'message',
+                body,
+            },
+        };
+        return this.send(conn, envelope);
+    }
+    /**
+     * Broadcast to all leads
+     */
+    broadcastToLeads(body) {
+        for (const [projectId] of this.connections) {
+            this.sendToProject(projectId, 'lead', body);
+        }
+    }
+    /**
+     * Broadcast to all agents in all projects
+     */
+    broadcastAll(body) {
+        for (const [projectId, conn] of this.connections) {
+            if (conn.ready) {
+                const envelope = {
+                    v: PROTOCOL_VERSION,
+                    type: 'SEND',
+                    id: uuid(),
+                    ts: Date.now(),
+                    to: '*',
+                    payload: {
+                        kind: 'message',
+                        body,
+                    },
+                };
+                this.send(conn, envelope);
+            }
+        }
+    }
+    /**
+     * Register a lead for a project
+     */
+    registerLead(projectId, leadName) {
+        this.leads.set(projectId, {
+            name: leadName,
+            projectId,
+            connected: true,
+        });
+    }
+    /**
+     * Get all connected projects
+     */
+    getConnectedProjects() {
+        return Array.from(this.connections.entries())
+            .filter(([_, conn]) => conn.ready)
+            .map(([id]) => id);
+    }
+    /**
+     * Get project connection info
+     */
+    getProject(projectId) {
+        return this.connections.get(projectId)?.config;
+    }
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    scheduleReconnect(conn) {
+        if (conn.reconnecting || this.shuttingDown)
+            return;
+        const attempts = conn.reconnectAttempts ?? 0;
+        if (attempts >= this.options.maxReconnectAttempts) {
+            console.error(`[bridge] Max reconnection attempts reached for ${conn.config.id}`);
+            return;
+        }
+        conn.reconnecting = true;
+        conn.reconnectAttempts = attempts + 1;
+        // Calculate delay with exponential backoff
+        const delay = Math.min(this.options.reconnectDelay * Math.pow(2, attempts), this.options.maxReconnectDelay);
+        console.log(`[bridge] Reconnecting to ${conn.config.id} in ${delay}ms (attempt ${conn.reconnectAttempts})`);
+        conn.reconnectTimer = setTimeout(() => {
+            this.attemptReconnect(conn);
+        }, delay);
+    }
+    /**
+     * Attempt to reconnect to a project daemon
+     */
+    attemptReconnect(conn) {
+        if (this.shuttingDown) {
+            conn.reconnecting = false;
+            return;
+        }
+        // Check socket exists
+        if (!fs.existsSync(conn.config.socketPath)) {
+            console.error(`[bridge] No daemon running for ${conn.config.id}, will retry`);
+            conn.reconnecting = false;
+            this.scheduleReconnect(conn);
+            return;
+        }
+        const socket = net.createConnection(conn.config.socketPath, () => {
+            this.sendHello(conn);
+        });
+        // Update connection with new socket
+        conn.socket = socket;
+        conn.parser = new FrameParser();
+        socket.on('data', (data) => this.handleData(conn, data));
+        socket.on('close', () => {
+            const wasReady = conn.ready;
+            conn.ready = false;
+            this.onProjectStateChange?.(conn.config.id, false);
+            if (wasReady && this.options.reconnect && !this.shuttingDown) {
+                this.scheduleReconnect(conn);
+            }
+        });
+        socket.on('error', (err) => {
+            console.error(`[bridge] Reconnection error for ${conn.config.id}:`, err.message);
+            conn.reconnecting = false;
+            if (!this.shuttingDown) {
+                this.scheduleReconnect(conn);
+            }
+        });
+        // Reset reconnection state on successful connect
+        const originalReady = conn.ready;
+        const checkReady = setInterval(() => {
+            if (conn.ready && !originalReady) {
+                clearInterval(checkReady);
+                clearTimeout(timeout);
+                conn.reconnecting = false;
+                conn.reconnectAttempts = 0;
+                console.log(`[bridge] Reconnected to ${conn.config.id}`);
+            }
+        }, 10);
+        const timeout = setTimeout(() => {
+            if (!conn.ready) {
+                clearInterval(checkReady);
+                socket.destroy();
+                conn.reconnecting = false;
+                console.error(`[bridge] Reconnection timeout for ${conn.config.id}`);
+                if (!this.shuttingDown) {
+                    this.scheduleReconnect(conn);
+                }
+            }
+        }, 5000);
+    }
+    /**
+     * Disconnect from all projects
+     */
+    disconnect() {
+        this.shuttingDown = true;
+        for (const [_, conn] of this.connections) {
+            // Clear any pending reconnection timers
+            if (conn.reconnectTimer) {
+                clearTimeout(conn.reconnectTimer);
+            }
+            try {
+                this.send(conn, {
+                    v: PROTOCOL_VERSION,
+                    type: 'BYE',
+                    id: uuid(),
+                    ts: Date.now(),
+                    payload: {},
+                });
+                conn.socket.end();
+            }
+            catch {
+                // Ignore
+            }
+        }
+        this.connections.clear();
+        this.leads.clear();
+    }
+}
+//# sourceMappingURL=multi-project-client.js.map

package/dist/bridge/multi-project-client.js.map

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

package/dist/bridge/spawner.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Agent Spawner
+ * Handles spawning and releasing worker agents via tmux.
+ */
+import type { SpawnRequest, SpawnResult, WorkerInfo } from './types.js';
+export declare class AgentSpawner {
+    private activeWorkers;
+    private tmuxSession;
+    private agentsPath;
+    private projectRoot;
+    private tmuxPath;
+    constructor(projectRoot: string, tmuxSession?: string);
+    /**
+     * Ensure the worker tmux session exists
+     */
+    ensureSession(): Promise<void>;
+    /**
+     * Spawn a new worker agent
+     */
+    spawn(request: SpawnRequest): Promise<SpawnResult>;
+    /**
+     * Release (terminate) a worker
+     */
+    release(name: string): Promise<boolean>;
+    /**
+     * Release all workers
+     */
+    releaseAll(): Promise<void>;
+    /**
+     * Get all active workers
+     */
+    getActiveWorkers(): WorkerInfo[];
+    /**
+     * Check if a worker exists
+     */
+    hasWorker(name: string): boolean;
+    /**
+     * Get worker info
+     */
+    getWorker(name: string): WorkerInfo | undefined;
+    /**
+     * Wait for an agent to appear in the registry (agents.json)
+     */
+    private waitForAgentRegistration;
+    private isAgentRegistered;
+}
+//# sourceMappingURL=spawner.d.ts.map

package/dist/bridge/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../../src/bridge/spawner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExE,qBAAa,YAAY;IACvB,OAAO,CAAC,aAAa,CAAsC;IAC3D,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAS;gBAGvB,WAAW,EAAE,MAAM,EACnB,WAAW,CAAC,EAAE,MAAM;IAatB;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAYpC;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IAyGxD;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAiC7C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC;;OAEG;IACH,gBAAgB,IAAI,UAAU,EAAE;IAIhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS;IAI/C;;OAEG;YACW,wBAAwB;IAkBtC,OAAO,CAAC,iBAAiB;CAkB1B"}

package/dist/bridge/spawner.js

@@ -0,0 +1,227 @@
+/**
+ * Agent Spawner
+ * Handles spawning and releasing worker agents via tmux.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { execAsync, sleep, escapeForTmux } from './utils.js';
+import { getProjectPaths } from '../utils/project-namespace.js';
+import { getTmuxPath } from '../utils/tmux-resolver.js';
+export class AgentSpawner {
+    activeWorkers = new Map();
+    tmuxSession;
+    agentsPath;
+    projectRoot;
+    tmuxPath; // Resolved path to tmux binary
+    constructor(projectRoot, tmuxSession) {
+        const paths = getProjectPaths(projectRoot);
+        this.projectRoot = paths.projectRoot;
+        this.agentsPath = path.join(paths.teamDir, 'agents.json');
+        // Resolve tmux path (will throw TmuxNotFoundError if tmux unavailable)
+        this.tmuxPath = getTmuxPath();
+        // Default session name based on project
+        this.tmuxSession = tmuxSession || 'relay-workers';
+    }
+    /**
+     * Ensure the worker tmux session exists
+     */
+    async ensureSession() {
+        try {
+            await execAsync(`"${this.tmuxPath}" has-session -t ${this.tmuxSession} 2>/dev/null`);
+        }
+        catch {
+            // Session doesn't exist, create it
+            await execAsync(`"${this.tmuxPath}" new-session -d -s ${this.tmuxSession} -c "${this.projectRoot}"`);
+            console.log(`[spawner] Created session ${this.tmuxSession}`);
+        }
+    }
+    /**
+     * Spawn a new worker agent
+     */
+    async spawn(request) {
+        const { name, cli, task, requestedBy } = request;
+        const debug = process.env.DEBUG_SPAWN === '1';
+        // Check if worker already exists
+        if (this.activeWorkers.has(name)) {
+            return {
+                success: false,
+                name,
+                error: `Worker ${name} already exists`,
+            };
+        }
+        try {
+            await this.ensureSession();
+            if (debug)
+                console.log(`[spawner:debug] Session ${this.tmuxSession} ready`);
+            // Create new window for worker
+            const windowName = name;
+            const newWindowCmd = `"${this.tmuxPath}" new-window -t ${this.tmuxSession} -n ${windowName} -c "${this.projectRoot}"`;
+            if (debug)
+                console.log(`[spawner:debug] Creating window: ${newWindowCmd}`);
+            await execAsync(newWindowCmd);
+            // Build the agent-relay command
+            // Unset TMUX to allow Claude to run inside tmux (it refuses to nest by default)
+            // Use full path to agent-relay to avoid PATH issues with nvm/shell init
+            let agentRelayPath;
+            try {
+                const { stdout } = await execAsync('which agent-relay');
+                agentRelayPath = stdout.trim();
+                if (debug)
+                    console.log(`[spawner:debug] Found agent-relay at: ${agentRelayPath}`);
+            }
+            catch {
+                // Fallback to npx if which fails
+                agentRelayPath = 'npx agent-relay';
+                if (debug)
+                    console.log(`[spawner:debug] Using npx fallback`);
+            }
+            // Add --dangerously-skip-permissions for Claude agents to avoid permission dialogs
+            // Use -- to separate agent-relay options from the wrapped command
+            const isClaudeCli = cli.startsWith('claude');
+            const cliWithFlags = isClaudeCli ? `${cli} --dangerously-skip-permissions` : cli;
+            const cmd = `unset TMUX && ${agentRelayPath} -n ${name} -- ${cliWithFlags}`;
+            if (debug)
+                console.log(`[spawner:debug] Agent command: ${cmd}`);
+            // Send the command
+            const sendCmd = `"${this.tmuxPath}" send-keys -t ${this.tmuxSession}:${windowName} '${cmd}' Enter`;
+            if (debug)
+                console.log(`[spawner:debug] Sending: ${sendCmd}`);
+            await execAsync(sendCmd);
+            // Wait for the agent to register with the daemon before injecting tasks
+            const registered = await this.waitForAgentRegistration(name, 30_000, 500);
+            if (!registered) {
+                const error = `Worker ${name} failed to register within 30s`;
+                console.error(`[spawner] ${error}`);
+                // Clean up the tmux window to avoid orphaned workers
+                await execAsync(`"${this.tmuxPath}" kill-window -t ${this.tmuxSession}:${windowName}`).catch(() => { });
+                return {
+                    success: false,
+                    name,
+                    error,
+                };
+            }
+            // Inject the initial task if provided
+            if (task && task.trim()) {
+                const escapedTask = escapeForTmux(task);
+                if (debug)
+                    console.log(`[spawner:debug] Injecting task: ${escapedTask.substring(0, 50)}...`);
+                await execAsync(`"${this.tmuxPath}" send-keys -t ${this.tmuxSession}:${windowName} -l "${escapedTask}"`);
+                await sleep(100);
+                await execAsync(`"${this.tmuxPath}" send-keys -t ${this.tmuxSession}:${windowName} Enter`);
+            }
+            // Track the worker
+            const workerInfo = {
+                name,
+                cli,
+                task,
+                spawnedBy: requestedBy,
+                spawnedAt: Date.now(),
+                window: `${this.tmuxSession}:${windowName}`,
+            };
+            this.activeWorkers.set(name, workerInfo);
+            console.log(`[spawner] Spawned ${name} (${cli}) for ${requestedBy}`);
+            return {
+                success: true,
+                name,
+                window: workerInfo.window,
+            };
+        }
+        catch (err) {
+            console.error(`[spawner] Failed to spawn ${name}:`, err.message);
+            if (debug)
+                console.error(`[spawner:debug] Full error:`, err);
+            return {
+                success: false,
+                name,
+                error: err.message,
+            };
+        }
+    }
+    /**
+     * Release (terminate) a worker
+     */
+    async release(name) {
+        const worker = this.activeWorkers.get(name);
+        if (!worker) {
+            console.log(`[spawner] Worker ${name} not found`);
+            return false;
+        }
+        try {
+            // Send exit command gracefully
+            await execAsync(`"${this.tmuxPath}" send-keys -t ${worker.window} '/exit' Enter`).catch(() => { });
+            // Wait a bit for graceful shutdown
+            await sleep(2000);
+            // Kill the window
+            await execAsync(`"${this.tmuxPath}" kill-window -t ${worker.window}`).catch(() => { });
+            this.activeWorkers.delete(name);
+            console.log(`[spawner] Released ${name}`);
+            return true;
+        }
+        catch (err) {
+            console.error(`[spawner] Failed to release ${name}:`, err.message);
+            // Still remove from tracking
+            this.activeWorkers.delete(name);
+            return false;
+        }
+    }
+    /**
+     * Release all workers
+     */
+    async releaseAll() {
+        const workers = Array.from(this.activeWorkers.keys());
+        for (const name of workers) {
+            await this.release(name);
+        }
+    }
+    /**
+     * Get all active workers
+     */
+    getActiveWorkers() {
+        return Array.from(this.activeWorkers.values());
+    }
+    /**
+     * Check if a worker exists
+     */
+    hasWorker(name) {
+        return this.activeWorkers.has(name);
+    }
+    /**
+     * Get worker info
+     */
+    getWorker(name) {
+        return this.activeWorkers.get(name);
+    }
+    /**
+     * Wait for an agent to appear in the registry (agents.json)
+     */
+    async waitForAgentRegistration(name, timeoutMs = 30_000, pollIntervalMs = 500) {
+        const deadline = Date.now() + timeoutMs;
+        while (Date.now() < deadline) {
+            if (this.isAgentRegistered(name)) {
+                return true;
+            }
+            await sleep(pollIntervalMs);
+        }
+        return false;
+    }
+    isAgentRegistered(name) {
+        if (!this.agentsPath)
+            return false;
+        if (!fs.existsSync(this.agentsPath))
+            return false;
+        try {
+            const raw = JSON.parse(fs.readFileSync(this.agentsPath, 'utf-8'));
+            const agents = Array.isArray(raw?.agents)
+                ? raw.agents
+                : raw?.agents && typeof raw.agents === 'object'
+                    ? Object.values(raw.agents)
+                    : [];
+            return agents.some((a) => a?.name === name);
+        }
+        catch (err) {
+            console.error('[spawner] Failed to read agents registry:', err.message);
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=spawner.js.map