agent-relay 2.0.21 → 2.0.23

package/packages/daemon/dist/server.js

@@ -178,6 +178,21 @@ export class Daemon {
     clearSpawning(agentName) {
         this.router.clearSpawning(agentName);
     }
+    /**
+     * 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) {
+        const removed = this.router.forceRemoveAgent(agentName);
+        if (removed) {
+            // Notify cloud sync about agent removal
+            this.notifyCloudSync();
+            // Update connected-agents.json to reflect the removal
+            this.writeConnectedAgentsFile();
+            log.info('Removed stale agent from router', { agentName });
+        }
+        return removed;
+    }
     /**
      * Initialize storage adapter (called during start).
      */
@@ -1170,7 +1185,8 @@ export class Daemon {
                         name,
                         cli: registryAgent?.cli,
                         idle: false, // Connected agents are not idle
-                        parent: registryAgent?.task?.includes('spawned by') ? 'parent' : undefined,
+                        // TODO: Add proper parent tracking via spawner relationship
+                        parent: undefined,
                     };
                 });
                 // Optionally include idle agents from registry
@@ -1196,6 +1212,120 @@ export class Daemon {
                 connection.send(response);
                 break;
             }
+            case 'LIST_CONNECTED_AGENTS': {
+                // Returns only currently connected agents (not historical/registered agents)
+                const connectedAgents = this.router.getAgents();
+                const registryAgents = this.registry?.getAgents() ?? [];
+                const registryMap = new Map(registryAgents.map(a => [a.name, a]));
+                const agents = connectedAgents
+                    .filter(name => !this.isInternalAgent(name))
+                    .map(name => {
+                    const registryAgent = registryMap.get(name);
+                    return {
+                        name,
+                        cli: registryAgent?.cli,
+                        idle: false,
+                        // TODO: Add proper parent tracking via spawner relationship
+                        parent: undefined,
+                    };
+                });
+                const connectedResponse = {
+                    v: PROTOCOL_VERSION,
+                    type: 'LIST_CONNECTED_AGENTS_RESPONSE',
+                    id: envelope.id,
+                    ts: Date.now(),
+                    payload: { agents },
+                };
+                connection.send(connectedResponse);
+                break;
+            }
+            case 'REMOVE_AGENT': {
+                const removePayload = envelope.payload;
+                const agentName = removePayload.name;
+                // Validate agent name
+                if (!agentName || typeof agentName !== 'string' || agentName.length === 0) {
+                    const errorResponse = {
+                        v: PROTOCOL_VERSION,
+                        type: 'REMOVE_AGENT_RESPONSE',
+                        id: envelope.id,
+                        ts: Date.now(),
+                        payload: { success: false, removed: false, message: 'Invalid agent name: name is required' },
+                    };
+                    connection.send(errorResponse);
+                    break;
+                }
+                if (agentName.length > 128) {
+                    const errorResponse = {
+                        v: PROTOCOL_VERSION,
+                        type: 'REMOVE_AGENT_RESPONSE',
+                        id: envelope.id,
+                        ts: Date.now(),
+                        payload: { success: false, removed: false, message: 'Invalid agent name: exceeds 128 characters' },
+                    };
+                    connection.send(errorResponse);
+                    break;
+                }
+                const doRemove = async () => {
+                    let removed = false;
+                    let message = '';
+                    // Remove from registry (agents.json)
+                    if (this.registry) {
+                        const wasInRegistry = this.registry.getAgents().some(a => a.name === agentName);
+                        if (wasInRegistry) {
+                            this.registry.remove(agentName);
+                            removed = true;
+                            message = `Removed ${agentName} from registry`;
+                        }
+                    }
+                    // Remove from storage (sessions table) if storage is available
+                    if (this.storage?.removeAgent) {
+                        await this.storage.removeAgent(agentName);
+                        if (!removed) {
+                            removed = true;
+                            message = `Removed ${agentName} from storage`;
+                        }
+                        else {
+                            message += ' and storage';
+                        }
+                    }
+                    // Optionally remove messages
+                    if (removePayload.removeMessages && this.storage?.removeMessagesForAgent) {
+                        await this.storage.removeMessagesForAgent(agentName);
+                        message += ' (including messages)';
+                    }
+                    // Force remove from router if still connected (shouldn't be, but just in case)
+                    if (this.router.forceRemoveAgent(agentName)) {
+                        message += ', disconnected from router';
+                        // Notify cloud sync and update connected-agents.json
+                        this.notifyCloudSync();
+                        this.writeConnectedAgentsFile();
+                    }
+                    if (!removed) {
+                        message = `Agent ${agentName} not found in registry or storage`;
+                    }
+                    return { removed, message };
+                };
+                doRemove().then(({ removed, message }) => {
+                    const removeResponse = {
+                        v: PROTOCOL_VERSION,
+                        type: 'REMOVE_AGENT_RESPONSE',
+                        id: envelope.id,
+                        ts: Date.now(),
+                        payload: { success: removed, removed, message },
+                    };
+                    connection.send(removeResponse);
+                }).catch(err => {
+                    const removeResponse = {
+                        v: PROTOCOL_VERSION,
+                        type: 'REMOVE_AGENT_RESPONSE',
+                        id: envelope.id,
+                        ts: Date.now(),
+                        payload: { success: false, removed: false, message: `Error: ${err.message}` },
+                    };
+                    connection.send(removeResponse);
+                });
+                break;
+            }
             case 'HEALTH': {
                 const healthPayload = envelope.payload;
                 // Compute health based on available data

package/packages/daemon/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/daemon",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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.21",
-    "@agent-relay/config": "2.0.21",
-    "@agent-relay/storage": "2.0.21",
-    "@agent-relay/bridge": "2.0.21",
-    "@agent-relay/utils": "2.0.21",
-    "@agent-relay/policy": "2.0.21",
-    "@agent-relay/memory": "2.0.21",
-    "@agent-relay/resiliency": "2.0.21",
-    "@agent-relay/user-directory": "2.0.21",
-    "@agent-relay/wrapper": "2.0.21",
-    "@agent-relay/telemetry": "2.0.21",
+    "@agent-relay/protocol": "2.0.23",
+    "@agent-relay/config": "2.0.23",
+    "@agent-relay/storage": "2.0.23",
+    "@agent-relay/bridge": "2.0.23",
+    "@agent-relay/utils": "2.0.23",
+    "@agent-relay/policy": "2.0.23",
+    "@agent-relay/memory": "2.0.23",
+    "@agent-relay/resiliency": "2.0.23",
+    "@agent-relay/user-directory": "2.0.23",
+    "@agent-relay/wrapper": "2.0.23",
+    "@agent-relay/telemetry": "2.0.23",
     "ws": "^8.18.3",
     "better-sqlite3": "^12.6.2",
     "pg": "^8.16.3",

package/packages/hooks/package.json

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

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

@@ -102,6 +102,21 @@ export interface RelayClient {
         idle?: boolean;
         parent?: string;
     }>>;
+    listConnectedAgents(options?: {
+        project?: string;
+    }): Promise<Array<{
+        name: string;
+        cli?: string;
+        idle?: boolean;
+        parent?: string;
+    }>>;
+    removeAgent(name: string, options?: {
+        removeMessages?: boolean;
+    }): Promise<{
+        success: boolean;
+        removed: boolean;
+        message?: string;
+    }>;
     getHealth(options?: {
         include_crashes?: boolean;
         include_alerts?: boolean;

package/packages/mcp/dist/client.js

@@ -252,6 +252,15 @@ export function createRelayClient(options) {
             const response = await request('LIST_AGENTS', payload);
             return response.agents || [];
         },
+        async listConnectedAgents(opts = {}) {
+            const payload = { project: opts.project };
+            const response = await request('LIST_CONNECTED_AGENTS', payload);
+            return response.agents || [];
+        },
+        async removeAgent(name, opts = {}) {
+            const payload = { name, removeMessages: opts.removeMessages };
+            return request('REMOVE_AGENT', payload);
+        },
         async getHealth(opts = {}) {
             const payload = {
                 includeCrashes: opts.include_crashes,

package/packages/mcp/dist/server.js

@@ -1,7 +1,7 @@
 import { Server } from '@modelcontextprotocol/sdk/server/index.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { CallToolRequestSchema, ListToolsRequestSchema, ListPromptsRequestSchema, GetPromptRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
-import { relaySendTool, relaySendSchema, handleRelaySend, relayInboxTool, relayInboxSchema, handleRelayInbox, relayWhoTool, relayWhoSchema, handleRelayWho, relaySpawnTool, relaySpawnSchema, handleRelaySpawn, relayReleaseTool, relayReleaseSchema, handleRelayRelease, relayStatusTool, relayStatusSchema, handleRelayStatus, relayLogsTool, relayLogsSchema, handleRelayLogs, relayMetricsTool, relayMetricsSchema, handleRelayMetrics, relayHealthTool, relayHealthSchema, handleRelayHealth, relayContinuityTool, relayContinuitySchema, handleRelayContinuity, } from './tools/index.js';
+import { relaySendTool, relaySendSchema, handleRelaySend, relayInboxTool, relayInboxSchema, handleRelayInbox, relayWhoTool, relayWhoSchema, handleRelayWho, relaySpawnTool, relaySpawnSchema, handleRelaySpawn, relayReleaseTool, relayReleaseSchema, handleRelayRelease, relayStatusTool, relayStatusSchema, handleRelayStatus, relayLogsTool, relayLogsSchema, handleRelayLogs, relayMetricsTool, relayMetricsSchema, handleRelayMetrics, relayHealthTool, relayHealthSchema, handleRelayHealth, relayContinuityTool, relayContinuitySchema, handleRelayContinuity, relayConnectedTool, relayConnectedSchema, handleRelayConnected, relayRemoveAgentTool, relayRemoveAgentSchema, handleRelayRemoveAgent, } from './tools/index.js';
 import { protocolPrompt, getProtocolPrompt } from './prompts/index.js';
 import { agentsResource, getAgentsResource, inboxResource, getInboxResource, projectResource, getProjectResource, } from './resources/index.js';
 /**
@@ -11,8 +11,10 @@ const TOOLS = [
     relaySendTool,
     relayInboxTool,
     relayWhoTool,
+    relayConnectedTool,
     relaySpawnTool,
     relayReleaseTool,
+    relayRemoveAgentTool,
     relayStatusTool,
     relayLogsTool,
     relayMetricsTool,
@@ -68,6 +70,11 @@ export function createMCPServer(client, config) {
                     result = await handleRelayWho(client, input);
                     break;
                 }
+                case 'relay_connected': {
+                    const input = relayConnectedSchema.parse(args);
+                    result = await handleRelayConnected(client, input);
+                    break;
+                }
                 case 'relay_spawn': {
                     const input = relaySpawnSchema.parse(args);
                     result = await handleRelaySpawn(client, input);
@@ -78,6 +85,11 @@ export function createMCPServer(client, config) {
                     result = await handleRelayRelease(client, input);
                     break;
                 }
+                case 'relay_remove_agent': {
+                    const input = relayRemoveAgentSchema.parse(args);
+                    result = await handleRelayRemoveAgent(client, input);
+                    break;
+                }
                 case 'relay_status': {
                     const input = relayStatusSchema.parse(args);
                     result = await handleRelayStatus(client, input);

package/packages/mcp/dist/tools/index.d.ts

@@ -8,4 +8,6 @@ export { relayLogsTool, relayLogsSchema, handleRelayLogs, type RelayLogsInput, }
 export { relayMetricsTool, relayMetricsSchema, handleRelayMetrics, type RelayMetricsInput, } from './relay-metrics.js';
 export { relayHealthTool, relayHealthSchema, handleRelayHealth, type RelayHealthInput, } from './relay-health.js';
 export { relayContinuityTool, relayContinuitySchema, handleRelayContinuity, type RelayContinuityInput, } from './relay-continuity.js';
+export { relayConnectedTool, relayConnectedSchema, handleRelayConnected, type RelayConnectedInput, } from './relay-connected.js';
+export { relayRemoveAgentTool, relayRemoveAgentSchema, handleRelayRemoveAgent, type RelayRemoveAgentInput, } from './relay-remove-agent.js';
 //# sourceMappingURL=index.d.ts.map

package/packages/mcp/dist/tools/index.js

@@ -8,4 +8,6 @@ export { relayLogsTool, relayLogsSchema, handleRelayLogs, } from './relay-logs.j
 export { relayMetricsTool, relayMetricsSchema, handleRelayMetrics, } from './relay-metrics.js';
 export { relayHealthTool, relayHealthSchema, handleRelayHealth, } from './relay-health.js';
 export { relayContinuityTool, relayContinuitySchema, handleRelayContinuity, } from './relay-continuity.js';
+export { relayConnectedTool, relayConnectedSchema, handleRelayConnected, } from './relay-connected.js';
+export { relayRemoveAgentTool, relayRemoveAgentSchema, handleRelayRemoveAgent, } from './relay-remove-agent.js';
 //# sourceMappingURL=index.js.map

package/packages/mcp/dist/tools/relay-connected.d.ts

@@ -0,0 +1,17 @@
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+export declare const relayConnectedSchema: z.ZodObject<{
+    project: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    project?: string | undefined;
+}, {
+    project?: string | undefined;
+}>;
+export type RelayConnectedInput = z.infer<typeof relayConnectedSchema>;
+export declare const relayConnectedTool: Tool;
+/**
+ * List only currently connected agents (not historical/registered).
+ */
+export declare function handleRelayConnected(client: RelayClient, input: RelayConnectedInput): Promise<string>;
+//# sourceMappingURL=relay-connected.d.ts.map

package/packages/mcp/dist/tools/relay-connected.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+export const relayConnectedSchema = z.object({
+    project: z.string().optional().describe('Filter by project (for multi-project setups)'),
+});
+export const relayConnectedTool = {
+    name: 'relay_connected',
+    description: `List only currently connected agents in the relay network.
+
+Unlike relay_who which includes historical/registered agents, this only shows
+agents that are actively connected right now. Use this for accurate liveness checks.
+
+Example output:
+- Alice (claude) - connected
+- Bob (codex) - connected`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            project: {
+                type: 'string',
+                description: 'Filter by project',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * List only currently connected agents (not historical/registered).
+ */
+export async function handleRelayConnected(client, input) {
+    const agents = await client.listConnectedAgents(input);
+    if (agents.length === 0) {
+        return 'No agents currently connected.';
+    }
+    const formatted = agents.map((a) => {
+        const worker = a.parent ? ` [worker of: ${a.parent}]` : '';
+        return `- ${a.name} (${a.cli || 'unknown'}) - connected${worker}`;
+    });
+    return `${agents.length} agent(s) currently connected:\n${formatted.join('\n')}`;
+}
+//# sourceMappingURL=relay-connected.js.map

package/packages/mcp/dist/tools/relay-remove-agent.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+export declare const relayRemoveAgentSchema: z.ZodObject<{
+    name: z.ZodString;
+    remove_messages: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    remove_messages: boolean;
+}, {
+    name: string;
+    remove_messages?: boolean | undefined;
+}>;
+export type RelayRemoveAgentInput = z.infer<typeof relayRemoveAgentSchema>;
+export declare const relayRemoveAgentTool: Tool;
+/**
+ * Remove an agent from the registry.
+ */
+export declare function handleRelayRemoveAgent(client: RelayClient, input: RelayRemoveAgentInput): Promise<string>;
+//# sourceMappingURL=relay-remove-agent.d.ts.map

package/packages/mcp/dist/tools/relay-remove-agent.js

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+export const relayRemoveAgentSchema = z.object({
+    name: z.string().describe('Name of the agent to remove from the registry'),
+    remove_messages: z.boolean().optional().default(false).describe('Also remove all messages from/to this agent'),
+});
+export const relayRemoveAgentTool = {
+    name: 'relay_remove_agent',
+    description: `Remove a stale agent from the relay registry.
+
+Use this to clean up agents that are no longer needed or have become stale.
+This removes the agent from:
+- The agent registry (agents.json)
+- The sessions table in storage
+- Optionally, all messages from/to this agent
+
+WARNING: This permanently removes the agent's history. Use with caution.`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Name of the agent to remove',
+            },
+            remove_messages: {
+                type: 'boolean',
+                description: 'Also remove all messages from/to this agent',
+                default: false,
+            },
+        },
+        required: ['name'],
+    },
+};
+/**
+ * Remove an agent from the registry.
+ */
+export async function handleRelayRemoveAgent(client, input) {
+    const result = await client.removeAgent(input.name, {
+        removeMessages: input.remove_messages,
+    });
+    if (result.success && result.removed) {
+        return `✓ ${result.message}`;
+    }
+    else if (result.success && !result.removed) {
+        return `Agent "${input.name}" was not found in registry or storage.`;
+    }
+    else {
+        return `✗ Failed to remove agent: ${result.message}`;
+    }
+}
+//# sourceMappingURL=relay-remove-agent.js.map

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/mcp",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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",
@@ -47,7 +47,7 @@
     "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "dependencies": {
-    "@agent-relay/config": "2.0.21",
+    "@agent-relay/config": "2.0.23",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "smol-toml": "^1.6.0",
     "zod": "^3.23.8"

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/memory",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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.21"
+    "@agent-relay/hooks": "2.0.23"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/policy/package.json

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

package/packages/protocol/dist/types.d.ts

@@ -5,7 +5,7 @@
  * These types define the wire protocol for agent-to-agent communication.
  */
 export declare const PROTOCOL_VERSION = 1;
-export type MessageType = 'HELLO' | 'WELCOME' | 'SEND' | 'DELIVER' | 'ACK' | 'NACK' | 'PING' | 'PONG' | 'ERROR' | 'BUSY' | 'RESUME' | 'BYE' | 'STATE' | 'SYNC' | 'SYNC_SNAPSHOT' | 'SYNC_DELTA' | 'SUBSCRIBE' | 'UNSUBSCRIBE' | 'SHADOW_BIND' | 'SHADOW_UNBIND' | 'LOG' | 'CHANNEL_JOIN' | 'CHANNEL_LEAVE' | 'CHANNEL_MESSAGE' | 'CHANNEL_INFO' | 'CHANNEL_MEMBERS' | 'CHANNEL_TYPING' | 'SPAWN' | 'SPAWN_RESULT' | 'RELEASE' | 'RELEASE_RESULT' | 'STATUS' | 'STATUS_RESPONSE' | 'INBOX' | 'INBOX_RESPONSE' | 'LIST_AGENTS' | 'LIST_AGENTS_RESPONSE' | 'HEALTH' | 'HEALTH_RESPONSE' | 'METRICS' | 'METRICS_RESPONSE';
+export type MessageType = 'HELLO' | 'WELCOME' | 'SEND' | 'DELIVER' | 'ACK' | 'NACK' | 'PING' | 'PONG' | 'ERROR' | 'BUSY' | 'RESUME' | 'BYE' | 'STATE' | 'SYNC' | 'SYNC_SNAPSHOT' | 'SYNC_DELTA' | 'SUBSCRIBE' | 'UNSUBSCRIBE' | 'SHADOW_BIND' | 'SHADOW_UNBIND' | 'LOG' | 'CHANNEL_JOIN' | 'CHANNEL_LEAVE' | 'CHANNEL_MESSAGE' | 'CHANNEL_INFO' | 'CHANNEL_MEMBERS' | 'CHANNEL_TYPING' | 'SPAWN' | 'SPAWN_RESULT' | 'RELEASE' | 'RELEASE_RESULT' | 'STATUS' | 'STATUS_RESPONSE' | 'INBOX' | 'INBOX_RESPONSE' | 'LIST_AGENTS' | 'LIST_AGENTS_RESPONSE' | 'LIST_CONNECTED_AGENTS' | 'LIST_CONNECTED_AGENTS_RESPONSE' | 'REMOVE_AGENT' | 'REMOVE_AGENT_RESPONSE' | 'HEALTH' | 'HEALTH_RESPONSE' | 'METRICS' | 'METRICS_RESPONSE';
 export type PayloadKind = 'message' | 'action' | 'state' | 'thinking';
 /**
  * Base envelope structure for all protocol messages.
@@ -412,12 +412,57 @@ export interface ListAgentsResponsePayload {
         parent?: string;
     }>;
 }
+/**
+ * Payload for LIST_CONNECTED_AGENTS request.
+ * Returns only currently connected agents (not historical/registered agents).
+ */
+export interface ListConnectedAgentsPayload {
+    /** Filter by project */
+    project?: string;
+}
+/**
+ * Payload for LIST_CONNECTED_AGENTS_RESPONSE.
+ */
+export interface ListConnectedAgentsResponsePayload {
+    /** List of currently connected agents */
+    agents: Array<{
+        name: string;
+        cli?: string;
+        idle?: boolean;
+        parent?: string;
+    }>;
+}
+/**
+ * Payload for REMOVE_AGENT request.
+ * Removes an agent from the registry (sessions, agents.json).
+ */
+export interface RemoveAgentPayload {
+    /** Agent name to remove */
+    name: string;
+    /** If true, also removes all messages from/to this agent */
+    removeMessages?: boolean;
+}
+/**
+ * Payload for REMOVE_AGENT_RESPONSE.
+ */
+export interface RemoveAgentResponsePayload {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Whether an agent was actually removed */
+    removed: boolean;
+    /** Human-readable message */
+    message?: string;
+}
 export type StatusEnvelope = Envelope<StatusPayload>;
 export type StatusResponseEnvelope = Envelope<StatusResponsePayload>;
 export type InboxEnvelope = Envelope<InboxPayload>;
 export type InboxResponseEnvelope = Envelope<InboxResponsePayload>;
 export type ListAgentsEnvelope = Envelope<ListAgentsPayload>;
 export type ListAgentsResponseEnvelope = Envelope<ListAgentsResponsePayload>;
+export type ListConnectedAgentsEnvelope = Envelope<ListConnectedAgentsPayload>;
+export type ListConnectedAgentsResponseEnvelope = Envelope<ListConnectedAgentsResponsePayload>;
+export type RemoveAgentEnvelope = Envelope<RemoveAgentPayload>;
+export type RemoveAgentResponseEnvelope = Envelope<RemoveAgentResponsePayload>;
 /**
  * Payload for HEALTH request.
  */

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Wire protocol types and framing for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/resiliency/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/resiliency",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

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

@@ -4,7 +4,7 @@
  *
  * Lightweight client for agent-to-agent communication via Agent Relay daemon.
  */
-import { type Envelope, type SendPayload, type SendMeta, type AckPayload, type PayloadKind, type SpeakOnTrigger, type EntityType, type ChannelMessagePayload, type MessageAttachment, type SpawnResultPayload, type ReleaseResultPayload, type StatusResponsePayload, type InboxMessage, type AgentInfo, type HealthResponsePayload, type MetricsResponsePayload, type CreateProposalOptions, type VoteOptions } from './protocol/types.js';
+import { type Envelope, type SendPayload, type SendMeta, type AckPayload, type PayloadKind, type SpeakOnTrigger, type EntityType, type ChannelMessagePayload, type MessageAttachment, type SpawnResultPayload, type ReleaseResultPayload, type StatusResponsePayload, type InboxMessage, type AgentInfo, type RemoveAgentResponsePayload, type HealthResponsePayload, type MetricsResponsePayload, type CreateProposalOptions, type VoteOptions } from './protocol/types.js';
 export type ClientState = 'DISCONNECTED' | 'CONNECTING' | 'HANDSHAKING' | 'READY' | 'BACKOFF';
 export interface SyncOptions {
     timeoutMs?: number;
@@ -289,6 +289,27 @@ export declare class RelayClient {
     getMetrics(options?: {
         agent?: string;
     }): Promise<MetricsResponsePayload>;
+    /**
+     * List only currently connected agents (not historical/registered agents).
+     * Use this instead of listAgents() when you need accurate liveness information.
+     * @param options - Filter options
+     * @param options.project - Filter by project
+     * @returns Array of currently connected agent info
+     */
+    listConnectedAgents(options?: {
+        project?: string;
+    }): Promise<AgentInfo[]>;
+    /**
+     * Remove an agent from the registry (sessions, agents.json).
+     * Use this to clean up stale agents that are no longer needed.
+     * @param name - Agent name to remove
+     * @param options - Removal options
+     * @param options.removeMessages - Also remove all messages from/to this agent (default: false)
+     * @returns Result indicating if the agent was removed
+     */
+    removeAgent(name: string, options?: {
+        removeMessages?: boolean;
+    }): Promise<RemoveAgentResponsePayload>;
     private setState;
     private sendHello;
     private send;