@deepseek-harness-tui/dsh-tui 0.11.2 → 0.13.0

package/lib/types/components/LogoV2.js

@@ -21,6 +21,7 @@ import { BRAND, FLASH, ICE, PALE, sweep } from './shimmer.js';
 import { STANDARD_FRAME_INDEX, WhaleArt } from './Whale.js';
 import { WhaleGirlArt } from './WhaleGirl.js';
 import { MAID_BOX_CENTER, MaidPortrait, useMaidPortraits } from './maidPortrait.js';
+import { SplashMascot, useSplashMascotSkin } from './sidePanel/companion/SplashMascot.js';
 import { OPENING_SEQUENCES, pickOpeningSequence, WHALE_FRAME_INDEX } from './whaleFrames.js';
 import { RESTING_POSE } from './whaleLayers.js';
 import { initialWhaleIdleState, nextWhaleIdleStep, } from './whaleIdle.js';
@@ -87,7 +88,7 @@ function capitalize(text) {
  * with a clickable "star us on GitHub" line whose indent is recomputed from
  * its own width.
  */
-export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, fontId, whale = true, whaleIdle = true, whaleGirl = false, starred = false, starReveal, onStarClick, working = false, drift, egg, starChance, }) {
+export function LogoV2({ model = '', effort, cwd = '', skipIntro = false, intro, tip, fontId, whale = true, whaleIdle = true, whaleGirl = false, starred = false, starReveal, onStarClick, working = false, drift, egg, starChance, align = 'start', chrome = 'full', arrangement = 'row', companionSkin, }) {
     // One intro per logo mount: the production path rolls (startup splash
     // and each /deepseek replay roll independently), the `intro` seam pins
     // a specific animation for probes.
@@ -118,6 +119,12 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, font
         if (working)
             setWhaleFrozen(true);
     }, [working]);
+    // ── 启动页吉祥物（2026-10 复用轮）：companion.skin 驱动 ────────────────
+    // deepy → 字母格动画；whaleGirl → 鲸娘动画（图像协议自适应，首帧字母格
+    // 同步可画）；两者都取代艺术槽的原住民（分层鲸/静态女仆娘立绘）。
+    // 'whale'/未知皮肤 → undefined，原路径零改动。冻结/落地页（whaleIdle=
+    // false）时吉祥物定格 idle 帧 0、零时钟（SplashMascot 内部保证）。
+    const mascotSkin = useSplashMascotSkin(companionSkin);
     // ── Whale behaviors (ported from the dsh-ui-whale pet) ─────────────────
     // Intro-phase click → heart pass: whole heart frames over the opening
     // animation (one-way heart1→heart2→heart3). Once the header settles, the
@@ -163,7 +170,21 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, font
     const [dailyEgg] = React.useState(() => (egg === undefined ? pickSplashEgg() : egg));
     const titleFont = dailyEgg === null ? font : withTagline(font, dailyEgg.top, dailyEgg.bottom);
     // 窄终端阶梯：鲸鱼 + 大字 → 纯大字 → 纯鲸鱼 → 一行纯文字（阈值随字体字身宽度变）。
-    const { showWhale, showBigTitle, showPlainTitle } = resolveSplashLayout(columns, { whale, font: titleFont });
+    const splash = resolveSplashLayout(columns, { whale, font: titleFont });
+    /**
+     * 上下排布（落地页）时立绘与词标**不共行**，宽轴那套「谁挤掉谁」的判定不适用：
+     * 立绘只看自己放不放得下（盒宽）。照并排阈值走会在 55–96 列这一大段把立绘判掉，
+     * 而落地页明明有一整行宽度给它——实测症状是「撤立绘」那一档不生效：矮屏上鲸鱼
+     * 照画，把大字与卡片挤出屏幕。
+     */
+    const stacked = arrangement === 'column';
+    const { showWhale, showBigTitle, showPlainTitle } = stacked
+        ? {
+            showWhale: whale && columns >= WHALE_BOX_WIDTH,
+            showBigTitle: splash.showBigTitle,
+            showPlainTitle: !splash.showBigTitle,
+        }
+        : splash;
     // 女仆娘档优先走**真图**（Kitty/Sixel 终端图像协议，见 `maidPortrait.tsx`）；
     // 协议不可用（内联模式、终端不支持）或资产解码失败时，回落到字符画版
     // 女仆娘（`WhaleGirl.tsx` 半块精灵——作者占位，之后会换更好看的）。
@@ -207,9 +228,9 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, font
     const pendingHeartRef = React.useRef(false);
     const tickRef = React.useRef(null);
     React.useEffect(() => {
-        // 女仆娘档（真图或字符画）没有闲置规划器：立绘是静态的，开屏定格
-        // 后不给她留任何定时器。
-        if (!settled || !whaleIdle || !showWhale || whaleFrozen || whaleGirl) {
+        // 女仆娘档（真图或字符画）与吉祥物档（SplashMascot 自带节拍器）都
+        // 不需要鲸鱼的闲置规划器：那两条路径里分层鲸根本没画。
+        if (!settled || !whaleIdle || !showWhale || whaleFrozen || whaleGirl || mascotSkin !== undefined) {
             setIdlePose(null);
             tickRef.current = null;
             return;
@@ -316,9 +337,14 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, font
     // line than `logo-tagline`, so reusing the tagline's width would push it
     // visibly off-center.
     const welcomeWidth = starLine === null ? stringWidth(tagline) : starLine.width;
-    const welcomePad = showWhale
-        ? Math.max(0, Math.round((whaleGirl ? MAID_BOX_CENTER : WHALE_CENTER) - welcomeWidth / 2))
-        : 2;
+    // 居中排版（落地页）交给父级的 `alignItems="center"`，缩进一律为 0；只有
+    // 转录区顶部那一版才需要"把标语钉在鲸鱼下方"。这条判据与根盒的
+    // `align` 走同一个开关，否则两种对齐会各偏一点。
+    const welcomePad = align === 'center'
+        ? 0
+        : showWhale
+            ? Math.max(0, Math.round((whaleGirl ? MAID_BOX_CENTER : WHALE_CENTER) - welcomeWidth / 2))
+            : 2;
     // 两行标题各自用字体声明的字距；下排再按 `bottomIndent` 居中——
     // 两者一起保证画出来的列数相等（见 splashFonts 的 tagline 契约）。
     // 节日彩蛋换的就是这里的两排词（`titleFont` 已按当天词对重解字距）；字体若自带
@@ -326,12 +352,13 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, font
     const { top, bottom, topKerning, bottomKerning, bottomIndent } = titleFont.tagline;
     const bigDeepSeek = renderBigText(titleFont, top, t, titleFont.palette?.from ?? wordmarkRGB, titleFont.palette?.to ?? taglineRGB, FLASH, 60, topKerning);
     const bigHarness = renderBigText(titleFont, bottom, t, titleFont.palette?.from ?? taglineRGB, titleFont.palette?.to ?? PALE, FLASH, 60, bottomKerning, bottomIndent);
-    // 立绘槽位的**唯一真源**：文字列的实际行数——词标 1 + 两排大字 + 两排
-    // 之间空 1 行 + 模型/目录/提示 3 行。槽位与它等高，图片既不压过文字列
+    // 立绘槽位的**唯一真源**：文字列的实际行数。full = 词标 1 + 两排大字 +
+    // 两排之间空 1 行 + 模型/目录/提示 3 行；minimal = 只有两排大字 + 空行
+    //（信息行整块不画，见 chrome prop）。槽位与它等高，图片既不压过文字列
     // 也不留一截在下面（实机反馈「超出去、不和谐」）；大字换字体/换词时也
-    // 自动跟着变，不写死 15。
-    const textColumnRows = bigDeepSeek.length + bigHarness.length + 5;
-    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, children: [_jsxs(Box, { flexDirection: "row", gap: COLUMN_GAP, width: "100%", alignItems: "center", children: [showWhale && (_jsx(Box, { flexShrink: 0, onClick: () => {
+    // 自动跟着变，不写死数字。
+    const textColumnRows = bigDeepSeek.length + bigHarness.length + (chrome === 'minimal' ? 1 : 5);
+    return (_jsxs(Box, { ref: ref, flexDirection: "column", marginTop: 1, ...(align === 'center' ? { alignItems: 'center' } : {}), children: [_jsxs(Box, { flexDirection: arrangement === 'column' ? 'column' : 'row', gap: arrangement === 'column' ? 1 : COLUMN_GAP, alignItems: "center", ...(align === 'center' || arrangement === 'column' ? {} : { width: '100%' }), children: [showWhale && (_jsx(Box, { flexDirection: "column", alignItems: "center", flexShrink: 0, onClick: () => {
                             // Frozen (first task started): the whale is a static logo —
                             // clicks do nothing. Settled: the layered planner consumes the
                             // click on its next tick — run that tick immediately so the
@@ -355,9 +382,9 @@ export function LogoV2({ model, effort, cwd, skipIntro = false, intro, tip, font
                                 setHeartSeq(0);
                                 setHeartKey(k => k + 1);
                             }
-                        }, children: whaleGirl ? (_jsx(Box, { width: WHALE_BOX_WIDTH, height: textColumnRows, flexDirection: "row", justifyContent: "center", alignItems: "center", children: maidImageActive ? (_jsx(MaidPortrait, { source: maidHappy ? (portraits?.happy ?? maidSource) : maidSource, maxColumns: WHALE_BOX_WIDTH, maxRows: textColumnRows, presentation: "transcript" })) : (_jsx(WhaleGirlArt, { width: WHALE_BOX_WIDTH })) })) : (_jsx(WhaleArt, { frameIndex: frameIndex, pose: settled && whaleIdle && !whaleFrozen ? (idlePose ?? RESTING_POSE) : undefined, width: WHALE_BOX_WIDTH })) })), (showBigTitle || showPlainTitle) && (_jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] }), showBigTitle ? (_jsxs(_Fragment, { children: [bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), _jsx(Box, { height: 1 }), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`)))] })) : (showPlainTitle && (_jsx(Text, { color: "accent", bold: true, wrap: "truncate-end", children: "DeepSeek Harness" }))), _jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), getLang() === 'zh' ? randomTip.zh : randomTip.en, _jsx(Text, { dimColor: true, children: ' · /tips ' + tr('logo-tip-more') })] }), driftLine != null && (_jsxs(Text, { color: "warning", wrap: "wrap", children: ["\u26A0", ' ', tOr(`logo-drift-${driftLine.kind}`, `The dsh engine (${driftLine.versions.join(' / ')}) does not match the validated ${UPSTREAM_VALIDATED_VERSION}; reinstall via npm i -g @deepseek-ai/dsh@${UPSTREAM_VALIDATED_VERSION}.`, {
+                        }, children: _jsx(Box, { width: WHALE_BOX_WIDTH, flexDirection: "column", alignItems: "center", children: mascotSkin !== undefined ? (_jsx(SplashMascot, { skin: mascotSkin, active: !whaleFrozen && whaleIdle })) : whaleGirl ? (_jsx(Box, { width: WHALE_BOX_WIDTH, height: textColumnRows, flexDirection: "row", justifyContent: "center", alignItems: "center", children: maidImageActive ? (_jsx(MaidPortrait, { source: maidHappy ? (portraits?.happy ?? maidSource) : maidSource, maxColumns: WHALE_BOX_WIDTH, maxRows: textColumnRows, presentation: "transcript" })) : (_jsx(WhaleGirlArt, { width: WHALE_BOX_WIDTH })) })) : (_jsx(WhaleArt, { frameIndex: frameIndex, pose: settled && whaleIdle && !whaleFrozen ? (idlePose ?? RESTING_POSE) : undefined, width: WHALE_BOX_WIDTH })) }) })), (showBigTitle || showPlainTitle) && (_jsxs(Box, { flexDirection: "column", flexShrink: 1, children: [chrome !== 'minimal' && (_jsxs(Text, { wrap: "truncate-end", children: [sweep('✦ dsh-TUI', t, wordmarkRGB, wordmarkShimmerRGB, 60), _jsx(Text, { dimColor: true, children: '  v' + VERSION })] })), showBigTitle ? (_jsxs(_Fragment, { children: [bigDeepSeek.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `ds-${index}`))), _jsx(Box, { height: 1 }), bigHarness.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, `h-${index}`)))] })) : (showPlainTitle && (_jsx(Text, { color: "accent", bold: true, wrap: "truncate-end", children: "DeepSeek Harness" }))), chrome !== 'minimal' && (_jsxs(_Fragment, { children: [_jsxs(Text, { wrap: "truncate-end", children: [model, effort !== undefined && _jsx(Text, { dimColor: true, children: ' · ' + capitalize(effort) + ' effort' })] }), _jsx(Text, { dimColor: true, wrap: "truncate-end", children: cwd }), _jsxs(Text, { wrap: "truncate-end", children: [_jsx(Text, { dimColor: true, children: tr('logo-tip-prefix') }), getLang() === 'zh' ? randomTip.zh : randomTip.en, _jsx(Text, { dimColor: true, children: ' · /tips ' + tr('logo-tip-more') })] })] })), chrome !== 'minimal' && driftLine != null && (_jsxs(Text, { color: "warning", wrap: "wrap", children: ["\u26A0", ' ', tOr(`logo-drift-${driftLine.kind}`, `The dsh engine (${driftLine.versions.join(' / ')}) does not match the validated ${UPSTREAM_VALIDATED_VERSION}; reinstall via npm i -g @deepseek-ai/dsh@${UPSTREAM_VALIDATED_VERSION}.`, {
                                         installed: driftLine.versions.join(' / '),
                                         validated: UPSTREAM_VALIDATED_VERSION,
                                         primary: UPSTREAM_VALIDATED_VERSION,
-                                    })] }))] }))] }), _jsx(Box, { flexDirection: "column", marginTop: 1, ...(starLine === null || onStarClick === undefined ? {} : { onClick: onStarClick }), children: starLine === null ? (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(tagline, t, taglineRGB, FLASH, 60) }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(starLine.title, t, taglineRGB, FLASH, 60) }) }), revealed >= 1 && (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { dimColor: true, children: starLine.stats }) })), revealed >= 2 && starred !== true && starLine.ask !== null && (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: starLine.ask }) }))] })) })] }));
+                                    })] }))] }))] }), (chrome !== 'minimal' || starLine !== null) && (_jsx(Box, { flexDirection: "column", marginTop: 1, ...(starLine === null || onStarClick === undefined ? {} : { onClick: onStarClick }), children: starLine === null ? (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(tagline, t, taglineRGB, FLASH, 60) }) })) : (_jsxs(_Fragment, { children: [_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: sweep(starLine.title, t, taglineRGB, FLASH, 60) }) }), revealed >= 1 && (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { dimColor: true, children: starLine.stats }) })), revealed >= 2 && starred !== true && starLine.ask !== null && (_jsx(Box, { paddingLeft: welcomePad, children: _jsx(Text, { children: starLine.ask }) }))] })) }))] }));
 }

package/lib/types/components/MessageList.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import { type ScrollBoxHandle } from '../ui.js';
 import type { ChatRow } from '../dsh-adapter/channel.js';
+import type { JobGroupFoldMode } from '../tuiDisplayPrefs.js';
 import type { TranscriptImage } from '../dsh-adapter/transcript-images.js';
 import type { DOMElement } from '../ink/dom.js';
 import { type TimelineSnapshot } from '../ink/timeline-rail.js';
@@ -24,7 +25,7 @@ import type { ToolBackground } from '../tuiDisplayPrefs.js';
  * any host.
  */
 export declare function displaySelectionPath(path: string, sessionCwd: string | undefined, caseInsensitive?: boolean): string;
-export declare function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamViewToggledRows, onToggleStreamView, model, diffLayout, thinkingFold, toolBackground, foldTerminalCommand, smoothStreaming, activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible, historyPaintEnabled, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, onOpenJobs, onOpenFile, sessionCwd, onPreviewImage, suppressImageGraphics, }: {
+export declare function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamViewToggledRows, onToggleStreamView, model, diffLayout, thinkingFold, jobGroupFold, toolBackground, foldTerminalCommand, smoothStreaming, activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible, historyPaintEnabled, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, onOpenJobs, onOpenFile, sessionCwd, onPreviewImage, suppressImageGraphics, }: {
     rows: readonly ChatRow[];
     expanded: boolean;
     expandedRows: ReadonlySet<number>;
@@ -38,6 +39,11 @@ export declare function MessageList({ rows, expanded, expandedRows, selectedId,
     diffLayout?: 'auto' | 'split' | 'unified';
     /** Thinking-block display mode from channel (`preview`/`full`). */
     thinkingFold?: 'preview' | 'full';
+    /** Grouping/folding of consecutive job-card runs (settings
+     *  `dsh-tui.jobGroupFold`): `auto` folds a settled run of ≥3 into its
+     *  summary header, `always` folds any run of ≥2, `never` leaves runs open
+     *  (a header click still folds one by hand). */
+    jobGroupFold?: JobGroupFoldMode;
     /** Tool-card background treatment from the live channel settings. */
     toolBackground?: ToolBackground;
     /** Terminal-card header folding from the live channel settings. */
@@ -109,7 +115,7 @@ export declare function MessageList({ rows, expanded, expandedRows, selectedId,
     /** 打开子代理详情场景（transcript 内点击子代理卡）。 */
     onOpenSubagent?: (agentId: string) => void;
     /** 打开 /jobs 后台任务面板（transcript 内点击任务卡）。 */
-    onOpenJobs?: () => void;
+    onOpenJobs?: (focusId?: string) => void;
     /** 点击工具卡内的文件路径（打开文件操作菜单）。 */
     onOpenFile?: (path: string) => void;
     /** Session working directory (fs path, `channel.cwd`): the IDE-selection

package/lib/types/components/MessageList.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/MessageList.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAmB,MAAM,OAAO,CAAA;AAEvC,OAAO,EAA8B,KAAK,eAAe,EAAE,MAAM,UAAU,CAAA;AAE3E,OAAO,KAAK,EAAE,OAAO,EAA8D,MAAM,2BAA2B,CAAA;AAEpH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAmB/C,OAAO,EAAe,KAAK,gBAAgB,EAAqB,MAAM,yBAAyB,CAAA;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAiF3D;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,eAAe,GAAE,OAAuE,GACvF,MAAM,CAoBR;AAmID,wBAAgB,WAAW,CAAC,EAC1B,IAAI,EACJ,QAAQ,EACR,YAAY,EACZ,UAAU,EACV,WAAW,EACX,qBAA8C,EAC9C,kBAA4C,EAC5C,KAAK,EACL,UAAmB,EACnB,YAAwB,EACxB,cAAuB,EACvB,mBAA2B,EAC3B,eAAuB,EACvB,cAAc,EACd,OAAO,EACP,WAAW,EACX,WAAW,EACX,eAAsB,EACtB,mBAA0B,EAC1B,cAAc,EACd,YAAY,EACZ,eAAe,EACf,aAAa,EACb,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,cAAc,EACd,UAAU,EACV,UAAU,EACV,UAAU,EACV,cAAc,EACd,qBAA6B,GAC9B,EAAE;IACD,IAAI,EAAE,SAAS,OAAO,EAAE,CAAA;IACxB,QAAQ,EAAE,OAAO,CAAA;IACjB,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACpC,+CAA+C;IAC/C,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAC3C,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IAC5C,KAAK,EAAE,MAAM,CAAA;IACb,yEAAyE;IACzE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAA;IACzC,mEAAmE;IACnE,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACjC,qEAAqE;IACrE,cAAc,CAAC,EAAE,cAAc,CAAA;IAC/B,mEAAmE;IACnE,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B;;sEAEkE;IAClE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;sEACkE;IAClE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,EAAE,OAAO,CAAA;IAChB,WAAW,EAAE,MAAM,IAAI,CAAA;IACvB;4BACwB;IACxB,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB;;;;;;;OAOG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAC7B,8EAA8E;IAC9E,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,GAAG,IAAI,KAAK,IAAI,CAAA;IAC/D,oDAAoD;IACpD,YAAY,CAAC,EAAE,eAAe,GAAG,IAAI,CAAA;IACrC,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B;8EAC0E;IAC1E,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAC9C;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,4DAA4D;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC1C,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,IAAI,CAAA;IACvB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;IACnC;;;;8CAI0C;IAC1C,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC/B,4CAA4C;IAC5C,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,IAAI,CAAA;IACjD,qEAAqE;IACrE,qBAAqB,CAAC,EAAE,OAAO,CAAA;CAChC,qBA82BA;AAsbD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,MAAM,EACN,GAAG,EACH,MAAM,EACN,KAAY,EACZ,SAAgB,EAChB,SAAiB,EACjB,OAAe,EACf,WAAW,EACX,OAAe,EACf,SAAiB,GAClB,EAAE;IACD,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,GAAG,EAAE,MAAM,CAAA;IACX;oEACgE;IAChE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,mFAAmF;IACnF,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;IACxB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;qEACiE;IACjE,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB,GAAG,KAAK,CAAC,SAAS,CASlB"}
+{"version":3,"file":"MessageList.d.ts","sourceRoot":"","sources":["../../../src/components/MessageList.tsx"],"names":[],"mappings":"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"}

package/lib/types/components/MessageList.js

@@ -10,7 +10,8 @@ import { AssistantThinkingMessage } from './messages/AssistantThinkingMessage.js
 import { AssistantToolUseMessage } from './messages/AssistantToolUseMessage.js';
 import { SubagentMessage } from './Chat/SubagentMessage.js';
 import { JobCard } from './Chat/JobCard.js';
-import { isMinimalMode } from '../minimalMode.js';
+import { JobGroupHeader } from './Chat/JobGroupHeader.js';
+import { isMinimalUiMode } from '../minimalUiMode.js';
 import { noteFrameCause, noteListGeometry } from '../ink/geometry-trace.js';
 import { getTerminalFlushTick } from '../ink/flush-tick.js';
 import { TurnInterruptedRow } from './TurnInterruptedRow.js';
@@ -45,6 +46,13 @@ import { primaryComboString } from '../utils/keymap.js';
  *  paint (<1s) with the rest behind the show-previous divider. The transcript
  *  is a viewport, not a printout; load-earlier restores older rows. */
 const RENDERED_ROW_CAP = 120;
+/** Threshold of the `auto` jobGroupFold policy: a run of this many (or
+ *  more) FULLY SETTLED jobs folds into its own summary line. Two jobs are
+ *  still a pair worth reading card by card — the group rail alone already
+ *  saves their separator lines there. `always` uses 2, `never` uses none.
+ *  Ctrl+O and a click on the summary reopen any group; clicking again folds
+ *  it back. */
+const JOB_GROUP_FOLD_MIN = 3;
 // --- layout virtualization constants -------------------------------------
 // Offscreen rows render as fixed-height spacers whose heights come from the
 // previous commit's Yoga layout, so the pure-JS Yoga engine never walks
@@ -158,6 +166,18 @@ export function displaySelectionPath(path, sessionCwd, caseInsensitive = process
  * (parts.slice()).
  */
 const signatureScratch = [];
+/** Status code for the job-group fingerprint (a hash input only — the values
+ *  just have to be distinct per status). */
+function jobStatusCode(status) {
+    switch (status) {
+        case 'running': return 1;
+        case 'stopping': return 2;
+        case 'completed': return 3;
+        case 'failed': return 4;
+        case 'killed': return 5;
+        default: return 7;
+    }
+}
 function signatureParts(row, columns, expanded, expandedRows, streamViewToggledRows, thinkingVisible, thinkingFold, diffLayout, foldTerminalCommand, model, failureHintRowId, failureHint, displayTextLen, sessionCwd) {
     signatureScratch.length = 0;
     // Universal height inputs: width reflows every row; kind switches height
@@ -180,7 +200,7 @@ function signatureParts(row, columns, expanded, expandedRows, streamViewToggledR
         case 'reasoning':
             // thinkingFold (preview vs full), its per-row live override, and the
             // visibility filter all change the card's height.
-            signatureScratch.push(row.streaming === true, expanded, expandedRows.has(row.id), streamViewToggledRows.has(row.id), thinkingVisible, thinkingFold);
+            signatureScratch.push(row.streaming === true, row.thinkingOpen === true, expanded, expandedRows.has(row.id), streamViewToggledRows.has(row.id), thinkingVisible, thinkingFold);
             break;
         case 'tool': {
             const tool = row.tool;
@@ -197,6 +217,31 @@ function signatureParts(row, columns, expanded, expandedRows, streamViewToggledR
             // height 永不过期 → 滚回 blank band / 滚不到底。
             signatureScratch.push(row.subagent?.status ?? '', row.subagent?.toolCalls.length ?? 0, row.subagent?.outputLines.length ?? 0, row.subagent?.error?.length ?? 0);
             break;
+        case 'job': {
+            // Card height inputs: the group decoration reshapes the row wholesale
+            // (the head adds the summary line, a folded run collapses into it, the
+            // rail shifts the body two columns right), the waterfall grows and
+            // shrinks with mirrored output, and settling drops the progress chip
+            // and the waterfall while it may add the detail tail. Missing any of
+            // them leaves an offscreen card's cached height stale → blank band /
+            // unreachable scroll bottom (the subagent card's lesson).
+            const group = row.jobGroup;
+            signatureScratch.push(row.job?.status ?? '', 
+            // The label drives the card's height: it wraps inside its column and
+            // the rail is painted per line, so a label that lands later (the
+            // kernel fills it in after launch) must invalidate the cached height.
+            row.job?.label?.length ?? 0, row.job?.outputLines.length ?? 0, row.job?.detail?.length ?? 0, row.job?.progress?.length ?? 0, 
+            // The waterfall wraps its tail and keeps the last rows, so how much
+            // text those tail lines carry decides how many rows actually paint.
+            row.job === undefined
+                ? ''
+                : row.job.outputLines.slice(-4).map(line => line.text.length).join(','), 
+            // Grouped members all render with the same 2-cell rail, so the only
+            // shape inputs are "is it a member", "is it the head" and "is the run
+            // folded" (a folded head paints the summary alone).
+            group !== undefined, group?.head === true, group?.last === true, group?.folded === true);
+            break;
+        }
         case 'compact':
             // Folded one-liner vs full summary text.
             signatureScratch.push(expanded, expandedRows.has(row.id));
@@ -232,7 +277,7 @@ function signatureParts(row, columns, expanded, expandedRows, streamViewToggledR
     }
     return signatureScratch;
 }
-export function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamViewToggledRows = NO_STREAM_VIEW_TOGGLED, onToggleStreamView = NOOP_TOGGLE_STREAM_VIEW, model, diffLayout = 'auto', thinkingFold = 'preview', toolBackground = 'none', foldTerminalCommand = false, smoothStreaming = false, activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible = true, historyPaintEnabled = true, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, onOpenJobs, onOpenFile, sessionCwd, onPreviewImage, suppressImageGraphics = false, }) {
+export function MessageList({ rows, expanded, expandedRows, selectedId, onToggleRow, streamViewToggledRows = NO_STREAM_VIEW_TOGGLED, onToggleStreamView = NOOP_TOGGLE_STREAM_VIEW, model, diffLayout = 'auto', thinkingFold = 'preview', jobGroupFold = 'auto', toolBackground = 'none', foldTerminalCommand = false, smoothStreaming = false, activityFrames, showAll, onToggleAll, onLoadOlder, thinkingVisible = true, historyPaintEnabled = true, registerRowRef, scrollHandle, forceMountRowId, newSinceRowId, onUnseenCount, onTimeline, failureHintRowId, failureHint, onOpenSubagent, onOpenJobs, onOpenFile, sessionCwd, onPreviewImage, suppressImageGraphics = false, }) {
     const lang = React.useSyncExternalStore(subscribeLang, getLang);
     const hiddenCount = rows.length - RENDERED_ROW_CAP;
     // The thinking filter runs BEFORE virtualization so window indices line up.
@@ -264,11 +309,25 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
             }
         }
     }
+    // Job-group fingerprint: job statuses land IN PLACE (`row.job` is
+    // re-assigned by the projection, the row array never moves) and the expand
+    // toggles live in a Set — none of that shows up in the rows identity or
+    // length key above, yet both decide whether a consecutive-job run folds,
+    // and a folded run REMOVES its members from the visible window. One
+    // allocation-free pass over the row list (only job rows feed the hash).
+    let jobsSig = (expanded ? 1 : 0) * 7 + (jobGroupFold === 'always' ? 1 : jobGroupFold === 'never' ? 2 : 3);
+    for (let i = 0; i < rows.length; i++) {
+        const row = rows[i];
+        if (row.kind !== 'job' || row.job === undefined)
+            continue;
+        jobsSig = (jobsSig * 33 + row.id + jobStatusCode(row.job.status) + (expandedRows.has(row.id) ? 7 : 0)) | 0;
+    }
     if (visibleCache === null ||
         visibleCache.rows !== rows ||
         visibleCache.rowsLength !== rows.length ||
         visibleCache.showAll !== (showAll || hiddenCount <= 0) ||
         visibleCache.thinkingVisible !== thinkingVisible ||
+        visibleCache.jobsSig !== jobsSig ||
         !streamBitsSame) {
         const sliced = showAll || hiddenCount <= 0
             ? rows
@@ -299,20 +358,132 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
                 break;
             }
         }
+        // The transcript can arrive FROZEN end to end: the session projection
+        // freezes both the row array and every row object (session-projection.ts
+        // `Object.freeze(rows.map(row => Object.freeze({ ...row })))`), so the
+        // pass-through branch below must COPY rather than alias it. The group
+        // decoration further down is render-local derived state: it rides
+        // shallow copies inside this writable array, never the shared row
+        // objects (an in-place write throws on a frozen row and takes the TUI
+        // down at startup — the resume/replay first frame delivers exactly
+        // that shape).
         const out = hasEmptyAssistant
             ? sliced.filter(row => !rendersEmptyAssistant(row) &&
                 (thinkingVisible || row.kind !== 'reasoning'))
             : thinkingVisible
-                ? sliced
+                ? sliced.slice()
                 : sliced.filter(row => row.kind !== 'reasoning');
-        // Every rendered block gets a 1-row top margin except the
-        // first. Pre-pass over the FULL list so a windowed row keeps the exact
-        // spacing it would have in a fully-mounted list.
+        // --- consecutive-job groups ------------------------------------------
+        // A batch of run_in_background calls lands as N adjacent job cards (the
+        // projection pushes the whole roster in one sync) and EVERY card pays
+        // the 1-row block margin — a pile of near-identical rows for work nobody
+        // reads card by card. Read ≥2 adjacent job rows as ONE group instead:
+        // members drop the blank line between them, hang off a shared chain
+        // rail, and the head row carries the run summary. A fully settled run
+        // (≥ JOB_GROUP_FOLD_MIN) folds into that summary alone.
+        //
+        // Folded members are removed HERE, before virtualization, so window
+        // indices line up (same rule as the thinking filter). The fold is the
+        // ordinary per-row expand gesture: clicking the summary — or Ctrl+O —
+        // reopens the run, clicking again folds it back.
+        //
+        // Runs are detected in the VISIBLE list, so a run whose head fell behind
+        // the RENDERED_ROW_CAP fold window is read from the first visible member
+        // (the header then counts what is on screen — never a headerless rail).
+        const foldedMembers = new Set();
+        for (let i = 0; i < out.length; i++) {
+            const head = out[i];
+            if (head.kind !== 'job' || head.job === undefined)
+                continue;
+            let end = i;
+            while (end + 1 < out.length) {
+                const next = out[end + 1];
+                if (next.kind !== 'job' || next.job === undefined)
+                    break;
+                end++;
+            }
+            const count = end - i + 1;
+            if (count < 2) {
+                // A lone card renders exactly as it did before groups existed (no
+                // rail, its own block margin). Nothing to clear: the decoration
+                // lives on per-pass shallow copies, never on the shared rows.
+                i = end;
+                continue;
+            }
+            let running = 0;
+            let completed = 0;
+            let failed = 0;
+            let killed = 0;
+            let startedAt = Number.POSITIVE_INFINITY;
+            let endedAt;
+            for (let k = i; k <= end; k++) {
+                const job = out[k].job;
+                switch (job.status) {
+                    case 'running':
+                    case 'stopping':
+                        running++;
+                        break;
+                    case 'completed':
+                        completed++;
+                        break;
+                    case 'killed':
+                        killed++;
+                        break;
+                    default:
+                        failed++;
+                }
+                startedAt = Math.min(startedAt, job.startedAt);
+                if (job.finishedAt !== undefined)
+                    endedAt = Math.max(endedAt ?? job.finishedAt, job.finishedAt);
+            }
+            // A live member means the run is not over: no duration to freeze.
+            if (running > 0)
+                endedAt = undefined;
+            // Fold policy (settings `dsh-tui.jobGroupFold`): `auto` waits for the
+            // whole run to settle, `always` folds a run of 2+ immediately (live
+            // members included — the header still reports what is running), and
+            // `never` leaves the decision to a header click. Ctrl+O force-expands
+            // every run; the header click lands in expandedRows.
+            const foldMin = jobGroupFold === 'always' ? 2 : JOB_GROUP_FOLD_MIN;
+            const folded = jobGroupFold !== 'never' && count >= foldMin &&
+                (jobGroupFold === 'always' || running === 0) && !expanded && !expandedRows.has(head.id);
+            for (let k = i; k <= end; k++) {
+                // Copy-on-write: decorate a shallow copy. `out[k].jobGroup = …` in
+                // place throws on the frozen rows the session projection delivers
+                // (resume/replay), crashing the TUI at startup.
+                out[k] = {
+                    ...(out[k]),
+                    jobGroup: {
+                        head: k === i,
+                        last: k === end,
+                        count,
+                        folded,
+                        running,
+                        completed,
+                        failed,
+                        killed,
+                        startedAt,
+                        ...(endedAt === undefined ? {} : { endedAt }),
+                    },
+                };
+            }
+            if (folded) {
+                for (let k = i + 1; k <= end; k++)
+                    foldedMembers.add(out[k].id);
+            }
+            i = end;
+        }
+        const visibleOut = foldedMembers.size === 0 ? out : out.filter(row => !foldedMembers.has(row.id));
+        // Every rendered block gets a 1-row top margin except the first. Pre-pass
+        // over the FULL list so a windowed row keeps the exact spacing it would
+        // have in a fully-mounted list. Group members are the exception: they sit
+        // flush under their head, which is the separator line the group removes.
         const margins = new Map();
         {
             let prev;
-            for (const row of out) {
-                margins.set(row.id, prev !== undefined);
+            for (const row of visibleOut) {
+                const member = row.jobGroup !== undefined && !row.jobGroup.head;
+                margins.set(row.id, prev !== undefined && !member);
                 prev = row.kind;
             }
         }
@@ -324,9 +495,10 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
             rowsLength: rows.length,
             showAll: showAll || hiddenCount <= 0,
             thinkingVisible,
-            out,
+            out: visibleOut,
             margins,
             streamBits,
+            jobsSig,
         };
         visGenRef.current++;
     }
@@ -1006,6 +1178,7 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
                 const tool = row.tool;
                 const subagent = row.kind === 'subagent' ? row.subagent : undefined;
                 const job = row.kind === 'job' ? row.job : undefined;
+                const jobGroup = row.kind === 'job' ? row.jobGroup : undefined;
                 const revealVersion = smoothStreaming && row.kind === 'tool' && row.fresh === true &&
                     row.tool?.status === 'running' && row.tool.resultView === undefined
                     ? getRevealVersion()
@@ -1030,7 +1203,7 @@ export function MessageList({ rows, expanded, expandedRows, selectedId, onToggle
                 else if (row.kind === 'reasoning' && smoothStreaming) {
                     displayText = revealTextOf(`r${row.id}`, row.text, { enabled: true, active: displayStreaming });
                 }
-                return (_jsx(MemoRow, { rowId: row.id, kind: row.kind, text: displayText, images: row.images, textFull: row.kind === 'reasoning' ? row.text : undefined, executionTarget: row.executionTarget, selectionAttached: row.selectionAttached, streaming: displayStreaming, durationMs: row.durationMs, time: row.time, marginTopOnTurn: marginTopOnTurn, isSelected: selectedId === row.id, isExpanded: expandedRows.has(row.id), expanded: expanded, model: model, diffLayout: diffLayout, thinkingFold: thinkingFold, toolBackground: toolBackground, foldTerminalCommand: foldTerminalCommand, smoothStreaming: smoothStreaming, fresh: row.fresh === true, revealVersion: revealVersion, activityFrames: activityFrames, background: rowBackground(row.id), toolCallId: tool?.callId, toolName: tool?.name, toolArgsText: tool?.argsText, toolArgsFull: tool?.argsFull, toolStatus: tool?.status, toolResultText: tool?.resultText, toolResultFull: tool?.resultFull, toolErrorText: tool?.errorText, toolFootnote: failureHintRowId === row.id ? failureHint : undefined, toolCallView: tool?.callView, toolResultView: tool?.resultView, toolStartedAt: tool?.startedAt, toolDurationMs: tool?.durationMs, subagent: subagent, job: job, onToggleRow: onToggleRow, onToggleStreamView: onToggleStreamView, streamViewToggled: streamViewToggledRows.has(row.id), onOpenSubagent: onOpenSubagent, onOpenJobs: onOpenJobs, onOpenFile: onOpenFile, sessionCwd: sessionCwd, onPreviewImage: onPreviewImage, suppressImageGraphics: suppressImageGraphics, setRowRef: setRowRef }, row.id));
+                return (_jsx(MemoRow, { rowId: row.id, kind: row.kind, text: displayText, images: row.images, textFull: row.kind === 'reasoning' ? row.text : undefined, executionTarget: row.executionTarget, selectionAttached: row.selectionAttached, streaming: displayStreaming, thinkingOpen: row.thinkingOpen === true, durationMs: row.durationMs, time: row.time, marginTopOnTurn: marginTopOnTurn, isSelected: selectedId === row.id, isExpanded: expandedRows.has(row.id), expanded: expanded, model: model, diffLayout: diffLayout, thinkingFold: thinkingFold, toolBackground: toolBackground, foldTerminalCommand: foldTerminalCommand, smoothStreaming: smoothStreaming, fresh: row.fresh === true, revealVersion: revealVersion, activityFrames: activityFrames, background: rowBackground(row.id), toolCallId: tool?.callId, toolName: tool?.name, toolArgsText: tool?.argsText, toolArgsFull: tool?.argsFull, toolStatus: tool?.status, toolResultText: tool?.resultText, toolResultFull: tool?.resultFull, toolErrorText: tool?.errorText, toolFootnote: failureHintRowId === row.id ? failureHint : undefined, toolCallView: tool?.callView, toolResultView: tool?.resultView, toolStartedAt: tool?.startedAt, toolDurationMs: tool?.durationMs, subagent: subagent, job: job, jobGroup: jobGroup, onToggleRow: onToggleRow, onToggleStreamView: onToggleStreamView, streamViewToggled: streamViewToggledRows.has(row.id), onOpenSubagent: onOpenSubagent, onOpenJobs: onOpenJobs, onOpenFile: onOpenFile, sessionCwd: sessionCwd, onPreviewImage: onPreviewImage, suppressImageGraphics: suppressImageGraphics, setRowRef: setRowRef }, row.id));
             }), bottomPad > 0 && _jsx(Box, { height: bottomPad, flexShrink: 0 })] }));
 }
 /** Load-earlier / show-previous divider row with a mouse hover tint — the
@@ -1039,7 +1212,7 @@ function ClickableDivider({ title, onClick }) {
     const [hovered, setHovered] = useState(false);
     return (_jsx(Box, { marginTop: 1, onClick: onClick, onMouseEnter: () => setHovered(true), onMouseLeave: () => setHovered(false), backgroundColor: hovered ? 'userMessageBackgroundHover' : undefined, children: _jsx(Divider, { title: title }) }));
 }
-function TranscriptRow({ rowId, kind, text, images, textFull, executionTarget, selectionAttached, sessionCwd, streaming, durationMs, time, marginTopOnTurn, isSelected, isExpanded, expanded, model, diffLayout, smoothStreaming, fresh, revealVersion, thinkingFold, toolBackground, foldTerminalCommand, activityFrames, background, toolCallId, toolName, toolArgsText, toolArgsFull, toolStatus, toolResultText, toolResultFull, toolErrorText, toolFootnote, toolCallView, toolResultView, toolStartedAt, toolDurationMs, subagent, job, onToggleRow, onToggleStreamView, streamViewToggled, onOpenSubagent, onOpenJobs, onOpenFile, onPreviewImage, suppressImageGraphics, setRowRef, }) {
+function TranscriptRow({ rowId, kind, text, images, textFull, executionTarget, selectionAttached, sessionCwd, streaming, thinkingOpen, durationMs, time, marginTopOnTurn, isSelected, isExpanded, expanded, model, diffLayout, smoothStreaming, fresh, revealVersion, thinkingFold, toolBackground, foldTerminalCommand, activityFrames, background, toolCallId, toolName, toolArgsText, toolArgsFull, toolStatus, toolResultText, toolResultFull, toolErrorText, toolFootnote, toolCallView, toolResultView, toolStartedAt, toolDurationMs, subagent, job, jobGroup, onToggleRow, onToggleStreamView, streamViewToggled, onOpenSubagent, onOpenJobs, onOpenFile, onPreviewImage, suppressImageGraphics, setRowRef, }) {
     const ref = React.useCallback((el) => {
         setRowRef(rowId, el);
     }, [setRowRef, rowId]);
@@ -1053,13 +1226,18 @@ function TranscriptRow({ rowId, kind, text, images, textFull, executionTarget, s
             return;
         onToggleRow(rowId);
     }, [onToggleRow, rowId]);
-    // 流式 reasoning 行：点击在三行预览/全文间切换。它反转 thinkingFold
-    // 的默认值，落定后语义自动回到 foldOnClick。
+    // 当前回合仍展开的 reasoning 行：点击在三行预览/全文间切换。它反转
+    // thinkingFold 的默认值，回合落定后语义自动回到 foldOnClick。
     const streamViewOnClick = React.useCallback((event) => {
         if (event.cellIsBlank)
             return;
         onToggleStreamView(rowId);
     }, [onToggleStreamView, rowId]);
+    // 任务组：点击组头行折叠/展开整组（与工具卡的折叠同一套手势：行点击 =
+    // expandedRows 切换，Ctrl+O 展开全部）。
+    const toggleJobGroup = React.useCallback(() => {
+        onToggleRow(rowId);
+    }, [onToggleRow, rowId]);
     // 子代理卡：点击打开详情场景（不是折叠）。
     const openSubagent = React.useCallback(() => {
         if (subagent !== undefined)
@@ -1099,12 +1277,13 @@ function TranscriptRow({ rowId, kind, text, images, textFull, executionTarget, s
         case 'reasoning': {
             // The setting chooses the live default; a row click reverses it. Global
             // or per-row transcript expansion always wins and shows the full text.
-            const streamPreview = streaming && !expanded && !isExpanded &&
+            const turnOpen = streaming || thinkingOpen;
+            const streamPreview = turnOpen && !expanded && !isExpanded &&
                 (streamViewToggled ? thinkingFold === 'full' : thinkingFold === 'preview');
             return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(AssistantThinkingMessage, { thinking: text, textFull: textFull, marginTopOnTurn: marginTopOnTurn, streaming: streaming, preview: streamPreview, 
                     // Settled rows keep the fold-on-settle default and expand via
-                    // expandedRows/Ctrl+O; a live row is always preview or full.
-                    verbose: isExpanded || expanded || (streaming && !streamPreview), durationMs: durationMs, isSelected: isSelected, onClick: streaming ? streamViewOnClick : foldOnClick }) }));
+                    // expandedRows/Ctrl+O; a current-turn row is preview or full.
+                    verbose: isExpanded || expanded || (turnOpen && !streamPreview), durationMs: durationMs, isSelected: isSelected, onClick: turnOpen ? streamViewOnClick : foldOnClick }) }));
         }
         case 'tool': {
             if (toolCallId === undefined ||
@@ -1150,10 +1329,25 @@ function TranscriptRow({ rowId, kind, text, images, textFull, executionTarget, s
             if (!subagent)
                 return null;
             return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(SubagentMessage, { subagent: subagent, marginTopOnTurn: marginTopOnTurn, activityFrames: activityFrames, isExpanded: isExpanded, onClick: openSubagent }) }));
-        case 'job':
+        case 'job': {
             if (!job)
                 return null;
-            return (_jsx(Box, { flexDirection: "column", ref: ref, children: _jsx(JobCard, { job: job, marginTopOnTurn: marginTopOnTurn, onClick: onOpenJobs }) }));
+            // A grouped run renders as ONE block: the head row carries the summary
+            // line, members hang off the shared rail, and a FOLDED run keeps only
+            // that summary (its members were dropped from the window upstream).
+            const groupHead = jobGroup !== undefined && jobGroup.head;
+            return (_jsxs(Box, { flexDirection: "column", 
+                // The head's block margin moves UP to the group (the summary line
+                // is what separates the run from what precedes it); the card under
+                // it must not add a second blank line.
+                marginTop: groupHead && marginTopOnTurn ? 1 : 0, ref: ref, children: [groupHead && _jsx(JobGroupHeader, { group: jobGroup, onToggle: toggleJobGroup }), groupHead && jobGroup.folded ? null : (_jsx(JobCard, { job: job, marginTopOnTurn: groupHead ? false : marginTopOnTurn, 
+                        // The bracket hugs the CARDS: the summary line above stays
+                        // outside it, and the head/last member round the two ends in
+                        // place (no extra cap row) — see JobCard's `rail` prop.
+                        rail: jobGroup === undefined ? undefined : { open: jobGroup.head, close: jobGroup.last }, 
+                        // Clicking a card opens the panel focused on THAT job, not the roster head.
+                        onClick: onOpenJobs === undefined ? undefined : () => onOpenJobs(job.id) }))] }));
+        }
     }
 }
 /** Folded compact-summary preview: whitespace flattened, capped with an
@@ -1171,9 +1365,9 @@ const MemoRow = React.memo(TranscriptRow);
  * fills the viewport.
  */
 export function LogoHeader({ model, effort, cwd, fontId, whale = true, whaleIdle = true, whaleGirl = false, starred = false, onStarClick, working = false, skipIntro = false, }) {
-    // Minimal mode drops the whole splash (whale art AND wordmark) — only the
+    // The minimal UI drops the whole splash (whale art AND wordmark) — only the
     // transcript and a bare status bar remain.
-    if (isMinimalMode())
+    if (isMinimalUiMode())
         return null;
     return (_jsx(Box, { flexDirection: "column", marginBottom: 1, children: _jsx(LogoV2, { model: model, effort: effort, cwd: cwd, fontId: fontId, whale: whale, whaleIdle: whaleIdle, whaleGirl: whaleGirl, starred: starred, onStarClick: onStarClick, working: working, skipIntro: skipIntro }) }));
 }

package/lib/types/components/OverlayAbove.d.ts

@@ -40,9 +40,19 @@ export declare function useOverlayListRows(frameRows: number): number;
  * bottom:'100%' 会把面板顶到 todo 之上，远离输入框。in-flow 面板（问卷/
  * 对话框/提示等）走输入簇的替换链，天然落在输入行位置，同样不会越过 todo。
  */
-export declare function OverlayAbove({ children, maxHeight, }: {
+export declare function OverlayAbove({ children, maxHeight, transparent, }: {
     children: React.ReactNode;
     /** 调用方声明的上限；实际还会被钳到锚点上方的可画行数。 */
     maxHeight?: number | undefined;
+    /**
+     * 透明宿主（第七版：落地页侧专用）：**干净的镂空，不是混合**——只关掉
+     * occlusionColor（那是立绘图像在浮层后面时触发的 toolCardBackground 整块
+     * 白底，用户截图报的「整块白底」就是它），**保留 opaque 的空格垫底**：
+     * 浮层矩形内每一格都被空格占位（宿主屏的字形——大字/立绘字符画——被完全
+     * 遮掉，绝不重影），但不发任何背景色 SGR（终端默认背景；Kitty 负 z 立绘
+     * 图像仍从默认背景格里透出来，这正是「透出启动页」想要的）。
+     * 聊天页姿态不变：那边的底是转录文本，遮挡图像的 occlusion 语义仍然需要。
+     */
+    transparent?: boolean;
 }): React.ReactNode;
 //# sourceMappingURL=OverlayAbove.d.ts.map

package/lib/types/components/OverlayAbove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverlayAbove.d.ts","sourceRoot":"","sources":["../../../src/components/OverlayAbove.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,SAAS,GACV,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC/B,GAAG,KAAK,CAAC,SAAS,CA2DlB"}
+{"version":3,"file":"OverlayAbove.d.ts","sourceRoot":"","sources":["../../../src/components/OverlayAbove.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AAezB;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAK5D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,SAAS,EACT,WAAmB,GACpB,EAAE;IACD,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,iCAAiC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC9B;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,GAAG,KAAK,CAAC,SAAS,CA0DlB"}

package/lib/types/components/OverlayAbove.js

@@ -56,7 +56,7 @@ export function useOverlayListRows(frameRows) {
  * bottom:'100%' 会把面板顶到 todo 之上，远离输入框。in-flow 面板（问卷/
  * 对话框/提示等）走输入簇的替换链，天然落在输入行位置，同样不会越过 todo。
  */
-export function OverlayAbove({ children, maxHeight, }) {
+export function OverlayAbove({ children, maxHeight, transparent = false, }) {
     const ref = React.useRef(null);
     const terminal = useTerminalSize();
     const { stdout } = useApp();
@@ -84,15 +84,5 @@ export function OverlayAbove({ children, maxHeight, }) {
         setSpaceAbove(previous => (previous === next ? previous : next));
     });
     const effectiveMaxHeight = clampOverlayHeight(maxHeight, spaceAbove);
-    return (_jsx(Box, { ref: ref, position: "absolute", bottom: "100%", left: 0, right: 0, flexDirection: "column", justifyContent: "flex-end", overflow: "hidden", 
-        // Kitty graphics below text still show through terminal-default
-        // background cells, and a real surface color is the only way to make
-        // the negative-z placement obey this overlay's visual bounds without
-        // deleting it. But a PERMANENT surface paints every transient panel
-        // (/ menu、picker、对话框) a bright full-width block that reads as a
-        // spurious highlight (a regression introduced by 49f7166).
-        // occlusionColor keeps the overlay terminal-transparent in the
-        // common frame and only paints the surface while an image actually
-        // sits behind this rect — see Styles.occlusionColor.
-        occlusionColor: "toolCardBackground", opaque: true, ...(effectiveMaxHeight === undefined ? {} : { maxHeight: effectiveMaxHeight }), children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: _jsx(OverlayBudgetContext.Provider, { value: effectiveMaxHeight, children: children }) }) }));
+    return (_jsx(Box, { ref: ref, position: "absolute", bottom: "100%", left: 0, right: 0, flexDirection: "column", justifyContent: "flex-end", overflow: "hidden", ...(transparent ? { opaque: true } : { occlusionColor: 'toolCardBackground', opaque: true }), ...(effectiveMaxHeight === undefined ? {} : { maxHeight: effectiveMaxHeight }), children: _jsx(Box, { flexDirection: "column", flexShrink: 0, children: _jsx(OverlayBudgetContext.Provider, { value: effectiveMaxHeight, children: children }) }) }));
 }