cross-agent-teams-mcp 0.5.6 → 0.5.7

package/README.md

@@ -251,6 +251,25 @@ Or with an explicit team:
 
 If you don't give a team, the agent uses your current working directory's basename — so you typically don't need to think about it.
 
+### Cross-device communication
+
+When an agent connects to a daemon running on **another machine** (the Cross-host (LAN) section above), it must self-declare a `device` label at registration:
+
+> Register me to xats as alice, device gx-laptop.
+
+That label becomes part of the agent's identity — `(device, team, name)` — so two physical machines can both have a `creator` in `team=default` without collision.  Once registered with a device, addressing across devices uses a `name:device` suffix:
+
+> Send creator on jt-laptop a message: build is green.
+
+This resolves to `creator:jt-laptop` and routes to that exact `(device=jt-laptop, team=…, name=creator)` row.  Bare `creator` resolves on the caller's own device.
+
+Notes:
+
+- The daemon's local label is set with its own `--device` flag (defaults to the daemon host's hostname normalized to lowercase + `-`).  Local-loopback agents auto-fill that label and don't need to specify `device` on register.
+- A remote register call that omits `device` is rejected with `device_required_from_remote`; the channel proxy's startup hint surfaces the configured device value so the agent prompt includes it verbatim.
+- `list_agents` returns a `device` field on every entry so you can see which devices contribute to your team and pick the right `name:device` target.
+- The channel proxy's `--device` flag (`cross-agent-teams-channel --device gx-laptop ...`) sets the device label for the proxy row and is propagated into the registration hint surfaced to the agent.  Match it to whatever label you want your machine's agents to appear under.
+
 ### Talk to other agents
 
 Address by name, by team, or by role:

package/README.zh-CN.md

@@ -251,6 +251,25 @@ agent 第一次连上 xats 时不会自动注册, 要等你开口.  直接说:
 
 不传 team 的话, agent 会用当前工作目录的 basename 作为默认 team — 一般情况下你不用操心.
 
+### 跨设备 (device) 通信
+
+当 agent 连的是**另一台机器**上的 daemon (见上方"跨主机 (LAN) 协作"), 它注册时必须自报一个 `device` 标签:
+
+> Register me to xats as alice, device gx-laptop.
+
+这个 device 会进入 agent 的身份键 — `(device, team, name)` — 所以两台机器都可以有 `team=default` 下的 `creator`, 不会撞名.  注册带上 device 之后, 跨设备寻址用 `name:device` 后缀:
+
+> Send creator on jt-laptop a message: build is green.
+
+这条会被解析成 `creator:jt-laptop`, 准确路由到 `(device=jt-laptop, team=…, name=creator)` 这一行.  裸名字 `creator` 默认解析到 caller 自己 device 上的同名 agent.
+
+要点:
+
+- daemon 自己的 device 标签用 `--device` 设置 (不传则从 daemon 主机的 hostname 派生, 小写 + 非 `[a-z0-9_-]` 替换为 `-`).  loopback 进来的 agent 注册时不必传 device, daemon 会自动填上这个值.
+- 远端 (非 loopback) 连接的 agent 注册时**必须**带 device, 否则 daemon 拒绝并返回 `device_required_from_remote`; channel proxy 的 startup hint 会把已配置的 device 值直接写进引导文案, agent 照抄即可.
+- `list_agents` 每条返回都有 `device` 字段, 方便你看清 team 里都有哪些设备贡献了哪些 agent, 进而拼对的 `name:device`.
+- channel proxy 自己的 `--device` 标志 (`cross-agent-teams-channel --device gx-laptop ...`) 决定 proxy 行的 device 字段, 同一台机器上的 agent 一般用同一个 device 名.
+
 ### 跟其它 agent 对话
 
 按名字, 按 team, 按 role 都行:

package/dist/channel-cli.d.ts

@@ -7,7 +7,7 @@ interface CliArgs {
 declare class CliArgError extends Error {
     constructor(message: string);
 }
-declare function buildStartupHint(csid: string): {
+declare function buildStartupHint(csid: string, device?: string): {
     content: string;
     meta: {
         source: string;

package/dist/channel-cli.js

@@ -230,11 +230,15 @@ var CliArgError = class extends Error {
     this.name = "CliArgError";
   }
 };
-function buildStartupHint(csid) {
+function buildStartupHint(csid, device) {
+  const isCrossHost = device !== void 0;
+  const deviceClause = isCrossHost ? `, device: "${device}"` : "";
+  const deviceRegisterFragment = isCrossHost ? ` (this proxy is running with --device "${device}", so include device: "${device}" verbatim \u2014 the daemon enforces per-origin device validation, and on a remote daemon omitting it returns device_required_from_remote)` : "";
+  const ask = isCrossHost ? `'To join cross-agent-teams (xats) and message other agents, reply with: Register to xats \u2014 name: your-agent-name, team: your-team-name (optional; defaults to the current working directory basename), device: ${device} (cross-host setup \u2014 keep this value verbatim).'` : `'To join cross-agent-teams (xats) and message other agents, reply with: Register to xats \u2014 name: your-agent-name, team: your-team-name (optional; defaults to the current working directory basename).'`;
   const content = [
     `cross-agent-teams-mcp: your channel_session_id is ${csid}.`,
-    `Do NOT register automatically. First ask the user (in English) to register this session so it can talk to other agents \u2014 use exactly this wording: 'To join cross-agent-teams (xats) and message other agents, reply with: Register to xats \u2014 name: your-agent-name, team: your-team-name (optional; defaults to the current working directory basename).'`,
-    `Once the user provides a name (and optionally a team), call register_agent({agent_type: "claude-code", name: "<name from user>", team: "<team from user, omit if not provided>", ui_pid: $PPID, project_dir: "<current working directory>"}) \u2014 do NOT pass channel_session_id here; the daemon auto-binds via ui_pid.`,
+    `Do NOT register automatically. First ask the user (in English) to register this session so it can talk to other agents \u2014 use exactly this wording: ${ask}`,
+    `Once the user provides a name (and optionally a team), call register_agent({agent_type: "claude-code", name: "<name from user>", team: "<team from user, omit if not provided>"${deviceClause}, ui_pid: $PPID, project_dir: "<current working directory>"})${deviceRegisterFragment}. Do NOT pass channel_session_id here; the daemon auto-binds via ui_pid.`,
     `bind_channel({channel_session_id: "${csid}"}) is the low-level rebind tool for an already-registered Claude host that needs to switch to a fresh csid; it is NOT the primary registration path.`,
     `Do not use curl or another external HTTP client for Claude registration here \u2014 that would create a different MCP session, and follow-up tools in Claude Code could still see unknown_agent.`
   ].join(" ");
@@ -305,7 +309,7 @@ async function main(argv = process.argv.slice(2), env = process.env) {
     },
     onSequenceComplete: () => {
       registrationEverSucceeded = true;
-      const hint = buildStartupHint(csid);
+      const hint = buildStartupHint(csid, args.device);
       relayChannelWake(hostServer, hint);
     }
   });

package/dist/channel-cli.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../plugins/cross-agent-teams-channel/src/cli.ts","../plugins/cross-agent-teams-channel/src/proxy.ts","../plugins/cross-agent-teams-channel/src/daemon-client.ts","../plugins/cross-agent-teams-channel/src/find-claude-pid.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { randomUUID } from 'node:crypto'\nimport { realpathSync } from 'node:fs'\nimport { hostname } from 'node:os'\nimport { fileURLToPath } from 'node:url'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { createProxyServer, relayChannelWake } from './proxy.js'\nimport { runReconnectingProxy } from './daemon-client.js'\n\ninterface CliArgs {\n  daemonUrl: string\n  token?: string\n  // Omitted when the user did not pass --device. The daemon then auto-fills\n  // its own local label on loopback registrations, which keeps zero-config\n  // proxies working against a daemon whose operator chose a custom --device.\n  device?: string\n}\n\nexport class CliArgError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'CliArgError'\n  }\n}\n\nexport function buildStartupHint(csid: string): { content: string; meta: { source: string; kind: string } } {\n  const content = [\n    `cross-agent-teams-mcp: your channel_session_id is ${csid}.`,\n    `Do NOT register automatically. First ask the user (in English) to register this session so it can talk to other agents — use exactly this wording: 'To join cross-agent-teams (xats) and message other agents, reply with: Register to xats — name: your-agent-name, team: your-team-name (optional; defaults to the current working directory basename).'`,\n    `Once the user provides a name (and optionally a team), call register_agent({agent_type: \"claude-code\", name: \"<name from user>\", team: \"<team from user, omit if not provided>\", ui_pid: $PPID, project_dir: \"<current working directory>\"}) — do NOT pass channel_session_id here; the daemon auto-binds via ui_pid.`,\n    `bind_channel({channel_session_id: \"${csid}\"}) is the low-level rebind tool for an already-registered Claude host that needs to switch to a fresh csid; it is NOT the primary registration path.`,\n    `Do not use curl or another external HTTP client for Claude registration here — that would create a different MCP session, and follow-up tools in Claude Code could still see unknown_agent.`\n  ].join(' ')\n  return {\n    content,\n    meta: { source: 'cross_agent_teams_mcp', kind: 'startup_bind_hint' }\n  }\n}\n\nexport function parseCliArgs(argv: readonly string[], env: NodeJS.ProcessEnv = process.env): CliArgs {\n  let daemonUrl: string | undefined\n  let token: string | undefined\n  let explicitDevice: string | undefined\n\n  for (let i = 0; i < argv.length; i++) {\n    const flag = argv[i]\n    const next = argv[i + 1]\n    switch (flag) {\n      case '--daemon-url':\n        daemonUrl = next; i++; break\n      case '--token':\n        token = next; i++; break\n      case '--device':\n        explicitDevice = next; i++; break\n      default:\n        // Ignore unknown flags for forward-compat (including legacy\n        // --agent-team / --agent-name, which are no longer honored).\n        break\n    }\n  }\n\n  if (!daemonUrl || daemonUrl.length === 0) {\n    daemonUrl = env.CROSS_AGENT_TEAMS_MCP_DAEMON_URL\n  }\n  if (!token || token.length === 0) {\n    token = env.CROSS_AGENT_TEAMS_MCP_TOKEN\n  }\n\n  if (!daemonUrl || daemonUrl.length === 0) {\n    throw new CliArgError(\n      'missing --daemon-url (or CROSS_AGENT_TEAMS_MCP_DAEMON_URL env var)'\n    )\n  }\n  // Only validate / pass the device when the user explicitly provided one.\n  // Leaving it undefined lets daemon-client omit the field on register_agent\n  // so the daemon's loopback auto-fill resolves it to the daemon's localDevice.\n  const device =\n    explicitDevice !== undefined ? resolveDeviceLabel(explicitDevice) : undefined\n  return { daemonUrl, token, device }\n}\n\nexport async function main(\n  argv: readonly string[] = process.argv.slice(2),\n  env: NodeJS.ProcessEnv = process.env\n): Promise<void> {\n  let args: CliArgs\n  try {\n    args = parseCliArgs(argv, env)\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err)\n    process.stderr.write(`cross-agent-teams-proxy: ${msg}\\n`)\n    process.exit(2)\n  }\n\n  // Fresh csid per startup — no persistence. Multi-instance safe.\n  const csid = randomUUID()\n\n  const hostServer = createProxyServer()\n  const stdioTransport = new StdioServerTransport()\n\n  let registrationEverSucceeded = false\n  const controller = runReconnectingProxy({\n    daemonUrl: args.daemonUrl,\n    token: args.token,\n    device: args.device,\n    channel_session_id: csid,\n    notificationHandler: (params) => {\n      relayChannelWake(hostServer, params as { content: string; meta: Record<string, string> })\n    },\n    onSequenceComplete: () => {\n      registrationEverSucceeded = true\n      // Announce csid to Claude via host-facing channel notification so Claude\n      // can call bind_channel({channel_session_id}) to bind its own agent row.\n      const hint = buildStartupHint(csid)\n      relayChannelWake(hostServer, hint)\n    }\n  })\n\n  let stopped = false\n  const shutdown = async (): Promise<void> => {\n    if (stopped) return\n    stopped = true\n    try { await controller.stop() } catch { /* best-effort */ }\n    try { await hostServer.close() } catch { /* best-effort */ }\n    if (!registrationEverSucceeded) {\n      process.stderr.write(`cross-agent-teams-proxy: daemon unreachable at ${args.daemonUrl}\\n`)\n      process.exit(1)\n    }\n    process.exit(0)\n  }\n\n  stdioTransport.onclose = () => { void shutdown() }\n\n  await hostServer.connect(stdioTransport)\n\n  process.on('SIGTERM', () => { void shutdown() })\n  process.on('SIGINT', () => { void shutdown() })\n}\n\n// Entry-point check.  The naive `import.meta.url === \\`file://${process.argv[1]}\\``\n// breaks when launched via an npm `.bin` symlink (npx, `npm install -g`):\n// process.argv[1] is the symlink path, while import.meta.url is already\n// resolved.  Compare realpath-resolved file paths instead.\nfunction isEntry(): boolean {\n  try {\n    const metaPath = fileURLToPath(import.meta.url)\n    const argvPath = realpathSync(process.argv[1])\n    return metaPath === argvPath\n  } catch {\n    return false\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-misused-promises\nif (isEntry()) {\n  void main()\n}\n\nfunction resolveDeviceLabel(explicit?: string): string {\n  const raw = explicit ?? hostname()\n  if (raw.includes(':')) {\n    throw new CliArgError('invalid_device_label')\n  }\n  const normalized = raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]/g, '-')\n  const label = normalized.length > 0 ? normalized : 'local'\n  if (label.length > 64) {\n    throw new CliArgError('invalid_device_label')\n  }\n  return label\n}\n","import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nexport function createProxyServer(): McpServer {\n  return new McpServer(\n    { name: 'cross-agent-teams-channel', version: '0.1.0' },\n    { capabilities: { experimental: { 'claude/channel': {} } } }\n  )\n}\n\nexport interface ChannelWakeParams {\n  content: string\n  meta: Record<string, string>\n}\n\nexport function relayChannelWake(server: McpServer, params: ChannelWakeParams): void {\n  try {\n    const notif = {\n      method: 'notifications/claude/channel',\n      params: params as unknown as Record<string, unknown>\n    }\n    const p = (server.server.notification as (n: typeof notif) => Promise<void>)(notif)\n    if (p && typeof p.catch === 'function') {\n      p.catch(() => { /* host closed — drop silently */ })\n    }\n  } catch {\n    // host transport closed or not yet connected — drop silently\n  }\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\nimport { findClaudeUiPid } from './find-claude-pid.js'\n\nexport interface RegistrationConfig {\n  daemonUrl: string\n  token?: string\n  device?: string\n  channel_session_id: string\n  backoffInitialMs?: number\n  backoffMaxMs?: number\n  notificationHandler?: (payload: unknown) => void\n}\n\nexport interface ReconnectingProxyConfig extends RegistrationConfig {\n  onSequenceComplete?: (order: string[]) => void\n  onDisconnect?: () => void\n  healthCheckIntervalMs?: number\n}\n\nexport interface ReconnectingProxyController {\n  stop(): Promise<void>\n}\n\nexport interface RegistrationSequenceResult {\n  order: string[]\n  lastSubscribeResult: unknown\n  client: Client\n  transport: StreamableHTTPClientTransport\n  close: () => Promise<void>\n}\n\ntype ToolResult = Record<string, unknown>\n\nasync function parseToolResult(resp: unknown): Promise<ToolResult> {\n  const r = resp as { content?: Array<{ text?: string }> }\n  const text = r.content?.[0]?.text\n  if (typeof text !== 'string') return {}\n  try { return JSON.parse(text) as ToolResult } catch { return {} }\n}\n\nexport async function runRegistrationSequence(\n  config: RegistrationConfig\n): Promise<RegistrationSequenceResult> {\n  const order: string[] = []\n  const requestInit = config.token\n    ? { headers: { Authorization: `Bearer ${config.token}` } }\n    : undefined\n  const transport = new StreamableHTTPClientTransport(new URL(config.daemonUrl), {\n    requestInit,\n  })\n  const client = new Client({ name: 'cross-agent-teams-proxy', version: '0.1.0' })\n\n  if (config.notificationHandler) {\n    client.fallbackNotificationHandler = async (n) => {\n      if (n.method === 'notifications/channel_wake') {\n        config.notificationHandler!(n.params)\n      }\n    }\n  }\n\n  await client.connect(transport)\n\n  // 1. register_agent as proxy — identity keyed on pid, stable across reconnects\n  // so the (device, team, name) ON CONFLICT upsert reuses the same row instead of spamming new rows.\n  // Only send `device` when the caller explicitly set one; otherwise let the daemon auto-fill\n  // its local label (loopback) or reject (remote, which requires explicit device).\n  const registerArgs: Record<string, unknown> = {\n    agent_type: 'custom',\n    agent_type_name: 'cross-agent-teams-channel',\n    model: 'proxy',\n    role: '__channel_proxy__',\n    name: `channel-proxy-${process.pid}`,\n    team: 'default',\n    claude_ui_pid: findClaudeUiPid(),\n    delivery: {\n      kind: 'claude-channel',\n      channel_session_id: config.channel_session_id,\n    },\n  }\n  if (config.device !== undefined) {\n    registerArgs.device = config.device\n  }\n  const registerResp = await client.callTool({\n    name: 'register_agent',\n    arguments: registerArgs,\n  })\n  order.push('register_agent')\n  const regResult = await parseToolResult(registerResp)\n  if (!('agent_id' in regResult)) {\n    throw new Error(`register_agent failed: ${JSON.stringify(regResult)}`)\n  }\n\n  // 2. subscribe_channel_wake — proxy's csid is fresh per startup\n  const subResp = await client.callTool({\n    name: 'subscribe_channel_wake',\n    arguments: { channel_session_id: config.channel_session_id }\n  })\n  order.push('subscribe_channel_wake')\n  const subResult = await parseToolResult(subResp)\n  if (!('ok' in subResult) || subResult.ok !== true) {\n    throw new Error(`subscribe_channel_wake failed: ${JSON.stringify(subResult)}`)\n  }\n\n  return {\n    order,\n    lastSubscribeResult: subResult,\n    client,\n    transport,\n    close: async () => {\n      try { await client.close() } catch { /* best-effort */ }\n      try { await transport.close() } catch { /* best-effort */ }\n    }\n  }\n}\n\nexport interface WaitForDisconnectInput {\n  client: Pick<Client, 'callTool'>\n  transport: { onclose?: (() => void) | null | undefined }\n}\n\nexport interface WaitForDisconnectOptions {\n  healthCheckIntervalMs?: number\n  shouldStop?: () => boolean\n}\n\nexport async function waitForDisconnect(\n  seq: WaitForDisconnectInput,\n  opts: WaitForDisconnectOptions = {}\n): Promise<void> {\n  const interval = opts.healthCheckIntervalMs ?? 30_000\n  const shouldStop = opts.shouldStop ?? (() => false)\n  let disconnected = false\n  let wakeup: (() => void) | null = null\n  const closeHandler = (): void => {\n    disconnected = true\n    wakeup?.()\n  }\n  const prevOnClose = seq.transport.onclose\n  seq.transport.onclose = (): void => { prevOnClose?.(); closeHandler() }\n  while (!disconnected && !shouldStop()) {\n    await new Promise<void>((resolve) => {\n      const timer = setTimeout(() => { wakeup = null; resolve() }, interval)\n      wakeup = (): void => { clearTimeout(timer); wakeup = null; resolve() }\n    })\n    if (disconnected || shouldStop()) break\n    try {\n      await seq.client.callTool({ name: 'echo', arguments: { msg: 'hb' } })\n    } catch {\n      disconnected = true\n      break\n    }\n  }\n}\n\nexport function runReconnectingProxy(config: ReconnectingProxyConfig): ReconnectingProxyController {\n  let stopped = false\n  let currentSeq: RegistrationSequenceResult | null = null\n\n  async function loop(): Promise<void> {\n    while (!stopped) {\n      try {\n        const seq = await runRegistrationSequence(config)\n        currentSeq = seq\n        if (config.onSequenceComplete) config.onSequenceComplete([...seq.order])\n\n        await waitForDisconnect(seq, {\n          healthCheckIntervalMs: config.healthCheckIntervalMs,\n          shouldStop: () => stopped,\n        })\n        if (config.onDisconnect) config.onDisconnect()\n        try { await seq.close() } catch { /* best-effort */ }\n        currentSeq = null\n      } catch {\n        // register/subscribe failed — wait and retry.\n      }\n      if (stopped) break\n      const wait = config.backoffInitialMs ?? 500\n      await new Promise(r => setTimeout(r, wait))\n    }\n  }\n\n  void loop()\n\n  return {\n    stop: async () => {\n      stopped = true\n      if (currentSeq) {\n        try { await currentSeq.close() } catch { /* best-effort */ }\n      }\n    }\n  }\n}\n","import { execFileSync } from 'node:child_process'\n\nconst MAX_HOPS = 8\n\ninterface PsRow {\n  ppid: number\n  cmd: string\n}\n\nexport function readPsRow(pid: number): PsRow | null {\n  try {\n    const out = execFileSync('ps', ['-o', 'ppid=,args=', '-p', String(pid)], {\n      encoding: 'utf8',\n      timeout: 1000,\n      stdio: ['ignore', 'pipe', 'ignore']\n    })\n    const trimmed = out.trim()\n    if (!trimmed) return null\n    const m = /^\\s*(\\d+)\\s+(.*)$/.exec(trimmed)\n    if (!m) return null\n    return { ppid: parseInt(m[1], 10), cmd: m[2] }\n  } catch {\n    return null\n  }\n}\n\nexport function isClaudeCmd(cmd: string): boolean {\n  const first = cmd.trim().split(/\\s+/)[0]\n  if (!first) return false\n  const base = first.replace(/^.*\\//, '')\n  return base === 'claude'\n}\n\nexport function findClaudeUiPid(\n  startPpid: number = process.ppid,\n  reader: (pid: number) => PsRow | null = readPsRow\n): number {\n  let pid = startPpid\n  for (let i = 0; i < MAX_HOPS; i++) {\n    const row = reader(pid)\n    if (!row) break\n    if (isClaudeCmd(row.cmd)) return pid\n    if (row.ppid <= 1 || row.ppid === pid) break\n    pid = row.ppid\n  }\n  return startPpid\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../plugins/cross-agent-teams-channel/src/cli.ts","../plugins/cross-agent-teams-channel/src/proxy.ts","../plugins/cross-agent-teams-channel/src/daemon-client.ts","../plugins/cross-agent-teams-channel/src/find-claude-pid.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { randomUUID } from 'node:crypto'\nimport { realpathSync } from 'node:fs'\nimport { hostname } from 'node:os'\nimport { fileURLToPath } from 'node:url'\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js'\nimport { createProxyServer, relayChannelWake } from './proxy.js'\nimport { runReconnectingProxy } from './daemon-client.js'\n\ninterface CliArgs {\n  daemonUrl: string\n  token?: string\n  // Omitted when the user did not pass --device. The daemon then auto-fills\n  // its own local label on loopback registrations, which keeps zero-config\n  // proxies working against a daemon whose operator chose a custom --device.\n  device?: string\n}\n\nexport class CliArgError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'CliArgError'\n  }\n}\n\nexport function buildStartupHint(\n  csid: string,\n  device?: string\n): { content: string; meta: { source: string; kind: string } } {\n  // Local default path (no --device): emit the original same-host hint with NO\n  // device-related noise. Pure-local users never need to think about device.\n  // Cross-host path (--device passed): surface the device value in both the\n  // user-facing ask and the register_agent call so the agent and the human\n  // both know it is required (daemon returns device_required_from_remote\n  // otherwise).\n  const isCrossHost = device !== undefined\n  const deviceClause = isCrossHost ? `, device: \"${device}\"` : ''\n  const deviceRegisterFragment = isCrossHost\n    ? ` (this proxy is running with --device \"${device}\", so include device: \"${device}\" verbatim — the daemon enforces per-origin device validation, and on a remote daemon omitting it returns device_required_from_remote)`\n    : ''\n  const ask = isCrossHost\n    ? `'To join cross-agent-teams (xats) and message other agents, reply with: Register to xats — name: your-agent-name, team: your-team-name (optional; defaults to the current working directory basename), device: ${device} (cross-host setup — keep this value verbatim).'`\n    : `'To join cross-agent-teams (xats) and message other agents, reply with: Register to xats — name: your-agent-name, team: your-team-name (optional; defaults to the current working directory basename).'`\n  const content = [\n    `cross-agent-teams-mcp: your channel_session_id is ${csid}.`,\n    `Do NOT register automatically. First ask the user (in English) to register this session so it can talk to other agents — use exactly this wording: ${ask}`,\n    `Once the user provides a name (and optionally a team), call register_agent({agent_type: \"claude-code\", name: \"<name from user>\", team: \"<team from user, omit if not provided>\"${deviceClause}, ui_pid: $PPID, project_dir: \"<current working directory>\"})${deviceRegisterFragment}. Do NOT pass channel_session_id here; the daemon auto-binds via ui_pid.`,\n    `bind_channel({channel_session_id: \"${csid}\"}) is the low-level rebind tool for an already-registered Claude host that needs to switch to a fresh csid; it is NOT the primary registration path.`,\n    `Do not use curl or another external HTTP client for Claude registration here — that would create a different MCP session, and follow-up tools in Claude Code could still see unknown_agent.`\n  ].join(' ')\n  return {\n    content,\n    meta: { source: 'cross_agent_teams_mcp', kind: 'startup_bind_hint' }\n  }\n}\n\nexport function parseCliArgs(argv: readonly string[], env: NodeJS.ProcessEnv = process.env): CliArgs {\n  let daemonUrl: string | undefined\n  let token: string | undefined\n  let explicitDevice: string | undefined\n\n  for (let i = 0; i < argv.length; i++) {\n    const flag = argv[i]\n    const next = argv[i + 1]\n    switch (flag) {\n      case '--daemon-url':\n        daemonUrl = next; i++; break\n      case '--token':\n        token = next; i++; break\n      case '--device':\n        explicitDevice = next; i++; break\n      default:\n        // Ignore unknown flags for forward-compat (including legacy\n        // --agent-team / --agent-name, which are no longer honored).\n        break\n    }\n  }\n\n  if (!daemonUrl || daemonUrl.length === 0) {\n    daemonUrl = env.CROSS_AGENT_TEAMS_MCP_DAEMON_URL\n  }\n  if (!token || token.length === 0) {\n    token = env.CROSS_AGENT_TEAMS_MCP_TOKEN\n  }\n\n  if (!daemonUrl || daemonUrl.length === 0) {\n    throw new CliArgError(\n      'missing --daemon-url (or CROSS_AGENT_TEAMS_MCP_DAEMON_URL env var)'\n    )\n  }\n  // Only validate / pass the device when the user explicitly provided one.\n  // Leaving it undefined lets daemon-client omit the field on register_agent\n  // so the daemon's loopback auto-fill resolves it to the daemon's localDevice.\n  const device =\n    explicitDevice !== undefined ? resolveDeviceLabel(explicitDevice) : undefined\n  return { daemonUrl, token, device }\n}\n\nexport async function main(\n  argv: readonly string[] = process.argv.slice(2),\n  env: NodeJS.ProcessEnv = process.env\n): Promise<void> {\n  let args: CliArgs\n  try {\n    args = parseCliArgs(argv, env)\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err)\n    process.stderr.write(`cross-agent-teams-proxy: ${msg}\\n`)\n    process.exit(2)\n  }\n\n  // Fresh csid per startup — no persistence. Multi-instance safe.\n  const csid = randomUUID()\n\n  const hostServer = createProxyServer()\n  const stdioTransport = new StdioServerTransport()\n\n  let registrationEverSucceeded = false\n  const controller = runReconnectingProxy({\n    daemonUrl: args.daemonUrl,\n    token: args.token,\n    device: args.device,\n    channel_session_id: csid,\n    notificationHandler: (params) => {\n      relayChannelWake(hostServer, params as { content: string; meta: Record<string, string> })\n    },\n    onSequenceComplete: () => {\n      registrationEverSucceeded = true\n      // Announce csid to Claude via host-facing channel notification so Claude\n      // can call bind_channel({channel_session_id}) to bind its own agent row.\n      const hint = buildStartupHint(csid, args.device)\n      relayChannelWake(hostServer, hint)\n    }\n  })\n\n  let stopped = false\n  const shutdown = async (): Promise<void> => {\n    if (stopped) return\n    stopped = true\n    try { await controller.stop() } catch { /* best-effort */ }\n    try { await hostServer.close() } catch { /* best-effort */ }\n    if (!registrationEverSucceeded) {\n      process.stderr.write(`cross-agent-teams-proxy: daemon unreachable at ${args.daemonUrl}\\n`)\n      process.exit(1)\n    }\n    process.exit(0)\n  }\n\n  stdioTransport.onclose = () => { void shutdown() }\n\n  await hostServer.connect(stdioTransport)\n\n  process.on('SIGTERM', () => { void shutdown() })\n  process.on('SIGINT', () => { void shutdown() })\n}\n\n// Entry-point check.  The naive `import.meta.url === \\`file://${process.argv[1]}\\``\n// breaks when launched via an npm `.bin` symlink (npx, `npm install -g`):\n// process.argv[1] is the symlink path, while import.meta.url is already\n// resolved.  Compare realpath-resolved file paths instead.\nfunction isEntry(): boolean {\n  try {\n    const metaPath = fileURLToPath(import.meta.url)\n    const argvPath = realpathSync(process.argv[1])\n    return metaPath === argvPath\n  } catch {\n    return false\n  }\n}\n\n// eslint-disable-next-line @typescript-eslint/no-misused-promises\nif (isEntry()) {\n  void main()\n}\n\nfunction resolveDeviceLabel(explicit?: string): string {\n  const raw = explicit ?? hostname()\n  if (raw.includes(':')) {\n    throw new CliArgError('invalid_device_label')\n  }\n  const normalized = raw\n    .trim()\n    .toLowerCase()\n    .replace(/[^a-z0-9_-]/g, '-')\n  const label = normalized.length > 0 ? normalized : 'local'\n  if (label.length > 64) {\n    throw new CliArgError('invalid_device_label')\n  }\n  return label\n}\n","import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js'\n\nexport function createProxyServer(): McpServer {\n  return new McpServer(\n    { name: 'cross-agent-teams-channel', version: '0.1.0' },\n    { capabilities: { experimental: { 'claude/channel': {} } } }\n  )\n}\n\nexport interface ChannelWakeParams {\n  content: string\n  meta: Record<string, string>\n}\n\nexport function relayChannelWake(server: McpServer, params: ChannelWakeParams): void {\n  try {\n    const notif = {\n      method: 'notifications/claude/channel',\n      params: params as unknown as Record<string, unknown>\n    }\n    const p = (server.server.notification as (n: typeof notif) => Promise<void>)(notif)\n    if (p && typeof p.catch === 'function') {\n      p.catch(() => { /* host closed — drop silently */ })\n    }\n  } catch {\n    // host transport closed or not yet connected — drop silently\n  }\n}\n","import { Client } from '@modelcontextprotocol/sdk/client/index.js'\nimport { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js'\nimport { findClaudeUiPid } from './find-claude-pid.js'\n\nexport interface RegistrationConfig {\n  daemonUrl: string\n  token?: string\n  device?: string\n  channel_session_id: string\n  backoffInitialMs?: number\n  backoffMaxMs?: number\n  notificationHandler?: (payload: unknown) => void\n}\n\nexport interface ReconnectingProxyConfig extends RegistrationConfig {\n  onSequenceComplete?: (order: string[]) => void\n  onDisconnect?: () => void\n  healthCheckIntervalMs?: number\n}\n\nexport interface ReconnectingProxyController {\n  stop(): Promise<void>\n}\n\nexport interface RegistrationSequenceResult {\n  order: string[]\n  lastSubscribeResult: unknown\n  client: Client\n  transport: StreamableHTTPClientTransport\n  close: () => Promise<void>\n}\n\ntype ToolResult = Record<string, unknown>\n\nasync function parseToolResult(resp: unknown): Promise<ToolResult> {\n  const r = resp as { content?: Array<{ text?: string }> }\n  const text = r.content?.[0]?.text\n  if (typeof text !== 'string') return {}\n  try { return JSON.parse(text) as ToolResult } catch { return {} }\n}\n\nexport async function runRegistrationSequence(\n  config: RegistrationConfig\n): Promise<RegistrationSequenceResult> {\n  const order: string[] = []\n  const requestInit = config.token\n    ? { headers: { Authorization: `Bearer ${config.token}` } }\n    : undefined\n  const transport = new StreamableHTTPClientTransport(new URL(config.daemonUrl), {\n    requestInit,\n  })\n  const client = new Client({ name: 'cross-agent-teams-proxy', version: '0.1.0' })\n\n  if (config.notificationHandler) {\n    client.fallbackNotificationHandler = async (n) => {\n      if (n.method === 'notifications/channel_wake') {\n        config.notificationHandler!(n.params)\n      }\n    }\n  }\n\n  await client.connect(transport)\n\n  // 1. register_agent as proxy — identity keyed on pid, stable across reconnects\n  // so the (device, team, name) ON CONFLICT upsert reuses the same row instead of spamming new rows.\n  // Only send `device` when the caller explicitly set one; otherwise let the daemon auto-fill\n  // its local label (loopback) or reject (remote, which requires explicit device).\n  const registerArgs: Record<string, unknown> = {\n    agent_type: 'custom',\n    agent_type_name: 'cross-agent-teams-channel',\n    model: 'proxy',\n    role: '__channel_proxy__',\n    name: `channel-proxy-${process.pid}`,\n    team: 'default',\n    claude_ui_pid: findClaudeUiPid(),\n    delivery: {\n      kind: 'claude-channel',\n      channel_session_id: config.channel_session_id,\n    },\n  }\n  if (config.device !== undefined) {\n    registerArgs.device = config.device\n  }\n  const registerResp = await client.callTool({\n    name: 'register_agent',\n    arguments: registerArgs,\n  })\n  order.push('register_agent')\n  const regResult = await parseToolResult(registerResp)\n  if (!('agent_id' in regResult)) {\n    throw new Error(`register_agent failed: ${JSON.stringify(regResult)}`)\n  }\n\n  // 2. subscribe_channel_wake — proxy's csid is fresh per startup\n  const subResp = await client.callTool({\n    name: 'subscribe_channel_wake',\n    arguments: { channel_session_id: config.channel_session_id }\n  })\n  order.push('subscribe_channel_wake')\n  const subResult = await parseToolResult(subResp)\n  if (!('ok' in subResult) || subResult.ok !== true) {\n    throw new Error(`subscribe_channel_wake failed: ${JSON.stringify(subResult)}`)\n  }\n\n  return {\n    order,\n    lastSubscribeResult: subResult,\n    client,\n    transport,\n    close: async () => {\n      try { await client.close() } catch { /* best-effort */ }\n      try { await transport.close() } catch { /* best-effort */ }\n    }\n  }\n}\n\nexport interface WaitForDisconnectInput {\n  client: Pick<Client, 'callTool'>\n  transport: { onclose?: (() => void) | null | undefined }\n}\n\nexport interface WaitForDisconnectOptions {\n  healthCheckIntervalMs?: number\n  shouldStop?: () => boolean\n}\n\nexport async function waitForDisconnect(\n  seq: WaitForDisconnectInput,\n  opts: WaitForDisconnectOptions = {}\n): Promise<void> {\n  const interval = opts.healthCheckIntervalMs ?? 30_000\n  const shouldStop = opts.shouldStop ?? (() => false)\n  let disconnected = false\n  let wakeup: (() => void) | null = null\n  const closeHandler = (): void => {\n    disconnected = true\n    wakeup?.()\n  }\n  const prevOnClose = seq.transport.onclose\n  seq.transport.onclose = (): void => { prevOnClose?.(); closeHandler() }\n  while (!disconnected && !shouldStop()) {\n    await new Promise<void>((resolve) => {\n      const timer = setTimeout(() => { wakeup = null; resolve() }, interval)\n      wakeup = (): void => { clearTimeout(timer); wakeup = null; resolve() }\n    })\n    if (disconnected || shouldStop()) break\n    try {\n      await seq.client.callTool({ name: 'echo', arguments: { msg: 'hb' } })\n    } catch {\n      disconnected = true\n      break\n    }\n  }\n}\n\nexport function runReconnectingProxy(config: ReconnectingProxyConfig): ReconnectingProxyController {\n  let stopped = false\n  let currentSeq: RegistrationSequenceResult | null = null\n\n  async function loop(): Promise<void> {\n    while (!stopped) {\n      try {\n        const seq = await runRegistrationSequence(config)\n        currentSeq = seq\n        if (config.onSequenceComplete) config.onSequenceComplete([...seq.order])\n\n        await waitForDisconnect(seq, {\n          healthCheckIntervalMs: config.healthCheckIntervalMs,\n          shouldStop: () => stopped,\n        })\n        if (config.onDisconnect) config.onDisconnect()\n        try { await seq.close() } catch { /* best-effort */ }\n        currentSeq = null\n      } catch {\n        // register/subscribe failed — wait and retry.\n      }\n      if (stopped) break\n      const wait = config.backoffInitialMs ?? 500\n      await new Promise(r => setTimeout(r, wait))\n    }\n  }\n\n  void loop()\n\n  return {\n    stop: async () => {\n      stopped = true\n      if (currentSeq) {\n        try { await currentSeq.close() } catch { /* best-effort */ }\n      }\n    }\n  }\n}\n","import { execFileSync } from 'node:child_process'\n\nconst MAX_HOPS = 8\n\ninterface PsRow {\n  ppid: number\n  cmd: string\n}\n\nexport function readPsRow(pid: number): PsRow | null {\n  try {\n    const out = execFileSync('ps', ['-o', 'ppid=,args=', '-p', String(pid)], {\n      encoding: 'utf8',\n      timeout: 1000,\n      stdio: ['ignore', 'pipe', 'ignore']\n    })\n    const trimmed = out.trim()\n    if (!trimmed) return null\n    const m = /^\\s*(\\d+)\\s+(.*)$/.exec(trimmed)\n    if (!m) return null\n    return { ppid: parseInt(m[1], 10), cmd: m[2] }\n  } catch {\n    return null\n  }\n}\n\nexport function isClaudeCmd(cmd: string): boolean {\n  const first = cmd.trim().split(/\\s+/)[0]\n  if (!first) return false\n  const base = first.replace(/^.*\\//, '')\n  return base === 'claude'\n}\n\nexport function findClaudeUiPid(\n  startPpid: number = process.ppid,\n  reader: (pid: number) => PsRow | null = readPsRow\n): number {\n  let pid = startPpid\n  for (let i = 0; i < MAX_HOPS; i++) {\n    const row = reader(pid)\n    if (!row) break\n    if (isClaudeCmd(row.cmd)) return pid\n    if (row.ppid <= 1 || row.ppid === pid) break\n    pid = row.ppid\n  }\n  return startPpid\n}\n"],"mappings":"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","names":[]}

package/dist/cli.js

@@ -1510,7 +1510,9 @@ var GetInboxService = class {
     const tx = this.db.transaction(() => {
       const rows = this.db.prepare(
         `SELECT m.id, m.event_id, m.from_team, m.to_team, m.from_agent_id, m.to_agent_id, m.to_role, m.subject, m.body, m.need_reply, m.sent_at,
-                a.role as from_role
+                a.role as from_role,
+                a.name as from_name,
+                a.device as from_device
            FROM messages m
            LEFT JOIN agents a ON a.agent_id = m.from_agent_id
           WHERE m.to_team = ?
@@ -3322,6 +3324,7 @@ var SEND_MESSAGE_DESC = [
   "Private 1\u21921 message to another agent by name.  By default auto-poke=true with quiet-guard (auto_poke:false opts out), and need_reply=true.",
   "Set need_reply:false for FYI/no-response-needed messages; recipients see need_reply in get_inbox.",
   "to_agent_name is the target's `name` within its team; bare names resolve on the caller's device, and `name:device` targets a specific device.  For UUID-based sends use send_message_by_id.",
+  'REPLY RULE: when replying to a message returned by get_inbox, treat its `from_device` as authoritative \u2014 if it differs from your own device, you MUST send to `from_name + ":" + from_device` (bare `from_name` would resolve on YOUR device and miss the actual sender). Same-device replies can use the bare name. The safe fallback for unknown device is send_message_by_id({to_agent_id: from_agent_id, ...}).',
   "For multi-recipient use broadcast (same-team) or broadcast_to_role (same-team, by role).",
   "\u9664\u975E\u7528\u6237\u660E\u786E\u6307\u5B9A to_team, \u4E0D\u8981\u8DE8 team \u6C9F\u901A (explicitly set to_team only when user asks).",
   "Reports poked, poke_skip_reasons (no_pane, guard_failed, tmux_unavailable, self); on guard_failed daemon retries at 30s/180s/600s (retry_scheduled, retry_delays_s); stops early on poked.",
@@ -3885,6 +3888,7 @@ function registerBusinessTools(server, db, getCallerAgentId, fanout, onRegisterS
         "Default behaviour (since_event_id omitted): the daemon reads the caller's server-side cursor (`agents.last_processed_event_id`), returns mail past it, and ADVANCES the cursor to the highest returned event_id in the same transaction. Subsequent default calls return only newer mail.",
         "Pagination via `limit` advances the cursor only to the last RETURNED event_id; the next default call resumes from there.",
         "Explicit `since_event_id` (any number, including 0) is read-only inspection: the daemon uses the supplied value as the lower bound and does NOT advance the stored cursor \u2014 useful for re-reading history or debugging without disturbing live read position.",
+        'REPLY GUIDANCE: every returned message carries `from_agent_id`, `from_name`, and `from_device` for the sender. When replying via `send_message`, construct `to_agent_name` as `from_name + ":" + from_device` whenever `from_device !== <your own device>` \u2014 otherwise the daemon resolves the bare name on YOUR device, misses the cross-device sender, and returns `unknown_recipient`. Bare `from_name` is correct only when `from_device === <your own device>`. `send_message_by_id({to_agent_id: from_agent_id, ...})` always works regardless of device and is the safe fallback when device is unknown.',
         "Retention: messages older than 30 days are deleted by the cleanup routine regardless of read state. Agents that go offline for more than 30 days forfeit any unread mail in that window."
       ].join(" "),
       inputSchema: {