@meiyukichan/dsh-sandore 0.1.0-rc.6

package/lib/client/tool/GenericToolCard.d.ts

@@ -0,0 +1,28 @@
+/**
+ * GenericToolCard：抄自 DSH `packages/client/ui-tool/src/client/tool/toolviews/GenericToolCard.tsx`。
+ * 默认工具行——把工具分类为视觉 variant 并渲染摘要行（DSH tool.call.toolview slot 的
+ * render-site fallback；未注册工具名落在此处）。内嵌面板不注册任何工具视图，故所有
+ * 工具都走通用卡片（与 DSH 对未注册工具的行为一致）。
+ * 适配：`openFile`/`inspect` 为可选 props（面板无 trajectory 视图时传 undefined，等价于
+ * DSH 未注入时无该 affordance）；`cwd`/`home` 可选（home 由 host description 提供，
+ * 面板不读取时省略，等价于 DSH 无 host description）。locale 面收窄为 sandore 命名空间。
+ * 卡片材质派生（terminal/read/diff/search/web）+ state/summary 覆盖逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/GenericToolCard
+ */
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client';
+/** Card props: the tool lifecycle block plus the render site's locale seat. */
+export interface GenericToolCardProps {
+    toolName: string;
+    block: ToolCallBlock;
+    /** Session workspace root; workspace-rooted path summaries display relative to it. */
+    cwd?: string | undefined;
+    /** Host account home; a leftover POSIX home path displays as `~`. */
+    home?: string | undefined;
+    /** Open a filesystem path through the Host (already cwd-resolved). */
+    openFile?: ((path: string) => void) | undefined;
+    /** Jump to this call in the trajectory view. */
+    inspect?: (() => void) | undefined;
+    t: TranslateNS<'sandore'>;
+}
+export declare function GenericToolCard({ toolName, block, cwd, home, openFile, inspect, t }: GenericToolCardProps): import("react").JSX.Element;

package/lib/client/tool/ToolRow.d.ts

@@ -0,0 +1,95 @@
+/**
+ * ToolRow：抄自 DSH `packages/client/ui-tool/src/client/tool/components/ToolRow.tsx`。
+ * 工具摘要行（figma 122:9479）——16px leading 槽（状态点/工具图标，hover/展开变 chevron）+
+ * 标题 + 分隔点 + FILL 截断摘要，经共享 DisclosureRow chrome，整行作为展开开关。
+ * 展开体：IN/OUT 槽标签卡（figma 1249:35657）、run_code 程序经 CodeBlock、或卡片材质
+ * （terminal/diff/read/search/web）之一；错误行折叠摘要为失败首行（红字）；文件工具的
+ * 路径以悬停下划线链接打开（onOpenFile）；展开体右下角 hover 揭示 Inspect 跳转。
+ * 适配：clsx 替换为本地 `cx`（sandore 无 clsx 依赖）；locale 面收窄为 sandore 命名空间。
+ * 其余逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/ToolRow
+ */
+import { type ReactNode } from 'react';
+import type { WebBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import { type DiffCardModel } from './diff-card-model.ts';
+import { type ReadCardModel } from './read-card-model.ts';
+import { type SearchCardModel } from './search-card-model.ts';
+import { type TerminalCardModel } from './terminal-card-model.ts';
+import type { ToolRowState, ToolRowVariant } from './tool-call-model.ts';
+export interface ToolRowProps {
+    /** The render site's locale seat (terminal/code body copy). */
+    t: TranslateNS<'sandore'>;
+    variant: ToolRowVariant;
+    /** Wire tool name for tool-owned styling layered over the generic variant. */
+    toolName?: string | undefined;
+    /** Leading-slot glyph. */
+    icon: ReactNode;
+    title: string;
+    summary: string;
+    /**
+     * Trailing summary fragment rendered outside the ellipsized summary text, so
+     * a narrow row clips the summary before this. For a fragment whose whole
+     * value is surviving that clip — the todo row's parallel-active count.
+     * null/absent = the summary is the whole collapsed content. Dropped on an
+     * error row, whose collapsed summary is the failure line instead.
+     */
+    summarySuffix?: string | null | undefined;
+    /** Expanded-body input text; null = no input section. */
+    body: string | null;
+    /** Flattened result text for the expanded Output section; null/absent = no output section. */
+    output?: string | null | undefined;
+    /** Error first line shown as the collapsed summary on an error row; null/absent = keep `summary`. */
+    errorSummary?: string | null | undefined;
+    /**
+     * Terminal-card material for a call whose render intent is a terminal card
+     * (derived by `terminalCardModel`); it replaces the text sections when
+     * present. A call carries at most one card kind, so the card props below are
+     * mutually exclusive.
+     */
+    terminal?: TerminalCardModel | null | undefined;
+    /**
+     * Diff-card material for a call whose render intent is a diff card (derived by
+     * `diffCardModel`); it replaces the text body when present, the same way
+     * `terminal` does.
+     */
+    diff?: DiffCardModel | null | undefined;
+    /**
+     * Read-card material for a call whose render intent is a read card (derived by
+     * `readCardModel`); it replaces the text body with the file's line-numbered,
+     * syntax-highlighted window when present.
+     */
+    read?: ReadCardModel | null | undefined;
+    /**
+     * Search-card material for a call whose render intent is a search card
+     * (derived by `searchCardModel`); it replaces the text body with grouped
+     * matches or a path list when present.
+     */
+    search?: SearchCardModel | null | undefined;
+    /**
+     * Web-card material for a call whose render intent is a web card (derived by
+     * `webCardModel`); it replaces the text body with the retrieval's citation
+     * list or fetched-source card when present.
+     */
+    web?: WebBlockProps | null | undefined;
+    state: ToolRowState;
+    /**
+     * Filesystem path from tool args; when set with onOpenFile, the summary
+     * renders as a hover-underline link that opens the host default app.
+     */
+    filePath?: string | undefined;
+    /** Open the path with the host OS default application (already cwd-resolved). */
+    onOpenFile?: ((path: string) => void) | undefined;
+    /**
+     * Jump to this call in the trajectory view: a hover-revealed Inspect pill
+     * over the expanded body. Absent = no affordance.
+     */
+    inspect?: (() => void) | undefined;
+}
+/**
+ * Render the tool row: the shared DisclosureRow chrome, one-line summary, and
+ * the expandable body with IN/OUT card, code block, or card material.
+ * @param props - ToolRow props (see {@link ToolRowProps}).
+ * @returns The tool row element.
+ */
+export declare function ToolRow({ t, variant, toolName, icon, title, summary, summarySuffix, body, output, errorSummary, terminal, diff, read, search, web, state, filePath, onOpenFile, inspect, }: ToolRowProps): import("react").JSX.Element;

package/lib/client/tool/diff-card-model.d.ts

@@ -0,0 +1,63 @@
+/**
+ * diff-card-model：抄自 DSH `packages/client/ui-tool/src/client/tool/models/diff-card-model.ts`。
+ * 从冻结 call slice 纯派生 diff 卡 props（`card:'diff'` 渲染意图，write/edit 声明）——
+ * 聊天工具行展开体与详情面板共用同一派生。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/diff-card-model
+ */
+/**
+ * Pure derivation of the diff-card props from a frozen call slice: the
+ * `card:'diff'` render intent the write/edit tools declare arrives on the
+ * snapshot as `callView`/`resultView`, and this is the one place that turns
+ * that pair into what {@link DiffBlock} draws. Both conversation render sites
+ * (the chat tool row's expanded body and the details panel's Output section)
+ * call this, so the hunks they show are derived once.
+ * @module
+ */
+import type { DiffBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { ToolCallBlock } from './tool-call-model.ts';
+/**
+ * Diff-body lines the chat row shows before collapsing the middle — half the
+ * primitive's own default, which the details panel keeps. A chat row is a
+ * summary surface inside the message flow: the flow must stay scannable across
+ * many calls, while the details panel is the single-call reading surface. The
+ * same split {@link CHAT_TERMINAL_MAX_LINES} draws for a terminal card, so the
+ * two card kinds cap a long body at the same place in the flow. A design
+ * constant of this UI's row geometry, not a deployment choice.
+ */
+export declare const CHAT_DIFF_MAX_LINES = 8;
+/**
+ * The {@link DiffBlock} props this derivation owns. Picked off the primitive's
+ * props so the two stay in step; `maxLines`/`className` belong to each render
+ * site.
+ */
+export interface DiffCardModel {
+    /**
+     * The props {@link DiffBlock} draws. Held as a nested object so a render site
+     * spreads exactly the primitive's own surface and can never leak a
+     * neighbouring field into it.
+     */
+    card: Pick<DiffBlockProps, 'diffs'>;
+}
+/**
+ * Derive the diff-card props for a tool call, or null when this call is not a
+ * diff card and belongs on the generic path.
+ *
+ * The result side is authoritative once the call settles: the write/edit tools
+ * return the applied contextual hunks there (an edit's real before/after, a
+ * create's whole-file diff), which replace the call-time diff derived from the
+ * arguments alone. While the call is still running only the call side exists,
+ * so a running write/edit shows its intended change. Null is the documented
+ * generic-card default and covers every non-diff card — including a `card`
+ * value this UI version does not know, which arrives over the wire and cannot
+ * be trusted to be one of the compiled variants — and a settled call whose
+ * result view is generic (how write/edit keep their execution errors on the
+ * generic path).
+ *
+ * This derivation consumes only `diffs`; the render intent's `title` field is
+ * deliberately dropped. The row supplies its own title (`Edit`/`Write · path`
+ * from the args), which outranks the view's `title`. A tool that names its own
+ * diff header therefore does not surface that text on the Web row.
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @returns the diff-card props, or null for the generic path.
+ */
+export declare function diffCardModel(block: ToolCallBlock): DiffCardModel | null;

package/lib/client/tool/read-card-model.d.ts

@@ -0,0 +1,67 @@
+/**
+ * read-card-model：抄自 DSH `packages/client/ui-tool/src/client/tool/models/read-card-model.ts`。
+ * 从冻结 call slice 纯派生 read 卡 props（`card:'read'` 渲染意图，result 侧）——
+ * 聊天工具行的常驻展开体与详情面板共用同一派生。适配：`abbreviateHomePath` 经
+ * tool-call-model 本地复刻导入（rc.6 runtime 未导出）；其余逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/read-card-model
+ */
+/**
+ * Pure derivation of the read-card props from a frozen call slice: the
+ * `card:'read'` render intent the read tool declares arrives on the snapshot as
+ * the settled result node's `resultView`, and this is the one place that turns
+ * it into what {@link ReadBlock} draws. Both conversation render sites (the chat
+ * tool row's resident body and the details panel's Output section) call this, so
+ * the path, lines, total, and language they show are derived once.
+ *
+ * The read card is result-side only ([read card note](../../../../../../.agents/notes/implemented/feature/2026-07-30-web-read-card.md)):
+ * a call carries no file content until `execute` returns, so the pending call
+ * stays a generic card (`kind: 'read'`). A running read therefore has no read
+ * card, and this returns null for it — the row keeps its args-derived summary
+ * until the result arrives.
+ * @module
+ */
+import type { ReadBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import { type ToolCallBlock } from './tool-call-model.ts';
+/**
+ * Content lines the chat row's resident read body shows before collapsing the
+ * middle — half the primitive's own default, which the details panel keeps. A
+ * chat row is a summary surface inside the message flow: the flow must stay
+ * scannable across many calls, while the details panel is the single-call
+ * reading surface. A design constant of this UI's row geometry, not a
+ * deployment choice, so it is fixed here rather than a plugin Config field. The
+ * same split [`CHAT_TERMINAL_MAX_LINES`](./terminal-card-model.ts) draws for
+ * terminal output.
+ */
+export declare const CHAT_READ_MAX_LINES = 8;
+/**
+ * The {@link ReadBlock} props this derivation owns. Picked off the primitive's
+ * props so the two stay in step; `maxLines`/`className` belong to each render
+ * site.
+ */
+export type ReadCardModel = Pick<ReadBlockProps, 'label' | 'lines' | 'totalLines' | 'lang'>;
+/**
+ * Derive the read-card props for a tool call, or null when this call is not a
+ * read card and belongs on the generic path.
+ *
+ * The read card is result-side only, so only a settled call whose result view
+ * declares `card:'read'` produces one. Every other case is null — the
+ * documented generic-card default:
+ *
+ * - A running call: it has no result view yet, and a read carries no content at
+ *   call time.
+ * - A settled call whose result view is not a read card — including a `card`
+ *   value this UI version does not know, which arrives over the wire and cannot
+ *   be trusted to be one of the compiled variants, and the read tool's own
+ *   generic fallback for an error result or a non-envelope body.
+ *
+ * The label is the read view's `title` when the tool supplied one (the
+ * presentation contract's replacement-title rule), otherwise the file path
+ * shortened the same way the row summary is: workspace-relative first, then
+ * POSIX `~` for a leftover host-home path.
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @param sessionCwd - the session workspace root; a workspace-rooted absolute
+ *   path label displays relative to it. Absent leaves the path as authored.
+ * @param home - host account home; a leftover POSIX home path displays as `~`.
+ * @returns the read-card props, or null for the generic path.
+ */
+export declare function readCardModel(block: ToolCallBlock, sessionCwd?: string, home?: string): ReadCardModel | null;

package/lib/client/tool/search-card-model.d.ts

@@ -0,0 +1,94 @@
+/**
+ * search-card-model：抄自 DSH `packages/client/ui-tool/src/client/tool/models/search-card-model.ts`。
+ * 从冻结 call slice 纯派生 search 卡 props（`card:'search'` 渲染意图，grep/glob 声明，
+ * result 侧）——聊天工具行常驻展开体与详情面板共用同一派生。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/search-card-model
+ */
+/**
+ * Pure derivation of the search-card props from a frozen call slice: the
+ * `card:'search'` render intent the `grep` and `glob` tools declare arrives on
+ * the snapshot as `resultView`, and this is the one place that turns it into
+ * what {@link SearchBlock} draws. Both conversation render sites (the chat tool
+ * row's resident body and the details panel's Output section) call this, so the
+ * grouped matches or the path list they show are derived once.
+ *
+ * The search card is result-time only: a search call has no matches or paths
+ * before `execute`, so its pending state stays a `GenericCallView`
+ * ({@link module:@deepseek-ai/dsh-tools/src/presentation}). This derivation
+ * therefore reads only `resultView` and returns null for a still-running call,
+ * unlike the terminal card whose call view carries the command before
+ * execution.
+ *
+ * A capped result also carries a recovery locator (grep/glob's `Full … stored
+ * at …` footer) in the raw `tool/result` content, not in the structured
+ * matches/paths the view carries. Since both render sites replace that raw
+ * result with the card, this derivation surfaces the block's own result text as
+ * {@link SearchCardModel.recovery} so the one path to the dropped rows is not
+ * lost.
+ * @module
+ */
+import type { SearchBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { ToolCallBlock } from './tool-call-model.ts';
+/**
+ * Distributive `Omit`: a plain `Omit<A | B, K>` keeps only the keys common to
+ * both members, which would drop the `files`/`paths` discriminated fields.
+ * Distributing over the naked type parameter `T` preserves each shape.
+ */
+type DistributiveOmit<T, K extends keyof T> = T extends unknown ? Omit<T, K> : never;
+/** The {@link SearchBlockProps} union minus each render site's own fields. */
+type SearchBlockModelProps = DistributiveOmit<SearchBlockProps, 'maxLines' | 'className'>;
+/**
+ * Result rows the chat row's resident search body shows before collapsing the
+ * middle — half the primitive's own default, which the details panel keeps. A
+ * chat row is a summary surface inside the message flow: the flow must stay
+ * scannable across many calls, while the details panel is the single-call
+ * reading surface. A design constant of this UI's row geometry, not a
+ * deployment choice, so it is fixed here rather than a plugin Config field.
+ */
+export declare const CHAT_SEARCH_MAX_LINES = 8;
+/**
+ * The {@link SearchBlock} props this derivation owns. Held as a nested object
+ * (`card`) so a render site spreads exactly the primitive's own surface and can
+ * never leak a neighbouring field into it. `maxLines`/`className` belong to each
+ * render site.
+ */
+export interface SearchCardModel {
+    /**
+     * The props {@link SearchBlock} draws, minus each render site's own
+     * `maxLines`/`className`.
+     */
+    card: SearchBlockModelProps;
+    /**
+     * The result view's replacement title, which the presentation contract lets a
+     * search tool set at settle time. Absent when the presenter supplied none; a
+     * row then keeps its args-derived summary.
+     */
+    title: string | undefined;
+    /**
+     * The raw `tool/result` text, flattened, surfaced only when the search was
+     * capped. The card renders the retained matches or paths, but the recovery
+     * locator a capped result carries — grep/glob's `Full … stored at: <locator>`
+     * footer, the one way to reach the rows the cap dropped — lives only in the raw
+     * result text, which the card replaces. A UI that shows the card would
+     * otherwise lose it. Absent when the result was not capped (the card holds
+     * every result) or the block carries no text.
+     */
+    recovery: string | undefined;
+}
+/**
+ * Derive the search-card props for a tool call, or null when this call is not
+ * a search card and belongs on the generic path.
+ *
+ * Only the result side matters: the search card carries no call-time state, so
+ * a still-running call (no result view) is null, as is a settled call whose
+ * result view is not a search card — including a `card` value this UI version
+ * does not know, which arrives over the wire and cannot be trusted to be one of
+ * the compiled variants, a `card: 'search'` view whose `shape` is neither
+ * `matches` nor `paths` (equally untrusted wire data), and a generic result a
+ * `grep`/`glob` failure or nested `run_code` dispatch produces (its text keeps
+ * the generic path).
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @returns the search-card props, or null for the generic path.
+ */
+export declare function searchCardModel(block: ToolCallBlock): SearchCardModel | null;
+export {};

package/lib/client/tool/terminal-card-model.d.ts

@@ -0,0 +1,86 @@
+/**
+ * terminal-card-model：抄自 DSH `packages/client/ui-tool/src/client/tool/models/terminal-card-model.ts`。
+ * 从冻结 call slice 纯派生 terminal 卡 props：`card:'terminal'` 渲染意图（shell 工具声明）
+ * 随快照以 `callView`/`resultView` 到达，这里是把它变成 {@link TerminalBlock} 所绘内容的
+ * 唯一地点。locale 面收窄为 sandore 命名空间，其余逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/terminal-card-model
+ */
+/**
+ * Pure derivation of the terminal-card props from a frozen call slice: the
+ * `card:'terminal'` render intent the shell tools declare arrives on the
+ * snapshot as `callView`/`resultView`, and this is the one place that turns
+ * that pair into what {@link TerminalBlock} draws. Both conversation render
+ * sites (the chat tool row's expanded body and the details panel's Output
+ * section) call this, so the command, cwd, output and exit status they show
+ * are derived once.
+ * @module
+ */
+import type { TerminalBlockLabels, TerminalBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ToolCallBlock } from './tool-call-model.ts';
+/**
+ * Build the TerminalBlock display copy from the locale seat — the one place
+ * the primitive's label surface pairs with this package's dictionary, shared
+ * by every terminal render site (chat row, bash row, details panel).
+ * @param t - the render site's locale seat.
+ * @returns the full label set for {@link TerminalBlockProps}'s `labels`.
+ */
+export declare function terminalBlockLabels(t: TranslateNS<'sandore'>): TerminalBlockLabels;
+/**
+ * The {@link TerminalBlock} props this derivation owns. Picked off the
+ * primitive's props so the two stay in step; `home` is absent because the web
+ * client has no home path for the session host (a cwd renders as its last
+ * path segment), and `maxLines`/`className` belong to each render site.
+ */
+export interface TerminalCardModel {
+    /**
+     * The props {@link TerminalBlock} draws. Held as a nested object so a render
+     * site spreads exactly the primitive's own surface and can never leak a
+     * neighbouring field into it.
+     */
+    card: Pick<TerminalBlockProps, 'command' | 'cwd' | 'output' | 'exitCode' | 'signal' | 'running'>;
+    /**
+     * The call view's model-authored description, which the contract defines as
+     * rendering ABOVE the card (the card itself has no description slot). Absent
+     * when the presenter supplied none, or when the window dropped the call side;
+     * a row then keeps its args-derived summary.
+     */
+    description: string | undefined;
+}
+/**
+ * True when a settled terminal card reports a failing exit — a non-zero code
+ * or a terminating signal. The bash tool settles a failing command as a
+ * completed call (`isError` stays false: the exit status is result data), so
+ * this is the collapsed row's only failure signal; without it the red exit
+ * pill would be visible only after expanding the card.
+ * @param model - a derived terminal card.
+ * @returns whether the card's exit status is a failure.
+ */
+export declare function terminalFailed(model: TerminalCardModel): boolean;
+/**
+ * Derive the terminal-card props for a tool call, or null when this call is
+ * not a terminal card and belongs on the generic path.
+ *
+ * The call side supplies the command and its working directory; the result
+ * side supplies the captured output and exit status. Three cases produce
+ * null, all of them the documented generic-card default:
+ *
+ * - Neither side declares `card:'terminal'` — including a `card` value this
+ *   UI version does not know, which arrives over the wire and therefore
+ *   cannot be trusted to be one of the compiled variants.
+ * - A settled call whose result view is not a terminal card: the result
+ *   presentation decides how the settled call renders, and the bash tool
+ *   returns a generic fenced card for an execution error or a background
+ *   start, whose text and error styling the generic path preserves.
+ *
+ * Window truncation can drop the call head from a settled result (see
+ * `ToolResultNode.call`/`callView` in dsh-client-runtime), leaving a terminal
+ * result with no call side. That still renders: the command falls back to the
+ * result view's replacement title, then to an empty command (the prompt line
+ * draws bare), and the prompt shows no cwd.
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @param sessionCwd - the session workspace root, which resolves an omitted or
+ *   relative view cwd (see {@link resolveTerminalCwd}); absent leaves both unresolved.
+ * @returns the terminal-card props, or null for the generic path.
+ */
+export declare function terminalCardModel(block: ToolCallBlock, sessionCwd?: string): TerminalCardModel | null;

package/lib/client/tool/tool-call-model.d.ts

@@ -0,0 +1,74 @@
+/**
+ * tool-call-model：抄自 DSH `packages/client/ui-tool/src/client/tool/models/tool-call-model.ts`。
+ * 工具摘要行的纯 row-model 派生：variant 分类、单行摘要、展开正文文本、结算结果输出。
+ * `abbreviateHomePath` 在 DSH 当前源码（rc.8）从 `@deepseek-ai/dsh-client-runtime/client`
+ * 导出，但 sandore 编译面锁定的已装版本（rc.6）尚未导出，故按 DSH runtime
+ * `workspaces/path.ts` 源码本地复刻（含 Windows/UNC 守卫）。逐字保留其余逻辑。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/tool-call-model
+ */
+import type { ToolCallBlock, ToolResultNode } from '@deepseek-ai/dsh-client-runtime/client';
+export type { ToolCallBlock } from '@deepseek-ai/dsh-client-runtime/client';
+/** Tool-call row variants selected by the generic atomic renderer. */
+export type ToolRowVariant = 'search' | 'read' | 'bash' | 'write' | 'edit' | 'code' | 'others';
+/** Row state semantic; colors self-supplied via StateDot (design gives none). */
+export type ToolRowState = 'running' | 'ok' | 'error' | 'stopped';
+/** Figma row titles per variant (design literals, not translatable copy). */
+export declare const VARIANT_TITLES: Record<ToolRowVariant, string>;
+/**
+ * Classify a tool name into its row variant.
+ * @param toolName - wire tool name.
+ * @returns matching variant, others when unknown.
+ */
+export declare function classifyTool(toolName: string): ToolRowVariant;
+/**
+ * Display-only POSIX home abbreviation（DSH runtime `workspaces/path.ts` 源码复刻）。
+ * Windows drive and UNC paths stay verbatim, including when `home` itself is a
+ * Windows path. A missing, empty, or filesystem-root `home` leaves `path`
+ * unchanged so `/` cannot become `~`.
+ * @param path - absolute or already-short display path.
+ * @param home - host account home from `host.describe`; absent skips abbreviation.
+ * @returns `~` or `~/…` for the POSIX home and its descendants, otherwise `path`.
+ */
+export declare function abbreviateHomePath(path: string, home?: string): string;
+/** Everything ToolRow needs, derived once from the frozen slice. */
+export interface ToolRowModel {
+    variant: ToolRowVariant;
+    title: string;
+    summary: string;
+    /**
+     * Filesystem path from args (`path` / `file_path`) when the row is a file
+     * tool; absent for URL reads and non-file tools.
+     */
+    filePath: string | undefined;
+    /** Expanded-body input text (pretty args); null = no input section. */
+    body: string | null;
+    /** Flattened result text ({@link resultText}); null while running or when the result carries no text. */
+    output: string | null;
+    /** First line of the result text on an error row; null for every other state. */
+    errorSummary: string | null;
+    state: ToolRowState;
+}
+/**
+ * Flatten a settled result's content blocks to display text: text blocks
+ * verbatim, other block shapes as pretty JSON. Empty content on a failed call
+ * falls back to the structured error's `name: code` line.
+ * @param node - the settled result node.
+ * @returns the flattened result text (may be empty).
+ */
+export declare function resultText(node: ToolResultNode): string;
+/**
+ * Strip the workspace root from a workspace-rooted absolute path (display only).
+ * @param text - the path to shorten.
+ * @param cwd - session workspace root; absent or empty leaves the path unchanged.
+ * @returns the path relative to the workspace root, or unchanged when it is not rooted there.
+ */
+export declare function relativizeToCwd(text: string, cwd: string | undefined): string;
+/**
+ * Derive the full row model from a frozen call slice.
+ * @param toolName - wire tool name (dispatch-supplied; survives windowless results).
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @param cwd - session workspace root; workspace-rooted path summaries display relative to it.
+ * @param home - host account home; a leftover POSIX home path displays as `~`.
+ * @returns the row model.
+ */
+export declare function toolRowModel(toolName: string, block: ToolCallBlock, cwd?: string, home?: string): ToolRowModel;

package/lib/client/tool/web-card-model.d.ts

@@ -0,0 +1,44 @@
+/**
+ * web-card-model：抄自 DSH `packages/client/ui-tool/src/client/tool/models/web-card-model.ts`。
+ * 从冻结 call slice 纯派生 web 卡 props（`card:'web'` 渲染意图，web_search/web_fetch 在
+ * result 时声明）——聊天工具行展开体与详情面板共用同一派生。逐字保留。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/tool/web-card-model
+ */
+/**
+ * Pure derivation of the web-card props from a frozen call slice: the
+ * `card:'web'` render intent the `web_search`/`web_fetch` tools declare at
+ * result time arrives on the snapshot as `resultView`, and this is the one
+ * place that turns it into what {@link WebBlock} draws. Both conversation
+ * render sites (the chat tool row's resident/expanded body and the details
+ * panel's Output section) call this, so the sources and fetch summary they
+ * show are derived once.
+ *
+ * The web card is result-only by contract: those tools keep a generic pending
+ * call view, so there is nothing to derive while the call is still running and
+ * a running call always takes the generic path.
+ * @module
+ */
+import type { WebBlockProps } from '@deepseek-ai/dsh-client-ui-primitives';
+import type { ToolCallBlock } from './tool-call-model.ts';
+/**
+ * Derive the web-card props for a tool call, or null when this call is not a
+ * web card and belongs on the generic path.
+ *
+ * The result side supplies the whole card: the sources and answer for a
+ * `search`, the URL and status for a `fetch`. Cases producing null, all of
+ * them the documented generic-card default:
+ *
+ * - A running call (no `resultView` yet): the web tools keep a generic pending
+ *   card, so nothing web-shaped exists until the call settles.
+ * - A settled call whose result view is not a web card — including a `card`
+ *   value this UI version does not know, which arrives over the wire and so
+ *   cannot be trusted to be one of the compiled variants, and a generic result
+ *   view (a web tool's error path returns the generic card, whose text the
+ *   generic path preserves).
+ * - A web card whose `kind` this UI version does not know (a newer host's
+ *   value): the wire cannot be trusted to be `search` or `fetch`, so it takes
+ *   the generic path rather than rendering as a malformed fetch.
+ * @param block - RunningToolCall or ToolResultNode off the snapshot caches.
+ * @returns the web-card props, or null for the generic path.
+ */
+export declare function webCardModel(block: ToolCallBlock): WebBlockProps | null;

package/lib/client/use-focus-refresh.d.ts

@@ -0,0 +1 @@
+export declare function useFocusRefresh(onRefresh: () => void): void;

package/lib/client/workflow-face.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 工作流 overlay 的业务 face（shell.overlay 条目注入；RPC 已在 index.ts 解包）。
+ *
+ * 覆盖左列表（实例/定义）、编辑区（DagEditor 编排 / RunView 执行）与测试运行
+ * 所需的全部 `ctx.remote.sandore` 访问面。`remote` 为 RunView 控件所需的最小 RPC 面。
+ * @module @deepseek-ai/dsh-client-ui-sandore/src/client/workflow-face
+ */
+import type { DagRun, InstanceSummary, WorkflowDefinitionEntry } from 'dsh-sandore/remote';
+import type { SaveDefinition } from './sandore-save.ts';
+import type { RunViewRemote } from './RunView.tsx';
+import type { ModelDirectoryFace, ObservableFace, PermissionSelectValue } from './model-faces.ts';
+/** 创建实例时选择的模型（对齐 Host `StartInstanceInput.model`）。 */
+export interface StartModelSelection {
+    provider: string;
+    model: string;
+    reasoningEffort?: string;
+}
+/** 新增实例入参（去 job 概念：直接绑定工作流定义 + 工作目录 + 模型 + 权限）。 */
+export interface StartInstanceParams {
+    workflowId: string;
+    originalInput: string;
+    /** 必填工作目录：hostAgent 据此 attach 到对应的 web workspace。 */
+    cwd: string;
+    model?: StartModelSelection;
+    permission?: string;
+}
+/** 模型目录条目（弹窗模型下拉数据源，来自 `ctx.llm` 目录）。 */
+export interface ModelDirectoryEntry {
+    provider: string;
+    providerName: string;
+    models: {
+        id: string;
+        name: string;
+    }[];
+}
+/** WorkflowOverlay 接收的业务 face。 */
+export interface WorkflowOverlayFace {
+    /** 拉取实例摘要（RPC 已解包）。 */
+    listInstances(): Promise<InstanceSummary[]>;
+    /** 拉取定义列表（RPC 已解包）。 */
+    listDefinitions(): Promise<WorkflowDefinitionEntry[]>;
+    /** 启动实例（新增实例弹窗 / 测试运行；RPC 已解包）。 */
+    startInstance(input: StartInstanceParams): Promise<DagRun>;
+    /** 模型目录（弹窗模型下拉数据源；RPC 已解包）。 */
+    listModelDirectory(): Promise<ModelDirectoryEntry[]>;
+    /** 打开 DSH 原生目录选择器（新增实例的工作目录）。 */
+    pickDirectory(): Promise<string | undefined>;
+    /** 删除定义（RPC 已解包）。 */
+    deleteDefinition(id: string): Promise<boolean>;
+    /** 删除实例（RPC 已解包；state 表行级删除）。 */
+    deleteInstance(instanceId: string): Promise<boolean>;
+    /** 读取定义原始 YAML（RPC 已解包）。 */
+    getYaml(id: string): Promise<string>;
+    /** DagEditor 保存回调（createSandoreSave 接线）。 */
+    save: SaveDefinition;
+    /** RunView 所需的最小 `ctx.remote.sandore` 访问面。 */
+    remote: RunViewRemote;
+    /** 打开宿主会话（RunView「查看详情/打开讨论」跳实例或子代理会话）。 */
+    openSession(id: string): void;
+    /** 某会话的共享模型目录（复用 DSH `ctx.modelDirectories`，行为与主 session 一致）。 */
+    modelDirectory(sessionId: string): ModelDirectoryFace;
+    /** 某会话的权限投影（`projections.permissions`，可订阅）。 */
+    permissions(sessionId: string): ObservableFace<PermissionSelectValue | undefined>;
+    /** 对某会话执行一行命令（`/permission <id>` 等，走 DSH `remote.commands`）。 */
+    runCommand(sessionId: string, line: string): Promise<boolean>;
+    /** 权限投影缺失时的回退：经 `/permission`（无参）查询当前预设与可用列表。 */
+    queryPermission(sessionId: string): Promise<PermissionSelectValue | undefined>;
+}