botmux 2.9.0 → 2.9.2

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,60 @@
+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;
+    /** When installed=false: human-readable reason for the caller's warning. */
+    reason?: string;
+    /** When installed=false: the manual command we'd have run, for the warning. */
+    manualCommand?: string;
+}
+/**
+ * Strip tmux-injected env vars when spawning a tmux child process.
+ *
+ * If the parent (daemon / worker / cli wrapper) was launched from inside a
+ * tmux session, tmux exports `TMUX=<socket-path>,<pid>,<session-id>` and
+ * `TMUX_PANE=...` to the environment. Any `tmux` subcommand we run without
+ * explicit `-L <socket>` then targets *that* parent server — when the user's
+ * terminal tmux is gone (logged out, server killed, /tmp wiped) every
+ * subsequent call fails with `error connecting to <stale-socket>`.
+ *
+ * This affects botmux even when the user's *new* `tmux -V` works fine on the
+ * shell, because that test starts from a fresh shell with no stale `TMUX`.
+ * The daemon, autostarted via pm2/systemd at login, inherited the original
+ * shell's tmux env — `/tmp/tmux-1001/default` in the wild we see — and keeps
+ * hammering at it forever.
+ *
+ * Caller pattern: every execSync / execFileSync / spawnSync / pty.spawn that
+ * invokes the `tmux` binary must pass `env: tmuxEnv()` (or `tmuxEnv(opts.env)`
+ * when forwarding caller-provided env). TMUX_TMPDIR is intentionally left
+ * alone — it just changes the socket directory and is the user's deliberate
+ * override if set.
+ */
+export declare function tmuxEnv(env?: NodeJS.ProcessEnv): NodeJS.ProcessEnv;
+/**
+ * Functional tmux probe — actually starts a tmux server and tears it down.
+ *
+ * `tmux -V` only checks the binary, not whether tmux can create a socket and
+ * fork a session. Real-world failures we've seen: (1) /tmp owned by another
+ * user, (2) broken ~/.tmux.conf, (3) the binary is a libc-mismatched dynamic
+ * link, (4) tmux 1.x on minimal images missing libevent. All of those make
+ * `tmux -V` succeed but every `new-session` / `attach-session` fail, which
+ * floods daemon-error.log and leaves the worker with no working backend.
+ *
+ * Uses a unique `-L <socket-name>` so the probe never clobbers an existing
+ * user tmux server. Stderr is captured (not inherited) so the failure
+ * reason can surface in the bootstrap warning without spilling onto the
+ * user's terminal.
+ */
+export declare function probeTmuxFunctional(): {
+    ok: true;
+    version: string;
+} | {
+    ok: false;
+    reason: string;
+};
+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":"AAuBA,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;IAC1B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAgBD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,OAAO,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAAC,UAAU,CAG/E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,mBAAmB,IAAI;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAsBnG;AAiED,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAsEzE"}

package/dist/setup/ensure-tmux.js

@@ -0,0 +1,236 @@
+/**
+ * Ensure tmux is installed before the daemon starts. Strategy (first one
+ * that fits wins):
+ *
+ *   1. Already installed AND functional → 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 with manual command
+ *   5. Otherwise → return failure with manual command.
+ *
+ * Tmux is a NICE-TO-HAVE (enables /adopt + multi-pane Web terminal), not
+ * load-bearing: PTY backend works without it. So this function never throws —
+ * the caller inspects `installed` and routes accordingly. Earlier versions
+ * threw on failure; that broke users whose tmux binary was present but
+ * couldn't actually start a server (corrupt install / restricted /tmp /
+ * broken ~/.tmux.conf — see daemon-error logs full of "error connecting to
+ * /tmp/tmux-UID/default"), because `tmux -V` would pass but every subsequent
+ * tmux command would fail. Functional probe + soft fallback fixes both.
+ */
+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,
+            env: tmuxEnv(),
+        });
+        return out.trim();
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Strip tmux-injected env vars when spawning a tmux child process.
+ *
+ * If the parent (daemon / worker / cli wrapper) was launched from inside a
+ * tmux session, tmux exports `TMUX=<socket-path>,<pid>,<session-id>` and
+ * `TMUX_PANE=...` to the environment. Any `tmux` subcommand we run without
+ * explicit `-L <socket>` then targets *that* parent server — when the user's
+ * terminal tmux is gone (logged out, server killed, /tmp wiped) every
+ * subsequent call fails with `error connecting to <stale-socket>`.
+ *
+ * This affects botmux even when the user's *new* `tmux -V` works fine on the
+ * shell, because that test starts from a fresh shell with no stale `TMUX`.
+ * The daemon, autostarted via pm2/systemd at login, inherited the original
+ * shell's tmux env — `/tmp/tmux-1001/default` in the wild we see — and keeps
+ * hammering at it forever.
+ *
+ * Caller pattern: every execSync / execFileSync / spawnSync / pty.spawn that
+ * invokes the `tmux` binary must pass `env: tmuxEnv()` (or `tmuxEnv(opts.env)`
+ * when forwarding caller-provided env). TMUX_TMPDIR is intentionally left
+ * alone — it just changes the socket directory and is the user's deliberate
+ * override if set.
+ */
+export function tmuxEnv(env = process.env) {
+    const { TMUX: _tmux, TMUX_PANE: _pane, ...rest } = env;
+    return rest;
+}
+/**
+ * Functional tmux probe — actually starts a tmux server and tears it down.
+ *
+ * `tmux -V` only checks the binary, not whether tmux can create a socket and
+ * fork a session. Real-world failures we've seen: (1) /tmp owned by another
+ * user, (2) broken ~/.tmux.conf, (3) the binary is a libc-mismatched dynamic
+ * link, (4) tmux 1.x on minimal images missing libevent. All of those make
+ * `tmux -V` succeed but every `new-session` / `attach-session` fail, which
+ * floods daemon-error.log and leaves the worker with no working backend.
+ *
+ * Uses a unique `-L <socket-name>` so the probe never clobbers an existing
+ * user tmux server. Stderr is captured (not inherited) so the failure
+ * reason can surface in the bootstrap warning without spilling onto the
+ * user's terminal.
+ */
+export function probeTmuxFunctional() {
+    const version = probeTmuxVersion();
+    if (!version)
+        return { ok: false, reason: 'tmux 二进制不在 PATH 上' };
+    const sockName = `bmx-probe-${process.pid}-${Date.now()}`;
+    // env: tmuxEnv() — without this, if the daemon inherited TMUX from a tmux
+    // session that has since died, this probe would target the dead server
+    // (despite the `-L` flag tmux still walks $TMUX in some 2.x paths during
+    // startup) and report "ok: false" even on a perfectly healthy install.
+    const run = spawnSync('tmux', ['-L', sockName, 'new-session', '-d', '-s', 'probe', 'true'], {
+        stdio: ['ignore', 'ignore', 'pipe'],
+        timeout: 5000,
+        env: tmuxEnv(),
+    });
+    if (run.status !== 0) {
+        const stderr = (run.stderr?.toString() ?? '').trim();
+        return { ok: false, reason: stderr || `tmux new-session 失败 (exit ${run.status})` };
+    }
+    // Tear down the probe server. Best-effort — if this leaks, the kernel
+    // will GC the abstract socket when the (now-empty) tmux server exits on
+    // its own once the only client (which we didn't attach) goes away.
+    spawnSync('tmux', ['-L', sockName, 'kill-server'], { stdio: 'ignore', timeout: 3000, env: tmuxEnv() });
+    return { ok: true, version };
+}
+/** 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 AND functional?
+    // `tmux -V` alone is not enough — see probeTmuxFunctional jsdoc for the
+    // failure modes (broken /tmp perms / bad ~/.tmux.conf / mismatched libs)
+    // that pass -V but fail every actual tmux command.
+    const initialProbe = probeTmuxFunctional();
+    if (initialProbe.ok) {
+        return { installed: true, version: initialProbe.version, freshInstall: false };
+    }
+    // If the binary exists but the server can't start, no amount of
+    // `apt-get install tmux` will help — surface the underlying reason and
+    // let the caller fall back to PTY backend.
+    const versionPresent = probeTmuxVersion();
+    if (versionPresent) {
+        return {
+            installed: false,
+            freshInstall: false,
+            reason: `${versionPresent} 已安装但启动 server 失败：${initialProbe.reason}`,
+            manualCommand: '排查 ~/.tmux.conf / /tmp 权限 / libevent 依赖后再试',
+        };
+    }
+    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 postInstall = probeTmuxFunctional();
+            if (postInstall.ok) {
+                console.log(`✅ tmux ${postInstall.version} 安装完成 (via ${pm})`);
+                return { installed: true, version: postInstall.version, freshInstall: true, strategy: pm };
+            }
+            tried.push(`${pm}（装上了但 server 起不来：${postInstall.reason}）`);
+        }
+        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 reasonLines = [
+        '自动安装 tmux 失败',
+        '已尝试：',
+        ...tried.map(t => `  - ${t}`),
+    ];
+    if (platform.os === 'darwin' && !platform.packageManagers.includes('brew')) {
+        reasonLines.push('macOS 推荐先安装 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"');
+    }
+    if (!platform.hasTty && !platform.isRoot && !platform.passwordlessSudo && platform.os === 'linux') {
+        reasonLines.push('提示：当前不是交互式 TTY 且 sudo 需要密码，systemd/pm2 自启下无法弹密码 — 先在 shell 跑一次 `botmux start`，或配置 NOPASSWD sudoers。');
+    }
+    return {
+        installed: false,
+        freshInstall: false,
+        reason: reasonLines.join('\n'),
+        manualCommand: manual,
+    };
+}
+//# 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,CA8BtE"}

package/dist/setup/index.js

@@ -0,0 +1,46 @@
+/**
+ * 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: nice-to-have (enables /adopt + multi-pane Web terminal). Daemon
+    // still works on PTY backend without it, so failure is a warning, not fatal.
+    const tmux = await ensureTmux(platform);
+    if (tmux.installed) {
+        if (!tmux.freshInstall)
+            console.log(`✓ tmux ${tmux.version} (existing)`);
+    }
+    else {
+        console.warn('');
+        console.warn('⚠️  tmux 不可用，已退回到 PTY backend');
+        console.warn(`    原因：${tmux.reason ?? '未知'}`);
+        if (tmux.manualCommand)
+            console.warn(`    手动尝试：${tmux.manualCommand}`);
+        console.warn('    影响：/adopt（接管已有 CLI 会话）和多人 Web 终端不可用；常规对话不受影响。');
+        console.warn('');
+    }
+    // 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,wEAAwE;IACxE,6EAA6E;IAC7E,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC,IAAI,CAAC,YAAY;YAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,CAAC,OAAO,aAAa,CAAC,CAAC;IAC3E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,UAAU,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,CAAC,CAAC;QAC9C,IAAI,IAAI,CAAC,aAAa;YAAE,OAAO,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,aAAa,EAAE,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;QAClE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACnB,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"}