agent-relay 1.0.8 → 1.0.11

package/README.md

@@ -40,6 +40,7 @@ Agents communicate by outputting `->relay:` patterns:
 | `agent-relay down` | Stop daemon |
 | `agent-relay status` | Check if running |
 | `agent-relay read <id>` | Read truncated message |
+| `agent-relay bridge <projects...>` | Bridge multiple projects |
 
 ## How It Works
 
@@ -92,20 +93,92 @@ Long messages are truncated. Use the ID to read full content:
 agent-relay read abc123
 ```
 
+## Agent Roles
+
+Agent names automatically match role definitions (case-insensitive):
+
+```bash
+# If .claude/agents/lead.md exists:
+agent-relay -n Lead claude    # matches lead.md
+agent-relay -n LEAD claude    # matches lead.md
+agent-relay -n lead claude    # matches lead.md
+
+# Supported locations:
+# - .claude/agents/<name>.md
+# - .openagents/<name>.md
+```
+
+Create role agents for your team:
+
+```
+.claude/agents/
+├── lead.md          # Coordinator
+├── implementer.md   # Developer
+├── designer.md      # UI/UX
+└── reviewer.md      # Code review
+```
+
+## Multi-Project Orchestration
+
+Bridge multiple projects with a single orchestrator:
+
+```bash
+# Bridge projects (Architect mode)
+agent-relay bridge ~/auth ~/frontend ~/api
+```
+
+### Workflow
+
+1. **Start daemons** in each project: `agent-relay up`
+2. **Start agents** in each project: `agent-relay -n Alice claude`
+3. **Bridge** from anywhere: `agent-relay bridge ~/project1 ~/project2`
+
+### Cross-Project Messaging
+
+```
+->relay:projectId:agent Message to specific agent
+->relay:*:lead Broadcast to all project leads
+```
+
+### Spawn Agents
+
+```
+->relay:spawn Dev1 claude "Implement login endpoint"
+->relay:release Dev1
+```
+
+See [docs/DESIGN_BRIDGE_STAFFING.md](docs/DESIGN_BRIDGE_STAFFING.md) for full details.
+
+## Enabling AI Agents
+
+To teach your AI agents how to use agent-relay, you should:
+
+### Install the Skill
+
+```bash
+prpm install using-agent-relay
+```
+
+This installs the `using-agent-relay` skill which provides agents with messaging patterns, coordination workflows, and troubleshooting guidance.
+
+### Update the AGENTS.md/CLAUDE.md file
+
+Use prpm to install the AGENTS.md snippet or CLAUDE.md snippet
+```
+prpm install @agent-relay/agent-relay-snippet
+```
+
+Or if using CLAUDE.md
+```
+prpm install @agent-relay/agent-relay-snippet --location CLAUDE.md
+```
+
 ## Dashboard
 
 `agent-relay up` starts a web dashboard at http://localhost:3888
 
 ![Agent Relay Dashboard](dashboard.png)
 
-## Troubleshooting
-
-| Issue | Solution |
-|-------|----------|
-| Messages not sending | `agent-relay status` to check daemon |
-| Socket not found | `agent-relay up` to start daemon |
-| Truncated message | `agent-relay read <id>` |
-
 ## Development
 
 ```bash
@@ -114,6 +187,54 @@ cd agent-relay
 npm install && npm run build
 ```
 
+## Why agent-relay?
+
+### The Composable Approach
+
+Most multi-agent tools try to be complete solutions - handling communication, memory, UI, workflows, and orchestration. agent-relay takes a different approach: **do one thing exceptionally well** (real-time messaging) and integrate with best-of-breed tools for everything else.
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    Your Agent System                        │
+├─────────────────────────────────────────────────────────────┤
+│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
+│  │   Mimir     │  │  Maestro    │  │    Beads    │         │
+│  │  (Memory)   │  │    (UI)     │  │ (Workflows) │         │
+│  └──────┬──────┘  └──────┬──────┘  └──────┬──────┘         │
+│         └────────────────┼────────────────┘                 │
+│                ┌─────────▼─────────┐                        │
+│                │   agent-relay     │  ◄── Messaging layer   │
+│                │     <5ms P2P      │                        │
+│                └─────────┬─────────┘                        │
+│         ┌────────────────┼────────────────┐                 │
+│    ┌────▼────┐     ┌────▼────┐     ┌────▼────┐             │
+│    │ Claude  │     │  Codex  │     │  Gemini │             │
+│    └─────────┘     └─────────┘     └─────────┘             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+### Unix Philosophy
+
+- **Do one thing well**: Real-time agent messaging with <5ms latency
+- **Work with others**: Simple `->relay:` pattern, standard I/O
+- **Text streams**: Messages are just text, easy to parse/transform
+- **Composability**: Pipe into other tools, wrap any CLI
+
+### When to Use agent-relay
+
+| Use Case | agent-relay? |
+|----------|--------------|
+| Quick prototyping with multiple agents | **Yes** - 1 min setup |
+| Real-time agent collaboration | **Yes** - fastest option |
+| CLI-native workflows | **Yes** - no Electron/desktop needed |
+| Need persistent knowledge graph | Combine with Mimir |
+| Need rich desktop UI | Combine with Maestro |
+| Enterprise compliance | Combine with governance layer |
+
+See [docs/COMPETITIVE_ANALYSIS.md](docs/COMPETITIVE_ANALYSIS.md) for detailed comparisons with 16 other multi-agent tools.
+
+---
+
 ## Inspiration
 
 This project was inspired by some excellent work in the multi-agent coordination space:

package/dist/bridge/config.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Bridge Configuration
+ * Handles loading and resolving bridge configuration from files and CLI args.
+ */
+import type { ProjectConfig } from './types.js';
+interface BridgeConfigFile {
+    projects?: Record<string, {
+        lead?: string;
+        cli?: string;
+    }>;
+    defaultCli?: string;
+}
+/**
+ * Load bridge config from file
+ */
+export declare function loadBridgeConfig(): BridgeConfigFile | null;
+/**
+ * Resolve project path (expand ~ and make absolute)
+ */
+export declare function resolvePath(p: string): string;
+/**
+ * Get default lead name from directory name
+ */
+export declare function getDefaultLeadName(projectPath: string): string;
+/**
+ * Resolve projects from CLI args and/or config file
+ */
+export declare function resolveProjects(cliPaths: string[], cliOverride?: string): ProjectConfig[];
+/**
+ * Validate that daemons are running for all projects
+ */
+export declare function validateDaemons(projects: ProjectConfig[]): {
+    valid: ProjectConfig[];
+    missing: ProjectConfig[];
+};
+/**
+ * Start daemons for missing projects
+ */
+export declare function startMissingDaemons(projects: ProjectConfig[]): Promise<void>;
+export {};
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/bridge/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAO9D,UAAU,gBAAgB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QACxB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,gBAAgB,GAAG,IAAI,CAY1D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAI9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAAE,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,aAAa,EAAE,CAmDjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,EAAE,GAAG;IAC1D,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAaA;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,aAAa,EAAE,GACxB,OAAO,CAAC,IAAI,CAAC,CAiBf"}

package/dist/bridge/config.js

@@ -0,0 +1,143 @@
+/**
+ * Bridge Configuration
+ * Handles loading and resolving bridge configuration from files and CLI args.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { getProjectPaths } from '../utils/project-namespace.js';
+const CONFIG_PATHS = [
+    path.join(os.homedir(), '.agent-relay', 'bridge.json'),
+    path.join(os.homedir(), '.config', 'agent-relay', 'bridge.json'),
+];
+/**
+ * Load bridge config from file
+ */
+export function loadBridgeConfig() {
+    for (const configPath of CONFIG_PATHS) {
+        if (fs.existsSync(configPath)) {
+            try {
+                const content = fs.readFileSync(configPath, 'utf-8');
+                return JSON.parse(content);
+            }
+            catch (err) {
+                console.error(`[bridge] Failed to parse ${configPath}:`, err);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Resolve project path (expand ~ and make absolute)
+ */
+export function resolvePath(p) {
+    if (p.startsWith('~')) {
+        p = path.join(os.homedir(), p.slice(1));
+    }
+    return path.resolve(p);
+}
+/**
+ * Get default lead name from directory name
+ */
+export function getDefaultLeadName(projectPath) {
+    const dirname = path.basename(projectPath);
+    // Capitalize first letter
+    return dirname.charAt(0).toUpperCase() + dirname.slice(1);
+}
+/**
+ * Resolve projects from CLI args and/or config file
+ */
+export function resolveProjects(cliPaths, cliOverride) {
+    const config = loadBridgeConfig();
+    const projects = [];
+    // If CLI paths provided, use those
+    if (cliPaths.length > 0) {
+        for (const p of cliPaths) {
+            const projectPath = resolvePath(p);
+            if (!fs.existsSync(projectPath)) {
+                console.error(`[bridge] Project path does not exist: ${projectPath}`);
+                continue;
+            }
+            const paths = getProjectPaths(projectPath);
+            // Check for project-specific config
+            const projectConfig = config?.projects?.[p] || config?.projects?.[projectPath];
+            projects.push({
+                path: projectPath,
+                id: paths.projectId,
+                socketPath: paths.socketPath,
+                leadName: projectConfig?.lead || getDefaultLeadName(projectPath),
+                cli: cliOverride || projectConfig?.cli || config?.defaultCli || 'claude',
+            });
+        }
+    }
+    // Otherwise use config file
+    else if (config?.projects) {
+        for (const [p, projectConfig] of Object.entries(config.projects)) {
+            const projectPath = resolvePath(p);
+            if (!fs.existsSync(projectPath)) {
+                console.error(`[bridge] Project path does not exist: ${projectPath}`);
+                continue;
+            }
+            const paths = getProjectPaths(projectPath);
+            projects.push({
+                path: projectPath,
+                id: paths.projectId,
+                socketPath: paths.socketPath,
+                leadName: projectConfig.lead || getDefaultLeadName(projectPath),
+                cli: cliOverride || projectConfig.cli || config.defaultCli || 'claude',
+            });
+        }
+    }
+    return projects;
+}
+/**
+ * Validate that daemons are running for all projects
+ */
+export function validateDaemons(projects) {
+    const valid = [];
+    const missing = [];
+    for (const project of projects) {
+        if (fs.existsSync(project.socketPath)) {
+            valid.push(project);
+        }
+        else {
+            missing.push(project);
+        }
+    }
+    return { valid, missing };
+}
+/**
+ * Start daemons for missing projects
+ */
+export async function startMissingDaemons(projects) {
+    const { execAsync } = await import('./utils.js');
+    for (const project of projects) {
+        console.log(`[bridge] Starting daemon for ${project.id}...`);
+        try {
+            // Start daemon in background
+            await execAsync(`cd "${project.path}" && agent-relay up &`, {
+                timeout: 5000,
+            });
+            // Wait for socket to appear
+            await waitForSocket(project.socketPath, 10000);
+            console.log(`[bridge] Daemon started for ${project.id}`);
+        }
+        catch (err) {
+            console.error(`[bridge] Failed to start daemon for ${project.id}:`, err);
+        }
+    }
+}
+/**
+ * Wait for socket file to exist
+ */
+async function waitForSocket(socketPath, timeoutMs) {
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeoutMs) {
+        if (fs.existsSync(socketPath)) {
+            return;
+        }
+        await new Promise(r => setTimeout(r, 200));
+    }
+    throw new Error(`Timeout waiting for socket: ${socketPath}`);
+}
+//# sourceMappingURL=config.js.map

package/dist/bridge/config.js.map

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

package/dist/bridge/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Bridge Module
+ * Multi-project orchestration for agent-relay
+ */
+export * from './types.js';
+export * from './config.js';
+export * from './multi-project-client.js';
+export * from './spawner.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,10 @@
+/**
+ * Bridge Module
+ * Multi-project orchestration for agent-relay
+ */
+export * from './types.js';
+export * from './config.js';
+export * from './multi-project-client.js';
+export * from './spawner.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

package/dist/bridge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/bridge/multi-project-client.d.ts

@@ -0,0 +1,99 @@
+/**
+ * MultiProjectClient
+ * Connects to multiple project daemons simultaneously for cross-project orchestration.
+ */
+import { type SendPayload } from '../protocol/types.js';
+import type { ProjectConfig } from './types.js';
+interface MultiProjectClientOptions {
+    /** Agent name to register as (default: '__BridgeClient'). Must be unique per daemon. */
+    agentName?: string;
+    /** Enable automatic reconnection on disconnect (default: true) */
+    reconnect?: boolean;
+    /** Initial reconnection delay in ms (default: 1000) */
+    reconnectDelay?: number;
+    /** Maximum reconnection delay in ms (default: 30000) */
+    maxReconnectDelay?: number;
+    /** Maximum reconnection attempts before giving up (default: Infinity) */
+    maxReconnectAttempts?: number;
+}
+export declare class MultiProjectClient {
+    private projects;
+    private connections;
+    private leads;
+    private options;
+    private shuttingDown;
+    /** Handler for incoming messages */
+    onMessage?: (projectId: string, from: string, payload: SendPayload, messageId: string) => void;
+    /** Handler for connection state changes */
+    onProjectStateChange?: (projectId: string, connected: boolean) => void;
+    constructor(projects: ProjectConfig[], options?: MultiProjectClientOptions);
+    /**
+     * Connect to all project daemons
+     */
+    connect(): Promise<void>;
+    /**
+     * Connect to a single project daemon
+     */
+    private connectToProject;
+    /**
+     * Send HELLO to a project daemon
+     */
+    private sendHello;
+    /**
+     * Handle incoming data from a project connection
+     */
+    private handleData;
+    /**
+     * Process a frame from a project daemon
+     */
+    private processFrame;
+    /**
+     * Handle delivered message from a project
+     */
+    private handleDeliver;
+    /**
+     * Send envelope to a project daemon
+     */
+    private send;
+    /**
+     * 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: string, to: string, body: string): boolean;
+    /**
+     * Broadcast to all leads
+     */
+    broadcastToLeads(body: string): void;
+    /**
+     * Broadcast to all agents in all projects
+     */
+    broadcastAll(body: string): void;
+    /**
+     * Register a lead for a project
+     */
+    registerLead(projectId: string, leadName: string): void;
+    /**
+     * Get all connected projects
+     */
+    getConnectedProjects(): string[];
+    /**
+     * Get project connection info
+     */
+    getProject(projectId: string): ProjectConfig | undefined;
+    /**
+     * Schedule a reconnection attempt with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Attempt to reconnect to a project daemon
+     */
+    private attemptReconnect;
+    /**
+     * Disconnect from all projects
+     */
+    disconnect(): void;
+}
+export {};
+//# sourceMappingURL=multi-project-client.d.ts.map

package/dist/bridge/multi-project-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"multi-project-client.d.ts","sourceRoot":"","sources":["../../src/bridge/multi-project-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,EAIL,KAAK,WAAW,EAGjB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EAAE,aAAa,EAAY,MAAM,YAAY,CAAC;AAa1D,UAAU,yBAAyB;IACjC,wFAAwF;IACxF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uDAAuD;IACvD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,kBAAkB;IAYjB,OAAO,CAAC,QAAQ;IAX5B,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,OAAO,CAAiF;IAChG,OAAO,CAAC,YAAY,CAAS;IAE7B,oCAAoC;IACpC,SAAS,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAE/F,2CAA2C;IAC3C,oBAAoB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;gBAEnD,QAAQ,EAAE,aAAa,EAAE,EAAE,OAAO,GAAE,yBAA8B;IAUtF;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAK9B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA8DxB;;OAEG;IACH,OAAO,CAAC,SAAS;IAqBjB;;OAEG;IACH,OAAO,CAAC,UAAU;IAWlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAmBrB;;OAEG;IACH,OAAO,CAAC,IAAI;IAaZ;;;;;OAKG;IACH,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO;IAkCnE;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAMpC;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBhC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQvD;;OAEG;IACH,oBAAoB,IAAI,MAAM,EAAE;IAMhC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIxD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAyBzB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAmExB;;OAEG;IACH,UAAU,IAAI,IAAI;CAyBnB"}