dsh-plugin-core 0.2.13 → 0.3.0

package/dist/session/mirror/ChatGroupSeat.js

@@ -0,0 +1,134 @@
+// 官方对照：packages/client/ui-chat/src/client/chat/ChatGroupSeat.js（0.1.7-rc.2 lib/client.js:2178-2385）
+// 二级收折：root[data-step-process] > title（button，activity 图标 ↔ 箭头 hover/展开互换，
+//   label = processTitle(summary)）+ body（max-height min(400px,50vh)，上下 24px 渐隐遮罩，
+//   --dsh-chat-flow-gap:8px）> content > 组内条目（ChatNodeSeat 逐个，三级各自展开）。
+// 外层可见性沿用官方 outerHidden：foldCompleted && turn 已闭合 && 有 spec && !alwaysOpen
+//   && 存储的 answerStep 不匹配 ⇒ 整组 hidden（一级「用时 N 秒」行收起时组随之隐藏）。
+// grouped（历史轮才收折：policy.stepGrouping === 'history' && turn 非 open）为 false 时
+//   隐藏标题行、body 展开不限高（expandedBody）。
+import { createElement as h, useCallback, useEffect, useRef, useState } from 'react';
+import { IconAgentPresetOutlineRegular, IconApiOutlineRegular, IconBrowseOutlineRegular, IconChevronDownOutlineRegular, IconChevronUpOutlineRegular, IconCodeOutlineRegular, IconEditOutlineRegular, IconGlobeOutlineRegular, IconPlanOutlineRegular, IconQuestionOutlineRegular, IconSearchOutlineRegular, IconSparkleRegular, IconThinkOutlineRegular, } from '../../ui/official.js';
+import { officialClass } from '../official-classes.js';
+import { ChatNodeSeatMirror, readPresentation } from './ChatNodeSeat.js';
+import { processTitle } from './process-groups.js';
+/** 官方 PROCESS_ICONS（lib/client.js:2187-2201）；工具行图标同源（edit/write=铅笔、generic=sparkle）。 */
+export const PROCESS_ICONS = {
+    thinking: IconThinkOutlineRegular,
+    read: IconBrowseOutlineRegular,
+    readImage: IconBrowseOutlineRegular,
+    search: IconSearchOutlineRegular,
+    edit: IconEditOutlineRegular,
+    write: IconEditOutlineRegular,
+    commands: IconApiOutlineRegular,
+    code: IconCodeOutlineRegular,
+    webSearch: IconGlobeOutlineRegular,
+    webFetch: IconBrowseOutlineRegular,
+    subagents: IconAgentPresetOutlineRegular,
+    plan: IconPlanOutlineRegular,
+    questions: IconQuestionOutlineRegular,
+    tools: IconSparkleRegular,
+};
+/** 官方图标尺寸（14px，除 thinking/commands/webSearch/plan/questions 用默认）。 */
+const SMALL_ICONS = new Set([
+    'read', 'readImage', 'search', 'edit', 'write', 'code', 'webFetch', 'subagents', 'tools',
+]);
+/** 过程分组（二级收折）：汇总行 + 组内条目。 */
+export function ChatGroupSeatMirror(props) {
+    const { group, grouped, store, openState, onSetOpen, foldCompleted, renderNode, t } = props;
+    const [open, setOpen] = useState(false);
+    const first = group.members[0];
+    const firstNode = first === undefined ? undefined : store?.get(first.key);
+    const presentation = first === undefined
+        ? undefined
+        : readPresentation(store, first.key);
+    const spec = presentation?.spec ?? undefined;
+    const location = firstNode?.location;
+    const reason = location?.kind === 'turn' || location?.kind === 'step'
+        ? location.turn?.end?.data?.reason?.kind
+        : undefined;
+    // 官方 ChatGroupSeat 的 alwaysOpen（2301）：与 seat 的版本略有差异（多 turnClosed === false 分支）。
+    const alwaysOpen = presentation?.turnClosed === false
+        || presentation?.hasInterleavedInput === true
+        || reason === 'aborted'
+        || reason === 'error';
+    const storedAnswerStep = openState.get(group.data.turn);
+    const outerHidden = foldCompleted && presentation?.turnClosed === true && spec !== undefined
+        && !alwaysOpen && storedAnswerStep !== (spec.answerStep ?? 0);
+    useEffect(() => {
+        if (outerHidden)
+            setOpen(false);
+    }, [outerHidden]);
+    const bodyRef = useRef(null);
+    const [edges, setEdges] = useState({ up: false, down: false });
+    const measure = useCallback(() => {
+        const el = bodyRef.current;
+        if (el === null)
+            return;
+        setEdges({
+            up: el.scrollTop > 1,
+            down: el.scrollTop + el.clientHeight < el.scrollHeight - 1,
+        });
+    }, []);
+    useEffect(() => {
+        if (grouped && open)
+            measure();
+    }, [grouped, open, measure]);
+    if (first === undefined || firstNode === undefined)
+        return null;
+    const label = group.data.closed ? processTitle(group.data.summary, t) : t('stepProcessDoneThinking');
+    const activity = group.data.summary.counts[0]?.kind ?? 'thinking';
+    const ActivityIcon = PROCESS_ICONS[activity] ?? IconThinkOutlineRegular;
+    const bodyClass = [
+        officialClass('ChatGroupSeat', 'body') ?? '',
+        grouped ? '' : officialClass('ChatGroupSeat', 'expandedBody') ?? '',
+        grouped && edges.up ? officialClass('ChatGroupSeat', 'fadeTop') ?? '' : '',
+        grouped && edges.down ? officialClass('ChatGroupSeat', 'fadeBottom') ?? '' : '',
+    ].filter(part => part !== '').join(' ');
+    return h('div', {
+        className: officialClass('ChatGroupSeat', 'root') ?? '',
+        'data-chat-group-key': group.key,
+        'data-chat-flow-key': group.key,
+        'data-chat-anchor-key': `group:${group.key}`,
+        'data-chat-turn': group.data.turn,
+        'data-step-process': true,
+        'data-group-expanded-mode': !grouped || undefined,
+        hidden: outerHidden || undefined,
+    }, grouped
+        ? h('button', {
+            type: 'button',
+            className: officialClass('ChatGroupSeat', 'title') ?? '',
+            'aria-expanded': open,
+            onClick: () => { setOpen(value => !value); },
+        }, h('span', {
+            className: officialClass('ChatGroupSeat', 'leading') ?? '',
+            'aria-hidden': true,
+        }, h('span', {
+            className: officialClass('ChatGroupSeat', 'activityIcon') ?? '',
+            'data-step-process-icon': true,
+        }, h(ActivityIcon, SMALL_ICONS.has(activity) ? { size: 14 } : {})), open
+            ? h(IconChevronUpOutlineRegular, { className: officialClass('ChatGroupSeat', 'chevron') ?? '' })
+            : h(IconChevronDownOutlineRegular, { className: officialClass('ChatGroupSeat', 'chevron') ?? '' })), h('span', { className: officialClass('ChatGroupSeat', 'label') ?? '' }, label))
+        : null, h('div', {
+        ref: bodyRef,
+        className: bodyClass,
+        'data-step-process-body': true,
+        'data-scroll-up': edges.up || undefined,
+        'data-scroll-down': edges.down || undefined,
+        onScroll: measure,
+        hidden: grouped && !open || undefined,
+    }, h('div', {
+        className: officialClass('ChatGroupSeat', 'content') ?? '',
+        'data-step-process-content': true,
+        'data-chat-flow': '',
+    }, group.members.map(member => h(ChatNodeSeatMirror, {
+        key: JSON.stringify([member.key, member.groupPart ?? null]),
+        node: store?.get(member.key) ?? { key: member.key, kind: '', anchorSeq: 0 },
+        groupPart: member.groupPart,
+        store,
+        openState,
+        onSetOpen,
+        foldCompleted,
+        renderNode,
+    })))));
+}
+//# sourceMappingURL=ChatGroupSeat.js.map

package/dist/session/mirror/ChatGroupSeat.js.map

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

package/dist/session/mirror/ChatNodeSeat.d.ts

@@ -0,0 +1,43 @@
+import { createElement as h } from 'react';
+import type { ReactNode } from 'react';
+import type { ChatNodeFace, ChatNodeStoreFace, NodeLocationFace, TurnLocationFace, TurnProcessPresentationFace, TurnProcessSpecFace } from '../faces.js';
+/**
+ * 官方 TURN_PROCESS_INDEPENDENT_KINDS（lib/client.js:1525）：这些 kind 永远不进过程折叠区。
+ */
+export declare const TURN_PROCESS_INDEPENDENT_KINDS: ReadonlySet<string>;
+/**
+ * 读过程席位快照。宿主 API 形态变了也只降级成「不折叠」，不让整个弹窗白屏。
+ */
+export declare function readPresentation(store: ChatNodeStoreFace | undefined, key: string): TurnProcessPresentationFace | undefined;
+/** 交给节点视图的 Turn 过程席位（官方 owner.turnProcess，ChatNodeSeat.tsx:1693-1706）。 */
+export interface TurnProcessHandle {
+    spec?: TurnProcessSpecFace;
+    foldable: boolean;
+    hasContent: boolean;
+    open: boolean;
+    /** 官方 turnProcessAlwaysOpen(node)：live / 已停止 / 失败的 turn 不允许折叠。 */
+    alwaysOpen: boolean;
+    setOpen(open: boolean): void;
+}
+/** 节点视图渲染函数（官方 slot "conversation.chat.node" 的等价物）。 */
+export type NodeRenderer = (node: ChatNodeFace, turnProcess: TurnProcessHandle | undefined, 
+/** 官方 groupPart：'reasoning' 只渲染思考块（组内），'response' 只渲染回复正文（组外）。 */
+groupPart?: 'response' | 'reasoning') => ReactNode;
+/** 取节点所属 turn（官方 turnOf，ChatNodeSeat.tsx:1660）。 */
+export declare function turnOf(node: ChatNodeFace | undefined): number | undefined;
+/** 官方 turnProcessAlwaysOpen（lib/client.js:1558）：live / 已停止 / 失败的 turn 不折叠。 */
+export declare function turnProcessAlwaysOpen(node: ChatNodeFace | undefined): boolean;
+/** 一个 keyed 节点 → 一个 flowItem（官方 ChatNodeSeat 的 JSX 等价物）。 */
+export declare function ChatNodeSeatMirror(props: {
+    node: ChatNodeFace;
+    groupPart?: 'response' | 'reasoning';
+    store?: ChatNodeStoreFace;
+    /** turn → 已展开的 answerStep（官方 store 的 storedTurnProcessEntry）。 */
+    openState: ReadonlyMap<number, number>;
+    onSetOpen(turn: number, answerStep: number, open: boolean): void;
+    /** 官方 usePresentation(policy => policy.foldCompletedTurns)；历史只读视图恒 true。 */
+    foldCompleted: boolean;
+    renderNode: NodeRenderer;
+}): ReturnType<typeof h> | null;
+export type { NodeLocationFace, TurnLocationFace };
+//# sourceMappingURL=ChatNodeSeat.d.ts.map

package/dist/session/mirror/ChatNodeSeat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatNodeSeat.d.ts","sourceRoot":"","sources":["../../../src/session/mirror/ChatNodeSeat.ts"],"names":[],"mappings":"AAqBA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,2BAA2B,EAC3B,mBAAmB,EACpB,MAAM,aAAa,CAAA;AAEpB;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,WAAW,CAAC,MAAM,CAS7D,CAAA;AAEF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAS3H;AAED,0EAA0E;AAC1E,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,mBAAmB,CAAA;IAC1B,QAAQ,EAAE,OAAO,CAAA;IACjB,UAAU,EAAE,OAAO,CAAA;IACnB,IAAI,EAAE,OAAO,CAAA;IACb,kEAAkE;IAClE,UAAU,EAAE,OAAO,CAAA;IACnB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;CAC7B;AAED,uDAAuD;AACvD,MAAM,MAAM,YAAY,GAAG,CACzB,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,iBAAiB,GAAG,SAAS;AAC1C,kEAAkE;AAClE,SAAS,CAAC,EAAE,UAAU,GAAG,WAAW,KACjC,SAAS,CAAA;AAEd,mDAAmD;AACnD,wBAAgB,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED,8EAA8E;AAC9E,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,CAK7E;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,IAAI,EAAE,YAAY,CAAA;IAClB,SAAS,CAAC,EAAE,UAAU,GAAG,WAAW,CAAA;IACpC,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,iEAAiE;IACjE,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAChE,4EAA4E;IAC5E,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,YAAY,CAAA;CACzB,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAgE9B;AAED,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,CAAA"}

package/dist/session/mirror/ChatNodeSeat.js

@@ -0,0 +1,133 @@
+// 官方对照：packages/client/ui-chat/src/client/chat/ChatNodeSeat.tsx（0.1.7-rc.2 lib/client.js:1668-1771）
+//   + 同文件里的 ChatNodeList（lib/client.js:5004-5038，order → seat 列表）。
+//
+// 这是「官方把一个 turn 折成一行」的全部判定，逐行照抄（源码行号见兄弟项目 ui-map §十七）：
+//   liveProcess        = presentation && !turnClosed
+//   alwaysOpen         = liveProcess || hasInterleavedInput || turnProcessAlwaysOpen(node)
+//   processOpen        = alwaysOpen || stored.answerStep === spec.answerStep
+//   processWindowReady = spec && presentation && foldCompleted && presentation.turn === spec.turn && (turnStarted || turnClosed)
+//   processMember      = !TURN_PROCESS_INDEPENDENT_KINDS.has(kind) && anchorSeq >= spec.processStartSeq
+//                        && (liveProcess || spec.answerAnchorSeq === null || anchorSeq < spec.answerAnchorSeq
+//                            || groupPart === 'reasoning' && kind === 'assistant-step' && data.step === spec.answerStep)
+//   processAnswer      = !liveProcess && groupPart !== 'reasoning' && kind === 'assistant-step' && data.step === spec.answerStep
+//   ownsDisclosure     = kind === 'turn-process' || processAnswer
+//   foldable           = processWindowReady && (liveProcess || processMember || ownsDisclosure)
+//   controllerInactive = kind === 'turn-process' && foldCompleted && !foldable
+//   compactAnswer      = processAnswer && foldable && presentation.compactAnswer && !processOpen
+//   processHidden      = controllerInactive || (foldable && processMember && !processOpen)
+// 折叠 = 给 flowItem 写 hidden 属性（官方由 useSearchableHidden 响应式置位，这里声明式写）。
+// ⚠ 与官方的两点已知偏差（只读历史场景等价，写在此处便于日后 diff）：
+//   1. 官方每个 seat 各自订阅 nodeStore/processSource；我们按「外层快照变化 ⇒ 整体重算」读取。
+//   2. 官方 grouped('chat') 的分组项（ChatGroupSeat）由 process-groups.ts 算法移植补齐。
+import { createElement as h } from 'react';
+import { officialClass } from '../official-classes.js';
+/**
+ * 官方 TURN_PROCESS_INDEPENDENT_KINDS（lib/client.js:1525）：这些 kind 永远不进过程折叠区。
+ */
+export const TURN_PROCESS_INDEPENDENT_KINDS = new Set([
+    'system-prompt',
+    'user',
+    'steering',
+    'turn-trigger',
+    'turn-process',
+    'turn-error',
+    'turn-max-tokens',
+    'turn-tail',
+]);
+/**
+ * 读过程席位快照。宿主 API 形态变了也只降级成「不折叠」，不让整个弹窗白屏。
+ */
+export function readPresentation(store, key) {
+    if (store === undefined)
+        return undefined;
+    try {
+        const source = store.processSource;
+        if (typeof source !== 'function')
+            return undefined;
+        return source.call(store, key)?.getSnapshot();
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 取节点所属 turn（官方 turnOf，ChatNodeSeat.tsx:1660）。 */
+export function turnOf(node) {
+    const location = node?.location;
+    return location?.kind === 'turn' || location?.kind === 'step' ? location.turn?.turn : undefined;
+}
+/** 官方 turnProcessAlwaysOpen（lib/client.js:1558）：live / 已停止 / 失败的 turn 不折叠。 */
+export function turnProcessAlwaysOpen(node) {
+    const location = node?.location;
+    if (location?.kind !== 'turn' && location?.kind !== 'step')
+        return false;
+    const reason = location.turn?.end?.data?.reason?.kind;
+    return location.turn?.status === 'open' || reason === 'aborted' || reason === 'error';
+}
+/** 一个 keyed 节点 → 一个 flowItem（官方 ChatNodeSeat 的 JSX 等价物）。 */
+export function ChatNodeSeatMirror(props) {
+    const { node, groupPart, store, openState, onSetOpen, foldCompleted, renderNode } = props;
+    const turn = turnOf(node);
+    const presentation = readPresentation(store, node.key);
+    // 官方 spec 来自 presentation；弹窗读归档会话时投影可能更薄 ⇒ turn-process 自身 data 兜底。
+    const spec = (presentation?.spec ?? undefined)
+        ?? (node.kind === 'turn-process' ? node.data : undefined);
+    const liveProcess = presentation !== undefined && presentation.turnClosed !== true;
+    const interleavedInput = presentation?.hasInterleavedInput === true;
+    const alwaysOpen = liveProcess || interleavedInput || turnProcessAlwaysOpen(node);
+    const storedAnswerStep = turn === undefined ? undefined : openState.get(turn);
+    const processOpen = alwaysOpen || (spec !== undefined && storedAnswerStep === (spec.answerStep ?? 0));
+    const setOpen = (open) => {
+        if (spec !== undefined && !alwaysOpen && turn !== undefined)
+            onSetOpen(turn, spec.answerStep ?? 0, open);
+    };
+    const processWindowReady = spec !== undefined && presentation !== undefined && foldCompleted
+        && presentation.turn === spec.turn
+        && (presentation.turnStarted === true || presentation.turnClosed === true);
+    const dataStep = typeof node.data?.step === 'number' ? node.data.step : undefined;
+    const processMember = processWindowReady && spec !== undefined
+        && !TURN_PROCESS_INDEPENDENT_KINDS.has(node.kind)
+        && node.anchorSeq >= spec.processStartSeq
+        && (liveProcess
+            || spec.answerAnchorSeq === null
+            || node.anchorSeq < spec.answerAnchorSeq
+            || (groupPart === 'reasoning' && node.kind === 'assistant-step' && dataStep === spec.answerStep));
+    const processAnswer = processWindowReady && spec !== undefined && !liveProcess
+        && groupPart !== 'reasoning'
+        && node.kind === 'assistant-step'
+        && dataStep === spec.answerStep;
+    const ownsDisclosure = node.kind === 'turn-process' || processAnswer;
+    const foldable = processWindowReady && (liveProcess || processMember || ownsDisclosure);
+    const turnProcess = spec === undefined ? undefined : {
+        spec,
+        foldable,
+        hasContent: !interleavedInput && (presentation?.hasExternalProcess === true || spec.inlineReasoning),
+        open: processOpen,
+        alwaysOpen,
+        setOpen,
+    };
+    const controllerInactive = node.kind === 'turn-process' && foldCompleted && !foldable;
+    const compactAnswer = processAnswer && foldable && presentation?.compactAnswer === true && !processOpen;
+    const processHidden = controllerInactive || (foldable && processMember && !processOpen);
+    // ⚠ groupPart 必须传给节点视图：'reasoning' 只渲染思考块、'response' 只渲染回复正文
+    // （官方块渲染器 lib/client.js:5824-5825）。漏传会把整步（思考+文本+工具块）全画出来——
+    // 步内工具块再画一张 = 与独立工具节点重复（真机踩过，2026-09-27）。
+    const inner = renderNode(node, turnProcess, groupPart);
+    if (inner === null || inner === undefined)
+        return null;
+    const flowKey = groupPart === undefined || groupPart === 'response' ? node.key : JSON.stringify([node.key, groupPart]);
+    return h('div', {
+        className: officialClass('ChatView', 'flowItem') ?? '',
+        'data-chat-anchor-key': flowKey,
+        'data-chat-flow-key': flowKey,
+        'data-chat-paging-anchor': node.kind !== 'turn-process' || undefined,
+        'data-chat-node-key': node.key,
+        'data-chat-group-part': groupPart,
+        'data-chat-flow-kind': node.kind,
+        'data-chat-turn': turn,
+        'data-turn-process-member': processMember || undefined,
+        'data-turn-process-hidden': processHidden || undefined,
+        'data-turn-process-answer': compactAnswer || undefined,
+        hidden: processHidden || undefined,
+    }, inner);
+}
+//# sourceMappingURL=ChatNodeSeat.js.map

package/dist/session/mirror/ChatNodeSeat.js.map

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

package/dist/session/mirror/ChatView.d.ts

@@ -0,0 +1,47 @@
+import { createElement as h } from 'react';
+import type { ReactNode } from 'react';
+import type { Translate } from '../../utils/i18n.js';
+import type { ChatNodeStoreFace, TurnsFace } from '../faces.js';
+import type { NodeRenderer } from './ChatNodeSeat.js';
+import type { ChatEntry, ProcessGroupSnapshot } from './process-groups.js';
+/** 会话区骨架：frame > root > scroll > column（类名一律取官方 ChatView.module.css，取不到 = 空类）。
+ *
+ *  `dshpc-sv-frame` / `dshpc-sv-scroll` = 本包**稳定钩子类**（不走 officialClass 发现，官方类命中时也照样挂）：
+ * 会话区**纵向间距的唯一真源**。官方 scroll 自带纵向 16px、官方 frame 的纵向值又不确定，
+ * 归一方案（移植自兄弟项目 2026-10-03 定尺）：**scroll 钩子把官方纵向 16px 归零，
+ * frame 钩子独自定 17/17**，两条钩子都用双类名提高特异性压过官方 CSS module（0,2,0 > 0,1,0），
+ * 不依赖注入顺序 ⇒ 命中 / 未命中两条路径纵向完全一致。
+ */
+export declare function ChatViewFrame(props: {
+    children?: ReactNode;
+}): ReturnType<typeof h>;
+/** 官方 ChatNodeList：order → seat 列表（grouped 视图 = entries + groups 路径）。 */
+export declare function ChatNodeListMirror(props: {
+    order: readonly string[];
+    store?: ChatNodeStoreFace;
+    /** 官方 grouped('chat') 的 entries + 组快照（buildProcessGroups 产出）；缺省走 order 兜底。 */
+    entries?: ReadonlyArray<ChatEntry>;
+    groups?: ReadonlyMap<string, ProcessGroupSnapshot>;
+    /** 官方 timeline.turns（判 turn 是否 open ⇒ grouped 政策）。 */
+    turns?: TurnsFace;
+    openState: ReadonlyMap<number, number>;
+    onSetOpen(turn: number, answerStep: number, open: boolean): void;
+    foldCompleted: boolean;
+    renderNode: NodeRenderer;
+    t: Translate;
+}): Array<ReturnType<typeof h> | null>;
+/** 加载 / 空态提示行（13px tertiary）。 */
+export declare function ChatHint(props: {
+    text: string;
+}): ReturnType<typeof h>;
+/** 「加载更早记录」按钮（官方 older：按钮 4px 12px / 12px 字号 / radius-sm / 底色 interactive-bg-hover-solid）。 */
+export declare function ChatOlderButton(props: {
+    label: string;
+    onClick: () => void;
+}): ReturnType<typeof h>;
+/** 「到底部」悬浮钮（官方 toBottom：34×34 圆形悬浮，仅在有更多历史时显示）。 */
+export declare function ChatToBottom(props: {
+    label: string;
+    onClick: () => void;
+}): ReturnType<typeof h>;
+//# sourceMappingURL=ChatView.d.ts.map

package/dist/session/mirror/ChatView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatView.d.ts","sourceRoot":"","sources":["../../../src/session/mirror/ChatView.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAGrD,OAAO,KAAK,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE1E;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAQnF;AAED,yEAAyE;AACzE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACxB,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,8EAA8E;IAC9E,OAAO,CAAC,EAAE,aAAa,CAAC,SAAS,CAAC,CAAA;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;IAClD,sDAAsD;IACtD,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACtC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,IAAI,CAAA;IAChE,aAAa,EAAE,OAAO,CAAA;IACtB,UAAU,EAAE,YAAY,CAAA;IACxB,CAAC,EAAE,SAAS,CAAA;CACb,GAAG,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CA8ErC;AAQD,iCAAiC;AACjC,wBAAgB,QAAQ,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAEtE;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAInG;AAED,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,IAAI,CAAA;CAAE,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAIhG"}

package/dist/session/mirror/ChatView.js

@@ -0,0 +1,127 @@
+// 官方对照：packages/client/ui-chat/src/client/chat/ChatView.tsx（0.1.7-rc.2 lib/client.js:5004-5260）
+// 骨架四层：frame（> TurnNavigator）> root[data-chat-following-tail] > scroll > column[data-chat-flow]
+//   column 子项：hint（loading）/ openError / older（hasMore）/ 各 flowItem（ChatNodeList）
+// root 内另有 toBottomSlot（官方按「是否贴尾」显隐，弹窗恒贴尾 ⇒ 不渲染）。
+// ChatNodeList：entries → seat；官方 entries 优先取 grouped('chat')，取不到时 = order.map(key)。
+import { createElement as h } from 'react';
+import { officialClass } from '../official-classes.js';
+import { ChatGroupSeatMirror } from './ChatGroupSeat.js';
+import { ChatNodeSeatMirror } from './ChatNodeSeat.js';
+/** 会话区骨架：frame > root > scroll > column（类名一律取官方 ChatView.module.css，取不到 = 空类）。
+ *
+ *  `dshpc-sv-frame` / `dshpc-sv-scroll` = 本包**稳定钩子类**（不走 officialClass 发现，官方类命中时也照样挂）：
+ * 会话区**纵向间距的唯一真源**。官方 scroll 自带纵向 16px、官方 frame 的纵向值又不确定，
+ * 归一方案（移植自兄弟项目 2026-10-03 定尺）：**scroll 钩子把官方纵向 16px 归零，
+ * frame 钩子独自定 17/17**，两条钩子都用双类名提高特异性压过官方 CSS module（0,2,0 > 0,1,0），
+ * 不依赖注入顺序 ⇒ 命中 / 未命中两条路径纵向完全一致。
+ */
+export function ChatViewFrame(props) {
+    return h('div', { className: `${officialClass('ChatView', 'frame') ?? ''} dshpc-sv-frame dshpc-sv-chat` }, h('div', { className: officialClass('ChatView', 'root') ?? '' }, h('div', { className: `${officialClass('ChatView', 'scroll') ?? ''} dshpc-sv-scroll` }, h('div', { className: officialClass('ChatView', 'column') ?? '', 'data-chat-flow': '' }, props.children))));
+}
+/** 官方 ChatNodeList：order → seat 列表（grouped 视图 = entries + groups 路径）。 */
+export function ChatNodeListMirror(props) {
+    const { order, store, entries, groups, turns, openState, onSetOpen, foldCompleted, renderNode, t } = props;
+    const rows = [];
+    const read = store === undefined ? undefined : store.get;
+    if (typeof read !== 'function' || store === undefined)
+        return rows;
+    const readSafe = (key) => {
+        try {
+            return read.call(store, key);
+        }
+        catch {
+            return undefined;
+        }
+    };
+    if (entries !== undefined && groups !== undefined) {
+        // 官方 deferCollapse：**每一轮（turn）的最后那一个过程组**保持 flat
+        // （不画「已完成分析…」头、组内条目直接铺开），该轮其余组照常收折。
+        // 例：turn 1 切出 2 组 ⇒ 前 1 组收折、最后 1 组平铺；turn 3 切出 5 组 ⇒ 前 4 组收折、最后 1 组平铺。
+        // ⚠️ turn = -1 的组（command 节点无 turn location，process-groups.ts:176 `turn ?? -1`）
+        // **不开新轮**，并入它前面那一轮 —— 否则会被单独当成一轮、多平铺一处（真机 2026-10-23）。
+        const flatKeys = new Set();
+        {
+            let bucket = [];
+            let bucketTurn;
+            const closeBucket = () => {
+                const last = bucket[bucket.length - 1];
+                if (last !== undefined)
+                    flatKeys.add(last);
+                bucket = [];
+            };
+            for (const entry of entries) {
+                if (entry.kind !== 'group')
+                    continue;
+                const turn = groups.get(entry.key)?.data.turn ?? -1;
+                if (turn >= 1) {
+                    if (bucketTurn !== undefined && turn !== bucketTurn)
+                        closeBucket();
+                    bucketTurn = turn;
+                }
+                bucket.push(entry.key);
+            }
+            closeBucket();
+        }
+        // 官方 ChatNodeList 的 entries 路径：group 条目 → ChatGroupSeat（二级收折）。
+        for (const entry of entries) {
+            if (entry.kind === 'group') {
+                const group = groups.get(entry.key);
+                if (group === undefined)
+                    continue;
+                const latest = flatKeys.has(group.key);
+                rows.push(h(ChatGroupSeatMirror, {
+                    key: entry.key,
+                    group,
+                    grouped: turnStatus(turns, group.data.turn) !== 'open' && !latest,
+                    store,
+                    openState,
+                    onSetOpen,
+                    foldCompleted,
+                    renderNode,
+                    t,
+                }));
+            }
+            else {
+                const node = readSafe(entry.key);
+                if (node === undefined)
+                    continue;
+                rows.push(h(ChatNodeSeatMirror, {
+                    key: JSON.stringify([entry.key, entry.groupPart ?? null]),
+                    node,
+                    groupPart: entry.groupPart,
+                    store,
+                    openState,
+                    onSetOpen,
+                    foldCompleted,
+                    renderNode,
+                }));
+            }
+        }
+        return rows;
+    }
+    for (const key of order) {
+        const node = readSafe(key);
+        if (node === undefined)
+            continue;
+        rows.push(h(ChatNodeSeatMirror, { key, node, store, openState, onSetOpen, foldCompleted, renderNode }));
+    }
+    return rows;
+}
+/** turn 状态（官方 turns.get(turn)?.status）。 */
+function turnStatus(turns, turn) {
+    const row = turns?.get(turn) ?? turns?.get(String(turn));
+    return row?.status;
+}
+/** 加载 / 空态提示行（13px tertiary）。 */
+export function ChatHint(props) {
+    return h('div', { className: officialClass('ChatView', 'hint') ?? '' }, props.text);
+}
+/** 「加载更早记录」按钮（官方 older：按钮 4px 12px / 12px 字号 / radius-sm / 底色 interactive-bg-hover-solid）。 */
+export function ChatOlderButton(props) {
+    return h('div', { className: officialClass('ChatView', 'older') ?? '' }, h('button', { type: 'button', onClick: props.onClick }, props.label));
+}
+/** 「到底部」悬浮钮（官方 toBottom：34×34 圆形悬浮，仅在有更多历史时显示）。 */
+export function ChatToBottom(props) {
+    return h('div', { className: officialClass('ChatView', 'toBottomSlot') ?? '' }, h('button', { type: 'button', className: officialClass('ChatView', 'toBottom') ?? '', onClick: props.onClick, 'aria-label': props.label }, '↓'));
+}
+//# sourceMappingURL=ChatView.js.map

package/dist/session/mirror/ChatView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatView.js","sourceRoot":"","sources":["../../../src/session/mirror/ChatView.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,gGAAgG;AAChG,kFAAkF;AAClF,kDAAkD;AAClD,oFAAoF;AACpF,OAAO,EAAE,aAAa,IAAI,CAAC,EAAE,MAAM,OAAO,CAAA;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AAItD,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAAC,KAA+B;IAC3D,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,+BAA+B,EAAE,EACvG,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAC7D,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,GAAG,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,EAAE,EACpF,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,gBAAgB,EAAE,EAAE,EAAE,EAAE,KAAK,CAAC,QAAQ,CAAC,CACzG,CACF,CACF,CAAA;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,kBAAkB,CAAC,KAalC;IACC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,KAAK,CAAA;IAC1G,MAAM,IAAI,GAAuC,EAAE,CAAA;IACnD,MAAM,IAAI,GAAG,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAE,KAAoC,CAAC,GAAG,CAAA;IACxF,IAAI,OAAO,IAAI,KAAK,UAAU,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IAClE,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAwC,EAAE;QACrE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;QAC9B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAA;QAClB,CAAC;IACH,CAAC,CAAA;IACD,IAAI,OAAO,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAClD,iDAAiD;QACjD,oCAAoC;QACpC,uEAAuE;QACvE,gFAAgF;QAChF,wDAAwD;QACxD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAA;QAClC,CAAC;YACC,IAAI,MAAM,GAAa,EAAE,CAAA;YACzB,IAAI,UAA8B,CAAA;YAClC,MAAM,WAAW,GAAG,GAAS,EAAE;gBAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;gBACtC,IAAI,IAAI,KAAK,SAAS;oBAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC1C,MAAM,GAAG,EAAE,CAAA;YACb,CAAC,CAAA;YACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;gBAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;oBAAE,SAAQ;gBACpC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAA;gBACnD,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC;oBACd,IAAI,UAAU,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU;wBAAE,WAAW,EAAE,CAAA;oBAClE,UAAU,GAAG,IAAI,CAAA;gBACnB,CAAC;gBACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YACxB,CAAC;YACD,WAAW,EAAE,CAAA;QACf,CAAC;QACD,+DAA+D;QAC/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBACnC,IAAI,KAAK,KAAK,SAAS;oBAAE,SAAQ;gBACjC,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBACtC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,mBAAmB,EAAE;oBAC/B,GAAG,EAAE,KAAK,CAAC,GAAG;oBACd,KAAK;oBACL,OAAO,EAAE,UAAU,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,MAAM;oBACjE,KAAK;oBACL,SAAS;oBACT,SAAS;oBACT,aAAa;oBACb,UAAU;oBACV,CAAC;iBACF,CAAC,CAAC,CAAA;YACL,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBAChC,IAAI,IAAI,KAAK,SAAS;oBAAE,SAAQ;gBAChC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE;oBAC9B,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC;oBACzD,IAAI;oBACJ,SAAS,EAAE,KAAK,CAAC,SAAS;oBAC1B,KAAK;oBACL,SAAS;oBACT,SAAS;oBACT,aAAa;oBACb,UAAU;iBACX,CAAC,CAAC,CAAA;YACL,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAA;IACb,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,SAAQ;QAChC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,kBAAkB,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IACzG,CAAC;IACD,OAAO,IAAI,CAAA;AACb,CAAC;AAED,2CAA2C;AAC3C,SAAS,UAAU,CAAC,KAA4B,EAAE,IAAY;IAC5D,MAAM,GAAG,GAAG,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAA;IACxD,OAAO,GAAG,EAAE,MAAM,CAAA;AACpB,CAAC;AAED,iCAAiC;AACjC,MAAM,UAAU,QAAQ,CAAC,KAAuB;IAC9C,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;AACrF,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,KAA6C;IAC3E,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,EACrE,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,KAAK,CAAC,KAAK,CAAC,CACrE,CAAA;AACH,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,YAAY,CAAC,KAA6C;IACxE,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,cAAc,CAAC,IAAI,EAAE,EAAE,EAC5E,CAAC,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,CAAC,CAChJ,CAAA;AACH,CAAC"}

package/dist/session/mirror/CommandCard.d.ts

@@ -0,0 +1,20 @@
+import { type ReactNode } from 'react';
+import type { Translate } from '../../utils/i18n.js';
+/** 官方 CommandNode（conversation-nodes/command.ts / records.d.ts）：斜杠命令生命周期节点。 */
+export interface CommandNodeFace {
+    readonly name?: string | null;
+    readonly args?: string | null;
+    readonly outcome?: {
+        readonly kind?: string;
+        readonly text?: string;
+    } | null;
+}
+/** 命令卡（官方 GenericCommandCard 镜像）：裸命令名 + 落定摘要 + 多行输出可展开。 */
+export declare function CommandCard(props: {
+    /** 官方 CommandNode（name/args/outcome）。 */
+    node: CommandNodeFace;
+    t: Translate;
+    /** 未决态运行文案；缺省用 t('commandRunning')（官方 command.running）。 */
+    runningSummary?: string;
+}): ReactNode;
+//# sourceMappingURL=CommandCard.d.ts.map

package/dist/session/mirror/CommandCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CommandCard.d.ts","sourceRoot":"","sources":["../../../src/session/mirror/CommandCard.ts"],"names":[],"mappings":"AAUA,OAAO,EAAuD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAG3F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAEpD,+EAA+E;AAC/E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAA;CAC7E;AAaD,2DAA2D;AAC3D,wBAAgB,WAAW,CAAC,KAAK,EAAE;IACjC,yCAAyC;IACzC,IAAI,EAAE,eAAe,CAAA;IACrB,CAAC,EAAE,SAAS,CAAA;IACZ,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAA;CACxB,GAAG,SAAS,CAkDZ"}

package/dist/session/mirror/CommandCard.js

@@ -0,0 +1,69 @@
+// 官方 GenericCommandCard（ui-chat/src/client/chat/GenericCommandCard.tsx @ master，原样复刻）镜像：
+//   · 行标题 = 裸命令名 node.name，缺席兜底 t('commandTitle')（官方 command.title = 指令 / Command）。
+//   · 摘要 = outcome 落定 text：未决(outcome===null) = t('commandRunning')（执行中…）；
+//     已决无 text 按 kind 取 t('commandFailed')（指令失败）/ t('commandDone')（已完成）。**不用 args**。
+//   · state = running(未决) / error(outcome.kind==='error') / ok；running/error 各挂一个 visually-hidden 读屏状态词。
+//   · 展开体仅当 outcome.text 含换行（多行）才可展开；展开体 = 原文 pre-wrap。
+//   · 分隔符 = 2×2 小圆点；错误态 summary/body 用 error 色。
+// 样式一律取宿主注入的官方 GenericCommandCard.module.css 类（officialClass），**不写自绘兜底**：
+// 本包只跑在 DSH 宿主上、官方样式必在场；官方大版本更新我们跟着更，兜底既防不住「官方加东西」也无意义
+// （用户 2026-10-23 定）。取不到官方类时退化为空类（裸结构、不白屏）；读屏 visually-hidden 复用 ToolRow 同名工具类。
+import { Fragment, createElement as h, useCallback, useState } from 'react';
+import { DisclosureRow, IconApiOutlineRegular, TextShimmer } from '../../ui/official.js';
+import { officialClass } from '../official-classes.js';
+/** 官方 GenericCommandCard 模块类（宿主必注入；缺席 = 空串，裸结构不白屏，不写自绘兜底）。 */
+const gcc = (semantic) => officialClass('GenericCommandCard', semantic) ?? '';
+/** 官方 stateOf：未决 = running；outcome.kind==='error' = error；否则 ok。 */
+function stateOf(outcome) {
+    if (outcome === null || outcome === undefined)
+        return 'running';
+    return outcome.kind === 'error' ? 'error' : 'ok';
+}
+/** 命令卡（官方 GenericCommandCard 镜像）：裸命令名 + 落定摘要 + 多行输出可展开。 */
+export function CommandCard(props) {
+    const { node, t, runningSummary } = props;
+    const [expanded, setExpanded] = useState(false);
+    const outcome = node.outcome ?? null;
+    const text = outcome?.text;
+    const summary = outcome === null
+        ? runningSummary ?? t('commandRunning')
+        : text ?? (outcome.kind === 'error' ? t('commandFailed') : t('commandDone'));
+    const title = node.name ?? t('commandTitle');
+    const state = stateOf(outcome);
+    const running = state === 'running';
+    // 官方：仅多行 text 才给展开体（单行摘要已够，不出 chevron）。
+    const body = text !== undefined && text.includes('\n') ? text : null;
+    const open = expanded && body !== null;
+    const toggle = useCallback(() => { setExpanded((value) => !value); }, []);
+    // 读屏 visually-hidden：复用 ToolRow 同名工具类（既有，非新写兜底）。
+    const hidden = officialClass('ToolRow', 'visuallyHidden') ?? '';
+    return h('div', { className: gcc('root'), 'data-state': state }, 
+    // 官方 a11y：running/error 的读屏状态词（visually-hidden，不占可见空间）。
+    state === 'running'
+        ? h('span', { className: hidden }, t('rowRunning'))
+        : state === 'error'
+            ? h('span', { className: hidden }, t('rowFailed'))
+            : null, h(DisclosureRow, {
+        leadingClassName: gcc('leading'),
+        titleClassName: gcc('title'),
+        icon: h(IconApiOutlineRegular, { size: 14 }),
+        title,
+        running,
+        open,
+        expandable: body !== null,
+        expandOnRowClick: true,
+        keepContentWhenOpen: true,
+        onToggle: toggle,
+        collapsedContent: h(Fragment, null, h('span', { className: gcc('separator'), 'aria-hidden': true }), h('span', {
+            className: gcc('summary'),
+            'data-error': state === 'error' || undefined,
+        }, h(TextShimmer, { active: running }, summary))),
+        children: open && body !== null
+            ? h('div', {
+                className: gcc('body'),
+                'data-error': state === 'error' || undefined,
+            }, body)
+            : undefined,
+    }));
+}
+//# sourceMappingURL=CommandCard.js.map