agent-relay 0.1.0

package/dist/webhook/spawner.js

@@ -0,0 +1,288 @@
+/**
+ * Webhook Spawner - Spawns agent CLIs when messages arrive
+ *
+ * Supports: claude, codex, gemini, cursor
+ */
+import { spawn } from 'child_process';
+import * as fs from 'fs';
+import * as path from 'path';
+import * as chokidar from 'chokidar';
+/**
+ * Get the spawn command for a CLI type
+ */
+function getSpawnCommand(cli) {
+    switch (cli.toLowerCase()) {
+        case 'claude':
+            return { cmd: 'claude', args: ['--dangerously-skip-permissions'] };
+        case 'codex':
+            return { cmd: 'codex', args: [] };
+        case 'gemini':
+            return { cmd: 'gemini', args: [] };
+        case 'cursor':
+            return { cmd: 'cursor', args: ['--cli'] };
+        default:
+            return { cmd: cli, args: [] };
+    }
+}
+/**
+ * Spawn an agent CLI to check their inbox
+ */
+export function spawnAgent(config) {
+    const { cmd, args } = getSpawnCommand(config.cli);
+    const instructionsPath = path.join(config.dataDir, config.name, 'INSTRUCTIONS.md');
+    // Create a prompt that tells the agent to check inbox
+    const prompt = `You have new messages! Read ${instructionsPath} and check your inbox immediately using the team-check command. Respond to any messages, then continue your work loop.`;
+    try {
+        const child = spawn(cmd, [...args, '-p', prompt], {
+            cwd: config.projectDir,
+            stdio: 'inherit',
+            detached: true,
+        });
+        child.unref();
+        return {
+            agent: config.name,
+            pid: child.pid,
+            success: true,
+        };
+    }
+    catch (error) {
+        return {
+            agent: config.name,
+            success: false,
+            error: error instanceof Error ? error.message : String(error),
+        };
+    }
+}
+/**
+ * Spawn agent in background and capture output
+ */
+export function spawnAgentBackground(config, onOutput, onExit) {
+    const { cmd, args } = getSpawnCommand(config.cli);
+    const instructionsPath = path.join(config.dataDir, config.name, 'INSTRUCTIONS.md');
+    const prompt = `You have new messages! Read ${instructionsPath} and check your inbox using team-check --no-wait. Respond to messages, do one task step, broadcast status, then exit.`;
+    try {
+        const child = spawn(cmd, [...args, '-p', prompt], {
+            cwd: config.projectDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        if (onOutput) {
+            child.stdout?.on('data', (data) => onOutput(data.toString()));
+            child.stderr?.on('data', (data) => onOutput(data.toString()));
+        }
+        if (onExit) {
+            child.on('exit', onExit);
+        }
+        return child;
+    }
+    catch (error) {
+        console.error(`Failed to spawn ${config.name}:`, error);
+        return null;
+    }
+}
+/**
+ * Watch for inbox changes and spawn agents
+ */
+export class InboxWatcher {
+    watcher = null;
+    agents = new Map();
+    activeAgents = new Map();
+    debounceTimers = new Map();
+    dataDir;
+    debounceMs;
+    constructor(dataDir, debounceMs = 2000) {
+        this.dataDir = dataDir;
+        this.debounceMs = debounceMs;
+    }
+    /**
+     * Register an agent to watch
+     */
+    registerAgent(config) {
+        this.agents.set(config.name, { ...config, enabled: config.enabled ?? true });
+    }
+    /**
+     * Load agents from team.json
+     */
+    loadFromTeamConfig() {
+        const configPath = path.join(this.dataDir, 'team.json');
+        if (!fs.existsSync(configPath)) {
+            throw new Error(`Team config not found: ${configPath}`);
+        }
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        for (const agent of config.agents) {
+            this.registerAgent({
+                name: agent.name,
+                cli: agent.cli,
+                projectDir: config.projectDir,
+                dataDir: this.dataDir,
+                enabled: agent.webhook !== false, // enabled by default
+            });
+        }
+    }
+    /**
+     * Start watching for inbox changes
+     */
+    start(onSpawn) {
+        const inboxPattern = path.join(this.dataDir, '*/inbox.md');
+        this.watcher = chokidar.watch(inboxPattern, {
+            persistent: true,
+            ignoreInitial: true,
+            awaitWriteFinish: {
+                stabilityThreshold: 500,
+                pollInterval: 100,
+            },
+        });
+        this.watcher.on('change', (filePath) => {
+            const agentName = path.basename(path.dirname(filePath));
+            this.handleInboxChange(agentName, onSpawn);
+        });
+        this.watcher.on('add', (filePath) => {
+            const agentName = path.basename(path.dirname(filePath));
+            // Only trigger if file has content
+            const stats = fs.statSync(filePath);
+            if (stats.size > 0) {
+                this.handleInboxChange(agentName, onSpawn);
+            }
+        });
+        console.log(`Watching for inbox changes in ${this.dataDir}`);
+    }
+    /**
+     * Handle inbox change with debouncing
+     */
+    handleInboxChange(agentName, onSpawn) {
+        const agent = this.agents.get(agentName);
+        if (!agent || !agent.enabled) {
+            return;
+        }
+        // Check if agent is already active
+        if (this.activeAgents.has(agentName)) {
+            console.log(`${agentName} already active, skipping spawn`);
+            return;
+        }
+        // Check if inbox actually has content
+        const inboxPath = path.join(this.dataDir, agentName, 'inbox.md');
+        if (!fs.existsSync(inboxPath) || fs.statSync(inboxPath).size === 0) {
+            return;
+        }
+        // Debounce rapid changes
+        const existingTimer = this.debounceTimers.get(agentName);
+        if (existingTimer) {
+            clearTimeout(existingTimer);
+        }
+        const timer = setTimeout(() => {
+            this.debounceTimers.delete(agentName);
+            this.spawnForAgent(agentName, onSpawn);
+        }, this.debounceMs);
+        this.debounceTimers.set(agentName, timer);
+    }
+    /**
+     * Spawn agent and track it
+     */
+    spawnForAgent(agentName, onSpawn) {
+        const agent = this.agents.get(agentName);
+        if (!agent)
+            return;
+        console.log(`Spawning ${agentName} (${agent.cli})...`);
+        const child = spawnAgentBackground(agent, (output) => {
+            process.stdout.write(`[${agentName}] ${output}`);
+        }, (code) => {
+            console.log(`${agentName} exited with code ${code}`);
+            this.activeAgents.delete(agentName);
+        });
+        if (child) {
+            this.activeAgents.set(agentName, child);
+            onSpawn?.({
+                agent: agentName,
+                pid: child.pid,
+                success: true,
+            });
+        }
+        else {
+            onSpawn?.({
+                agent: agentName,
+                success: false,
+                error: 'Failed to spawn',
+            });
+        }
+    }
+    /**
+     * Stop watching
+     */
+    stop() {
+        this.watcher?.close();
+        this.watcher = null;
+        // Clear all debounce timers
+        for (const timer of this.debounceTimers.values()) {
+            clearTimeout(timer);
+        }
+        this.debounceTimers.clear();
+        // Kill active agents
+        for (const [name, child] of this.activeAgents) {
+            console.log(`Stopping ${name}...`);
+            child.kill();
+        }
+        this.activeAgents.clear();
+    }
+    /**
+     * Get status of all agents
+     */
+    getStatus() {
+        return Array.from(this.agents.values()).map((agent) => ({
+            name: agent.name,
+            enabled: agent.enabled ?? true,
+            active: this.activeAgents.has(agent.name),
+        }));
+    }
+}
+/**
+ * Trigger webhook for a specific agent (called after team-send)
+ */
+export async function triggerWebhook(agentName, dataDir, options) {
+    const configPath = path.join(dataDir, 'team.json');
+    if (!fs.existsSync(configPath)) {
+        return { agent: agentName, success: false, error: 'Team config not found' };
+    }
+    const config = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+    const agent = config.agents.find((a) => a.name === agentName);
+    if (!agent) {
+        return { agent: agentName, success: false, error: 'Agent not found' };
+    }
+    // HTTP webhook if configured
+    if (options?.http || agent.webhookUrl) {
+        const url = options?.http || agent.webhookUrl;
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    agent: agentName,
+                    event: 'new_message',
+                    timestamp: new Date().toISOString(),
+                    inboxPath: path.join(dataDir, agentName, 'inbox.md'),
+                }),
+            });
+            return {
+                agent: agentName,
+                success: response.ok,
+                error: response.ok ? undefined : `HTTP ${response.status}`,
+            };
+        }
+        catch (error) {
+            return {
+                agent: agentName,
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    // Spawn CLI if requested
+    if (options?.spawn !== false) {
+        return spawnAgent({
+            name: agentName,
+            cli: agent.cli,
+            projectDir: config.projectDir,
+            dataDir,
+        });
+    }
+    return { agent: agentName, success: true };
+}
+//# sourceMappingURL=spawner.js.map

package/dist/webhook/spawner.js.map

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

package/dist/wrapper/client.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Relay Client
+ * Connects to the daemon and handles message sending/receiving.
+ */
+import { type SendPayload, type PayloadKind } from '../protocol/types.js';
+export type ClientState = 'DISCONNECTED' | 'CONNECTING' | 'HANDSHAKING' | 'READY' | 'BACKOFF';
+export interface ClientConfig {
+    socketPath: string;
+    agentName: string;
+    reconnect: boolean;
+    maxReconnectAttempts: number;
+    reconnectDelayMs: number;
+    reconnectMaxDelayMs: number;
+}
+export declare class RelayClient {
+    private config;
+    private socket?;
+    private parser;
+    private _state;
+    private sessionId?;
+    private resumeToken?;
+    private reconnectAttempts;
+    private reconnectDelay;
+    private reconnectTimer?;
+    private _destroyed;
+    onMessage?: (from: string, payload: SendPayload) => void;
+    onStateChange?: (state: ClientState) => void;
+    onError?: (error: Error) => void;
+    constructor(config?: Partial<ClientConfig>);
+    get state(): ClientState;
+    get agentName(): string;
+    /**
+     * Connect to the relay daemon.
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect from the relay daemon.
+     */
+    disconnect(): void;
+    /**
+     * Permanently destroy the client. Disconnects and prevents any reconnection.
+     */
+    destroy(): void;
+    /**
+     * Send a message to another agent.
+     */
+    sendMessage(to: string, body: string, kind?: PayloadKind, data?: Record<string, unknown>): boolean;
+    /**
+     * Broadcast a message to all agents.
+     */
+    broadcast(body: string, kind?: PayloadKind, data?: Record<string, unknown>): boolean;
+    /**
+     * Subscribe to a topic.
+     */
+    subscribe(topic: string): boolean;
+    /**
+     * Unsubscribe from a topic.
+     */
+    unsubscribe(topic: string): boolean;
+    private setState;
+    private sendHello;
+    private send;
+    private handleData;
+    private processFrame;
+    private handleWelcome;
+    private handleDeliver;
+    private handlePing;
+    private handleDisconnect;
+    private handleError;
+    private scheduleReconnect;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/wrapper/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/wrapper/client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAIL,KAAK,WAAW,EAEhB,KAAK,WAAW,EAEjB,MAAM,sBAAsB,CAAC;AAI9B,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,GAAG,SAAS,CAAC;AAE9F,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAWD,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAc;IAE5B,OAAO,CAAC,MAAM,CAA+B;IAC7C,OAAO,CAAC,SAAS,CAAC,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,UAAU,CAAS;IAG3B,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACzD,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;gBAErB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IAM9C,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CxB;;OAEG;IACH,UAAU,IAAI,IAAI;IAqBlB;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAuB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAqB7G;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,WAAuB,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO;IAI/F;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAajC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAanC,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,aAAa;IAmBrB,OAAO,CAAC,UAAU;IAUlB,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,iBAAiB;CAiB1B"}

package/dist/wrapper/client.js

@@ -0,0 +1,306 @@
+/**
+ * Relay Client
+ * Connects to the daemon and handles message sending/receiving.
+ */
+import net from 'node:net';
+import { v4 as uuid } from 'uuid';
+import { PROTOCOL_VERSION, } from '../protocol/types.js';
+import { encodeFrame, FrameParser } from '../protocol/framing.js';
+import { DEFAULT_SOCKET_PATH } from '../daemon/server.js';
+const DEFAULT_CLIENT_CONFIG = {
+    socketPath: DEFAULT_SOCKET_PATH,
+    agentName: 'agent',
+    reconnect: true,
+    maxReconnectAttempts: 10,
+    reconnectDelayMs: 100,
+    reconnectMaxDelayMs: 30000,
+};
+export class RelayClient {
+    config;
+    socket;
+    parser;
+    _state = 'DISCONNECTED';
+    sessionId;
+    resumeToken;
+    reconnectAttempts = 0;
+    reconnectDelay;
+    reconnectTimer;
+    _destroyed = false;
+    // Event handlers
+    onMessage;
+    onStateChange;
+    onError;
+    constructor(config = {}) {
+        this.config = { ...DEFAULT_CLIENT_CONFIG, ...config };
+        this.parser = new FrameParser();
+        this.reconnectDelay = this.config.reconnectDelayMs;
+    }
+    get state() {
+        return this._state;
+    }
+    get agentName() {
+        return this.config.agentName;
+    }
+    /**
+     * Connect to the relay daemon.
+     */
+    connect() {
+        if (this._state !== 'DISCONNECTED' && this._state !== 'BACKOFF') {
+            return Promise.resolve();
+        }
+        return new Promise((resolve, reject) => {
+            this.setState('CONNECTING');
+            this.socket = net.createConnection(this.config.socketPath, () => {
+                this.setState('HANDSHAKING');
+                this.sendHello();
+            });
+            this.socket.on('data', (data) => this.handleData(data));
+            this.socket.on('close', () => {
+                this.handleDisconnect();
+            });
+            this.socket.on('error', (err) => {
+                if (this._state === 'CONNECTING') {
+                    reject(err);
+                }
+                this.handleError(err);
+            });
+            // Wait for WELCOME
+            const checkReady = setInterval(() => {
+                if (this._state === 'READY') {
+                    clearInterval(checkReady);
+                    resolve();
+                }
+            }, 10);
+            // Timeout
+            setTimeout(() => {
+                if (this._state !== 'READY') {
+                    clearInterval(checkReady);
+                    reject(new Error('Connection timeout'));
+                }
+            }, 5000);
+        });
+    }
+    /**
+     * Disconnect from the relay daemon.
+     */
+    disconnect() {
+        if (this.reconnectTimer) {
+            clearTimeout(this.reconnectTimer);
+            this.reconnectTimer = undefined;
+        }
+        if (this.socket) {
+            this.send({
+                v: PROTOCOL_VERSION,
+                type: 'BYE',
+                id: uuid(),
+                ts: Date.now(),
+                payload: {},
+            });
+            this.socket.end();
+            this.socket = undefined;
+        }
+        this.setState('DISCONNECTED');
+    }
+    /**
+     * Permanently destroy the client. Disconnects and prevents any reconnection.
+     */
+    destroy() {
+        this._destroyed = true;
+        this.disconnect();
+    }
+    /**
+     * Send a message to another agent.
+     */
+    sendMessage(to, body, kind = 'message', data) {
+        if (this._state !== 'READY') {
+            return false;
+        }
+        const envelope = {
+            v: PROTOCOL_VERSION,
+            type: 'SEND',
+            id: uuid(),
+            ts: Date.now(),
+            to,
+            payload: {
+                kind,
+                body,
+                data,
+            },
+        };
+        return this.send(envelope);
+    }
+    /**
+     * Broadcast a message to all agents.
+     */
+    broadcast(body, kind = 'message', data) {
+        return this.sendMessage('*', body, kind, data);
+    }
+    /**
+     * Subscribe to a topic.
+     */
+    subscribe(topic) {
+        if (this._state !== 'READY')
+            return false;
+        return this.send({
+            v: PROTOCOL_VERSION,
+            type: 'SUBSCRIBE',
+            id: uuid(),
+            ts: Date.now(),
+            topic,
+            payload: {},
+        });
+    }
+    /**
+     * Unsubscribe from a topic.
+     */
+    unsubscribe(topic) {
+        if (this._state !== 'READY')
+            return false;
+        return this.send({
+            v: PROTOCOL_VERSION,
+            type: 'UNSUBSCRIBE',
+            id: uuid(),
+            ts: Date.now(),
+            topic,
+            payload: {},
+        });
+    }
+    setState(state) {
+        this._state = state;
+        if (this.onStateChange) {
+            this.onStateChange(state);
+        }
+    }
+    sendHello() {
+        const hello = {
+            v: PROTOCOL_VERSION,
+            type: 'HELLO',
+            id: uuid(),
+            ts: Date.now(),
+            payload: {
+                agent: this.config.agentName,
+                capabilities: {
+                    ack: true,
+                    resume: true,
+                    max_inflight: 256,
+                    supports_topics: true,
+                },
+                session: this.resumeToken ? { resume_token: this.resumeToken } : undefined,
+            },
+        };
+        this.send(hello);
+    }
+    send(envelope) {
+        if (!this.socket)
+            return false;
+        try {
+            const frame = encodeFrame(envelope);
+            this.socket.write(frame);
+            return true;
+        }
+        catch (err) {
+            this.handleError(err);
+            return false;
+        }
+    }
+    handleData(data) {
+        try {
+            const frames = this.parser.push(data);
+            for (const frame of frames) {
+                this.processFrame(frame);
+            }
+        }
+        catch (err) {
+            this.handleError(err);
+        }
+    }
+    processFrame(envelope) {
+        switch (envelope.type) {
+            case 'WELCOME':
+                this.handleWelcome(envelope);
+                break;
+            case 'DELIVER':
+                this.handleDeliver(envelope);
+                break;
+            case 'PING':
+                this.handlePing(envelope);
+                break;
+            case 'ERROR':
+                console.error('[client] Server error:', envelope.payload);
+                break;
+            case 'BUSY':
+                console.warn('[client] Server busy, backing off');
+                break;
+        }
+    }
+    handleWelcome(envelope) {
+        this.sessionId = envelope.payload.session_id;
+        this.resumeToken = envelope.payload.resume_token;
+        this.reconnectAttempts = 0;
+        this.reconnectDelay = this.config.reconnectDelayMs;
+        this.setState('READY');
+        console.log(`[client] Connected as ${this.config.agentName} (session: ${this.sessionId})`);
+    }
+    handleDeliver(envelope) {
+        // Send ACK
+        this.send({
+            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(envelope.from, envelope.payload);
+        }
+    }
+    handlePing(envelope) {
+        this.send({
+            v: PROTOCOL_VERSION,
+            type: 'PONG',
+            id: uuid(),
+            ts: Date.now(),
+            payload: envelope.payload ?? {},
+        });
+    }
+    handleDisconnect() {
+        this.parser.reset();
+        this.socket = undefined;
+        // Don't reconnect if permanently destroyed
+        if (this._destroyed) {
+            this.setState('DISCONNECTED');
+            return;
+        }
+        if (this.config.reconnect && this.reconnectAttempts < this.config.maxReconnectAttempts) {
+            this.scheduleReconnect();
+        }
+        else {
+            this.setState('DISCONNECTED');
+        }
+    }
+    handleError(error) {
+        console.error('[client] Error:', error.message);
+        if (this.onError) {
+            this.onError(error);
+        }
+    }
+    scheduleReconnect() {
+        this.setState('BACKOFF');
+        this.reconnectAttempts++;
+        // Exponential backoff with jitter
+        const jitter = Math.random() * 0.3 + 0.85; // 0.85 - 1.15
+        const delay = Math.min(this.reconnectDelay * jitter, this.config.reconnectMaxDelayMs);
+        this.reconnectDelay *= 2;
+        console.log(`[client] Reconnecting in ${Math.round(delay)}ms (attempt ${this.reconnectAttempts})`);
+        this.reconnectTimer = setTimeout(() => {
+            this.connect().catch(() => {
+                // Will trigger another reconnect
+            });
+        }, delay);
+    }
+}
+//# sourceMappingURL=client.js.map