botmux 2.14.0 → 2.16.0

package/dist/setup/ensure-fonts.js

@@ -0,0 +1,225 @@
+/**
+ * Ensure the screenshot-renderer (`@napi-rs/canvas`) has CJK / Latin / emoji
+ * fonts available. Downloads missing categories from GitHub release
+ * artifacts to `~/.botmux/fonts/` so registration (`GlobalFonts.registerFromPath`)
+ * can find them at runtime.
+ *
+ * macOS is skipped entirely — PingFang + Menlo + Apple Color Emoji are
+ * preinstalled.
+ *
+ * Failures are NOT fatal: missing fonts only degrade the screenshot rendered
+ * for Lark (CJK becomes tofu, emoji becomes monochrome). The daemon should
+ * still come up. Tmux is the load-bearing dep, fonts are nice-to-have.
+ */
+import { existsSync, mkdirSync, createWriteStream, statSync, unlinkSync, renameSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { get as httpsGet } from 'node:https';
+import { detectPlatform } from './detect-platform.js';
+const FONT_DIR = join(homedir(), '.botmux', 'fonts');
+/** Download targets — pinned to specific release tags so the URLs don't rot.
+ *
+ *  Sources (all permissive licenses, GitHub-hosted):
+ *  - notofonts/noto-cjk @ Sans2.004 (Mono variant) — OFL
+ *  - JetBrains/JetBrainsMono @ v2.304 — Apache 2.0 (replaces DejaVu since
+ *    DejaVu only ships .tar.bz2 release artifacts, not individual TTFs)
+ *  - googlefonts/noto-emoji @ v2.047 — OFL
+ */
+const FONT_SPECS = [
+    {
+        category: 'CJK',
+        files: [
+            {
+                name: 'NotoSansMonoCJKsc-Regular.otf',
+                url: 'https://github.com/notofonts/noto-cjk/raw/Sans2.004/Sans/Mono/NotoSansMonoCJKsc-Regular.otf',
+                minBytes: 1_000_000,
+            },
+            {
+                name: 'NotoSansMonoCJKsc-Bold.otf',
+                url: 'https://github.com/notofonts/noto-cjk/raw/Sans2.004/Sans/Mono/NotoSansMonoCJKsc-Bold.otf',
+                minBytes: 1_000_000,
+            },
+        ],
+        systemPaths: [
+            '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc',
+            '/usr/share/fonts/noto-cjk/NotoSansCJK-Regular.ttc',
+            '/usr/share/fonts/google-noto-cjk/NotoSansCJK-Regular.ttc',
+            '/usr/share/fonts/opentype/noto/NotoSansMonoCJK-Regular.ttc',
+        ],
+    },
+    {
+        category: 'Latin',
+        files: [
+            {
+                name: 'JetBrainsMono-Regular.ttf',
+                url: 'https://github.com/JetBrains/JetBrainsMono/raw/v2.304/fonts/ttf/JetBrainsMono-Regular.ttf',
+                minBytes: 100_000,
+            },
+            {
+                name: 'JetBrainsMono-Bold.ttf',
+                url: 'https://github.com/JetBrains/JetBrainsMono/raw/v2.304/fonts/ttf/JetBrainsMono-Bold.ttf',
+                minBytes: 100_000,
+            },
+        ],
+        systemPaths: [
+            '/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf',
+            '/usr/share/fonts/dejavu/DejaVuSansMono.ttf',
+            '/usr/share/fonts/truetype/liberation/LiberationMono-Regular.ttf',
+            '/usr/share/fonts/liberation/LiberationMono-Regular.ttf',
+            '/usr/share/fonts/truetype/jetbrains-mono/JetBrainsMono-Regular.ttf',
+        ],
+    },
+    {
+        category: 'Emoji',
+        files: [
+            {
+                name: 'NotoColorEmoji.ttf',
+                url: 'https://github.com/googlefonts/noto-emoji/raw/v2.047/fonts/NotoColorEmoji.ttf',
+                minBytes: 5_000_000,
+            },
+        ],
+        systemPaths: [
+            '/usr/share/fonts/truetype/noto/NotoColorEmoji.ttf',
+            '/usr/share/fonts/noto/NotoColorEmoji.ttf',
+            '/usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf',
+        ],
+    },
+];
+/** Public: paths the screenshot-renderer should also probe. */
+export function botmuxFontDir() {
+    return FONT_DIR;
+}
+function categoryAlreadyOk(spec) {
+    // 1. System path present?
+    if (spec.systemPaths.some(p => existsSync(p)))
+        return true;
+    // 2. We already downloaded it on a prior run?
+    return spec.files.every(f => {
+        const p = join(FONT_DIR, f.name);
+        if (!existsSync(p))
+            return false;
+        try {
+            return statSync(p).size >= f.minBytes;
+        }
+        catch {
+            return false;
+        }
+    });
+}
+/** Download a URL to disk, following redirects (GitHub raw → CDN).
+ *  All FONT_SPECS URLs are https, so we don't bother with an http fallback.
+ *  Hard timeout (default 60s) covers connect + transfer; on expiry the
+ *  request is destroyed and the partial file is unlinked. */
+function downloadFile(url, destPath, timeoutMs = 60_000) {
+    return new Promise((resolve, reject) => {
+        const tmp = destPath + '.part';
+        let settled = false;
+        let activeReq = null;
+        const cleanup = () => {
+            try {
+                unlinkSync(tmp);
+            }
+            catch { /* may not exist */ }
+        };
+        const finish = (err) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (activeReq)
+                try {
+                    activeReq.destroy();
+                }
+                catch { /* ignore */ }
+            if (err) {
+                cleanup();
+                reject(err);
+            }
+            else
+                resolve();
+        };
+        const timer = setTimeout(() => finish(new Error(`下载超时 (${timeoutMs}ms): ${url}`)), timeoutMs);
+        const followRedirect = (current, hops) => {
+            if (hops > 5)
+                return finish(new Error(`太多重定向: ${url}`));
+            const u = new URL(current);
+            if (u.protocol !== 'https:')
+                return finish(new Error(`仅支持 https://, got ${u.protocol} for ${current}`));
+            activeReq = httpsGet(u, { headers: { 'user-agent': 'botmux-font-installer' } }, (res) => {
+                if (res.statusCode && res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+                    res.resume();
+                    followRedirect(new URL(res.headers.location, u).toString(), hops + 1);
+                    return;
+                }
+                if (res.statusCode !== 200) {
+                    res.resume();
+                    return finish(new Error(`HTTP ${res.statusCode} for ${current}`));
+                }
+                const out = createWriteStream(tmp);
+                res.pipe(out);
+                out.on('error', (err) => finish(err));
+                out.on('finish', () => {
+                    out.close(() => {
+                        try {
+                            renameSync(tmp, destPath);
+                            finish();
+                        }
+                        catch (err) {
+                            finish(err);
+                        }
+                    });
+                });
+            });
+            activeReq.on('error', (err) => finish(err));
+        };
+        followRedirect(url, 0);
+    });
+}
+async function downloadCategory(spec) {
+    if (!existsSync(FONT_DIR))
+        mkdirSync(FONT_DIR, { recursive: true });
+    for (const f of spec.files) {
+        const dest = join(FONT_DIR, f.name);
+        // Skip if already present and big enough.
+        try {
+            if (existsSync(dest) && statSync(dest).size >= f.minBytes)
+                continue;
+        }
+        catch { /* fall through to redownload */ }
+        console.log(`   下载 ${spec.category}: ${f.name} ...`);
+        await downloadFile(f.url, dest);
+        const sz = statSync(dest).size;
+        if (sz < f.minBytes) {
+            try {
+                unlinkSync(dest);
+            }
+            catch { /* ignore */ }
+            throw new Error(`${f.name} 下载完毕但大小异常 (${sz} < ${f.minBytes})`);
+        }
+    }
+}
+export async function ensureFonts(info) {
+    const platform = info ?? detectPlatform();
+    const result = { fontDir: FONT_DIR, ready: [], failed: [] };
+    // macOS: skip — system fonts cover everything we need.
+    if (platform.os === 'darwin') {
+        result.ready.push('CJK', 'Latin', 'Emoji');
+        return result;
+    }
+    for (const spec of FONT_SPECS) {
+        if (categoryAlreadyOk(spec)) {
+            result.ready.push(spec.category);
+            continue;
+        }
+        try {
+            await downloadCategory(spec);
+            result.ready.push(spec.category);
+        }
+        catch (err) {
+            console.warn(`⚠️  字体下载失败 [${spec.category}]: ${err?.message ?? err}`);
+            result.failed.push(spec.category);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=ensure-fonts.js.map

package/dist/setup/ensure-fonts.js.map

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

package/dist/setup/ensure-tmux.d.ts

@@ -0,0 +1,11 @@
+import { type PackageManager, type PlatformInfo } from './detect-platform.js';
+export interface TmuxResult {
+    installed: boolean;
+    version?: string;
+    /** True iff we ran an installer (vs. tmux was already present). */
+    freshInstall: boolean;
+    /** Which strategy actually ran the install. */
+    strategy?: PackageManager;
+}
+export declare function ensureTmux(info?: PlatformInfo): Promise<TmuxResult>;
+//# sourceMappingURL=ensure-tmux.d.ts.map

package/dist/setup/ensure-tmux.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ensure-tmux.d.ts","sourceRoot":"","sources":["../../src/setup/ensure-tmux.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAkB,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAE9F,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,YAAY,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AA0ED,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DzE"}

package/dist/setup/ensure-tmux.js

@@ -0,0 +1,151 @@
+/**
+ * Ensure tmux is installed before the daemon starts. Strategy (first one
+ * that fits wins):
+ *
+ *   1. Already installed → done.
+ *   2. brew available → `brew install tmux` (no sudo)
+ *   3. conda/mamba available → `conda install -y -c conda-forge tmux` (no sudo)
+ *   4. Linux + system pkg manager:
+ *        a. NOPASSWD sudo or running as root → run non-interactively
+ *        b. Has TTY → run interactively (sudo will prompt for password)
+ *        c. No TTY (autostart / pm2 fork) → skip and throw with manual command
+ *   5. Otherwise → throw with manual command.
+ *
+ * The caller (cli.ts) treats a thrown error as fatal: tmux is non-negotiable
+ * for the /adopt + multi-pane Web terminal experience, and the user explicitly
+ * opted into hard-fail-on-missing.
+ */
+import { execSync, spawnSync } from 'node:child_process';
+import { detectPlatform } from './detect-platform.js';
+function probeTmuxVersion() {
+    try {
+        const out = execSync('tmux -V', { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'], timeout: 3000 });
+        return out.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Wrap a system command with the appropriate sudo prefix for the current
+ *  platform context, or return undefined if we cannot escalate (no
+ *  passwordless sudo and no TTY to prompt on). */
+function sudoPrefix(cmd, info) {
+    if (info.isRoot)
+        return cmd;
+    if (info.passwordlessSudo)
+        return ['sudo', '-n', ...cmd];
+    if (info.hasTty)
+        return ['sudo', ...cmd];
+    return undefined;
+}
+/** Build the install argv for a given package manager. Pure: returns argv[]
+ *  ready for spawnSync, no side effects. Returns undefined if escalation
+ *  isn't possible. */
+function buildInstallArgv(pm, pkg, info) {
+    switch (pm) {
+        case 'brew': return ['brew', 'install', pkg];
+        case 'conda': return ['conda', 'install', '-y', '-c', 'conda-forge', pkg];
+        case 'apt': return sudoPrefix(['apt-get', 'install', '-y', pkg], info);
+        case 'dnf': return sudoPrefix(['dnf', 'install', '-y', pkg], info);
+        case 'yum': return sudoPrefix(['yum', 'install', '-y', pkg], info);
+        case 'pacman': return sudoPrefix(['pacman', '-S', '--noconfirm', pkg], info);
+        case 'apk': return sudoPrefix(['apk', 'add', pkg], info);
+        case 'zypper': return sudoPrefix(['zypper', 'install', '-y', pkg], info);
+        case 'unknown': return undefined;
+    }
+}
+/** apt-get specifically needs an updated package list on minimal images
+ *  before the install will find tmux. This is NOT part of buildInstallArgv
+ *  (which is pure) — it runs once just before the apt install attempt.
+ *  Failure here is non-fatal; the actual install will fail loudly if it
+ *  can't find the package. */
+function aptUpdateBeforeInstall(info) {
+    const argv = sudoPrefix(['apt-get', 'update'], info);
+    if (!argv)
+        return;
+    try {
+        spawnSync(argv[0], argv.slice(1), { stdio: 'inherit', timeout: 120_000 });
+    }
+    catch { /* best-effort */ }
+}
+/** Suggest the manual command we'd have run, for the failure message. */
+function suggestManualCommand(pm, pkg) {
+    switch (pm) {
+        case 'brew': return `brew install ${pkg}`;
+        case 'conda': return `conda install -y -c conda-forge ${pkg}`;
+        case 'apt': return `sudo apt-get update && sudo apt-get install -y ${pkg}`;
+        case 'dnf': return `sudo dnf install -y ${pkg}`;
+        case 'yum': return `sudo yum install -y ${pkg}`;
+        case 'pacman': return `sudo pacman -S --noconfirm ${pkg}`;
+        case 'apk': return `sudo apk add ${pkg}`;
+        case 'zypper': return `sudo zypper install -y ${pkg}`;
+        default: return `(请手动安装 ${pkg})`;
+    }
+}
+function runInstall(argv) {
+    const result = spawnSync(argv[0], argv.slice(1), {
+        stdio: 'inherit',
+        timeout: 10 * 60_000, // 10 min — apt-get on slow networks
+    });
+    return result.status === 0;
+}
+export async function ensureTmux(info) {
+    const platform = info ?? detectPlatform();
+    // Step 1: already installed?
+    const existing = probeTmuxVersion();
+    if (existing) {
+        return { installed: true, version: existing, freshInstall: false };
+    }
+    console.log('⚠️  tmux 未检测到，正在安装...');
+    // Step 2..4: walk the package-manager preference list.
+    const tried = [];
+    for (const pm of platform.packageManagers) {
+        if (pm === 'unknown')
+            continue;
+        const argv = buildInstallArgv(pm, 'tmux', platform);
+        if (!argv) {
+            tried.push(`${pm}（跳过：当前用户无 sudo 且无 TTY）`);
+            continue;
+        }
+        if (pm === 'apt')
+            aptUpdateBeforeInstall(platform);
+        console.log(`   尝试 ${pm}: ${argv.join(' ')}`);
+        if (runInstall(argv)) {
+            const v = probeTmuxVersion();
+            if (v) {
+                console.log(`✅ tmux ${v} 安装完成 (via ${pm})`);
+                return { installed: true, version: v, freshInstall: true, strategy: pm };
+            }
+            tried.push(`${pm}（命令成功但 tmux -V 仍失败）`);
+        }
+        else {
+            tried.push(`${pm}（命令返回非零）`);
+        }
+    }
+    // Build a useful failure message with the most relevant manual command.
+    const preferred = platform.packageManagers.find(p => p !== 'unknown') ?? 'unknown';
+    const manual = suggestManualCommand(preferred, 'tmux');
+    const lines = [
+        '❌ 自动安装 tmux 失败',
+        '',
+        '已尝试：',
+        ...tried.map(t => `  - ${t}`),
+        '',
+        '请手动安装后重试：',
+        `  ${manual}`,
+    ];
+    // macOS without Homebrew → guide the user to install brew first.
+    if (platform.os === 'darwin' && !platform.packageManagers.includes('brew')) {
+        lines.push('');
+        lines.push('macOS 推荐先安装 Homebrew：');
+        lines.push('  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"');
+        lines.push('安装完成后重试 `botmux start`，会走 brew 自动装 tmux。');
+    }
+    if (!platform.hasTty && !platform.isRoot && !platform.passwordlessSudo && platform.os === 'linux') {
+        lines.push('');
+        lines.push('提示：当前不是交互式 TTY 且 sudo 需要密码，systemd/pm2 自启场景下无法弹密码。');
+        lines.push('请在 shell 中手动跑一次 `botmux start`，或配置 NOPASSWD sudoers 后再启用 autostart。');
+    }
+    throw new Error(lines.join('\n'));
+}
+//# sourceMappingURL=ensure-tmux.js.map

package/dist/setup/ensure-tmux.js.map

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

package/dist/setup/index.d.ts

@@ -0,0 +1,9 @@
+import { type TmuxResult } from './ensure-tmux.js';
+import { type FontResult } from './ensure-fonts.js';
+export interface DependenciesReport {
+    tmux: TmuxResult;
+    fonts: FontResult;
+}
+export { botmuxFontDir } from './ensure-fonts.js';
+export declare function ensureDependencies(): Promise<DependenciesReport>;
+//# sourceMappingURL=index.d.ts.map

package/dist/setup/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAe,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,CAAC;IACjB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAsBtE"}

package/dist/setup/index.js

@@ -0,0 +1,35 @@
+/**
+ * Dependency bootstrap. Called from `botmux start` and `botmux restart` so
+ * a fresh machine that just `npm i -g botmux`'d gets tmux + screenshot fonts
+ * provisioned without manual setup.
+ *
+ * - tmux is required: a failed install throws so cli.ts can exit non-zero.
+ * - fonts are nice-to-have: failures only print a warning.
+ */
+import { detectPlatform } from './detect-platform.js';
+import { ensureTmux } from './ensure-tmux.js';
+import { ensureFonts } from './ensure-fonts.js';
+export { botmuxFontDir } from './ensure-fonts.js';
+export async function ensureDependencies() {
+    const platform = detectPlatform();
+    // tmux first — it's the load-bearing dep. Throws on failure.
+    const tmux = await ensureTmux(platform);
+    if (!tmux.freshInstall) {
+        console.log(`✓ tmux ${tmux.version} (existing)`);
+    }
+    // Fonts second — best-effort.
+    const fonts = await ensureFonts(platform);
+    if (fonts.failed.length === 0) {
+        if (platform.os === 'darwin') {
+            console.log('✓ 字体: 系统字体已就绪 (macOS)');
+        }
+        else {
+            console.log(`✓ 字体: ${fonts.ready.join(' / ')} 已就绪`);
+        }
+    }
+    else {
+        console.warn(`⚠️  字体部分缺失: ${fonts.failed.join(' / ')} —— 飞书截图中相关字符可能渲染为方块`);
+    }
+    return { tmux, fonts };
+}
+//# sourceMappingURL=index.js.map

package/dist/setup/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/setup/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAmB,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAmB,MAAM,mBAAmB,CAAC;AAOjE,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,CAAC,KAAK,UAAU,kBAAkB;IACtC,MAAM,QAAQ,GAAG,cAAc,EAAE,CAAC;IAElC,6DAA6D;IAC7D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;IACnD,CAAC;IAED,8BAA8B;IAC9B,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,SAAS,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAC9E,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AACzB,CAAC"}

package/dist/utils/bot-mention-dedup.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Cross-path dedup for bot-to-bot @mentions.
+ *
+ * Two routes can deliver the same `botmux send --mention <peer>` to a target
+ * daemon:
+ *   1. Lark WSClient → event-dispatcher → handleThreadReply
+ *   2. signal-file watcher → processBotMentionSignal
+ *
+ * Whichever fires first records the inbound message_id here; the other side
+ * checks before forwarding to the worker so we never enqueue the same turn
+ * twice. Keyed by inbound message_id (not session/anchor) so it is robust to
+ * reordering and to stale `lastMessageAt` from prior unrelated turns.
+ *
+ * In-memory only (one instance per daemon process). Entries expire after
+ * `TTL_MS` to keep the map bounded; 30s is well past any realistic gap
+ * between the two paths.
+ */
+/** Mark this messageId as already routed to the worker by one of the two
+ *  paths. Calling twice for the same id is a no-op. */
+export declare function markBotMentionMessageHandled(messageId: string | undefined): void;
+/** Did we already route this messageId? Returns true if the other path got
+ *  there first within the TTL window. */
+export declare function isBotMentionMessageHandled(messageId: string | undefined): boolean;
+/** Test seam — drop everything. */
+export declare function _resetForTest(): void;
+//# sourceMappingURL=bot-mention-dedup.d.ts.map

package/dist/utils/bot-mention-dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-mention-dedup.d.ts","sourceRoot":"","sources":["../../src/utils/bot-mention-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH;uDACuD;AACvD,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAIhF;AAED;yCACyC;AACzC,wBAAgB,0BAA0B,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CASjF;AAED,mCAAmC;AACnC,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/utils/bot-mention-dedup.js

@@ -0,0 +1,56 @@
+/**
+ * Cross-path dedup for bot-to-bot @mentions.
+ *
+ * Two routes can deliver the same `botmux send --mention <peer>` to a target
+ * daemon:
+ *   1. Lark WSClient → event-dispatcher → handleThreadReply
+ *   2. signal-file watcher → processBotMentionSignal
+ *
+ * Whichever fires first records the inbound message_id here; the other side
+ * checks before forwarding to the worker so we never enqueue the same turn
+ * twice. Keyed by inbound message_id (not session/anchor) so it is robust to
+ * reordering and to stale `lastMessageAt` from prior unrelated turns.
+ *
+ * In-memory only (one instance per daemon process). Entries expire after
+ * `TTL_MS` to keep the map bounded; 30s is well past any realistic gap
+ * between the two paths.
+ */
+const TTL_MS = 30_000;
+const seen = new Map(); // messageId → expiresAt (epoch ms)
+/** Mark this messageId as already routed to the worker by one of the two
+ *  paths. Calling twice for the same id is a no-op. */
+export function markBotMentionMessageHandled(messageId) {
+    if (!messageId)
+        return;
+    gc();
+    seen.set(messageId, Date.now() + TTL_MS);
+}
+/** Did we already route this messageId? Returns true if the other path got
+ *  there first within the TTL window. */
+export function isBotMentionMessageHandled(messageId) {
+    if (!messageId)
+        return false;
+    const expiresAt = seen.get(messageId);
+    if (expiresAt === undefined)
+        return false;
+    if (expiresAt < Date.now()) {
+        seen.delete(messageId);
+        return false;
+    }
+    return true;
+}
+/** Test seam — drop everything. */
+export function _resetForTest() {
+    seen.clear();
+}
+function gc() {
+    // Cheap incremental GC: only sweep when we cross a small threshold.
+    if (seen.size < 64)
+        return;
+    const now = Date.now();
+    for (const [k, v] of seen) {
+        if (v < now)
+            seen.delete(k);
+    }
+}
+//# sourceMappingURL=bot-mention-dedup.js.map

package/dist/utils/bot-mention-dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bot-mention-dedup.js","sourceRoot":"","sources":["../../src/utils/bot-mention-dedup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,MAAM,GAAG,MAAM,CAAC;AAEtB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,mCAAmC;AAE3E;uDACuD;AACvD,MAAM,UAAU,4BAA4B,CAAC,SAA6B;IACxE,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,EAAE,EAAE,CAAC;IACL,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC;AAC3C,CAAC;AAED;yCACyC;AACzC,MAAM,UAAU,0BAA0B,CAAC,SAA6B;IACtE,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC1C,IAAI,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,mCAAmC;AACnC,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC,KAAK,EAAE,CAAC;AACf,CAAC;AAED,SAAS,EAAE;IACT,oEAAoE;IACpE,IAAI,IAAI,CAAC,IAAI,GAAG,EAAE;QAAE,OAAO;IAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG;YAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/utils/screenshot-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot-renderer.d.ts","sourceRoot":"","sources":["../../src/utils/screenshot-renderer.ts"],"names":[],"mappings":"AASA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,KAAK,QAAQ,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AAsJ5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAqE1E"}
+{"version":3,"file":"screenshot-renderer.d.ts","sourceRoot":"","sources":["../../src/utils/screenshot-renderer.ts"],"names":[],"mappings":"AAUA,OAAO,aAAa,MAAM,iBAAiB,CAAC;AAC5C,KAAK,QAAQ,GAAG,YAAY,CAAC,OAAO,aAAa,CAAC,QAAQ,CAAC,CAAC;AA4J5D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAqE1E"}

package/dist/utils/screenshot-renderer.js

@@ -5,6 +5,7 @@
  */
 import { createCanvas, GlobalFonts } from '@napi-rs/canvas';
 import { existsSync } from 'node:fs';
+import { homedir } from 'node:os';
 import { dirname, join } from 'node:path';
 import { fileURLToPath } from 'node:url';
 // ─── Font registration ──────────────────────────────────────────────────────
@@ -39,8 +40,11 @@ function ensureFontRegistered() {
         }
     }
     // 2. CJK monospace — primary for Latin + Han glyphs.
-    //    Linux: Noto Sans CJK（需要 fonts-noto-cjk 包）；macOS: 系统自带 PingFang/Hiragino。
+    //    Linux: Noto Sans CJK（需要 fonts-noto-cjk 包，或 botmux setup 自动下载到 ~/.botmux/fonts/）；
+    //    macOS: 系统自带 PingFang/Hiragino。
+    const userFontDir = join(homedir(), '.botmux', 'fonts');
     const cjkCandidates = [
+        { regular: join(userFontDir, 'NotoSansMonoCJKsc-Regular.otf'), bold: join(userFontDir, 'NotoSansMonoCJKsc-Bold.otf'), family: 'Noto Sans Mono CJK SC' },
         { regular: '/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc', bold: '/usr/share/fonts/opentype/noto/NotoSansCJK-Bold.ttc', family: 'Noto Sans Mono CJK SC' },
         { regular: '/usr/share/fonts/noto-cjk/NotoSansCJK-Regular.ttc', bold: '/usr/share/fonts/noto-cjk/NotoSansCJK-Bold.ttc', family: 'Noto Sans Mono CJK SC' },
         { regular: '/usr/share/fonts/google-noto-cjk/NotoSansCJK-Regular.ttc', bold: '/usr/share/fonts/google-noto-cjk/NotoSansCJK-Bold.ttc', family: 'Noto Sans Mono CJK SC' },
@@ -58,18 +62,20 @@ function ensureFontRegistered() {
             break;
         }
     }
-    // 3. Latin monospace — DejaVu/Liberation cover dingbats (❯, ✓, etc.) and
-    //    most box-drawing/geometric symbols not in CJK font.
+    // 3. Latin monospace — DejaVu/Liberation/JetBrains Mono cover dingbats (❯,
+    //    ✓, etc.) and most box-drawing/geometric symbols not in CJK font.
     const latinCandidates = [
+        [join(userFontDir, 'JetBrainsMono-Regular.ttf'), 'JetBrains Mono'],
         ['/usr/share/fonts/truetype/dejavu/DejaVuSansMono.ttf', 'DejaVu Sans Mono'],
         ['/usr/share/fonts/dejavu/DejaVuSansMono.ttf', 'DejaVu Sans Mono'],
         ['/usr/share/fonts/truetype/liberation/LiberationMono-Regular.ttf', 'Liberation Mono'],
         ['/usr/share/fonts/liberation/LiberationMono-Regular.ttf', 'Liberation Mono'],
+        ['/usr/share/fonts/truetype/jetbrains-mono/JetBrainsMono-Regular.ttf', 'JetBrains Mono'],
     ];
     for (const [p, name] of latinCandidates) {
         if (tryRegister(p)) {
-            // Best-effort bold companion
-            tryRegister(p.replace(/Regular\.ttf$/, 'Bold.ttf'));
+            // Best-effort bold companion. Same dir, replace -Regular with -Bold.
+            tryRegister(p.replace(/-Regular\.ttf$/, '-Bold.ttf'));
             tryRegister(p.replace(/SansMono\.ttf$/, 'SansMono-Bold.ttf'));
             fontFamilyChain.push(name);
             break;
@@ -78,6 +84,7 @@ function ensureFontRegistered() {
     // 4. Color emoji — Noto Color Emoji on Linux, Apple Color Emoji on macOS.
     //    skia handles CBDT/CBLC + COLR/CPAL color formats.
     const emojiCandidates = [
+        [join(userFontDir, 'NotoColorEmoji.ttf'), 'Noto Color Emoji'],
         ['/usr/share/fonts/truetype/noto/NotoColorEmoji.ttf', 'Noto Color Emoji'],
         ['/usr/share/fonts/noto/NotoColorEmoji.ttf', 'Noto Color Emoji'],
         ['/usr/share/fonts/google-noto-emoji/NotoColorEmoji.ttf', 'Noto Color Emoji'],