botmux 2.63.1 → 2.65.0

package/dist/services/bot-config-store.js

@@ -0,0 +1,241 @@
+import { getBot } from '../bot-registry.js';
+import { rmwBotEntry } from './config-store.js';
+import { resolveAllowedUsersWithMap } from '../im/lark/client.js';
+import { CLI_OPTIONS, resolveCliId } from '../setup/bot-config-editor.js';
+import { expandHomePath } from '../utils/working-dir.js';
+import { resolveTeamRoleFile } from '../core/role-resolver.js';
+import { statSync } from 'node:fs';
+import { logger } from '../utils/logger.js';
+/**
+ * Phase 1 可编辑的运营字段。**不含** allowedUsers 之外的权限字段、secret、brand
+ * （绑定租户、需重启重建 client）、name（pm2 进程名，启动期绑定）。allowedUsers
+ * 在此登记但走 {@link setBotAllowedUsers} 的专用异步路径（重解析 + 防自锁）。
+ */
+export const CONFIG_FIELDS = [
+    { key: 'model', configKey: 'model', kind: 'string', effect: 'next-session', clearable: true, hint: 'CLI 模型名（如 opus）；unset 回 CLI 默认' },
+    { key: 'cli', configKey: 'cliId', kind: 'cli', effect: 'next-session', clearable: false, hint: 'CLI 适配器（序号 1-16 或 id，如 claude-code）' },
+    { key: 'lang', configKey: 'lang', kind: 'enum', effect: 'immediate', clearable: true, enumValues: ['zh', 'en'], hint: '机器人 UI 语言 zh|en；unset 回全局默认' },
+    { key: 'defaultWorkingDir', configKey: 'defaultWorkingDir', kind: 'dir', effect: 'next-session', clearable: true, hint: '新话题默认工作目录（跳过仓库选择卡片）' },
+    { key: 'brandLabel', configKey: 'brandLabel', kind: 'string', effect: 'immediate', clearable: true, hint: '卡片页脚品牌文案；unset 回默认 botmux 链接' },
+    { key: 'autoStartPrompt', configKey: 'autoStartOnGroupJoinPrompt', kind: 'string', effect: 'immediate', clearable: true, hint: '被拉进新群主动开工的首轮 prompt（配合 autoStartOnGroupJoin）' },
+    { key: 'allowedUsers', configKey: 'allowedUsers', kind: 'allowedUsers', effect: 'immediate', clearable: false, hint: '管理员名单（邮箱/on_/ou_，逗号或空格分隔）；改后需加 确认' },
+    { key: 'disableStreamingCard', configKey: 'disableStreamingCard', kind: 'boolean', effect: 'immediate', clearable: false, hint: '关闭实时流式卡片 on|off' },
+    { key: 'writableTerminalLinkInCard', configKey: 'writableTerminalLinkInCard', kind: 'boolean', effect: 'immediate', clearable: false, hint: '卡片内嵌可写终端链接 on|off' },
+    { key: 'privateCard', configKey: 'privateCard', kind: 'boolean', effect: 'immediate', clearable: false, hint: '/card 发 owner-only 私有快照 on|off' },
+    { key: 'autoStartOnGroupJoin', configKey: 'autoStartOnGroupJoin', kind: 'boolean', effect: 'immediate', clearable: false, hint: '被拉进新群即主动开工 on|off' },
+    { key: 'autoStartOnNewTopic', configKey: 'autoStartOnNewTopic', kind: 'boolean', effect: 'immediate', clearable: false, hint: '话题群每个新话题自动开工 on|off' },
+    { key: 'disableCliBypass', configKey: 'disableCliBypass', kind: 'boolean', effect: 'next-session', clearable: false, hint: '不加 CLI 审批/sandbox 绕过参数 on|off' },
+    { key: 'restrictGrantCommands', configKey: 'restrictGrantCommands', kind: 'boolean', effect: 'immediate', clearable: false, hint: '被授权人仅能纯对话、拦截斜杠命令 on|off' },
+    { key: 'p2pMode', configKey: 'p2pMode', kind: 'enum', effect: 'immediate', clearable: true, enumValues: ['thread', 'chat'], hint: '私聊单聊模式 thread|chat；chat=扁平连续会话，thread/unset 回默认（每条 DM 独立会话）' },
+];
+/** 大小写不敏感地按 key 找字段 spec。 */
+export function findConfigField(key) {
+    const k = key.trim().toLowerCase();
+    return CONFIG_FIELDS.find(f => f.key.toLowerCase() === k);
+}
+/** 可设置字段名列表（用于报错提示 / help）。 */
+export function settableFieldKeys() {
+    return CONFIG_FIELDS.map(f => f.key);
+}
+/** 把 on/off 类输入解析成布尔，无法识别 → undefined。 */
+export function parseBooleanValue(raw) {
+    const v = raw.trim().toLowerCase();
+    if (['on', 'true', '1', 'yes', 'y', 'enable', 'enabled', '开', '是'].includes(v))
+        return true;
+    if (['off', 'false', '0', 'no', 'n', 'disable', 'disabled', '关', '否'].includes(v))
+        return false;
+    return undefined;
+}
+/** 展示某字段当前值的人类可读文本。 */
+function formatFieldValue(spec, value) {
+    if (spec.kind === 'boolean')
+        return value === true ? 'on' : 'off';
+    if (spec.kind === 'allowedUsers') {
+        const arr = Array.isArray(value) ? value : [];
+        return arr.length ? arr.join(', ') : '∅';
+    }
+    if (value === undefined || value === null || value === '')
+        return '∅';
+    return String(value);
+}
+/** 当前可编辑字段的快照（供 `/config get`）。不含 secret。 */
+export function getConfigSnapshot(larkAppId) {
+    let bot;
+    try {
+        bot = getBot(larkAppId);
+    }
+    catch {
+        return { ok: false };
+    }
+    const cfg = bot.config;
+    const rows = CONFIG_FIELDS.map(spec => ({
+        key: spec.key,
+        value: formatFieldValue(spec, cfg[spec.configKey]),
+        effect: spec.effect,
+    }));
+    return {
+        ok: true,
+        rows,
+        info: {
+            cliId: cfg.cliId,
+            brand: cfg.brand ?? 'feishu',
+            resolvedAdmins: bot.resolvedAllowedUsers.length,
+            workingDirs: cfg.workingDirs ?? (cfg.workingDir ? [cfg.workingDir] : []),
+        },
+    };
+}
+/**
+ * 写入并热更新一个**已解析**的字段值（string / boolean / null=清除）。
+ * 调用方负责按 kind 校验后再传值；本函数只负责落盘 + 同步内存。
+ * 不处理 allowedUsers（异步，见 {@link setBotAllowedUsers}）。
+ */
+export async function applyConfigField(larkAppId, spec, value) {
+    if (spec.kind === 'allowedUsers')
+        return { ok: false, reason: 'use_setBotAllowedUsers' };
+    let bot;
+    try {
+        bot = getBot(larkAppId);
+    }
+    catch {
+        return { ok: false, reason: 'bot_not_registered' };
+    }
+    const oldText = formatFieldValue(spec, bot.config[spec.configKey]);
+    const r = await rmwBotEntry(larkAppId, (entry) => {
+        if (value === null) {
+            delete entry[spec.configKey];
+        }
+        else if (spec.kind === 'boolean') {
+            // 与 parseBotConfigsFromText 一致：true 才写，false → 删 key（bots.json 保持干净）。
+            if (value === true)
+                entry[spec.configKey] = true;
+            else
+                delete entry[spec.configKey];
+        }
+        else {
+            entry[spec.configKey] = value;
+        }
+        return { write: true, result: null };
+    });
+    if (!r.ok)
+        return { ok: false, reason: r.reason };
+    // 同步内存 config（与 oncall/grant-prefs store 一致，路由/spawn 不重启即生效）。
+    if (value === null) {
+        bot.config[spec.configKey] = undefined;
+    }
+    else if (spec.kind === 'boolean') {
+        bot.config[spec.configKey] = value || undefined;
+    }
+    else {
+        bot.config[spec.configKey] = value;
+    }
+    const newText = formatFieldValue(spec, bot.config[spec.configKey]);
+    logger.info(`[config:${larkAppId}] set ${spec.key}: ${oldText} -> ${newText}`);
+    return { ok: true, oldText, newText, effect: spec.effect };
+}
+/**
+ * 改 allowedUsers（管理员名单）。这是动信任根的敏感操作，与普通字段分开：
+ *   1. 用 bot 凭证把邮箱/on_ 解析成 open_id（与启动期同一路径）。
+ *   2. **防自锁**：解析后名单必须仍含发起人的 open_id，否则拒绝——避免把自己踢出管理员。
+ *   3. 解析后非空才写。
+ *   4. 落盘原始条目（邮箱/on_/ou_，与 setup 一致），并同步内存 resolvedAllowedUsers /
+ *      rawAllowedUserResolution（与 daemon 启动期赋值同口径），无需重启。
+ *
+ * confirm 二次确认由调用方（command-handler）处理，本函数只做校验 + 落盘。
+ */
+export async function setBotAllowedUsers(larkAppId, rawEntries, senderOpenId) {
+    let bot;
+    try {
+        bot = getBot(larkAppId);
+    }
+    catch {
+        return { ok: false, reason: 'bot_not_registered' };
+    }
+    const { resolved, map } = await resolveAllowedUsersWithMap(larkAppId, rawEntries);
+    if (resolved.length === 0)
+        return { ok: false, reason: 'empty_resolved' };
+    if (senderOpenId && !resolved.includes(senderOpenId))
+        return { ok: false, reason: 'self_lockout' };
+    const r = await rmwBotEntry(larkAppId, (entry) => {
+        entry.allowedUsers = rawEntries;
+        return { write: true, result: null };
+    });
+    if (!r.ok)
+        return { ok: false, reason: r.reason };
+    bot.config.allowedUsers = rawEntries;
+    bot.resolvedAllowedUsers = resolved;
+    bot.rawAllowedUserResolution = map;
+    logger.info(`[config:${larkAppId}] allowedUsers updated: ${rawEntries.length} entries, ${resolved.length} resolved`);
+    return { ok: true, raw: rawEntries, resolved };
+}
+/**
+ * 把一个**原始**字段值（来自卡片下拉/输入或别处）按字段 kind 解析校验成可落盘的
+ * string|boolean。dir 在此做存在性检查（无 locale，返回结构化 reason，调用方再本地化）。
+ * allowedUsers 不走这里（异步，见 {@link setBotAllowedUsers}）。
+ */
+export function coerceConfigValue(spec, raw) {
+    if (spec.kind === 'boolean') {
+        if (typeof raw === 'boolean')
+            return { ok: true, value: raw };
+        const b = parseBooleanValue(String(raw ?? ''));
+        return b === undefined ? { ok: false, reason: 'invalid_bool' } : { ok: true, value: b };
+    }
+    const s = String(raw ?? '').trim();
+    if (!s)
+        return { ok: false, reason: 'empty' };
+    switch (spec.kind) {
+        case 'enum':
+            return spec.enumValues?.includes(s.toLowerCase())
+                ? { ok: true, value: s.toLowerCase() }
+                : { ok: false, reason: 'invalid_enum' };
+        case 'cli': {
+            try {
+                const id = resolveCliId(s);
+                return id ? { ok: true, value: id } : { ok: false, reason: 'invalid_cli' };
+            }
+            catch {
+                return { ok: false, reason: 'invalid_cli' };
+            }
+        }
+        case 'dir': {
+            try {
+                if (statSync(expandHomePath(s)).isDirectory())
+                    return { ok: true, value: s };
+            }
+            catch { /* not a dir */ }
+            return { ok: false, reason: 'invalid_dir' };
+        }
+        default: // 'string'
+            return { ok: true, value: s };
+    }
+}
+export function getConfigCardData(larkAppId, modelChoices = []) {
+    let bot;
+    try {
+        bot = getBot(larkAppId);
+    }
+    catch {
+        return null;
+    }
+    const cfg = bot.config;
+    const q = cfg.messageQuota?.defaultLimit;
+    return {
+        larkAppId,
+        botName: bot.botName ?? cfg.cliId,
+        cliId: cfg.cliId,
+        cliOptions: CLI_OPTIONS.map(o => ({ id: o.id, label: o.label })),
+        model: cfg.model ?? null,
+        modelChoices: [...modelChoices],
+        lang: cfg.lang ?? null,
+        p2pMode: cfg.p2pMode ?? null,
+        brandLabel: cfg.brandLabel ?? null,
+        defaultWorkingDir: cfg.defaultWorkingDir ?? null,
+        autoStartPrompt: cfg.autoStartOnGroupJoinPrompt ?? null,
+        teamRole: resolveTeamRoleFile(larkAppId),
+        quota: typeof q === 'number' && Number.isInteger(q) && q > 0 ? q : null,
+        admins: bot.resolvedAllowedUsers.length,
+        booleans: CONFIG_FIELDS.filter(f => f.kind === 'boolean').map(f => ({
+            key: f.key, on: cfg[f.configKey] === true,
+        })),
+    };
+}
+//# sourceMappingURL=bot-config-store.js.map

package/dist/services/bot-config-store.js.map

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

package/dist/services/card-prefs-store.d.ts

@@ -1,3 +1,4 @@
+import { type ChatReplyMode } from '../bot-registry.js';
 export interface BotCardPrefs {
     disableStreamingCard: boolean;
     writableTerminalLinkInCard: boolean;
@@ -8,6 +9,10 @@ export interface BotCardPrefs {
     autoStartOnGroupJoinPrompt: string;
     /** 主动开工 — 场景②: auto-start on every new topic in a topic group. */
     autoStartOnNewTopic: boolean;
+    /** Per-bot DEFAULT regular-group session mode (chat | new-topic | shared). */
+    regularGroupReplyMode: ChatReplyMode;
+    /** Per-bot 3-tier @-requirement policy for regular groups (default 'always'). */
+    regularGroupMentionMode: 'always' | 'topic' | 'never';
 }
 /** Current card prefs for a bot (booleans default false, prompt defaults '' when unset). */
 export declare function getBotCardPrefs(larkAppId: string): BotCardPrefs;

package/dist/services/card-prefs-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"card-prefs-store.d.ts","sourceRoot":"","sources":["../../src/services/card-prefs-store.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,0BAA0B,EAAE,OAAO,CAAC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,0BAA0B,EAAE,MAAM,CAAC;IACnC,kEAAkE;IAClE,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAqB/D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAgE5E"}
+{"version":3,"file":"card-prefs-store.d.ts","sourceRoot":"","sources":["../../src/services/card-prefs-store.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGhE,MAAM,WAAW,YAAY;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,0BAA0B,EAAE,OAAO,CAAC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,2EAA2E;IAC3E,oBAAoB,EAAE,OAAO,CAAC;IAC9B,wEAAwE;IACxE,0BAA0B,EAAE,MAAM,CAAC;IACnC,kEAAkE;IAClE,mBAAmB,EAAE,OAAO,CAAC;IAC7B,8EAA8E;IAC9E,qBAAqB,EAAE,aAAa,CAAC;IACrC,iFAAiF;IACjF,uBAAuB,EAAE,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;CACvD;AAED,4FAA4F;AAC5F,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CA0B/D;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC3B,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiG5E"}

package/dist/services/card-prefs-store.js

@@ -11,6 +11,9 @@
  *   • privateCard               — `/card` sends a private ephemeral snapshot
  *                                  (visible to the talk-grant audience) instead
  *                                  of the group-visible live card
+ *   • regularGroupReplyMode     — per-bot DEFAULT session mode for regular
+ *                                  groups: chat | new-topic | shared (see
+ *                                  chat-reply-mode-store). Default 'chat'.
  */
 import { rmwBotEntry } from './config-store.js';
 import { getBot } from '../bot-registry.js';
@@ -26,6 +29,9 @@ export function getBotCardPrefs(larkAppId) {
             autoStartOnGroupJoin: c.autoStartOnGroupJoin === true,
             autoStartOnGroupJoinPrompt: typeof c.autoStartOnGroupJoinPrompt === 'string' ? c.autoStartOnGroupJoinPrompt : '',
             autoStartOnNewTopic: c.autoStartOnNewTopic === true,
+            regularGroupReplyMode: c.regularGroupReplyMode ?? 'chat',
+            regularGroupMentionMode: c.regularGroupMentionMode === 'topic' || c.regularGroupMentionMode === 'never'
+                ? c.regularGroupMentionMode : 'always',
         };
     }
     catch {
@@ -36,6 +42,8 @@ export function getBotCardPrefs(larkAppId) {
             autoStartOnGroupJoin: false,
             autoStartOnGroupJoinPrompt: '',
             autoStartOnNewTopic: false,
+            regularGroupReplyMode: 'chat',
+            regularGroupMentionMode: 'always',
         };
     }
 }
@@ -70,6 +78,26 @@ export async function updateBotCardPrefs(larkAppId, patch) {
         else
             delete entry[key];
     };
+    // Regular-group default mode: store only the non-default modes; 'chat' (the
+    // default) drops the key so bots.json stays tidy (absent === 'chat').
+    const applyMode = (entry, key, val) => {
+        if (val === undefined)
+            return;
+        if (val === 'new-topic' || val === 'shared')
+            entry[key] = val;
+        else
+            delete entry[key];
+    };
+    // 3-tier @ policy: store only the non-default tiers; 'always' (default) drops
+    // the key so bots.json stays tidy (absent === 'always').
+    const applyMention = (entry, key, val) => {
+        if (val === undefined)
+            return;
+        if (val === 'topic' || val === 'never')
+            entry[key] = val;
+        else
+            delete entry[key];
+    };
     const r = await rmwBotEntry(larkAppId, (entry) => {
         apply(entry, 'disableStreamingCard', patch.disableStreamingCard);
         apply(entry, 'writableTerminalLinkInCard', patch.writableTerminalLinkInCard);
@@ -77,6 +105,8 @@ export async function updateBotCardPrefs(larkAppId, patch) {
         apply(entry, 'autoStartOnGroupJoin', patch.autoStartOnGroupJoin);
         applyStr(entry, 'autoStartOnGroupJoinPrompt', patch.autoStartOnGroupJoinPrompt);
         apply(entry, 'autoStartOnNewTopic', patch.autoStartOnNewTopic);
+        applyMode(entry, 'regularGroupReplyMode', patch.regularGroupReplyMode);
+        applyMention(entry, 'regularGroupMentionMode', patch.regularGroupMentionMode);
         return {
             write: true,
             result: {
@@ -86,6 +116,12 @@ export async function updateBotCardPrefs(larkAppId, patch) {
                 autoStartOnGroupJoin: entry.autoStartOnGroupJoin === true,
                 autoStartOnGroupJoinPrompt: typeof entry.autoStartOnGroupJoinPrompt === 'string' ? entry.autoStartOnGroupJoinPrompt : '',
                 autoStartOnNewTopic: entry.autoStartOnNewTopic === true,
+                regularGroupReplyMode: (entry.regularGroupReplyMode === 'new-topic' || entry.regularGroupReplyMode === 'shared')
+                    ? entry.regularGroupReplyMode
+                    : 'chat',
+                regularGroupMentionMode: (entry.regularGroupMentionMode === 'topic' || entry.regularGroupMentionMode === 'never')
+                    ? entry.regularGroupMentionMode
+                    : 'always',
             },
         };
     });
@@ -110,9 +146,20 @@ export async function updateBotCardPrefs(larkAppId, patch) {
     if (patch.autoStartOnNewTopic !== undefined) {
         bot.config.autoStartOnNewTopic = patch.autoStartOnNewTopic || undefined;
     }
+    if (patch.regularGroupReplyMode !== undefined) {
+        bot.config.regularGroupReplyMode = (patch.regularGroupReplyMode === 'new-topic' || patch.regularGroupReplyMode === 'shared')
+            ? patch.regularGroupReplyMode
+            : undefined;
+    }
+    if (patch.regularGroupMentionMode !== undefined) {
+        bot.config.regularGroupMentionMode = (patch.regularGroupMentionMode === 'topic' || patch.regularGroupMentionMode === 'never')
+            ? patch.regularGroupMentionMode
+            : undefined;
+    }
     logger.info(`[card-prefs:${larkAppId}] disableStreamingCard=${r.result.disableStreamingCard} ` +
         `writableTerminalLinkInCard=${r.result.writableTerminalLinkInCard} privateCard=${r.result.privateCard} ` +
         `autoStartOnGroupJoin=${r.result.autoStartOnGroupJoin} autoStartOnNewTopic=${r.result.autoStartOnNewTopic} ` +
+        `regularGroupReplyMode=${r.result.regularGroupReplyMode} regularGroupMentionMode=${r.result.regularGroupMentionMode} ` +
         `autoStartOnGroupJoinPrompt.len=${r.result.autoStartOnGroupJoinPrompt.length}`);
     return { ok: true, prefs: r.result };
 }

package/dist/services/card-prefs-store.js.map

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

package/dist/services/chat-reply-mode-store.d.ts

@@ -0,0 +1,28 @@
+import { type ChatReplyMode } from '../bot-registry.js';
+export type { ChatReplyMode } from '../bot-registry.js';
+export declare function normalizeChatReplyMode(raw: string | undefined): ChatReplyMode | undefined;
+/** Short command-word label for status / confirmation messages. */
+export declare function replyModeLabel(mode: ChatReplyMode): 'chat' | 'topic' | 'shared';
+export type GroupMentionMode = 'always' | 'topic' | 'never';
+/**
+ * Per-bot (bot-global) @-requirement policy for regular groups, default 'always'.
+ *   • always — @ required everywhere (incl. inside shared topics).
+ *   • topic  — @ required at top level, but non-@ continues inside shared topics.
+ *   • never  — non-@ messages are answered too (where the bot has talk access).
+ */
+export declare function resolveGroupMentionMode(larkAppId: string): GroupMentionMode;
+/**
+ * Effective regular-group reply mode for a chat — the SINGLE source of truth for
+ * routing. Per-chat override first, then the per-bot default. Both the
+ * `regularGroupRouting` (new-topic) and `maybeApplySharedTopicSeed` (shared)
+ * code paths read this, so they are mutually exclusive by construction.
+ */
+export declare function resolveRegularGroupMode(larkAppId: string, chatId: string | undefined): ChatReplyMode;
+export declare function setChatReplyMode(larkAppId: string, chatId: string, mode: ChatReplyMode): Promise<{
+    ok: true;
+    mode: ChatReplyMode;
+} | {
+    ok: false;
+    reason: string;
+}>;
+//# sourceMappingURL=chat-reply-mode-store.d.ts.map

package/dist/services/chat-reply-mode-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-reply-mode-store.d.ts","sourceRoot":"","sources":["../../src/services/chat-reply-mode-store.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAU,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGhE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,GAAG,SAAS,CAOzF;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAE/E;AAWD,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,OAAO,GAAG,OAAO,CAAC;AAE5D;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAO3E;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAMpG;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CA8B5E"}

package/dist/services/chat-reply-mode-store.js

@@ -0,0 +1,115 @@
+/**
+ * Per-chat reply mode for regular groups, layered over the per-bot default.
+ *
+ * Three modes (tri-state) — unifies #116 + #131 into one knob so a chat resolves
+ * to EXACTLY ONE mode and the two thread-reply mechanisms can never compete:
+ *   • chat        — flat chat-scope replies in the group (default).
+ *   • new-topic   — each top-level @mention opens a fresh thread-scope session
+ *                   under the trigger (its own worker/cwd/context). This is the
+ *                   per-bot fork behavior from #116.
+ *   • shared      — 话题模式但复用同一个 session: reuse the bot's existing
+ *                   chat-scope session/worker/cwd, but route this turn's reply
+ *                   into the trigger message's thread (#131).
+ *
+ * Resolution: per-chat override (`chatReplyModes[chatId]`) wins; otherwise fall
+ * back to the per-bot default (`regularGroupReplyMode`, default 'chat'). The
+ * setting is bot-scoped: Bot A can prefer topic replies in one group while Bot B
+ * or another group stays flat.
+ */
+import { rmwBotEntry } from './config-store.js';
+import { getBot } from '../bot-registry.js';
+import { logger } from '../utils/logger.js';
+export function normalizeChatReplyMode(raw) {
+    const v = raw?.trim().toLowerCase();
+    if (!v || v === 'status')
+        return undefined;
+    if (v === 'chat')
+        return 'chat';
+    if (v === 'topic' || v === 'new-topic' || v === 'newtopic' || v === 'thread')
+        return 'new-topic';
+    if (v === 'shared' || v === 'share' || v === 'alias' || v === 'topic-alias' || v === 'topic_alias')
+        return 'shared';
+    return undefined;
+}
+/** Short command-word label for status / confirmation messages. */
+export function replyModeLabel(mode) {
+    return mode === 'new-topic' ? 'topic' : mode === 'shared' ? 'shared' : 'chat';
+}
+/** Per-bot default regular-group mode (`regularGroupReplyMode`, default 'chat'). */
+function regularGroupDefaultMode(larkAppId) {
+    try {
+        return getBot(larkAppId).config.regularGroupReplyMode ?? 'chat';
+    }
+    catch {
+        return 'chat';
+    }
+}
+/**
+ * Per-bot (bot-global) @-requirement policy for regular groups, default 'always'.
+ *   • always — @ required everywhere (incl. inside shared topics).
+ *   • topic  — @ required at top level, but non-@ continues inside shared topics.
+ *   • never  — non-@ messages are answered too (where the bot has talk access).
+ */
+export function resolveGroupMentionMode(larkAppId) {
+    try {
+        const m = getBot(larkAppId).config.regularGroupMentionMode;
+        return m === 'topic' || m === 'never' ? m : 'always';
+    }
+    catch {
+        return 'always';
+    }
+}
+/**
+ * Effective regular-group reply mode for a chat — the SINGLE source of truth for
+ * routing. Per-chat override first, then the per-bot default. Both the
+ * `regularGroupRouting` (new-topic) and `maybeApplySharedTopicSeed` (shared)
+ * code paths read this, so they are mutually exclusive by construction.
+ */
+export function resolveRegularGroupMode(larkAppId, chatId) {
+    try {
+        const perChat = chatId ? getBot(larkAppId).config.chatReplyModes?.[chatId] : undefined;
+        if (perChat)
+            return perChat;
+    }
+    catch { /* fall through to default */ }
+    return regularGroupDefaultMode(larkAppId);
+}
+export async function setChatReplyMode(larkAppId, chatId, mode) {
+    let bot;
+    try {
+        bot = getBot(larkAppId);
+    }
+    catch {
+        return { ok: false, reason: 'bot_not_registered' };
+    }
+    // Persist only when the per-chat mode differs from the per-bot default, so
+    // bots.json stays tidy in the common default-off case while an explicit
+    // opt-out (e.g. per-bot default new-topic, this chat pinned back to chat)
+    // still sticks instead of being silently dropped.
+    const redundant = mode === regularGroupDefaultMode(larkAppId);
+    const r = await rmwBotEntry(larkAppId, (entry) => {
+        if (!entry.chatReplyModes || typeof entry.chatReplyModes !== 'object' || Array.isArray(entry.chatReplyModes)) {
+            entry.chatReplyModes = {};
+        }
+        if (redundant) {
+            delete entry.chatReplyModes[chatId];
+            if (Object.keys(entry.chatReplyModes).length === 0)
+                delete entry.chatReplyModes;
+        }
+        else {
+            entry.chatReplyModes[chatId] = mode;
+        }
+        return { write: true, result: mode };
+    });
+    if (!r.ok)
+        return { ok: false, reason: r.reason };
+    const next = { ...(bot.config.chatReplyModes ?? {}) };
+    if (redundant)
+        delete next[chatId];
+    else
+        next[chatId] = mode;
+    bot.config.chatReplyModes = Object.keys(next).length > 0 ? next : undefined;
+    logger.info(`[reply-mode:${larkAppId}] chat=${chatId} mode=${mode}`);
+    return { ok: true, mode };
+}
+//# sourceMappingURL=chat-reply-mode-store.js.map

package/dist/services/chat-reply-mode-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-reply-mode-store.js","sourceRoot":"","sources":["../../src/services/chat-reply-mode-store.ts"],"names":[],"mappings":"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"}

package/dist/services/groups-store.d.ts

@@ -4,6 +4,8 @@ export interface ChatBrief {
     description?: string;
     chatMode?: string;
     ownerId?: string;
+    /** 群头像 URL（/open-apis/im/v1/chats 的 avatar 字段）。 */
+    avatar?: string;
 }
 /**
  * List chats the given bot is a member of, draining pagination internally.

package/dist/services/groups-store.d.ts.map

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

package/dist/services/groups-store.js

@@ -36,6 +36,7 @@ export async function listChats(larkAppId) {
                 description: c.description,
                 chatMode: c.chat_mode,
                 ownerId: c.owner_id,
+                avatar: c.avatar,
             });
         }
         pageToken = res.data?.has_more ? res.data?.page_token : undefined;