agent-relay 2.0.0 → 2.0.4

package/packages/dashboard-server/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/dashboard-server",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Relay dashboard server - HTTP/WebSocket server for agent coordination",
   "type": "module",
   "main": "dist/index.js",
@@ -22,17 +22,18 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.0",
-    "@agent-relay/config": "2.0.0",
-    "@agent-relay/storage": "2.0.0",
-    "@agent-relay/bridge": "2.0.0",
-    "@agent-relay/utils": "2.0.0",
-    "@agent-relay/resiliency": "2.0.0",
-    "@agent-relay/trajectory": "2.0.0",
-    "@agent-relay/cloud": "2.0.0",
-    "@agent-relay/daemon": "2.0.0",
-    "@agent-relay/user-directory": "2.0.0",
-    "@agent-relay/sdk": "2.0.0",
+    "@agent-relay/protocol": "2.0.4",
+    "@agent-relay/config": "2.0.4",
+    "@agent-relay/storage": "2.0.4",
+    "@agent-relay/bridge": "2.0.4",
+    "@agent-relay/utils": "2.0.4",
+    "@agent-relay/resiliency": "2.0.4",
+    "@agent-relay/trajectory": "2.0.4",
+    "@agent-relay/cloud": "2.0.4",
+    "@agent-relay/daemon": "2.0.4",
+    "@agent-relay/user-directory": "2.0.4",
+    "@agent-relay/sdk": "2.0.4",
+    "array-flatten": "^1.1.1",
     "express": "^4.21.2",
     "ws": "^8.18.3"
   },
@@ -45,5 +46,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/dashboard-server"
   }
 }

package/packages/hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/hooks",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Hook emitter, registry, and trajectory hooks for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -37,9 +37,9 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.0",
-    "@agent-relay/config": "2.0.0",
-    "@agent-relay/trajectory": "2.0.0"
+    "@agent-relay/protocol": "2.0.4",
+    "@agent-relay/config": "2.0.4",
+    "@agent-relay/trajectory": "2.0.4"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",
@@ -48,5 +48,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/hooks"
   }
 }

package/packages/mcp/README.md

@@ -160,50 +160,166 @@ The MCP server provides:
 
 In cloud environments (with `WORKSPACE_ID` set), MCP is pre-configured and uses workspace-specific sockets automatically.
 
-## Programmatic Usage
+## Programmatic Usage (For Libraries & Integrations)
 
-Use relay tools directly in your code (no MCP protocol needed):
+The MCP package provides a simple programmatic API that's perfect for building agent orchestration libraries like AgentSwarm.
+
+### Simple Tools API (Recommended)
 
 ```typescript
 import { createTools } from '@agent-relay/mcp';
 
-const tools = createTools('MyAgent');
+// Create tools for your orchestrator agent
+const tools = createTools('Conductor');
 
-// Send messages
-await tools.send('OtherAgent', 'Hello!');
-await tools.send('#general', 'Channel message');
-await tools.send('*', 'Broadcast');
+// Send messages to agents
+await tools.send('Worker1', 'Run the test suite');
+await tools.send('#team', 'Starting task coordination');  // Channel
+await tools.send('*', 'System announcement');              // Broadcast
 
-// Check inbox
+// Spawn worker agents
+const result = await tools.spawn({
+  name: 'TestRunner',
+  cli: 'claude',           // 'claude' | 'codex' | 'gemini' | 'opencode'
+  task: 'Run all tests and report failures',
+  cwd: '/path/to/project', // Optional working directory
+});
+
+if (!result.success) {
+  console.error('Spawn failed:', result.error);
+}
+
+// Check your inbox
 const messages = await tools.inbox();
 for (const msg of messages) {
-  console.log(`${msg.from}: ${msg.content}`);
+  console.log(`From ${msg.from}: ${msg.content}`);
+  if (msg.channel) console.log(`  (in ${msg.channel})`);
 }
 
 // List online agents
 const agents = await tools.who();
+console.log('Online agents:', agents.map(a => a.name));
 
-// Spawn workers
-await tools.spawn({
-  name: 'Worker1',
-  cli: 'claude',
-  task: 'Run tests',
-});
+// Release workers when done
+await tools.release('TestRunner', 'Tests complete');
 
-// Release workers
-await tools.release('Worker1');
+// Get connection status
+const status = await tools.status();
+console.log(`Connected: ${status.connected}, Project: ${status.project}`);
 ```
 
-### One-liners
+### Full Integration Example
 
 ```typescript
-import { send, inbox, who } from '@agent-relay/mcp/simple';
+import { createTools, type RelayTools, type Message, type Agent } from '@agent-relay/mcp';
+
+class AgentOrchestrator {
+  private tools: RelayTools;
+  private workers: Map<string, { task: string; status: string }> = new Map();
+
+  constructor(name: string) {
+    this.tools = createTools(name);
+  }
+
+  async spawnWorker(name: string, task: string) {
+    const result = await this.tools.spawn({
+      name,
+      cli: 'claude',
+      task,
+    });
+
+    if (result.success) {
+      this.workers.set(name, { task, status: 'running' });
+    }
+    return result;
+  }
+
+  async sendTask(workerName: string, task: string) {
+    await this.tools.send(workerName, task);
+  }
+
+  async waitForCompletion(workerName: string, timeoutMs = 60000) {
+    // Use sendAndWait for synchronous request-response
+    const response = await this.tools.sendAndWait(
+      workerName,
+      'Report your status',
+      { timeoutMs }
+    );
+    return response;
+  }
+
+  async getMessages(): Promise<Message[]> {
+    return this.tools.inbox();
+  }
+
+  async getOnlineAgents(): Promise<Agent[]> {
+    return this.tools.who();
+  }
+
+  async releaseWorker(name: string) {
+    await this.tools.release(name);
+    this.workers.delete(name);
+  }
+
+  async releaseAll() {
+    for (const name of this.workers.keys()) {
+      await this.releaseWorker(name);
+    }
+  }
+}
+
+// Usage
+const conductor = new AgentOrchestrator('Conductor');
+
+await conductor.spawnWorker('Planner', 'Create implementation plan');
+await conductor.spawnWorker('Coder', 'Implement the plan');
+await conductor.spawnWorker('Tester', 'Write and run tests');
+
+// Coordinate work...
+await conductor.sendTask('Planner', 'Start planning the feature');
+
+// Check for responses
+const messages = await conductor.getMessages();
+
+// Clean up
+await conductor.releaseAll();
+```
 
+### One-liners (For Quick Scripts)
+
+```typescript
+import { send, inbox, who } from '@agent-relay/mcp';
+
+// Send a message
 await send('MyAgent', 'Bob', 'Hello!');
+
+// Check inbox
 const messages = await inbox('MyAgent');
+
+// List agents
 const agents = await who();
 ```
 
+### Socket Discovery
+
+The MCP package auto-discovers the daemon socket:
+
+```typescript
+import { discoverSocket, getConnectionInfo } from '@agent-relay/mcp';
+
+// Get socket path and metadata
+const discovery = discoverSocket();
+if (discovery) {
+  console.log(`Socket: ${discovery.socketPath}`);
+  console.log(`Project: ${discovery.project}`);
+  console.log(`Source: ${discovery.source}`);  // 'env' | 'cloud' | 'cwd' | 'scan'
+  console.log(`Cloud: ${discovery.isCloud}`);
+}
+
+// Or get full connection info
+const info = getConnectionInfo();
+```
+
 ## Requirements
 
 - Node.js 18+

package/packages/mcp/dist/cloud.js

@@ -61,6 +61,24 @@ export function getCloudSocketPath(workspaceId) {
 export function getCloudOutboxPath(workspaceId, agentName) {
     return `/tmp/relay/${workspaceId}/outbox/${agentName}`;
 }
+/**
+ * Find project root by looking for common markers.
+ * Scans up from startDir until it finds a marker or hits the filesystem root.
+ */
+function findProjectRoot(startDir = process.cwd()) {
+    let current = startDir;
+    const root = current.split('/')[0] || '/';
+    const markers = ['.git', 'package.json', 'Cargo.toml', 'go.mod', 'pyproject.toml', '.agent-relay'];
+    while (current !== root && current !== '/') {
+        for (const marker of markers) {
+            if (existsSync(join(current, marker))) {
+                return current;
+            }
+        }
+        current = join(current, '..');
+    }
+    return null;
+}
 /**
  * Get platform-specific data directory.
  */
@@ -146,7 +164,38 @@ export function discoverSocket(options = {}) {
             };
         }
     }
-    // 4. Current working directory config
+    // 4. Project-local socket (created by daemon in project's .agent-relay directory)
+    // This is the primary path for local development
+    // First try cwd, then scan up to find project root
+    const projectRoot = findProjectRoot(process.cwd());
+    const searchDirs = [process.cwd()];
+    if (projectRoot && projectRoot !== process.cwd()) {
+        searchDirs.push(projectRoot);
+    }
+    for (const dir of searchDirs) {
+        const projectLocalSocket = join(dir, '.agent-relay', 'relay.sock');
+        if (existsSync(projectLocalSocket)) {
+            // Read project ID from marker file if available
+            let projectId = 'local';
+            const markerPath = join(dir, '.agent-relay', '.project');
+            if (existsSync(markerPath)) {
+                try {
+                    const marker = JSON.parse(readFileSync(markerPath, 'utf-8'));
+                    projectId = marker.projectId || 'local';
+                }
+                catch {
+                    // Ignore marker read errors
+                }
+            }
+            return {
+                socketPath: projectLocalSocket,
+                project: projectId,
+                source: 'cwd',
+                isCloud: false,
+            };
+        }
+    }
+    // 4b. Legacy .relay/config.json support
     const cwdConfig = join(process.cwd(), '.relay', 'config.json');
     if (existsSync(cwdConfig)) {
         try {

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/mcp",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "MCP server for Agent Relay - native messaging tools for AI agents in Claude, Cursor, and VS Code",
   "author": "Agent Workforce Inc.",
   "license": "Apache-2.0",

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/memory",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Semantic memory storage and retrieval system for agent-relay with multiple backend support",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/hooks": "2.0.0"
+    "@agent-relay/hooks": "2.0.4"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",
@@ -31,5 +31,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/memory"
   }
 }

package/packages/policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/policy",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Agent policy management with multi-level fallback (repo, local PRPM, cloud workspace)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "2.0.0"
+    "@agent-relay/config": "2.0.4"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",
@@ -31,5 +31,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/policy"
   }
 }

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Wire protocol types and framing for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -52,5 +52,10 @@
     "@types/node": "^22.19.3",
     "typescript": "^5.9.3",
     "vitest": "^3.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/protocol"
   }
 }

package/packages/resiliency/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/resiliency",
-  "version": "2.0.0",
+  "version": "2.0.4",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -29,5 +29,10 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/resiliency"
   }
 }