botmux 2.64.0 → 2.65.0

package/dist/core/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAiBA;;6DAE6D;AAC7D,MAAM,UAAU,iBAAiB,CAAC,EAAc;IAC9C,IAAI,EAAE,CAAC,WAAW,KAAK,YAAY,IAAI,EAAE,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,WAAW,CAAC;IAC1F,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC/C,CAAC;AAqGD;;;;;uDAKuD;AACvD,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,SAAiB;IAC5D,OAAO,GAAG,QAAQ,KAAK,SAAS,EAAE,CAAC;AACrC,CAAC;AAED;;+BAE+B;AAC/B,MAAM,UAAU,eAAe,CAAC,EAAiB;IAC/C,OAAO,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;AACpE,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAiBA;;6DAE6D;AAC7D,MAAM,UAAU,iBAAiB,CAAC,EAAc;IAC9C,IAAI,EAAE,CAAC,WAAW,KAAK,YAAY,IAAI,EAAE,CAAC,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC,WAAW,CAAC;IAC1F,OAAO,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC/C,CAAC;AA6GD;;;;;uDAKuD;AACvD,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,SAAiB;IAC5D,OAAO,GAAG,QAAQ,KAAK,SAAS,EAAE,CAAC;AACrC,CAAC;AAED;;+BAE+B;AAC/B,MAAM,UAAU,eAAe,CAAC,EAAiB;IAC/C,OAAO,EAAE,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,aAAa,CAAC;AACpE,CAAC"}

package/dist/core/worker-budget.d.ts

@@ -0,0 +1,19 @@
+import type { WorkerConfig } from '../global-config.js';
+export declare const MIN_AUTO_MAX_LIVE_WORKERS = 4;
+export declare const MAX_AUTO_MAX_LIVE_WORKERS = 32;
+export declare const DEFAULT_IDLE_SUSPEND_MS: number;
+export interface WorkerResources {
+    cpuCount: number;
+    memoryBytes: number;
+}
+export interface ResolvedWorkerBudget {
+    maxLiveWorkers: number;
+    idleSuspendMs: number;
+    autoMaxLiveWorkers: number;
+    maxLiveWorkersSource: 'auto' | 'config';
+    idleSuspendMsSource: 'default' | 'config';
+}
+export declare function detectWorkerResources(): WorkerResources;
+export declare function autoMaxLiveWorkers(resources?: WorkerResources): number;
+export declare function resolveWorkerBudget(workerConfig?: WorkerConfig, resources?: WorkerResources): ResolvedWorkerBudget;
+//# sourceMappingURL=worker-budget.d.ts.map

package/dist/core/worker-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-budget.d.ts","sourceRoot":"","sources":["../../src/core/worker-budget.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,KAAK,CAAC;AAC5C,eAAO,MAAM,uBAAuB,QAAc,CAAC;AAEnD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxC,mBAAmB,EAAE,SAAS,GAAG,QAAQ,CAAC;CAC3C;AAwBD,wBAAgB,qBAAqB,IAAI,eAAe,CAMvD;AAED,wBAAgB,kBAAkB,CAAC,SAAS,GAAE,eAAyC,GAAG,MAAM,CAI/F;AAED,wBAAgB,mBAAmB,CACjC,YAAY,CAAC,EAAE,YAAY,EAC3B,SAAS,GAAE,eAAyC,GACnD,oBAAoB,CAStB"}

package/dist/core/worker-budget.js

@@ -0,0 +1,50 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { availableParallelism, totalmem } from 'node:os';
+export const MIN_AUTO_MAX_LIVE_WORKERS = 4;
+export const MAX_AUTO_MAX_LIVE_WORKERS = 32;
+export const DEFAULT_IDLE_SUSPEND_MS = 30 * 60_000;
+function clamp(n, min, max) {
+    return Math.max(min, Math.min(max, n));
+}
+function readMemoryLimitFile(path) {
+    if (!existsSync(path))
+        return undefined;
+    const raw = readFileSync(path, 'utf-8').trim();
+    if (!raw || raw === 'max')
+        return undefined;
+    const n = Number(raw);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+function cgroupMemoryLimitBytes(hostMemoryBytes) {
+    const limits = [
+        readMemoryLimitFile('/sys/fs/cgroup/memory.max'),
+        readMemoryLimitFile('/sys/fs/cgroup/memory/memory.limit_in_bytes'),
+    ].filter((n) => n !== undefined);
+    if (limits.length === 0)
+        return undefined;
+    const limit = Math.min(...limits);
+    return limit < hostMemoryBytes ? limit : undefined;
+}
+export function detectWorkerResources() {
+    const hostMemoryBytes = totalmem();
+    return {
+        cpuCount: Math.max(1, availableParallelism?.() ?? 1),
+        memoryBytes: cgroupMemoryLimitBytes(hostMemoryBytes) ?? hostMemoryBytes,
+    };
+}
+export function autoMaxLiveWorkers(resources = detectWorkerResources()) {
+    const cpuBudget = Math.max(1, resources.cpuCount) * 2;
+    const memoryBudget = Math.max(1, Math.round(resources.memoryBytes / 1024 ** 3));
+    return clamp(Math.min(cpuBudget, memoryBudget), MIN_AUTO_MAX_LIVE_WORKERS, MAX_AUTO_MAX_LIVE_WORKERS);
+}
+export function resolveWorkerBudget(workerConfig, resources = detectWorkerResources()) {
+    const auto = autoMaxLiveWorkers(resources);
+    return {
+        maxLiveWorkers: workerConfig?.maxLiveWorkers ?? auto,
+        idleSuspendMs: workerConfig?.idleSuspendMs ?? DEFAULT_IDLE_SUSPEND_MS,
+        autoMaxLiveWorkers: auto,
+        maxLiveWorkersSource: workerConfig?.maxLiveWorkers === undefined ? 'auto' : 'config',
+        idleSuspendMsSource: workerConfig?.idleSuspendMs === undefined ? 'default' : 'config',
+    };
+}
+//# sourceMappingURL=worker-budget.js.map

package/dist/core/worker-budget.js.map

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

package/dist/core/worker-pool.d.ts

@@ -4,11 +4,12 @@
  */
 import { type ChildProcess } from 'node:child_process';
 import type { CliId } from '../adapters/cli/types.js';
+import type { BackendType } from '../adapters/backend/types.js';
 import type { WorkerToDaemon, Session } from '../types.js';
 import { type DaemonSession } from './types.js';
 import { type CliUsageLimitState } from '../utils/cli-usage-limit.js';
 export interface WorkerPoolCallbacks {
-    sessionReply: (rootId: string, content: string, msgType?: string, larkAppId?: string) => Promise<string>;
+    sessionReply: (rootId: string, content: string, msgType?: string, larkAppId?: string, turnId?: string) => Promise<string>;
     getSessionWorkingDir: (ds?: DaemonSession) => string;
     getActiveCount: () => number;
     /** Close a stale session (message withdrawn, etc.) */
@@ -107,7 +108,7 @@ export declare function recallFrozenCards(ds: DaemonSession): void;
  * Note: this does NOT itself flip `ds.streamingCardForced` — the caller sets
  * that so the card keeps live-patching afterwards even when the bot opted out.
  */
-export declare function postFreshStreamingCard(ds: DaemonSession, sessionReply: (rootId: string, content: string, msgType?: string, larkAppId?: string) => Promise<string>): Promise<boolean>;
+export declare function postFreshStreamingCard(ds: DaemonSession, sessionReply: (rootId: string, content: string, msgType?: string, larkAppId?: string, turnId?: string) => Promise<string>): Promise<boolean>;
 /**
  * Audience for a private `/card`: the bot's `allowedUsers` (the canOperate set —
  * owner & co-owners), deduped, `ou_` only. Talk-only grants (`globalGrants` /
@@ -189,6 +190,8 @@ export declare function ensureCliEnv(cliId: CliId, cliPathOverride?: string): vo
  *  clobbers other keys; any failure is swallowed so it can't block spawn. */
 export declare function ensureClaudeFolderTrust(workingDir: string, stateJsonPath?: string): void;
 export declare function killWorker(ds: DaemonSession): void;
+export declare function isSuspendableBackendType(backendType: BackendType | undefined): boolean;
+export declare function suspendWorker(ds: DaemonSession, reason?: string): boolean;
 /**
  * Idempotent close: kill worker if alive, mark Session status='closed' + closedAt,
  * publish session.exited (if a live worker was killed) and session.update

package/dist/core/worker-pool.d.ts.map

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

package/dist/core/worker-pool.js

@@ -32,6 +32,7 @@ import { dashboardEventBus } from './dashboard-events.js';
 import { composeRowFromActive } from './dashboard-rows.js';
 import { publishAttentionPatch } from './session-activity.js';
 import { knownBotOpenIdsFromCrossRef } from '../utils/bot-routing.js';
+import { emitSessionLifecycleHook, emitSessionStateTransitionHook } from '../services/session-lifecycle-hooks.js';
 import { sessionKey, sessionAnchorId } from './types.js';
 import { claimPendingResponseCard, COMPLETED_REACTION_EMOJI_TYPE, markPendingResponseCardPatchedIfCurrent, syncPendingResponseState } from './pending-response.js';
 import { buildTerminalUrl } from './terminal-url.js';
@@ -375,7 +376,7 @@ export async function postFreshStreamingCard(ds, sessionReply) {
     const cardJson = buildStreamingCard(ds.session.sessionId, sessionAnchorId(ds), readUrl, title, ds.lastScreenContent ?? '', status, effectiveCliId, ds.displayMode ?? 'hidden', ds.streamCardNonce, ds.currentImageKey, !!ds.adoptedFrom, false, localeForBot(ds.larkAppId), cardUsageLimit(ds), writableTerminalLinkFor(ds));
     ds.streamCardId = CARD_POSTING_SENTINEL;
     try {
-        ds.streamCardId = await sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId);
+        ds.streamCardId = await sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId, ds.currentReplyTarget?.turnId);
         // This card is now the live one for the current turn. Clear the new-turn
         // pending flag so the next screen_update PATCHes it instead of POSTing a
         // duplicate (the gate above only suppresses cards when disabled+unforced;
@@ -804,6 +805,41 @@ export function killWorker(ds) {
     ds.workerPort = null;
     ds.workerToken = null;
 }
+export function isSuspendableBackendType(backendType) {
+    return backendType === 'tmux' || backendType === 'herdr' || backendType === 'zellij';
+}
+export function suspendWorker(ds, reason = 'suspended_idle') {
+    if (!ds.worker || ds.worker.killed)
+        return false;
+    if (!isSuspendableBackendType(ds.initConfig?.backendType))
+        return false;
+    const w = ds.worker;
+    try {
+        w.send({ type: 'suspend' });
+    }
+    catch {
+        try {
+            w.kill('SIGTERM');
+        }
+        catch { /* already gone */ }
+    }
+    armWorkerKillBackstop(w, tag(ds));
+    ds.worker = null;
+    ds.workerPort = null;
+    ds.workerToken = null;
+    ds.session.webPort = undefined;
+    sessionStore.updateSessionPid(ds.session.sessionId, null);
+    sessionStore.updateSession(ds.session);
+    if (!ds.exitEventEmitted) {
+        ds.exitEventEmitted = true;
+        dashboardEventBus.publish({
+            type: 'session.exited',
+            body: { sessionId: ds.session.sessionId, reason },
+        });
+    }
+    logger.info(`[${tag(ds)}] Worker suspended (${reason}); session remains active`);
+    return true;
+}
 function armWorkerKillBackstop(w, label) {
     const sigterm = setTimeout(() => {
         if (w.exitCode === null && w.signalCode === null) {
@@ -851,6 +887,7 @@ export async function closeSession(sessionId) {
                 type: 'session.exited',
                 body: { sessionId, reason: 'dashboard_close' },
             });
+            emitSessionLifecycleHook(ds, 'session.exit', { reason: 'dashboard_close' });
         }
     }
     // Persistence path — load → mark closed → save (delegated to sessionStore).
@@ -1204,6 +1241,7 @@ export function forkWorker(ds, prompt, resume = false) {
         botName: bot.botName,
         botOpenId: bot.botOpenId,
         locale: botLocale(botCfg),
+        turnId: ds.currentReplyTarget?.turnId,
     };
     worker.send(initMsg);
     ds.initConfig = initMsg;
@@ -1230,11 +1268,16 @@ export function forkWorker(ds, prompt, resume = false) {
         type: 'session.spawned',
         body: { session: composeRowFromActive(ds) },
     });
+    emitSessionLifecycleHook(ds, 'session.start', {
+        reason: resume ? 'resume' : 'worker_spawn',
+        pid: worker.pid ?? null,
+    });
 }
 // ─── Shared worker IPC handler ──────────────────────────────────────────────
 function setupWorkerHandlers(ds, worker) {
     const cb = requireCallbacks();
     const t = tag(ds);
+    const scopedReply = (content, msgType, turnId) => cb.sessionReply(sessionAnchorId(ds), content, msgType, ds.larkAppId, turnId);
     const bot = getBot(ds.larkAppId);
     const botCfg = bot.config;
     const loc = botLocale(botCfg);
@@ -1274,6 +1317,15 @@ function setupWorkerHandlers(ds, worker) {
                     logger.info(`[${t}] Streaming card disabled for this bot — skipping card post`);
                     break;
                 }
+                // Restart recovery: stay silent in the group. The session was restored
+                // after a daemon restart; don't auto-post/patch a streaming card here.
+                // The owner gets a private DM summary instead, and the surviving card
+                // (if any) is left untouched. The next real user turn clears this flag
+                // (rememberLastCliInput) and the normal card flow resumes.
+                if (ds.suppressRecoveryCard) {
+                    logger.info(`[${t}] Restored session — suppressing recovery streaming card (silent restart)`);
+                    break;
+                }
                 // If a previous streaming card survived (e.g. daemon restart), try to
                 // PATCH it with the new "starting" state instead of POSTing a fresh card.
                 // ds.streamCardPending forces a new card (e.g. mid-session repo switch
@@ -1332,7 +1384,7 @@ function setupWorkerHandlers(ds, worker) {
                     // before the first screen_update lands. Fresh worker spawn
                     // has lastScreenContent undefined → '' (unchanged).
                     ds.lastScreenContent ?? '', initStatus, effectiveCliId, ds.displayMode ?? 'hidden', ds.streamCardNonce, ds.currentImageKey, isAdopt, showTakeover, loc, initStatus === 'limited' ? ds.usageLimit : undefined, writableTerminalLinkFor(ds));
-                    ds.streamCardId = await cb.sessionReply(sessionAnchorId(ds), streamCardJson, 'interactive', ds.larkAppId);
+                    ds.streamCardId = await scopedReply(streamCardJson, 'interactive', msg.turnId);
                     // This card IS the current turn's live card — clear the new-turn flag
                     // so subsequent screen_updates PATCH it (starting → working) instead of
                     // POSTing a second card. Without this, a re-fork that happens while
@@ -1366,7 +1418,7 @@ function setupWorkerHandlers(ds, worker) {
                     // Fallback: send static session card
                     try {
                         const cardJson = buildSessionCard(ds.session.sessionId, sessionAnchorId(ds), readOnlyUrl, ds.session.title || getCliDisplayName(effectiveCliId), effectiveCliId, undefined, !!ds.adoptedFrom, loc);
-                        await cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId);
+                        await scopedReply(cardJson, 'interactive', msg.turnId);
                     }
                     catch (fallbackErr) {
                         if (fallbackErr instanceof MessageWithdrawnError) {
@@ -1412,11 +1464,20 @@ function setupWorkerHandlers(ds, worker) {
                             },
                         },
                     });
+                    emitSessionStateTransitionHook(ds, prevStatus, ds.lastScreenStatus, {
+                        source: 'screen_update',
+                        content: msg.content,
+                    });
                 }
                 // Bot opted out of the streaming card — dashboard SSE above already got
                 // the status patch; just don't touch any Lark card.
                 if (streamingCardDisabled(ds))
                     break;
+                // Restart recovery: a restored worker may emit screen updates as the CLI
+                // redraws on resume. Stay silent (no post/patch) until the first real
+                // user turn clears the flag. Dashboard SSE above still reflects status.
+                if (ds.suppressRecoveryCard)
+                    break;
                 const readUrl = buildTerminalUrl(ds);
                 const turnTitle = ds.currentTurnTitle || ds.session.title || getCliDisplayName(effectiveCliId);
                 const mode = ds.displayMode ?? 'hidden';
@@ -1437,7 +1498,7 @@ function setupWorkerHandlers(ds, worker) {
                     // not POSTed as duplicate cards.
                     ds.streamCardPending = false;
                     ds.streamCardId = CARD_POSTING_SENTINEL;
-                    cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId)
+                    scopedReply(cardJson, 'interactive', msg.turnId)
                         .then(msgId => {
                         ds.streamCardId = msgId;
                         persistStreamCardState(ds);
@@ -1477,8 +1538,14 @@ function setupWorkerHandlers(ds, worker) {
                 if (ds.streamCardPending)
                     break;
                 ds.currentImageKey = msg.imageKey;
+                const prevStatus = ds.lastScreenStatus;
                 updateUsageLimitState(ds, msg.usageLimit);
                 ds.lastScreenStatus = (msg.usageLimit ?? ds.usageLimit) ? 'limited' : msg.status;
+                emitSessionStateTransitionHook(ds, prevStatus, ds.lastScreenStatus, {
+                    source: 'screenshot_uploaded',
+                    imageKey: msg.imageKey,
+                    content: ds.lastScreenContent ?? '',
+                });
                 persistStreamCardState(ds);
                 if ((ds.displayMode ?? 'hidden') !== 'screenshot')
                     break;
@@ -1501,6 +1568,18 @@ function setupWorkerHandlers(ds, worker) {
                 ds.tuiPromptOptions = msg.options;
                 ds.tuiPromptMultiSelect = msg.multiSelect;
                 ds.tuiToggledIndices = [];
+                emitSessionLifecycleHook(ds, 'session.requires_attention', {
+                    reason: 'tui_prompt',
+                    description: msg.description,
+                    optionsCount: msg.options.length,
+                    optionsPreview: msg.options.slice(0, 5).map(option => ({
+                        text: option.text,
+                        label: option.label,
+                        type: option.type,
+                        selected: option.selected,
+                    })),
+                    multiSelect: msg.multiSelect,
+                });
                 const prevTuiTurnTitle = ds.currentTurnTitle;
                 ds.currentTurnTitle = msg.description; // store for card PATCH on toggle
                 if (prevTuiTurnTitle !== ds.currentTurnTitle) {
@@ -1514,7 +1593,7 @@ function setupWorkerHandlers(ds, worker) {
                 }
                 try {
                     const cardJson = buildTuiPromptCard(sessionAnchorId(ds), ds.session.sessionId, msg.description, msg.options, msg.multiSelect, undefined, loc);
-                    const cardMsgId = await cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId);
+                    const cardMsgId = await scopedReply(cardJson, 'interactive', msg.turnId);
                     ds.tuiPromptCardId = cardMsgId;
                     publishAttentionPatch(ds);
                 }
@@ -1556,7 +1635,7 @@ function setupWorkerHandlers(ds, worker) {
                     // leave status='active' and still get the notice.
                     if (ds.session.status !== 'closed') {
                         try {
-                            await cb.sessionReply(sessionAnchorId(ds), tr('worker.adopted_session_exited', undefined, loc), 'text', ds.larkAppId);
+                            await scopedReply(tr('worker.adopted_session_exited', undefined, loc), 'text', undefined);
                         }
                         catch { /* best effort */ }
                     }
@@ -1584,7 +1663,7 @@ function setupWorkerHandlers(ds, worker) {
                     killWorker(ds);
                     const cliName = getCliDisplayName(effectiveCliId);
                     try {
-                        await cb.sessionReply(sessionAnchorId(ds), tr('worker.crash_loop_stopped', { cliName, count: rc.count }, loc), 'text', ds.larkAppId);
+                        await scopedReply(tr('worker.crash_loop_stopped', { cliName, count: rc.count }, loc), 'text', undefined);
                     }
                     catch (replyErr) {
                         if (replyErr instanceof MessageWithdrawnError) {
@@ -1607,8 +1686,12 @@ function setupWorkerHandlers(ds, worker) {
             }
             case 'user_notify': {
                 logger.warn(`[${t}] Worker user_notify: ${msg.message}`);
+                emitSessionLifecycleHook(ds, 'session.requires_attention', {
+                    reason: 'user_notify',
+                    message: msg.message,
+                });
                 try {
-                    await cb.sessionReply(sessionAnchorId(ds), msg.message, 'text', ds.larkAppId);
+                    await scopedReply(msg.message, 'text', msg.turnId);
                 }
                 catch (err) {
                     logger.error(`[${t}] Failed to deliver user_notify to Lark: ${err.message}`);
@@ -1654,7 +1737,7 @@ function setupWorkerHandlers(ds, worker) {
                     recipientOpenId,
                     brand: resolveBrandLabel(ds.larkAppId),
                 });
-                cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId).catch((err) => {
+                scopedReply(cardJson, 'interactive', msg.turnId).catch((err) => {
                     logger.warn(`[${t}] Failed to deliver adopt_preamble to Lark: ${err.message}`);
                 });
                 break;
@@ -1681,6 +1764,10 @@ function setupWorkerHandlers(ds, worker) {
                     reason: code === 0 ? 'graceful' : `exit_code_${code}`,
                 },
             });
+            emitSessionLifecycleHook(ds, 'session.exit', {
+                reason: code === 0 ? 'graceful' : `exit_code_${code}`,
+                code,
+            });
         }
     });
 }
@@ -1694,6 +1781,7 @@ const FINAL_OUTPUT_RETRY_BACKOFF_MS = [0, 5000, 15000]; // immediate, +5s, +15s
 function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuoteTargetId) {
     const cb = requireCallbacks();
     const effectiveCliId = ds.session.cliId ?? getBot(ds.larkAppId).config.cliId;
+    const scopedReply = (content, msgType, turnId) => cb.sessionReply(sessionAnchorId(ds), content, msgType, ds.larkAppId, turnId);
     setTimeout(async () => {
         let pendingCardId;
         let pendingQuoteTargetId;
@@ -1734,7 +1822,7 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
             if (pendingCardId) {
                 try {
                     if (ds.session.pendingResponseCardId !== pendingCardId) {
-                        await cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId);
+                        await scopedReply(cardJson, 'interactive', msg.turnId);
                     }
                     else {
                         writePendingResponsePatchMarker(ds.session.sessionId, pendingCardId);
@@ -1755,14 +1843,14 @@ function deliverFinalOutput(ds, msg, t, attempt, lockedPendingCardId, lockedQuot
                     if (!(err instanceof MessageWithdrawnError))
                         throw err;
                     logger.warn(`[${t}] Pending response card withdrawn while forwarding final_output; sending a new reply`);
-                    await cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId);
+                    await scopedReply(cardJson, 'interactive', msg.turnId);
                     markPendingResponseCardPatchedIfCurrent(ds.session, pendingCardId);
                     syncPendingResponseState(ds, ds.session);
                     sessionStore.updateSession(ds.session);
                 }
             }
             else {
-                await cb.sessionReply(sessionAnchorId(ds), cardJson, 'interactive', ds.larkAppId);
+                await scopedReply(cardJson, 'interactive', msg.turnId);
             }
             ds.lastBridgeEmittedUuid = msg.lastUuid;
             logger.info(`[${t}] Bridge final_output forwarded (turn ${msg.turnId.substring(0, 8)}, ${msg.content.length} chars, kind=${msg.kind ?? 'bridge'}, attempt ${attempt + 1})`);
@@ -1977,6 +2065,11 @@ export function forkAdoptWorker(ds, opts) {
         type: 'session.spawned',
         body: { session: composeRowFromActive(ds) },
     });
+    emitSessionLifecycleHook(ds, 'session.start', {
+        reason: opts?.restoredFromMetadata ? 'adopt_restore' : 'adopt',
+        pid: worker.pid ?? null,
+        adoptedFrom: adopted.tmuxTarget,
+    });
 }
 // ─── Kill stale PIDs ────────────────────────────────────────────────────────
 export function killStalePids(activeSessions_) {