@deepseek-harness-tui/dsh-tui 0.15.0 → 0.16.1

package/lib/types/components/sidePanel/btw/threads.js

@@ -24,6 +24,16 @@ export const BTW_CONTEXT_CHAR_BUDGET = 24_000;
 export const BTW_ANSWER_CHAR_BUDGET = 8_000;
 /** 跨线程并发上限：超过显示忙，不隐式取消。 */
 export const BTW_MAX_CONCURRENT_ASKS = 2;
+/**
+ * 有效选中轮：钉住的 id 还在就继续用它，否则跟最后一条（新轮到达自动跟尾、
+ * 轮被清掉/换话题自动落回）。面板与全屏场景共用这一条解析，保证两个形态
+ * 的选中语义逐字一致。
+ */
+export function effectiveSelectedTurnId(turns, pinned) {
+    if (pinned !== null && turns.some(turn => turn.turnId === pinned))
+        return pinned;
+    return turns.length === 0 ? null : turns[turns.length - 1].turnId;
+}
 /** 钳到 1–8；非有限值取默认 4。 */
 export function normalizeRecentTurnsLimit(value) {
     if (value === undefined || !Number.isFinite(value))
@@ -92,6 +102,7 @@ function buildSnapshot(record) {
         turns: Object.freeze([...record.turns]),
         activeTurnId: active === null ? null : active.turnId,
         draft: record.draft,
+        selectedTurnId: effectiveSelectedTurnId(record.turns, record.selectedTurnId),
         unread: Object.freeze({ count: unreadCount, error: unreadError }),
         version: record.version,
     });
@@ -147,6 +158,8 @@ class BtwThreadStore {
             omittedOlderCount: selection.omittedOlderCount,
         };
         record.turns.push(turn);
+        // 新轮到达回到跟尾：选中态跟的是「最后一条」，上一轮的钉位不再有意义。
+        record.selectedTurnId = null;
         this.bump(record);
         const controller = new AbortController();
         this.controllers.set(turn.turnId, controller);
@@ -230,6 +243,7 @@ class BtwThreadStore {
         record.generation += 1;
         record.turns = [];
         record.draft = '';
+        record.selectedTurnId = null;
         record.seenThroughSeq = this.turnSeq;
         this.bump(record);
         return true;
@@ -241,6 +255,41 @@ class BtwThreadStore {
         record.draft = text;
         this.bump(record);
     }
+    /** 指定选中某一轮（点标题行；null = 回到跟最后一条）。 */
+    select(sessionId, turnId) {
+        const record = this.recordOf(sessionId);
+        if (record.selectedTurnId === turnId)
+            return;
+        record.selectedTurnId = turnId;
+        this.bump(record);
+    }
+    /** 当前选中轮（实时解析，不依赖渲染期快照）。 */
+    selectedTurn(sessionId) {
+        const record = this.threads.get(sessionId);
+        if (record === undefined)
+            return undefined;
+        const id = effectiveSelectedTurnId(record.turns, record.selectedTurnId);
+        return id === null ? undefined : record.turns.find(turn => turn.turnId === id);
+    }
+    /**
+     * ↑/↓ 移动选中：从当前有效选中出发、夹在两端（delta = ±1）。落点即钉住，
+     * 所以移动之后不再跟尾；返回新选中轮（线程为空 = undefined）。
+     */
+    moveSelection(sessionId, delta) {
+        const record = this.recordOf(sessionId);
+        if (record.turns.length === 0)
+            return undefined;
+        const current = effectiveSelectedTurnId(record.turns, record.selectedTurnId);
+        const at = record.turns.findIndex(turn => turn.turnId === current);
+        const from = at === -1 ? record.turns.length - 1 : at;
+        const next = Math.min(record.turns.length - 1, Math.max(0, from + delta));
+        const turnId = record.turns[next].turnId;
+        if (record.selectedTurnId !== turnId) {
+            record.selectedTurnId = turnId;
+            this.bump(record);
+        }
+        return record.turns[next];
+    }
     /** 看到最新线程：把已落定轮全部记为已读（running 轮落定时再见分晓）。 */
     markSeen(sessionId) {
         const record = this.threads.get(sessionId);
@@ -269,6 +318,7 @@ class BtwThreadStore {
                 generation: 0,
                 turns: [],
                 draft: '',
+                selectedTurnId: null,
                 seenThroughSeq: this.turnSeq,
                 version: 0,
                 snapshot: Object.freeze({
@@ -279,6 +329,7 @@ class BtwThreadStore {
                     turns: Object.freeze([]),
                     activeTurnId: null,
                     draft: '',
+                    selectedTurnId: null,
                     unread: Object.freeze({ count: 0, error: false }),
                     version: 0,
                 }),

package/lib/types/components/sidePanel/builtinPanels.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtinPanels.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/builtinPanels.tsx"],"names":[],"mappings":"AA6NA,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,IAAI,CAmG5C"}
+{"version":3,"file":"builtinPanels.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/builtinPanels.tsx"],"names":[],"mappings":"AAiOA,2BAA2B;AAC3B,wBAAgB,qBAAqB,IAAI,IAAI,CAmG5C"}

package/lib/types/components/sidePanel/builtinPanels.js

@@ -141,6 +141,10 @@ function AgentsPanelAdapter({ focused, visible }) {
     React.useEffect(() => {
         const running = subagents.filter(s => s.status === 'running' || s.status === 'starting').length;
         const failedIds = new Set(subagents.filter(s => s.status === 'failed').map(s => s.agentId));
+        // A failed team member is durable; it counts once even beside a failed run.
+        for (const member of channel.team?.members ?? [])
+            if (member.phase === 'failed')
+                failedIds.add(member.id);
         if (visible) {
             seenFailedRef.current = failedIds;
             panelStore.setBadge('agents', running > 0 ? { level: 'info', unread: 0 } : null);
@@ -162,7 +166,7 @@ function AgentsPanelAdapter({ focused, visible }) {
     if (typeof route === 'object' && detail !== undefined) {
         return (_jsx(SubagentDetailScene, { subagent: detail, variant: "panel", focused: focused, visible: visible, onBack: () => setRoute('dashboard'), onInterrupt: (id) => channel.subagentControl?.interrupt(id), ...(channel.subagentControl?.history === undefined ? {} : { loadTranscript: channel.subagentControl.history }), onOpenView: () => agentViewStore.request(detail.agentId, 'agent-detail', true), messages: detailMessages, ...(detailCompose === undefined ? {} : { compose: detailCompose }) }));
     }
-    return (_jsx(SubagentDashboard, { subagents: subagents, variant: "panel", focused: focused, visible: visible, onSelect: (id) => setRoute({ detail: id }), onOpenView: (id) => agentViewStore.request(id, 'agents-dashboard', true), messages: messageControl?.messages() }));
+    return (_jsx(SubagentDashboard, { subagents: subagents, team: channel.team, sessionId: channel.sessionId, variant: "panel", focused: focused, visible: visible, onSelect: (id) => setRoute({ detail: id }), onOpenView: (id) => agentViewStore.request(id, 'agents-dashboard', true), messages: messageControl?.messages() }));
 }
 let registered = false;
 /** 幂等：重复调用（夹具多次挂载）不再注册。 */

package/lib/types/components/sidePanel/companion/SplashMascot.d.ts

@@ -19,13 +19,17 @@
  * 渲染路径（LogoV2 底部块，welcomePad 缩进）。
  */
 import React from 'react';
+import { type SplashImageBox } from '../../splashArtRows.js';
 export type SplashMascotSkin = 'deepy' | 'whaleGirl';
 /** 读 companion.skin（LogoV2 的测试缝 prop 优先）；非吉祥物皮肤返回
  *  undefined（LogoV2 走原鲸鱼/女仆娘路径，零改动）。 */
 export declare function useSplashMascotSkin(pinned?: string): SplashMascotSkin | undefined;
+/** 图片原生尺寸的紧凑槽；仅启动页使用，协议/像元/素材未就绪时保持原回退。 */
+export declare function useSplashMascotBox(skin: SplashMascotSkin | undefined, compact: boolean): SplashImageBox | undefined;
 /** 启动页吉祥物本体：按 skin 渲染动画，点击交互（poke/连点）在内层盒。 */
-export declare function SplashMascot({ skin, active }: {
+export declare function SplashMascot({ skin, active, imageBox }: {
     readonly skin: SplashMascotSkin;
+    readonly imageBox?: SplashImageBox;
     /** 动画许可：false（冻结/落地页 whaleIdle=false）时定格 idle 帧 0、零时钟。 */
     readonly active: boolean;
 }): React.ReactNode;

package/lib/types/components/sidePanel/companion/SplashMascot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SplashMascot.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/SplashMascot.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAiBzB,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAA;AAEpD;wCACwC;AACxC,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAIjF;AAGD,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;IAC7C,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,GAAG,KAAK,CAAC,SAAS,CAqElB"}
+{"version":3,"file":"SplashMascot.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/SplashMascot.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,MAAM,OAAO,CAAA;AAEzB,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAiB/E,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAA;AAEpD;wCACwC;AACxC,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAIjF;AAGD,2CAA2C;AAC3C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,cAAc,GAAG,SAAS,CAUnH;AAED,8CAA8C;AAC9C,wBAAgB,YAAY,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IACvD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAA;IAC/B,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAA;IAClC,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB,GAAG,KAAK,CAAC,SAAS,CAsElB"}

package/lib/types/components/sidePanel/companion/SplashMascot.js

@@ -20,10 +20,12 @@ import { jsx as _jsx } from "react/jsx-runtime";
  * 渲染路径（LogoV2 底部块，welcomePad 缩进）。
  */
 import React from 'react';
-import { Box } from '../../../ui.js';
+import { Box, useTerminalImages, useTerminalImageCellSize, useTerminalImageProtocol } from '../../../ui.js';
+import { fitSplashImageBox } from '../../splashArtRows.js';
+import { loadWhaleGirlKit } from './deepy.js';
 import { getCompanionSkin, subscribeCompanionSkin } from '../../../tuiDisplayPrefs.js';
 import { TICKLE_MIN_CLICKS, TICKLE_WINDOW_MS } from './mood.js';
-import { DeepySkin, WhaleGirlSkin } from './skins.js';
+import { DeepySkin, WhaleGirlSkin, loadWhaleGirlImageKit } from './skins.js';
 import { initialCompanionPoseState, nextCompanionPoseStep } from './pose.js';
 /** 点击反应档时长：poke 帧表一轮 2100ms，取头段（同 CompanionPanel 的口径）。 */
 const SPLASH_POKE_MS = 1400;
@@ -40,8 +42,20 @@ export function useSplashMascotSkin(pinned) {
     const id = pinned ?? setting;
     return id === 'deepy' || id === 'whaleGirl' ? id : undefined;
 }
+/** 图片原生尺寸的紧凑槽；仅启动页使用，协议/像元/素材未就绪时保持原回退。 */
+export function useSplashMascotBox(skin, compact) {
+    // 高度降级可能暂时撤掉吉祥物，因此能力探测不能只依赖吉祥物挂载。
+    const available = useTerminalImages(compact && skin === 'whaleGirl');
+    const protocol = useTerminalImageProtocol();
+    const cell = useTerminalImageCellSize();
+    const canvas = available && compact && skin === 'whaleGirl' && cell !== undefined
+        && (protocol === 'kitty' || protocol === 'sixel') && loadWhaleGirlKit() !== undefined
+        ? loadWhaleGirlImageKit()?.canvas : undefined;
+    return React.useMemo(() => canvas !== undefined && cell !== undefined
+        ? fitSplashImageBox(canvas, cell, WhaleGirlSkin.cells) : undefined, [canvas, cell]);
+}
 /** 启动页吉祥物本体：按 skin 渲染动画，点击交互（poke/连点）在内层盒。 */
-export function SplashMascot({ skin, active }) {
+export function SplashMascot({ skin, active, imageBox }) {
     const [, setBump] = React.useState(0);
     // 稳态 idle 从挂载起循环；冻结时 now 钉在挂载值 → elapsed 恒 0 → 帧 0。
     const mountedAtRef = React.useRef(Date.now());
@@ -78,6 +92,7 @@ export function SplashMascot({ skin, active }) {
         now,
         width: SPLASH_MASCOT_COLUMNS,
         animationSemantic,
+        ...(imageBox === undefined ? {} : { imageBox }),
     };
     return (_jsx(Box, { flexDirection: "column", alignItems: "center", flexShrink: 0, children: _jsx(Box, { onClick: (event) => {
                 event.stopImmediatePropagation();
@@ -93,7 +108,7 @@ export function SplashMascot({ skin, active }) {
                 overrideRef.current = rapid
                     ? { semantic: 'tickle', since: at, until: at + TICKLE_WINDOW_MS }
                     : {
-                        semantic: event.localCol < SPLASH_MASCOT_COLUMNS / 2 ? 'poke-left' : 'poke-right',
+                        semantic: event.localCol < (imageBox?.columns ?? (skin === 'whaleGirl' ? WhaleGirlSkin.cells.columns : SPLASH_MASCOT_COLUMNS)) / 2 ? 'poke-left' : 'poke-right',
                         since: at,
                         until: at + SPLASH_POKE_MS,
                     };

package/lib/types/components/sidePanel/companion/skins.d.ts

@@ -11,6 +11,7 @@
  * 皮肤 = id + cells + render(pose, ctx)，自定义皮肤走同一接口进入。
  */
 import React from 'react';
+import type { SplashImageBox } from '../../splashArtRows.js';
 import type { I18nKey } from '../../../i18n.js';
 import type { TerminalImageSource } from '../../../ink/terminal-image.js';
 import type { CompanionMood } from './mood.js';
@@ -29,6 +30,8 @@ export interface CompanionSkinRenderInput {
      *  旧调用方（缺省）皮肤退回 pose.mood 分层，属皮肤接口「未支持即
      *  退化」契约。 */
     readonly animationSemantic?: string;
+    /** 启动页专属紧凑图片槽；侧栏不传，保持原来的固定几何。 */
+    readonly imageBox?: SplashImageBox;
 }
 export interface CompanionSkin {
     readonly id: string;
@@ -86,6 +89,11 @@ interface WhaleGirlImageAnimation {
 interface WhaleGirlImageKit {
     /** img/ 目录的绝对路径（帧 PNG 解码用）。 */
     readonly dir: string;
+    /** idle 首帧 PNG 头部声明的稳定画布，不等待像素解码。 */
+    readonly canvas?: {
+        readonly width: number;
+        readonly height: number;
+    };
     readonly byKey: Readonly<Record<string, WhaleGirlImageAnimation>>;
 }
 /** 惰性加载 + 缓存图像 timings；缺失/校验失败返回 undefined（退字母格）。 */

package/lib/types/components/sidePanel/companion/skins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skins.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/skins.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"skins.d.ts","sourceRoot":"","sources":["../../../../../src/components/sidePanel/companion/skins.tsx"],"names":[],"mappings":"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"}

package/lib/types/components/sidePanel/companion/skins.js

@@ -16,7 +16,7 @@ import { existsSync, readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { join } from 'node:path';
 import { Box, Text, Image, useTerminalImages, useTerminalImageProtocol, useTerminalImageCellSize } from '../../../ui.js';
-import { WhaleArt, renderSpriteRows } from '../../Whale.js';
+import { WhaleArt, renderSpriteRows, renderCellRows } from '../../Whale.js';
 import { loadSharp } from '../../../dsh-adapter/sharp.js';
 import { DEEPY_CELLS, DEEPY_MOOD_ANIMATION, DEEPY_SEMANTIC_ANIMATION, frameAt, loadDeepyKit, loadWhaleGirlKit, renderedDeepyAnimation, } from './deepy.js';
 /** deepy 小鲸鱼（默认）：语义/心情 → 动画，elapsed → frameAt 确定性选帧。 */
@@ -122,14 +122,31 @@ export function resolveWhaleGirlAnimationKey(pose, animationSemantic, hasKey) {
  * 回归锁「全部帧内容 ⊆ [5, 5+31)」防素材更新后悄悄越窗被截。 */
 const WHALE_GIRL_LETTER_WINDOW_START = 5;
 const whaleGirlWindowCache = new Map();
-function renderedWhaleGirlWindowRows(kit, key) {
+function renderedWhaleGirlWindowRows(kit, key, imageBox) {
     const animation = kit.byKey[key];
     if (animation === undefined)
         return undefined;
-    const cacheKey = kit.id + ':window:' + key;
+    const cacheKey = kit.id + ':window:' + key + (imageBox === undefined ? '' : `:${imageBox.columns}x${imageBox.rows}`);
     let rendered = whaleGirlWindowCache.get(cacheKey);
     if (rendered === undefined) {
-        rendered = Object.freeze(animation.frames.map(frame => renderSpriteRows(frame.rows.map(row => row.slice(WHALE_GIRL_LETTER_WINDOW_START, WHALE_GIRL_LETTER_WINDOW_START + WHALE_GIRL_CELLS.columns)), kit.palette)));
+        rendered = Object.freeze(animation.frames.map(frame => {
+            if (imageBox === undefined)
+                return renderSpriteRows(frame.rows.map(row => row.slice(WHALE_GIRL_LETTER_WINDOW_START, WHALE_GIRL_LETTER_WINDOW_START + WHALE_GIRL_CELLS.columns)), kit.palette);
+            // 解码前/失败时整幅字母格 contain 进同一个槽，不裁掉头脚，也不换画跳高。
+            const pixelRows = imageBox.rows * 2;
+            const scale = Math.min(imageBox.columns / WHALE_GIRL_CELLS.columns, pixelRows / kit.rows);
+            const width = Math.max(1, Math.floor(WHALE_GIRL_CELLS.columns * scale));
+            const height = Math.max(1, Math.floor(kit.rows * scale));
+            const left = Math.floor((imageBox.columns - width) / 2);
+            const top = Math.floor((pixelRows - height) / 2);
+            return renderCellRows(imageBox.columns, pixelRows, (x, y) => {
+                if (x < left || x >= left + width || y < top || y >= top + height)
+                    return undefined;
+                const sx = Math.min(WHALE_GIRL_CELLS.columns - 1, Math.floor((x - left) * WHALE_GIRL_CELLS.columns / width));
+                const sy = Math.min(kit.rows - 1, Math.floor((y - top) * kit.rows / height));
+                return kit.palette[frame.rows[sy]?.[sx + WHALE_GIRL_LETTER_WINDOW_START] ?? '.'];
+            });
+        }));
         whaleGirlWindowCache.set(cacheKey, rendered);
     }
     return rendered;
@@ -146,14 +163,14 @@ function renderWhaleGirlLetterGrid(input) {
     const animationKey = resolveWhaleGirlAnimationKey(pose, animationSemantic, key => kit.byKey[key] !== undefined);
     if (animationKey === undefined)
         return DeepySkin.render({ ...input, width: WHALE_GIRL_CELLS.columns });
-    const rendered = renderedWhaleGirlWindowRows(kit, animationKey);
+    const rendered = renderedWhaleGirlWindowRows(kit, animationKey, input.imageBox);
     const animation = kit.byKey[animationKey];
     if (rendered === undefined || animation === undefined) {
         return DeepySkin.render({ ...input, width: WHALE_GIRL_CELLS.columns });
     }
     const frameIndex = frameAt(animation, now - moodSince);
     const rows = rendered[frameIndex] ?? rendered[0] ?? [];
-    return (_jsx(Box, { flexDirection: "column", flexShrink: 0, width: WHALE_GIRL_CELLS.columns, children: rows.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, index))) }));
+    return (_jsx(Box, { flexDirection: "column", flexShrink: 0, width: input.imageBox?.columns ?? WHALE_GIRL_CELLS.columns, children: rows.map((row, index) => (_jsx(Text, { wrap: "truncate-end", children: row }, index))) }));
 }
 export const WhaleGirlSkin = {
     id: 'whaleGirl',
@@ -210,8 +227,25 @@ export function loadWhaleGirlImageKit() {
                 continue;
             const kit = parseWhaleGirlImageKit(JSON.parse(readFileSync(join(dir, 'timings.json'), 'utf8')), dir);
             if (kit !== undefined) {
-                whaleGirlImageKitCache = kit;
-                return kit;
+                const first = kit.byKey.idle?.frames[0];
+                let canvas;
+                if (first !== undefined) {
+                    try {
+                        const png = readFileSync(join(dir, 'idle', first.file));
+                        if (png.length >= 24 && png.subarray(0, 8).equals(Buffer.from([137, 80, 78, 71, 13, 10, 26, 10]))
+                            && png.toString('ascii', 12, 16) === 'IHDR') {
+                            const width = png.readUInt32BE(16);
+                            const height = png.readUInt32BE(20);
+                            if (width > 0 && height > 0 && width <= 4096 && height <= 4096)
+                                canvas = { width, height };
+                        }
+                    }
+                    catch {
+                        // 缺失/坏帧仍走原来的异步解码失败与字母格回退。
+                    }
+                }
+                whaleGirlImageKitCache = { ...kit, ...(canvas === undefined ? {} : { canvas }) };
+                return whaleGirlImageKitCache;
             }
         }
         catch {
@@ -537,17 +571,28 @@ function WhaleGirlRasterSkin(input) {
             const frameRatio = source.width / source.height;
             // 盒宽=图宽（钳在 cells.columns 内；超宽像元比下 contain 收行不裁剪）。
             const rawColumns = Math.max(1, Math.round(cellRatio * WHALE_GIRL_CELLS.rows * frameRatio));
-            const columns = whaleGirlImageBoxColumns(cellSize, frameRatio);
-            const rows = rawColumns > columns
+            const columns = input.imageBox?.columns ?? whaleGirlImageBoxColumns(cellSize, frameRatio);
+            const rows = input.imageBox?.rows ?? (rawColumns > columns
                 ? Math.max(1, Math.round(columns / (cellRatio * frameRatio)))
-                : WHALE_GIRL_CELLS.rows;
+                : WHALE_GIRL_CELLS.rows);
             image = (_jsx(Image, { transparent: true, source: source, width: columns, height: rows, alt: "", presentation: "transcript", children: _jsx(Text, { children: Array.from({ length: rows }, () => ' '.repeat(columns)).join('\n') }) }));
         }
     }
     // 本次候选或上一帧；都没有（冷启动）时画字母格。切到还没解码的键时
     // 保持上一帧，不闪回字母格。
     const [visibleImage] = useHeldCommittedImage(image);
-    return (_jsx(Box, { ref: boxRef, flexDirection: "column", flexShrink: 0, alignItems: "center", justifyContent: "center", width: WHALE_GIRL_CELLS.columns, height: WHALE_GIRL_CELLS.rows, children: visibleImage !== undefined ? visibleImage : renderWhaleGirlLetterGrid(input) }));
+    let raster = visibleImage;
+    // 换键等待解码时保留旧像素，但 resize 后不能把旧的大 Image 盒塞进新小槽。
+    if (input.imageBox !== undefined && React.isValidElement(raster)
+        && (raster.props.width !== input.imageBox.columns || raster.props.height !== input.imageBox.rows)) {
+        const { columns, rows } = input.imageBox;
+        raster = React.cloneElement(raster, {
+            width: columns,
+            height: rows,
+            children: _jsx(Text, { children: Array.from({ length: rows }, () => ' '.repeat(columns)).join('\n') }),
+        });
+    }
+    return (_jsx(Box, { ref: boxRef, flexDirection: "column", flexShrink: 0, alignItems: "center", justifyContent: "center", width: input.imageBox?.columns ?? WHALE_GIRL_CELLS.columns, height: input.imageBox?.rows ?? WHALE_GIRL_CELLS.rows, children: raster !== undefined ? raster : renderWhaleGirlLetterGrid(input) }));
 }
 const WHALE_CELLS = Object.freeze({ columns: 40, rows: 13 });
 /** 现有像素鲸鱼：直接消费 nativeWhalePose（与开屏 splash 同一规划器、

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

@@ -74,6 +74,12 @@ export interface PanelEntry {
     /** 同 id 重注册时递增，用于重挂 error boundary。 */
     readonly registrationId: number;
     readonly badge: PanelBadge | null;
+    /**
+     * 面板自己广告的键位片段（底栏用）。`''` = 面板明确「此刻没有要广告的键」
+     * （底栏连能力位那一段也不画）；没设置过则由底栏按 capabilities 兜底。
+     * 层内状态（编辑层 vs 列表层）只有面板自己知道，所以由面板发、宿主只拼。
+     */
+    readonly hint?: string;
     readonly lastError: {
         readonly message: string;
         readonly at: number;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/components/sidePanel/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,KAAK,MAAM,OAAO,CAAA;AAC9B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,MAAM,MAAM,gBAAgB;AAC1B,uCAAuC;AACrC,QAAQ;AACV;;iCAEiC;GAC/B,SAAS,CAAA;AAEb,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B;uDACmD;IACnD,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB;0DACsD;IACtD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,YAAY,CAAA;CAC/C;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;CAClC;AAED,MAAM,WAAW,eAAe;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,wCAAwC;IACxC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAA;IACrC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAA;IACvC,QAAQ,CAAC,YAAY,CAAC,EAAE,iBAAiB,CAAA;IACzC,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;IACnD,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC3B,QAAQ,CAAC,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,iBAAiB,CAAC,CAAA;KAC3D,CAAA;CACF;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,CAAA;AAEjG,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAA;IACjC;;;;OAIG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;IAC5E,6CAA6C;IAC7C,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,uCAAuC;AACvC,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CACzB;AAED,gCAAgC;AAChC,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,KAAK,OAAO,GAAG,IAAI,CAAA;AAEvF;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+CAA+C;IAC/C,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,OAAO,KAAK,MAAM,IAAI,CAAA;IAC1F,wCAAwC;IACxC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,KAAK,OAAO,CAAA;CACjF"}

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

@@ -0,0 +1,29 @@
+import type { Brand } from '../branding.js';
+/** 启动页立绘槽的占行：鲸鱼自然高度、portrait 的 minimal 等高盒、吉祥物的侧栏默认盒。 */
+export declare const WHALE_ART_ROWS = 13;
+export declare const PORTRAIT_ART_ROWS = 11;
+export declare const MASCOT_ART_ROWS = 15;
+export type SplashArtForm = 'whale' | 'portrait' | 'mascot';
+export interface SplashImageBox {
+    readonly columns: number;
+    readonly rows: number;
+}
+/** 与 LogoV2 的默认品牌及 mascot → portrait → whale 分支一致。 */
+export declare function resolveSplashArtForm(input: {
+    readonly brand: Brand | undefined;
+    readonly whaleGirl: boolean;
+    readonly mascotSkin: string | undefined;
+}): SplashArtForm;
+export declare function splashArtRows(form: SplashArtForm, imageBox?: SplashImageBox): number;
+/**
+ * 启动页图片按原生画布占位：只缩小、不预留放大后用不上的空间。
+ * 同一个稳定画布用于全部动画帧；不按 alpha 包围盒逐帧裁剪。
+ */
+export declare function fitSplashImageBox(source: {
+    readonly width: number;
+    readonly height: number;
+}, cell: {
+    readonly width: number;
+    readonly height: number;
+}, limit: SplashImageBox): SplashImageBox;
+//# sourceMappingURL=splashArtRows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"splashArtRows.d.ts","sourceRoot":"","sources":["../../../src/components/splashArtRows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AAE3C,yDAAyD;AACzD,eAAO,MAAM,cAAc,KAAK,CAAA;AAChC,eAAO,MAAM,iBAAiB,KAAK,CAAA;AACnC,eAAO,MAAM,eAAe,KAAK,CAAA;AAEjC,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAA;AAC3D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,sDAAsD;AACtD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAA;IACjC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC,GAAG,aAAa,CAKhB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,EAAE,QAAQ,CAAC,EAAE,cAAc,GAAG,MAAM,CAIpF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EAC3D,IAAI,EAAE;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACzD,KAAK,EAAE,cAAc,GACpB,cAAc,CAMhB"}

package/lib/types/components/splashArtRows.js

@@ -0,0 +1,31 @@
+/** 启动页立绘槽的占行：鲸鱼自然高度、portrait 的 minimal 等高盒、吉祥物的侧栏默认盒。 */
+export const WHALE_ART_ROWS = 13;
+export const PORTRAIT_ART_ROWS = 11;
+export const MASCOT_ART_ROWS = 15;
+/** 与 LogoV2 的默认品牌及 mascot → portrait → whale 分支一致。 */
+export function resolveSplashArtForm(input) {
+    const brand = input.brand ?? 'deepseek';
+    if (brand === 'deepseek' && (input.mascotSkin === 'deepy' || input.mascotSkin === 'whaleGirl'))
+        return 'mascot';
+    if (input.whaleGirl || brand !== 'deepseek')
+        return 'portrait';
+    return 'whale';
+}
+export function splashArtRows(form, imageBox) {
+    if (form === 'whale')
+        return WHALE_ART_ROWS;
+    if (form === 'portrait')
+        return PORTRAIT_ART_ROWS;
+    return imageBox?.rows ?? MASCOT_ART_ROWS;
+}
+/**
+ * 启动页图片按原生画布占位：只缩小、不预留放大后用不上的空间。
+ * 同一个稳定画布用于全部动画帧；不按 alpha 包围盒逐帧裁剪。
+ */
+export function fitSplashImageBox(source, cell, limit) {
+    const scale = Math.min(1, limit.columns * cell.width / source.width, limit.rows * cell.height / source.height);
+    return {
+        columns: Math.max(1, Math.min(limit.columns, Math.ceil(source.width * scale / cell.width))),
+        rows: Math.max(1, Math.min(limit.rows, Math.ceil(source.height * scale / cell.height))),
+    };
+}

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

@@ -0,0 +1,70 @@
+/**
+ * Agent Teams in the agents surfaces (issue #1241, phase 2): fold the
+ * session's `TeamView` and its subagent rows into what the dashboard
+ * renders. A teammate is a continuable subagent of the Lead whose row id is
+ * the member id, so the two join by id; neither side overwrites the other's
+ * state (see `teamMemberStatus`). Pure: no I/O, no backend import.
+ */
+import type { TeamMember, TeamTask, TeamView } from '../adapter/ports/channel-view.js';
+import type { SubagentState } from '../dsh-adapter/subagents.js';
+/** A member's state as shown: durable `phase` first, then the run. `active`
+ *  is an active member whose run this session cannot see (a teammate's own
+ *  subagent rows never hold its siblings). */
+export type TeamMemberStatus = 'provisioning' | 'running' | 'idle' | 'active' | 'failed';
+/** One teammate, with its subagent row once the host has announced it. */
+export interface TeamMemberRow {
+    readonly member: TeamMember;
+    readonly subagent?: SubagentState;
+    readonly status: TeamMemberStatus;
+}
+export interface TeamDashboardModel {
+    readonly lead?: TeamMember;
+    /** Whether the session on screen is the Lead (its subagent rows are the teammates). */
+    readonly viewedFromLead: boolean;
+    readonly teammates: readonly TeamMemberRow[];
+    /** Subagent rows that are not team members (workflow / ralph spawns). */
+    readonly others: readonly SubagentState[];
+}
+/**
+ * A member's shown state. A failed `phase` is durable and wins; provisioning
+ * has no run yet. An active member is running only while its row runs: a
+ * finished turn leaves the member alive and waiting (a message wakes it),
+ * so a completed — or failed, or absent — run reads as idle, never done.
+ * @param member - Roster row.
+ * @param subagent - The member's subagent row, if any.
+ * @param runKnown - Whether the subagent rows are the Lead's (default).
+ * @returns the state to render.
+ */
+export declare function teamMemberStatus(member: TeamMember, subagent: SubagentState | undefined, runKnown?: boolean): TeamMemberStatus;
+/**
+ * Join the roster with the subagent rows.
+ * @param team - The session's team.
+ * @param subagents - The session's subagent rows.
+ * @param sessionId - The session on screen; inside a teammate its rows are
+ *   its own children, never joined with the roster.
+ * @returns the Lead, teammates in roster order, and the remaining rows.
+ */
+export declare function teamDashboardModel(team: TeamView, subagents: readonly SubagentState[], sessionId?: string): TeamDashboardModel;
+/**
+ * Teammates on the roster: those known to be running or provisioning, and
+ * those that may be running. Inside a teammate a sibling's run is not
+ * visible, so an active sibling is `unseen`; the teammate on screen itself
+ * counts in neither.
+ * @param team - The session's team.
+ * @param subagents - The session's subagent rows.
+ * @param sessionId - The session on screen.
+ * @returns the three counts.
+ */
+export declare function teamMemberCounts(team: TeamView, subagents: readonly SubagentState[], sessionId?: string): {
+    readonly total: number;
+    readonly active: number;
+    readonly unseen: number;
+};
+/** Completed / total of the task board. */
+export declare function teamTaskProgress(tasks: readonly TeamTask[]): {
+    readonly completed: number;
+    readonly total: number;
+};
+/** A pending task some blocker still holds back. */
+export declare function isTeamTaskBlocked(task: TeamTask): boolean;
+//# sourceMappingURL=teamRoster.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"teamRoster.d.ts","sourceRoot":"","sources":["../../../src/components/teamRoster.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAA;AACtF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAEhE;;8CAE8C;AAC9C,MAAM,MAAM,gBAAgB,GAAG,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAExF,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;CAClC;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAA;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAA;IAChC,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAA;IAC5C,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAA;CAC1C;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,aAAa,GAAG,SAAS,EAAE,QAAQ,UAAO,GAAG,gBAAgB,CAK3H;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAmB9H;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQtL;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,GAAG;IAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAEnH;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEzD"}

package/lib/types/components/teamRoster.js

@@ -0,0 +1,78 @@
+/**
+ * A member's shown state. A failed `phase` is durable and wins; provisioning
+ * has no run yet. An active member is running only while its row runs: a
+ * finished turn leaves the member alive and waiting (a message wakes it),
+ * so a completed — or failed, or absent — run reads as idle, never done.
+ * @param member - Roster row.
+ * @param subagent - The member's subagent row, if any.
+ * @param runKnown - Whether the subagent rows are the Lead's (default).
+ * @returns the state to render.
+ */
+export function teamMemberStatus(member, subagent, runKnown = true) {
+    if (member.phase === 'failed')
+        return 'failed';
+    if (member.phase === 'provisioning')
+        return 'provisioning';
+    if (!runKnown)
+        return 'active';
+    return subagent?.status === 'running' || subagent?.status === 'starting' ? 'running' : 'idle';
+}
+/**
+ * Join the roster with the subagent rows.
+ * @param team - The session's team.
+ * @param subagents - The session's subagent rows.
+ * @param sessionId - The session on screen; inside a teammate its rows are
+ *   its own children, never joined with the roster.
+ * @returns the Lead, teammates in roster order, and the remaining rows.
+ */
+export function teamDashboardModel(team, subagents, sessionId) {
+    const viewedFromLead = sessionId === undefined || sessionId === team.leadSessionId;
+    const byId = new Map();
+    if (viewedFromLead)
+        for (const row of subagents)
+            byId.set(row.agentId, row);
+    const teammates = [];
+    const memberIds = new Set();
+    for (const member of team.members) {
+        if (member.role !== 'teammate')
+            continue;
+        const subagent = byId.get(member.id);
+        if (subagent !== undefined)
+            memberIds.add(member.id);
+        teammates.push({ member, status: teamMemberStatus(member, subagent, viewedFromLead), ...subagent === undefined ? {} : { subagent } });
+    }
+    const lead = team.members.find(member => member.role === 'lead');
+    return {
+        ...lead === undefined ? {} : { lead },
+        viewedFromLead,
+        teammates,
+        others: subagents.filter(row => !memberIds.has(row.agentId)),
+    };
+}
+/**
+ * Teammates on the roster: those known to be running or provisioning, and
+ * those that may be running. Inside a teammate a sibling's run is not
+ * visible, so an active sibling is `unseen`; the teammate on screen itself
+ * counts in neither.
+ * @param team - The session's team.
+ * @param subagents - The session's subagent rows.
+ * @param sessionId - The session on screen.
+ * @returns the three counts.
+ */
+export function teamMemberCounts(team, subagents, sessionId) {
+    const { teammates } = teamDashboardModel(team, subagents, sessionId);
+    const counted = teammates.filter(row => row.member.id !== sessionId);
+    return {
+        total: teammates.length,
+        active: counted.filter(row => row.status === 'running' || row.status === 'provisioning').length,
+        unseen: counted.filter(row => row.status === 'active').length,
+    };
+}
+/** Completed / total of the task board. */
+export function teamTaskProgress(tasks) {
+    return { completed: tasks.filter(task => task.status === 'completed').length, total: tasks.length };
+}
+/** A pending task some blocker still holds back. */
+export function isTeamTaskBlocked(task) {
+    return task.status === 'pending' && !task.ready;
+}