botmux 2.101.0 → 2.102.0

package/dist/core/local-terminal-opener.js

@@ -0,0 +1,221 @@
+import { spawn, spawnSync } from 'node:child_process';
+import { homedir } from 'node:os';
+import { delimiter } from 'node:path';
+import { getBot } from '../bot-registry.js';
+import { createCliAdapterSync } from '../adapters/cli/registry.js';
+import { buildWrappedLaunch, decorateResumeForWrapper, parseWrapperCli } from '../setup/cli-selection.js';
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+function onPath(bin) {
+    if (bin.includes('/'))
+        return spawnSync('test', ['-x', bin]).status === 0;
+    const paths = (process.env.PATH || '').split(delimiter).filter(Boolean);
+    if (paths.some(dir => spawnSync('test', ['-x', `${dir}/${bin}`]).status === 0))
+        return true;
+    const shell = process.env.SHELL || '/bin/zsh';
+    const result = spawnSync(shell, ['-lc', `command -v ${shellQuote(bin)}`], {
+        encoding: 'utf8',
+        timeout: 3000,
+        stdio: ['ignore', 'pipe', 'ignore'],
+    });
+    return result.status === 0 && (result.stdout ?? '').trim().length > 0;
+}
+function effectiveCliConfig(ds) {
+    let botCfg;
+    try {
+        botCfg = getBot(ds.larkAppId).config;
+    }
+    catch { /* tests / deregistered bot */ }
+    return {
+        cliId: (ds.session.cliId ?? ds.initConfig?.cliId ?? botCfg?.cliId ?? 'claude-code'),
+        cliPathOverride: ds.session.cliPathOverride ?? ds.initConfig?.cliPathOverride ?? botCfg?.cliPathOverride,
+        wrapperCli: ds.session.wrapperCli ?? ds.initConfig?.wrapperCli ?? botCfg?.wrapperCli,
+        model: ds.session.model ?? ds.initConfig?.model ?? botCfg?.model,
+    };
+}
+function isCodexFamily(cliId) {
+    return cliId === 'codex' || cliId === 'codex-app';
+}
+function defaultLocalExecutable(cliId, adapterResolvedBin, cliPathOverride) {
+    if (cliPathOverride?.trim())
+        return cliPathOverride.trim();
+    if (cliId === 'codex-app')
+        return 'codex';
+    if (cliId === 'mira')
+        return null;
+    if (cliId === 'mir')
+        return 'mircli';
+    return adapterResolvedBin;
+}
+function replaceFirstToken(command, executable) {
+    const rest = command.trim().replace(/^\S+/, '').trimStart();
+    return rest ? `${shellQuote(executable)} ${rest}` : shellQuote(executable);
+}
+function shellJoin(parts) {
+    return parts.map(shellQuote).join(' ');
+}
+function commandForWrapperLaunch(wrapperCli, args, model) {
+    const tokens = parseWrapperCli(wrapperCli);
+    const launch = buildWrappedLaunch(wrapperCli, args, (bin) => bin, { ttadkModel: model });
+    return {
+        command: shellJoin([launch.bin, ...launch.args]),
+        executable: tokens[0] ?? launch.bin,
+    };
+}
+function appleScriptString(value) {
+    return JSON.stringify(value);
+}
+export function localCliCommandForSession(ds) {
+    const cfg = effectiveCliConfig(ds);
+    const cwd = ds.workingDir || ds.session.workingDir || ds.adoptedFrom?.cwd || homedir();
+    const cd = `cd ${shellQuote(cwd)}`;
+    let adapter;
+    try {
+        adapter = createCliAdapterSync(cfg.cliId, cfg.cliPathOverride);
+    }
+    catch (err) {
+        return { ok: false, error: 'adapter_error', cliId: cfg.cliId, detail: err instanceof Error ? err.message : String(err) };
+    }
+    const rawResume = adapter.buildResumeCommand?.({
+        sessionId: ds.session.sessionId,
+        cliSessionId: ds.session.cliSessionId,
+    }) ?? null;
+    if (rawResume) {
+        const decorated = decorateResumeForWrapper(rawResume, cfg.wrapperCli, { ttadkModel: cfg.model });
+        if (cfg.wrapperCli?.trim()) {
+            const executable = parseWrapperCli(cfg.wrapperCli)[0];
+            if (!executable || !onPath(executable)) {
+                return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable };
+            }
+            return { ok: true, mode: 'resume', executable, command: `${cd} && exec ${decorated}` };
+        }
+        const executable = defaultLocalExecutable(cfg.cliId, adapter.resolvedBin, cfg.cliPathOverride);
+        if (!executable || !onPath(executable)) {
+            return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable: executable ?? cfg.cliId };
+        }
+        return { ok: true, mode: 'resume', executable, command: `${cd} && exec ${replaceFirstToken(rawResume, executable)}` };
+    }
+    if (cfg.wrapperCli?.trim()) {
+        const { command, executable } = commandForWrapperLaunch(cfg.wrapperCli, [], cfg.model);
+        if (!executable || !onPath(executable)) {
+            return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable };
+        }
+        return { ok: true, mode: 'launch', executable, command: `${cd} && exec ${command}` };
+    }
+    const executable = defaultLocalExecutable(cfg.cliId, adapter.resolvedBin, cfg.cliPathOverride);
+    if (!executable) {
+        return { ok: false, error: 'resume_unavailable', cliId: cfg.cliId };
+    }
+    if (!onPath(executable)) {
+        return { ok: false, error: 'cli_unavailable', cliId: cfg.cliId, executable };
+    }
+    return { ok: true, mode: 'launch', executable, command: `${cd} && exec ${shellQuote(executable)}` };
+}
+function spawnDetached(command, args) {
+    try {
+        const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+        child.unref();
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+}
+function openOnMac(command) {
+    if (!onPath('osascript'))
+        return { ok: false, error: 'launcher_unavailable', detail: 'osascript not found', command };
+    const args = [
+        '-e', 'tell application "Terminal"',
+        '-e', 'activate',
+        '-e', `do script ${appleScriptString(command)}`,
+        '-e', 'end tell',
+    ];
+    const launched = spawnDetached('osascript', args);
+    if (!launched.ok)
+        return { ok: false, error: 'spawn_failed', detail: launched.error, command };
+    return { ok: true, backend: 'cli', command, launcher: 'Terminal.app' };
+}
+function openCodexApp() {
+    if (process.platform !== 'darwin') {
+        return { ok: false, error: 'unsupported_platform', detail: process.platform, command: 'open -a Codex' };
+    }
+    if (!onPath('open'))
+        return { ok: false, error: 'launcher_unavailable', detail: 'open not found', command: 'open -a Codex' };
+    const launched = spawnSync('open', ['-a', 'Codex'], { stdio: 'ignore', timeout: 3000 });
+    if (launched.status === 0) {
+        return { ok: true, backend: 'app', command: 'open -a Codex', launcher: 'Codex.app' };
+    }
+    return {
+        ok: false,
+        error: 'launcher_unavailable',
+        detail: launched.error?.message ?? 'Codex.app not found',
+        command: 'open -a Codex',
+    };
+}
+/** Per-emulator command forwarding: gnome-terminal wants `--`, xfce4-terminal
+ *  `-x`, kitty / xdg-terminal-exec take the command as positional args, and the
+ *  xterm lineage (konsole / alacritty / xterm and most others, including
+ *  whatever BOTMUX_TERMINAL points at) wants `-e`. */
+export function terminalLaunchArgs(terminalBase, shell, command) {
+    if (terminalBase === 'gnome-terminal')
+        return ['--', shell, '-lc', command];
+    if (terminalBase === 'xfce4-terminal')
+        return ['-x', shell, '-lc', command];
+    if (terminalBase === 'kitty' || terminalBase === 'xdg-terminal-exec')
+        return [shell, '-lc', command];
+    return ['-e', shell, '-lc', command];
+}
+function openOnLinux(command) {
+    const shell = process.env.SHELL || 'bash';
+    const preferred = process.env.BOTMUX_TERMINAL || process.env.TERMINAL;
+    const candidates = [
+        ...(preferred ? [preferred] : []),
+        'xdg-terminal-exec',
+        'gnome-terminal',
+        'konsole',
+        'xfce4-terminal',
+        'kitty',
+        'alacritty',
+        'xterm',
+    ];
+    const terminal = candidates.find(onPath);
+    if (!terminal)
+        return { ok: false, error: 'launcher_unavailable', detail: 'no terminal launcher found', command };
+    const base = terminal.split('/').pop() || terminal;
+    const launched = spawnDetached(terminal, terminalLaunchArgs(base, shell, command));
+    if (!launched.ok)
+        return { ok: false, error: 'spawn_failed', detail: launched.error, command };
+    return { ok: true, backend: 'cli', command, launcher: terminal };
+}
+/** Whether the daemon host can plausibly pop a native terminal window at all.
+ *  Gates the card button so headless/server deployments don't carry a button
+ *  that can only ever fail: macOS always qualifies (osascript + Terminal.app
+ *  ship with the OS); Linux only with a GUI session (DISPLAY/WAYLAND_DISPLAY)
+ *  or an explicit BOTMUX_TERMINAL/TERMINAL override. */
+export function localTerminalCapable() {
+    if (process.platform === 'darwin')
+        return true;
+    if (process.platform === 'linux') {
+        return Boolean(process.env.DISPLAY || process.env.WAYLAND_DISPLAY || process.env.BOTMUX_TERMINAL || process.env.TERMINAL);
+    }
+    return false;
+}
+export function openLocalTerminalForSession(ds) {
+    const cfg = effectiveCliConfig(ds);
+    const resolved = localCliCommandForSession(ds);
+    if (!resolved.ok && resolved.error === 'cli_unavailable' && isCodexFamily(cfg.cliId) && !cfg.wrapperCli?.trim()) {
+        const app = openCodexApp();
+        if (app.ok)
+            return app;
+        return { ...resolved, detail: app.detail ?? resolved.detail };
+    }
+    if (!resolved.ok)
+        return resolved;
+    if (process.platform === 'darwin')
+        return openOnMac(resolved.command);
+    if (process.platform === 'linux')
+        return openOnLinux(resolved.command);
+    return { ok: false, error: 'unsupported_platform', detail: process.platform, command: resolved.command };
+}
+//# sourceMappingURL=local-terminal-opener.js.map

package/dist/core/local-terminal-opener.js.map

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

package/dist/core/working-dir.d.ts

@@ -5,10 +5,21 @@ export declare function expandHome(p: string): string;
  * "owner explicitly chose a directory" — the daemon already runs CLI prompts
  * with full filesystem access, so an allowlist would be theater. We only do
  * the typo guards: exists and is a directory.
+ *
+ * Auto-create is opt-in (`opts.autoCreate`): only commands where the owner is
+ * explicitly typing a fresh path right now (`/cd`, `/oncall bind`) pass it —
+ * a missing path gets `mkdir -p` and `created: true` so the caller can tell
+ * the user. Every other call site (stored/derived paths at trigger time,
+ * dashboard writes, repo cards) keeps the exists-check as its typo guard —
+ * silently materializing an empty dir there would mask a stale or mistyped
+ * path instead of surfacing it.
  */
-export declare function validateWorkingDir(input: string, locale?: Locale): {
+export declare function validateWorkingDir(input: string, locale?: Locale, opts?: {
+    autoCreate?: boolean;
+}): {
     ok: true;
     resolvedPath: string;
+    created?: boolean;
 } | {
     ok: false;
     error: string;

package/dist/core/working-dir.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"working-dir.d.ts","sourceRoot":"","sources":["../../src/core/working-dir.ts"],"names":[],"mappings":"AAOA,OAAO,EAAK,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAElD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAapI"}
+{"version":3,"file":"working-dir.d.ts","sourceRoot":"","sources":["../../src/core/working-dir.ts"],"names":[],"mappings":"AAOA,OAAO,EAAK,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAElD,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,EACf,IAAI,CAAC,EAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAC9B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAqBtF"}

package/dist/core/working-dir.js

@@ -2,7 +2,7 @@
  * Working-directory path helpers, kept dependency-light so the CLI entrypoint
  * can import them without dragging in the daemon graph (worker-pool, PTY, …).
  */
-import { existsSync, statSync } from 'node:fs';
+import { existsSync, statSync, mkdirSync } from 'node:fs';
 import { join, resolve } from 'node:path';
 import { homedir } from 'node:os';
 import { t } from '../i18n/index.js';
@@ -14,11 +14,28 @@ export function expandHome(p) {
  * "owner explicitly chose a directory" — the daemon already runs CLI prompts
  * with full filesystem access, so an allowlist would be theater. We only do
  * the typo guards: exists and is a directory.
+ *
+ * Auto-create is opt-in (`opts.autoCreate`): only commands where the owner is
+ * explicitly typing a fresh path right now (`/cd`, `/oncall bind`) pass it —
+ * a missing path gets `mkdir -p` and `created: true` so the caller can tell
+ * the user. Every other call site (stored/derived paths at trigger time,
+ * dashboard writes, repo cards) keeps the exists-check as its typo guard —
+ * silently materializing an empty dir there would mask a stale or mistyped
+ * path instead of surfacing it.
  */
-export function validateWorkingDir(input, locale) {
+export function validateWorkingDir(input, locale, opts) {
     const resolvedPath = resolve(expandHome(input));
     if (!existsSync(resolvedPath)) {
-        return { ok: false, error: t('cmd.cd.dir_not_exist', { path: resolvedPath }, locale) };
+        if (!opts?.autoCreate) {
+            return { ok: false, error: t('cmd.cd.dir_not_exist', { path: resolvedPath }, locale) };
+        }
+        try {
+            mkdirSync(resolvedPath, { recursive: true });
+            return { ok: true, resolvedPath, created: true };
+        }
+        catch (e) {
+            return { ok: false, error: t('cmd.cd.cannot_create', { path: resolvedPath, msg: e?.message ?? String(e) }, locale) };
+        }
     }
     let isDir = false;
     try {

package/dist/core/working-dir.js.map

@@ -1 +1 @@
-{"version":3,"file":"working-dir.js","sourceRoot":"","sources":["../../src/core/working-dir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,CAAC,EAAe,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAa,EAAE,MAAe;IAC/D,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;IACzF,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC;QAAC,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QACpE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;IACrH,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACpC,CAAC"}
+{"version":3,"file":"working-dir.js","sourceRoot":"","sources":["../../src/core/working-dir.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,CAAC,EAAe,MAAM,kBAAkB,CAAC;AAElD,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAa,EACb,MAAe,EACf,IAA+B;IAE/B,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;QACzF,CAAC;QACD,IAAI,CAAC;YACH,SAAS,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7C,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACnD,CAAC;QAAC,OAAO,CAAM,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,sBAAsB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;QACvH,CAAC;IACH,CAAC;IACD,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,CAAC;QAAC,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAAC,OAAO,CAAM,EAAE,CAAC;QACpE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;IACrH,CAAC;IACD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,MAAM,CAAC,EAAE,CAAC;IAC3F,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;AACpC,CAAC"}

package/dist/daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAmBA,OAAO,EAA8G,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAkBhK,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiGrD,OAAO,EAAE,oBAAoB,EAA6B,MAAM,uBAAuB,CAAC;AACxF,OAAO,KAAK,EAAE,sBAAsB,EAAiB,MAAM,wBAAwB,CAAC;AAqPpF,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmClK;AAED,iBAAe,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAe,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8D3I;AAMD,eAAO,MAAM,uBAAuB,qBAAe,CAAC;AACpD,eAAO,MAAM,yBAAyB,4BAAiB,CAAC;AAqCxD,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CA+ClB;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAMpB;AAoKD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,sBAAsB,GAAG,oBAAoB,CA0C5G;AA65CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAe,uBAAuB,CAAC,GAAG,EAAE;IAC1C,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;;;;GAqBA;AAED,eAAO,MAAM,kCAAkC,gCAA0B,CAAC;AAihD1E,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAidlE"}
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAuI,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAoBzL,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAiGrD,OAAO,EAAE,oBAAoB,EAA6B,MAAM,uBAAuB,CAAC;AACxF,OAAO,KAAK,EAAE,sBAAsB,EAAiB,MAAM,wBAAwB,CAAC;AAqPpF,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmClK;AAED,iBAAe,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,MAAe,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CA8D3I;AAMD,eAAO,MAAM,uBAAuB,qBAAe,CAAC;AACpD,eAAO,MAAM,yBAAyB,4BAAiB,CAAC;AAqCxD,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CA+ClB;AAED,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAIpB;AAED,wBAAgB,+BAA+B,CAC7C,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,GAAG,EAAE,MAAM,GACV,MAAM,GAAG,SAAS,CAMpB;AAoKD,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,sBAAsB,GAAG,oBAAoB,CA0C5G;AA65CD;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAe,uBAAuB,CAAC,GAAG,EAAE;IAC1C,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,GAAG,KAAK,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;CACnB;;;;GAqBA;AAED,eAAO,MAAM,kCAAkC,gCAA0B,CAAC;AAihD1E,wBAAsB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmflE"}

package/dist/daemon.js

@@ -16,7 +16,9 @@ import { sendRestartReportIfPending } from './core/restart-report.js';
 import { statSync } from 'node:fs';
 import { addReaction, getChatMode, listChatMemberOpenIds, replyMessage, resolveAllowedUsersWithMap, sendMessage, sendUserMessage, updateMessage } from './im/lark/client.js';
 import { resolveGroupJoinPrompt, waitForAllowedUserInChat } from './core/auto-start.js';
-import { loadBotConfigs, registerBot, getBot, getAllBots, findOncallChat, effectiveDefaultWorkingDir } from './bot-registry.js';
+import { loadBotConfigs, registerBot, getBot, getAllBots, findOncallChat, effectiveDefaultWorkingDir, effectiveBotDisplayName } from './bot-registry.js';
+import { setDisplayNameRefresher, findConfigField, applyConfigField } from './services/bot-config-store.js';
+import { renameBotOnOpenPlatform } from './services/open-platform-rename.js';
 import * as sessionStore from './services/session-store.js';
 import * as chatFirstSeenStore from './services/chat-first-seen-store.js';
 import { ensureDefaultOncallBound } from './services/oncall-store.js';
@@ -42,7 +44,7 @@ import { RECEIVED_REACTION_EMOJI_TYPE } from './core/pending-response.js';
 import { t as tr, botLocale, localeForBot } from './i18n/index.js';
 import { createCliAdapterSync } from './adapters/cli/registry.js';
 import { initWorkerPool, setActiveSessionsRegistry, forkWorker, killWorker, reapOrphanWorkers, scheduleCardPatch, setCurrentCliVersion, CARD_POSTING_SENTINEL, parkStreamCard, closeSession as closeSessionHelper, ensureCliEnv, sweepGlobalBotmuxSkills, writableTerminalLinkFor, } from './core/worker-pool.js';
-import { ipcRoute, jsonRes, readJsonBody, setBotName, setLarkAppId, startIpcServer, setWorkflowRunner } from './core/dashboard-ipc-server.js';
+import { ipcRoute, jsonRes, readJsonBody, setBotName, setLarkAppId, startIpcServer, setWorkflowRunner, setBotRenamer } from './core/dashboard-ipc-server.js';
 import { saveFrozenCards } from './services/frozen-card-store.js';
 import { DAEMON_COMMANDS, SESSIONLESS_DAEMON_COMMANDS, resolvePassthroughCommands, resolveAdapterDefaultPassthroughCommands, handleCommand, handleCardCommand, handleTermLinkCommand, parseSlashCommandInvocation, parseForceTopicInvocation } from './core/command-handler.js';
 import { SLASH_COMMAND_SHAPE } from './core/passthrough-commands.js';
@@ -3451,7 +3453,7 @@ export async function startDaemon(botIndex) {
     const ipcPort = config.dashboard.ipcBasePort + idx;
     const desc = {
         larkAppId: cfg.larkAppId,
-        botName: cfg.larkAppId,
+        botName: cfg.displayName ?? cfg.larkAppId,
         cliId: cfg.cliId,
         botIndex: idx,
         ipcPort,
@@ -3464,6 +3466,45 @@ export async function startDaemon(botIndex) {
         // briefly sees an unusable on_/email (the resolution below rewrites this field).
         resolvedAllowedUsers: getBot(cfg.larkAppId).resolvedAllowedUsers.filter(u => u.startsWith('ou_')),
     };
+    // 名称状态刷新：displayName 或飞书真名变化后，用有效展示名刷新 descriptor +
+    // SessionRow.botName，无需重启 daemon。displayName 路径经 bot-config-store 的
+    // 钩子触发；真·改名路径在下面的 renamer 里直接调用。
+    const refreshBotNameState = () => {
+        const effective = effectiveBotDisplayName(getBot(cfg.larkAppId));
+        setBotName(effective);
+        if (effective !== desc.botName) {
+            desc.botName = effective;
+            try {
+                writeDaemonDescriptor(desc);
+            }
+            catch { /* best effort */ }
+        }
+    };
+    setDisplayNameRefresher(refreshBotNameState);
+    // 机器人真·改名（dashboard 档案头 ✎）：开放平台自动化改飞书应用名并发布新版本
+    // （群内显示名跟随已发布版本，见 services/open-platform-rename.ts）。成功后同步
+    // 内存 botName / bots-info 名册 / descriptor，并清掉冗余的 displayName 别名——
+    // 飞书名已经是新名，保持单一事实来源。
+    setBotRenamer(async (newName) => {
+        const r = await renameBotOnOpenPlatform(cfg.larkAppId, newName, cfg.brand);
+        if (!r.ok)
+            return r;
+        const bot = getBot(cfg.larkAppId);
+        bot.botName = newName;
+        const spec = findConfigField('displayName');
+        if (spec && bot.config.displayName) {
+            // applyConfigField 的 displayName 钩子会顺带触发 refreshBotNameState。
+            await applyConfigField(cfg.larkAppId, spec, null);
+        }
+        else {
+            refreshBotNameState();
+        }
+        try {
+            writeBotInfoFile(config.session.dataDir);
+        }
+        catch { /* best effort */ }
+        return r;
+    });
     // Initialise worker pool with daemon callbacks
     initWorkerPool({
         sessionReply,
@@ -3483,10 +3524,11 @@ export async function startDaemon(botIndex) {
     // Wire the workflow runner for /api/trigger (kind=workflow): reuse the same
     // heavy deps as the catalog run route.
     setWorkflowRunner((input) => triggerWorkflowRun(input, workflowTriggerDeps()));
-    // Seed dashboard IPC botName with the bot's config id; the friendly name from
-    // /bot/v3/info is wired into the registry descriptor (below) but the IPC server
-    // also needs its own copy for SessionRow.botName.
-    setBotName(cfg.larkAppId);
+    // Seed dashboard IPC botName with the custom displayName (falling back to the
+    // bot's config id); the friendly name from /bot/v3/info is wired into the
+    // registry descriptor (below) but the IPC server also needs its own copy for
+    // SessionRow.botName.
+    setBotName(cfg.displayName ?? cfg.larkAppId);
     setLarkAppId(cfg.larkAppId);
     selfV3LarkAppId = cfg.larkAppId; // scope v3 humanGate cold-attach / start to this bot
     // Bind dashboard IPC HTTP server BEFORE publishing the registry descriptor.
@@ -3596,9 +3638,11 @@ export async function startDaemon(botIndex) {
         // Probe bot open_id and persist to bots-info.json. When the friendly
         // botName comes back from /bot/v3/info, refresh the dashboard descriptor
         // so the registry shows "Claude" / "Codex" instead of the raw app id.
+        // A custom displayName (bots.json) beats the probed Lark name — the probe
+        // must not overwrite a rename seeded at startup.
         probeBotOpenId(cfg.larkAppId).then(() => {
             writeBotInfoFile(config.session.dataDir);
-            const probedName = bot.botName;
+            const probedName = cfg.displayName ?? bot.botName;
             const probedAvatar = bot.botAvatarUrl;
             let descChanged = false;
             if (probedName && probedName !== desc.botName) {