botmux 2.95.0 → 2.96.1

package/dist/adapters/hook-installer.js

@@ -136,45 +136,155 @@ function installClaudeSettings(configPath, hookCommand, sessionStartCommand) {
 // ─── OpenCode plugin 格式 ─────────────────────────────────────────────────────
 /**
  * 构造 botmux ask 的 OpenCode 插件内容。
- * 插件监听 question.asked 事件，将 payload JSON 写入 botmux hook opencode 的 stdin，
- * 读取 stdout 作为回答，返回给 OpenCode。
  *
- * TODO(dogfood): 校验 OpenCode 插件 question.asked API
- * OpenCode 插件 API 目前处于 dogfood 阶段，`question.asked` 钩子形状和返回值约定
- * 需要在真实会话中实测确认（stdin/stdout 格式、同步/异步、返回值结构等）。
+ * 机制（已在 OpenCode 1.17.x 实机验证）：
+ *   - OpenCode 自带原生 `question` 工具（= Claude AskUserQuestion 等价物），模型会原生
+ *     调用，无需我们注入。它被调用时，服务端发布 `question.asked` 事件并阻塞，等客户端
+ *     把答案提交到 `/question/{id}/reply`（body `{ answers }`）后才解阻塞、返回给模型。
+ *   - OpenCode 插件 API 没有 `question.asked` 这种专用钩子；要拦截只能用通用 `event` 钩子
+ *     按 `event.type === 'question.asked'` 过滤（plugin 导出必须是「函数」而非对象）。
+ *
+ * 事件 payload 形状：
+ *   { type:'question.asked', properties:{ id:'que_…', sessionID:'ses_…',
+ *     questions:[{ question, header, options:[{label,description}], multiple? }] } }
+ *
+ * 转发策略：把 questions 规范成 `botmux hook opencode` 认识的 payload 喂给它（复用现有
+ * 飞书问答链路：daemon /api/asks → 飞书卡片 → 用户作答 → directive），拿到 stdout 里的
+ * `{ answers }` 后回传给 OpenCode 解阻塞。
+ *   - **回传必须走 OpenCode 注入给插件的 client（`client._client`）**，不能用裸 fetch：
+ *     OpenCode 是「单 server 多 worktree 实例」模型，client 自带 `x-opencode-directory`
+ *     头把 reply 路由到发起 question 的那个实例，且其传输在 daemon 里实际可达
+ *     （裸 fetch 到 `localhost:4096` 在 daemon 里连不上 + 缺 directory 头 → 永远卡 picker）。
+ *   - **异步**作答：飞书侧作答可能耗时很久（默认上限 1h），绝不能用 spawnSync 同步阻塞
+ *     OpenCode 的单线程事件总线（会冻结整个 TUI）。改用异步 spawn + fire-and-forget。
+ *   - stdout 为空（passthrough：daemon 不可达 / 超时 / 非 botmux 会话）→ 不 reply，把问题
+ *     留给 OpenCode 原生 picker（botmux web 终端里仍可人工作答）。
  */
 function buildOpenCodePlugin(parts) {
     // 用 argv 形式嵌入（不拼 shell 字符串、不 split）：含空格/引号的路径也不会被拆坏。
     const cmdLit = JSON.stringify(parts.cmd);
     const argsLit = JSON.stringify(parts.args);
     return `// botmux-ask opencode plugin
-// 将 OpenCode 的 question.asked 事件转发到 botmux hook opencode。
-// TODO(dogfood): 校验 OpenCode 插件 question.asked API
-import { spawnSync } from "child_process";
+// 监听 OpenCode 原生 \`question\` 工具触发的 \`question.asked\` 事件，转发到
+// \`botmux hook opencode\`（飞书问答），再把答案 POST 回 OpenCode 解阻塞。
+import { spawn } from "child_process";
+import { appendFileSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
 
-export default {
-  name: "botmux-ask",
+const CMD = ${cmdLit};
+const ARGS = ${argsLit};
+
+// 诊断日志：默认关闭，设 BOTMUX_OPENCODE_ASK_DEBUG=1 后每步落盘到
+// ~/.botmux/opencode-ask-debug.log，用于排查 ask 链路（事件→转发→reply）。
+const DBG_ON = !!process.env.BOTMUX_OPENCODE_ASK_DEBUG;
+const DBG = join(homedir(), ".botmux", "opencode-ask-debug.log");
+function dbg(m) {
+  if (!DBG_ON) return;
+  try { appendFileSync(DBG, new Date().toISOString() + " " + m + "\\n"); } catch {}
+}
 
-  // question.asked: OpenCode 向用户提问时触发。
-  // payload 形状待实测（见 TODO 注释）。
-  // 返回值 { type:'answer', answers } 或 undefined（undefined = 由 OpenCode 自行处理）。
-  "question.asked"(payload) {
+// 异步 spawn \`botmux hook opencode\`：stdin 喂 payload，收集 stdout。
+// 任何失败都 resolve("")（= passthrough 放行）。child 自带超时（hook 客户端按
+// BOTMUX_ASK_TIMEOUT_MS 自限），这里再加 25h 兜底 kill 防僵尸（unref 不拖住事件循环）。
+function askBotmux(payload) {
+  return new Promise((resolve) => {
+    let out = "";
+    let settled = false;
+    const done = (v) => { if (!settled) { settled = true; resolve(v); } };
+    let child;
     try {
-      const input = JSON.stringify(payload);
-      const result = spawnSync(${cmdLit}, ${argsLit}, {
-        input,
-        encoding: "utf-8",
-        timeout: 86400000, // 24h，等待用户在飞书回答
-      });
-      // stdout 为空 = hook 客户端 passthrough（放行）→ 返回 undefined，OpenCode 原生处理。
-      if (result.status === 0 && result.stdout && result.stdout.trim()) {
-        return JSON.parse(result.stdout.trim());
-      }
+      child = spawn(CMD, ARGS, { stdio: ["pipe", "pipe", "ignore"] });
     } catch {
-      // 任何失败都降级放行：返回 undefined 让 OpenCode 回退原生终端提问
+      return done("");
+    }
+    const backstop = setTimeout(() => { try { child.kill(); } catch {} done(""); }, 90000000);
+    if (typeof backstop.unref === "function") backstop.unref();
+    child.stdout.on("data", (d) => { out += d.toString("utf-8"); });
+    child.on("error", () => { clearTimeout(backstop); done(""); });
+    child.on("close", (code) => { clearTimeout(backstop); done(code === 0 ? out : ""); });
+    try { child.stdin.write(payload); child.stdin.end(); } catch { clearTimeout(backstop); done(""); }
+  });
+}
+
+// 把答案回传给 OpenCode 解阻塞。
+// 必须走 OpenCode 自带的 client（client._client = 已配置的 hey-api client）——
+// 它带着 \`x-opencode-directory\` 头与正确的 baseUrl/传输。OpenCode 用「单 server 多
+// worktree 实例」模型，该头用于把 reply 路由到发起 question 的那个实例；裸 fetch 缺这个
+// 头会打到错误实例（question 找不到 → 永远卡在 picker）。失败再回落裸 fetch（复制其 headers）。
+function safeStr(x) {
+  try { return String(JSON.stringify(x)).slice(0, 120); } catch { return String(x); }
+}
+
+async function postReply(client, serverUrl, id, answers) {
+  const body = { answers };
+  // 1) 经 client._client（带 directory 头 + 正确传输）。这是 daemon 多实例下唯一可达的路径：
+  //    裸 fetch 到 localhost:4096 在 daemon 里根本连不上（OpenCode 用 interceptor 传输）。
+  try {
+    const c = client && client._client;
+    if (c && typeof c.post === "function") {
+      const res = await c.post({ url: "/question/" + id + "/reply", body });
+      const st = res && res.response && res.response.status;
+      const success = (res && res.data === true) || (st && st >= 200 && st < 300);
+      dbg("CLIENT_POST id=" + id + " status=" + st + " data=" + safeStr(res && res.data) + " err=" + safeStr(res && res.error));
+      if (success) return true;
+    } else {
+      dbg("CLIENT_POST_UNAVAILABLE id=" + id);
     }
-    return undefined;
-  },
+  } catch (e) { dbg("CLIENT_POST_THREW id=" + id + " err=" + String(e)); }
+  // 2) 回落裸 fetch，尽量复制 client 的 headers（含 directory）与 baseUrl
+  try {
+    let base = String(serverUrl).replace(/\\/+$/, "");
+    let headers = { "content-type": "application/json" };
+    try {
+      const cfg = client && client._client && client._client.getConfig && client._client.getConfig();
+      if (cfg) {
+        if (cfg.baseUrl) base = String(cfg.baseUrl).replace(/\\/+$/, "");
+        if (cfg.headers) headers = Object.assign({}, cfg.headers, { "content-type": "application/json" });
+      }
+    } catch {}
+    const url = base + "/question/" + id + "/reply";
+    dbg("FETCH_POST url=" + url + " headers=" + Object.keys(headers).join(","));
+    const r = await fetch(url, { method: "POST", headers, body: JSON.stringify(body) });
+    let txt = ""; try { txt = await r.text(); } catch {}
+    dbg("FETCH_POST_RESULT id=" + id + " status=" + r.status + " body=" + txt.slice(0, 150));
+    return r.ok;
+  } catch (e) { dbg("FETCH_POST_THREW id=" + id + " err=" + String(e)); return false; }
+}
+
+export const BotmuxAsk = async ({ client, serverUrl }) => {
+  dbg("PLUGIN_LOADED serverUrl=" + serverUrl + " hasClient=" + !!(client && client._client));
+  return {
+    event: async ({ event }) => {
+      if (!event || event.type !== "question.asked") return;
+      const props = event.properties || {};
+      const id = props.id;
+      const questions = props.questions;
+      dbg("EVENT question.asked id=" + id + " sessionID=" + props.sessionID + " nQ=" + (Array.isArray(questions) ? questions.length : "?"));
+      if (!id || !Array.isArray(questions) || questions.length === 0) { dbg("SKIP missing id/questions"); return; }
+      // fire-and-forget：不 await，避免阻塞事件总线（飞书作答可能很久）。
+      // 问题在服务端独立阻塞，答案经 reply 回去即可解阻塞。
+      (async () => {
+        const payload = JSON.stringify({
+          hook_event_name: "question.asked",
+          question_id: id,
+          session_id: props.sessionID,
+          tool_input: { questions },
+        });
+        dbg("SPAWN botmux hook opencode id=" + id);
+        const stdout = (await askBotmux(payload)).trim();
+        dbg("HOOK_STDOUT id=" + id + " len=" + stdout.length + " body=" + stdout.slice(0, 300));
+        if (!stdout) { dbg("PASSTHROUGH empty stdout id=" + id); return; } // passthrough/超时 → 不应答，留给原生 picker
+        let directive;
+        try { directive = JSON.parse(stdout); } catch (e) { dbg("PARSE_FAIL id=" + id + " err=" + String(e)); return; }
+        const answers = directive && directive.answers;
+        if (!Array.isArray(answers)) { dbg("NO_ANSWERS id=" + id + " directive=" + JSON.stringify(directive).slice(0, 200)); return; }
+        dbg("REPLY id=" + id + " answers=" + JSON.stringify(answers));
+        const ok = await postReply(client, serverUrl, id, answers);
+        dbg("REPLY_DONE id=" + id + " ok=" + ok);
+      })().catch((e) => { dbg("HANDLER_ERR id=" + id + " err=" + String(e)); });
+    },
+  };
 };
 `;
 }
@@ -208,7 +318,7 @@ export function installHook(cliId, hookInstall, hookCommand) {
                 installClaudeSettings(configPath, hookCommand, hookInstall.sessionStartCommand);
                 break;
             case 'opencode-plugin':
-                // OpenCode 插件走 argv parts（spawnSync），不复用 shell 字符串，避免被 split 拆坏。
+                // OpenCode 插件走 argv parts（异步 spawn），不复用 shell 字符串，避免被 split 拆坏。
                 installOpenCodePlugin(configPath, hookCommandParts(cliId));
                 break;
             default: {

package/dist/adapters/hook-installer.js.map

@@ -1 +1 @@
-{"version":3,"file":"hook-installer.js","sourceRoot":"","sources":["../../src/adapters/hook-installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hook-installer.js","sourceRoot":"","sources":["../../src/adapters/hook-installer.ts"],"names":[],"mappings":"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"}

package/dist/bot-registry.d.ts

@@ -6,6 +6,46 @@ import type { VoiceConfig } from './services/voice/types.js';
 import { type Brand } from './im/lark/lark-hosts.js';
 import type { BotSkillPolicy } from './core/skills/types.js';
 export type ChatReplyMode = 'chat' | 'new-topic' | 'shared' | 'chat-topic';
+export type ContentTriggerScope = 'topic' | 'regularGroup' | 'both';
+export type ContentTriggerMatchType = 'keyword' | 'regex';
+export type ContentTriggerActionType = 'start-or-wake-session';
+export interface SummaryRangeConfig {
+    /** 0 means no count limit; omitted defaults to 50. */
+    limit?: number;
+    /** 0 means no time limit; omitted defaults to 24 hours. */
+    sinceHours?: number;
+}
+export interface ContentTriggerConfig {
+    name: string;
+    enabled: boolean;
+    scope: ContentTriggerScope;
+    /**
+     * Default false. When true, this trigger may be matched by non-@ messages
+     * authored by other bots. The current bot's own messages are still ignored.
+     */
+    allowBotMessages?: boolean;
+    match: {
+        type: ContentTriggerMatchType;
+        pattern: string;
+        caseSensitive: boolean;
+    };
+    history: {
+        topic: {
+            mode: 'current-thread';
+        };
+        regularGroup: {
+            mode: 'recent-messages';
+            /** 0 means no count limit; omitted defaults to 50. */
+            limit?: number;
+            /** 0 means no time limit; omitted means no time limit. */
+            sinceHours?: number;
+        };
+    };
+    action: {
+        type: ContentTriggerActionType;
+        prompt: string;
+    };
+}
 export interface OncallChat {
     /** Lark chat_id (oc_xxx) the bot was pulled into. */
     chatId: string;
@@ -333,19 +373,28 @@ export interface BotConfig {
     regularGroupReplyMode?: ChatReplyMode;
     /**
      * Per-bot (bot-global) policy for when an @mention is required to get a reply
-     * in regular Lark groups — a 3-tier ladder:
+     * in regular Lark groups — a 4-tier ladder:
      *   • 'always' (or undefined) — @ required everywhere, including inside the
      *                               bot's own shared topics (the safe default).
      *   • 'topic'                 — @ required to start / at top level, but NOT
      *                               inside the bot's shared topics (non-@ replies
      *                               there continue the session).
-     *   • 'never'                 — @ never required: non-@ messages in groups
-     *                               where the bot has talk access are answered too.
+     *   • 'never'                 — @ never required: every non-@ message in groups
+     *                               where the bot has talk access is answered too,
+     *                               unconditionally. For dedicated / on-call groups.
+     *   • 'ambient'               — like 'never' (non-@ messages answered), EXCEPT
+     *                               when the message @mentions another specific
+     *                               member (person/bot) without @ing this bot —
+     *                               that is a redirect to someone else, so the bot
+     *                               stays quiet (@all is not a redirect). Best for
+     *                               multi-bot / multi-person groups: a default
+     *                               responder that yields when you address someone
+     *                               else.
      * Governs the shared-topic fold-back + the top-level @ gate. `new-topic` /
      * 话题群 topics own their own thread and continue without @ regardless (that
      * is the mode's defining behavior, not affected by this policy).
      */
-    regularGroupMentionMode?: 'always' | 'topic' | 'never';
+    regularGroupMentionMode?: 'always' | 'topic' | 'never' | 'ambient';
     /**
      * 飞书文档订阅入口（/subscribe-lark-doc）新订阅的默认评论触发范围：
      *   • 'mention-only'（或 undefined）— 仅评论里 @bot 才触发（默认，防噪声）
@@ -353,6 +402,13 @@ export interface BotConfig {
      * 单条订阅的触发范围之后可在 dashboard 逐文档改（doc-subscriptions 表）。
      */
     docSubscribeDefaultMode?: 'mention-only' | 'all';
+    /** Per-bot range for explicit `@bot /summary`; defaults to 50 messages / 24h. */
+    summaryRange?: SummaryRangeConfig;
+    /**
+     * Legacy content/keyword trigger config. Kept parseable for config
+     * compatibility, but message routing no longer fires non-@ content triggers.
+     */
+    contentTriggers?: ContentTriggerConfig[];
     /**
      * Per-bot voice-engine override for the voice-summary feature. Merged OVER
      * the global `voice` block in ~/.botmux/config.json (per-bot wins field by
@@ -371,6 +427,7 @@ export interface BotState {
     /** raw allowedUsers 条目 → 解析后的 open_id。供 /revoke 反查并删除 email 形式的 raw 条目。 */
     rawAllowedUserResolution: Map<string, string>;
 }
+export declare function __testOnly_resetBotRegistry(): void;
 export declare function getLoadedConfigPath(): string | undefined;
 /**
  * Condense a Lark SDK error into one readable line, preserving just the fields

package/dist/bot-registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bot-registry.d.ts","sourceRoot":"","sources":["../src/bot-registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"bot-registry.d.ts","sourceRoot":"","sources":["../src/bot-registry.ts"],"names":[],"mappings":"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"}

package/dist/bot-registry.js

@@ -21,7 +21,161 @@ function normalizeChatReplyModeConfig(raw) {
         return 'shared';
     return undefined;
 }
+function normalizeContentTriggerScope(raw) {
+    if (typeof raw !== 'string')
+        return undefined;
+    const v = raw.trim().toLowerCase();
+    if (v === 'both' || v === 'all')
+        return 'both';
+    if (v === 'topic' || v === 'thread' || v === 'topic-group' || v === 'topic_group')
+        return 'topic';
+    if (v === 'regulargroup' || v === 'regular-group' || v === 'regular_group' || v === 'group')
+        return 'regularGroup';
+    return undefined;
+}
+function normalizeNonNegativeInt(raw) {
+    if (typeof raw !== 'number')
+        return undefined;
+    if (!Number.isInteger(raw) || raw < 0)
+        return undefined;
+    return raw;
+}
+function normalizeSummaryRange(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw))
+        return undefined;
+    const entry = raw;
+    const out = {};
+    const limit = normalizeNonNegativeInt(entry.limit);
+    const sinceHours = normalizeNonNegativeInt(entry.sinceHours);
+    if (limit !== undefined)
+        out.limit = limit;
+    if (sinceHours !== undefined)
+        out.sinceHours = sinceHours;
+    return Object.keys(out).length > 0 ? out : undefined;
+}
+function normalizeContentTriggers(raw, botIndex) {
+    if (!Array.isArray(raw))
+        return undefined;
+    const out = [];
+    raw.forEach((item, triggerIndex) => {
+        const loc = `Bot config [${botIndex}] contentTriggers[${triggerIndex}]`;
+        const drop = (reason) => logger.warn(`${loc} ignored: ${reason}`);
+        if (!item || typeof item !== 'object' || Array.isArray(item)) {
+            drop('must be an object');
+            return;
+        }
+        const entry = item;
+        const name = typeof entry.name === 'string' && entry.name.trim()
+            ? entry.name.trim()
+            : `content-trigger-${triggerIndex + 1}`;
+        const enabled = entry.enabled !== false;
+        const scope = normalizeContentTriggerScope(entry.scope);
+        if (!scope) {
+            drop(`invalid scope ${JSON.stringify(entry.scope)}`);
+            return;
+        }
+        const matchRaw = entry.match;
+        if (!matchRaw || typeof matchRaw !== 'object' || Array.isArray(matchRaw)) {
+            drop('match must be an object');
+            return;
+        }
+        const match = matchRaw;
+        const type = match.type === 'keyword' || match.type === 'regex' ? match.type : undefined;
+        if (!type) {
+            drop(`invalid match.type ${JSON.stringify(match.type)}`);
+            return;
+        }
+        const pattern = typeof match.pattern === 'string' ? match.pattern : '';
+        if (!pattern) {
+            drop('match.pattern must be a non-empty string');
+            return;
+        }
+        const caseSensitive = match.caseSensitive === true;
+        if (type === 'regex') {
+            try {
+                // Validate only. Runtime recompiles defensively in case an in-memory
+                // config is mutated after startup.
+                new RegExp(pattern, caseSensitive ? 'u' : 'iu');
+            }
+            catch (err) {
+                drop(`invalid regex ${JSON.stringify(pattern)} (${err instanceof Error ? err.message : String(err)})`);
+                return;
+            }
+        }
+        const actionRaw = entry.action;
+        if (!actionRaw || typeof actionRaw !== 'object' || Array.isArray(actionRaw)) {
+            drop('action must be an object');
+            return;
+        }
+        const action = actionRaw;
+        if (action.type !== 'start-or-wake-session') {
+            drop(`invalid action.type ${JSON.stringify(action.type)}`);
+            return;
+        }
+        const prompt = typeof action.prompt === 'string' ? action.prompt.trim() : '';
+        if (!prompt) {
+            drop('action.prompt must be a non-empty string');
+            return;
+        }
+        const historyRaw = entry.history && typeof entry.history === 'object' && !Array.isArray(entry.history)
+            ? entry.history
+            : {};
+        const topicRaw = historyRaw.topic && typeof historyRaw.topic === 'object' && !Array.isArray(historyRaw.topic)
+            ? historyRaw.topic
+            : {};
+        const regularRaw = historyRaw.regularGroup && typeof historyRaw.regularGroup === 'object' && !Array.isArray(historyRaw.regularGroup)
+            ? historyRaw.regularGroup
+            : {};
+        const topicMode = topicRaw.mode === undefined || topicRaw.mode === 'current-thread'
+            ? 'current-thread'
+            : undefined;
+        if (!topicMode) {
+            drop(`invalid history.topic.mode ${JSON.stringify(topicRaw.mode)}`);
+            return;
+        }
+        const regularMode = regularRaw.mode === undefined || regularRaw.mode === 'recent-messages'
+            ? 'recent-messages'
+            : undefined;
+        if (!regularMode) {
+            drop(`invalid history.regularGroup.mode ${JSON.stringify(regularRaw.mode)}`);
+            return;
+        }
+        const limit = regularRaw.limit === undefined ? 50 : normalizeNonNegativeInt(regularRaw.limit);
+        if (limit === undefined) {
+            drop(`invalid history.regularGroup.limit ${JSON.stringify(regularRaw.limit)}`);
+            return;
+        }
+        const sinceHours = regularRaw.sinceHours === undefined ? undefined : normalizeNonNegativeInt(regularRaw.sinceHours);
+        if (regularRaw.sinceHours !== undefined && sinceHours === undefined) {
+            drop(`invalid history.regularGroup.sinceHours ${JSON.stringify(regularRaw.sinceHours)}`);
+            return;
+        }
+        out.push({
+            name,
+            enabled,
+            scope,
+            ...(entry.allowBotMessages === true ? { allowBotMessages: true } : {}),
+            match: { type, pattern, caseSensitive },
+            history: {
+                topic: { mode: 'current-thread' },
+                regularGroup: {
+                    mode: 'recent-messages',
+                    limit,
+                    sinceHours,
+                },
+            },
+            action: { type: 'start-or-wake-session', prompt },
+        });
+    });
+    return out.length > 0 ? out : undefined;
+}
 const bots = new Map();
+export function __testOnly_resetBotRegistry() {
+    bots.clear();
+    loadedConfigPath = undefined;
+    oncallChatCache = null;
+    brandLabelCache = null;
+}
 // Wire the i18n lookup so `localeForBot()` can resolve per-bot locale without
 // a hard import cycle between `i18n` and `bot-registry`.
 setBotLookup((id) => bots.get(id));
@@ -480,6 +634,8 @@ export function parseBotConfigsFromText(jsonText) {
         const sanitizedEnv = sanitizePerBotEnv(entry.env);
         const env = Object.keys(sanitizedEnv).length > 0 ? sanitizedEnv : undefined;
         const skills = readBotSkillPolicy(entry.skills);
+        const summaryRange = normalizeSummaryRange(entry.summaryRange ?? entry.summary);
+        const contentTriggers = normalizeContentTriggers(entry.contentTriggers, i);
         // voice：per-bot 语音引擎覆盖。结构化保留（engine ∈ sami|openai，sami/openai
         // 为对象，speaker/rate 透传）；非对象或 engine 非法 → undefined。深度校验
         // （凭证是否可用）在 resolveVoiceConfig 做，这里只挡明显垃圾。
@@ -589,14 +745,19 @@ export function parseBotConfigsFromText(jsonText) {
                 const mode = normalizeChatReplyModeConfig(entry.regularGroupReplyMode);
                 return mode === 'new-topic' || mode === 'shared' || mode === 'chat-topic' ? mode : undefined;
             })(),
-            // 3-tier @ policy. Only 'topic' | 'never' are meaningful; 'always' (the
-            // default) and anything else normalize to undefined so bots.json stays clean.
-            regularGroupMentionMode: entry.regularGroupMentionMode === 'topic' || entry.regularGroupMentionMode === 'never'
+            // 4-tier @ policy. Only 'topic' | 'never' | 'ambient' are meaningful;
+            // 'always' (the default) and anything else normalize to undefined so
+            // bots.json stays clean.
+            regularGroupMentionMode: entry.regularGroupMentionMode === 'topic'
+                || entry.regularGroupMentionMode === 'never'
+                || entry.regularGroupMentionMode === 'ambient'
                 ? entry.regularGroupMentionMode
                 : undefined,
             // 文档订阅默认触发范围。只 'all' 有意义；'mention-only'（默认）归一化为
             // undefined 让 bots.json 保持干净。
             docSubscribeDefaultMode: entry.docSubscribeDefaultMode === 'all' ? 'all' : undefined,
+            summaryRange,
+            contentTriggers,
             voice,
         });
     }