agent-relay 2.0.24 → 2.0.26

package/dist/src/cli/index.js

@@ -26,12 +26,12 @@ import fs from 'node:fs';
 import path from 'node:path';
 import readline from 'node:readline';
 import { promisify } from 'node:util';
-import { exec } from 'node:child_process';
+import { exec, spawn as spawnProcess } from 'node:child_process';
 import { fileURLToPath } from 'node:url';
 const RELAY_DASHBOARD_REPO = 'https://github.com/AgentWorkforce/relay-dashboard';
 /**
  * Prompt user to choose how to handle missing dashboard package.
- * Returns: 'install' | 'skip'
+ * Returns: 'npx' | 'install' | 'skip'
  */
 async function promptDashboardInstall() {
     const rl = readline.createInterface({
@@ -42,14 +42,18 @@ async function promptDashboardInstall() {
 The web dashboard requires @agent-relay/dashboard-server package.
 
 How would you like to proceed?
-  1. View installation instructions
-  2. Skip and continue without dashboard
+  1. Start with npx (recommended - auto-installs temporarily)
+  2. View installation instructions
+  3. Skip and continue without dashboard
 `);
     return new Promise((resolve) => {
-        rl.question('Choose [1/2]: ', (answer) => {
+        rl.question('Choose [1/2/3]: ', (answer) => {
             rl.close();
             const choice = answer.trim();
             if (choice === '1') {
+                resolve('npx');
+            }
+            else if (choice === '2') {
                 resolve('install');
             }
             else {
@@ -74,6 +78,53 @@ Then restart with:
 For more options, see: ${RELAY_DASHBOARD_REPO}
 `);
 }
+/**
+ * Start dashboard via npx (downloads and runs if not installed).
+ * Returns the spawned child process and port.
+ */
+function startDashboardViaNpx(options) {
+    console.log('Starting dashboard via npx (this may take a moment on first run)...');
+    const dashboardProcess = spawnProcess('npx', [
+        '--yes',
+        '@agent-relay/dashboard-server',
+        '--integrated',
+        '--port', String(options.port),
+        '--data-dir', options.dataDir,
+        '--team-dir', options.teamDir,
+        '--project-root', options.projectRoot,
+    ], {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        env: {
+            ...process.env,
+            // Pass any additional env vars needed
+        },
+    });
+    // Forward dashboard output with prefix
+    dashboardProcess.stdout?.on('data', (data) => {
+        const lines = data.toString().split('\n').filter(Boolean);
+        for (const line of lines) {
+            // Don't duplicate the "Dashboard:" line
+            if (!line.includes('Dashboard:')) {
+                console.log(`[dashboard] ${line}`);
+            }
+        }
+    });
+    dashboardProcess.stderr?.on('data', (data) => {
+        const lines = data.toString().split('\n').filter(Boolean);
+        for (const line of lines) {
+            console.error(`[dashboard] ${line}`);
+        }
+    });
+    dashboardProcess.on('error', (err) => {
+        console.error('Failed to start dashboard via npx:', err.message);
+    });
+    dashboardProcess.on('exit', (code) => {
+        if (code !== 0 && code !== null) {
+            console.error(`Dashboard process exited with code ${code}`);
+        }
+    });
+    return { process: dashboardProcess, port: options.port };
+}
 dotenvConfig();
 const DEFAULT_DASHBOARD_PORT = process.env.AGENT_RELAY_DASHBOARD_PORT || '3888';
 // Read version from package.json
@@ -524,15 +575,54 @@ program
                         if (process.stdin.isTTY) {
                             console.log('');
                             const action = await promptDashboardInstall();
-                            if (action === 'install') {
+                            if (action === 'npx') {
+                                // Start dashboard via npx
+                                const { process: dashboardProcess, port: npxPort } = startDashboardViaNpx({
+                                    port,
+                                    dataDir: paths.dataDir,
+                                    teamDir: paths.teamDir,
+                                    projectRoot: paths.projectRoot,
+                                });
+                                dashboardPort = npxPort;
+                                // Clean up dashboard process on exit
+                                const cleanupDashboard = () => {
+                                    if (dashboardProcess && !dashboardProcess.killed) {
+                                        dashboardProcess.kill('SIGTERM');
+                                    }
+                                };
+                                process.on('SIGINT', cleanupDashboard);
+                                process.on('SIGTERM', cleanupDashboard);
+                                process.on('exit', cleanupDashboard);
+                                // Wait a moment for dashboard to start
+                                await new Promise(resolve => setTimeout(resolve, 2000));
+                                console.log(`Dashboard: http://localhost:${dashboardPort}`);
+                            }
+                            else if (action === 'install') {
                                 showDashboardInstallInstructions();
                             }
                         }
                         else {
-                            // Non-interactive: just show instructions and exit with error
-                            console.error('Dashboard package not installed.');
-                            showDashboardInstallInstructions();
-                            process.exit(1);
+                            // Non-interactive: try npx automatically
+                            console.log('Dashboard package not installed. Starting via npx...');
+                            const { process: dashboardProcess, port: npxPort } = startDashboardViaNpx({
+                                port,
+                                dataDir: paths.dataDir,
+                                teamDir: paths.teamDir,
+                                projectRoot: paths.projectRoot,
+                            });
+                            dashboardPort = npxPort;
+                            // Clean up dashboard process on exit
+                            const cleanupDashboard = () => {
+                                if (dashboardProcess && !dashboardProcess.killed) {
+                                    dashboardProcess.kill('SIGTERM');
+                                }
+                            };
+                            process.on('SIGINT', cleanupDashboard);
+                            process.on('SIGTERM', cleanupDashboard);
+                            process.on('exit', cleanupDashboard);
+                            // Wait a moment for dashboard to start
+                            await new Promise(resolve => setTimeout(resolve, 3000));
+                            console.log(`Dashboard: http://localhost:${dashboardPort}`);
                         }
                     }
                     // Silent if user didn't explicitly request dashboard

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/src/index.js",
@@ -87,21 +87,21 @@
   },
   "homepage": "https://github.com/AgentWorkforce/relay#readme",
   "dependencies": {
-    "@agent-relay/bridge": "2.0.24",
-    "@agent-relay/config": "2.0.24",
-    "@agent-relay/continuity": "2.0.24",
-    "@agent-relay/daemon": "2.0.24",
-    "@agent-relay/hooks": "2.0.24",
-    "@agent-relay/mcp": "2.0.24",
-    "@agent-relay/protocol": "2.0.24",
-    "@agent-relay/resiliency": "2.0.24",
-    "@agent-relay/sdk": "2.0.24",
-    "@agent-relay/storage": "2.0.24",
-    "@agent-relay/telemetry": "2.0.24",
-    "@agent-relay/trajectory": "2.0.24",
-    "@agent-relay/user-directory": "2.0.24",
-    "@agent-relay/utils": "2.0.24",
-    "@agent-relay/wrapper": "2.0.24",
+    "@agent-relay/bridge": "2.0.26",
+    "@agent-relay/config": "2.0.26",
+    "@agent-relay/continuity": "2.0.26",
+    "@agent-relay/daemon": "2.0.26",
+    "@agent-relay/hooks": "2.0.26",
+    "@agent-relay/mcp": "2.0.26",
+    "@agent-relay/protocol": "2.0.26",
+    "@agent-relay/resiliency": "2.0.26",
+    "@agent-relay/sdk": "2.0.26",
+    "@agent-relay/storage": "2.0.26",
+    "@agent-relay/telemetry": "2.0.26",
+    "@agent-relay/trajectory": "2.0.26",
+    "@agent-relay/user-directory": "2.0.26",
+    "@agent-relay/utils": "2.0.26",
+    "@agent-relay/wrapper": "2.0.26",
     "agent-trajectories": "^0.2.3",
     "better-sqlite3": "^12.6.2",
     "chokidar": "^5.0.0",

package/packages/api-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/api-types",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Shared API types and Zod schemas for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/bridge/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/bridge",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Multi-project bridge client utilities for Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -22,13 +22,13 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.24",
-    "@agent-relay/config": "2.0.24",
-    "@agent-relay/utils": "2.0.24",
-    "@agent-relay/policy": "2.0.24",
-    "@agent-relay/user-directory": "2.0.24",
-    "@agent-relay/wrapper": "2.0.24",
-    "@agent-relay/mcp": "2.0.24"
+    "@agent-relay/protocol": "2.0.26",
+    "@agent-relay/config": "2.0.26",
+    "@agent-relay/utils": "2.0.26",
+    "@agent-relay/policy": "2.0.26",
+    "@agent-relay/user-directory": "2.0.26",
+    "@agent-relay/wrapper": "2.0.26",
+    "@agent-relay/mcp": "2.0.26"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/cli-tester/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/cli-tester",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Manual interactive testing for CLI authentication flows",
   "type": "module",
   "main": "dist/index.js",

package/packages/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/config",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Shared configuration schemas and loaders for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -83,7 +83,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.24",
+    "@agent-relay/protocol": "2.0.26",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.1"
   },

package/packages/continuity/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/continuity",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Session continuity manager for Relay (ledgers, handoffs, resume)",
   "type": "module",
   "main": "dist/index.js",

package/packages/daemon/dist/consensus-integration.d.ts

@@ -27,7 +27,8 @@
  * consensus.processIncomingMessage(from, body);
  * ```
  */
-import { ConsensusEngine, createConsensusEngine, formatProposalMessage, formatResultMessage, parseVoteCommand, parseProposalCommand, isConsensusCommand, type Proposal, type ConsensusResult, type ConsensusConfig, type VoteValue, type ConsensusType, type ParsedProposalCommand } from './consensus.js';
+import type { VoteValue, ConsensusType } from '@agent-relay/protocol';
+import { ConsensusEngine, createConsensusEngine, formatProposalMessage, formatResultMessage, parseVoteCommand, parseProposalCommand, isConsensusCommand, type Proposal, type ConsensusResult, type ConsensusConfig, type ParsedProposalCommand } from './consensus.js';
 import type { Router } from './router.js';
 export interface CloudSyncConfig {
     /** Cloud API base URL (defaults to AGENT_RELAY_CLOUD_URL or https://agent-relay.com) */

package/packages/daemon/dist/consensus.d.ts

@@ -18,9 +18,7 @@
  * - Task assignment (weighted by expertise)
  */
 import { EventEmitter } from 'node:events';
-export type ConsensusType = 'majority' | 'supermajority' | 'unanimous' | 'weighted' | 'quorum';
-export type VoteValue = 'approve' | 'reject' | 'abstain';
-export type ProposalStatus = 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled';
+import type { ConsensusType, VoteValue, ProposalStatus } from '@agent-relay/protocol';
 export interface AgentWeight {
     /** Agent name */
     agent: string;

package/packages/daemon/dist/enhanced-features.d.ts

@@ -17,7 +17,8 @@ import { getCompiledPatterns, isInstructionalTextFast, isPlaceholderTargetFast,
 import { AgentSigningManager, loadSigningConfig, attachSignature, extractSignature, type AgentSigningConfig, type SignedMessage } from './agent-signing.js';
 import { SQLiteDLQAdapter, PostgresDLQAdapter, InMemoryDLQAdapter, createDLQAdapter, DEFAULT_DLQ_CONFIG, type DLQStorageAdapter, type DLQConfig, type DeadLetter, type DLQStats } from '@agent-relay/storage/dlq-adapter';
 import { ContextCompactor, createContextCompactor, estimateTokens, estimateContextTokens, formatTokenCount, type Message, type CompactionConfig, type CompactionResult } from '@agent-relay/memory';
-import { ConsensusEngine, createConsensusEngine, formatProposalMessage, parseVoteCommand, formatResultMessage, type Proposal, type ConsensusResult, type ConsensusConfig, type VoteValue } from './consensus.js';
+import type { VoteValue } from '@agent-relay/protocol';
+import { ConsensusEngine, createConsensusEngine, formatProposalMessage, parseVoteCommand, formatResultMessage, type Proposal, type ConsensusResult, type ConsensusConfig } from './consensus.js';
 export interface EnhancedFeaturesConfig {
     /** Pattern matching configuration */
     patterns?: {

package/packages/daemon/dist/orchestrator.js

@@ -21,7 +21,7 @@ function generateId() {
 }
 /**
  * Determine the default host binding.
- * - In cloud environments (Fly.io, Docker with WORKSPACE_ID), bind to 0.0.0.0 for external access
+ * - In cloud environments, bind to '::' for IPv6+IPv4 dual-stack (required for Fly.io 6PN)
  * - Locally, bind to localhost for security
  * - Can be overridden with AGENT_RELAY_API_HOST env var
  */
@@ -30,12 +30,13 @@ function getDefaultHost() {
     if (process.env.AGENT_RELAY_API_HOST) {
         return process.env.AGENT_RELAY_API_HOST;
     }
-    // Cloud environment detection - bind to all interfaces for load balancer access
+    // Cloud environment detection - bind to :: for IPv6 + IPv4 dual-stack
+    // Fly.io internal network uses IPv6 (fdaa:...), so 0.0.0.0 won't work
     const isCloudEnvironment = process.env.FLY_APP_NAME || // Fly.io
         process.env.WORKSPACE_ID || // Agent Relay workspace
         process.env.RELAY_WORKSPACE_ID || // Alternative workspace ID
         process.env.RUNNING_IN_DOCKER === 'true'; // Docker container
-    return isCloudEnvironment ? '0.0.0.0' : 'localhost';
+    return isCloudEnvironment ? '::' : 'localhost';
 }
 const DEFAULT_CONFIG = {
     port: 3456,

package/packages/daemon/dist/server.js

@@ -1169,6 +1169,54 @@ export class Daemon {
                 });
                 break;
             }
+            case 'MESSAGES_QUERY': {
+                // Query all messages (used by dashboard) - not filtered by recipient
+                const queryPayload = envelope.payload;
+                const getMessages = async () => {
+                    if (!this.storage?.getMessages) {
+                        return [];
+                    }
+                    try {
+                        const messages = await this.storage.getMessages({
+                            limit: queryPayload.limit || 100,
+                            sinceTs: queryPayload.sinceTs,
+                            from: queryPayload.from,
+                            to: queryPayload.to,
+                            thread: queryPayload.thread,
+                            order: queryPayload.order || 'desc',
+                        });
+                        return messages.map(m => ({
+                            id: m.id,
+                            from: m.from,
+                            to: m.to,
+                            body: m.body,
+                            channel: m.data?.channel,
+                            thread: m.thread,
+                            timestamp: m.ts,
+                            status: m.status,
+                            isBroadcast: m.is_broadcast,
+                            replyCount: m.replyCount,
+                            data: m.data,
+                        }));
+                    }
+                    catch {
+                        return [];
+                    }
+                };
+                getMessages().then(messages => {
+                    const response = {
+                        v: PROTOCOL_VERSION,
+                        type: 'MESSAGES_RESPONSE',
+                        id: envelope.id,
+                        ts: Date.now(),
+                        payload: { messages },
+                    };
+                    connection.send(response);
+                }).catch(err => {
+                    this.sendErrorEnvelope(connection, `Failed to get messages: ${err.message}`);
+                });
+                break;
+            }
             case 'LIST_AGENTS': {
                 const listPayload = envelope.payload;
                 // Get connected agents from router

package/packages/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/daemon",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "description": "Relay daemon server - agent coordination and message routing",
   "type": "module",
   "main": "dist/index.js",
@@ -22,17 +22,17 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.24",
-    "@agent-relay/config": "2.0.24",
-    "@agent-relay/storage": "2.0.24",
-    "@agent-relay/bridge": "2.0.24",
-    "@agent-relay/utils": "2.0.24",
-    "@agent-relay/policy": "2.0.24",
-    "@agent-relay/memory": "2.0.24",
-    "@agent-relay/resiliency": "2.0.24",
-    "@agent-relay/user-directory": "2.0.24",
-    "@agent-relay/wrapper": "2.0.24",
-    "@agent-relay/telemetry": "2.0.24",
+    "@agent-relay/protocol": "2.0.26",
+    "@agent-relay/config": "2.0.26",
+    "@agent-relay/storage": "2.0.26",
+    "@agent-relay/bridge": "2.0.26",
+    "@agent-relay/utils": "2.0.26",
+    "@agent-relay/policy": "2.0.26",
+    "@agent-relay/memory": "2.0.26",
+    "@agent-relay/resiliency": "2.0.26",
+    "@agent-relay/user-directory": "2.0.26",
+    "@agent-relay/wrapper": "2.0.26",
+    "@agent-relay/telemetry": "2.0.26",
     "ws": "^8.18.3",
     "better-sqlite3": "^12.6.2",
     "pg": "^8.16.3",

package/packages/hooks/dist/inbox-check/types.d.ts

@@ -17,7 +17,12 @@ export interface HookOutput {
     /** Reason for the decision (shown to Claude if blocked) */
     reason?: string;
 }
-export interface InboxMessage {
+/**
+ * Parsed message from inbox file.
+ * Note: This is different from @agent-relay/protocol's InboxMessage
+ * which is for daemon communication.
+ */
+export interface ParsedInboxMessage {
     from: string;
     timestamp: string;
     body: string;

package/packages/hooks/dist/inbox-check/utils.d.ts

@@ -1,7 +1,7 @@
 /**
  * Utility functions for Agent Relay Inbox Check Hook
  */
-import type { InboxConfig, InboxMessage } from './types.js';
+import type { InboxConfig, ParsedInboxMessage } from './types.js';
 /** Default inbox directory */
 export declare const DEFAULT_INBOX_DIR = "/tmp/agent-relay";
 /**
@@ -32,11 +32,11 @@ export declare function countMessages(inboxPath: string): number;
 /**
  * Parse messages from inbox content
  */
-export declare function parseMessages(inboxPath: string): InboxMessage[];
+export declare function parseMessages(inboxPath: string): ParsedInboxMessage[];
 /**
  * Format a message for display
  */
-export declare function formatMessagePreview(msg: InboxMessage, maxLength?: number): string;
+export declare function formatMessagePreview(msg: ParsedInboxMessage, maxLength?: number): string;
 /**
  * Build the block reason message
  */

package/packages/hooks/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/hooks",
-  "version": "2.0.24",
+  "version": "2.0.26",
   "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.24",
-    "@agent-relay/config": "2.0.24",
-    "@agent-relay/trajectory": "2.0.24"
+    "@agent-relay/protocol": "2.0.26",
+    "@agent-relay/config": "2.0.26",
+    "@agent-relay/trajectory": "2.0.26"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/mcp/dist/client.d.ts

@@ -1,52 +1,12 @@
 /**
  * RelayClient - Client for connecting to the Agent Relay daemon
+ *
+ * This module uses @agent-relay/protocol for wire format handling
+ * to avoid code duplication with the SDK.
  */
-export interface HealthResponse {
-    healthScore: number;
-    summary: string;
-    issues: Array<{
-        severity: string;
-        message: string;
-    }>;
-    recommendations: string[];
-    crashes: Array<{
-        id: string;
-        agentName: string;
-        crashedAt: string;
-        likelyCause: string;
-        summary?: string;
-    }>;
-    alerts: Array<{
-        id: string;
-        agentName: string;
-        alertType: string;
-        message: string;
-        createdAt: string;
-    }>;
-    stats: {
-        totalCrashes24h: number;
-        totalAlerts24h: number;
-        agentCount: number;
-    };
-}
-export interface MetricsResponse {
-    agents: Array<{
-        name: string;
-        pid?: number;
-        status: string;
-        rssBytes?: number;
-        cpuPercent?: number;
-        trend?: string;
-        alertLevel?: string;
-        highWatermark?: number;
-        uptimeMs?: number;
-    }>;
-    system: {
-        totalMemory: number;
-        freeMemory: number;
-        heapUsed: number;
-    };
-}
+import { type HealthResponsePayload, type MetricsResponsePayload } from '@agent-relay/protocol';
+export type HealthResponse = HealthResponsePayload;
+export type MetricsResponse = MetricsResponsePayload;
 export interface RelayClient {
     send(to: string, message: string, options?: {
         thread?: string;
@@ -59,6 +19,9 @@ export interface RelayClient {
         content: string;
         thread?: string;
     }>;
+    broadcast(message: string, options?: {
+        kind?: string;
+    }): Promise<void>;
     spawn(options: {
         name: string;
         cli: string;
@@ -68,11 +31,59 @@ export interface RelayClient {
     }): Promise<{
         success: boolean;
         error?: string;
+        pid?: number;
     }>;
     release(name: string, reason?: string): Promise<{
         success: boolean;
         error?: string;
     }>;
+    subscribe(topic: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    unsubscribe(topic: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    joinChannel(channel: string, displayName?: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    leaveChannel(channel: string, reason?: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    sendChannelMessage(channel: string, message: string, options?: {
+        thread?: string;
+    }): Promise<void>;
+    bindAsShadow(primaryAgent: string, options?: {
+        speakOn?: string[];
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    unbindAsShadow(primaryAgent: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    createProposal(options: {
+        id: string;
+        description: string;
+        options: string[];
+        votingMethod?: string;
+        deadline?: number;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    vote(options: {
+        proposalId: string;
+        vote: string;
+        reason?: string;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
     getStatus(): Promise<{
         connected: boolean;
         agentName: string;