dsh-better-display 0.1.1

package/lib/types/client/native/tool-call-model.js

@@ -0,0 +1,219 @@
+/**
+ * Pure row-model derivation for tool summary rows: variant classification,
+ * one-line summary, expanded-body text, and flattened result output from the
+ * frozen call slice. Input material comes from the call ARGUMENTS; output and
+ * error material from the settled result node. A call whose render intent is
+ * a terminal card gets its expanded body from the views instead, through
+ * `terminalCardModel` in terminal-card-model.ts.
+ */
+// The block union's defining home is runtime (fold-product types); this
+// contract only forwards it (type-definition authority stays with the layer
+// that produces the values).
+import { abbreviateHomePath } from '@deepseek-ai/dsh-util-workspace-path';
+/** Figma row titles per variant (design literals, not translatable copy). */
+export const VARIANT_TITLES = {
+    search: 'Search', read: 'Read', bash: 'Bash',
+    write: 'Write', edit: 'Edit', code: 'Code', others: 'Tool call',
+};
+/**
+ * Known tool name -> variant.
+ *
+ * `cordis_define` is deliberately absent: ui-cordis registers a keyed
+ * `tool.call.toolview` entry for it, and a keyed hit REPLACES the generic row
+ * (this table is only reached through GenericToolCard, the dispatch fallback in
+ * ToolCallTree). An entry here would be unreachable, and a second title for the
+ * same call would be a second answer to a question the card already owns.
+ */
+const TOOL_VARIANTS = {
+    bash: 'bash',
+    // The PowerShell twin is a shell tool: the bash row family (icon, colors)
+    // with its own title from TOOL_TITLES, not the generic `others` row.
+    pwsh: 'bash',
+    read: 'read',
+    web_fetch: 'read',
+    web_search: 'search',
+    grep: 'search',
+    glob: 'search',
+    write: 'write',
+    edit: 'edit',
+    run_code: 'code',
+    cordis_package_inspect: 'read',
+    cordis_runtime_inspect: 'read',
+    // The three run-control verbs take one package id and produce a receipt, so
+    // the generic row is the decided intent, not an unclassified default: there is
+    // no program to show (that is `cordis_define`'s card) and no file to open. The
+    // id lands in the summary slot, and the titles below name the act.
+    cordis_run: 'others',
+    cordis_stop: 'others',
+    cordis_undefine: 'others',
+};
+/** Tool-owned titles that refine a generic row variant without replacing it. */
+const TOOL_TITLES = {
+    cordis_package_inspect: 'Inspect',
+    cordis_runtime_inspect: 'Inspect',
+    cordis_run: 'Run Cordis Plugin',
+    cordis_stop: 'Stop Cordis Plugin',
+    cordis_undefine: 'Remove Cordis Plugin',
+    pwsh: 'Pwsh',
+};
+/**
+ * Classify a tool name into its row variant.
+ * @param toolName - wire tool name.
+ * @returns matching variant, others when unknown.
+ */
+export function classifyTool(toolName) {
+    return TOOL_VARIANTS[toolName] ?? 'others';
+}
+/**
+ * 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 function resultText(node) {
+    const parts = [];
+    for (const block of node.content) {
+        if (block.type === 'text')
+            parts.push(block.text);
+        else
+            parts.push(JSON.stringify(block, null, 2));
+    }
+    if (parts.length === 0 && node.error !== undefined) {
+        parts.push(`${node.error.name}: ${node.error.code}`);
+    }
+    return parts.join('\n');
+}
+function parseArgs(argsRaw) {
+    try {
+        return JSON.parse(argsRaw);
+    }
+    catch {
+        // Non-JSON args (mid-stream truncation): summary/body fall back to the raw string.
+        return undefined;
+    }
+}
+function firstLine(text) {
+    const nl = text.indexOf('\n');
+    return nl === -1 ? text : text.slice(0, nl);
+}
+function pickString(args, keys) {
+    for (const key of keys) {
+        const v = args[key];
+        if (typeof v === 'string' && v !== '')
+            return v;
+    }
+    return undefined;
+}
+/** Summary key preference per variant (args-derived; result-derived summaries are a ledger item). */
+const SUMMARY_KEYS = {
+    bash: ['description', 'command'],
+    read: ['path', 'file_path', 'url'],
+    search: ['query', 'pattern', 'url'],
+    write: ['path', 'file_path'],
+    edit: ['path', 'file_path'],
+    code: ['description'],
+    others: [],
+};
+/**
+ * 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 function relativizeToCwd(text, cwd) {
+    if (cwd === undefined || cwd === '')
+        return text;
+    const root = cwd.replace(/[/\\]+$/, '');
+    if (text.startsWith(`${root}/`) || text.startsWith(`${root}\\`))
+        return text.slice(root.length + 1);
+    return text;
+}
+function deriveSummary(variant, argsRaw) {
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null)
+        return firstLine(argsRaw);
+    const args = parsed;
+    if (variant === 'search' && Array.isArray(args.queries)) {
+        const queries = args.queries.filter((query) => typeof query === 'string' && query !== '');
+        if (queries.length > 0)
+            return queries.map(firstLine).join(', ');
+    }
+    const picked = pickString(args, SUMMARY_KEYS[variant]);
+    if (picked !== undefined)
+        return firstLine(picked);
+    for (const v of Object.values(args)) {
+        if (typeof v === 'string' && v !== '')
+            return firstLine(v);
+    }
+    return firstLine(argsRaw);
+}
+/** Path keys only — never `url` (web_fetch lands on the read variant). */
+const FILE_PATH_KEYS = ['path', 'file_path'];
+/** File-tool variants whose summary may be an openable workspace path. */
+const FILE_PATH_VARIANTS = new Set(['read', 'write', 'edit']);
+function deriveFilePath(variant, argsRaw) {
+    if (!FILE_PATH_VARIANTS.has(variant))
+        return undefined;
+    const parsed = parseArgs(argsRaw);
+    if (typeof parsed !== 'object' || parsed === null)
+        return undefined;
+    const picked = pickString(parsed, FILE_PATH_KEYS);
+    return picked === undefined ? undefined : firstLine(picked);
+}
+function deriveBody(variant, argsRaw) {
+    if (argsRaw === '')
+        return null;
+    const parsed = parseArgs(argsRaw);
+    if (parsed === undefined)
+        return argsRaw;
+    // The code row's expanded body IS the program (monospace via the row's
+    // variant styling), not the args JSON envelope around it.
+    if (variant === 'code' && typeof parsed === 'object' && parsed !== null) {
+        const code = parsed.code;
+        if (typeof code === 'string' && code !== '')
+            return code;
+    }
+    return JSON.stringify(parsed, null, 2);
+}
+/**
+ * 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 function toolRowModel(toolName, block, cwd, home) {
+    const variant = classifyTool(toolName);
+    const done = 'kind' in block;
+    const argsRaw = (done ? block.call?.argsRaw : block.argsRaw) ?? '';
+    const state = !done ? 'running'
+        : block.error?.code === 'interrupted' ? 'stopped'
+            : block.isError ? 'error' : 'ok';
+    const base = argsRaw === ''
+        ? block.callId
+        : abbreviateHomePath(relativizeToCwd(deriveSummary(variant, argsRaw), cwd), home);
+    const toolTitle = TOOL_TITLES[toolName];
+    // Others keeps the static "Tool call" title (figma literal); the real tool
+    // name rides the mutable summary slot unless the tool owns a specific title.
+    const summary = variant === 'others' && toolName !== '' && toolTitle === undefined
+        ? `${toolName} · ${base}`
+        : base;
+    // The empty string is "no text" for both derived result fields: a settled
+    // call with blank content has nothing to expand, and a blank first line
+    // would erase the collapsed error row's summary slot.
+    const output = done ? (resultText(block) || null) : null;
+    const errorSummary = state === 'error' && output !== null ? firstLine(output) : null;
+    return {
+        variant,
+        title: toolTitle ?? VARIANT_TITLES[variant],
+        summary,
+        filePath: deriveFilePath(variant, argsRaw),
+        body: deriveBody(variant, argsRaw),
+        output,
+        errorSummary,
+        state,
+    };
+}
+//# sourceMappingURL=tool-call-model.js.map

package/lib/types/client/native/tool-call-model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-call-model.js","sourceRoot":"","sources":["../../../../src/client/native/tool-call-model.ts"],"names":[],"mappings":"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"}

package/lib/types/client/open-file.d.ts

@@ -0,0 +1,24 @@
+export type DeliverableOpenMode = 'external' | 'sidebar';
+export interface OpenModeSnapshot {
+    getSnapshot: () => {
+        deliverableOpenMode?: DeliverableOpenMode;
+    };
+    subscribe?: (fn: () => void) => () => void;
+}
+export declare function deliverableOpenModeOf(value: unknown): DeliverableOpenMode;
+export declare function modeFromSnapshot(store: OpenModeSnapshot | undefined): DeliverableOpenMode;
+export declare function isFolderOpenPath(path: string): boolean;
+export declare function fileAddressFor(sessionId: string, cwd: string | undefined, path: string): string;
+export declare function resolveOpenWorkspacePath(cwd: string | undefined, path: string, resolveWorkspacePath: (cwd: string | undefined, path: string) => string): string;
+export declare function openDeliverableFile(args: {
+    path: string;
+    mode: DeliverableOpenMode;
+    sessionId: string;
+    cwd: string | undefined;
+    resolveWorkspacePath: (cwd: string | undefined, path: string) => string;
+    openExternal: (absolutePath: string) => Promise<void>;
+    openSidebar?: (address: string) => void;
+    fileAddressFor?: (sessionId: string, cwd: string | undefined, path: string) => string;
+    warn?: (message: string, extra?: unknown) => void;
+}): Promise<'sidebar' | 'external'>;
+//# sourceMappingURL=open-file.d.ts.map

package/lib/types/client/primitive-labels.d.ts

@@ -0,0 +1,10 @@
+import type { DiffBlockLabels, JsonTreeLabels, MarkdownLabels, ReadBlockLabels, SearchBlockLabels, TerminalBlockLabels, WebBlockLabels } from '@deepseek-ai/dsh-client-ui-primitives';
+export declare const markdownLabels: MarkdownLabels;
+export declare const readBlockLabels: ReadBlockLabels;
+export declare const terminalBlockLabels: TerminalBlockLabels;
+export declare const diffBlockLabels: DiffBlockLabels;
+export declare const searchBlockLabels: SearchBlockLabels;
+export declare const webBlockLabels: WebBlockLabels;
+export declare const jsonTreeLabels: JsonTreeLabels;
+export declare const truncatedJsonLabel: (total: number) => string;
+//# sourceMappingURL=primitive-labels.d.ts.map

package/lib/types/client/primitive-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitive-labels.d.ts","sourceRoot":"","sources":["../../../src/client/primitive-labels.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,mBAAmB,EACnB,cAAc,EACf,MAAM,uCAAuC,CAAC;AAE/C,eAAO,MAAM,cAAc,EAAE,cAG5B,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAI7B,CAAC;AAEF,eAAO,MAAM,mBAAmB,EAAE,mBAKjC,CAAC;AAEF,eAAO,MAAM,eAAe,EAAE,eAI7B,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,iBAK/B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAG5B,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,cAI5B,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,KAAG,MAAoC,CAAC"}

package/lib/types/client/primitive-labels.js

@@ -0,0 +1,37 @@
+export const markdownLabels = {
+    code: { copyLabel: '复制', copiedLabel: '已复制' },
+    footnotes: '脚注',
+};
+export const readBlockLabels = {
+    window: (shown, total) => `显示 ${shown} / ${total} 行`,
+    copy: '复制', copied: '已复制', collapseAria: '收起文件内容',
+    expandAria: hidden => `展开其余 ${hidden} 行`, collapse: '收起', expand: hidden => `展开其余 ${hidden} 行`,
+};
+export const terminalBlockLabels = {
+    signal: signal => `信号 ${signal}`, exitCode: code => `退出码 ${code}`,
+    running: '执行中', failed: '失败', done: '已完成', copy: '复制', copied: '已复制',
+    noOutput: '没有输出', collapseAria: '收起命令输出', collapse: '收起',
+    expandAria: hidden => `展开其余 ${hidden} 行`, expand: hidden => `展开其余 ${hidden} 行`,
+};
+export const diffBlockLabels = {
+    copy: '复制', copied: '已复制', collapseAria: '收起差异', collapse: '收起',
+    expandAria: hidden => `展开其余 ${hidden} 行`, expand: hidden => `展开其余 ${hidden} 行`,
+    files: count => `${count} 个文件`,
+};
+export const searchBlockLabels = {
+    pathsSummary: (shown, total, truncated) => `${shown} / ${total} 个路径${truncated ? '（结果已截断）' : ''}`,
+    matchesSummary: (shown, total, files, truncated) => `${shown} / ${total} 处匹配 · ${files} 个文件${truncated ? '（结果已截断）' : ''}`,
+    copy: '复制', copied: '已复制', noResults: '没有结果', collapseAria: '收起搜索结果', collapse: '收起',
+    expandAria: hidden => `展开其余 ${hidden} 行`, expand: hidden => `展开其余 ${hidden} 行`,
+};
+export const webBlockLabels = {
+    noResults: '没有结果', sourcesTruncated: '来源已截断', http: 'HTTP', contentTruncated: '内容已截断',
+    markdown: markdownLabels,
+};
+export const jsonTreeLabels = {
+    copyValue: '复制值', copyJson: '复制 JSON', copyPath: '复制路径', copyPrettyJson: '复制格式化 JSON',
+    copyCompactJson: '复制紧凑 JSON', copied: '已复制', copyFailed: '复制失败', collapseNode: '收起节点',
+    expandNode: '展开节点', copyButtonTitle: action => action,
+};
+export const truncatedJsonLabel = (total) => `内容过长，已截断（共 ${total} 个字符）`;
+//# sourceMappingURL=primitive-labels.js.map

package/lib/types/client/primitive-labels.js.map

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

package/lib/types/client/projection.d.ts

@@ -0,0 +1,41 @@
+import type { AssistantBlock, ToolCallBlock, TurnLocation } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { AssistantChatData, ChatConversationViewNode } from '@deepseek-ai/dsh-client-ui-chat/client';
+export interface ReaderGroup {
+    key: string;
+    turn: number | null;
+    keys: readonly string[];
+}
+export interface TurnBoundary {
+    status: 'open' | 'closed' | 'unknown';
+    reason: string | null;
+    latestStep: number;
+    closingStep: number | null;
+}
+export declare function groupNodes(order: readonly string[], get: (key: string) => ChatConversationViewNode | undefined): ReaderGroup[];
+export declare function boundaryOf(turn: TurnLocation | undefined): TurnBoundary;
+export declare function isEarlierNarration(data: AssistantChatData, boundary: TurnBoundary): boolean;
+export declare function processExpanded(choice: boolean | undefined, boundary: TurnBoundary): boolean;
+/** Reading while running must not pin the process open after completion. */
+export declare function processChoiceKey(groupKey: string, boundary: TurnBoundary): string;
+/** A body-only assistant step is not a thinking/process disclosure. */
+export declare function hasProcessContent(node: ChatConversationViewNode | undefined, boundary: TurnBoundary): boolean;
+export declare function hasVisibleBody(blocks: readonly AssistantBlock[]): boolean;
+/** Keep native block order. In particular, never lift a later Think above text. */
+export declare function assistantSegments(blocks: readonly AssistantBlock[]): {
+    kind: 'reasoning' | 'body';
+    start: number;
+    blocks: AssistantBlock[];
+}[];
+export declare function toolFailed(block: ToolCallBlock): boolean;
+export declare function toolName(block: ToolCallBlock): string;
+export declare function terminalLabel(reason: string | null): string | null;
+/**
+ * Extract the first usable fork anchor seq from candidate message nodes.
+ * Only the durable closing message seq cuts the intended turn prefix: an
+ * absent anchor must surface as undefined (never as 0 or NaN), because the
+ * host treats a missing atSeq as a whole-session fork.
+ */
+export declare function forkAnchorSeq(candidates: ReadonlyArray<{
+    seq?: unknown;
+} | null | undefined>): number | undefined;
+//# sourceMappingURL=projection.d.ts.map

package/lib/types/client/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../src/client/projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gDAAgD,CAAC;AAClH,OAAO,KAAK,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AAG1G,MAAM,WAAW,WAAW;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AAC1F,MAAM,WAAW,YAAY;IAAG,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE;AAG9I,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,GAAG,WAAW,EAAE,CAgB9H;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,YAAY,CAOvE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAK3F;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAE5F;AAED,4EAA4E;AAC5E,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEjF;AAED,uEAAuE;AACvE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,wBAAwB,GAAG,SAAS,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAS7G;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAEzE;AAED,mFAAmF;AACnF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG;IAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,cAAc,EAAE,CAAA;CAAE,EAAE,CAa9I;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAExD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAErD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAUlE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,aAAa,CAAC;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,GAAG,SAAS,CAAC,GAC9D,MAAM,GAAG,SAAS,CAMpB"}

package/lib/types/client/projection.js

@@ -0,0 +1,112 @@
+import { activityPhase } from './tool-activity.js';
+// Run on structural publication, not on each text delta. Node seats subscribe by key.
+export function groupNodes(order, get) {
+    const groups = [];
+    const seenTurns = new Set();
+    for (const key of order) {
+        const node = get(key);
+        if (!node || node.visibility === 'hidden')
+            continue;
+        const turn = node.location.kind === 'step' || node.location.kind === 'turn' ? node.location.turn.turn : null;
+        const previous = groups.at(-1);
+        if (turn !== null && previous?.turn === turn) {
+            previous.keys.push(key);
+        }
+        else {
+            groups.push({ key: turn === null ? `node:${key}` : seenTurns.has(turn) ? `turn:${turn}:${key}` : `turn:${turn}`, turn, keys: [key] });
+            if (turn !== null)
+                seenTurns.add(turn);
+        }
+    }
+    return groups;
+}
+export function boundaryOf(turn) {
+    return {
+        status: turn?.status ?? 'unknown',
+        reason: turn?.end?.data.reason.kind ?? null,
+        latestStep: turn?.steps.at(-1)?.step ?? -1,
+        closingStep: turn?.data.get('turn-tail')?.closing?.step ?? null,
+    };
+}
+export function isEarlierNarration(data, boundary) {
+    // New body text, a tool call, or a settled step is not a completed turn.
+    if (data.status !== 'settled' || boundary.status !== 'closed' || boundary.reason !== 'completed')
+        return false;
+    if (data.blocks.some(block => block.kind === 'image' || block.kind === 'other'))
+        return false;
+    return boundary.closingStep !== null && data.step < boundary.closingStep;
+}
+export function processExpanded(choice, boundary) {
+    return choice ?? !(boundary.status === 'closed' && boundary.reason === 'completed');
+}
+/** Reading while running must not pin the process open after completion. */
+export function processChoiceKey(groupKey, boundary) {
+    return `${groupKey}:${boundary.status}:${boundary.reason ?? 'pending'}`;
+}
+/** A body-only assistant step is not a thinking/process disclosure. */
+export function hasProcessContent(node, boundary) {
+    if (!node || node.visibility === 'hidden')
+        return false;
+    if (node.kind === 'assistant-step') {
+        const data = node.data;
+        return data.blocks.some(block => block.kind === 'reasoning' && block.text.trim() !== '')
+            || (isEarlierNarration(data, boundary) && hasVisibleBody(data.blocks));
+    }
+    return node.kind === 'context' || node.kind === 'model-retry' || node.kind === 'system-prompt' || node.kind === 'turn-process'
+        || node.kind === 'command' || node.kind === 'manual-compaction' || node.kind === 'compaction';
+}
+export function hasVisibleBody(blocks) {
+    return blocks.some(block => block.kind === 'image' || block.kind === 'other' || (block.kind === 'text' && block.text.trim() !== ''));
+}
+/** Keep native block order. In particular, never lift a later Think above text. */
+export function assistantSegments(blocks) {
+    const segments = [];
+    let previous;
+    blocks.forEach((block, index) => {
+        if (block.kind === 'tool-call') {
+            previous = undefined;
+            return;
+        }
+        const kind = block.kind === 'reasoning' ? 'reasoning' : 'body';
+        if (previous?.kind === kind)
+            previous.blocks.push(block);
+        else {
+            previous = { kind, start: index, blocks: [block] };
+            segments.push(previous);
+        }
+    });
+    return segments;
+}
+export function toolFailed(block) {
+    return activityPhase({ block }) === 'failed';
+}
+export function toolName(block) {
+    return 'kind' in block ? block.call?.name ?? '工具调用' : block.name;
+}
+export function terminalLabel(reason) {
+    switch (reason) {
+        case 'completed': return null;
+        case 'aborted':
+        case 'interrupted': return '本轮已停止，已生成的内容仍保留。';
+        case 'blocked': return '本轮需要处理阻塞事项；请查看原对话与下方操作区。';
+        case 'max-tokens': return '输出达到本轮长度限制，内容可能尚未完整。';
+        case 'error': return '本轮未完成；错误信息保留在下方。';
+        case null: return null;
+        default: return `本轮结束状态：${reason}。请在原对话中核对完整记录。`;
+    }
+}
+/**
+ * Extract the first usable fork anchor seq from candidate message nodes.
+ * Only the durable closing message seq cuts the intended turn prefix: an
+ * absent anchor must surface as undefined (never as 0 or NaN), because the
+ * host treats a missing atSeq as a whole-session fork.
+ */
+export function forkAnchorSeq(candidates) {
+    for (const candidate of candidates) {
+        const seq = candidate?.seq;
+        if (typeof seq === 'number' && Number.isFinite(seq))
+            return seq;
+    }
+    return undefined;
+}
+//# sourceMappingURL=projection.js.map

package/lib/types/client/projection.js.map

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

package/lib/types/client/reasoning-follow.d.ts

@@ -0,0 +1,6 @@
+/** Transitions.dev Reasoning stream, adapted to appended content, never a loop. */
+export declare const REASON_HOLD = 840;
+export declare const REASON_STEP = 500;
+export declare const REASON_LINES = 2;
+export declare function reasoningTarget(top: number, contentHeight: number, viewportHeight: number, lineHeight: number): number;
+//# sourceMappingURL=reasoning-follow.d.ts.map

package/lib/types/client/reasoning-follow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-follow.d.ts","sourceRoot":"","sources":["../../../src/client/reasoning-follow.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,WAAW,MAAM,CAAC;AAC/B,eAAO,MAAM,YAAY,IAAI,CAAC;AAE9B,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAMtH"}

package/lib/types/client/reasoning-follow.js

@@ -0,0 +1,12 @@
+/** Transitions.dev Reasoning stream, adapted to appended content, never a loop. */
+export const REASON_HOLD = 840;
+export const REASON_STEP = 500;
+export const REASON_LINES = 2;
+export function reasoningTarget(top, contentHeight, viewportHeight, lineHeight) {
+    const end = Math.max(0, contentHeight - viewportHeight);
+    const current = Math.min(end, Math.max(0, top));
+    // Receiving a burst changes the available transcript, never the step size.
+    // Only the final, partial step may be shorter than the reference's two lines.
+    return Math.min(end, current + Math.max(1, lineHeight) * REASON_LINES);
+}
+//# sourceMappingURL=reasoning-follow.js.map

package/lib/types/client/reasoning-follow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reasoning-follow.js","sourceRoot":"","sources":["../../../src/client/reasoning-follow.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,CAAC;AAC/B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC;AAE9B,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,aAAqB,EAAE,cAAsB,EAAE,UAAkB;IAC5G,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAChD,2EAA2E;IAC3E,8EAA8E;IAC9E,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,GAAG,YAAY,CAAC,CAAC;AACzE,CAAC"}

package/lib/types/client/settings-copy.d.ts

@@ -0,0 +1,6 @@
+export type SettingsCopyKey = "nav" | "openTitle" | "openDescription" | "skillTitle" | "skillInstalled" | "skillMissing" | "skillPurpose" | "skillPluginNote" | "skillInstall" | "skillRecheck" | "skillChecking" | "skillUnavailable";
+export type SettingsCopy = Record<SettingsCopyKey, string>;
+export declare const en: SettingsCopy;
+export declare const zh: SettingsCopy;
+export declare function settingsLanguage(tag: string | undefined): "zh" | "en";
+export declare function settingsCopyFor(tag: string | undefined): SettingsCopy;

package/lib/types/client/settings-slots.d.ts

@@ -0,0 +1,16 @@
+import type { SettingsCopyKey } from './settings-copy.js';
+export interface SettingsSectionOwnerProps {
+    close: () => void;
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotMap {
+        'settings.section': {
+            kind: 'list';
+            scope: 'root';
+            owner: SettingsSectionOwnerProps;
+        };
+    }
+    interface LocaleNamespaceMap {
+        'better-display': SettingsCopyKey;
+    }
+}

package/lib/types/client/store.d.ts

@@ -0,0 +1,17 @@
+import type { EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+import type { DeliverableOpenMode } from './open-file.js';
+export interface ReaderState {
+    expanded: Record<string, boolean>;
+    motion: boolean;
+    autoFold: boolean;
+    deliverableOpenMode: DeliverableOpenMode;
+}
+type ReaderActions = {
+    setExpanded: (draft: ReaderState, key: string, value: boolean) => void;
+    setMotion: (draft: ReaderState, value: boolean) => void;
+    setAutoFold: (draft: ReaderState, value: boolean) => void;
+    setDeliverableOpenMode: (draft: ReaderState, value: DeliverableOpenMode) => void;
+};
+export declare function createReaderStore(): EngineStoreHandle<ReaderState, ReaderActions>;
+export {};
+//# sourceMappingURL=store.d.ts.map

package/lib/types/client/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/client/store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,MAAM,WAAW,WAAW;IAAG,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,MAAM,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE;AACtG,KAAK,aAAa,GAAG;IACnB,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACvE,SAAS,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;IACxD,WAAW,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC3D,CAAC;AAEF,wBAAgB,iBAAiB,IAAI,iBAAiB,CAAC,WAAW,EAAE,aAAa,CAAC,CAUjF"}

package/lib/types/client/store.js

@@ -0,0 +1,13 @@
+import { defineStore } from '@deepseek-ai/dsh-client-store';
+export function createReaderStore() {
+    return defineStore({
+        init: () => ({ expanded: {}, motion: true, autoFold: true }),
+        persist: 'dsh.reader.v1',
+        actions: {
+            setExpanded: (draft, key, value) => { draft.expanded[key] = value; },
+            setMotion: (draft, value) => { draft.motion = value; },
+            setAutoFold: (draft, value) => { draft.autoFold = value; },
+        },
+    });
+}
+//# sourceMappingURL=store.js.map

package/lib/types/client/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/client/store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAU5D,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC;QACjB,IAAI,EAAE,GAAgB,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;QACzE,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE;YACP,WAAW,EAAE,CAAC,KAAK,EAAE,GAAW,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC;YACrF,SAAS,EAAE,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;YAC/D,WAAW,EAAE,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE,GAAG,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC;SACpE;KACF,CAAC,CAAC;AACL,CAAC"}

package/lib/types/client/stream-buffer.d.ts

@@ -0,0 +1,29 @@
+/** Presentation only. The original session string remains the source of truth. */
+export declare const STREAM_TIMING: {
+    readonly catchUpMs: 180;
+    readonly maxQueuedMs: 240;
+    readonly finishMs: 96;
+    readonly revealMs: 350;
+    readonly minimumRate: 100;
+};
+export declare class StreamBuffer {
+    target: string;
+    visible: string;
+    revision: number;
+    private boundaries;
+    private arrivals;
+    private lastAt;
+    private credit;
+    private finishAt;
+    constructor(initial?: string);
+    get pending(): boolean;
+    private segment;
+    /** Non-append updates, cancellations and hidden/reduced views never replay. */
+    update(text: string, now: number, options?: {
+        immediate?: boolean;
+        finished?: boolean;
+    }): void;
+    flush(): void;
+    advance(now: number): boolean;
+}
+//# sourceMappingURL=stream-buffer.d.ts.map

package/lib/types/client/stream-buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-buffer.d.ts","sourceRoot":"","sources":["../../../src/client/stream-buffer.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,eAAO,MAAM,aAAa;;;;;;CAA+F,CAAC;AAc1H,qBAAa,YAAY;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,SAAK;IACb,OAAO,CAAC,UAAU,CAAO;IACzB,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,OAAO,SAAK;IAMxB,IAAI,OAAO,IAAI,OAAO,CAAqD;IAE3E,OAAO,CAAC,OAAO;IAOf,+EAA+E;IAC/E,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAwBlG,KAAK,IAAI,IAAI;IAQb,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;CA0B9B"}