agent-relay 2.1.13 → 2.1.15

package/packages/mcp/dist/bin.js

@@ -10,6 +10,8 @@
  */
 import { parseArgs } from 'node:util';
 import { runInstall, validateEditor, getValidEditors } from './install-cli.js';
+import { RelayClient } from '@agent-relay/sdk';
+import { createRelayClientAdapter } from './client-adapter.js';
 const { values, positionals } = parseArgs({
     allowPositionals: true,
     options: {
@@ -104,7 +106,7 @@ switch (command) {
         (async () => {
             try {
                 const { runMCPServer, discoverSocket, discoverAgentName } = await import('./index.js');
-                const { createHybridClient, discoverProjectRoot } = await import('./hybrid-client.js');
+                const { discoverProjectRoot } = await import('./hybrid-client.js');
                 const { join } = await import('node:path');
                 const { existsSync } = await import('node:fs');
                 // Use explicit project path if provided (for MCP servers invoked from different contexts)
@@ -123,7 +125,7 @@ switch (command) {
                 }
                 const discovery = discoverSocket();
                 const agentName = discoverAgentName(discovery) || `mcp-${process.pid}`;
-                // Discover project root for file-based transport
+                // Discover project root
                 if (!projectRoot) {
                     projectRoot = discoverProjectRoot() ?? undefined;
                 }
@@ -139,14 +141,25 @@ switch (command) {
                     console.error('Run "agent-relay up" in the project to start the daemon first');
                     process.exit(1);
                 }
-                // Create hybrid client (file-based writes, socket queries)
-                const client = createHybridClient({
+                const client = new RelayClient({
                     agentName,
+                    socketPath: socketPath || discovery?.socketPath,
+                    quiet: values.quiet,
+                    reconnect: true,
+                });
+                await client.connect();
+                const mcpClient = createRelayClientAdapter(client, {
+                    agentName,
+                    project: discovery?.project,
                     projectRoot,
                     socketPath: socketPath || discovery?.socketPath,
+                });
+                await runMCPServer(mcpClient, {
+                    projectRoot,
                     project: discovery?.project,
+                    socketPath: socketPath || discovery?.socketPath,
+                    agentName,
                 });
-                await runMCPServer(client);
             }
             catch (err) {
                 const message = err instanceof Error ? err.message : String(err);

package/packages/mcp/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":"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"}

package/packages/mcp/dist/{client.d.ts → client-adapter.d.ts}

@@ -1,15 +1,8 @@
-/**
- * RelayClient - Client for connecting to the Agent Relay daemon
- *
- * This module uses @agent-relay/protocol for wire format handling
- * to avoid code duplication with the SDK.
- */
-import { type AckPayload, type HealthResponsePayload, type MetricsResponsePayload, type MessagesResponsePayload } from '@agent-relay/protocol';
-import { type SpawnResult, type ReleaseResult } from '@agent-relay/utils/client-helpers';
+import { RelayClient as SdkRelayClient, type AckPayload, type AgentInfo, type HealthResponsePayload, type MetricsResponsePayload, type MessagesResponsePayload, type SpawnResult, type ReleaseResultPayload } from '@agent-relay/sdk';
+export type QueryMessage = MessagesResponsePayload['messages'][number];
 export type HealthResponse = HealthResponsePayload;
 export type MetricsResponse = MetricsResponsePayload;
 export type MessagesResponse = MessagesResponsePayload;
-export type QueryMessage = MessagesResponsePayload['messages'][number];
 export interface RelayClient {
     send(to: string, message: string, options?: {
         thread?: string;
@@ -24,15 +17,16 @@ export interface RelayClient {
     }): Promise<AckPayload>;
     broadcast(message: string, options?: {
         kind?: string;
+        data?: Record<string, unknown>;
     }): Promise<void>;
     spawn(options: {
         name: string;
         cli: string;
-        task: string;
+        task?: string;
         model?: string;
         cwd?: string;
     }): Promise<SpawnResult>;
-    release(name: string, reason?: string): Promise<ReleaseResult>;
+    release(name: string, reason?: string): Promise<ReleaseResultPayload>;
     subscribe(topic: string): Promise<{
         success: boolean;
         error?: string;
@@ -52,12 +46,10 @@ export interface RelayClient {
     sendChannelMessage(channel: string, message: string, options?: {
         thread?: string;
     }): Promise<void>;
-    /** Admin join: Add any member to a channel (does not require member to be connected) */
     adminJoinChannel(channel: string, member: string): Promise<{
         success: boolean;
         error?: string;
     }>;
-    /** Admin remove: Remove any member from a channel */
     adminRemoveMember(channel: string, member: string): Promise<{
         success: boolean;
         error?: string;
@@ -113,20 +105,10 @@ export interface RelayClient {
     listAgents(options?: {
         include_idle?: boolean;
         project?: string;
-    }): Promise<Array<{
-        name: string;
-        cli?: string;
-        idle?: boolean;
-        parent?: string;
-    }>>;
+    }): Promise<AgentInfo[]>;
     listConnectedAgents(options?: {
         project?: string;
-    }): Promise<Array<{
-        name: string;
-        cli?: string;
-        idle?: boolean;
-        parent?: string;
-    }>>;
+    }): Promise<AgentInfo[]>;
     removeAgent(name: string, options?: {
         removeMessages?: boolean;
     }): Promise<{
@@ -137,33 +119,37 @@ export interface RelayClient {
     getHealth(options?: {
         include_crashes?: boolean;
         include_alerts?: boolean;
-    }): Promise<HealthResponse>;
+    }): Promise<HealthResponsePayload>;
     getMetrics(options?: {
         agent?: string;
-    }): Promise<MetricsResponse>;
-    /**
-     * Query all messages (not filtered by recipient).
-     * Useful for dashboard views and message history.
-     */
+    }): Promise<MetricsResponsePayload>;
     queryMessages(options?: {
         limit?: number;
         sinceTs?: number;
+        since_ts?: number;
         from?: string;
         to?: string;
         thread?: string;
         order?: 'asc' | 'desc';
     }): Promise<QueryMessage[]>;
-    /**
-     * Send log output to the daemon for dashboard streaming.
-     */
     sendLog(data: string): Promise<void>;
 }
+export interface RelayClientAdapterOptions {
+    agentName: string;
+    project?: string;
+    projectRoot?: string;
+    socketPath?: string;
+}
+export declare function createRelayClientAdapter(client: SdkRelayClient, ctx: RelayClientAdapterOptions): RelayClient;
 export interface RelayClientOptions {
     agentName: string;
     socketPath?: string;
     project?: string;
+    quiet?: boolean;
     timeout?: number;
 }
+/**
+ * Factory that creates an SDK RelayClient and wraps it with the MCP adapter.
+ */
 export declare function createRelayClient(options: RelayClientOptions): RelayClient;
-export default createRelayClient;
-//# sourceMappingURL=client.d.ts.map
+//# sourceMappingURL=client-adapter.d.ts.map

package/packages/mcp/dist/client-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-adapter.d.ts","sourceRoot":"","sources":["../src/client-adapter.ts"],"names":[],"mappings":"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"}

package/packages/mcp/dist/client-adapter.js

@@ -0,0 +1,227 @@
+import { RelayClient as SdkRelayClient } from '@agent-relay/sdk';
+import { PROTOCOL_VERSION } from '@agent-relay/protocol';
+import { randomUUID } from 'node:crypto';
+async function ensureReady(client) {
+    if (client.state !== 'READY') {
+        await client.connect();
+    }
+}
+function boolResult(ok, action) {
+    return ok ? { success: true } : { success: false, error: `Failed to ${action}` };
+}
+export function createRelayClientAdapter(client, ctx) {
+    const project = ctx.projectRoot ?? ctx.project ?? 'default';
+    const socketPath = ctx.socketPath ?? '';
+    return {
+        async send(to, message, opts = {}) {
+            await ensureReady(client);
+            const ok = client.sendMessage(to, message, opts.kind ?? 'message', opts.data, opts.thread);
+            if (!ok)
+                throw new Error('Failed to send message');
+        },
+        async sendAndWait(to, message, opts = {}) {
+            await ensureReady(client);
+            return client.sendAndWait(to, message, {
+                thread: opts.thread,
+                timeoutMs: opts.timeoutMs,
+                kind: opts.kind,
+                data: opts.data,
+            });
+        },
+        async broadcast(message, opts = {}) {
+            await ensureReady(client);
+            const ok = client.broadcast(message, opts.kind ?? 'message', opts.data);
+            if (!ok)
+                throw new Error('Failed to broadcast message');
+        },
+        async subscribe(topic) {
+            await ensureReady(client);
+            const ok = client.subscribe(topic);
+            return boolResult(ok, 'subscribe');
+        },
+        async unsubscribe(topic) {
+            await ensureReady(client);
+            const ok = client.unsubscribe(topic);
+            return boolResult(ok, 'unsubscribe');
+        },
+        async joinChannel(channel, displayName) {
+            await ensureReady(client);
+            const ok = client.joinChannel(channel, displayName);
+            return boolResult(ok, 'join channel');
+        },
+        async leaveChannel(channel, reason) {
+            await ensureReady(client);
+            const ok = client.leaveChannel(channel, reason);
+            return boolResult(ok, 'leave channel');
+        },
+        async sendChannelMessage(channel, message, options = {}) {
+            await ensureReady(client);
+            const ok = client.sendChannelMessage(channel, message, { thread: options.thread });
+            if (!ok)
+                throw new Error('Failed to send channel message');
+        },
+        async adminJoinChannel(channel, member) {
+            await ensureReady(client);
+            const ok = client.adminJoinChannel(channel, member);
+            return boolResult(ok, 'add member to channel');
+        },
+        async adminRemoveMember(channel, member) {
+            await ensureReady(client);
+            const ok = client.adminRemoveMember(channel, member);
+            return boolResult(ok, 'remove member from channel');
+        },
+        async bindAsShadow(primaryAgent, opts = {}) {
+            await ensureReady(client);
+            const ok = client.bindAsShadow(primaryAgent, { speakOn: opts.speakOn });
+            return boolResult(ok, 'bind as shadow');
+        },
+        async unbindAsShadow(primaryAgent) {
+            await ensureReady(client);
+            const ok = client.unbindAsShadow(primaryAgent);
+            return boolResult(ok, 'unbind shadow');
+        },
+        async createProposal(opts) {
+            await ensureReady(client);
+            const envelope = {
+                v: PROTOCOL_VERSION,
+                type: 'PROPOSAL_CREATE',
+                id: randomUUID(),
+                ts: Date.now(),
+                payload: {
+                    id: opts.id,
+                    description: opts.description,
+                    options: opts.options,
+                    votingMethod: opts.votingMethod ?? 'majority',
+                    deadline: opts.deadline,
+                },
+            };
+            const ok = client.send?.(envelope) ?? false;
+            return boolResult(ok, 'create proposal');
+        },
+        async vote(opts) {
+            await ensureReady(client);
+            const envelope = {
+                v: PROTOCOL_VERSION,
+                type: 'VOTE',
+                id: randomUUID(),
+                ts: Date.now(),
+                payload: {
+                    proposalId: opts.proposalId,
+                    vote: opts.vote,
+                    reason: opts.reason,
+                },
+            };
+            const ok = client.send?.(envelope) ?? false;
+            return boolResult(ok, 'vote');
+        },
+        async spawn(options) {
+            await ensureReady(client);
+            return client.spawn(options);
+        },
+        async release(name, reason) {
+            await ensureReady(client);
+            return client.release(name, reason);
+        },
+        async getStatus() {
+            try {
+                await ensureReady(client);
+                const status = await client.getStatus();
+                return {
+                    connected: true,
+                    agentName: ctx.agentName,
+                    project,
+                    socketPath,
+                    daemonVersion: status.version,
+                    uptime: status.uptime ? `${Math.floor(status.uptime / 1000)}s` : undefined,
+                };
+            }
+            catch {
+                return {
+                    connected: false,
+                    agentName: ctx.agentName,
+                    project,
+                    socketPath,
+                };
+            }
+        },
+        async getInbox(options = {}) {
+            await ensureReady(client);
+            const messages = await client.getInbox({
+                limit: options.limit,
+                unreadOnly: options.unread_only,
+                from: options.from,
+                channel: options.channel,
+            });
+            return messages.map((m) => ({
+                id: m.id,
+                from: m.from,
+                content: m.body,
+                channel: m.channel,
+                thread: m.thread,
+            }));
+        },
+        async listAgents(options = {}) {
+            await ensureReady(client);
+            return client.listAgents({
+                includeIdle: options.include_idle,
+                project: options.project,
+            });
+        },
+        async listConnectedAgents(options = {}) {
+            await ensureReady(client);
+            return client.listConnectedAgents({
+                project: options.project,
+            });
+        },
+        async removeAgent(name, options = {}) {
+            await ensureReady(client);
+            return client.removeAgent(name, { removeMessages: options.removeMessages });
+        },
+        async getHealth(options = {}) {
+            await ensureReady(client);
+            return client.getHealth({
+                includeCrashes: options.include_crashes,
+                includeAlerts: options.include_alerts,
+            });
+        },
+        async getMetrics(options = {}) {
+            await ensureReady(client);
+            return client.getMetrics({ agent: options.agent });
+        },
+        async queryMessages(options = {}) {
+            await ensureReady(client);
+            const response = await client.queryMessages({
+                limit: options.limit,
+                sinceTs: options.sinceTs ?? options.since_ts,
+                from: options.from,
+                to: options.to,
+                thread: options.thread,
+                order: options.order,
+            });
+            return response || [];
+        },
+        async sendLog(data) {
+            await ensureReady(client);
+            const ok = client.sendLog(data);
+            if (!ok)
+                throw new Error('Failed to send log');
+        },
+    };
+}
+/**
+ * Factory that creates an SDK RelayClient and wraps it with the MCP adapter.
+ */
+export function createRelayClient(options) {
+    const sdkClient = new SdkRelayClient({
+        agentName: options.agentName,
+        socketPath: options.socketPath,
+        quiet: options.quiet,
+        reconnect: true,
+    });
+    return createRelayClientAdapter(sdkClient, {
+        agentName: options.agentName,
+        project: options.project,
+        socketPath: options.socketPath,
+    });
+}
+//# sourceMappingURL=client-adapter.js.map

package/packages/mcp/dist/client-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-adapter.js","sourceRoot":"","sources":["../src/client-adapter.ts"],"names":[],"mappings":"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"}

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

@@ -1,35 +1,5 @@
 /**
- * Hybrid Client for MCP Tools
- *
- * IMPORTANT: The file-based writes ONLY work when relay-pty is wrapping the agent.
- * relay-pty watches for ->relay-file:* triggers in agent output and processes outbox files.
- * The daemon does NOT watch outbox directories directly.
- *
- * For pure MCP tools (not wrapped by relay-pty), use createRelayClient() instead,
- * which communicates directly with the daemon via socket.
- *
- * This hybrid client is designed for scenarios where:
- * - An agent is wrapped by relay-pty
- * - File-based writes avoid socket connection overhead
- * - Socket is still used for queries (getInbox, listAgents, etc.)
- */
-import type { RelayClient } from './client.js';
-export interface HybridClientOptions {
-    /** Agent name */
-    agentName: string;
-    /** Project root directory (where .agent-relay lives) */
-    projectRoot: string;
-    /** Socket path (optional, will discover if not provided) */
-    socketPath?: string;
-    /** Project ID */
-    project?: string;
-}
-/**
- * Create a hybrid client that uses file-based for writes, socket for queries.
- */
-export declare function createHybridClient(options: HybridClientOptions): RelayClient;
-/**
- * Discover project root from socket path or environment.
+ * Discover project root by locating a .agent-relay directory.
  */
 export declare function discoverProjectRoot(): string | null;
 //# sourceMappingURL=hybrid-client.d.ts.map

package/packages/mcp/dist/hybrid-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hybrid-client.d.ts","sourceRoot":"","sources":["../src/hybrid-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,mBAAmB;IAClC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,CA+J5E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAqBnD"}
+{"version":3,"file":"hybrid-client.d.ts","sourceRoot":"","sources":["../src/hybrid-client.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAkBnD"}

package/packages/mcp/dist/hybrid-client.js

@@ -1,166 +1,16 @@
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
 /**
- * Hybrid Client for MCP Tools
- *
- * IMPORTANT: The file-based writes ONLY work when relay-pty is wrapping the agent.
- * relay-pty watches for ->relay-file:* triggers in agent output and processes outbox files.
- * The daemon does NOT watch outbox directories directly.
- *
- * For pure MCP tools (not wrapped by relay-pty), use createRelayClient() instead,
- * which communicates directly with the daemon via socket.
- *
- * This hybrid client is designed for scenarios where:
- * - An agent is wrapped by relay-pty
- * - File-based writes avoid socket connection overhead
- * - Socket is still used for queries (getInbox, listAgents, etc.)
- */
-import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
-import { join, dirname } from 'node:path';
-import { createRelayClient } from './client.js';
-import { discoverSocket } from './cloud.js';
-/**
- * Create a hybrid client that uses file-based for writes, socket for queries.
- */
-export function createHybridClient(options) {
-    const { agentName, projectRoot, project = 'default' } = options;
-    // Setup directories
-    const relayDir = join(projectRoot, '.agent-relay');
-    const outboxDir = join(relayDir, 'outbox', agentName);
-    const inboxDir = join(relayDir, 'inbox', agentName);
-    // Ensure directories exist
-    if (!existsSync(outboxDir)) {
-        mkdirSync(outboxDir, { recursive: true });
-    }
-    if (!existsSync(inboxDir)) {
-        mkdirSync(inboxDir, { recursive: true });
-    }
-    // Get socket path for queries
-    // Use discoverSocket() which respects cloud workspace config and env overrides.
-    // Only fall back to relayDir/relay.sock for non-cloud local development.
-    const discovery = discoverSocket();
-    const socketPath = options.socketPath || discovery?.socketPath || join(relayDir, 'relay.sock');
-    if (process.env.DEBUG || process.env.RELAY_DEBUG) {
-        console.debug('[hybrid-client] Socket path:', socketPath, 'source:', discovery?.source ?? 'fallback', 'isCloud:', discovery?.isCloud ?? false);
-    }
-    // Create socket client for queries only
-    let socketClient = null;
-    const getSocketClient = () => {
-        if (!socketClient) {
-            socketClient = createRelayClient({
-                agentName,
-                socketPath,
-                project,
-            });
-        }
-        return socketClient;
-    };
-    // File-based send (write to outbox)
-    const send = async (to, message, opts = {}) => {
-        let content = `TO: ${to}\n`;
-        if (opts.thread) {
-            content += `THREAD: ${opts.thread}\n`;
-        }
-        content += `\n${message}`;
-        const msgPath = join(outboxDir, 'msg');
-        writeFileSync(msgPath, content);
-        // NOTE: relay-pty (not daemon) watches for ->relay-file:msg trigger.
-        // The agent must output "->relay-file:msg" for relay-pty to process.
-    };
-    // File-based sendAndWait (for now, delegate to socket - can improve later)
-    const sendAndWait = async (to, message, opts = {}) => {
-        // For await responses, we still use socket since we need the response
-        // TODO: Implement file-based request/response pattern
-        return getSocketClient().sendAndWait(to, message, opts);
-    };
-    // File-based spawn
-    const spawn = async (opts) => {
-        let content = `KIND: spawn\n`;
-        content += `NAME: ${opts.name}\n`;
-        content += `CLI: ${opts.cli}\n`;
-        if (opts.model) {
-            content += `MODEL: ${opts.model}\n`;
-        }
-        if (opts.cwd) {
-            content += `CWD: ${opts.cwd}\n`;
-        }
-        content += `\n${opts.task}`;
-        const spawnPath = join(outboxDir, 'spawn');
-        writeFileSync(spawnPath, content);
-        return { success: true };
-    };
-    // File-based release
-    const release = async (name, reason) => {
-        let content = `KIND: release\n`;
-        content += `NAME: ${name}\n`;
-        if (reason) {
-            content += `\n${reason}`;
-        }
-        const releasePath = join(outboxDir, 'release');
-        writeFileSync(releasePath, content);
-        return { success: true };
-    };
-    // File-based continuity (NEW - not in original MCP)
-    const saveContinuity = async (state) => {
-        let content = `KIND: continuity\n`;
-        content += `ACTION: save\n\n`;
-        if (state.currentTask)
-            content += `Current task: ${state.currentTask}\n`;
-        if (state.completed)
-            content += `Completed: ${state.completed}\n`;
-        if (state.inProgress)
-            content += `In progress: ${state.inProgress}\n`;
-        if (state.keyDecisions)
-            content += `Key decisions: ${state.keyDecisions}\n`;
-        if (state.files)
-            content += `Files: ${state.files}\n`;
-        const continuityPath = join(outboxDir, 'continuity');
-        writeFileSync(continuityPath, content);
-    };
-    const loadContinuity = async () => {
-        const content = `KIND: continuity\nACTION: load\n`;
-        const continuityPath = join(outboxDir, 'continuity');
-        writeFileSync(continuityPath, content);
-    };
-    const markUncertain = async (item) => {
-        const content = `KIND: continuity\nACTION: uncertain\n\n${item}`;
-        const continuityPath = join(outboxDir, 'continuity');
-        writeFileSync(continuityPath, content);
-    };
-    // Socket-based queries (these work fine over socket)
-    const getStatus = async () => getSocketClient().getStatus();
-    const getInbox = async (opts) => getSocketClient().getInbox(opts);
-    const listAgents = async (opts) => getSocketClient().listAgents(opts);
-    const getHealth = async (opts) => getSocketClient().getHealth(opts);
-    const getMetrics = async (opts) => getSocketClient().getMetrics(opts);
-    return {
-        send,
-        sendAndWait,
-        spawn,
-        release,
-        getStatus,
-        getInbox,
-        listAgents,
-        getHealth,
-        getMetrics,
-        // Extended methods (not in base RelayClient interface but useful)
-        saveContinuity,
-        loadContinuity,
-        markUncertain,
-    };
-}
-/**
- * Discover project root from socket path or environment.
+ * Discover project root by locating a .agent-relay directory.
  */
 export function discoverProjectRoot() {
-    // Check RELAY_SOCKET env var
     const socketEnv = process.env.RELAY_SOCKET;
     if (socketEnv) {
-        // Socket path is like /path/to/project/.agent-relay/relay.sock
         const match = socketEnv.match(/^(.+)\/\.agent-relay\/relay\.sock$/);
         if (match) {
             return match[1];
         }
     }
-    // Search from cwd upward
     let dir = process.cwd();
     while (dir !== '/') {
         if (existsSync(join(dir, '.agent-relay'))) {