agent2agent-cli 0.3.2 → 0.3.4

package/a2a-mcp.js

@@ -24,7 +24,7 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 
-const VERSION = '0.3.2';
+const VERSION = '0.3.4';
 const PROTOCOL_VERSION = '2024-11-05'; // MCP 当前稳定协议版本
 
 /* ------------------------------------------------------------------ *
@@ -357,12 +357,19 @@ async function apiText(config, pathName) {
 /* ------------------------------------------------------------------ *
  * MCP stdio 传输（换行分隔 JSON-RPC 2.0）
  * ------------------------------------------------------------------ */
+// 兼容的 MCP 协议版本（Cursor 可能请求较新版本，回显客户端请求值）
+const KNOWN_PROTOCOLS = ['2024-11-05', '2025-03-26', '2025-06-18'];
+
 function main() {
+  // 找不到配置不再退出：server 照常启动（tools 可用），调用工具时才给出明确指引
   const config = resolveConfig();
-  if (!config.url) {
-    console.error('[a2a-mcp] 未找到平台配置：请在项目根运行（含 .a2a.json），或设置 A2A_URL / A2A_TOKEN / A2A_ACCOUNT');
-    console.error('[a2a-mcp] 首次接入：a2a init');
-    process.exit(1);
+  const cfgMissing = !config.url;
+  if (cfgMissing) {
+    console.error(`[a2a-mcp v${VERSION}] 当前工作目录: ${process.cwd()}`);
+    console.error('[a2a-mcp] 未找到平台配置（.a2a.json）：请在含 .a2a.json 的项目目录使用；');
+    console.error('[a2a-mcp] 或设置 A2A_URL / A2A_TOKEN / A2A_ACCOUNT 环境变量；首次接入：a2a init');
+  } else {
+    console.error(`[a2a-mcp v${VERSION}] 已加载配置: ${config.url}（账号: ${config.accountId || '?'}）`);
   }
 
   const rl = readline.createInterface({ input: process.stdin, crlfDelay: Infinity });
@@ -397,14 +404,18 @@ function main() {
       err && err.message ? err.message : String(err));
 
     switch (method) {
-      case 'initialize':
+      case 'initialize': {
         serverReady = true;
+        // 协议版本协商：回显客户端请求的已知版本，避免较新客户端不兼容
+        const reqVer = params && params.protocolVersion;
+        const ver = KNOWN_PROTOCOLS.includes(reqVer) ? reqVer : PROTOCOL_VERSION;
         finish({
-          protocolVersion: PROTOCOL_VERSION,
+          protocolVersion: ver,
           capabilities: { tools: { listChanged: false } },
           serverInfo: { name: 'a2a-mcp', version: VERSION },
         });
         break;
+      }
       case 'ping':
         finish({});
         break;
@@ -413,6 +424,11 @@ function main() {
         break;
       case 'tools/call': {
         const { name, arguments: args } = params || {};
+        if (cfgMissing) {
+          const errText = '平台未配置：请在含 .a2a.json 的项目目录使用本 MCP（Cursor 的项目级 .cursor/mcp.json 会把工作目录设为项目根），或设置 A2A_URL/A2A_TOKEN/A2A_ACCOUNT 环境变量。首次接入运行 a2a init。';
+          finish({ isError: true, content: [{ type: 'text', text: errText }] });
+          break;
+        }
         callTool(config, name, args || {})
           .then((result) => {
             const text = typeof result === 'string' ? result : JSON.stringify(result, null, 2);

package/a2a.js

@@ -805,6 +805,7 @@ async function cmdUpdateSkills(opts) {
 /** `a2a update`：一键更新 CLI + Skills（平台由运维执行 docker 命令） */
 async function cmdUpdate(opts) {
   console.log(hl('===== a2a update ====='));
+  let updated = false;
   if (VERSION) {
     // 先检查 CLI 版本
     const pkg = await fetchJson('https://registry.npmjs.org/' + NPM_PACKAGE + '/latest');
@@ -813,6 +814,7 @@ async function cmdUpdate(opts) {
       try {
         execSync(`npm install -g ${NPM_PACKAGE}@latest`, { stdio: 'inherit' });
         console.log(paint(C.green, '[CLI] 更新完成 ✅'));
+        updated = true;
       } catch (e) {
         console.log(paint(C.red, `[CLI] 更新失败，请手动：npm install -g ${NPM_PACKAGE}@latest`));
       }
@@ -822,9 +824,15 @@ async function cmdUpdate(opts) {
   } else {
     console.log(paint(C.yellow, '[CLI] 单文件安装无版本信息，建议：npm install -g ' + NPM_PACKAGE));
   }
+  if (updated) {
+    // 本进程仍是旧代码：让用户退出后重跑，以用新版本完成其余更新
+    const pkg2 = await fetchJson('https://registry.npmjs.org/' + NPM_PACKAGE + '/latest').catch(() => null);
+    console.log(paint(C.yellow, 'CLI 已更新到 v' + (pkg2 ? pkg2.version : '最新') + '。请退出后重新运行 a2a update（或直接运行 a2a update-skills）完成 skills 更新。'));
+    return;
+  }
   await cmdUpdateSkills({ yes: opts.yes || opts.y });
   console.log('');
-  console.log('平台更新（在部署服务器执行）：cd <仓库> && git pull && docker compose up -d --build');
+  console.log('平台更新（在部署服务器执行）：cd <仓库> && git pull && docker compose up -d --build（或 docker compose -f docker-compose.pull.yml up -d）');
 }
 
 /* ------------------------------------------------------------------------- *
@@ -1363,6 +1371,29 @@ async function cmdHeartbeat(opts, ctx) {
   );
 }
 
+/** `a2a mcp-setup`：在当前项目生成 .cursor/mcp.json（Cursor/Windsurf 用），使用绝对路径免 PATH 问题 */
+async function cmdMcpSetup() {
+  const nodePath = process.execPath; // 当前 node 绝对路径（避免 Cursor 环境 PATH 无 node/nvm）
+  const mcpPath = path.join(__dirname, 'a2a-mcp.js');
+  if (!fs.existsSync(mcpPath)) {
+    fail('未找到 a2a-mcp.js（' + mcpPath + '）。请使用 npm 全局安装：npm install -g agent2agent-cli');
+  }
+  const config = {
+    mcpServers: {
+      a2a: { command: nodePath, args: [mcpPath] },
+    },
+  };
+  const dir = path.join(process.cwd(), '.cursor');
+  fs.mkdirSync(dir, { recursive: true });
+  const target = path.join(dir, 'mcp.json');
+  fs.writeFileSync(target, JSON.stringify(config, null, 2) + '\n');
+  console.log(paint(C.green, `已生成 ${target}`));
+  console.log('  server: a2a（command=' + nodePath + '）');
+  console.log('说明：该配置随项目提交，团队 clone 后无需再配；');
+  console.log('      请在当前项目（含 .a2a.json）使用，a2a-mcp 会自动匹配该项目账号。');
+  console.log('重启 Cursor 后生效（MCP 面板应显示 13 个工具）。');
+}
+
 /* ------------------------------------------------------------------------- *
  * 帮助
  * ------------------------------------------------------------------------- */
@@ -1389,6 +1420,7 @@ function printHelp() {
     ['sync', '双向镜像同步本地 doc 目录 ↔ 平台'],
     ['memory', '记忆（get / set）'],
     ['heartbeat', '心跳'],
+    ['mcp-setup', '生成 .cursor/mcp.json（Cursor/Windsurf MCP 接入）'],
     ['update-check', '检查各组件是否有新版本'],
     ['update', '一键更新 CLI + skills'],
     ['update-skills', '更新已安装的 skills（--to 指定目录 / --yes 免确认）'],
@@ -1483,16 +1515,22 @@ async function main() {
     await cmdUpdate(opts);
     return;
   }
+  if (cmd === 'mcp-setup') {
+    await cmdMcpSetup();
+    return;
+  }
+  if (cmd === 'update-check') {
+    // 有 .a2a.json 则附带平台版本对比；无配置只检查 CLI / skills
+    let cfg = null;
+    try { cfg = requireConfig(opts.config); } catch (e) { cfg = null; }
+    await cmdUpdateCheck(cfg || { config: null });
+    return;
+  }
 
   let ctx = null;
   try {
     ctx = requireConfig(opts.config);
   } catch (e) {
-    // update-check 允许无配置运行（仅检查 CLI / skills）；其余命令必须配置
-    if (cmd === 'update-check') {
-      await cmdUpdateCheck({ config: null });
-      return;
-    }
     process.stderr.write(String(e.message || e) + '\n');
     process.exit(1);
   }
@@ -1552,7 +1590,20 @@ async function main() {
   }
 }
 
-main().catch((err) => {
-  const msg = err && err.message ? err.message : String(err);
-  fail(msg);
-});
+main()
+  .catch((err) => {
+    const msg = err && err.message ? err.message : String(err);
+    fail(msg);
+  })
+  .finally(() => {
+    // 统一「跑完即退」守卫：命令逻辑完成后，若仍有残留句柄（stdin 监听、定时器等）
+    // 阻止事件循环退出，短暂等待 stdout flush 后强制退出，回到 shell。
+    const guard = setTimeout(() => {
+      try {
+        process.stdin.pause();
+        if (process.stdin.removeAllListeners) process.stdin.removeAllListeners('data');
+      } catch (e) { /* ignore */ }
+      process.exit(process.exitCode || 0);
+    }, 600);
+    if (guard.unref) guard.unref();
+  });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent2agent-cli",
-  "version": "0.3.2",
+  "version": "0.3.4",
   "description": "Agent2Agent 统一 CLI（命令名 a2a）：跨 AI 编程代理协作平台的命令行客户端 — 异步消息、任务看板、文档双向同步、持久记忆",
   "bin": {
     "a2a": "a2a.js",