@agent-relay/mcp 0.1.0

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

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+export declare const relaySendSchema: z.ZodObject<{
+    to: z.ZodString;
+    message: z.ZodString;
+    thread: z.ZodOptional<z.ZodString>;
+    await_response: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    to: string;
+    message: string;
+    await_response: boolean;
+    timeout_ms: number;
+    thread?: string | undefined;
+}, {
+    to: string;
+    message: string;
+    thread?: string | undefined;
+    await_response?: boolean | undefined;
+    timeout_ms?: number | undefined;
+}>;
+export type RelaySendInput = z.infer<typeof relaySendSchema>;
+export declare const relaySendTool: Tool;
+/**
+ * Send a message via the relay daemon, optionally waiting for a response.
+ */
+export declare function handleRelaySend(client: RelayClient, input: RelaySendInput): Promise<string>;
+//# sourceMappingURL=relay-send.d.ts.map

package/dist/tools/relay-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-send.d.ts","sourceRoot":"","sources":["../../src/tools/relay-send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;EAc1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE7D,eAAO,MAAM,aAAa,EAAE,IAsC3B,CAAC;AAEF;;GAEG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,MAAM,CAAC,CAajB"}

package/dist/tools/relay-send.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+export const relaySendSchema = z.object({
+    to: z.string().describe('Target: agent name, #channel, or * for broadcast'),
+    message: z.string().describe('Message content'),
+    thread: z.string().optional().describe('Optional thread ID for threaded conversations'),
+    await_response: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe('If true, wait for a response (blocks until reply or timeout)'),
+    timeout_ms: z
+        .number()
+        .optional()
+        .default(30000)
+        .describe('Timeout in milliseconds when await_response is true'),
+});
+export const relaySendTool = {
+    name: 'relay_send',
+    description: `Send a message via Agent Relay.
+
+Examples:
+- Direct message: to="Alice", message="Hello"
+- Channel: to="#general", message="Team update"
+- Broadcast: to="*", message="System notice"
+- Threaded: to="Bob", message="Follow up", thread="task-123"
+- Await reply: to="Worker", message="Process this", await_response=true`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            to: {
+                type: 'string',
+                description: 'Target: agent name, #channel, or * for broadcast',
+            },
+            message: {
+                type: 'string',
+                description: 'Message content',
+            },
+            thread: {
+                type: 'string',
+                description: 'Optional thread ID for threaded conversations',
+            },
+            await_response: {
+                type: 'boolean',
+                description: 'If true, wait for a response',
+                default: false,
+            },
+            timeout_ms: {
+                type: 'number',
+                description: 'Timeout in ms when await_response is true',
+                default: 30000,
+            },
+        },
+        required: ['to', 'message'],
+    },
+};
+/**
+ * Send a message via the relay daemon, optionally waiting for a response.
+ */
+export async function handleRelaySend(client, input) {
+    const { to, message, thread, await_response, timeout_ms } = input;
+    if (await_response) {
+        const response = await client.sendAndWait(to, message, {
+            thread,
+            timeoutMs: timeout_ms,
+        });
+        return `Response from ${response.from}: ${response.content}`;
+    }
+    await client.send(to, message, { thread });
+    return `Message sent to ${to}`;
+}
+//# sourceMappingURL=relay-send.js.map

package/dist/tools/relay-send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-send.js","sourceRoot":"","sources":["../../src/tools/relay-send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;IAC3E,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC/C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;IACvF,cAAc,EAAE,CAAC;SACd,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,qDAAqD,CAAC;CACnE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,aAAa,GAAS;IACjC,IAAI,EAAE,YAAY;IAClB,WAAW,EAAE;;;;;;;wEAOyD;IACtE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,EAAE,EAAE;gBACF,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kDAAkD;aAChE;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iBAAiB;aAC/B;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,+CAA+C;aAC7D;YACD,cAAc,EAAE;gBACd,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,8BAA8B;gBAC3C,OAAO,EAAE,KAAK;aACf;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,2CAA2C;gBACxD,OAAO,EAAE,KAAK;aACf;SACF;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,CAAC;KAC5B;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAmB,EACnB,KAAqB;IAErB,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;IAElE,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE;YACrD,MAAM;YACN,SAAS,EAAE,UAAU;SACtB,CAAC,CAAC;QACH,OAAO,iBAAiB,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC,OAAO,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,OAAO,mBAAmB,EAAE,EAAE,CAAC;AACjC,CAAC"}

package/dist/tools/relay-spawn.d.ts

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+/**
+ * Supported CLI tools for spawning workers.
+ * This list should be kept in sync with CliType in packages/wrapper/src/shared.ts
+ * Note: 'cursor', 'spawned', 'other' are excluded as they're not valid spawn targets.
+ */
+export declare const SPAWNABLE_CLIS: readonly ["claude", "codex", "gemini", "droid", "opencode"];
+export type SpawnableCli = typeof SPAWNABLE_CLIS[number];
+export declare const relaySpawnSchema: z.ZodObject<{
+    name: z.ZodString;
+    cli: z.ZodEnum<["claude", "codex", "gemini", "droid", "opencode"]>;
+    task: z.ZodString;
+    model: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    cli: "claude" | "gemini" | "opencode" | "droid" | "codex";
+    task: string;
+    cwd?: string | undefined;
+    model?: string | undefined;
+}, {
+    name: string;
+    cli: "claude" | "gemini" | "opencode" | "droid" | "codex";
+    task: string;
+    cwd?: string | undefined;
+    model?: string | undefined;
+}>;
+export type RelaySpawnInput = z.infer<typeof relaySpawnSchema>;
+export declare const relaySpawnTool: Tool;
+/**
+ * Spawn a worker agent using the relay client.
+ */
+export declare function handleRelaySpawn(client: RelayClient, input: RelaySpawnInput): Promise<string>;
+//# sourceMappingURL=relay-spawn.d.ts.map

package/dist/tools/relay-spawn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-spawn.d.ts","sourceRoot":"","sources":["../../src/tools/relay-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,cAAc,6DAA8D,CAAC;AAC1F,MAAM,MAAM,YAAY,GAAG,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;EAQ3B,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE/D,eAAO,MAAM,cAAc,EAAE,IAsC5B,CAAC;AAEF;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/tools/relay-spawn.js

@@ -0,0 +1,73 @@
+import { z } from 'zod';
+/**
+ * Supported CLI tools for spawning workers.
+ * This list should be kept in sync with CliType in packages/wrapper/src/shared.ts
+ * Note: 'cursor', 'spawned', 'other' are excluded as they're not valid spawn targets.
+ */
+export const SPAWNABLE_CLIS = ['claude', 'codex', 'gemini', 'droid', 'opencode'];
+export const relaySpawnSchema = z.object({
+    name: z.string().describe('Unique name for the worker agent'),
+    cli: z.enum(SPAWNABLE_CLIS).describe('CLI tool to use for the worker (claude, codex, gemini, droid, opencode)'),
+    task: z.string().describe('Task description/prompt for the worker'),
+    model: z.string().optional().describe('Model override (e.g., "claude-3-5-sonnet")'),
+    cwd: z.string().optional().describe('Working directory for the worker'),
+});
+export const relaySpawnTool = {
+    name: 'relay_spawn',
+    description: `Spawn a worker agent to handle a subtask.
+
+The worker runs in a separate process with its own CLI instance.
+You'll receive a confirmation when the worker is ready.
+
+Example:
+  name="TestRunner"
+  cli="claude"
+  task="Run the test suite and report failures"`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: {
+                type: 'string',
+                description: 'Unique name for the worker agent',
+            },
+            cli: {
+                type: 'string',
+                enum: SPAWNABLE_CLIS,
+                description: 'CLI tool to use (claude, codex, gemini, droid, opencode)',
+            },
+            task: {
+                type: 'string',
+                description: 'Task description for the worker',
+            },
+            model: {
+                type: 'string',
+                description: 'Optional model override',
+            },
+            cwd: {
+                type: 'string',
+                description: 'Working directory for the worker',
+            },
+        },
+        required: ['name', 'cli', 'task'],
+    },
+};
+/**
+ * Spawn a worker agent using the relay client.
+ */
+export async function handleRelaySpawn(client, input) {
+    const { name, cli, task, model, cwd } = input;
+    const result = await client.spawn({
+        name,
+        cli,
+        task,
+        model,
+        cwd,
+    });
+    if (result.success) {
+        return `Worker "${name}" spawned successfully. It will message you when ready.`;
+    }
+    else {
+        return `Failed to spawn worker: ${result.error}`;
+    }
+}
+//# sourceMappingURL=relay-spawn.js.map

package/dist/tools/relay-spawn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-spawn.js","sourceRoot":"","sources":["../../src/tools/relay-spawn.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAU,CAAC;AAG1F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;IAC7D,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,QAAQ,CAClC,yEAAyE,CAC1E;IACD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,wCAAwC,CAAC;IACnE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,4CAA4C,CAAC;IACnF,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;CACxE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,cAAc,GAAS;IAClC,IAAI,EAAE,aAAa;IACnB,WAAW,EAAE;;;;;;;;gDAQiC;IAC9C,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,cAAqC;gBAC3C,WAAW,EAAE,0DAA0D;aACxE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,iCAAiC;aAC/C;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yBAAyB;aACvC;YACD,GAAG,EAAE;gBACH,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,kCAAkC;aAChD;SACF;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;KAClC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAmB,EACnB,KAAsB;IAEtB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;IAE9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;QAChC,IAAI;QACJ,GAAG;QACH,IAAI;QACJ,KAAK;QACL,GAAG;KACJ,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,WAAW,IAAI,yDAAyD,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,OAAO,2BAA2B,MAAM,CAAC,KAAK,EAAE,CAAC;IACnD,CAAC;AACH,CAAC"}

package/dist/tools/relay-status.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+export declare const relayStatusSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type RelayStatusInput = z.infer<typeof relayStatusSchema>;
+export declare const relayStatusTool: Tool;
+/**
+ * Retrieve relay daemon status and format a human-readable summary.
+ */
+export declare function handleRelayStatus(client: RelayClient, _input: RelayStatusInput): Promise<string>;
+//# sourceMappingURL=relay-status.d.ts.map

package/dist/tools/relay-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-status.d.ts","sourceRoot":"","sources":["../../src/tools/relay-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,eAAO,MAAM,iBAAiB,gDAAe,CAAC;AAE9C,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAEjE,eAAO,MAAM,eAAe,EAAE,IAQ7B,CAAC;AAEF;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/dist/tools/relay-status.js

@@ -0,0 +1,43 @@
+import { z } from 'zod';
+export const relayStatusSchema = z.object({});
+export const relayStatusTool = {
+    name: 'relay_status',
+    description: `Show connection and daemon status for Agent Relay.`,
+    inputSchema: {
+        type: 'object',
+        properties: {},
+        required: [],
+    },
+};
+/**
+ * Retrieve relay daemon status and format a human-readable summary.
+ */
+export async function handleRelayStatus(client, _input) {
+    const status = await client.getStatus();
+    const connected = status.connected ? 'Yes' : 'No';
+    let agentCount = 'unknown';
+    if (typeof client.listAgents === 'function') {
+        try {
+            const agents = await client.listAgents({});
+            agentCount = Array.isArray(agents) ? agents.length : 'unknown';
+        }
+        catch {
+            agentCount = 'unknown';
+        }
+    }
+    const lines = [
+        `Connected: ${connected}`,
+        `Agent Name: ${status.agentName}`,
+        `Project: ${status.project}`,
+        `Socket: ${status.socketPath}`,
+    ];
+    if (status.daemonVersion) {
+        lines.push(`Daemon Version: ${status.daemonVersion}`);
+    }
+    if (status.uptime) {
+        lines.push(`Uptime: ${status.uptime}`);
+    }
+    lines.push(`Agent Count: ${agentCount}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=relay-status.js.map

package/dist/tools/relay-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-status.js","sourceRoot":"","sources":["../../src/tools/relay-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAI9C,MAAM,CAAC,MAAM,eAAe,GAAS;IACnC,IAAI,EAAE,cAAc;IACpB,WAAW,EAAE,oDAAoD;IACjE,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE,EAAE;QACd,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAmB,EACnB,MAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IACxC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAElD,IAAI,UAAU,GAAoB,SAAS,CAAC;IAC5C,IAAI,OAAQ,MAAc,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QACrD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAO,MAAc,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACpD,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,UAAU,GAAG,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAED,MAAM,KAAK,GAAG;QACZ,cAAc,SAAS,EAAE;QACzB,eAAe,MAAM,CAAC,SAAS,EAAE;QACjC,YAAY,MAAM,CAAC,OAAO,EAAE;QAC5B,WAAW,MAAM,CAAC,UAAU,EAAE;KAC/B,CAAC;IAEF,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;QACzB,KAAK,CAAC,IAAI,CAAC,mBAAmB,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,IAAI,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,gBAAgB,UAAU,EAAE,CAAC,CAAC;IAEzC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/tools/relay-who.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 relayWhoSchema: z.ZodObject<{
+    include_idle: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    project: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    include_idle: boolean;
+    project?: string | undefined;
+}, {
+    project?: string | undefined;
+    include_idle?: boolean | undefined;
+}>;
+export type RelayWhoInput = z.infer<typeof relayWhoSchema>;
+export declare const relayWhoTool: Tool;
+/**
+ * List online agents with status and optional project filtering.
+ */
+export declare function handleRelayWho(client: RelayClient, input: RelayWhoInput): Promise<string>;
+//# sourceMappingURL=relay-who.d.ts.map

package/dist/tools/relay-who.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-who.d.ts","sourceRoot":"","sources":["../../src/tools/relay-who.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oCAAoC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,eAAO,MAAM,cAAc;;;;;;;;;EAGzB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE3D,eAAO,MAAM,YAAY,EAAE,IAyB1B,CAAC;AAEF;;GAEG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,aAAa,GACnB,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/dist/tools/relay-who.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+export const relayWhoSchema = z.object({
+    include_idle: z.boolean().optional().default(true).describe('Include idle agents'),
+    project: z.string().optional().describe('Filter by project (for multi-project setups)'),
+});
+export const relayWhoTool = {
+    name: 'relay_who',
+    description: `List online agents in the relay network.
+
+Shows agent names, their CLI type, and current status.
+
+Example output:
+- Alice (claude) - active
+- Bob (codex) - idle
+- TestRunner (claude) - active [worker of: Alice]`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            include_idle: {
+                type: 'boolean',
+                description: 'Include idle agents',
+                default: true,
+            },
+            project: {
+                type: 'string',
+                description: 'Filter by project',
+            },
+        },
+        required: [],
+    },
+};
+/**
+ * List online agents with status and optional project filtering.
+ */
+export async function handleRelayWho(client, input) {
+    const agents = await client.listAgents(input);
+    if (agents.length === 0) {
+        return 'No agents online.';
+    }
+    const formatted = agents.map((a) => {
+        const status = a.idle ? 'idle' : 'active';
+        const worker = a.parent ? ` [worker of: ${a.parent}]` : '';
+        return `- ${a.name} (${a.cli}) - ${status}${worker}`;
+    });
+    return `${agents.length} agent(s) online:\n${formatted.join('\n')}`;
+}
+//# sourceMappingURL=relay-who.js.map

package/dist/tools/relay-who.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relay-who.js","sourceRoot":"","sources":["../../src/tools/relay-who.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,qBAAqB,CAAC;IAClF,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8CAA8C,CAAC;CACxF,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,YAAY,GAAS;IAChC,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE;;;;;;;kDAOmC;IAChD,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,YAAY,EAAE;gBACZ,IAAI,EAAE,SAAS;gBACf,WAAW,EAAE,qBAAqB;gBAClC,OAAO,EAAE,IAAI;aACd;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,mBAAmB;aACjC;SACF;QACD,QAAQ,EAAE,EAAE;KACb;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,MAAmB,EACnB,KAAoB;IAEpB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,mBAAmB,CAAC;IAC7B,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACjC,MAAM,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1C,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,GAAG,OAAO,MAAM,GAAG,MAAM,EAAE,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,MAAM,CAAC,MAAM,sBAAsB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACtE,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@agent-relay/mcp",
+  "version": "0.1.0",
+  "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",
+  "homepage": "https://github.com/AgentWorkforce/relay#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentWorkforce/relay.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/AgentWorkforce/relay/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "agent-relay-mcp": "dist/bin.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./simple": {
+      "types": "./dist/simple.d.ts",
+      "import": "./dist/simple.js",
+      "default": "./dist/simple.js"
+    },
+    "./install": {
+      "types": "./dist/install-cli.d.ts",
+      "import": "./dist/install-cli.js",
+      "default": "./dist/install-cli.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "prepublishOnly": "npm run clean && npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.3",
+    "typescript": "^5.9.3",
+    "vitest": "^2.1.9"
+  },
+  "keywords": [
+    "mcp",
+    "agent-relay",
+    "ai-agents",
+    "claude",
+    "cursor",
+    "vscode"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}