evolcore 0.0.32 → 0.0.33

package/dist/cli/aun-commands.js

@@ -1,5 +1,6 @@
 import fs from 'fs';
 import path from 'path';
+import crypto from 'crypto';
 import { agentMdPath, resolvePaths, resolveRoot } from '../paths.js';
 import { isExplicitGroupId, normalizeGroupAid, sameGroupAid } from '../aun/group/index.js';
 import { getArgValue, isHelpFlag, wantsHelp } from './help.js';
@@ -11,6 +12,7 @@ import { readBestTaskRuntimeContext } from './task-context.js';
 import { assertEcSingleLine } from './cli-argv.js';
 import { canonicalizeEvolcoreCommandArgv } from '../core/permission/ec-command-parser.js';
 import { ManagedGroupOperationError } from '../aun/msg/managed-operation.js';
+import { parseDuration } from '../trigger/parser.js';
 // ==================== AID ====================
 function resolveAunPath(args) {
     const idx = args.indexOf('--aun-path');
@@ -1307,6 +1309,176 @@ Options:
     process.exit(1);
 }
 // ==================== Msg ====================
+/**
+ * 构造跨话题复查 Trigger 的定义。
+ *
+ * `ec msg send --thread T2 --check-every 5m` 发送成功后自动创建。
+ *
+ * 使用 `interval` 而非 `delay`：周期触发，只有显式
+ * `ec trigger cancel` 或 `ec trigger update --every <新时长>` 才改变其状态。
+ * 一次性 Trigger 会静默消失，无法承担「一直跟进直到显式结束」的语义。
+ */
+export function buildThreadCheckTrigger(input) {
+    const now = Date.now();
+    return {
+        $schema_version: 3.1,
+        agentAid: input.agentAid,
+        id: input.id,
+        name: input.name,
+        enabled: true,
+        createdAt: now,
+        updatedAt: now,
+        // T10: labels 携带 kind + 业务上下文，渲染层按 kind=thread-check 路由到专属模板
+        labels: {
+            kind: 'thread-check',
+            originThreadId: input.originThreadId,
+            targetThreadId: input.targetThreadId,
+            originPeer: input.originPeer,
+            checkEvery: input.checkEvery,
+        },
+        ...(input.origin ? { origin: input.origin } : {}),
+        // 周期触发：每 everyMs 唤醒一次，直到显式取消/调整
+        source: { type: 'interval', everyMs: input.everyMs },
+        execution: {
+            type: 'trigger_session',
+            prompt: input.prompt,
+            thread: 'by_trigger',
+            onError: 'retry',
+            noopSentinel: '[[NOOP]]',
+        },
+        feedback: {
+            strategy: 'target',
+            target: {
+                channelKey: input.channelKey,
+                channelId: input.targetChannelId,
+                session: 'thread',
+                threadId: input.targetThreadId,
+                chatType: input.feedbackChatType ?? 'private',
+            },
+        },
+        reliability: { concurrency: 'forbid', missedPolicy: 'run_once', retry: { maxAttempts: 0, backoffMs: 30_000 } },
+    };
+}
+/**
+ * 解析并校验 `--check-every`。返回 `{ durationMs }` 或错误。
+ * 私聊与群聊两条跨话题发送路径共用，保证错误码一致。
+ */
+function parseCheckEveryArgs(checkEveryRaw, hasCheckEvery) {
+    if (!hasCheckEvery) {
+        return { code: 'CHECK_EVERY_REQUIRED', error: '跨话题发送必须指定 --check-every <时长>（如 5m / 30m / 2h）' };
+    }
+    if (checkEveryRaw === undefined)
+        return { durationMs: 5 * 60 * 1000 };
+    const parsed = parseDuration(checkEveryRaw);
+    if (parsed === null) {
+        return { code: 'INVALID_DURATION', error: `--check-every 时长格式无效: ${checkEveryRaw}（示例: 5m / 30m / 2h / 1d）` };
+    }
+    return { durationMs: parsed };
+}
+/**
+ * 跨话题发送成功后的统一收尾：创建周期复查 Trigger + 写入本端 thread-inbox。
+ *
+ * 私聊（`ec msg send --thread`）与群聊（`ec group send --thread`）共用，
+ * 保证两条路径行为一致（M2 修复前群聊路径完全不做这两件事）。
+ *
+ * 设计见 `docs/thread-chain/thread-context-mechanism.md` §十、`thread-cli-spec-v2.md` §3.4。
+ * 任意一步失败都不影响消息已发出的事实：返回 `triggerId` 为 undefined 时调用方照常输出发送结果。
+ */
+async function applyCrossThreadSendEffects(input) {
+    const runtime = await readBestTaskRuntimeContext();
+    const originThreadId = runtime?.threadId || 'main';
+    const originPeer = runtime?.channelId || input.targetChannelId;
+    const originSessionId = runtime?.sessionId;
+    if (!originSessionId)
+        return { inboxWritten: false };
+    // Trigger 的 id 与 name 是两个不同的东西（见 src/trigger/validation.ts:727）：
+    //   id   = `trig_<ts>_<8位hex>` —— 唯一的持久化标识，`ec trigger show/update/cancel` 只认它
+    //   name = `check-<目标threadId>-from-<来源threadId>-<唯一后缀>` —— 人读标签，不参与定位
+    //
+    // 这里**在 IPC 之前**就把 id 定下来，有三个理由：
+    //   1. prompt 里要写 `ec trigger cancel <id>`，而 prompt 是 definition 的一部分，
+    //      create 之前就得拼完，拿不到 daemon 的返回值；
+    //   2. definition 带上 id 后 daemon 直接采用（normalizeV3Phase2 认 `raw.id`），
+    //      落盘 id 与 prompt 中的 id 天然一致，不存在"返回值和 prompt 两套值"的漂移；
+    //   3. D7：此前这里把拼出来的 name 当 id 用，导致 inbox 的 triggerId、`--format json`
+    //      的 trigger_id、prompt 里的参考命令三处全部不可用（`ec trigger cancel` 报 not found）。
+    const triggerSeed = `${Date.now()}_${crypto.randomBytes(4).toString('hex')}`;
+    const triggerId = `trig_${triggerSeed}`;
+    // D8：name 必须每次不同。此前用固定的 `check-<T>-from-<origin>`，同一
+    // (目标, 来源) 对第二次发送就撞 `trigger name already exists`（assertUnique 按 name 去重），
+    // 结果消息照发、inbox 照写、Trigger 静默不建 —— 完全无感知。
+    // 每次 `--check-every` 都该有自己的 new Trigger（要复用应走 update），所以追加唯一后缀。
+    const triggerName = `check-${input.targetThreadId}-from-${originThreadId}-${triggerSeed.split('_')[1]}`;
+    const userPromptPart = input.triggerPromptExtra
+        ? input.triggerPromptExtra
+        : `请检查该话题的最新进度，根据情况：继续等待、调整周期（ec trigger update ${triggerId} --every <时长>）或结束复查（ec trigger cancel ${triggerId}）。`;
+    const prompt = [
+        `【Trigger 复查】话题 ${input.targetThreadId}（对端 ${input.targetChannelId}）`,
+        `这是周期复查：每 ${input.checkEveryLabel} 唤醒一次，直到你显式结束它。`,
+        ``,
+        userPromptPart,
+        ``,
+        `参考命令：`,
+        `  ec thread history ${input.targetChannelId}/${input.targetThreadId} --limit 10`,
+        `  ec thread history ${originPeer}/${originThreadId} --after ${Date.now()}`,
+        `  ec trigger cancel ${triggerId}`,
+        `  ec trigger update ${triggerId} --every <时长>`,
+        `Trigger id：${triggerId}`,
+        `Trigger 名称：${triggerName}`,
+    ].join('\n');
+    let createdTriggerId;
+    try {
+        const { formatChannelKey } = await import('../core/channel-loader.js');
+        const triggerDef = buildThreadCheckTrigger({
+            agentAid: input.selfAid,
+            id: triggerId,
+            name: triggerName,
+            prompt,
+            everyMs: input.durationMs,
+            checkEvery: input.checkEveryLabel,
+            channelKey: formatChannelKey({ type: 'aun', selfAID: input.selfAid, name: 'main' }),
+            targetChannelId: input.targetChannelId,
+            targetThreadId: input.targetThreadId,
+            originThreadId,
+            originPeer,
+            feedbackChatType: input.feedbackChatType,
+        });
+        const triggerRes = await ipcQuery(resolvePaths().socket, {
+            type: 'trigger.create',
+            definition: triggerDef,
+            files: [],
+            enable: true,
+            // daemon 侧 authenticatedTriggerActor 先看 actorSessionId：缺了它会回落到
+            // controlToken 分支（CLI 从不读 control.token），必然抛
+            // "valid local control token is required"。与 trigger-command.ts 的组装保持一致。
+            actorSessionId: originSessionId,
+            delegationToken: readDelegationCredential(),
+        }, 30_000);
+        if (!triggerRes?.ok) {
+            process.stderr.write(`⚠ Trigger 创建失败: ${triggerRes?.error ?? 'unknown'}（inbox 仍会写入）\n`);
+        }
+        else {
+            // 以 daemon 落盘的结果为准（definition 已带 id，正常应与预设值相同；
+            // 若 daemon 因任何原因改写了 id，回填真值而不是本地预设值）。
+            createdTriggerId = triggerRes.trigger?.id ?? triggerId;
+        }
+    }
+    catch (e) {
+        process.stderr.write(`⚠ Trigger 创建异常: ${e?.message ?? e}（inbox 仍会写入）\n`);
+    }
+    const { ThreadService } = await import('../core/thread/index.js');
+    ThreadService.appendInbox(input.selfAid, {
+        messageId: input.messageId,
+        content: input.contentSummary,
+        timestamp: input.timestamp,
+        originThreadId,
+        originPeer,
+        originSessionId,
+        targetSessionId: input.targetSessionId,
+        ...(createdTriggerId ? { triggerId: createdTriggerId } : {}),
+    });
+    return { triggerId: createdTriggerId, inboxWritten: true };
+}
 export async function cmdMsg(args) {
     args = canonicalizeEvolcoreCommandArgv(['ec', 'msg', ...args]).slice(2);
     const sub = args[0];
@@ -1317,7 +1489,7 @@ export async function cmdMsg(args) {
         console.log(`用法: ec msg <command> <from-aid> [args...] [options]
 
 Commands:
-  send <from> <to> <text> --return <none|required>     发送文本（跨会话时 --return 必填）
+  send <from> <to> <text>                              发送文本
   send <from> <to> --text-from-file <path>             从文件读取文本内容
   send <from> <to> --file <path> [--as <type>]         发送文件（image|video|voice|file）
   send <from> <to> --link <url> [--title T]            发送链接卡片
@@ -1328,6 +1500,10 @@ Commands:
   online <from> <target-aid> [<target-aid>...]         查询在线状态
   history <from> [<target-aid>|selector] [筛选选项]    查询本地消息历史
 
+托管会话简化语法（EVOLCORE_SESSION_ID 已设时）：
+  send <text> --thread <id>       from/to 从运行时上下文与话题索引自动推断
+  send <text>                     发送到当前会话对端
+
 Options:
   --text-from-file <path>  从文件读取文本（UTF-8），用于超长消息或避免 Shell 转义
   --handoff-context <text>  仅托管会话：为目标会话补充本地上下文，不发给对端
@@ -1336,7 +1512,7 @@ Options:
   --format json         输出 JSON 格式
   --encrypt             强制端到端加密（未指定时使用 daemon 默认值）
   --no-encrypt          强制明文发送（优先于 --encrypt）
-  --thread <id>         指定话题 ID（用于多话题路由）
+  --thread <id>         指定目标话题 ID（话题必须存在于本端索引；from/to 可省略）
   --session <latest|all|id> 按 EvolCore 逻辑会话过滤历史（默认 latest）
   --before <time>       只返回该时间之前的历史
   --after <time>        只返回该时间之后的历史
@@ -1345,7 +1521,10 @@ Options:
   --channel-name <name> 历史渠道实例名（非 AUN 渠道必须匹配 Agent 配置）
   --channel-key <key>   非 AUN 已落盘渠道的完整实例键（与 --peer-id 成对）
   --peer-id <id>        非 AUN 渠道的原生对端 ID（与 --channel-key 成对）
-  --return <none|required> 跨会话发送必填：none=仅补充目标上下文，required=回答回流来源
+  --check-every <duration> 跨话题发送后自动创建**周期**复查 Trigger（如 5m/30m/2h），跨话题时**必填**
+                         每 duration 唤醒一次，直到显式 ec trigger cancel 结束
+                         Trigger 名：check-<目标threadId>-from-<来源threadId>-<唯一后缀>
+                         取消/调整用返回的 trigger_id（trig_…），show/update/cancel 只认 id
   --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
   --as <type>           附件类型：image|video|voice|file（仅 --file 模式）
   --text <说明>          附件说明文字（仅 --file 模式）
@@ -1356,12 +1535,12 @@ Options:
                         （用于发送恰好等于某 flag 的文本，如 send a b -- --encrypt）
 
 示例:
-  ec msg send alice.agentid.pub bob.agentid.pub "hello" --return none
-  ec msg send alice.agentid.pub bob.agentid.pub --text-from-file long-message.txt --return none
-  ec msg send alice.agentid.pub bob.agentid.pub "讨论项目A" --thread "project-A" --return required
-  ec msg send alice.agentid.pub bob.agentid.pub --file ./pic.png --return none
-  ec msg send alice.agentid.pub bob.agentid.pub --file ./demo.mp4 --as video --return none
-  ec msg send alice.agentid.pub bob.agentid.pub --link https://example.com --title "AUN" --return none
+  ec msg send alice.agentid.pub bob.agentid.pub "hello"
+  ec msg send alice.agentid.pub bob.agentid.pub --text-from-file long-message.txt
+  ec msg send alice.agentid.pub bob.agentid.pub "讨论项目A" --thread "thread-xxx"
+  ec msg send alice.agentid.pub bob.agentid.pub --file ./pic.png
+  ec msg send alice.agentid.pub bob.agentid.pub --file ./demo.mp4 --as video
+  ec msg send alice.agentid.pub bob.agentid.pub --link https://example.com --title "AUN"
   ec msg pull alice.agentid.pub --app my-bot
   ec msg ack alice.agentid.pub 42 --app my-bot
   ec msg recall alice.agentid.pub msg-uuid-1 msg-uuid-2
@@ -1371,13 +1550,16 @@ Options:
         return;
     }
     if (sub === 'history' && wantsHelp(args)) {
-        console.log(`用法: ec msg history <self-aid> [<target-aid> | --channel-key <key> --peer-id <id>] [options]
+        console.log(`用法: ec msg history [<self-aid> [<target-aid>]] [--thread <id>] [options]
+
+托管会话中 --thread <id> 时 self-aid 和 target-aid 均可省略，从运行时上下文自动推断。
 
 查询指定会话对的本地历史，不调用 message.pull，也不影响收件箱游标。非 AUN selector 按已落盘的 session metadata、完整 channelKey 与原生 peer ID 精确读取，不能传入文件路径。
 
 托管会话限制：普通会话只能使用当前 self AID 和当前 AUN 私聊对端；可信 daemon Trigger 可用精确的 --channel-key/--peer-id selector 读取已落盘的非 AUN 私聊历史。托管任务不支持 --channel、--channel-name、--aun-path 或 --app。
 
 Options:
+  --thread <id>           按话题 ID 过滤（托管会话中 from/to 可省略）
   --session <latest|all|id> 默认 latest；all 查询全部；也可指定会话 ID
   --limit <N>             返回最新 N 条（默认 50，最大 500）
   --before <time>         开区间；epoch 毫秒或 ISO 时间
@@ -1392,9 +1574,41 @@ Options:
   ec msg history alice.agentid.pub bob.agentid.pub --session latest
   ec msg history alice.agentid.pub bob.agentid.pub --session all
   ec msg history alice.agentid.pub bob.agentid.pub --session meta_20260713_1783920000000 --format json
-  ec msg history alice.agentid.pub --channel-key feishu#alice.agentid.pub#main --peer-id ou_xxx --session all --format json`);
+  ec msg history alice.agentid.pub --channel-key feishu#alice.agentid.pub#main --peer-id ou_xxx --session all --format json
+  ec msg history --thread thread-xxx-0001-aaaa --limit 20`);
         return;
     }
+    // P1b.6.2: 托管会话 send 时，from/to 可省略——从 runtime 和话题索引推断
+    // history --thread 时同理：from/to 均可省略
+    if (process.env.EVOLCORE_SESSION_ID && (sub === 'send' || (sub === 'history' && getArgValue(args, '--thread')))) {
+        const { isValidAid: checkAid } = await import('../aun/aid/index.js');
+        const hasFrom = typeof args[1] === 'string' && checkAid(args[1]);
+        const hasTo = typeof args[2] === 'string' && checkAid(args[2]);
+        if (!hasFrom || !hasTo) {
+            const runtime = await readBestTaskRuntimeContext();
+            if (runtime?.selfAid) {
+                const inferredFrom = runtime.selfAid.replace(/^@/, '');
+                let inferredTo;
+                const threadArg = getArgValue(args, '--thread');
+                if (threadArg) {
+                    const { ThreadService } = await import('../core/thread/index.js');
+                    inferredTo = ThreadService.findThreadById(inferredFrom, threadArg)?.peer;
+                }
+                if (!inferredTo) {
+                    inferredTo = runtime.channelId?.replace(/^@/, '');
+                }
+                if (!hasFrom && !hasTo && inferredTo) {
+                    args.splice(1, 0, inferredFrom, inferredTo);
+                }
+                else if (!hasFrom && inferredTo) {
+                    args.splice(1, 0, inferredFrom);
+                }
+                else if (!hasTo && inferredTo) {
+                    args.splice(2, 0, inferredTo);
+                }
+            }
+        }
+    }
     const from = args[1];
     if (!from) {
         console.error('❌ 缺少 <from-aid> 参数');
@@ -1517,6 +1731,7 @@ Options:
             before,
             after,
             direction: (getArgValue(args, '--direction') ?? 'all'),
+            threadId: getArgValue(args, '--thread'),
         });
         if (!result.ok) {
             if (format === 'json')
@@ -1626,11 +1841,38 @@ Options:
             ? false
             : args.includes('--encrypt') ? true : undefined;
         const thread = getArgValue(args, '--thread');
-        const returnPolicyRaw = getArgValue(args, '--return');
-        if (returnPolicyRaw && returnPolicyRaw !== 'required' && returnPolicyRaw !== 'none') {
-            console.error(`❌ --return 仅支持 required|none: ${returnPolicyRaw}`);
-            process.exit(1);
+        // P1b.6.5: 话题存在性校验 — --thread 指定的话题必须在本端索引里存在
+        let threadEntry;
+        if (thread) {
+            const { ThreadService, normalizeThreadPeer } = await import('../core/thread/index.js');
+            threadEntry = ThreadService.findThreadById(from, thread);
+            if (!threadEntry || normalizeThreadPeer(threadEntry.peer) !== normalizeThreadPeer(to)) {
+                if (formatJson) {
+                    console.log(JSON.stringify({ ok: false, code: 'TOPIC_NOT_FOUND', error: `话题不存在: ${thread}` }));
+                }
+                else {
+                    console.error(`❌ 话题不存在: ${thread}`);
+                }
+                process.exit(1);
+            }
         }
+        // T8: 跨话题发送必须显式指定复查周期（发送前校验，避免消息已发出才报错）
+        const checkEveryRaw = getArgValue(args, '--check-every');
+        const hasCheckEvery = args.includes('--check-every') || checkEveryRaw !== undefined;
+        const triggerPromptExtra = getArgValue(args, '--trigger-prompt');
+        let checkEveryDurationMs;
+        if (thread) {
+            const parsedCheck = parseCheckEveryArgs(checkEveryRaw, hasCheckEvery);
+            if ('error' in parsedCheck) {
+                if (formatJson)
+                    console.log(JSON.stringify({ ok: false, code: parsedCheck.code, error: parsedCheck.error }));
+                else
+                    console.error(`❌ ${parsedCheck.error}`);
+                process.exit(1);
+            }
+            checkEveryDurationMs = parsedCheck.durationMs;
+        }
+        // --return 参数已移除：跨会话 send 不再需要指定返回策略（内部默认 none）。
         // SDK 尚未提供字节进度回调，只展示上传开始和成功完成。
         const onUploadProgress = formatJson ? undefined : (info) => {
             if (info.phase === 'upload')
@@ -1638,7 +1880,8 @@ Options:
             else if (info.phase === 'done')
                 process.stderr.write('  ✓ upload complete\n');
         };
-        const result = await msgSend({ from, to, body, encrypt, thread, returnPolicy: returnPolicyRaw, handoffContext: getArgValue(args, '--handoff-context'), onUploadProgress, ...commonOpts });
+        const runtime = await readBestTaskRuntimeContext();
+        const result = await msgSend({ from, to, body, encrypt, thread, handoffContext: getArgValue(args, '--handoff-context'), onUploadProgress, ...commonOpts });
         if (!result.ok) {
             if (formatJson) {
                 console.log(JSON.stringify(result));
@@ -1648,6 +1891,31 @@ Options:
             }
             process.exit(1);
         }
+        // T2: 跨话题 send 成功后创建复查 Trigger 并写入本端 inbox（Thread Context）。
+        // 私有逻辑集中在 applyCrossThreadSendEffects，与群聊路径共用。
+        let createdTriggerId;
+        if (thread && threadEntry && result.message_id && runtime?.sessionId) {
+            const effects = await applyCrossThreadSendEffects({
+                selfAid: from,
+                targetThreadId: thread,
+                targetSessionId: threadEntry.sessionId,
+                targetChannelId: to,
+                feedbackChatType: 'private',
+                messageId: result.message_id,
+                contentSummary: body.mode === 'text' ? body.text
+                    : body.mode === 'link' ? `[link] ${body.url}`
+                        : body.mode === 'file' ? `[file] ${body.filePath}`
+                            : '[payload]',
+                timestamp: result.timestamp ?? Date.now(),
+                durationMs: checkEveryDurationMs ?? 5 * 60 * 1000,
+                checkEveryLabel: checkEveryRaw || '5m',
+                triggerPromptExtra,
+            });
+            createdTriggerId = effects.triggerId;
+        }
+        // E4: 把复查 Trigger ID 回填到返回值，兑现 spec §3.4 的 `{ message_id, trigger_id }` 契约。
+        if (createdTriggerId)
+            result.trigger_id = createdTriggerId;
         if (formatJson) {
             console.log(JSON.stringify(result));
         }
@@ -1850,7 +2118,7 @@ visitor 不开放历史；群权限仍由托管会话校验。`);
         console.log(`用法: ec group <command> <from-aid> [args...] [options]
 
 消息:
-  send <from> <group-id> <text> --return <none|required> 发送群文本（跨会话时 --return 必填）
+  send <from> <group-id> <text>                        发送群文本
   send <from> <group-id> --file <path> [--as <type>]   发送群文件
   send <from> <group-id> --payload <json>              发送自定义 payload
   pull <from> <group-id> [--after-seq N] [--limit N] --app <name>   拉取群消息（必须使用独立 slot）
@@ -1900,8 +2168,11 @@ Options:
   --format json         输出 JSON 格式
   --encrypt             强制端到端加密（未指定时使用 daemon 默认值；仅 send）
   --no-encrypt          强制明文发送（优先于 --encrypt；仅 send）
-  --thread <id>         指定话题 ID（仅 send）
-  --return <none|required> 跨会话发送必填（仅 send；Trigger 只能使用 none）
+  --thread <id>         指定话题 ID（仅 send；话题必须存在于本端索引）
+  --check-every <时长>   跨话题发送（带 --thread）时**必填**，创建周期复查 Trigger（如 5m/30m/2h）
+                        无值时默认 5m；Trigger 名：check-<目标threadId>-from-<来源threadId>-<唯一后缀>
+                        取消/调整用返回的 trigger_id（trig_…），show/update/cancel 只认 id
+  --trigger-prompt <text> 自定义复查 Trigger prompt 中的用户段（仅 --check-every）
   --mention <aid>       发送时 @ 某个成员（可多次，或用逗号分隔多个 aid）
   --mention-all         发送时 @ 所有人
   --content-type <mime> 显式覆盖 MIME（仅 --file 模式）
@@ -1915,9 +2186,10 @@ Options:
 
 格式示例（.example.invalid 是保留的虚构域，以下 AID 均不是真实地址）:
   ec group create sender.example.invalid "Dev Team" --visibility private
-  ec group send sender.example.invalid 12345.example.invalid "hello team" --return none
+  ec group send sender.example.invalid 12345.example.invalid "hello team"
   ec group send sender.example.invalid 12345.example.invalid "@member 看下 PR" --mention member.example.invalid
   ec group send sender.example.invalid 12345.example.invalid --file ./arch.png
+  ec group send sender.example.invalid g-12345.example.invalid "进度?" --thread thread-xxx --check-every 30m
   ec group rules sender.example.invalid 12345.example.invalid set ./rules.md
   ec group invite sender.example.invalid 12345.example.invalid member.example.invalid
   ec group members sender.example.invalid 12345.example.invalid
@@ -2157,7 +2429,16 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
                 failManagedGroup(formatJson, 'NOT_ALLOWED', '--aun-path and --app are not allowed in a managed task');
             }
             const runtime = await readBestTaskRuntimeContext();
-            validateManagedGroupScope(from, groupId, runtime, formatJson);
+            // 跨话题发送：目标群由 --thread 话题决定，不受「只能操作当前群」限制；
+            // 发送者仍必须是当前 self AID，daemon 侧按目标话题 relation 复核。
+            const threadArg = getArgValue(args, '--thread');
+            const { resolveThreadRouteTarget } = await import('../core/thread/thread-route.js');
+            if (threadArg && resolveThreadRouteTarget(from, threadArg, 'group', groupId)) {
+                validateManagedGroupScope(from, undefined, runtime, formatJson);
+            }
+            else {
+                validateManagedGroupScope(from, groupId, runtime, formatJson);
+            }
         }
         const optionsEnd = args.indexOf('--', 3);
         const optionArgs = optionsEnd >= 0 ? args.slice(0, optionsEnd) : args;
@@ -2165,7 +2446,7 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
         const fileVal = getSendArgValue('--file');
         const payloadVal = getSendArgValue('--payload');
         const bodyPositionals = collectPositional(args, 3);
-        const bodyFlags = ['--file', '--payload', '--as', '--content-type', '--text', '--transcript', '--thread', '--return'];
+        const bodyFlags = ['--file', '--payload', '--as', '--content-type', '--text', '--transcript', '--thread', '--check-every', '--trigger-prompt'];
         for (let index = 3; index < args.length; index++) {
             const flag = args[index];
             if (flag === '--')
@@ -2238,9 +2519,24 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
             ? false
             : args.includes('--encrypt') ? true : undefined;
         const thread = getSendArgValue('--thread');
-        const returnPolicyRaw = getSendArgValue('--return');
-        if (returnPolicyRaw && returnPolicyRaw !== 'required' && returnPolicyRaw !== 'none') {
-            failManagedGroup(formatJson, 'INVALID_ARGUMENT', `--return 仅支持 required|none: ${returnPolicyRaw}`);
+        // M2: 群话题跨话题发送与私聊同样必须指定 --check-every，并同样创建复查 Trigger + 写 inbox。
+        const groupCheckEveryRaw = getSendArgValue('--check-every');
+        const groupHasCheckEvery = optionArgs.includes('--check-every') || groupCheckEveryRaw !== undefined;
+        const groupTriggerPromptExtra = getSendArgValue('--trigger-prompt');
+        let groupCheckEveryMs;
+        let groupThreadEntry;
+        if (thread) {
+            // 话题必须存在于本端索引（与私聊路径一致，不自动创建）。
+            const { ThreadService } = await import('../core/thread/index.js');
+            groupThreadEntry = ThreadService.findThreadById(from, thread);
+            if (!groupThreadEntry || normalizeGroupAid(groupThreadEntry.peer, from.slice(from.indexOf('.') + 1)) !== groupId) {
+                failManagedGroup(formatJson, 'TOPIC_NOT_FOUND', `话题不存在: ${thread}`);
+            }
+            const parsedCheck = parseCheckEveryArgs(groupCheckEveryRaw, groupHasCheckEvery);
+            if ('error' in parsedCheck) {
+                failManagedGroup(formatJson, parsedCheck.code, parsedCheck.error);
+            }
+            groupCheckEveryMs = parsedCheck.durationMs;
         }
         const result = await groupSend({
             from,
@@ -2249,9 +2545,33 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
             mentions: mentions.length ? mentions : undefined,
             encrypt: encryptGroup,
             thread,
-            returnPolicy: returnPolicyRaw,
             ...commonOpts,
         });
+        // T2.6: 群聊跨话题发送成功后，同样写入本端 inbox（与私聊路径一致）
+        if (result && result.ok !== false && thread && groupThreadEntry) {
+            const r = result;
+            const messageId = r.message_id ?? r.message?.message_id;
+            if (messageId) {
+                const effects = await applyCrossThreadSendEffects({
+                    selfAid: from,
+                    targetThreadId: thread,
+                    targetSessionId: groupThreadEntry.sessionId,
+                    targetChannelId: groupId,
+                    feedbackChatType: 'group',
+                    messageId: String(messageId),
+                    contentSummary: body.mode === 'text' ? body.text
+                        : body.mode === 'link' ? `[link] ${body.url}`
+                            : body.mode === 'file' ? `[file] ${body.filePath}`
+                                : '[payload]',
+                    timestamp: r.timestamp ?? Date.now(),
+                    durationMs: groupCheckEveryMs ?? 5 * 60 * 1000,
+                    checkEveryLabel: groupCheckEveryRaw || '5m',
+                    triggerPromptExtra: groupTriggerPromptExtra,
+                });
+                if (effects.triggerId)
+                    result.trigger_id = effects.triggerId;
+            }
+        }
         outputResult(result, () => {
             const r = result;
             if (r.handoff_id && r.status === 'delivered')
@@ -2798,7 +3118,7 @@ export function resolveManagedSendArgv(argv) {
     const booleans = new Set();
     const text = [];
     const mentions = [];
-    const valueFlags = new Set(['--format', '--file', '--payload', '--text-from-file', '--link', '--title', '--description', '--as', '--content-type', '--text', '--transcript', '--thread', '--return', '--handoff-context', '--mention']);
+    const valueFlags = new Set(['--format', '--file', '--payload', '--text-from-file', '--link', '--title', '--description', '--as', '--content-type', '--text', '--transcript', '--thread', '--check-every', '--trigger-prompt', '--return', '--handoff-context', '--mention']);
     const booleanFlags = new Set(['--encrypt', '--no-encrypt', '--mention-all']);
     for (let index = 4; index < argv.length; index++) {
         const flag = argv[index];
@@ -2840,6 +3160,20 @@ export function resolveManagedSendArgv(argv) {
     const handoffContext = values.get('--handoff-context');
     if (handoffContext !== undefined && (scope !== 'msg' || !handoffContext.trim() || handoffContext.length > 65536))
         throw new Error('Invalid private handoff context');
+    const thread = values.get('--thread');
+    const checkEvery = values.get('--check-every');
+    const triggerPromptExtra = values.get('--trigger-prompt');
+    if (!thread && (checkEvery !== undefined || triggerPromptExtra !== undefined))
+        throw new Error('Cross-thread options require --thread');
+    let checkEveryMs;
+    if (thread) {
+        if (checkEvery === undefined)
+            throw new Error('Cross-thread sends require --check-every');
+        const parsedCheckEveryMs = parseDuration(checkEvery);
+        if (parsedCheckEveryMs === null)
+            throw new Error('Invalid --check-every duration');
+        checkEveryMs = parsedCheckEveryMs;
+    }
     if (scope === 'msg' && (mentions.length || booleans.has('--mention-all')))
         throw new Error('Mentions require a group send');
     if (scope === 'group' && (values.has('--link') || values.has('--text-from-file')))
@@ -2878,7 +3212,7 @@ export function resolveManagedSendArgv(argv) {
         mentions.push({ scope: 'all' });
     return { aid, to, scope, payload, file, textFile: values.get('--text-from-file'),
         encrypt: booleans.has('--no-encrypt') ? false : booleans.has('--encrypt') ? true : undefined,
-        thread: values.get('--thread'), returnPolicy: returnPolicy, handoffContext,
+        thread, checkEvery, checkEveryMs: checkEveryMs ?? undefined, triggerPromptExtra, returnPolicy: returnPolicy, handoffContext,
         mentions: mentions.length ? mentions : undefined };
 }
 /**
@@ -2900,7 +3234,9 @@ const VALUE_FLAGS = new Set([
     '--as', '--content-type', '--mention', '--visibility', '--join-mode',
     '--group-id', '--name', '--message', '--answer', '--page', '--size',
     '--member-type',
-    '--aun-path', '--thread', '--return', '--handoff-context',
+    '--aun-path', '--thread', '--handoff-context',
+    // 跨话题发送的复查参数：漏登记会让 collectPositional 把它们当正文（正文污染）
+    '--check-every', '--trigger-prompt',
 ]);
 const BOOLEAN_FLAGS = new Set([
     '--encrypt', '--no-encrypt', '--mention-all', '--clear',

package/dist/cli/contact.js

@@ -11,8 +11,14 @@ export async function cmdContact(args) {
     }
     const json = getArgValue(args, '--format') === 'json';
     if (process.env.EVOLCORE_SESSION_ID) {
-        const result = await runManaged(args, json);
-        output(result, json);
+        try {
+            const result = await runManaged(args, json);
+            output(result, json);
+        }
+        catch (err) {
+            console.error(`❌ ${err.message ?? String(err)}`);
+            process.exitCode = 1;
+        }
         return;
     }
     if (!args.includes('--self') && isListCommand(args) && !process.env.EVOLCORE_SELF_AID?.trim()) {