evolcore 0.0.25 → 0.0.26

package/dist/cli/diag.js

@@ -0,0 +1,31 @@
+import { ipcQuery } from '../ipc.js';
+import { resolvePaths } from '../paths.js';
+import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
+import { parseDiagArgs } from '../core/command/diag-service.js';
+import { wantsHelp } from './help.js';
+export async function cmdDiag(args) {
+    if (wantsHelp(args)) {
+        console.log('用法：ec diag <问题描述> [--owner <daemonOwner-aid>] [--format json]\n      ec diag stop [--format json]\n未指定 --owner 时联系本机 daemon.json.owners[0]。');
+        return;
+    }
+    const json = args.at(-2) === '--format' && args.at(-1) === 'json';
+    const argv = json ? args.slice(0, -2) : args;
+    let result;
+    try {
+        parseDiagArgs(argv);
+        result = await ipcQuery(resolvePaths().socket, {
+            type: 'diag', argv,
+            ...(process.env.EVOLCORE_SESSION_ID ? {
+                sessionId: process.env.EVOLCORE_SESSION_ID,
+                delegationToken: process.env[AGENT_DELEGATION_TOKEN_ENV],
+            } : {}),
+        }, 30_000) ?? { ok: false, code: 'DAEMON_UNAVAILABLE', message: 'daemon 未返回结果，请检查其运行状态；发送结果尚未确认' };
+    }
+    catch (error) {
+        result = { ok: false, code: 'INVALID_ARGUMENT', message: error.message };
+    }
+    result.message ??= result.error ?? '诊断请求未完成';
+    console.log(json ? JSON.stringify(result, null, 2) : result.message);
+    if (!result.ok)
+        process.exitCode = 1;
+}

package/dist/cli/fs-command.js

@@ -19,73 +19,73 @@ class FsCliError extends Error {
         this.details = details;
     }
 }
-const HELP = `用法: ec fs <command> [args...] [options]
-
-Commands:
-  ls <AID>:<path>                 列目录
-  stat [-L] <AID>:<path>          查看节点元数据（默认不跟随软链；-L 跟随）
-  lstat <AID>:<path>              查看节点本身（不跟随末级软链）
-  cat <AID>:<path>                输出文本文件内容；二进制/大文件返回头部摘要
-  cp <local> <AID>:<path>         上传本地文件
-  cp <AID>:<path> <local>         下载远程文件
-  cp <AID>:<path> <AID>:<path>    远程复制（同后端）
-  mv <AID>:<path> <AID>:<path>    移动/改名（同后端）
-  rm [-r] <AID>:<path>            删除文件或目录
-  mkdir [-p] <AID>:<path>         创建目录
-  ln -s <target> <AID>:<path>     创建软链（personal storage）
-  chmod [mode] <AID>:<path>       切换公开/私有（personal storage）
-  setfacl <AID>:<path> -m|-x ...   设置/移除 ACL（群路径使用 role:member|role:admin）
-  getfacl <AID>:<path>            查看 ACL
-  token issue|revoke|ls <path>    管理访问 token（personal storage）
-  find <AID>:<path> [filters]     查找节点
-  df <AID>:                       查看容量/配额
-  mount <target> --volume <id>    挂载实体卷
-  mount <target> --source <src>   挂载远程子树
-  approve <AID>:<path>            批准待审挂载（personal storage）
-  reject <AID>:<path>             拒绝待审挂载（personal storage）
-  umount <AID>:<path>             卸载挂载点
-
-Options:
-  --as <aid>                      操作者 AID；也可由 EVOLCORE_SELF_AID 注入
-  --format json                   输出 JSON
-  --overwrite, --force            覆盖目标（用于 cp/mv/ln）或强制删除（用于 rm）
-  -r, --recursive                 递归（用于 rm/cp）
-  -p, --parents                   自动创建父目录（用于 mkdir/group 上传）
-  -L, --follow                    stat 跟随末级软链
-  --token <token>                 读取时携带访问 token（personal storage）
-  --content-type <mime>           上传时指定内容类型
-  --public                        上传后公开可读（personal storage）
-  --visibility <public|private>   chmod 可见性
-  --allow-roles <roles>           chmod 角色约束，逗号分隔
-  -m aid:<aid>:<perms>            setfacl 新增/更新 ACL
-  -x aid:<aid>                    setfacl 移除 ACL
-  --source <AID>:<path>           mount 虚拟卷来源
-  --volume <id>                   mount 实体卷 ID
-  --require-approval              mount 需要来源 owner 审批
-  --expires <time>                mount/token/ACL 过期时间，Unix 秒或 ISO 日期
-  --max-uses <n>                  ACL 最大使用次数
-  --max-reads <n>                 token 最大读取次数
-  --readonly, --readwrite         mount 只读/读写
-  --name <glob>                   find 名称过滤
-  --type <f|d|l>                  find 类型过滤
-  --size <expr>                   find 大小过滤，如 +1M
-  --mtime <expr>                  find 修改时间过滤
-  --head-bytes <n>                cat 二进制头部字节数，默认 256
-  --max-bytes <n>                 cat 最大直接输出字节数，默认 1048576
-  --aun-path <path>               指定 AUN keystore 根
-  --app <name>                    指定 AUN app slot
-
-示例:
-  ec fs ls alice.agentid.pub:/private/
-  ec fs cp ./report.md alice.agentid.pub:/private/report.md --as alice.agentid.pub
-  ec fs cp alice.agentid.pub:/private/report.md ./report.md --as alice.agentid.pub
-  ec fs cp alice.agentid.pub:/private/a.md bob.agentid.pub:/inbox/a.md --as alice.agentid.pub
-  ec fs cat alice.agentid.pub:/private/report.md --as alice.agentid.pub
-  ec fs ln -s alice.agentid.pub:/private/report.md alice.agentid.pub:/public/report.md --as alice.agentid.pub
-  ec fs chmod +r alice.agentid.pub:/public/report.md --as alice.agentid.pub
-  ec fs setfacl alice.agentid.pub:/private/report.md -m aid:bob.agentid.pub:r --as alice.agentid.pub
-  ec fs token issue alice.agentid.pub:/public/report.md --expires 2026-12-31 --as alice.agentid.pub
-  ec fs find alice.agentid.pub:/private/ --name "*.md" --as alice.agentid.pub
+const HELP = `用法: ec fs <command> [args...] [options]
+
+Commands:
+  ls <AID>:<path>                 列目录
+  stat [-L] <AID>:<path>          查看节点元数据（默认不跟随软链；-L 跟随）
+  lstat <AID>:<path>              查看节点本身（不跟随末级软链）
+  cat <AID>:<path>                输出文本文件内容；二进制/大文件返回头部摘要
+  cp <local> <AID>:<path>         上传本地文件
+  cp <AID>:<path> <local>         下载远程文件
+  cp <AID>:<path> <AID>:<path>    远程复制（同后端）
+  mv <AID>:<path> <AID>:<path>    移动/改名（同后端）
+  rm [-r] <AID>:<path>            删除文件或目录
+  mkdir [-p] <AID>:<path>         创建目录
+  ln -s <target> <AID>:<path>     创建软链（personal storage）
+  chmod [mode] <AID>:<path>       切换公开/私有（personal storage）
+  setfacl <AID>:<path> -m|-x ...   设置/移除 ACL（群路径使用 role:member|role:admin）
+  getfacl <AID>:<path>            查看 ACL
+  token issue|revoke|ls <path>    管理访问 token（personal storage）
+  find <AID>:<path> [filters]     查找节点
+  df <AID>:                       查看容量/配额
+  mount <target> --volume <id>    挂载实体卷
+  mount <target> --source <src>   挂载远程子树
+  approve <AID>:<path>            批准待审挂载（personal storage）
+  reject <AID>:<path>             拒绝待审挂载（personal storage）
+  umount <AID>:<path>             卸载挂载点
+
+Options:
+  --as <aid>                      操作者 AID；也可由 EVOLCORE_SELF_AID 注入
+  --format json                   输出 JSON
+  --overwrite, --force            覆盖目标（用于 cp/mv/ln）或强制删除（用于 rm）
+  -r, --recursive                 递归（用于 rm/cp）
+  -p, --parents                   自动创建父目录（用于 mkdir/group 上传）
+  -L, --follow                    stat 跟随末级软链
+  --token <token>                 读取时携带访问 token（personal storage）
+  --content-type <mime>           上传时指定内容类型
+  --public                        上传后公开可读（personal storage）
+  --visibility <public|private>   chmod 可见性
+  --allow-roles <roles>           chmod 角色约束，逗号分隔
+  -m aid:<aid>:<perms>            setfacl 新增/更新 ACL
+  -x aid:<aid>                    setfacl 移除 ACL
+  --source <AID>:<path>           mount 虚拟卷来源
+  --volume <id>                   mount 实体卷 ID
+  --require-approval              mount 需要来源 owner 审批
+  --expires <time>                mount/token/ACL 过期时间，Unix 秒或 ISO 日期
+  --max-uses <n>                  ACL 最大使用次数
+  --max-reads <n>                 token 最大读取次数
+  --readonly, --readwrite         mount 只读/读写
+  --name <glob>                   find 名称过滤
+  --type <f|d|l>                  find 类型过滤
+  --size <expr>                   find 大小过滤，如 +1M
+  --mtime <expr>                  find 修改时间过滤
+  --head-bytes <n>                cat 二进制头部字节数，默认 256
+  --max-bytes <n>                 cat 最大直接输出字节数，默认 1048576
+  --aun-path <path>               指定 AUN keystore 根
+  --app <name>                    指定 AUN app slot
+
+示例:
+  ec fs ls alice.agentid.pub:/private/
+  ec fs cp ./report.md alice.agentid.pub:/private/report.md --as alice.agentid.pub
+  ec fs cp alice.agentid.pub:/private/report.md ./report.md --as alice.agentid.pub
+  ec fs cp alice.agentid.pub:/private/a.md bob.agentid.pub:/inbox/a.md --as alice.agentid.pub
+  ec fs cat alice.agentid.pub:/private/report.md --as alice.agentid.pub
+  ec fs ln -s alice.agentid.pub:/private/report.md alice.agentid.pub:/public/report.md --as alice.agentid.pub
+  ec fs chmod +r alice.agentid.pub:/public/report.md --as alice.agentid.pub
+  ec fs setfacl alice.agentid.pub:/private/report.md -m aid:bob.agentid.pub:r --as alice.agentid.pub
+  ec fs token issue alice.agentid.pub:/public/report.md --expires 2026-12-31 --as alice.agentid.pub
+  ec fs find alice.agentid.pub:/private/ --name "*.md" --as alice.agentid.pub
   ec fs df alice.agentid.pub: --as alice.agentid.pub`;
 const VALUE_FLAGS = new Set([
     '--as',

package/dist/cli/handoff-command.js

@@ -106,13 +106,13 @@ export function parseReturn(args) {
 function printReturn(result) {
     if (result.ok) {
         if (result.code === 'HANDOFF_RETURN_ALREADY_APPLIED') {
-            console.log(`✓ handoff ${result.handoff_id} 已接收过相同结果，未重复处理`);
+            console.log(`✓ handoff ${result.handoff_id} 已接收过相同结果，未重复处理${result.result_id ? ` result_id=${result.result_id}` : ''}`);
         }
         else if (result.state === 'completed') {
             console.log(`✓ handoff ${result.handoff_id} 已确认完成，不回流来源会话`);
         }
         else {
-            console.log(`✓ handoff ${result.handoff_id} 回流结果已接收`);
+            console.log(`✓ handoff ${result.handoff_id} 回流结果已接收${result.result_id ? ` result_id=${result.result_id}` : ''}；后续仍可用同一 ID 追加结果`);
         }
         return;
     }
@@ -153,13 +153,15 @@ function formatTimestamp(value) {
 export async function cmdHandoff(args) {
     const sub = args[0];
     if (!sub || isHelpFlag(sub) || wantsHelp(args)) {
-        console.log(`用法: ec handoff <command> [args]
-
-Commands:
-  return [handoff-id] [content]       确认完成；required 策略需提供回流内容
-  return [handoff-id] --text-from-file <path>
-  status <handoff-id>                查询 handoff 状态
-  list [--state <state>] [--session <id>] [--limit <n>] [--agent <aid>]
+        console.log(`用法: ec handoff <command> [args]
+
+Commands:
+  return [handoff-id] [content]       提交一个回流结果；required 可用同一 ID 追加多个结果
+  return [handoff-id] --text-from-file <path>
+  recover-return <handoff-id> [content]  owner-authorized recovery after target session replacement
+  recover-return <handoff-id> --text-from-file <path>
+  status <handoff-id>                查询 handoff 状态
+  list [--state <state>] [--session <id>] [--limit <n>] [--agent <aid>]
   trace <handoff-id> [--limit <n>] [--agent <aid>]`);
         return;
     }
@@ -194,6 +196,36 @@ Commands:
         printReturn(result);
         return;
     }
+    if (sub === 'recover-return') {
+        let parsed;
+        try {
+            parsed = parseReturn(args.slice(1));
+        }
+        catch (error) {
+            console.error(`✗ ${error instanceof Error ? error.message : String(error)}`);
+            process.exitCode = 1;
+            return;
+        }
+        if (!parsed.handoffId) {
+            console.error('✗ recover-return 必须指定 handoff ID');
+            process.exitCode = 1;
+            return;
+        }
+        const result = await ipcQuery(resolvePaths().socket, {
+            type: 'handoff-recover-return',
+            sessionId: process.env.EVOLCORE_SESSION_ID,
+            handoffId: parsed.handoffId,
+            content: parsed.content,
+            delegationToken: process.env[AGENT_DELEGATION_TOKEN_ENV],
+        }, 5000);
+        if (!result) {
+            console.error('✗ daemon 暂时不可用');
+            process.exitCode = 1;
+            return;
+        }
+        printReturn(result);
+        return;
+    }
     if (sub === 'status') {
         const handoffId = args[1];
         if (!handoffId || !HANDOFF_ID_RE.test(handoffId)) {

package/dist/cli/index.js

@@ -19,57 +19,58 @@ import { cmdStart, cmdStop, cmdRestart, cmdStatus, cmdLogs, cmdWatchCommand, cmd
 import { logCliCommand } from './command-log.js';
 import { isInitCancelledError, printInitCancelHint } from './init-cancel.js';
 import { assertManagedTopLevelCommandAllowed, ManagedCommandNotAllowedError } from './managed-command-guard.js';
-const MAIN_HELP = `用法: ec <command> [选项]
-
-服务:
-  init              初始化默认配置、owner、控制 AID 与 EC Web
-  start             启动服务
-  stop              停止服务
-  restart           重启服务并检查更新
-  status            查看运行状态
-  logs              持续查看 daemon 日志
-  watch             打开日志、AID、消息或 EC Web 监控
-
-Agent 与会话:
-  agent             管理 EvolAgent
-  ctl               当前托管会话的控制命令
-  queue             查询或操作 agent 消息队列
-  trigger           管理定时与事件触发器
-  handoff           查询和完成跨会话回流
-  model             查看或设置模型与推理强度
-  response          查看或设置响应模式
-
-AUN:
-  aid               管理 AID 身份与 agent.md
-  msg               私聊消息收发、撤回、在线状态与历史
-  group             群消息与群管理
-  fs                AUN 文件系统
-  storage           底层对象存储命令
-  rpc               调用底层 AUN RPC
-  menu-client       向远程 daemon 发送标准 Menu 请求
-  contact           联系人黑名单管理
-  net               AUN 网络链路诊断
-
-配置与诊断:
-  config            读取、修改和检查分层配置
-  stats             Token 用量与费用统计
-  diagnose          检查启动环境
-  version           显示组件版本
-  mv                迁移项目目录和会话路径
-
-维护命令:
-  data migrate      迁移 per-Agent 用户数据（显式维护窗口）
-  mode              切换开发源码与 npm 包运行模式
-  restart-monitor   运行 daemon 重启监控器
-  bench             AUN 消息性能基准测试
-  link-rules        连接 ECK rules 到项目目录
-
-运行 ec <command> --help 查看该命令的完整参数。
-
-环境变量:
-  EVOLCORE_HOME     数据目录（默认: ~/.evolcore）
-  LOG_LEVEL         日志级别（默认: INFO）
-  MESSAGE_LOG       消息日志（默认: true）
+const MAIN_HELP = `用法: ec <command> [选项]
+
+服务:
+  init              初始化默认配置、owner、控制 AID 与 EC Web
+  start             启动服务
+  stop              停止服务
+  restart           重启服务并检查更新
+  status            查看运行状态
+  logs              持续查看 daemon 日志
+  watch             打开日志、AID、消息或 EC Web 监控
+
+Agent 与会话:
+  agent             管理 EvolAgent
+  ctl               当前托管会话的控制命令
+  queue             查询或操作 agent 消息队列
+  trigger           管理定时与事件触发器
+  handoff           查询和完成跨会话回流
+  model             查看或设置模型与推理强度
+  response          查看或设置响应模式
+
+AUN:
+  aid               管理 AID 身份与 agent.md
+  msg               私聊消息收发、撤回、在线状态与历史
+  group             群消息与群管理
+  fs                AUN 文件系统
+  storage           底层对象存储命令
+  rpc               调用底层 AUN RPC
+  menu-client       向远程 daemon 发送标准 Menu 请求
+  diag              邀请远程诊断 Agent，或 stop 撤销诊断授权
+  contact           联系人、待审申请与黑名单管理
+  net               AUN 网络链路诊断
+
+配置与诊断:
+  config            读取、修改和检查分层配置
+  stats             Token 用量与费用统计
+  diagnose          检查启动环境
+  version           显示组件版本
+  mv                迁移项目目录和会话路径
+
+维护命令:
+  data migrate      迁移 per-Agent 用户数据（显式维护窗口）
+  mode              切换开发源码与 npm 包运行模式
+  restart-monitor   运行 daemon 重启监控器
+  bench             AUN 消息性能基准测试
+  link-rules        连接 ECK rules 到项目目录
+
+运行 ec <command> --help 查看该命令的完整参数。
+
+环境变量:
+  EVOLCORE_HOME     数据目录（默认: ~/.evolcore）
+  LOG_LEVEL         日志级别（默认: INFO）
+  MESSAGE_LOG       消息日志（默认: true）
   EVENT_LOG         事件日志（默认: true）`;
 function printLifecycleHelp(command) {
     const help = {
@@ -115,32 +116,32 @@ export async function main(args) {
         case 'init': {
             try {
                 if (wantsHelp(args.slice(1))) {
-                    console.log(`用法: ec init [渠道] [选项]
-
-仅初始化 defaults.json:
-  ec init                          交互式（写完 defaults.json 后嵌套 agent new）
-                                  选择 ecagent 时会继续询问 API Key 和 Base URL
-  ec init --non-interactive [选项]
-    --baseagent <claude|codex|gemini|ecagent>    默认: PATH 中第一个可用项；ecagent 需显式选择
-    --force                              已存在 defaults.json 时覆盖
-
-云部署非交互式初始化（结构化 JSON 输出）:
-  ec init --non-interactive --owner <aid> [--format json] [选项]
-    --owner <aid>                        必填。唯一 daemon owner AID
-    --baseagent <claude|codex|gemini|ecagent>    可选。默认从 PATH 检测，ecagent 需显式选择
-    --projectpath <abs-path>             可选。默认项目目录（必须绝对路径，自动创建）
-    --ecweb                              可选。安装 EC Web 并启用自启动
-    --auto-start                         Windows/macOS 上启用 EvolCore 登录自启动
-    --no-auto-start                      Windows/macOS 上禁用 EvolCore 登录自启动
-    --format json                        可选但推荐。stdout 输出 init.result JSON
-    --force                              已有不同 owner 时强制覆盖
-
-配置渠道（先 ec agent new 创建 agent）:
-  ec init aun           AUN owner 追加绑定（daemon 或指定 agent）
-  ec init feishu        飞书扫码登录
-  ec init wechat        微信扫码登录
-  ec init dingtalk      钉钉扫码登录
-  ec init qqbot         QQ 机器人扫码绑定
+                    console.log(`用法: ec init [渠道] [选项]
+
+仅初始化 defaults.json:
+  ec init                          交互式（写完 defaults.json 后嵌套 agent new）
+                                  选择 ecagent 时会继续询问 API Key 和 Base URL
+  ec init --non-interactive [选项]
+    --baseagent <claude|codex|gemini|ecagent>    默认: PATH 中第一个可用项；ecagent 需显式选择
+    --force                              已存在 defaults.json 时覆盖
+
+云部署非交互式初始化（结构化 JSON 输出）:
+  ec init --non-interactive --owner <aid> [--format json] [选项]
+    --owner <aid>                        必填。唯一 daemon owner AID
+    --baseagent <claude|codex|gemini|ecagent>    可选。默认从 PATH 检测，ecagent 需显式选择
+    --projectpath <abs-path>             可选。默认项目目录（必须绝对路径，自动创建）
+    --ecweb                              可选。安装 EC Web 并启用自启动
+    --auto-start                         Windows/macOS 上启用 EvolCore 登录自启动
+    --no-auto-start                      Windows/macOS 上禁用 EvolCore 登录自启动
+    --format json                        可选但推荐。stdout 输出 init.result JSON
+    --force                              已有不同 owner 时强制覆盖
+
+配置渠道（先 ec agent new 创建 agent）:
+  ec init aun           AUN owner 追加绑定（daemon 或指定 agent）
+  ec init feishu        飞书扫码登录
+  ec init wechat        微信扫码登录
+  ec init dingtalk      钉钉扫码登录
+  ec init qqbot         QQ 机器人扫码绑定
   ec init wecom         企业微信 AI Bot 扫码创建/手工配置`);
                 }
                 else {
@@ -351,6 +352,11 @@ export async function main(args) {
             await cmdRpc(args.slice(1));
             break;
         }
+        case 'diag': {
+            const { cmdDiag } = await import('./diag.js');
+            await cmdDiag(args.slice(1));
+            break;
+        }
         case 'menu-client': {
             const { suppressSdkLogs } = await import('../aun/aid/index.js');
             suppressSdkLogs();

package/dist/cli/link-rules.js

@@ -79,27 +79,27 @@ function cleanEmptyParents(dir) {
 }
 // ── 子命令 ──
 function showHelp() {
-    console.log(`Usage: ec link-rules <subcommand> [baseagent] [--dir <path>]
-
-Subcommands:
-  connect       Connect ECK rules to a project directory (default: cwd)
-  disconnect    Remove ECK rules connection for a baseagent
-  status        Show connection state for all baseagents
-
-Arguments:
-  baseagent     Target base agent: ${KNOWN_BASEAGENTS.join(', ')} (default: cc)
-  --dir <path>  Target directory (default: current working directory)
-
-Supported baseagents:
-  cc            Claude Code (.claude/rules/eck/)
-  codex         Codex (.codex/rules/eck/)
-  gemini        Gemini CLI (.gemini/rules/eck/)
-
-Examples:
-  ec link-rules connect              # connect cc in cwd
-  ec link-rules connect codex        # connect codex in cwd
-  ec link-rules connect cc --dir /x  # connect cc in specific dir
-  ec link-rules disconnect cc        # disconnect cc
+    console.log(`Usage: ec link-rules <subcommand> [baseagent] [--dir <path>]
+
+Subcommands:
+  connect       Connect ECK rules to a project directory (default: cwd)
+  disconnect    Remove ECK rules connection for a baseagent
+  status        Show connection state for all baseagents
+
+Arguments:
+  baseagent     Target base agent: ${KNOWN_BASEAGENTS.join(', ')} (default: cc)
+  --dir <path>  Target directory (default: current working directory)
+
+Supported baseagents:
+  cc            Claude Code (.claude/rules/eck/)
+  codex         Codex (.codex/rules/eck/)
+  gemini        Gemini CLI (.gemini/rules/eck/)
+
+Examples:
+  ec link-rules connect              # connect cc in cwd
+  ec link-rules connect codex        # connect codex in cwd
+  ec link-rules connect cc --dir /x  # connect cc in specific dir
+  ec link-rules disconnect cc        # disconnect cc
   ec link-rules status               # show all connections`);
 }
 function showStatus() {

package/dist/cli/managed-command-guard.js

@@ -5,6 +5,9 @@ const MANAGED_TASK_COMMANDS = new Set([
     'config',
     'contact',
     'ctl',
+    // These commands are authenticated again by their daemon IPC entrypoints.
+    'diag',
+    'menu-client',
     'fs',
     'group',
     'handoff',

package/dist/cli/menu-client.js

@@ -1,6 +1,7 @@
 import fs from 'node:fs';
 import { getArgValue, wantsHelp } from './help.js';
 import { executeMenuClientRequest, MenuClientError } from '../aun/menu-client.js';
+import { AGENT_DELEGATION_TOKEN_ENV } from '../core/auth/agent-delegation.js';
 function parseDurationMs(value) {
     if (value === undefined)
         return undefined;
@@ -11,14 +12,14 @@ function parseDurationMs(value) {
     const unit = match[2].toLowerCase();
     return amount * (unit === 'ms' ? 1 : unit === 's' ? 1_000 : unit === 'm' ? 60_000 : 3_600_000);
 }
-function readRequest(args) {
+function readRequest(args, readFile = (file) => fs.readFileSync(file, 'utf8')) {
     const file = getArgValue(args, '--request-file');
     const inline = getArgValue(args, '--request-json');
     if (!!file === !!inline)
         throw new MenuClientError('INVALID_ARGUMENT', '--request-file and --request-json are mutually exclusive');
     let raw;
     try {
-        raw = file ? fs.readFileSync(file, 'utf8') : inline;
+        raw = file ? readFile(file) : inline;
     }
     catch (error) {
         throw new MenuClientError('INVALID_ARGUMENT', `Unable to read request: ${error?.message ?? String(error)}`);
@@ -36,8 +37,12 @@ function readRequest(args) {
 function validateOptions(args) {
     const valueOptions = new Set(['--request-file', '--request-json', '--timeout', '--remote-token', '--ecweb-token', '--app', '--aun-path', '--format']);
     const booleanOptions = new Set(['--encrypt', '--no-encrypt']);
+    const seen = new Set();
     for (let index = 0; index < args.length; index += 1) {
         const option = args[index];
+        if (seen.has(option))
+            throw new MenuClientError('INVALID_ARGUMENT', `Duplicate option: ${option}`);
+        seen.add(option);
         if (booleanOptions.has(option))
             continue;
         if (!valueOptions.has(option))
@@ -54,22 +59,7 @@ function validateOptions(args) {
     if (format !== undefined && format !== 'json')
         throw new MenuClientError('INVALID_ARGUMENT', '--format currently supports only json');
 }
-export async function cmdMenuClient(args) {
-    if (wantsHelp(args)) {
-        console.log(`用法: ec menu-client request <from-aid> <daemon-aid> [选项]
-
-  --request-file <path>    从 JSON 文件读取一个 menu.* 请求
-  --request-json <json>    直接传入一个 menu.* JSON 请求
-  --timeout <时长>         默认 15s，最大 120s
-  --encrypt                使用 E2EE（默认）
-  --no-encrypt             已拒绝：ec-menu-client 必须使用 E2EE
-  --remote-token <token>   使用 daemon 远程访问 token 临时授权
-  --ecweb-token <token>    --remote-token 的兼容别名
-  --app <slot>             覆盖默认 evolcore-menu-client 消费槽位
-  --aun-path <path>        覆盖本地 AUN keystore 根目录
-  --format json            输出标准 menu.response JSON`);
-        return;
-    }
+export function parseMenuClientArgs(args, readFile) {
     if (args[0] !== 'request')
         throw new MenuClientError('INVALID_ARGUMENT', 'menu-client currently supports only the request subcommand');
     const fromAid = args[1]?.trim();
@@ -78,18 +68,43 @@ export async function cmdMenuClient(args) {
         throw new MenuClientError('INVALID_ARGUMENT', 'request requires <from-aid> and <daemon-aid>');
     const options = args.slice(3);
     validateOptions(options);
-    const request = readRequest(options);
-    const timeoutMs = parseDurationMs(getArgValue(args, '--timeout'));
-    const encrypt = args.includes('--no-encrypt') ? false : true;
-    const response = await executeMenuClientRequest({
-        fromAid,
-        targetAid,
-        request,
-        timeoutMs,
-        encrypt,
-        remoteAccessToken: getArgValue(args, '--remote-token') ?? getArgValue(args, '--ecweb-token'),
-        slotId: getArgValue(args, '--app'),
-        aunPath: getArgValue(args, '--aun-path'),
-    });
+    return {
+        fromAid, targetAid, request: readRequest(options, readFile),
+        timeoutMs: parseDurationMs(getArgValue(options, '--timeout')),
+        encrypt: !options.includes('--no-encrypt'),
+        remoteAccessToken: getArgValue(options, '--remote-token') ?? getArgValue(options, '--ecweb-token'),
+        slotId: getArgValue(options, '--app'), aunPath: getArgValue(options, '--aun-path'),
+    };
+}
+export async function cmdMenuClient(args) {
+    if (wantsHelp(args)) {
+        console.log(`用法: ec menu-client request <from-aid> <daemon-aid> [选项]
+
+  --request-file <path>    从 JSON 文件读取一个 menu.* 请求
+  --request-json <json>    直接传入一个 menu.* JSON 请求
+  --timeout <时长>         默认 15s，最大 120s
+  --encrypt                使用 E2EE（默认）
+  --no-encrypt             已拒绝：ec-menu-client 必须使用 E2EE
+  --remote-token <token>   使用 daemon 远程访问 token 临时授权
+  --ecweb-token <token>    --remote-token 的兼容别名
+  --app <slot>             覆盖默认 evolcore-menu-client 消费槽位
+  --aun-path <path>        覆盖本地 AUN keystore 根目录
+  --format json            输出标准 menu.response JSON`);
+        return;
+    }
+    let response;
+    if (process.env.EVOLCORE_SESSION_ID) {
+        const { ipcQuery } = await import('../ipc.js');
+        const { resolvePaths } = await import('../paths.js');
+        const result = await ipcQuery(resolvePaths().socket, {
+            type: 'menu-client.request', argv: args, sessionId: process.env.EVOLCORE_SESSION_ID,
+            delegationToken: process.env[AGENT_DELEGATION_TOKEN_ENV],
+        }, 250_000);
+        if (!result?.ok)
+            throw new MenuClientError(result?.code ?? 'DAEMON_UNAVAILABLE', result?.error ?? 'Managed Menu daemon is unavailable');
+        response = result.response;
+    }
+    else
+        response = await executeMenuClientRequest(parseMenuClientArgs(args));
     console.log(JSON.stringify(response, null, 2));
 }