evolcore 0.0.31 → 0.0.33

package/dist/cli/aun-commands.js

@@ -1,15 +1,18 @@
 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';
 import { ipcQuery } from '../ipc.js';
+import { isValidAid as validSendAid } from '../aun/aid/validation.js';
 import { AGENT_DELEGATION_TOKEN_ENV, readDelegationCredential } from '../core/auth/agent-delegation.js';
 import { isManagementRole } from '../config/builtin-roles.js';
 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');
@@ -1088,6 +1091,7 @@ Options:
 }
 // ==================== Storage ====================
 export async function cmdStorage(args) {
+    args = canonicalizeEvolcoreCommandArgv(['ec', 'storage', ...args]).slice(2);
     const sub = args[0];
     const aunPath = resolveAunPath(args);
     const formatJson = getArgValue(args, '--format') === 'json';
@@ -1142,12 +1146,9 @@ Options:
                 console.error('用法: ec storage upload <aid> <local-file> <remote-path> [--public]');
                 process.exit(1);
             }
-            if (!fs.existsSync(localFile)) {
-                console.error(`❌ 文件不存在: ${localFile}`);
-                process.exit(1);
-            }
             const result = await ipcQuery(resolvePaths().socket, {
                 type: 'storage.upload',
+                argv: ['storage', ...args],
                 aid,
                 localFile,
                 remotePath,
@@ -1172,12 +1173,25 @@ Options:
             return;
         }
         const authorization = await ipcQuery(resolvePaths().socket, {
-            type: 'storage.auth', operation, aid, sessionId: process.env.EVOLCORE_SESSION_ID, delegationToken,
+            type: 'storage.auth', argv: ['storage', ...args], operation, aid, sessionId: process.env.EVOLCORE_SESSION_ID, delegationToken,
         }, 10_000);
         if (!authorization)
             failManagedGroup(formatJson, 'DAEMON_UNAVAILABLE', 'Unable to connect to the evolcore daemon');
         if (!authorization.ok)
             failManagedGroup(formatJson, authorization.code || 'STORAGE_AUTH_FAILED', authorization.error || 'Storage operation denied');
+        if (sub === 'ls') {
+            const objects = authorization.result?.objects ?? authorization.result ?? [];
+            console.log(Array.isArray(objects) && !objects.length ? '(空)' : JSON.stringify(objects, null, 2));
+        }
+        else if (sub === 'quota')
+            console.log(JSON.stringify(authorization.result, null, 2));
+        else if (formatJson)
+            console.log(JSON.stringify(authorization));
+        else if (sub === 'download')
+            console.log(`✓ 已下载: ${authorization.localPath} (${authorization.size} bytes)`);
+        else
+            console.log(`✓ 已删除: ${authorization.objectKey}`);
+        return;
     }
     const { storageUpload, storageDownload, storageLs, storageRm, storageQuota } = await import('../aun/storage/index.js');
     if (sub === 'upload') {
@@ -1295,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];
@@ -1305,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]            发送链接卡片
@@ -1316,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>  仅托管会话：为目标会话补充本地上下文，不发给对端
@@ -1324,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>        只返回该时间之后的历史
@@ -1333,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 模式）
@@ -1344,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
@@ -1359,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 时间
@@ -1380,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> 参数');
@@ -1398,6 +1624,8 @@ Options:
         renderManagedMsgResult(sub, result, formatJson);
         return;
     }
+    if (process.env.EVOLCORE_SESSION_ID && sub === 'send')
+        return runManagedSend(['msg', ...args], formatJson);
     const { msgSend, msgPull, msgAck, msgRecall, msgOnline, msgHistory } = await import('../aun/msg/index.js');
     const commonOpts = { aunPath, slotId: appSlot };
     const requireConsumerSlot = (operation) => {
@@ -1503,6 +1731,7 @@ Options:
             before,
             after,
             direction: (getArgValue(args, '--direction') ?? 'all'),
+            threadId: getArgValue(args, '--thread'),
         });
         if (!result.ok) {
             if (format === 'json')
@@ -1612,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')
@@ -1624,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));
@@ -1634,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));
         }
@@ -1836,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）
@@ -1886,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 模式）
@@ -1901,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
@@ -1935,6 +2221,21 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
         renderManagedGroupResult(args, result, formatJson);
         return;
     }
+    if (process.env.EVOLCORE_SESSION_ID && sub === 'send') {
+        if (args.includes('--aun-path') || args.includes('--app')) {
+            failManagedGroup(formatJson, 'NOT_ALLOWED', '--aun-path and --app are not allowed in a managed task');
+        }
+        let groupId;
+        try {
+            groupId = normalizeGroupAid(args[2] ?? '', from.slice(from.indexOf('.') + 1));
+        }
+        catch (error) {
+            failManagedGroup(formatJson, 'INVALID_ARGUMENT', `Invalid group AID: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        const runtime = await readBestTaskRuntimeContext();
+        validateManagedGroupScope(from, groupId, runtime, formatJson);
+        return runManagedSend(['group', ...args], formatJson);
+    }
     const { groupSend, groupPull, groupAck, groupHistory, parseGroupHistoryArgs, groupCreate, groupInfo, groupList, groupUpdate, groupDissolve, groupSuspend, groupResume, groupJoin, groupLeave, groupInvite, groupInvites, groupAcceptInvite, groupRejectInvite, groupRevokeInvite, groupKick, groupMembers, groupOnline, groupSetRole, groupTransferOwner, groupBan, groupUnban, groupBanlist, groupBlock, groupUnblock, groupBlocklist, groupReportStatus, groupMemberStatuses, groupRules, groupUpdateRules, groupRulesFileGet, groupRulesFileSet, groupRulesFilePublish, } = await import('../aun/msg/index.js');
     const commonOpts = { aunPath, slotId: appSlot };
     if (['block', 'unblock', 'blocklist', 'report-status', 'member-statuses'].includes(sub)) {
@@ -2128,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;
@@ -2136,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 === '--')
@@ -2209,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,
@@ -2220,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')
@@ -2737,6 +3086,135 @@ g- 是名称的一部分，会完整保留；默认命名格式为 g-10000 至 g
     process.exit(1);
 }
 // ==================== Main ====================
+async function runManagedSend(argv, formatJson) {
+    const delegationToken = readDelegationCredential();
+    if (!delegationToken)
+        failManagedGroup(formatJson, 'DELEGATION_REQUIRED', 'Managed send requires delegation');
+    const runtime = await readBestTaskRuntimeContext();
+    const result = await ipcQuery(resolvePaths().socket, {
+        type: 'aun-msg-send', argv, delegationToken,
+        originSessionId: process.env.EVOLCORE_SESSION_ID, originMessageId: runtime?.messageId,
+    }, null);
+    if (!result)
+        failManagedGroup(formatJson, 'AUN_DAEMON_UNAVAILABLE', 'Unable to connect to the EvolCore daemon');
+    if (!result.ok)
+        failManagedGroup(formatJson, result.code ?? 'AUN_SEND_FAILED', result.error ?? 'Send failed');
+    if (formatJson)
+        console.log(JSON.stringify(result));
+    else if (result.handoff_id)
+        console.log(`✓ handoff ${result.handoff_id} ${result.status === 'delivered' ? '已投递' : '已排队'} ${result.message_id ?? ''}`.trimEnd());
+    else
+        console.log(`✓ 已发送 message_id=${result.message_id ?? '-'} seq=${result.seq ?? result.message?.seq ?? '-'}`);
+}
+export function resolveManagedSendArgv(argv) {
+    if (!['msg', 'group'].includes(argv[0]) || argv[1] !== 'send' || !validSendAid(argv[2]))
+        throw new Error('Invalid managed send command');
+    const scope = argv[0];
+    const aid = argv[2];
+    const to = scope === 'group' ? normalizeGroupAid(argv[3], aid.slice(aid.indexOf('.') + 1)) : argv[3];
+    if (!to || !validSendAid(to))
+        throw new Error('Invalid send target');
+    const values = new Map();
+    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', '--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];
+        if (flag === '--') {
+            text.push(...argv.slice(index + 1));
+            break;
+        }
+        if (flag === '--app' || flag === '--aun-path')
+            throw new Error(`${flag} is not allowed for managed sends`);
+        if (booleanFlags.has(flag))
+            booleans.add(flag);
+        else if (valueFlags.has(flag)) {
+            const value = argv[++index];
+            if (value === undefined || valueFlags.has(value) || booleanFlags.has(value))
+                throw new Error(`${flag} requires a value`);
+            if (flag === '--mention') {
+                for (const mention of value.split(',').map(item => item.trim()).filter(Boolean)) {
+                    if (!validSendAid(mention))
+                        throw new Error('Invalid mention AID');
+                    mentions.push({ aid: mention });
+                }
+            }
+            else {
+                if (values.has(flag))
+                    throw new Error(`Duplicate send option: ${flag}`);
+                values.set(flag, value);
+            }
+        }
+        else
+            text.push(flag);
+    }
+    if (booleans.has('--encrypt') && booleans.has('--no-encrypt'))
+        throw new Error('Encryption options are mutually exclusive');
+    if (values.has('--format') && values.get('--format') !== 'json')
+        throw new Error('--format only supports json');
+    const returnPolicy = values.get('--return');
+    if (returnPolicy !== undefined && !['none', 'required'].includes(returnPolicy))
+        throw new Error('Invalid return policy');
+    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')))
+        throw new Error('Unsupported group send body');
+    const modes = ['--file', '--payload', '--text-from-file', '--link'].filter(flag => values.has(flag));
+    if (modes.length > 1 || (modes.length && text.length))
+        throw new Error('Message body modes are mutually exclusive');
+    let payload;
+    let file;
+    if (values.has('--file')) {
+        const as = values.get('--as');
+        if (as && !['image', 'video', 'voice', 'file'].includes(as))
+            throw new Error('Invalid attachment type');
+        if (values.has('--transcript') && as !== 'voice')
+            throw new Error('--transcript requires --as voice');
+        file = { filePath: values.get('--file'), as, contentType: values.get('--content-type'), text: values.get('--text'), transcript: values.get('--transcript') };
+    }
+    else if (values.has('--payload')) {
+        payload = JSON.parse(values.get('--payload'));
+        if (!payload || typeof payload !== 'object' || Array.isArray(payload))
+            throw new Error('--payload must be a JSON object');
+    }
+    else if (values.has('--link')) {
+        assertEcSingleLine(values.get('--title'), '--title');
+        payload = { type: 'link', url: values.get('--link'), ...(values.get('--title') ? { title: values.get('--title') } : {}),
+            ...(values.get('--description') ? { description: values.get('--description') } : {}) };
+    }
+    else if (!values.has('--text-from-file')) {
+        if (!text.join(' '))
+            throw new Error('Message content is required');
+        payload = { type: 'text', text: text.join(' ') };
+    }
+    if (!file && ['--as', '--content-type', '--text', '--transcript'].some(flag => values.has(flag)))
+        throw new Error('Attachment options require --file');
+    if (booleans.has('--mention-all'))
+        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, checkEvery, checkEveryMs: checkEveryMs ?? undefined, triggerPromptExtra, returnPolicy: returnPolicy, handoffContext,
+        mentions: mentions.length ? mentions : undefined };
+}
 /**
  * 收集位置参数（从 startIdx 开始）。
  *
@@ -2756,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',