@meiyukichan/dsh-sandore 0.1.0-rc.6

package/lib/client/TreeNav.d.ts

@@ -0,0 +1,27 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { RunTreeNode } from './run-view-model.ts';
+/** 叶子节点点击载荷（预览目标）。 */
+export interface TreeLeafSelection {
+    /** 叶子节点 id（供高亮匹配）。 */
+    readonly leafId: string;
+    readonly kind: 'result' | 'artifact';
+    readonly stepId: string;
+    readonly name: string;
+    readonly meta?: string | undefined;
+    readonly text?: string | undefined;
+}
+/** TreeNav 接收的 props。 */
+export interface TreeNavProps {
+    /** 类型化的翻译函数（sandore 命名空间）。 */
+    t: TranslateNS<'sandore'>;
+    /** 树形导航数据（buildRunTree 派生）。 */
+    tree: readonly RunTreeNode[];
+    /** 当前预览叶子 id（高亮）。 */
+    activePreviewId: string | null;
+    /** 点击叶子 → 打开右栏预览。 */
+    onSelectLeaf(selection: TreeLeafSelection): void;
+    /** 跳子代理会话（Step 行）。 */
+    onOpenChild(childId: string): void;
+}
+/** 渲染树形导航（照 DSH WorkflowRunPanel；左上角标题 + 树身顶部留白）。 */
+export declare function TreeNav({ t, tree, activePreviewId, onSelectLeaf, onOpenChild }: TreeNavProps): import("react").JSX.Element;

package/lib/client/UnifiedTimeline.d.ts

@@ -0,0 +1,11 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import { type TimelineItem } from './run-view-model.ts';
+/** 渲染执行详情对话流。 */
+export declare function UnifiedTimeline({ t, items, openSession }: {
+    /** 类型化翻译函数。 */
+    t: TranslateNS<'sandore'>;
+    /** 时间线条目（buildTimeline 派生）。 */
+    items: readonly TimelineItem[];
+    /** 跳子代理会话（agent 标题点击）。 */
+    openSession: (id: string) => void;
+}): import("react").JSX.Element;

package/lib/client/WorkflowButton.d.ts

@@ -0,0 +1,11 @@
+/** sidebar.footer.action 工作流入口：点击切换 shell.overlay 全局工作流 UI（设置上方）。 */
+import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+/** 注册进 slot 的业务 face：切换工作流 overlay 开关的回调。 */
+export interface WorkflowButtonFace {
+    /** 点击「工作流」：切换 shell.overlay 全局工作流 UI 开关（开→关、关→开）。 */
+    onToggleWorkflow(): void;
+}
+/** sidebar.footer.action 的组件 props（owner + 注入 face + locale）。 */
+export type WorkflowButtonProps = PropsRuntime<'sidebar.footer.action'> & InjectFace<WorkflowButtonFace> & PropsLocale<'sandore'>;
+/** 渲染工作流入口按钮，点击切换全局工作流 overlay 开关；overlay 打开时按钮高亮。 */
+export declare function WorkflowButton({ wide, t, onToggleWorkflow }: WorkflowButtonProps): import("react").JSX.Element;

package/lib/client/WorkflowList.d.ts

@@ -0,0 +1,18 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { WorkspaceView } from '@deepseek-ai/dsh-client-runtime/client';
+import type { WorkflowOverlayFace } from './workflow-face.ts';
+/** WorkflowList 接收的 props。 */
+export interface WorkflowListProps {
+    /** 类型化翻译函数（sandore 命名空间）。 */
+    t: TranslateNS<'sandore'>;
+    /** 工作区成员表（供 InstanceList 按工作区分组）。 */
+    workspaces: readonly WorkspaceView[];
+    /** 业务 face（列表类 RPC 已解包）。 */
+    face: WorkflowOverlayFace;
+    /** 刷新计数：变化时重挂载列表（保存/删除/手动刷新后）。 */
+    refreshKey: number;
+    /** 列表列宽（px，拖拽分隔条驱动）。 */
+    width: number;
+}
+/** 渲染工作流 overlay 左栏列表。 */
+export declare function WorkflowList({ t, workspaces, face, refreshKey, width }: WorkflowListProps): import("react").JSX.Element;

package/lib/client/WorkflowOverlay.d.ts

@@ -0,0 +1,6 @@
+import type { GlobalStandardProps, InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { WorkflowOverlayFace } from './workflow-face.ts';
+/** WorkflowOverlay 的组件 props：注入 face + locale + 全局标准 prop（useWorkspaces）。 */
+export type WorkflowOverlayProps = InjectFace<WorkflowOverlayFace> & PropsLocale<'sandore'> & GlobalStandardProps;
+/** 渲染 shell.overlay 全局工作流 UI（关闭时渲染 null）。 */
+export declare function WorkflowOverlay({ useWorkspaces, listInstances, listDefinitions, startInstance, listModelDirectory, pickDirectory, deleteDefinition, deleteInstance, getYaml, save, remote, openSession, modelDirectory, permissions, runCommand, queryPermission, t, }: WorkflowOverlayProps): import("react").JSX.Element | null;

package/lib/client/chat/AssistantMarkdown.d.ts

@@ -0,0 +1,22 @@
+import type { AssistantBlock } from '@deepseek-ai/dsh-client-runtime/client';
+import type { MarkdownFileMentions } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SandoreRenderMessageImages } from './attachment/MessageImage.tsx';
+export interface AssistantMarkdownProps {
+    blocks: readonly AssistantBlock[];
+    streaming: boolean;
+    /** Frozen partial of an aborted turn: rendered with a stopped marker. */
+    interrupted?: boolean | undefined;
+    /** Render consecutive image blocks through the attachment renderer. */
+    renderMessageImages: SandoreRenderMessageImages;
+    /** Resolved prose file mentions for this Assistant's closing turn. */
+    mentions?: MarkdownFileMentions | undefined;
+    /** The owning view's locale seat, passed down as a plain prop. */
+    t: TranslateNS<'sandore'>;
+}
+/**
+ * Reasoning block as the Think variant summary row (figma 39:28304).
+ * @param props - assistant blocks + streaming + 附件渲染器 + locale。
+ * @returns 渲染后的助手消息体（tool-call 块由外层分组渲染，此处跳过）。
+ */
+export declare const AssistantMarkdown: import("react").MemoExoticComponent<({ blocks, streaming, interrupted, renderMessageImages, mentions, t, }: AssistantMarkdownProps) => import("react").JSX.Element | null>;

package/lib/client/chat/CompactionItem.d.ts

@@ -0,0 +1,24 @@
+/**
+ * CompactionItem：抄自 DSH `packages/client/ui-conversation/src/client/chat/CompactionItem.tsx`。
+ * 一次落地压缩为流程贡献的一行标记（模型面上被遮蔽的历史留在其上，标记只报告模型
+ * 停止看到该历史的边界）。locale 面收窄为 sandore 命名空间，其余逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/CompactionItem
+ */
+import type { CompactionSummaryNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+interface CompactionItemProps {
+    node: CompactionSummaryNode;
+    /** Optional command title for a manual compaction folded into this marker. */
+    title?: string;
+    /** Command settlement text used when structured compaction counts are unavailable. */
+    fallbackSummary?: string | null;
+    /** The owning view's locale seat. */
+    t: TranslateNS<'sandore'>;
+}
+/**
+ * The collapsed-by-default compaction marker.
+ * @param props - the marker node off the snapshot cache.
+ * @returns the marker row, with the summary disclosure when one is available.
+ */
+export declare const CompactionItem: import("react").MemoExoticComponent<({ node, title, fallbackSummary, t, }: CompactionItemProps) => import("react").JSX.Element>;
+export {};

package/lib/client/chat/ContextBody.d.ts

@@ -0,0 +1,136 @@
+/**
+ * ContextBody：抄自 DSH `packages/client/ui-conversation/src/client/chat/ContextBody.tsx`。
+ * 上下文披露的展开体，每种 durable context form 一个呈现（producer 声明 form，本模块
+ * 只为它选呈现；form 缺失/未知/损坏一律回退 OpaqueBody）。locale 面收窄为 sandore
+ * 命名空间，其余逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/ContextBody
+ */
+import type { ReactNode } from 'react';
+import type { ContextMessageNode, KnownContextForm } from '@deepseek-ai/dsh-client-runtime/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+type Translate = TranslateNS<'sandore'>;
+/**
+ * Default presentation: the model-facing text as text, with its real line
+ * breaks, and the remaining source fields beneath it. This is what every form
+ * this UI version does not recognize renders as.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The opaque context body.
+ */
+export declare function OpaqueBody({ content, source, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * `instructions` form: the files this context reconciled, then their text.
+ *
+ * The text keeps its `<system-reminder>` framing verbatim — the framing is part
+ * of what the model read, so hiding it would misreport the request.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The instructions context body, or the opaque body when the change
+ * list is unreadable.
+ */
+export declare function InstructionsBody({ content, source, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * `catalog` form: the published entries as a list, read from the source rather
+ * than re-parsed out of the model-facing prose.
+ *
+ * A catalog whose source carries no usable entries falls through to the opaque
+ * body, so an older or hand-edited log still shows its text.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The catalog context body, or the opaque body when the entry list is
+ * unreadable.
+ */
+export declare function CatalogBody({ content, source, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * `snapshot` form: the named contributions this snapshot assembled, in order.
+ *
+ * The sections are the same bytes the model read, split at the boundaries the
+ * producer assembled them on, so a reader sees which subsystem contributed
+ * which state instead of one undifferentiated wall.
+ *
+ * One sentence of the model-facing text is NOT in any section: the producer's
+ * framing line declaring that this snapshot supersedes earlier ones. Unlike the
+ * `<system-reminder>` wrapper an instruction context carries — which wraps
+ * content and cannot be separated from it — that line states the form's own
+ * semantics, so the body states them as a caption instead of reprinting the
+ * joined prose beside the sections it was split from.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The snapshot context body, or the opaque body when unreadable.
+ */
+export declare function SnapshotBody({ content, source, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * `notice` form: what just happened, with the model-facing text beneath it.
+ *
+ * The one-line account also rides the collapsed row ({@link contextBody}), so a
+ * notice is usually readable without expanding at all.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The notice context body.
+ */
+export declare function NoticeBody({ content, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * `relay` form: which agent sent this, then what it said.
+ *
+ * The sender is an opaque session id; it is shown as a field rather than a
+ * label, because this client cannot resolve it to a title.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The relay context body.
+ */
+export declare function RelayBody({ content, source, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * `recall` form: which sessions this material came from and how much of each
+ * survived the read, then the material itself.
+ *
+ * Completeness is the fact a reader needs first: recalled context is bounded on
+ * the way in, so a card that hid the omitted count would overstate what the
+ * model received.
+ * @param props - Durable content, its source, and the locale seat.
+ * @returns The recall context body, or the opaque body when unreadable.
+ */
+export declare function RecallBody({ content, source, t }: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): ReactNode;
+/**
+ * Choose the body for one context node.
+ *
+ * Returns the form the body actually rendered as, which is not always the
+ * declared one: a declared form whose fields are unreadable falls back to
+ * opaque, and the caller labels the row with what it really shows.
+ * `summary` is the collapsed row's one-line account, which only a `notice`
+ * records: its whole point is being readable without expanding.
+ * @param form - the producer-declared form projected onto the node.
+ * @param props - durable content, its source, and the locale seat.
+ * @returns the rendered form (null for opaque), its collapsed summary, and its body.
+ */
+export declare function contextBody(form: ContextMessageNode['form'], props: {
+    content: ContextMessageNode['content'];
+    source: unknown;
+    t: Translate;
+}): {
+    rendered: KnownContextForm | null;
+    summary: string | null;
+    body: ReactNode;
+};
+export {};

package/lib/client/chat/ContextInjectionRow.d.ts

@@ -0,0 +1,25 @@
+import type { ContextMessageNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** Props for the logged non-user message presentation. */
+export interface ContextInjectionRowProps {
+    content: ContextMessageNode['content'];
+    source: ContextMessageNode['source'];
+    /** Role and producer name projected from the durable source. */
+    provenance: ContextMessageNode['provenance'];
+    /** Producer-declared information form; null renders the opaque body. */
+    form: ContextMessageNode['form'];
+    /** The owning view's locale seat, passed down as a plain prop. */
+    t: TranslateNS<'sandore'>;
+}
+/**
+ * Render logged context with the Tool calls disclosure chrome from Figma.
+ *
+ * The header names the role the context plays and, beside it, the producer the
+ * durable source identifies, so a reader can tell an injected skill catalog
+ * from a workspace instruction file or a recalled session without expanding.
+ * The expanded body follows the producer-declared form; an absent or unknown
+ * form renders the opaque body.
+ * @param props - Durable content, its projected producer role/name and form, and the locale seat.
+ * @returns A collapsed context row with a bounded, form-specific body.
+ */
+export declare function ContextInjectionRow({ content, source, provenance, form, t }: ContextInjectionRowProps): import("react").JSX.Element;

package/lib/client/chat/GenericCommandCard.d.ts

@@ -0,0 +1,10 @@
+import type { CommandNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** Card props: the command node plus the render site's locale seat. */
+export interface GenericCommandCardProps {
+    node: CommandNode;
+    t: TranslateNS<'sandore'>;
+    /** Command-specific running copy; absent uses the generic command label. */
+    runningSummary?: string | undefined;
+}
+export declare function GenericCommandCard({ node, t, runningSummary }: GenericCommandCardProps): import("react").JSX.Element;

package/lib/client/chat/MessageIconActions.d.ts

@@ -0,0 +1,41 @@
+/**
+ * MessageIconActions：抄自 DSH `packages/client/ui-conversation/src/client/chat/MessageIconActions.tsx`。
+ * 用户/agent 消息共用的 IconActions 行：复制 + 可选 branch（会话 fork）+ 可选日期感知
+ * 时钟（含运行时长/TTFT/吞吐读数）+ 可选 extraActions（插件注入动作）。
+ * locale 面收窄为 sandore 命名空间（key 集抄进 sandore 字典），逻辑逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/MessageIconActions
+ */
+import { type ReactNode } from 'react';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+export interface MessageIconActionsProps {
+    text: string;
+    /** Unix epoch ms for the clock label; omitted for transient messages. */
+    time?: number | undefined;
+    /** Turn wall time in ms, appended to the clock as `· Ran for 15s`; omitted when the turn's start is unknown. */
+    runMs?: number | undefined;
+    /** Turn first-step TTFT in ms, appended as `· TTFT 1.2s`; omitted when unrecorded. */
+    ttftMs?: number | undefined;
+    /** Turn decode throughput, appended as `· 34 tok/s`; omitted when unrecorded. */
+    tokensPerSecond?: number | undefined;
+    /** Clock before icons (user) or after (assistant). */
+    clock: 'start' | 'end';
+    /** Fork the session at this message; omission hides the branch action. */
+    onBranch?: (() => void) | undefined;
+    /** The message is not a completed transcript tail, so branch stays visible but unavailable. */
+    branchUnavailable?: boolean | undefined;
+    /** Parent layout class composed onto the actions row. */
+    className?: string | undefined;
+    /**
+     * Slot-rendered actions owned by independent plugins, placed between the
+     * built-in copy and branch controls.
+     */
+    extraActions?: ReactNode;
+    /** The owning view's locale seat, passed down as a plain prop. */
+    t: TranslateNS<'sandore'>;
+}
+/**
+ * Copy / branch (/ clock) IconActions row shared by user and assistant chrome.
+ * @param props - Copy text, event time, clock side, branch callback, className.
+ * @returns The actions row element.
+ */
+export declare function MessageIconActions({ text, time, runMs, ttftMs, tokensPerSecond, clock, onBranch, branchUnavailable, className, extraActions, t, }: MessageIconActionsProps): import("react").JSX.Element;

package/lib/client/chat/MessageItem.d.ts

@@ -0,0 +1,65 @@
+/**
+ * MessageItem：抄自 DSH `packages/client/ui-conversation/src/client/chat/MessageItem.tsx`。
+ * 简单聊天节点——用户/consumed-steering 右对齐气泡（时钟 + 复制 + 可选 branch 的
+ * IconActions；branch 只在 assistant 回答下）、pending steering（仅复制）、上下文注入、
+ * 压缩标记、model-retry 披露、turn-error、turn-max-tokens、未知 surface JSON 行。
+ *
+ * 适配：props 从内部 `ChatNode`/`ChatViewSlotProps` 收窄为公开节点数据 + sandore 命名
+ * 空间 locale；`renderMessageImages` 为 sandore 面板自己的 ImageGallery 渲染器（替代
+ * DSH 的 conversation.message.images slot）；`referenceLabels` 由 DSH 的
+ * ReferenceLabelProjector（UI 计算）提供，runtime 公开节点不带该字段，面板按
+ * `UserMessageNodeView` 的缺省路径传空。其余逻辑逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/MessageItem
+ */
+import type { ReactNode } from 'react';
+import type { CompactionSummaryNode, ContextMessageNode, ConversationNode, ModelRetryNode, TurnErrorNode, UnknownSurfaceNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SandoreRenderMessageImages } from './attachment/MessageImage.tsx';
+/**
+ * Render one Host-authoritative pending steering item with the same visual
+ * language as its eventual durable transcript node.
+ * @param props - Pending message content and translator.
+ * @returns the pending steering bubble.
+ */
+export declare function PendingSteeringBubble({ content, renderMessageImages, t }: {
+    content: readonly unknown[];
+    renderMessageImages: SandoreRenderMessageImages;
+    t: TranslateNS<'sandore'>;
+}): ReactNode;
+/** User and admitted-steering 节点 → 右对齐气泡（公开 `UserMessageNode`/`SteeringMessageNode` 数据）。 */
+export declare const UserMessageNodeView: import("react").MemoExoticComponent<({ node, renderMessageImages, t }: {
+    node: Extract<ConversationNode, {
+        kind: "user" | "steering";
+    }>;
+    renderMessageImages: SandoreRenderMessageImages;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+/** Injected-context 节点 → 上下文注入行（公开 `ContextMessageNode` 数据）。 */
+export declare const ContextMessageNodeView: import("react").MemoExoticComponent<({ node, t }: {
+    node: ContextMessageNode;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+/** Automatic compaction 节点 → 压缩标记行（公开 `CompactionSummaryNode` 数据）。 */
+export declare const CompactionNodeView: import("react").MemoExoticComponent<({ node, t }: {
+    node: CompactionSummaryNode;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+/** model-retry 节点 → 重试披露（公开 `ModelRetryNode` 数据）。 */
+export declare const RetryNodeView: import("react").MemoExoticComponent<({ node, t }: {
+    node: ModelRetryNode;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+/** Terminal turn-error 节点 → 持久失败提示（公开 `TurnErrorNode` 数据）。 */
+export declare const TurnErrorNodeView: import("react").MemoExoticComponent<({ node, t }: {
+    node: TurnErrorNode;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+/** Max-tokens turn-end notice 节点 → 输出上限提示。 */
+export declare const TurnMaxTokensNodeView: import("react").MemoExoticComponent<({ t }: {
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+/** Explicit unknown-surface 节点 → JSON 行（公开 `UnknownSurfaceNode` 数据）。 */
+export declare const UnknownNodeView: import("react").MemoExoticComponent<({ node, t }: {
+    node: UnknownSurfaceNode;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;

package/lib/client/chat/ReasoningRow.d.ts

@@ -0,0 +1,13 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/**
+ * Render one assistant reasoning block as the Think disclosure row.
+ * @param props.text - complete or streaming reasoning text.
+ * @param props.running - whether this block is the streaming tail.
+ * @param props.t - sandore locale seat for the running status.
+ * @returns the reasoning disclosure.
+ */
+export declare function ReasoningRow({ text, running, t }: {
+    text: string;
+    running: boolean;
+    t: TranslateNS<'sandore'>;
+}): import("react").JSX.Element;

package/lib/client/chat/TurnTailNodeView.d.ts

@@ -0,0 +1,29 @@
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+/** turn-tail 展示数据（chat-flow 派生；字段对齐 DSH TurnTailChatData 的展示面）。 */
+export interface StepChatTailData {
+    /** 已完结 turn 号。 */
+    turn: number;
+    /** 结算 assistant 节点 seq（分支锚点）。 */
+    seq: number;
+    /** 结算时间（Unix epoch ms；时钟用）。 */
+    time: number;
+    /** 结算 assistant 的拼接文本（复制按钮取文本）。 */
+    text: string;
+    /** Turn 壁钟时长 ms；turn/start|end 均在窗口内时可用。 */
+    runMs?: number | undefined;
+    /** Turn 首步 TTFT ms；未记录时省略。 */
+    ttftMs?: number | undefined;
+    /** Turn 解码吞吐；未记录时省略。 */
+    tokensPerSecond?: number | undefined;
+    /** 分支不可用（结算 assistant 非 turn 尾部等；chat-flow 派生）。 */
+    branchUnavailable: boolean;
+}
+/** Turn-local actions and feature tail over the closing Assistant, independent of Assistant placement. */
+export declare const TurnTailNodeView: import("react").MemoExoticComponent<({ data, onBranch, t, }: {
+    /** 由 chat-flow 派生的 turn-tail 展示数据。 */
+    data: StepChatTailData;
+    /** 分支回调：以结算 seq 为锚 fork 会话（`sessions.fork`，与 DSH forkAt 同语义）。 */
+    onBranch: (seq: number) => void;
+    /** sandore locale seat。 */
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;

package/lib/client/chat/UserMessageRow.d.ts

@@ -0,0 +1,18 @@
+import type { ConversationNode } from '@deepseek-ai/dsh-client-runtime/client';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { SandoreRenderMessageImages } from './attachment/MessageImage.tsx';
+type UserNode = Extract<ConversationNode, {
+    kind: 'user' | 'steering';
+}>;
+/**
+ * 用户消息行：DisclosureRow 行式（左对齐）——用户图标 + "User Message" 标签 + 分隔点 +
+ * 单行省略的用户消息文本 + 尾部时钟；点击整行展开完整用户消息文本框。
+ * @param props - 用户/steering 节点、图片画廊渲染器与 locale。
+ * @returns 折叠为单行的用户消息披露行。
+ */
+export declare const UserMessageRow: import("react").MemoExoticComponent<({ node, renderMessageImages, t }: {
+    node: UserNode;
+    renderMessageImages: SandoreRenderMessageImages;
+    t: TranslateNS<"sandore">;
+}) => import("react").JSX.Element>;
+export {};

package/lib/client/chat/attachment/ImageLightbox.d.ts

@@ -0,0 +1,26 @@
+/** Lightbox strings the owner resolves from its own locale namespace. */
+export interface ImageLightboxLabels {
+    /** Accessible name of the preview dialog. */
+    dialog: string;
+    /** Accessible label of the close control. */
+    close: string;
+}
+/**
+ * Document-level original-image preview opened by clicking a thumbnail.
+ * Closes on Escape, backdrop press, or the close control, and restores focus
+ * to the opener on unmount. Rendered through a body portal: an opener inside
+ * a transformed or filtered ancestor would otherwise trap the fixed backdrop
+ * in that ancestor's box instead of covering the viewport.
+ *
+ * @param props.src - the original image URL.
+ * @param props.alt - the image's alt text.
+ * @param props.labels - dialog and close-control strings.
+ * @param props.onClose - dismiss callback owned by the opener.
+ * @returns the modal preview dialog.
+ */
+export declare function ImageLightbox({ src, alt, labels, onClose }: {
+    src: string;
+    alt: string;
+    labels: ImageLightboxLabels;
+    onClose: () => void;
+}): import("react").ReactPortal;

package/lib/client/chat/attachment/MessageImage.d.ts

@@ -0,0 +1,56 @@
+import type { ReactNode } from 'react';
+import type { ImageLightboxLabels } from './ImageLightbox.tsx';
+import type { SandoreImageAttachmentRef } from './image-attachment.ts';
+/** Loads a session-authorized durable image URL. */
+export type ImageLoader = (attachment: SandoreImageAttachmentRef) => Promise<string>;
+/** 历史图片组渲染器（对齐 DSH slots.ts 的 `RenderMessageImages`，attachment 面本地复刻）。 */
+export type SandoreRenderMessageImages = (owner: {
+    /** Consecutive image blocks rendered as one gallery. */
+    images: readonly {
+        readonly attachment: SandoreImageAttachmentRef;
+    }[];
+    /** Message-side alignment. */
+    align: 'start' | 'end';
+}) => ReactNode;
+/** Message-image strings the owner resolves from its own locale namespace. */
+export interface MessageImageLabels {
+    /** Fallback display name for an unnamed image. */
+    image: string;
+    /** Thumbnail tooltip inviting the original-image preview. */
+    open: string;
+    /** Accessible thumbnail label; receives the image's display name. */
+    openNamed: (label: string) => string;
+    /** Loading placeholder shown until bytes resolve. */
+    loading: string;
+    /** Retry-control label shown when the load fails. */
+    loadFailed: string;
+    /** Lightbox strings forwarded to the opened preview. */
+    lightbox: ImageLightboxLabels;
+}
+/**
+ * Compact history renderer with retryable loading and click-to-open original
+ * preview. A lone image renders at its `singleFit` size; an image among
+ * several renders as a fixed 64px square tile.
+ *
+ * @param props.attachment - the durable image reference to load and bound.
+ * @param props.load - session-authorized URL loader.
+ * @param props.variant - `single` for a message's lone image, `tile` otherwise.
+ * @param props.labels - resolved strings (tooltip, loading, retry, lightbox).
+ * @returns the bounded thumbnail button, or the retry control on failure.
+ */
+export declare function MessageImage({ attachment, load, variant, labels }: {
+    attachment: SandoreImageAttachmentRef;
+    load: ImageLoader;
+    variant: 'single' | 'tile';
+    labels: MessageImageLabels;
+}): import("react").JSX.Element;
+/** Wrapping image group shared by user and assistant history: a lone image
+ * renders large, several render as 64px square tiles (DeepSeek Chat rule). */
+export declare function ImageGallery({ images, load, align, labels }: {
+    images: readonly {
+        attachment: SandoreImageAttachmentRef;
+    }[];
+    load: ImageLoader;
+    align: 'start' | 'end';
+    labels: MessageImageLabels;
+}): import("react").JSX.Element | null;

package/lib/client/chat/attachment/image-attachment.d.ts

@@ -0,0 +1,41 @@
+/**
+ * image-attachment：沙盒面板的本地图片附件面。
+ *
+ * DSH 的 `ImageAttachmentRef` 定义在 `@deepseek-ai/dsh-attachment`（runtime 的
+ * `ISession.readAttachment` 返回它），sandore 面板不声明该依赖，故按
+ * `packages/attachment/attachment/src/types.ts` 的字段结构本地复刻（仅类型，无行为）。
+ * `resolveImage` 抄自 DSH `ui-conversation/src/client/service.ts` 的
+ * `ConversationController.resolveImage`：经 `session.readAttachment` 取回字节，构建
+ * blob URL（不可用时退化为 data URL），按 session+attachmentId 缓存。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/attachment/image-attachment
+ */
+import type { SessionFace } from '@deepseek-ai/dsh-client-runtime/client';
+/** Raster image formats accepted by the version-one attachment path. */
+export type SandoreImageMediaType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+/** Durable, serializable metadata for one immutable image object（dsh-attachment 的 ImageAttachmentRef 结构复刻）。 */
+export interface SandoreImageAttachmentRef {
+    /** Opaque storage identifier; never a filesystem path or bearer URL. */
+    attachmentId: string;
+    /** Media type verified from the stored bytes. */
+    mediaType: SandoreImageMediaType;
+    /** Exact encoded byte length. */
+    bytes: number;
+    /** Intrinsic encoded width in pixels. */
+    width: number;
+    /** Intrinsic encoded height in pixels. */
+    height: number;
+    /** Optional display name stripped of local path information. */
+    name?: string;
+}
+/**
+ * 构建一个会话授权的历史图片 URL 加载器（`(attachment) => Promise<string>`）。
+ * 行为与 DSH `ConversationController.resolveImage` 一致：按 session+attachmentId 缓存，
+ * 取回字节后优先 blob URL（`URL.createObjectURL` 不可用时退化为 base64 data URL）。
+ * 调用方应在卸载时 `dispose()` 释放创建的 blob URL。
+ * @param session - 所属会话面（readAttachment 授权源）。
+ * @returns `{ load, dispose }`：load 为加载器；dispose 释放缓存与已创建 URL。
+ */
+export declare function createImageLoader(session: SessionFace): {
+    load(attachment: SandoreImageAttachmentRef): Promise<string>;
+    dispose(): void;
+};

package/lib/client/chat/attachment/image-labels.d.ts

@@ -0,0 +1,21 @@
+/**
+ * image-labels：抄自 DSH `packages/client/ui-attachment/src/client/labels.ts`（消息图片
+ * 部分；drop/rail 标签不属于聊天面板）。把 sandore 命名空间的 image.* 键解析为
+ * MessageImage/ImageLightbox 的标签面。逐字保留逻辑。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/chat/attachment/image-labels
+ */
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ImageLightboxLabels } from './ImageLightbox.tsx';
+import type { MessageImageLabels } from './MessageImage.tsx';
+/**
+ * Resolve original-image lightbox strings from the sandore namespace.
+ * @param t - sandore namespace translator.
+ * @returns translated lightbox labels.
+ */
+export declare function lightboxLabels(t: TranslateNS<'sandore'>): ImageLightboxLabels;
+/**
+ * Resolve historical message-image strings from the sandore namespace.
+ * @param t - sandore namespace translator.
+ * @returns translated message-image labels.
+ */
+export declare function messageImageLabels(t: TranslateNS<'sandore'>): MessageImageLabels;