botmux 2.60.1 → 2.62.0

package/dist/core/command-discovery.d.ts

@@ -0,0 +1,24 @@
+export type DiscoveredSource = 'project-command' | 'user-command' | 'project-skill' | 'user-skill' | 'plugin-command' | 'plugin-skill';
+export interface DiscoveredCommand {
+    /** Invocation form, e.g. '/deploy' or '/myplugin:foo'. */
+    name: string;
+    /** First-line description pulled from frontmatter, when present. */
+    description?: string;
+    source: DiscoveredSource;
+    /** Human-friendly origin (relative-ish path or plugin id) for display. */
+    origin: string;
+}
+/**
+ * Discover all filesystem-visible slash commands for a session's working dir.
+ * Personal (`~/.claude`) + project (`<workingDir>/.claude`) + plugins, deduped
+ * by (name, source) and sorted by name. Safe to call on any CLI: non-Claude
+ * layouts simply yield nothing.
+ */
+export declare function discoverSlashCommands(workingDir: string): DiscoveredCommand[];
+/**
+ * Cheaply surface MCP *server* names from `<workingDir>/.mcp.json` (the standard
+ * project-level MCP config). The actual `/mcp__<server>__<prompt>` commands need
+ * a live handshake to enumerate and are out of scope here — this is just a hint.
+ */
+export declare function listMcpServerNames(workingDir: string): string[];
+//# sourceMappingURL=command-discovery.d.ts.map

package/dist/core/command-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-discovery.d.ts","sourceRoot":"","sources":["../../src/core/command-discovery.ts"],"names":[],"mappings":"AA0BA,MAAM,MAAM,gBAAgB,GACxB,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,cAAc,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,gBAAgB,CAAC;IACzB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;CAChB;AA+HD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA0B7E;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAc/D"}

package/dist/core/command-discovery.js

@@ -0,0 +1,201 @@
+/**
+ * Slash-command discovery — enumerate the user-installed / project-local slash
+ * commands, skills and plugins that the underlying CLI (Claude Code family)
+ * would surface, purely by scanning the filesystem. Powers part ③ of the
+ * `/list-slash-command` daemon command.
+ *
+ * Scope (v1): the Claude `.claude/` layout —
+ *   • custom commands:  <root>/.claude/commands/**\/*.md  → /name (subdir → ns:name)
+ *   • skills:           <root>/.claude/skills/*\/SKILL.md  → /name
+ *   • plugins:          <claudeHome>/plugins/cache/<mp>/<plugin>/[<ver>/]{commands,skills}
+ * where <root> ∈ { workingDir (project), claudeHome (personal) } and
+ * <claudeHome> = $CLAUDE_CONFIG_DIR || ~/.claude.
+ *
+ * Intentionally dependency-free (no YAML / glob libs): a tiny frontmatter reader
+ * and a bounded recursive walker keep this importable from the leaf-ish command
+ * handler without pulling in the daemon graph.
+ *
+ * NOT covered: MCP-provided `/mcp__<server>__<prompt>` commands — enumerating
+ * those needs a live MCP handshake. {@link listMcpServerNames} cheaply surfaces
+ * the server *names* from `.mcp.json` so the caller can at least hint at them.
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, basename, relative, sep } from 'node:path';
+import { homedir } from 'node:os';
+/** Resolve the Claude config/data root the CLI reads commands & skills from.
+ *  Honors CLAUDE_CONFIG_DIR (set by claude-family forks); defaults to ~/.claude. */
+function claudeHome() {
+    const env = process.env.CLAUDE_CONFIG_DIR?.trim();
+    return env && env.length > 0 ? env : join(homedir(), '.claude');
+}
+/** Minimal frontmatter reader: pull `name:` / `description:` from a leading
+ *  `---` … `---` block. No YAML dep — handles plain and quoted scalar values. */
+function readFrontmatter(file) {
+    let text;
+    try {
+        text = readFileSync(file, 'utf-8');
+    }
+    catch {
+        return {};
+    }
+    if (!text.startsWith('---'))
+        return {};
+    const end = text.indexOf('\n---', 3);
+    if (end === -1)
+        return {};
+    const block = text.slice(3, end);
+    const out = {};
+    for (const line of block.split(/\r?\n/)) {
+        const m = /^\s*(name|description)\s*:\s*(.+?)\s*$/.exec(line);
+        if (!m)
+            continue;
+        let v = m[2].trim();
+        if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
+            v = v.slice(1, -1);
+        }
+        if (m[1] === 'name')
+            out.name = v;
+        else
+            out.description = v;
+    }
+    return out;
+}
+/** Recursively collect `*.md` files under `dir` (bounded depth, fail-soft). */
+function walkMd(dir, depth = 4) {
+    if (depth < 0 || !existsSync(dir))
+        return [];
+    let entries;
+    try {
+        entries = readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        const p = join(dir, e.name);
+        if (e.isDirectory())
+            out.push(...walkMd(p, depth - 1));
+        else if (e.isFile() && e.name.endsWith('.md'))
+            out.push(p);
+    }
+    return out;
+}
+/** Immediate subdirectories of `dir` (fail-soft). */
+function listDirs(dir) {
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => join(dir, e.name));
+    }
+    catch {
+        return [];
+    }
+}
+/** `<commandsDir>/**\/*.md` → commands. Filename (minus .md) is the command;
+ *  nested subdirs become `ns:sub:name` namespaces (Claude convention). */
+function scanCommandsDir(commandsDir, source, originPrefix) {
+    return walkMd(commandsDir).map((file) => {
+        const rel = relative(commandsDir, file).replace(/\.md$/, '');
+        const name = '/' + rel.split(sep).join(':');
+        const fm = readFrontmatter(file);
+        return { name, description: fm.description, source, origin: `${originPrefix}/${rel}.md` };
+    });
+}
+/** `<skillsDir>/<name>/SKILL.md` → /name (optionally `ns:name` for plugins). */
+function scanSkillsDir(skillsDir, source, originPrefix, namePrefix = '') {
+    const out = [];
+    for (const d of listDirs(skillsDir)) {
+        const skillMd = join(d, 'SKILL.md');
+        if (!existsSync(skillMd))
+            continue;
+        const base = basename(d);
+        const fm = readFrontmatter(skillMd);
+        out.push({
+            name: '/' + (namePrefix ? `${namePrefix}:${base}` : base),
+            description: fm.description,
+            source,
+            origin: `${originPrefix}/${base}/SKILL.md`,
+        });
+    }
+    return out;
+}
+/** Walk `<claudeRoot>/plugins/cache/<marketplace>/<plugin>/[<ver>/]{commands,skills}`.
+ *  commands/skills may sit directly under the plugin or under a version subdir —
+ *  we try both and let the caller's dedupe collapse any overlap. */
+function scanPlugins(claudeRoot) {
+    const cacheRoot = join(claudeRoot, 'plugins', 'cache');
+    const out = [];
+    for (const mp of listDirs(cacheRoot)) {
+        for (const plugin of listDirs(mp)) {
+            const pluginId = basename(plugin);
+            const originPrefix = `plugins/${basename(mp)}/${pluginId}`;
+            const roots = [plugin, ...listDirs(plugin)];
+            for (const root of roots) {
+                for (const c of scanCommandsDir(join(root, 'commands'), 'plugin-command', originPrefix)) {
+                    // Re-namespace `/foo` → `/pluginId:foo`.
+                    out.push({ ...c, name: c.name.replace(/^\//, `/${pluginId}:`) });
+                }
+                out.push(...scanSkillsDir(join(root, 'skills'), 'plugin-skill', originPrefix, pluginId));
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Discover all filesystem-visible slash commands for a session's working dir.
+ * Personal (`~/.claude`) + project (`<workingDir>/.claude`) + plugins, deduped
+ * by (name, source) and sorted by name. Safe to call on any CLI: non-Claude
+ * layouts simply yield nothing.
+ */
+export function discoverSlashCommands(workingDir) {
+    const home = claudeHome();
+    const found = [];
+    // Personal (global) layer.
+    found.push(...scanCommandsDir(join(home, 'commands'), 'user-command', '~/.claude/commands'));
+    found.push(...scanSkillsDir(join(home, 'skills'), 'user-skill', '~/.claude/skills'));
+    found.push(...scanPlugins(home));
+    // Project layer.
+    if (workingDir) {
+        const proj = join(workingDir, '.claude');
+        found.push(...scanCommandsDir(join(proj, 'commands'), 'project-command', '.claude/commands'));
+        found.push(...scanSkillsDir(join(proj, 'skills'), 'project-skill', '.claude/skills'));
+    }
+    const seen = new Set();
+    const deduped = [];
+    for (const c of found) {
+        const key = c.name; // dedupe by name across sources (fixes duplicate cmds)
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        deduped.push(c);
+    }
+    deduped.sort((a, b) => a.name.localeCompare(b.name));
+    return deduped;
+}
+/**
+ * Cheaply surface MCP *server* names from `<workingDir>/.mcp.json` (the standard
+ * project-level MCP config). The actual `/mcp__<server>__<prompt>` commands need
+ * a live handshake to enumerate and are out of scope here — this is just a hint.
+ */
+export function listMcpServerNames(workingDir) {
+    if (!workingDir)
+        return [];
+    const file = join(workingDir, '.mcp.json');
+    if (!existsSync(file))
+        return [];
+    try {
+        const parsed = JSON.parse(readFileSync(file, 'utf-8'));
+        const servers = parsed?.mcpServers;
+        if (servers && typeof servers === 'object' && !Array.isArray(servers)) {
+            return Object.keys(servers);
+        }
+    }
+    catch {
+        /* malformed .mcp.json — ignore */
+    }
+    return [];
+}
+//# sourceMappingURL=command-discovery.js.map

package/dist/core/command-discovery.js.map

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

package/dist/core/command-handler.d.ts

@@ -22,6 +22,15 @@ export declare const SESSIONLESS_DAEMON_COMMANDS: Set<string>;
  * own slash-command parser sees them.
  */
 export declare const PASSTHROUGH_COMMANDS: Set<string>;
+/**
+ * Effective passthrough set for a bot: the fixed {@link PASSTHROUGH_COMMANDS}
+ * plus the bot's `customPassthroughCommands` (bots.json). Entries that would
+ * shadow a botmux daemon command are dropped — daemon commands must keep their
+ * daemon semantics, and passthrough is checked BEFORE DAEMON_COMMANDS in the
+ * router, so an un-filtered custom `/status` would hijack the daemon's own.
+ * Unknown / no bot → falls back to the builtin set unchanged.
+ */
+export declare function resolvePassthroughCommands(larkAppId?: string): Set<string>;
 export interface SlashCommandInvocation {
     cmd: string;
     content: string;

package/dist/core/command-handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/core/command-handler.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAoF,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACjJ,OAAO,EAA8D,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACtI,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAOnG,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,eAAO,MAAM,eAAe,aAAiM,CAAC;AAE9N;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,aAA4B,CAAC;AAErE;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,aAO/B,CAAC;AAIH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0C9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKpF;AAED;;;;mCAImC;AACnC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAqB1F;AAmED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzG,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,gCAAgC,EAAE,WAAW,EAAE,CAAC,CAAC;CACnF;AAoOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA6sCf;AAoDD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,qBAAqB,EAC7B,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,EACjD,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}
+{"version":3,"file":"command-handler.d.ts","sourceRoot":"","sources":["../../src/core/command-handler.ts"],"names":[],"mappings":"AAsBA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAoF,KAAK,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACjJ,OAAO,EAA8D,KAAK,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACtI,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAOnG,OAAO,KAAK,EAAE,WAAW,EAAkB,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKhD,eAAO,MAAM,eAAe,aAAkO,CAAC;AAE/P;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,aAA6D,CAAC;AAEtG;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,aAO/B,CAAC;AAEH;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAY1E;AAID,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAAE,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA0C9C;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKpF;AAED;;;;mCAImC;AACnC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI,CAqB1F;AAmED,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC3C,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACzG,cAAc,EAAE,MAAM,MAAM,CAAC;IAC7B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,gCAAgC,EAAE,WAAW,EAAE,CAAC,CAAC;CACnF;AAoOD;;;;;;;;;;;;GAYG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,WAAW,EACpB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAyuCf;AAoDD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,qBAAqB,EAC7B,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,gBAAgB,GAAG,sBAAsB,EACjD,EAAE,EAAE,aAAa,EACjB,IAAI,EAAE,kBAAkB,EACxB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CA4Cf"}

package/dist/core/command-handler.js

@@ -11,13 +11,15 @@ import * as sessionStore from '../services/session-store.js';
 import * as scheduleStore from '../services/schedule-store.js';
 import * as scheduler from './scheduler.js';
 import { scanMultipleProjects, describeProjectDir } from '../services/project-scanner.js';
-import { buildRepoSelectCard, buildAdoptSelectCard, buildCodexAppThreadSelectCard, buildSessionClosedCard, getCliDisplayName } from '../im/lark/card-builder.js';
+import { buildRepoSelectCard, buildAdoptSelectCard, buildCodexAppThreadSelectCard, buildSessionClosedCard, buildSlashListCard, getCliDisplayName } from '../im/lark/card-builder.js';
 import { createCliAdapterSync } from '../adapters/cli/registry.js';
 import { deleteMessage, sendMessage, listChatBotMembers, resolveUserUnionId, getChatModeStrict } from '../im/lark/client.js';
+import { chatAppLink, normalizeBrand } from '../im/lark/lark-hosts.js';
 import { claimPairing } from '../services/pairing-store.js';
 import { logger } from '../utils/logger.js';
 import { killWorker, forkWorker, forkAdoptWorker, getCurrentCliVersion, postFreshStreamingCard, postPrivateSnapshotCard, resolvePrivateCardAudience, deliverEphemeralOrReply } from './worker-pool.js';
 import { expandHome, getSessionWorkingDir, getProjectScanDirs, rememberLastCliInput } from './session-manager.js';
+import { discoverSlashCommands, listMcpServerNames } from './command-discovery.js';
 import { validateWorkingDir } from './working-dir.js';
 import { discoverAdoptableSessions, validateAdoptTarget, adoptTargetKey, adoptTargetLabel } from './session-discovery.js';
 import { discoverAdoptableZellijSessions, validateZellijAdoptTarget } from './zellij-adopt-discovery.js';
@@ -31,7 +33,7 @@ import { getBotCapability, setBotCapability, clearBotCapability } from '../servi
 import { sessionKey, sessionAnchorId } from './types.js';
 import { t, localeForBot } from '../i18n/index.js';
 // ─── Exported constants ──────────────────────────────────────────────────────
-export const DAEMON_COMMANDS = new Set(['/close', '/restart', '/status', '/help', '/cd', '/repo', '/schedule', '/role', '/pair', '/login', '/adopt', '/detach', '/disconnect', '/oncall', '/group', '/g', '/relay', '/card']);
+export const DAEMON_COMMANDS = new Set(['/close', '/restart', '/status', '/help', '/cd', '/repo', '/schedule', '/role', '/pair', '/login', '/adopt', '/detach', '/disconnect', '/oncall', '/group', '/g', '/relay', '/card', '/list-slash-command', '/slash']);
 /**
  * Daemon commands that act on the chat itself rather than opening a
  * conversation. `/group` (`/g`) just creates a Lark group and replies once —
@@ -40,7 +42,7 @@ export const DAEMON_COMMANDS = new Set(['/close', '/restart', '/status', '/help'
  * card buttons routable, but for these that record is a phantom conversation
  * that pollutes the dashboard's session list. Handle them without a session.
  */
-export const SESSIONLESS_DAEMON_COMMANDS = new Set(['/group', '/g']);
+export const SESSIONLESS_DAEMON_COMMANDS = new Set(['/group', '/g', '/list-slash-command', '/slash']);
 /**
  * Slash commands that are forwarded verbatim to the underlying CLI (e.g.
  * Claude Code's `/compact`, `/model`, `/usage`). The daemon does NOT handle
@@ -56,6 +58,30 @@ export const PASSTHROUGH_COMMANDS = new Set([
     // Codex：/btw 向当前会话追加一条旁注/引导消息
     '/btw',
 ]);
+/**
+ * Effective passthrough set for a bot: the fixed {@link PASSTHROUGH_COMMANDS}
+ * plus the bot's `customPassthroughCommands` (bots.json). Entries that would
+ * shadow a botmux daemon command are dropped — daemon commands must keep their
+ * daemon semantics, and passthrough is checked BEFORE DAEMON_COMMANDS in the
+ * router, so an un-filtered custom `/status` would hijack the daemon's own.
+ * Unknown / no bot → falls back to the builtin set unchanged.
+ */
+export function resolvePassthroughCommands(larkAppId) {
+    const effective = new Set(PASSTHROUGH_COMMANDS);
+    if (!larkAppId)
+        return effective;
+    try {
+        for (const c of getBot(larkAppId).config.customPassthroughCommands ?? []) {
+            if (DAEMON_COMMANDS.has(c))
+                continue; // never shadow a daemon command
+            effective.add(c);
+        }
+    }
+    catch {
+        /* unknown bot — builtin set only */
+    }
+    return effective;
+}
 const MULTILINE_COMMANDS = new Set(['/schedule', '/role']);
 // `validateWorkingDir` now lives in ./working-dir.js (leaf module the CLI can
 // import without the daemon graph); re-exported here for existing callers.
@@ -843,16 +869,17 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
             }
             case '/login': {
                 const subCmd = message.content.replace(/^\/login\s*/, '').trim();
-                if (subCmd === 'status' || subCmd === '状态') {
-                    await sessionReply(rootId, getTokenStatus());
-                    break;
-                }
+                // 先定位本 bot 配置——token 状态与 OAuth URL 都按 per-bot appId/brand 走。
                 const botCfg2 = ds ? getBot(ds.larkAppId).config : (larkAppId ? getBot(larkAppId).config : getAllBots()[0]?.config);
                 if (!botCfg2?.larkAppId || !botCfg2?.larkAppSecret) {
                     await sessionReply(rootId, t('cmd.login.no_credentials', undefined, loc));
                     break;
                 }
-                const { authUrl } = generateAuthUrl(botCfg2.larkAppId, botCfg2.larkAppSecret);
+                if (subCmd === 'status' || subCmd === '状态') {
+                    await sessionReply(rootId, getTokenStatus(botCfg2.larkAppId, normalizeBrand(botCfg2.brand)));
+                    break;
+                }
+                const { authUrl } = generateAuthUrl(botCfg2.larkAppId, botCfg2.larkAppSecret, normalizeBrand(botCfg2.brand));
                 await sessionReply(rootId, [
                     t('cmd.login.title', undefined, loc),
                     '',
@@ -1133,7 +1160,7 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     });
                     // Prefer the shareable join link (others can click to *join*); fall
                     // back to the member-only applink URL when Lark's link API failed.
-                    const applink = `https://applink.feishu.cn/client/chat/open?openChatId=${encodeURIComponent(result.chatId)}`;
+                    const applink = chatAppLink(result.chatId, normalizeBrand(getBot(creatorAppId).config.brand));
                     const link = result.shareLink ?? applink;
                     // Partial failures are non-fatal — the chat exists; surface them as
                     // hints so the user knows whether to expect to be auto-invited.
@@ -1436,7 +1463,7 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                         transferOwnerTo: senderOpenId,
                     });
                     newChatId = result.chatId;
-                    const applink = `https://applink.feishu.cn/client/chat/open?openChatId=${encodeURIComponent(result.chatId)}`;
+                    const applink = chatAppLink(result.chatId, normalizeBrand(getBot(creatorAppId).config.brand));
                     inviteLink = result.shareLink ?? applink;
                 }
                 catch (err) {
@@ -1658,6 +1685,27 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                 await handleCardCommand(rootId, appId, cardChatId, message.senderId, message.content, deps);
                 break;
             }
+            case '/list-slash-command':
+            case '/slash': {
+                // 列出本 bot 当前可用的 slash 命令，分三段：
+                //   ① botmux 固定放行的透传白名单（PASSTHROUGH_COMMANDS）
+                //   ② 用户在 bots.json 自定义配置的额外透传命令（customPassthroughCommands）
+                //   ③ 文件系统自动发现的 .claude 自定义命令 / skill / 插件（discoverSlashCommands）
+                // MCP 的 /mcp__<server>__<prompt> 需运行时握手才能枚举，这里仅按 .mcp.json 提示 server 名。
+                const botCfg = ds
+                    ? getBot(ds.larkAppId).config
+                    : (larkAppId ? getBot(larkAppId).config : getAllBots()[0]?.config);
+                const cliName = getCliDisplayName(botCfg?.cliId ?? 'claude-code');
+                const workingDir = getSessionWorkingDir(ds);
+                const builtin = [...PASSTHROUGH_COMMANDS];
+                const custom = botCfg?.customPassthroughCommands ?? [];
+                const discovered = discoverSlashCommands(workingDir);
+                const mcpServers = listMcpServerNames(workingDir);
+                const card = buildSlashListCard({ cliName, builtin, custom, discovered, workingDir, mcpServers }, loc);
+                await sessionReply(rootId, card, 'interactive');
+                logger.info(`[${logTag}] /list-slash-command builtin=${builtin.length} custom=${custom.length} discovered=${discovered.length}`);
+                break;
+            }
             case '/help': {
                 const botCfg = ds ? getBot(ds.larkAppId).config : getAllBots()[0]?.config;
                 const cliName = getCliDisplayName(botCfg?.cliId ?? 'claude-code');
@@ -1706,6 +1754,7 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     t('help.heading_group', undefined, loc),
                     t('help.group', undefined, loc),
                     '',
+                    t('help.list_slash', undefined, loc),
                     t('help.help', undefined, loc),
                 ];
                 await sessionReply(rootId, help.join('\n'));