agent-relay 2.0.13 → 2.0.15

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

@@ -3,18 +3,15 @@ import type { Tool } from '@modelcontextprotocol/sdk/types.js';
 import type { RelayClient } from '../client.js';
 export declare const relayMetricsSchema: z.ZodObject<{
     agent: z.ZodOptional<z.ZodString>;
-    port: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    port: number;
     agent?: string | undefined;
 }, {
     agent?: string | undefined;
-    port?: number | undefined;
 }>;
 export type RelayMetricsInput = z.infer<typeof relayMetricsSchema>;
 export declare const relayMetricsTool: Tool;
 /**
  * Get memory and resource metrics for agents.
  */
-export declare function handleRelayMetrics(_client: RelayClient, input: RelayMetricsInput): Promise<string>;
+export declare function handleRelayMetrics(client: RelayClient, input: RelayMetricsInput): Promise<string>;
 //# sourceMappingURL=relay-metrics.d.ts.map

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

@@ -1,7 +1,6 @@
 import { z } from 'zod';
 export const relayMetricsSchema = z.object({
     agent: z.string().optional().describe('Filter metrics to a specific agent'),
-    port: z.number().optional().default(3888).describe('Dashboard port (default: 3888)'),
 });
 export const relayMetricsTool = {
     name: 'relay_metrics',
@@ -27,11 +26,6 @@ Example: Get metrics for specific agent
                 type: 'string',
                 description: 'Filter metrics to a specific agent',
             },
-            port: {
-                type: 'number',
-                description: 'Dashboard port (default: 3888)',
-                default: 3888,
-            },
         },
         required: [],
     },
@@ -60,14 +54,9 @@ function formatUptime(ms) {
 /**
  * Get memory and resource metrics for agents.
  */
-export async function handleRelayMetrics(_client, input) {
-    const port = input.port || 3888;
+export async function handleRelayMetrics(client, input) {
     try {
-        const response = await fetch(`http://localhost:${port}/api/metrics/agents`);
-        if (!response.ok) {
-            throw new Error(`HTTP ${response.status}`);
-        }
-        const data = await response.json();
+        const data = await client.getMetrics({ agent: input.agent });
         let agents = data.agents;
         // Filter to specific agent if requested
         if (input.agent) {
@@ -126,8 +115,8 @@ export async function handleRelayMetrics(_client, input) {
     }
     catch (err) {
         const error = err;
-        if (error.code === 'ECONNREFUSED') {
-            return `Cannot connect to dashboard at port ${port}. Is the daemon running?\n\nRun 'agent-relay up' to start the daemon.`;
+        if (error.code === 'ECONNREFUSED' || error.code === 'ENOENT') {
+            return `Cannot connect to daemon. Is the daemon running?\n\nRun 'agent-relay up' to start the daemon.`;
         }
         return `Failed to fetch metrics: ${error.message || String(err)}`;
     }

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

@@ -8,14 +8,14 @@ export declare const relaySendSchema: z.ZodObject<{
     await_response: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    to: string;
     message: string;
+    to: string;
     await_response: boolean;
     timeout_ms: number;
     thread?: string | undefined;
 }, {
-    to: string;
     message: string;
+    to: string;
     thread?: string | undefined;
     await_response?: boolean | undefined;
     timeout_ms?: number | undefined;

package/packages/mcp/package.json

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

package/packages/memory/package.json

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

package/packages/policy/package.json

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

package/packages/protocol/dist/relay-pty-schemas.d.ts

@@ -151,6 +151,11 @@ export type InjectRequest = {
     type: 'status';
 } | {
     type: 'shutdown';
+} | {
+    /** Send just Enter key (for stuck input recovery) */
+    type: 'send_enter';
+    /** Message ID this is for (for tracking) */
+    id: string;
 };
 /**
  * Response from relay-pty socket
@@ -187,6 +192,15 @@ export type InjectResponse = {
     type: 'error';
     /** Error message */
     message: string;
+} | {
+    /** SendEnter result (for stuck input recovery) */
+    type: 'send_enter_result';
+    /** Message ID this is for */
+    id: string;
+    /** Whether Enter was sent successfully */
+    success: boolean;
+    /** Unix timestamp in milliseconds */
+    timestamp: number;
 };
 /**
  * The final format injected into the recipient agent's PTY as plain text.

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';
+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 PayloadKind = 'message' | 'action' | 'state' | 'thinking';
 /**
  * Base envelope structure for all protocol messages.
@@ -158,7 +158,7 @@ export interface PingPayload {
 export interface PongPayload {
     nonce: string;
 }
-export type ErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'NOT_FOUND' | 'INTERNAL' | 'RESUME_TOO_OLD';
+export type ErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'NOT_FOUND' | 'INTERNAL' | 'RESUME_TOO_OLD' | 'DUPLICATE_CONNECTION';
 export interface ErrorPayload {
     /** Error code */
     code: ErrorCode;
@@ -266,6 +266,8 @@ export interface SpawnPayload {
     team?: string;
     /** Working directory */
     cwd?: string;
+    /** Model override (alternative to cli:model format) */
+    model?: string;
     /** Socket path for the spawned agent */
     socketPath?: string;
     /** Parent agent name */
@@ -303,6 +305,8 @@ export interface SpawnResultPayload {
 export interface ReleasePayload {
     /** Agent name to release */
     name: string;
+    /** Reason for releasing the agent */
+    reason?: string;
 }
 export interface ReleaseResultPayload {
     /** Correlation ID */
@@ -340,4 +344,150 @@ export type ReleaseResultEnvelope = Envelope<ReleaseResultPayload>;
 export type ChannelJoinEnvelope = Envelope<ChannelJoinPayload>;
 export type ChannelLeaveEnvelope = Envelope<ChannelLeavePayload>;
 export type ChannelMessageEnvelope = Envelope<ChannelMessagePayload>;
+/**
+ * Payload for STATUS request.
+ */
+export interface StatusPayload {
+}
+/**
+ * Payload for STATUS_RESPONSE.
+ */
+export interface StatusResponsePayload {
+    /** Daemon version */
+    version?: string;
+    /** Uptime in milliseconds */
+    uptime?: number;
+    /** Whether cloud sync is connected */
+    cloudConnected?: boolean;
+    /** Number of connected agents */
+    agentCount?: number;
+}
+/**
+ * Payload for INBOX request.
+ */
+export interface InboxPayload {
+    /** Agent name to get inbox for */
+    agent: string;
+    /** Maximum number of messages to return */
+    limit?: number;
+    /** Only return unread messages */
+    unreadOnly?: boolean;
+    /** Filter by sender */
+    from?: string;
+    /** Filter by channel */
+    channel?: string;
+}
+/**
+ * Payload for INBOX_RESPONSE.
+ */
+export interface InboxResponsePayload {
+    /** Messages in the inbox */
+    messages: Array<{
+        id: string;
+        from: string;
+        body: string;
+        channel?: string;
+        thread?: string;
+        timestamp: number;
+    }>;
+}
+/**
+ * Payload for LIST_AGENTS request.
+ */
+export interface ListAgentsPayload {
+    /** Include idle agents */
+    includeIdle?: boolean;
+    /** Filter by project */
+    project?: string;
+}
+/**
+ * Payload for LIST_AGENTS_RESPONSE.
+ */
+export interface ListAgentsResponsePayload {
+    /** List of agents */
+    agents: Array<{
+        name: string;
+        cli?: string;
+        idle?: boolean;
+        parent?: 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>;
+/**
+ * Payload for HEALTH request.
+ */
+export interface HealthPayload {
+    /** Include crash history */
+    includeCrashes?: boolean;
+    /** Include alerts */
+    includeAlerts?: boolean;
+}
+/**
+ * Payload for HEALTH_RESPONSE.
+ */
+export interface HealthResponsePayload {
+    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;
+    };
+}
+/**
+ * Payload for METRICS request.
+ */
+export interface MetricsPayload {
+    /** Filter to specific agent */
+    agent?: string;
+}
+/**
+ * Payload for METRICS_RESPONSE.
+ */
+export interface MetricsResponsePayload {
+    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;
+    };
+}
+export type HealthEnvelope = Envelope<HealthPayload>;
+export type HealthResponseEnvelope = Envelope<HealthResponsePayload>;
+export type MetricsEnvelope = Envelope<MetricsPayload>;
+export type MetricsResponseEnvelope = Envelope<MetricsResponsePayload>;
 //# sourceMappingURL=types.d.ts.map

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "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.13",
+  "version": "2.0.15",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/sdk/dist/client.js

@@ -644,6 +644,13 @@ export class RelayClient {
             this.resumeToken = undefined;
             this.sessionId = undefined;
         }
+        // Fatal errors (like DUPLICATE_CONNECTION) should prevent reconnection
+        if (envelope.payload.fatal) {
+            if (!this.config.quiet) {
+                console.error('[sdk] Fatal error received, will not reconnect:', envelope.payload.message);
+            }
+            this._destroyed = true;
+        }
     }
     handleDisconnect() {
         this.parser.reset();

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "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.13"
+    "@agent-relay/protocol": "2.0.15"
   },
   "engines": {
     "node": ">=18.0.0"

package/packages/spawner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/spawner",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "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.13",
+  "version": "2.0.15",
   "description": "Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)",
   "type": "module",
   "main": "dist/index.js",

package/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/storage",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "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.13"
+    "@agent-relay/protocol": "2.0.15"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "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.13",
+  "version": "2.0.15",
   "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.13"
+    "@agent-relay/config": "2.0.15"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "2.0.13",
+  "version": "2.0.15",
   "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.13"
+    "@agent-relay/resiliency": "2.0.15"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/dist/logger.js

@@ -54,8 +54,10 @@ function log(level, component, msg, extra) {
     // Write to file if configured
     if (LOG_FILE) {
         fs.appendFileSync(LOG_FILE, formatted + '\n');
+        // When logging to file, skip console output to avoid polluting TUI terminals
+        return;
     }
-    // Write to console (stderr for WARN/ERROR)
+    // Only write to console if no log file is configured (fallback mode)
     if (level === 'ERROR' || level === 'WARN') {
         console.error(formatted);
     }

package/packages/utils/package.json

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

package/packages/wrapper/dist/relay-pty-orchestrator.d.ts

@@ -16,7 +16,8 @@
  * @see docs/RUST_WRAPPER_DESIGN.md for protocol details
  */
 import { BaseWrapper, type BaseWrapperConfig } from './base-wrapper.js';
-import type { SendPayload, SendMeta } from '@agent-relay/protocol/types';
+import type { SendPayload, SendMeta, Envelope } from '@agent-relay/protocol/types';
+import type { ChannelMessagePayload } from '@agent-relay/protocol/channels';
 interface StatusResponse {
     type: 'status';
     agent_idle: boolean;
@@ -92,6 +93,7 @@ export declare class RelayPtyOrchestrator extends BaseWrapper {
     private lastParsedLength;
     private isInteractive;
     private pendingInjections;
+    private pendingSendEnter;
     private backpressureActive;
     private readyForMessages;
     private throttle;
@@ -116,10 +118,12 @@ export declare class RelayPtyOrchestrator extends BaseWrapper {
     constructor(config: RelayPtyOrchestratorConfig);
     /**
      * Debug log - only outputs when debug is enabled
+     * Writes to log file to avoid polluting TUI output
      */
     private log;
     /**
      * Error log - always outputs (errors are important)
+     * Writes to log file to avoid polluting TUI output
      */
     private logError;
     /**
@@ -210,6 +214,14 @@ export declare class RelayPtyOrchestrator extends BaseWrapper {
      * Disconnect from socket
      */
     private disconnectSocket;
+    /** Timer for socket reconnection */
+    private socketReconnectTimer?;
+    /** Current reconnection attempt count */
+    private socketReconnectAttempt;
+    /**
+     * Schedule a socket reconnection attempt with exponential backoff
+     */
+    private scheduleSocketReconnect;
     /**
      * Send a request to the socket and optionally wait for response
      */
@@ -224,6 +236,15 @@ export declare class RelayPtyOrchestrator extends BaseWrapper {
      * If verification fails, retries up to MAX_RETRIES times.
      */
     private handleInjectResult;
+    /**
+     * Handle SendEnter result (stuck input recovery)
+     * Called when relay-pty responds to a SendEnter request
+     */
+    private handleSendEnterResult;
+    /**
+     * Do a full retry with message content (used when SendEnter fails or for subsequent retries)
+     */
+    private doFullRetry;
     /**
      * Handle backpressure notification
      */
@@ -240,6 +261,12 @@ export declare class RelayPtyOrchestrator extends BaseWrapper {
      * Override handleIncomingMessage to trigger queue processing
      */
     protected handleIncomingMessage(from: string, payload: SendPayload, messageId: string, meta?: SendMeta, originalTo?: string): void;
+    /**
+     * Override handleIncomingChannelMessage to trigger queue processing.
+     * Without this override, channel messages would be queued but processMessageQueue()
+     * would never be called, causing messages to get stuck until the queue monitor runs.
+     */
+    protected handleIncomingChannelMessage(from: string, channel: string, body: string, envelope: Envelope<ChannelMessagePayload>): void;
     /**
      * Start the queue monitor to periodically check for stuck messages.
      * This ensures messages don't get orphaned in the queue when the agent is idle.