agent-relay 2.0.21 → 2.0.23

package/dist/src/cli/index.d.ts

@@ -3,11 +3,11 @@
  * Agent Relay CLI
  *
  * Commands:
- *   relay claude                   - Start daemon + Dashboard coordinator with Claude
- *   relay codex                    - Start daemon + Dasbboard coordinator with Codex
+ *   relay claude                   - Start daemon with Claude coordinator
+ *   relay codex                    - Start daemon with Codex coordinator
  *   relay create-agent <cmd>       - Wrap agent with real-time messaging
  *   relay create-agent -n Name cmd - Wrap with specific agent name
- *   relay up                       - Start daemon + dashboard
+ *   relay up                       - Start daemon
  *   relay read <id>                - Read full message by ID
  *   relay agents                   - List connected agents
  *   relay who                      - Show currently active agents

package/dist/src/cli/index.js

@@ -3,11 +3,11 @@
  * Agent Relay CLI
  *
  * Commands:
- *   relay claude                   - Start daemon + Dashboard coordinator with Claude
- *   relay codex                    - Start daemon + Dasbboard coordinator with Codex
+ *   relay claude                   - Start daemon with Claude coordinator
+ *   relay codex                    - Start daemon with Codex coordinator
  *   relay create-agent <cmd>       - Wrap agent with real-time messaging
  *   relay create-agent -n Name cmd - Wrap with specific agent name
- *   relay up                       - Start daemon + dashboard
+ *   relay up                       - Start daemon
  *   relay read <id>                - Read full message by ID
  *   relay agents                   - List connected agents
  *   relay who                      - Show currently active agents
@@ -26,10 +26,11 @@ import fs from 'node:fs';
 import path from 'node:path';
 import readline from 'node:readline';
 import { promisify } from 'node:util';
-import { exec, spawn as spawnProcess } from 'node:child_process';
+import { exec } 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
+ * Prompt user to choose how to handle missing dashboard package.
  * Returns: 'install' | 'skip'
  */
 async function promptDashboardInstall() {
@@ -38,11 +39,11 @@ async function promptDashboardInstall() {
         output: process.stdout,
     });
     console.log(`
-Dashboard package not installed.
+The web dashboard is now an external package.
 
 How would you like to proceed?
-  1. Install now (npm install -g @agent-relay/dashboard)
-  2. Continue without dashboard
+  1. View installation instructions for relay-dashboard
+  2. Skip and continue without dashboard
 `);
     return new Promise((resolve) => {
         rl.question('Choose [1/2]: ', (answer) => {
@@ -58,29 +59,24 @@ How would you like to proceed?
     });
 }
 /**
- * Install dashboard package globally
+ * Show instructions for installing the external relay-dashboard package.
  */
-async function installDashboardGlobally() {
-    console.log('\nInstalling @agent-relay/dashboard globally...\n');
-    return new Promise((resolve) => {
-        const proc = spawnProcess('npm', ['install', '-g', '@agent-relay/dashboard'], {
-            stdio: 'inherit',
-        });
-        proc.on('close', (code) => {
-            if (code === 0) {
-                console.log('\n✓ Dashboard installed successfully.\n');
-                resolve(true);
-            }
-            else {
-                console.error('\n✗ Installation failed. Try running manually:\n  npm install -g @agent-relay/dashboard\n');
-                resolve(false);
-            }
-        });
-        proc.on('error', () => {
-            console.error('\n✗ Installation failed. Try running manually:\n  npm install -g @agent-relay/dashboard\n');
-            resolve(false);
-        });
-    });
+function showDashboardInstallInstructions() {
+    console.log(`
+To install the relay-dashboard, visit:
+
+  ${RELAY_DASHBOARD_REPO}
+
+Install via npm:
+
+  npm install -g relay-dashboard
+
+Then start the dashboard alongside the daemon:
+
+  relay-dashboard --port 3888
+
+See the repository README for full configuration options.
+`);
 }
 dotenvConfig();
 const DEFAULT_DASHBOARD_PORT = process.env.AGENT_RELAY_DASHBOARD_PORT || '3888';
@@ -492,76 +488,7 @@ program
     try {
         await daemon.start();
         console.log('Daemon started.');
-        let dashboardPort;
-        // Dashboard is disabled by default (use --dashboard to enable)
-        // Dashboard is an optional separate package: @agent-relay/dashboard
-        if (options.dashboard === true) {
-            const port = parseInt(options.port, 10);
-            try {
-                const { startDashboard } = await import('@agent-relay/dashboard');
-                dashboardPort = await startDashboard({
-                    port,
-                    dataDir: paths.dataDir,
-                    teamDir: paths.teamDir,
-                    dbPath,
-                    enableSpawner: true,
-                    projectRoot: paths.projectRoot,
-                    // Pass spawn tracking callbacks so messages can be queued before HELLO completes
-                    onMarkSpawning: (name) => daemon.markSpawning(name),
-                    onClearSpawning: (name) => daemon.clearSpawning(name),
-                });
-                console.log(`Dashboard: http://localhost:${dashboardPort}`);
-                // Hook daemon log output to dashboard WebSocket
-                daemon.onLogOutput = (agentName, data, _timestamp) => {
-                    const broadcast = global.__broadcastLogOutput;
-                    if (broadcast) {
-                        broadcast(agentName, data);
-                    }
-                };
-            }
-            catch (err) {
-                const error = err;
-                if (error.code === 'ERR_MODULE_NOT_FOUND' || error.code === 'MODULE_NOT_FOUND') {
-                    // Interactive prompt for dashboard installation
-                    const choice = await promptDashboardInstall();
-                    if (choice === 'install') {
-                        const installed = await installDashboardGlobally();
-                        if (installed) {
-                            // Retry import after installation
-                            try {
-                                const { startDashboard } = await import('@agent-relay/dashboard');
-                                dashboardPort = await startDashboard({
-                                    port,
-                                    dataDir: paths.dataDir,
-                                    teamDir: paths.teamDir,
-                                    dbPath,
-                                    enableSpawner: true,
-                                    projectRoot: paths.projectRoot,
-                                    onMarkSpawning: (name) => daemon.markSpawning(name),
-                                    onClearSpawning: (name) => daemon.clearSpawning(name),
-                                });
-                                console.log(`Dashboard: http://localhost:${dashboardPort}`);
-                                daemon.onLogOutput = (agentName, data, _timestamp) => {
-                                    const broadcast = global.__broadcastLogOutput;
-                                    if (broadcast) {
-                                        broadcast(agentName, data);
-                                    }
-                                };
-                            }
-                            catch {
-                                console.error('Dashboard still not found after installation. Continuing without dashboard.');
-                            }
-                        }
-                    }
-                    else {
-                        console.log('\nContinuing without dashboard...\n');
-                    }
-                }
-                else {
-                    throw err;
-                }
-            }
-        }
+        const dashboardPort = undefined;
         // Determine if we should auto-spawn agents
         // --spawn: force spawn
         // --no-spawn: never spawn
@@ -1519,6 +1446,10 @@ program
     console.log(`\nCleaned up ${killed}/${orphaned.length} session(s).`);
 });
 async function discoverRelaySessions() {
+    // Skip tmux discovery in test environments to avoid hangs
+    if (process.env.AGENT_RELAY_SKIP_TMUX === '1') {
+        return [];
+    }
     try {
         const tmuxPath = getTmuxPath();
         const { stdout } = await execAsync(`"${tmuxPath}" list-sessions -F "#{session_name}"`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-relay",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Real-time agent-to-agent communication system",
   "type": "module",
   "main": "dist/src/index.js",
@@ -16,9 +16,9 @@
   },
   "scripts": {
     "postinstall": "npm rebuild better-sqlite3 && node scripts/postinstall.js",
-    "build": "npm run clean && npm run build:rust && turbo run build --filter='./packages/*' && tsc && npm run build:dashboard",
-    "build:sequential": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:cloud && npm run build:daemon && npm run build:sdk && npm run build:dashboard-server && npm run build:dashboard-pkg && npm run build:api-types && npm run build:spawner && tsc && npm run build:dashboard",
-    "build:workspace": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:cloud && npm run build:daemon && npm run build:sdk && npm run build:dashboard-server && npm run build:dashboard-pkg && npm run build:api-types && npm run build:spawner && tsc",
+    "build": "npm run clean && npm run build:rust && turbo run build --filter='./packages/*' && tsc",
+    "build:sequential": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:cloud && npm run build:daemon && npm run build:sdk && npm run build:api-types && npm run build:spawner && tsc",
+    "build:workspace": "npm run clean && npm run build:rust && npm run build:protocol && npm run build:config && npm run build:storage && npm run build:state && npm run build:policy && npm run build:trajectory && npm run build:hooks && npm run build:memory && npm run build:utils && npm run build:continuity && npm run build:resiliency && npm run build:user-directory && npm run build:wrapper && npm run build:mcp && npm run build:bridge && npm run build:telemetry && npm run build:cloud && npm run build:daemon && npm run build:sdk && npm run build:api-types && npm run build:spawner && tsc",
     "build:packages": "turbo run build --filter='./packages/*'",
     "build:packages:watch": "turbo run build --filter='./packages/*' --watch",
     "build:mcp": "cd packages/mcp && npm run build",
@@ -38,27 +38,20 @@
     "build:wrapper": "cd packages/wrapper && npm run build",
     "build:cloud": "cd packages/cloud && npm run build",
     "build:daemon": "cd packages/daemon && npm run build",
-    "build:dashboard-server": "cd packages/dashboard-server && npm run build",
-    "build:dashboard-pkg": "cd packages/dashboard && npm run build:server",
     "build:sdk": "cd packages/sdk && npm run build",
     "build:api-types": "cd packages/api-types && npm run build",
     "build:spawner": "cd packages/spawner && npm run build",
     "build:telemetry": "cd packages/telemetry && npm run build",
-    "build:dashboard": "cd packages/dashboard/ui && npm ci && npm run build",
-    "postbuild": "chmod +x dist/src/cli/index.js && mkdir -p dist/dashboard && cp -r packages/dashboard/ui/out dist/dashboard/ && mkdir -p packages/dashboard/ui-dist && cp -r packages/dashboard/ui/out/* packages/dashboard/ui-dist/",
+    "postbuild": "chmod +x dist/src/cli/index.js",
     "dev:watch": "tsc -w",
     "predev": "npm run clean && npm run build:packages && tsc && chmod +x dist/src/cli/index.js",
-    "dev": "concurrently -n daemon,next -c blue,magenta \"npm run dev:daemon\" \"npm run dev:next\"",
-    "dev:daemon": "node dist/src/cli/index.js up --dashboard --port 3889",
-    "dev:next": "cd packages/dashboard/ui && npm run dev",
-    "dev:simple": "node dist/src/cli/index.js up --dashboard --port 3888",
+    "dev": "node dist/src/cli/index.js up --dashboard --port 3888",
     "dev:local": "npm run build && npm link && echo '✓ agent-relay linked globally'",
     "dev:unlink": "npm unlink -g agent-relay && echo '✓ agent-relay unlinked'",
     "dev:rebuild": "npm run build && echo '✓ Rebuilt (linked version updated)'",
     "build:rust": "if command -v ~/.cargo/bin/cargo >/dev/null 2>&1; then cd relay-pty && ~/.cargo/bin/cargo build --release && cp target/release/relay-pty ../bin/relay-pty && node -e \"const os=require('os'); const fs=require('fs'); const p=os.platform(); const a=os.arch(); const name='relay-pty-'+p+'-'+a; fs.copyFileSync('target/release/relay-pty', '../bin/'+name); console.log('✓ relay-pty binary built and copied to bin/ and bin/'+name)\"; else echo '⚠ Rust not installed, using prebuilt binaries from bin/'; fi",
     "start": "node dist/src/cli/index.js",
     "daemon": "node packages/daemon/dist/server.js",
-    "dashboard": "node packages/dashboard-server/dist/start.js",
     "pretest": "npm run build",
     "test": "vitest run",
     "test:integration": "vitest run test/cloud/*.integration.test.ts",
@@ -84,7 +77,7 @@
     "cloud:setup": "./scripts/cloud-setup.sh",
     "cloud:api": "WORKSPACE_IMAGE=relay-workspace:local WORKSPACE_DEV_MOUNT=true node -r dotenv/config packages/cloud/dist/index.js",
     "precloud": "./scripts/cloud-setup.sh --skip-data",
-    "cloud": "concurrently -n api,daemon,dashboard -c cyan,blue,magenta \"npm run cloud:api\" \"npm run dev:daemon\" \"npm run dev:next\"",
+    "cloud": "npm run cloud:api",
     "docs:dev": "cd docs && npm run dev",
     "cli-tester:start": "cd packages/cli-tester && ./scripts/start.sh",
     "cli-tester:start:clean": "cd packages/cli-tester && ./scripts/start.sh --clean",
@@ -114,21 +107,21 @@
   },
   "homepage": "https://github.com/AgentWorkforce/relay#readme",
   "dependencies": {
-    "@agent-relay/bridge": "2.0.21",
-    "@agent-relay/config": "2.0.21",
-    "@agent-relay/continuity": "2.0.21",
-    "@agent-relay/daemon": "2.0.21",
-    "@agent-relay/hooks": "2.0.21",
-    "@agent-relay/mcp": "2.0.21",
-    "@agent-relay/protocol": "2.0.21",
-    "@agent-relay/resiliency": "2.0.21",
-    "@agent-relay/sdk": "2.0.21",
-    "@agent-relay/storage": "2.0.21",
-    "@agent-relay/telemetry": "2.0.21",
-    "@agent-relay/trajectory": "2.0.21",
-    "@agent-relay/user-directory": "2.0.21",
-    "@agent-relay/utils": "2.0.21",
-    "@agent-relay/wrapper": "2.0.21",
+    "@agent-relay/bridge": "2.0.23",
+    "@agent-relay/config": "2.0.23",
+    "@agent-relay/continuity": "2.0.23",
+    "@agent-relay/daemon": "2.0.23",
+    "@agent-relay/hooks": "2.0.23",
+    "@agent-relay/mcp": "2.0.23",
+    "@agent-relay/protocol": "2.0.23",
+    "@agent-relay/resiliency": "2.0.23",
+    "@agent-relay/sdk": "2.0.23",
+    "@agent-relay/storage": "2.0.23",
+    "@agent-relay/telemetry": "2.0.23",
+    "@agent-relay/trajectory": "2.0.23",
+    "@agent-relay/user-directory": "2.0.23",
+    "@agent-relay/utils": "2.0.23",
+    "@agent-relay/wrapper": "2.0.23",
     "@nangohq/node": "^0.69.20",
     "@types/jsonwebtoken": "^9.0.10",
     "agent-trajectories": "^0.2.3",

package/packages/api-types/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/api-types",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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.21",
+  "version": "2.0.23",
   "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.21",
-    "@agent-relay/config": "2.0.21",
-    "@agent-relay/utils": "2.0.21",
-    "@agent-relay/policy": "2.0.21",
-    "@agent-relay/user-directory": "2.0.21",
-    "@agent-relay/wrapper": "2.0.21",
-    "@agent-relay/mcp": "2.0.21"
+    "@agent-relay/protocol": "2.0.23",
+    "@agent-relay/config": "2.0.23",
+    "@agent-relay/utils": "2.0.23",
+    "@agent-relay/policy": "2.0.23",
+    "@agent-relay/user-directory": "2.0.23",
+    "@agent-relay/wrapper": "2.0.23",
+    "@agent-relay/mcp": "2.0.23"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/cli-tester/package.json

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

package/packages/cloud/dist/server.js

@@ -1153,10 +1153,31 @@ export async function createServer() {
     // Teams router - MUST BE LAST among /api routes
     // Handles /workspaces/:id/members and /invites with requireAuth on all routes
     app.use('/api', teamsRouter);
-    // Serve static dashboard files (Next.js static export)
-    // Path: packages/cloud/dist/server.js -> ../../dashboard/ui/out
-    // In Docker: /app/packages/cloud/dist -> /app/packages/dashboard/ui/out
-    const dashboardPath = path.join(__dirname, '../../dashboard/ui/out');
+    // Serve static dashboard files from @agent-relay/dashboard npm package
+    // The npm package exports pre-built Next.js static files in its 'out' directory
+    const npmDashboardPaths = [
+        // When running from packages/cloud/dist/server.js
+        path.join(__dirname, '../../../node_modules/@agent-relay/dashboard/out'),
+        // When running from root node_modules (monorepo hoisting)
+        path.join(__dirname, '../../../../node_modules/@agent-relay/dashboard/out'),
+        // Docker deployment path
+        '/app/node_modules/@agent-relay/dashboard/out',
+    ];
+    // Find the first path that exists
+    let dashboardPath = null;
+    for (const npmPath of npmDashboardPaths) {
+        if (fs.existsSync(npmPath)) {
+            dashboardPath = npmPath;
+            console.log(`[cloud] Serving dashboard from: ${npmPath}`);
+            break;
+        }
+    }
+    if (!dashboardPath) {
+        console.error(`[cloud] Dashboard not found! Install @agent-relay/dashboard package.`);
+        console.error(`[cloud] Checked paths: ${npmDashboardPaths.join(', ')}`);
+        // Use first path as fallback (will 404 but won't crash)
+        dashboardPath = npmDashboardPaths[0];
+    }
     // Serve static files (JS, CSS, images, etc.)
     app.use(express.static(dashboardPath));
     // Handle clean URLs for Next.js static export

package/packages/cloud/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/cloud",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Cloud API server and services for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -38,11 +38,11 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/wrapper": "2.0.21",
-    "@agent-relay/config": "2.0.21",
-    "@agent-relay/resiliency": "2.0.21",
-    "@agent-relay/storage": "2.0.21",
-    "@agent-relay/protocol": "2.0.21"
+    "@agent-relay/wrapper": "2.0.23",
+    "@agent-relay/config": "2.0.23",
+    "@agent-relay/resiliency": "2.0.23",
+    "@agent-relay/storage": "2.0.23",
+    "@agent-relay/protocol": "2.0.23"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/config/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/config",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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.21",
+    "@agent-relay/protocol": "2.0.23",
     "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.21",
+  "version": "2.0.23",
   "description": "Session continuity manager for Relay (ledgers, handoffs, resume)",
   "type": "module",
   "main": "dist/index.js",

package/packages/daemon/dist/orchestrator.js

@@ -19,9 +19,27 @@ const logger = createLogger('orchestrator');
 function generateId() {
     return Math.random().toString(36).substring(2, 15);
 }
+/**
+ * Determine the default host binding.
+ * - In cloud environments (Fly.io, Docker with WORKSPACE_ID), bind to 0.0.0.0 for external access
+ * - Locally, bind to localhost for security
+ * - Can be overridden with AGENT_RELAY_API_HOST env var
+ */
+function getDefaultHost() {
+    // Explicit override
+    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
+    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';
+}
 const DEFAULT_CONFIG = {
     port: 3456,
-    host: 'localhost',
+    host: getDefaultHost(),
     dataDir: path.join(process.env.HOME || '', '.agent-relay', 'orchestrator'),
     autoStartDaemons: true,
 };
@@ -971,6 +989,8 @@ export class Orchestrator extends EventEmitter {
             likelyCause: crashContext.likelyCause,
             crashType: 'heartbeat_failure',
         });
+        // Remove the stale agent from the router so connected-agents.json is accurate
+        workspace?.daemon?.removeStaleAgent(health.agentName);
         logger.error('Agent crashed', {
             workspaceId: health.workspaceId,
             agentName: health.agentName,

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

@@ -225,6 +225,11 @@ export declare class Router {
      * Get connection by agent name.
      */
     getConnection(agentName: string): RoutableConnection | undefined;
+    /**
+     * Force remove an agent from the router (used when process dies without clean disconnect).
+     * This cleans up the agent's connection and subscriptions without needing the connection object.
+     */
+    forceRemoveAgent(agentName: string): boolean;
     /**
      * Get number of active connections.
      */

package/packages/daemon/dist/router.js

@@ -876,6 +876,37 @@ export class Router {
     getConnection(agentName) {
         return this.agents.get(agentName);
     }
+    /**
+     * Force remove an agent from the router (used when process dies without clean disconnect).
+     * This cleans up the agent's connection and subscriptions without needing the connection object.
+     */
+    forceRemoveAgent(agentName) {
+        const connection = this.agents.get(agentName);
+        if (!connection) {
+            routerLog.debug(`forceRemoveAgent: agent ${agentName} not found in router`);
+            return false;
+        }
+        routerLog.info(`Force removing stale agent: ${agentName}`);
+        // Remove from agents map
+        this.agents.delete(agentName);
+        // Remove from all channel subscriptions
+        for (const [channel, subscribers] of this.subscriptions) {
+            if (subscribers.delete(agentName)) {
+                routerLog.debug(`Removed ${agentName} from channel ${channel}`);
+            }
+        }
+        // Remove from connections map
+        this.connections.delete(connection.id);
+        // Clear any pending deliveries
+        this.deliveryTracker.clearPendingForConnection(connection.id);
+        // Clean up channel memberships (same as unregister)
+        this.removeFromAllChannels(agentName);
+        // Clean up shadow relationships
+        this.unbindShadow(agentName);
+        // Clear processing state
+        this.clearProcessing(agentName);
+        return true;
+    }
     /**
      * Get number of active connections.
      */

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

@@ -80,6 +80,11 @@ export declare class Daemon {
      * Called when spawn fails or is cancelled (successful registration clears automatically).
      */
     clearSpawning(agentName: string): void;
+    /**
+     * Remove a stale agent from the router (used when process dies without clean disconnect).
+     * This is called by the orchestrator's health monitoring when a PID is detected as dead.
+     */
+    removeStaleAgent(agentName: string): boolean;
     /**
      * Initialize storage adapter (called during start).
      */