agent-relay 2.0.21 → 2.0.22

package/packages/sdk/dist/protocol/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.
@@ -410,6 +410,36 @@ export interface AgentInfo {
 export interface ListAgentsResponsePayload {
     agents: AgentInfo[];
 }
+/**
+ * Payload for LIST_CONNECTED_AGENTS request.
+ * Returns only currently connected agents (not historical/registered agents).
+ */
+export interface ListConnectedAgentsPayload {
+    project?: string;
+}
+/**
+ * Response payload for LIST_CONNECTED_AGENTS request.
+ */
+export interface ListConnectedAgentsResponsePayload {
+    agents: AgentInfo[];
+}
+/**
+ * Payload for REMOVE_AGENT request.
+ * Removes an agent from the registry (sessions, agents.json).
+ */
+export interface RemoveAgentPayload {
+    name: string;
+    /** If true, also removes all messages from/to this agent */
+    removeMessages?: boolean;
+}
+/**
+ * Response payload for REMOVE_AGENT request.
+ */
+export interface RemoveAgentResponsePayload {
+    success: boolean;
+    removed: boolean;
+    message?: string;
+}
 /**
  * Payload for HEALTH request.
  */
@@ -519,6 +549,10 @@ 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>;
 export type HealthEnvelope = Envelope<HealthPayload>;
 export type HealthResponseEnvelope = Envelope<HealthResponsePayload>;
 export type MetricsEnvelope = Envelope<MetricsPayload>;

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.21"
+    "@agent-relay/protocol": "2.0.22"
   },
   "engines": {
     "node": ">=18.0.0"

package/packages/spawner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/spawner",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Agent spawning types and utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/state/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/state",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)",
   "type": "module",
   "main": "dist/index.js",

package/packages/storage/dist/adapter.d.ts

@@ -96,6 +96,10 @@ export interface StorageAdapter {
     }>>;
     /** Get channels that an agent is a member of (based on stored membership events) */
     getChannelMembershipsForAgent?(memberName: string): Promise<string[]>;
+    /** Remove an agent from sessions table */
+    removeAgent?(agentName: string): Promise<void>;
+    /** Remove all messages from/to an agent */
+    removeMessagesForAgent?(agentName: string): Promise<void>;
 }
 /**
  * Storage configuration options.

package/packages/storage/dist/sqlite-adapter.d.ts

@@ -109,5 +109,15 @@ export declare class SqliteStorageAdapter implements StorageAdapter {
      * @returns List of channel names where the agent's latest action is not "leave"
      */
     getChannelMembershipsForAgent(memberName: string): Promise<string[]>;
+    /**
+     * Remove an agent from the sessions table.
+     * This is used to clean up stale agents from the registry.
+     */
+    removeAgent(agentName: string): Promise<void>;
+    /**
+     * Remove all messages from/to an agent.
+     * Use with caution - this permanently deletes message history.
+     */
+    removeMessagesForAgent(agentName: string): Promise<void>;
 }
 //# sourceMappingURL=sqlite-adapter.d.ts.map

package/packages/storage/dist/sqlite-adapter.js

@@ -750,5 +750,31 @@ export class SqliteStorageAdapter {
         const rows = stmt.all(memberName);
         return rows.map(row => row.channel);
     }
+    /**
+     * Remove an agent from the sessions table.
+     * This is used to clean up stale agents from the registry.
+     */
+    async removeAgent(agentName) {
+        if (!this.db) {
+            await this.init();
+        }
+        const stmt = this.db.prepare(`
+      DELETE FROM sessions WHERE agent_name = ?
+    `);
+        stmt.run(agentName);
+    }
+    /**
+     * Remove all messages from/to an agent.
+     * Use with caution - this permanently deletes message history.
+     */
+    async removeMessagesForAgent(agentName) {
+        if (!this.db) {
+            await this.init();
+        }
+        const stmt = this.db.prepare(`
+      DELETE FROM messages WHERE sender = ? OR recipient = ?
+    `);
+        stmt.run(agentName, agentName);
+    }
 }
 //# sourceMappingURL=sqlite-adapter.js.map

package/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/storage",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Storage adapters and interfaces for Relay message/session persistence",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     }
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.21"
+    "@agent-relay/protocol": "2.0.22"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Anonymous telemetry for Agent Relay usage analytics",
   "type": "module",
   "main": "dist/index.js",

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/trajectory",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Trajectory integration utilities (trail/PDERO) for Relay",
   "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.22"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "User directory service for agent-relay (per-user credential storage)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/resiliency": "2.0.21"
+    "@agent-relay/resiliency": "2.0.22"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/index.js",

package/packages/wrapper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/wrapper",
-  "version": "2.0.21",
+  "version": "2.0.22",
   "description": "CLI agent wrappers for Agent Relay - tmux, pty integration",
   "type": "module",
   "main": "dist/index.js",
@@ -30,11 +30,11 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agent-relay/api-types": "2.0.21",
-    "@agent-relay/protocol": "2.0.21",
-    "@agent-relay/config": "2.0.21",
-    "@agent-relay/continuity": "2.0.21",
-    "@agent-relay/resiliency": "2.0.21"
+    "@agent-relay/api-types": "2.0.22",
+    "@agent-relay/protocol": "2.0.22",
+    "@agent-relay/config": "2.0.22",
+    "@agent-relay/continuity": "2.0.22",
+    "@agent-relay/resiliency": "2.0.22"
   },
   "devDependencies": {
     "typescript": "^5.9.3",