agent-relay 2.0.21 → 2.0.23

package/packages/sdk/dist/client.js

@@ -731,6 +731,35 @@ export class RelayClient {
         };
         return this.query('METRICS', payload);
     }
+    /**
+     * 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
+     */
+    async listConnectedAgents(options = {}) {
+        const payload = {
+            project: options.project,
+        };
+        const response = await this.query('LIST_CONNECTED_AGENTS', payload);
+        return response.agents || [];
+    }
+    /**
+     * 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
+     */
+    async removeAgent(name, options = {}) {
+        const payload = {
+            name,
+            removeMessages: options.removeMessages,
+        };
+        return this.query('REMOVE_AGENT', payload);
+    }
     // Private methods
     setState(state) {
         this._state = state;
@@ -839,6 +868,8 @@ export class RelayClient {
             case 'STATUS_RESPONSE':
             case 'INBOX_RESPONSE':
             case 'LIST_AGENTS_RESPONSE':
+            case 'LIST_CONNECTED_AGENTS_RESPONSE':
+            case 'REMOVE_AGENT_RESPONSE':
             case 'HEALTH_RESPONSE':
             case 'METRICS_RESPONSE':
                 this.handleQueryResponse(envelope);

package/packages/sdk/dist/protocol/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * Protocol exports for @agent-relay/sdk
  */
-export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type HelloPayload, type WelcomePayload, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type NackPayload, type BusyPayload, type PingPayload, type PongPayload, type ErrorCode, type ErrorPayload, type LogPayload, type SyncStream, type SyncPayload, type SpeakOnTrigger, type ShadowConfig, type ShadowBindPayload, type ShadowUnbindPayload, type SpawnPayload, type SpawnPolicyDecision, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, type MessageAttachment, type ChannelJoinPayload, type ChannelLeavePayload, type ChannelMessagePayload, type StatusPayload, type StatusResponsePayload, type InboxPayload, type InboxMessage, type InboxResponsePayload, type ListAgentsPayload, type AgentInfo, type ListAgentsResponsePayload, type HealthPayload, type CrashRecord, type AlertRecord, type HealthResponsePayload, type MetricsPayload, type AgentMetrics, type MetricsResponsePayload, type HelloEnvelope, type WelcomeEnvelope, type SendEnvelope, type DeliverEnvelope, type AckEnvelope, type NackEnvelope, type PingEnvelope, type PongEnvelope, type ErrorEnvelope, type BusyEnvelope, type LogEnvelope, type SyncEnvelope, type ShadowBindEnvelope, type ShadowUnbindEnvelope, type SpawnEnvelope, type SpawnResultEnvelope, type ReleaseEnvelope, type ReleaseResultEnvelope, type ChannelJoinEnvelope, type ChannelLeaveEnvelope, type ChannelMessageEnvelope, type StatusEnvelope, type StatusResponseEnvelope, type InboxEnvelope, type InboxResponseEnvelope, type ListAgentsEnvelope, type ListAgentsResponseEnvelope, type HealthEnvelope, type HealthResponseEnvelope, type MetricsEnvelope, type MetricsResponseEnvelope, } from './types.js';
+export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type HelloPayload, type WelcomePayload, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type NackPayload, type BusyPayload, type PingPayload, type PongPayload, type ErrorCode, type ErrorPayload, type LogPayload, type SyncStream, type SyncPayload, type SpeakOnTrigger, type ShadowConfig, type ShadowBindPayload, type ShadowUnbindPayload, type SpawnPayload, type SpawnPolicyDecision, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, type MessageAttachment, type ChannelJoinPayload, type ChannelLeavePayload, type ChannelMessagePayload, type StatusPayload, type StatusResponsePayload, type InboxPayload, type InboxMessage, type InboxResponsePayload, type ListAgentsPayload, type AgentInfo, type ListAgentsResponsePayload, type ListConnectedAgentsPayload, type ListConnectedAgentsResponsePayload, type RemoveAgentPayload, type RemoveAgentResponsePayload, type HealthPayload, type CrashRecord, type AlertRecord, type HealthResponsePayload, type MetricsPayload, type AgentMetrics, type MetricsResponsePayload, type HelloEnvelope, type WelcomeEnvelope, type SendEnvelope, type DeliverEnvelope, type AckEnvelope, type NackEnvelope, type PingEnvelope, type PongEnvelope, type ErrorEnvelope, type BusyEnvelope, type LogEnvelope, type SyncEnvelope, type ShadowBindEnvelope, type ShadowUnbindEnvelope, type SpawnEnvelope, type SpawnResultEnvelope, type ReleaseEnvelope, type ReleaseResultEnvelope, type ChannelJoinEnvelope, type ChannelLeaveEnvelope, type ChannelMessageEnvelope, type StatusEnvelope, type StatusResponseEnvelope, type InboxEnvelope, type InboxResponseEnvelope, type ListAgentsEnvelope, type ListAgentsResponseEnvelope, type ListConnectedAgentsEnvelope, type ListConnectedAgentsResponseEnvelope, type RemoveAgentEnvelope, type RemoveAgentResponseEnvelope, type HealthEnvelope, type HealthResponseEnvelope, type MetricsEnvelope, type MetricsResponseEnvelope, } from './types.js';
 export { MAX_FRAME_BYTES, HEADER_SIZE, LEGACY_HEADER_SIZE, type WireFormat, initMessagePack, hasMessagePack, encodeFrame, encodeFrameLegacy, FrameParser, } from './framing.js';
 //# sourceMappingURL=index.d.ts.map

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.23",
   "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.23"
   },
   "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.23",
   "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.23",
   "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.23",
   "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.23"
   },
   "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.23",
   "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.23",
   "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.23"
   },
   "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.23",
   "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.23"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/dist/update-checker.js

@@ -160,6 +160,10 @@ export function printUpdateNotification(info) {
  * This is non-blocking and errors are silently ignored.
  */
 export function checkForUpdatesInBackground(currentVersion) {
+    // Skip update check in test environments
+    if (process.env.AGENT_RELAY_SKIP_UPDATE_CHECK === '1') {
+        return;
+    }
     // Run async check without awaiting
     checkForUpdates(currentVersion)
         .then(info => {

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "2.0.21",
+  "version": "2.0.23",
   "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.23",
   "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.23",
+    "@agent-relay/protocol": "2.0.23",
+    "@agent-relay/config": "2.0.23",
+    "@agent-relay/continuity": "2.0.23",
+    "@agent-relay/resiliency": "2.0.23"
   },
   "devDependencies": {
     "typescript": "^5.9.3",

package/deploy/workspace/codex.config.toml

@@ -1,20 +0,0 @@
-# Codex CLI Configuration for Agent Relay Containers
-# This file is copied to ~/.codex/config.toml in container environments
-# Reference: https://developers.openai.com/codex/config-reference/
-
-# Disable auto-updates in containers to prevent permission errors
-# Updates are managed via Dockerfile (pinned versions)
-check_for_update_on_startup = false
-
-# MCP Server for agent-to-agent communication
-[mcp_servers.agent-relay]
-command = "node"
-args = ["/app/dist/src/cli/index.js", "mcp", "serve"]
-
-# Additional configuration options can be added here as needed
-# Examples (uncomment and adjust as needed):
-# [model]
-# default_model = "o1"
-#
-# [editor]
-# default_editor = "vim"

package/deploy/workspace/entrypoint-browser.sh

@@ -1,118 +0,0 @@
-#!/usr/bin/env bash
-
-set -euo pipefail
-
-log() {
-  echo "[workspace-browser] $*"
-}
-
-# ============================================================================
-# Start Virtual Display (Xvfb)
-# ============================================================================
-log "Starting Xvfb virtual display..."
-Xvfb :99 -screen 0 "${SCREEN_WIDTH:-1920}x${SCREEN_HEIGHT:-1080}x${SCREEN_DEPTH:-24}" &
-XVFB_PID=$!
-sleep 1
-
-# Verify Xvfb started
-if ! kill -0 $XVFB_PID 2>/dev/null; then
-  log "ERROR: Xvfb failed to start"
-  exit 1
-fi
-log "Xvfb started on display :99"
-
-# ============================================================================
-# Start Window Manager (Fluxbox)
-# ============================================================================
-log "Starting Fluxbox window manager..."
-fluxbox &
-sleep 1
-log "Fluxbox started"
-
-# ============================================================================
-# Start VNC Server (optional, for debugging/viewing)
-# ============================================================================
-if [[ "${VNC_ENABLED:-true}" == "true" ]]; then
-  log "Starting x11vnc server..."
-  x11vnc -display :99 -forever -shared -rfbport "${VNC_PORT:-5900}" -bg -nopw -xkb
-  log "VNC server started on port ${VNC_PORT:-5900}"
-
-  # Start noVNC for browser-based access
-  if [[ "${NOVNC_ENABLED:-true}" == "true" ]]; then
-    log "Starting noVNC web interface..."
-    websockify --web=/usr/share/novnc/ "${NOVNC_PORT:-6080}" localhost:"${VNC_PORT:-5900}" &
-    log "noVNC available at http://localhost:${NOVNC_PORT:-6080}/vnc.html"
-  fi
-fi
-
-# ============================================================================
-# Export browser testing utilities
-# ============================================================================
-
-# Create screenshot helper
-cat > /usr/local/bin/take-screenshot <<'EOF'
-#!/usr/bin/env bash
-# Take a screenshot and save to specified path
-# Usage: take-screenshot [output.png]
-OUTPUT="${1:-/tmp/screenshot-$(date +%Y%m%d-%H%M%S).png}"
-DISPLAY=:99 scrot "$OUTPUT"
-echo "$OUTPUT"
-EOF
-chmod +x /usr/local/bin/take-screenshot
-
-# Create browser launcher helper
-cat > /usr/local/bin/launch-browser <<'EOF'
-#!/usr/bin/env bash
-# Launch browser with optional URL
-# Usage: launch-browser [url]
-URL="${1:-about:blank}"
-DISPLAY=:99 chromium --no-sandbox --disable-gpu --start-maximized "$URL" &
-echo "Browser launched with PID $!"
-EOF
-chmod +x /usr/local/bin/launch-browser
-
-# Create Playwright test runner helper
-cat > /usr/local/bin/run-playwright <<'EOF'
-#!/usr/bin/env bash
-# Run Playwright tests with proper display settings
-# Usage: run-playwright [test-file.spec.ts] [additional args...]
-export DISPLAY=:99
-npx playwright test "$@"
-EOF
-chmod +x /usr/local/bin/run-playwright
-
-# ============================================================================
-# Docker-in-Docker helper (if socket mounted)
-# ============================================================================
-if [[ -S /var/run/docker.sock ]]; then
-  log "Docker socket detected - agents can spawn containers"
-
-  # Create helper for agents to spawn isolated containers
-  cat > /usr/local/bin/spawn-container <<'EOF'
-#!/usr/bin/env bash
-# Spawn an isolated container for agent tasks
-# Usage: spawn-container <image> [command...]
-IMAGE="${1:-ubuntu:22.04}"
-shift
-docker run --rm -it \
-  --network=host \
-  -v "$(pwd):/workspace" \
-  -w /workspace \
-  "$IMAGE" "$@"
-EOF
-  chmod +x /usr/local/bin/spawn-container
-else
-  log "WARN: Docker socket not mounted - container spawning disabled"
-fi
-
-# ============================================================================
-# Continue with main entrypoint
-# ============================================================================
-log "Browser testing environment ready"
-log "  - Display: $DISPLAY (${SCREEN_WIDTH}x${SCREEN_HEIGHT})"
-log "  - VNC: ${VNC_ENABLED:-true} (port ${VNC_PORT:-5900})"
-log "  - noVNC: ${NOVNC_ENABLED:-true} (http://localhost:${NOVNC_PORT:-6080})"
-log "  - Playwright: $(npx playwright --version 2>/dev/null || echo 'installed')"
-
-# Hand off to main entrypoint
-exec /entrypoint.sh "$@"