botmux 3.9.2 → 3.10.0

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

@@ -24,12 +24,11 @@ export declare const SESSIONLESS_DAEMON_COMMANDS: Set<string>;
 export declare function formatSlashGroupName(name: string, prefix?: string): string;
 /**
  * Daemon commands that operate on an ALREADY-EXISTING session and must never
- * pre-create one. `/rename` renames the current session — with no session there
- * is nothing to rename, so the daemon routes must skip their generic
+ * pre-create one. With no real session to operate on, the daemon routes must skip their generic
  * "createSession + activeSessions.set(worker:null)" pre-create block and let
- * handleCommand's `!ds` branch reply no_active_session. Without this, `/rename`
+ * handleCommand's `!ds` branch reply no_active_session. Without this, one of these commands
  * in a brand-new topic (or a thread with no session) would spawn a phantom
- * worker:null session just to rename it, polluting the dashboard. (Same class
+ * worker:null session just to handle it, polluting the dashboard. (Same class
  * of fix as the `/card` / `/term` special cases in daemon.ts.)
  */
 export declare const EXISTING_SESSION_ONLY_DAEMON_COMMANDS: Set<string>;
@@ -146,4 +145,19 @@ export declare function discoverResumableSessionsForBot(cliId: CliId, cliPathOve
  *  CLI via `--resume <cliSessionId>` in `cwd`. Mirrors the manual resume path —
  *  the worker owns the CLI (NOT an observe-adopt), so no `adoptedFrom` is set. */
 export declare function startResumeImportSession(target: ResumableSession, ds: DaemonSession, deps: CommandHandlerDeps, larkAppId?: string): Promise<void>;
+type ForkSubtopicResult = {
+    ok: true;
+    childSessionId: string;
+    anchorId: string;
+    link: string;
+} | {
+    ok: false;
+    error: string;
+    orphanTopic: boolean;
+};
+/** Fork the current session into a new sub-topic of the same topic group.
+ *  The session copy itself stays in worker-pool's generic `forkSession()`;
+ *  this layer only creates the Lark destination, supplies the first task turn,
+ *  and records display-only lineage for the parent panel. */
+export declare function startForkSubtopicSession(taskText: string, parentDs: DaemonSession, message: LarkMessage, larkAppId?: string): Promise<ForkSubtopicResult>;
 //# sourceMappingURL=command-handler.d.ts.map

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

package/dist/core/command-handler.js

@@ -15,12 +15,12 @@ import { scanMultipleProjects, describeProjectDir } from '../services/project-sc
 import { createRepoWorktree, pushWorktreeBranch } from '../services/git-worktree.js';
 import { worktreeSlugFromContextAI } from '../services/worktree-slug-ai.js';
 import { resolvePairedSpawnBackendType } from './persistent-backend.js';
-import { buildRepoSelectCard, buildAdoptSelectCard, buildCodexAppThreadSelectCard, buildSlashListCard, getCliDisplayName, buildConfigCard, buildAdoptBlockedCard } from '../im/lark/card-builder.js';
+import { buildRepoSelectCard, buildAdoptSelectCard, buildCodexAppThreadSelectCard, buildSlashListCard, getCliDisplayName, buildConfigCard, buildForkPanelCard, buildAdoptBlockedCard } from '../im/lark/card-builder.js';
 import { handleDashboardCommand } from './dashboard-command/index.js';
 import { createCliAdapterSync } from '../adapters/cli/registry.js';
 import { resolveCliRuntime, runtimeInstallationKey } from '../adapters/cli/runtime.js';
-import { deleteMessage, sendMessage, sendUserMessage, replyMessage, listChatBotMembers, resolveUserUnionId, getChatModeStrict, UserTokenMissingError } from '../im/lark/client.js';
-import { chatAppLink, normalizeBrand } from '../im/lark/lark-hosts.js';
+import { deleteMessage, sendMessage, sendUserMessage, replyMessage, listChatBotMembers, resolveUserUnionId, getChatModeStrict, getMessageThreadId, UserTokenMissingError } from '../im/lark/client.js';
+import { chatAppLink, threadAppLink, normalizeBrand } from '../im/lark/lark-hosts.js';
 import { claimPairing } from '../services/pairing-store.js';
 import { logger } from '../utils/logger.js';
 import { scheduleTimeZone } from '../utils/timezone.js';
@@ -96,15 +96,14 @@ export function formatSlashGroupName(name, prefix = '') {
 }
 /**
  * Daemon commands that operate on an ALREADY-EXISTING session and must never
- * pre-create one. `/rename` renames the current session — with no session there
- * is nothing to rename, so the daemon routes must skip their generic
+ * pre-create one. With no real session to operate on, the daemon routes must skip their generic
  * "createSession + activeSessions.set(worker:null)" pre-create block and let
- * handleCommand's `!ds` branch reply no_active_session. Without this, `/rename`
+ * handleCommand's `!ds` branch reply no_active_session. Without this, one of these commands
  * in a brand-new topic (or a thread with no session) would spawn a phantom
- * worker:null session just to rename it, polluting the dashboard. (Same class
+ * worker:null session just to handle it, polluting the dashboard. (Same class
  * of fix as the `/card` / `/term` special cases in daemon.ts.)
  */
-export const EXISTING_SESSION_ONLY_DAEMON_COMMANDS = new Set(['/rename']);
+export const EXISTING_SESSION_ONLY_DAEMON_COMMANDS = new Set(['/rename', '/fork', '/forklist']);
 export function resolveAdapterDefaultPassthroughCommands(larkAppId) {
     if (!larkAppId)
         return [];
@@ -148,7 +147,7 @@ export function resolvePassthroughCommands(larkAppId) {
     }
     return effective;
 }
-const MULTILINE_COMMANDS = new Set(['/schedule', '/role']);
+const MULTILINE_COMMANDS = new Set(['/schedule', '/role', '/fork']);
 // `validateWorkingDir` now lives in ./working-dir.js (leaf module the CLI can
 // import without the daemon graph); re-exported here for existing callers.
 export { validateWorkingDir };
@@ -1409,7 +1408,8 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                         // shared in-flight claim instead of treating this as a repo switch.
                         const initiallyBuffered = (ds.pendingPrompt?.trim().length ?? 0) > 0 ||
                             (ds.pendingAttachments?.length ?? 0) > 0 ||
-                            (ds.pendingFollowUps?.length ?? 0) > 0;
+                            (ds.pendingFollowUps?.length ?? 0) > 0 ||
+                            ds.pendingChatContext !== undefined;
                         const availableBots = initiallyBuffered
                             ? await getAvailableBots(ds.larkAppId, ds.chatId)
                             : [];
@@ -1423,7 +1423,8 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                         const pendingRawInput = ds.pendingRawInput;
                         const hasBufferedInput = pendingPrompt.trim().length > 0 ||
                             (ds.pendingAttachments?.length ?? 0) > 0 ||
-                            (ds.pendingFollowUps?.length ?? 0) > 0;
+                            (ds.pendingFollowUps?.length ?? 0) > 0 ||
+                            ds.pendingChatContext !== undefined;
                         // Nothing to submit at all (bare `/repo`: the message IS the command).
                         // The CLI boots idle, so the user's NEXT real message is its first
                         // turn and must carry the full new-topic opening — see
@@ -1442,6 +1443,7 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                                 codexAppMessageContext: ds.pendingCodexAppMessageContext,
                                 codexAppFollowUps: ds.pendingCodexAppFollowUps,
                                 codexAppFollowUpContexts: ds.pendingCodexAppFollowUpContexts,
+                                chatContext: ds.pendingChatContext,
                             })
                             : { content: '' };
                         const pendingTurnId = ds.pendingTurnId;
@@ -1490,6 +1492,7 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                         ds.pendingCodexAppText = undefined;
                         ds.pendingCodexAppApplicationContext = undefined;
                         ds.pendingCodexAppMessageContext = undefined;
+                        ds.pendingChatContext = undefined;
                         ds.pendingAttachments = undefined;
                         ds.pendingMentions = undefined;
                         ds.pendingSubstituteTrigger = undefined;
@@ -3307,8 +3310,8 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
             case '/fork': {
                 // Session fork (Bot 分身): non-destructive copy of a running session
                 // into a SECOND independent session at a new anchor; source untouched.
-                // PR1 scope: `--create <群名> @bot` (fork to a freshly-created group).
-                // The no-arg picker (fork into the current group) is a follow-up.
+                // `/fork <task>` hosts it in a new sub-topic of the same topic group;
+                // `/fork --create <name>` keeps the existing new-group destination.
                 const argsLine = message.content.replace(/^\/fork\s*/i, '').trim();
                 const forkAppId = larkAppId ?? ds?.larkAppId;
                 if (!forkAppId) {
@@ -3338,20 +3341,8 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     await sessionReply(rootId, t('cmd.fork.unsupported_backend', { cli: cliName }, loc));
                     break;
                 }
-                if (!/^--create\b/i.test(argsLine)) {
-                    // No-arg picker path ("fork into an existing group you pick") is not
-                    // built yet. Don't reuse the no-session copy — the user often DOES
-                    // have a session here (that's exactly the confusing case). Tell them
-                    // the picker is pending and point at the working --create form.
-                    await sessionReply(rootId, t('cmd.fork.picker_pending', undefined, loc));
-                    break;
-                }
-                // ── /fork --create <群名> @bot ──────────────────────────────────────
-                const afterFlag = argsLine.replace(/^--create\s*/i, '').trim();
                 // Front guards (fork needs a clean, real, idle source — same as relay).
-                // These MUST run before createGroupWithBots, otherwise a refusal (e.g.
-                // /fork typed at a chat top-level where ds is an empty scratch, while
-                // the real session lives in a 话题) leaves an orphan empty group.
+                // These MUST run before creating either a topic root or a new group.
                 if (ds.session.adoptedFrom) {
                     await sessionReply(rootId, t('cmd.fork.adopt_not_forkable', undefined, loc));
                     break;
@@ -3375,6 +3366,55 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     await sessionReply(rootId, t('cmd.fork.mid_turn', undefined, loc));
                     break;
                 }
+                if (!/^--create\b/i.test(argsLine)) {
+                    if (!argsLine) {
+                        await sessionReply(rootId, t('cmd.fork.subtopic_usage', undefined, loc));
+                        break;
+                    }
+                    if (ds.scope !== 'thread' || !ds.session.rootMessageId?.startsWith('om_')) {
+                        await sessionReply(rootId, t('cmd.fork.subtopic_thread_only', undefined, loc));
+                        break;
+                    }
+                    let chatMode;
+                    try {
+                        chatMode = await getChatModeStrict(forkAppId, ds.chatId);
+                    }
+                    catch {
+                        // Treat an unknown mode as unsupported: sending a top-level message
+                        // to a regular group would not create the isolated topic we promise.
+                    }
+                    if (chatMode !== 'topic') {
+                        await sessionReply(rootId, t('cmd.fork.subtopic_thread_only', undefined, loc));
+                        break;
+                    }
+                    const result = await startForkSubtopicSession(argsLine, ds, message, forkAppId);
+                    if (!result.ok) {
+                        const errKey = result.error === 'worker_busy' ? 'cmd.fork.mid_turn'
+                            : result.error === 'adopt_not_forkable' ? 'cmd.fork.adopt_not_forkable'
+                                : result.error === 'fork_unsupported_backend' ? 'cmd.fork.unsupported_backend'
+                                    : result.error === 'not_started_yet' ? 'cmd.fork.not_started_yet'
+                                        : undefined;
+                        if (errKey === 'cmd.fork.unsupported_backend') {
+                            const cliName = getCliDisplayName((ds.session.cliId ?? getBot(forkAppId).config.cliId ?? 'claude-code'));
+                            await sessionReply(rootId, t(errKey, { cli: cliName }, loc));
+                        }
+                        else if (errKey) {
+                            await sessionReply(rootId, t(errKey, undefined, loc));
+                        }
+                        else {
+                            await sessionReply(rootId, t('cmd.fork.failed', { error: result.error }, loc));
+                        }
+                        if (result.orphanTopic) {
+                            await sessionReply(rootId, t('cmd.fork.orphan_topic_left', undefined, loc));
+                        }
+                        break;
+                    }
+                    await sessionReply(rootId, t('cmd.fork.subtopic_created', { link: result.link }, loc));
+                    logger.info(`[${logTag}] /fork sub-topic completed: child=${result.childSessionId.substring(0, 8)} anchor=${result.anchorId.substring(0, 12)} (source ${ds.session.sessionId.substring(0, 8)} untouched)`);
+                    break;
+                }
+                // ── /fork --create <群名> @bot ──────────────────────────────────────
+                const afterFlag = argsLine.replace(/^--create\s*/i, '').trim();
                 // Resolve the bot to invite into the new group. Fork copies THIS
                 // session's transcript, so the child MUST run the same bot as the
                 // source — i.e. the invited bot is always this bot. Therefore:
@@ -3489,6 +3529,14 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                 logger.info(`[${logTag}] /fork --create completed: chat=${forkChatId} child=${forkResult.childSessionId.substring(0, 8)} bot=${targetBotAppId} (source ${ds.session.sessionId.substring(0, 8)} untouched)`);
                 break;
             }
+            case '/forklist': {
+                if (!ds) {
+                    await sessionReply(rootId, t('cmd.fork.no_session', undefined, loc));
+                    break;
+                }
+                await upsertForkPanelCard(ds, loc, { allowEmpty: true });
+                break;
+            }
             case '/card': {
                 // Existing-session path. New topics route /card via handleCardCommand at
                 // the router (so no phantom session is created). off/on work without a
@@ -3607,6 +3655,7 @@ export async function handleCommand(cmd, rootId, message, deps, larkAppId) {
                     t('help.relay', undefined, loc),
                     t('help.relay_create', undefined, loc),
                     t('help.fork', undefined, loc),
+                    t('help.forklist', undefined, loc),
                     '',
                     t('help.heading_login', undefined, loc),
                     t('help.login', undefined, loc),
@@ -3897,4 +3946,163 @@ export async function startResumeImportSession(target, ds, deps, larkAppId) {
     const cliName = sessionCliDisplayName(ds);
     await sessionReply(sessionAnchorId(ds), t('cmd.adopt.resume_success', { cliName, project, title: target.title || target.cliSessionId.slice(0, 8) }, loc));
 }
+/** Fork the current session into a new sub-topic of the same topic group.
+ *  The session copy itself stays in worker-pool's generic `forkSession()`;
+ *  this layer only creates the Lark destination, supplies the first task turn,
+ *  and records display-only lineage for the parent panel. */
+export async function startForkSubtopicSession(taskText, parentDs, message, larkAppId) {
+    const appId = parentDs.larkAppId ?? larkAppId;
+    if (!appId)
+        return { ok: false, error: 'missing_lark_app_id', orphanTopic: false };
+    const loc = localeForBot(appId);
+    const bot = getBot(appId);
+    const botCfg = bot.config;
+    const parentSession = parentDs.session;
+    const chatId = parentDs.chatId;
+    const brand = normalizeBrand(botCfg.brand);
+    const taskTitle = taskText.split(/\r?\n/).map(line => line.trim()).find(Boolean)?.slice(0, 60)
+        ?? taskText.slice(0, 60);
+    const senderIsBot = message.senderType === 'app' || message.senderType === 'bot';
+    const triggerSender = {
+        openId: message.senderId,
+        type: senderIsBot ? 'bot' : 'user',
+        ...(message.senderName ? { name: message.senderName } : {}),
+    };
+    let anchorId;
+    const recallAnchor = async () => {
+        if (!anchorId)
+            return true;
+        try {
+            return await deleteMessage(appId, anchorId);
+        }
+        catch (err) {
+            logger.warn(`[${parentSession.sessionId.substring(0, 8)}] /fork sub-topic recall failed: `
+                + `${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+    };
+    try {
+        let parentThreadId = parentSession.larkThreadId ?? message.threadId;
+        if (!parentThreadId) {
+            parentThreadId = (await getMessageThreadId(appId, parentSession.rootMessageId)) ?? undefined;
+        }
+        if (parentThreadId && parentSession.larkThreadId !== parentThreadId) {
+            parentSession.larkThreadId = parentThreadId;
+            sessionStore.updateSession(parentSession);
+        }
+        const parentLink = parentThreadId
+            ? threadAppLink(chatId, parentThreadId, brand)
+            : chatAppLink(chatId, brand);
+        const localeKey = loc === 'en' ? 'en_us' : 'zh_cn';
+        const seedPost = JSON.stringify({
+            [localeKey]: {
+                title: `${t('cmd.fork.badge', undefined, loc)} ${taskText.replace(/\s*\n+\s*/g, ' ').slice(0, 300)}`,
+                content: [[
+                        ...(senderIsBot ? [] : [{ tag: 'at', user_id: message.senderId }]),
+                        {
+                            tag: 'text',
+                            text: `${senderIsBot ? '' : ' '}${t('cmd.fork.seed_parent_line', { title: parentSession.title || '' }, loc)} `,
+                        },
+                        { tag: 'a', text: t('cmd.fork.seed_back_link', undefined, loc), href: parentLink },
+                    ]],
+            },
+        });
+        anchorId = await sendMessage(appId, chatId, seedPost, 'post');
+        const childThreadId = (await getMessageThreadId(appId, anchorId)) ?? undefined;
+        const childIntro = t('cmd.fork.child_intro', {
+            parentTitle: parentSession.title || '',
+            parentSessionId: parentSession.sessionId,
+            parentRootId: parentSession.rootMessageId,
+        }, loc);
+        const availableBots = await getAvailableBots(appId, chatId);
+        const childCliId = parentSession.cliId ?? botCfg.cliId;
+        const { forkSession } = await import('./worker-pool.js');
+        const forkResult = await forkSession(parentSession.sessionId, chatId, anchorId, 'group', 'thread', {
+            childTitle: `${t('cmd.fork.badge', undefined, loc)} ${taskTitle}`,
+            forkTaskText: taskText,
+            larkThreadId: childThreadId,
+            turnId: message.messageId,
+            senderOpenId: triggerSender.openId,
+            senderIsBot,
+            buildInitialPrompt: childSessionId => buildNewTopicCliInput(`${childIntro}\n\n${taskText}`, childSessionId, childCliId, botCfg.cliPathOverride, undefined, undefined, availableBots, undefined, { name: bot.botName, openId: bot.botOpenId }, loc, triggerSender, { larkAppId: appId, chatId }),
+        });
+        if (!forkResult.ok) {
+            const orphanTopic = !await recallAnchor();
+            return { ok: false, error: forkResult.error, orphanTopic };
+        }
+        if (!parentSession.forkChildSessionIds?.includes(forkResult.childSessionId)) {
+            parentSession.forkChildSessionIds = [
+                ...(parentSession.forkChildSessionIds ?? []),
+                forkResult.childSessionId,
+            ];
+            try {
+                sessionStore.updateSession(parentSession);
+            }
+            catch (err) {
+                logger.warn(`[${parentSession.sessionId.substring(0, 8)}] /fork parent lineage update failed: `
+                    + `${err instanceof Error ? err.message : String(err)}`);
+            }
+        }
+        try {
+            await upsertForkPanelCard(parentDs, loc);
+        }
+        catch (err) {
+            logger.warn(`[${parentSession.sessionId.substring(0, 8)}] /fork panel refresh failed: `
+                + `${err instanceof Error ? err.message : String(err)}`);
+        }
+        return {
+            ok: true,
+            childSessionId: forkResult.childSessionId,
+            anchorId,
+            link: childThreadId ? threadAppLink(chatId, childThreadId, brand) : chatAppLink(chatId, brand),
+        };
+    }
+    catch (err) {
+        logger.error(`[${parentSession.sessionId.substring(0, 8)}] /fork sub-topic failed: `
+            + `${err instanceof Error ? err.message : String(err)}`);
+        return {
+            ok: false,
+            error: anchorId ? 'fork_subtopic_failed' : 'topic_creation_failed',
+            orphanTopic: anchorId ? !await recallAnchor() : false,
+        };
+    }
+}
+/** Re-post the parent session's fork panel at the bottom of the topic. Reading
+ *  each child row from the store keeps `/forklist` status current without
+ *  coupling child lifecycle to its parent. */
+async function upsertForkPanelCard(parentDs, loc, opts) {
+    const appId = parentDs.larkAppId;
+    const chatId = parentDs.chatId;
+    const brand = normalizeBrand(getBot(appId).config.brand);
+    const children = (parentDs.session.forkChildSessionIds ?? [])
+        .map(sessionId => sessionStore.getSession(sessionId))
+        .filter((session) => !!session)
+        .map(session => ({
+        instruction: session.forkTaskText ?? session.title,
+        status: (session.status === 'active' ? 'active' : 'closed'),
+        link: session.larkThreadId
+            ? threadAppLink(chatId, session.larkThreadId, brand)
+            : chatAppLink(chatId, brand),
+    }));
+    if (children.length === 0 && !opts?.allowEmpty)
+        return;
+    const staleCardId = parentDs.session.forkPanelCardId;
+    if (staleCardId) {
+        try {
+            await deleteMessage(appId, staleCardId);
+        }
+        catch {
+            // It may already be withdrawn or past Lark's recall window. Posting the
+            // fresh panel is still more useful than keeping the command silent.
+        }
+    }
+    try {
+        const cardId = await replyMessage(appId, parentDs.session.rootMessageId, buildForkPanelCard(children, loc), 'interactive', true);
+        parentDs.session.forkPanelCardId = cardId;
+        sessionStore.updateSession(parentDs.session);
+    }
+    catch (err) {
+        logger.warn(`[fork-panel] failed to post panel card: ${err instanceof Error ? err.message : err}`);
+    }
+}
 //# sourceMappingURL=command-handler.js.map