@deepseek-ai/dsh-client-ui-chat 0.1.6-alpha.2 → 0.1.7-alpha.2

package/lib/index.js

@@ -1,24 +1,51 @@
 import z from "@deepseek-ai/schemastery";
 //#region lib/types/chat-settings.js
-/** Chat transcript preferences stored in the Host user-settings document. */
+/** Chat display preferences stored in the Host user-settings document. */
 /** Settings namespace owned by the Chat target. */
 const CHAT_SETTINGS_NAMESPACE = "ui-chat";
-/** Field carrying the completed-Turn transcript presentation mode. */
+/** Field carrying the work-details presentation mode. */
 const TRANSCRIPT_VIEW_FIELD = "transcriptView";
-/** Transcript presentation modes accepted at settings boundaries. */
-const TRANSCRIPT_VIEW_MODES = ["normal", "compact"];
+/** Work-details presentation modes a user can choose. */
+const TRANSCRIPT_VIEW_MODES = [
+	"compact",
+	"detailed",
+	"expanded"
+];
+/**
+* Saved value from the two-mode generation of this setting. Read as `detailed`;
+* never offered as a choice and never written back.
+*/
+const LEGACY_TRANSCRIPT_VIEW_MODE = "normal";
+/** Every value the durable field accepts: current modes plus the legacy saved value. */
+const TRANSCRIPT_VIEW_SETTING_VALUES = [...TRANSCRIPT_VIEW_MODES, LEGACY_TRANSCRIPT_VIEW_MODE];
 /** Default preserves the compact process disclosure introduced by Chat. */
 const DEFAULT_TRANSCRIPT_VIEW_MODE = "compact";
+/** Performance and usage detail levels accepted by user settings. */
+const PERFORMANCE_USAGE_MODES = ["compact", "detailed"];
+/** Preserve detailed accounting for users without an explicit preference. */
+const DEFAULT_PERFORMANCE_USAGE = "detailed";
 /** Durable Chat schema; also the wire envelope the browser scope validates against. */
-const ChatSettingsSchema = z.object({ [TRANSCRIPT_VIEW_FIELD]: z.union([...TRANSCRIPT_VIEW_MODES]).default(DEFAULT_TRANSCRIPT_VIEW_MODE) });
+const ChatSettingsFields = {
+	linkOpening: z.union(["sidebar", "new-tab"]).default("sidebar"),
+	performanceUsage: z.union([...PERFORMANCE_USAGE_MODES]).default(DEFAULT_PERFORMANCE_USAGE),
+	[TRANSCRIPT_VIEW_FIELD]: z.union([...TRANSCRIPT_VIEW_SETTING_VALUES]).default(DEFAULT_TRANSCRIPT_VIEW_MODE)
+};
+z.object(ChatSettingsFields);
 //#endregion
 //#region lib/types/index.js
-/** Host registration for browser Chat preferences. */
-/** Register the durable Chat settings section when a provider exists. */
+/** Live preferences projected to the browser. */
+const Config = z.object({
+	[TRANSCRIPT_VIEW_FIELD]: ChatSettingsFields[TRANSCRIPT_VIEW_FIELD].volatile(),
+	performanceUsage: ChatSettingsFields["performanceUsage"].volatile(),
+	linkOpening: ChatSettingsFields.linkOpening.volatile()
+});
+/** Host preferences are consumed through the configuration form projection.
+* @param ctx Plugin context used for optional settings presentation.
+*/
 function apply(ctx) {
-	ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.register(CHAT_SETTINGS_NAMESPACE, ChatSettingsSchema);
+	ctx.inject(["settings"], (child) => {
+		child.effect(() => child.settings.configure({ auto: false }, ctx.fiber));
 	});
 }
 //#endregion
-export { CHAT_SETTINGS_NAMESPACE, DEFAULT_TRANSCRIPT_VIEW_MODE, TRANSCRIPT_VIEW_FIELD, TRANSCRIPT_VIEW_MODES, apply };
+export { CHAT_SETTINGS_NAMESPACE, Config, DEFAULT_TRANSCRIPT_VIEW_MODE, LEGACY_TRANSCRIPT_VIEW_MODE, TRANSCRIPT_VIEW_FIELD, TRANSCRIPT_VIEW_MODES, apply };

package/lib/types/chat-settings.d.ts

@@ -1,20 +1,53 @@
-/** Chat transcript preferences stored in the Host user-settings document. */
+/** Chat display preferences stored in the Host user-settings document. */
 import z from '@deepseek-ai/schemastery';
 /** Settings namespace owned by the Chat target. */
 export declare const CHAT_SETTINGS_NAMESPACE = "ui-chat";
-/** Field carrying the completed-Turn transcript presentation mode. */
+/** Field carrying the work-details presentation mode. */
 export declare const TRANSCRIPT_VIEW_FIELD = "transcriptView";
-/** Transcript presentation modes accepted at settings boundaries. */
-export declare const TRANSCRIPT_VIEW_MODES: readonly ["normal", "compact"];
-/** Completed-Turn transcript presentation. */
+/** Work-details presentation modes a user can choose. */
+export declare const TRANSCRIPT_VIEW_MODES: readonly ["compact", "detailed", "expanded"];
+/** Work-details presentation mode. */
 export type TranscriptViewMode = typeof TRANSCRIPT_VIEW_MODES[number];
+/**
+ * Saved value from the two-mode generation of this setting. Read as `detailed`;
+ * never offered as a choice and never written back.
+ */
+export declare const LEGACY_TRANSCRIPT_VIEW_MODE = "normal";
 /** Default preserves the compact process disclosure introduced by Chat. */
 export declare const DEFAULT_TRANSCRIPT_VIEW_MODE: TranscriptViewMode;
+/** Performance and usage detail levels accepted by user settings. */
+export declare const PERFORMANCE_USAGE_MODES: readonly ["compact", "detailed"];
+/** Performance and usage presentation. */
+export type PerformanceUsageMode = typeof PERFORMANCE_USAGE_MODES[number];
+/** Preserve detailed accounting for users without an explicit preference. */
+export declare const DEFAULT_PERFORMANCE_USAGE: PerformanceUsageMode;
+/** Destinations for ordinary clicks on Chat HTTP(S) links. */
+export type LinkOpening = 'sidebar' | 'new-tab';
+/** Preserve the built-in browser for users without an explicit preference. */
+export declare const DEFAULT_LINK_OPENING: LinkOpening;
 /** Durable Chat section shared by the Host schema and browser scope. */
 export interface ChatSettings {
-    /** Presentation mode for completed Turn process content. */
-    transcriptView: TranscriptViewMode;
+    /** Work-details preference; the legacy value is accepted only from existing saved settings. */
+    transcriptView: TranscriptViewMode | typeof LEGACY_TRANSCRIPT_VIEW_MODE;
+    /** Detail level for composer statistics and completed-Turn usage. */
+    performanceUsage: PerformanceUsageMode;
+    /** Default destination for Chat HTTP(S) links. */
+    linkOpening: LinkOpening;
 }
 /** Durable Chat schema; also the wire envelope the browser scope validates against. */
-export declare const ChatSettingsSchema: z<ChatSettings>;
+export declare const ChatSettingsFields: {
+    linkOpening: z<"sidebar" | "new-tab", "sidebar" | "new-tab", "defined">;
+    performanceUsage: z<"compact" | "detailed", "compact" | "detailed", "defined">;
+    transcriptView: z<"compact" | "detailed" | "expanded" | "normal", "compact" | "detailed" | "expanded" | "normal", "defined">;
+};
+/** Schema for shared configuration values. */
+export declare const ChatSettingsSchema: z<Schemastery.ObjectS<NoInfer<{
+    linkOpening: z<"sidebar" | "new-tab", "sidebar" | "new-tab", "defined">;
+    performanceUsage: z<"compact" | "detailed", "compact" | "detailed", "defined">;
+    transcriptView: z<"compact" | "detailed" | "expanded" | "normal", "compact" | "detailed" | "expanded" | "normal", "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    linkOpening: z<"sidebar" | "new-tab", "sidebar" | "new-tab", "defined">;
+    performanceUsage: z<"compact" | "detailed", "compact" | "detailed", "defined">;
+    transcriptView: z<"compact" | "detailed" | "expanded" | "normal", "compact" | "detailed" | "expanded" | "normal", "defined">;
+}>>, "plain">;
 //# sourceMappingURL=chat-settings.d.ts.map

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

@@ -1,18 +1,19 @@
 import type { MarkdownFileMentions } from '@deepseek-ai/dsh-client-ui-primitives';
-import type { ChatNodeOwnerProps, ChatViewSlotProps } from '../contract/slots.ts';
+import type { ChatNodeOwnerProps, ChatViewSlotProps, UseDisclosure, UsePresentation } from '../contract/slots.ts';
 import type { AssistantBlock } from '../contract/snapshot.ts';
 /**
- * Map one authored media destination to the same-origin workspace-file URL.
- * @param protocol - `window.location.protocol` at render time.
- * @param origin - `window.location.origin` at render time.
- * @param value - The authored markdown destination, exactly as written.
- * @returns The API URL for an absolute POSIX path on an HTTP(S) page, or
- * undefined when the destination cannot be a Host-served local file
- * (non-HTTP transport such as Electron `file://`, protocol-relative or
- * relative destinations).
+ * Resolve an authored POSIX image path against the document's file API.
+ * @param base - canonical `document.baseURI` at render time.
+ * @param value - authored markdown destination.
+ * @returns an absolute HTTP(S) file-API URL, or undefined for unsupported
+ * protocols and non-local paths.
  */
-export declare function localPathMediaUrl(protocol: string, origin: string, value: string): string | undefined;
+export declare function localPathMediaUrl(base: string, value: string): string | undefined;
 export interface AssistantMarkdownProps {
+    /** Render only the requested business portion, preserving original block indexes. */
+    groupPart?: string | undefined;
+    /** Stable Hook forwarded to each independently expandable reasoning block. */
+    useDisclosure: UseDisclosure;
     blocks: readonly AssistantBlock[];
     streaming: boolean;
     /** Frozen partial of an aborted turn: rendered with a stopped marker. */
@@ -21,7 +22,9 @@ export interface AssistantMarkdownProps {
     renderMessageImages: ChatNodeOwnerProps['renderMessageImages'];
     /** Hide reasoning that belongs to the Turn-level process disclosure. */
     reasoningHidden?: boolean | undefined;
-    /** Reveal the owning Turn-level process disclosure. */
+    /** Live display policy for reasoning summaries. */
+    usePresentation: UsePresentation;
+    /** Reveal the disclosure that hides this reasoning. */
     revealProcess?: (() => void) | undefined;
     /** Resolved prose file mentions for this Assistant's closing turn. */
     mentions?: MarkdownFileMentions | undefined;
@@ -29,5 +32,5 @@ export interface AssistantMarkdownProps {
     t: ChatViewSlotProps['t'];
 }
 /** Reasoning block as the Think variant summary row (figma 39:28304). */
-export declare const AssistantMarkdown: import("react").MemoExoticComponent<({ blocks, streaming, interrupted, renderMessageImages, reasoningHidden, revealProcess, mentions, t, }: AssistantMarkdownProps) => import("react").JSX.Element | null>;
+export declare const AssistantMarkdown: import("react").MemoExoticComponent<({ blocks, streaming, interrupted, renderMessageImages, groupPart, useDisclosure, reasoningHidden, usePresentation, revealProcess, mentions, t, }: AssistantMarkdownProps) => import("react").JSX.Element | null>;
 //# sourceMappingURL=AssistantMarkdown.d.ts.map

package/lib/types/client/chat/AssistantNodeView.d.ts

@@ -1,4 +1,7 @@
-import type { ChatNodeViewProps } from '../contract/slots.ts';
+import type { InjectFace } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ChatNodeViewProps, PresentationInjected } from '../contract/slots.ts';
+type AssistantNodeViewProps = ChatNodeViewProps<'assistant-step'> & InjectFace<PresentationInjected>;
 /** Streaming, settled, and interrupted Assistant states share one keyed renderer instance. */
-export declare const AssistantNodeView: import("react").MemoExoticComponent<({ node, useTurnData, turnProcess, openFile, renderMessageImages, fileMentions, t, }: ChatNodeViewProps<"assistant-step">) => import("react").JSX.Element>;
+export declare const AssistantNodeView: import("react").MemoExoticComponent<({ node, groupPart, useDisclosure, useTurnData, turnProcess, openFile, renderMessageImages, fileMentions, usePresentation, t, }: AssistantNodeViewProps) => import("react").JSX.Element>;
+export {};
 //# sourceMappingURL=AssistantNodeView.d.ts.map

package/lib/types/client/chat/ChatGroupSeat.d.ts

@@ -0,0 +1,14 @@
+/** Stable process container; display policy changes visibility, never member parents. */
+import { type ComponentProps } from 'react';
+import type { GroupKey } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import type { ChatViewSlotProps } from '../contract/slots.ts';
+import { ChatNodeSeat } from './ChatNodeSeat.tsx';
+type SeatProps = Omit<ComponentProps<typeof ChatNodeSeat>, 'nodeKey' | 'groupPart'>;
+type ChatGroupSeatProps = SeatProps & {
+    readonly groupKey: GroupKey;
+    readonly useChatGroup: ChatViewSlotProps['useChatGroup'];
+};
+/** Render a process group with local disclosure and the existing outer-Turn visibility. */
+export declare const ChatGroupSeat: import("react").MemoExoticComponent<({ groupKey, useChatGroup, ...props }: ChatGroupSeatProps) => import("react").JSX.Element | null>;
+export {};
+//# sourceMappingURL=ChatGroupSeat.d.ts.map

package/lib/types/client/chat/ChatNodeSeat.d.ts

@@ -1,16 +1,22 @@
-import type { ChatNodeOwnerProps, ChatViewSlotProps } from '../contract/slots.ts';
+import type { ChatNodeOwnerProps, ChatViewSlotProps, UsePresentation } from '../contract/slots.ts';
+import type { ChatNodeStore } from '../contract/snapshot.ts';
 interface ChatNodeSeatProps extends ChatNodeOwnerProps {
     readonly nodeKey: string;
+    /** A replaced Builder must rebind keyed hooks even when references and keys survive. */
+    readonly nodeStore: ChatNodeStore;
     readonly useChatNode: ChatViewSlotProps['useChatNode'];
     readonly useChatNodeProcess: ChatViewSlotProps['useChatNodeProcess'];
-    readonly historyIncomplete: boolean;
-    readonly compactTranscript: boolean;
+    readonly usePresentation: UsePresentation;
     readonly useStore: ChatViewSlotProps['useStore'];
     readonly actions: ChatViewSlotProps['actions'];
     readonly renderSlot: ChatViewSlotProps['renderSlot'];
     readonly t: ChatViewSlotProps['t'];
 }
-/** Subscribe, apply Turn-process visibility, and dispatch one stable Context key. */
-export declare const ChatNodeSeat: import("react").MemoExoticComponent<({ nodeKey, useChatNode, useChatNodeProcess, historyIncomplete, compactTranscript, cwd, openFile, openSkill, inspectCall, forkAt, loadImage, renderMessageImages, fileMentions, useStore, actions, renderSlot, t, }: ChatNodeSeatProps) => import("react").JSX.Element | null>;
+/**
+ * Subscribe, apply Turn-process visibility, and dispatch one stable Context key.
+ * Policy reads select this seat's own conclusion, so a mode change re-renders
+ * only seats whose visibility actually changes.
+ */
+export declare const ChatNodeSeat: import("react").MemoExoticComponent<({ nodeKey, groupPart, useChatNode, useChatNodeProcess, usePresentation, cwd, openFile, openSkill, inspectCall, forkAt, loadImage, renderMessageImages, fileMentions, useStore, actions, renderSlot, t, }: ChatNodeSeatProps) => import("react").JSX.Element | null>;
 export {};
 //# sourceMappingURL=ChatNodeSeat.d.ts.map

package/lib/types/client/chat/ChatView.d.ts

@@ -3,5 +3,5 @@ import type { ChatViewSlotProps } from '../contract/slots.ts';
  * The chat view slot entry: pure component over the composed props; each
  * ordered business Node crosses the keyed renderer seat.
  */
-export declare function ChatView({ useSession, useChat, useChatNode, useChatNodeProcess, useSessions, useStore, actions, renderSlot, sessionId, openFile, openSkill, openExternalLink, loadOlder, loadThrough, loadImage, openView, chatScroll, forkAt, fileMentions, useTranscriptView, useProjection, t, }: ChatViewSlotProps): import("react").JSX.Element;
+export declare function ChatView({ useSession, useChat, useChatNode, useChatNodeProcess, useChatGroup, useConversation, useSessions, useStore, actions, renderSlot, sessionId, openFile, openSkill, openExternalLink, loadOlder, loadThrough, loadImage, inspectCall, chatScroll, forkAt, fileMentions, usePresentation, useProjection, t, }: ChatViewSlotProps): import("react").JSX.Element;
 //# sourceMappingURL=ChatView.d.ts.map

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

@@ -5,5 +5,10 @@ export interface GenericCommandCardProps extends CommandRowOwnerProps {
     /** 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;
+/**
+ * Render a command summary and its lazily mounted multiline output.
+ * @param props - command, locale, and optional running label.
+ * @returns the command disclosure.
+ */
+export declare const GenericCommandCard: import("react").MemoExoticComponent<({ node, t, runningSummary }: GenericCommandCardProps) => import("react").JSX.Element>;
 //# sourceMappingURL=GenericCommandCard.d.ts.map

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

@@ -1,16 +1,22 @@
-import type { ChatViewSlotProps } from '../contract/slots.ts';
+import type { ChatViewSlotProps, UseDisclosure, UsePresentation } from '../contract/slots.ts';
 /**
  * Render one assistant reasoning block collapsed until the reader opens it. The
  * collapsed summary omits double-asterisk markers; expanded content renders
- * the complete Markdown with secondary typography.
+ * the complete Markdown with secondary typography. A streaming preview advances
+ * when a paragraph's first line completes. Mode changes toggle CSS display without unmounting
+ * collapsed summaries.
  * @param props.text - complete or streaming reasoning text.
  * @param props.running - whether this block is the streaming tail.
+ * @param props.usePresentation - live display-policy selector for this reasoning row.
+ * @param props.useDisclosure - independent open state with enclosing-Turn resets.
  * @param props.t - conversation locale seat for status and Markdown actions.
  * @returns the reasoning disclosure.
  */
-export declare function ReasoningRow({ text, running, t }: {
+export declare const ReasoningRow: import("react").MemoExoticComponent<({ text, running, usePresentation, useDisclosure, t }: {
     text: string;
     running: boolean;
-    t: ChatViewSlotProps['t'];
-}): import("react").JSX.Element;
+    useDisclosure: UseDisclosure;
+    usePresentation: UsePresentation;
+    t: ChatViewSlotProps["t"];
+}) => import("react").JSX.Element>;
 //# sourceMappingURL=ReasoningRow.d.ts.map

package/lib/types/client/chat/StatsPills.d.ts

@@ -1,7 +1,7 @@
 import type { UseProjection } from '@deepseek-ai/dsh-api-session-controller/client';
-import type { SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { InjectFace, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
 import type { TokenUsageProjection } from '@deepseek-ai/dsh-token-meter/client';
-import type { ChatViewSlotProps } from '../contract/slots.ts';
+import type { ChatViewSlotProps, PerformanceUsageInjected } from '../contract/slots.ts';
 import type { ChatSnapshot } from '../contract/snapshot.ts';
 interface WindowStats {
     turns: number;
@@ -53,12 +53,12 @@ export declare function cacheHitPercent(usage: TokenUsageProjection): string | n
  */
 export declare function billedInputTokens(usage: TokenUsageProjection): number;
 /** Props: the conversation-snapshot selector plus the projection read seat. */
-export interface StatsPillsProps {
+export interface StatsPillsProps extends InjectFace<PerformanceUsageInjected> {
     useChat: SnapshotSelectorHook<ChatSnapshot>;
     useProjection: UseProjection;
     /** The owning dock's locale seat. */
     t: ChatViewSlotProps['t'];
 }
-export declare const StatsPills: import("react").MemoExoticComponent<({ useChat, useProjection, t }: StatsPillsProps) => import("react").JSX.Element | null>;
+export declare const StatsPills: import("react").MemoExoticComponent<({ useChat, useProjection, usePerformanceUsage, t }: StatsPillsProps) => import("react").JSX.Element | null>;
 export {};
 //# sourceMappingURL=StatsPills.d.ts.map

package/lib/types/client/chat/TurnNavigator.d.ts

@@ -8,19 +8,21 @@ interface TurnNavigatorProps {
     readonly onNavigate: (item: TurnRailItem) => void;
     readonly t: ChatViewSlotProps['t'];
 }
-declare function TurnNavigatorRail({ items, activeTurn, busyTurn, onNavigate, t }: TurnNavigatorProps): import("react").JSX.Element | null;
+/** Imperative controls for known turns; unknown turn numbers are ignored. */
+export interface TurnNavigatorHandle {
+    /** @param turn - turn to activate through the navigation callback. */
+    activateTurn(turn: number): void;
+    /** @param turn - turn to center in the rail without navigating the transcript. */
+    scrollToTurn(turn: number): void;
+}
 /**
  * Fixed-pitch rail of every known Turn — loaded marks scroll, unloaded marks
  * page history in first — with hover and focus previews. Overflow scrolls
  * inside the frame, gradient fades marking each scrollable end, and the
- * active mark keeps itself in view while the pointer is elsewhere.
- *
- * Memoized because it renders two host elements per Turn while the
- * enclosing view re-renders on every streaming delta: without the guard a long
- * session rebuilds hundreds of marks per commit for a rail that only changes
- * when a Turn is added, removed, or becomes active. Its props must therefore
- * stay referentially stable across those commits.
+ * active mark centers only outside the fade-free band while the pointer is
+ * elsewhere. Previews follow pointer movement or focus, not scrolling under
+ * a stationary pointer.
  */
-export declare const TurnNavigator: import("react").MemoExoticComponent<typeof TurnNavigatorRail>;
+export declare const TurnNavigator: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<TurnNavigatorProps & import("react").RefAttributes<TurnNavigatorHandle>>>;
 export {};
 //# sourceMappingURL=TurnNavigator.d.ts.map

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

@@ -1,7 +1,7 @@
-import type { PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';
-import type { ChatNodeViewProps } from '../contract/slots.ts';
-type TurnTailNodeViewProps = ChatNodeViewProps<'turn-tail'> & PropsRenderSlots<'conversation.chat.turnTail' | 'conversation.chat.assistant-actions'>;
+import type { InjectFace, PropsRenderSlots } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ChatNodeViewProps, PerformanceUsageInjected } from '../contract/slots.ts';
+type TurnTailNodeViewProps = ChatNodeViewProps<'turn-tail'> & PropsRenderSlots<'conversation.chat.turnTail' | 'conversation.chat.assistant-actions'> & InjectFace<PerformanceUsageInjected>;
 /** Turn-local actions and feature tail over the Location index, independent of Assistant placement. */
-export declare const TurnTailNodeView: import("react").MemoExoticComponent<({ node, openFile, forkAt, renderSlot, t, useChat, }: TurnTailNodeViewProps) => import("react").JSX.Element | null>;
+export declare const TurnTailNodeView: import("react").MemoExoticComponent<({ node, openFile, forkAt, renderSlot, t, useChat, usePerformanceUsage, }: TurnTailNodeViewProps) => import("react").JSX.Element | null>;
 export {};
 //# sourceMappingURL=TurnTailNodeView.d.ts.map

package/lib/types/client/chat/TurnTriggerNodeView.d.ts

@@ -0,0 +1,4 @@
+import type { ChatNodeViewProps } from '../contract/slots.ts';
+/** Render recorded trigger attribution above the whole-Turn disclosure. */
+export declare function TurnTriggerNodeView({ node, t }: Pick<ChatNodeViewProps<'turn-trigger'>, 'node' | 't'>): import("react").JSX.Element;
+//# sourceMappingURL=TurnTriggerNodeView.d.ts.map

package/lib/types/client/chat/TurnUsagePanel.d.ts

@@ -1,3 +1,4 @@
+/** Completed-Turn token usage action and its accounting details dialog. */
 import type { TurnTokenUsage } from '../contract/chat-nodes.ts';
 import type { ChatViewSlotProps } from '../contract/slots.ts';
 export interface TurnUsagePanelProps {
@@ -5,26 +6,10 @@ export interface TurnUsagePanelProps {
     /** The owning view's locale seat, passed down as a plain prop. */
     t: ChatViewSlotProps['t'];
 }
-export interface TurnTimePanelProps {
-    /** Turn wall time in ms, the pill's label. */
-    runMs: number;
-    /** Turn decode throughput, a dialog row when known. */
-    tokensPerSecond?: number | undefined;
-    /** Turn first-step TTFT in ms, a dialog row when known. */
-    ttftMs?: number | undefined;
-    /** The owning view's locale seat, passed down as a plain prop. */
-    t: ChatViewSlotProps['t'];
-}
 /**
  * Turn-usage IconActions pill with a click-open Turn-usage details dialog.
  * @param props - Turn usage buckets and locale seat.
  * @returns The trigger and, while open, its portaled dialog anchored above the trigger.
  */
 export declare function TurnUsagePanel({ usage, t }: TurnUsagePanelProps): import("react").JSX.Element;
-/**
- * Turn-time IconActions pill with a click-open Turn-time details dialog.
- * @param props - Turn timing facts and locale seat.
- * @returns The clock-and-duration trigger and, while open, its portaled dialog anchored above the trigger.
- */
-export declare function TurnTimePanel({ runMs, tokensPerSecond, ttftMs, t }: TurnTimePanelProps): import("react").JSX.Element;
 //# sourceMappingURL=TurnUsagePanel.d.ts.map

package/lib/types/client/chat/message-chrome.d.ts

@@ -3,6 +3,8 @@ import type { Translate } from '@deepseek-ai/dsh-client-ui-slots';
 export type ClockTranslate = Translate<'clock.md' | 'clock.ymd'>;
 /** The elapsed-duration share of the conversation dictionary. */
 export type RunDurationTranslate = Translate<'duration.seconds' | 'duration.minutes' | 'duration.hours'>;
+/** Refresh interval for whole-second live run clocks. */
+export declare const LIVE_RUN_CLOCK_INTERVAL_MS = 1000;
 /**
  * Local calendar-day epoch (ms at local midnight) for an instant.
  * @param ms - Unix epoch ms.
@@ -16,7 +18,7 @@ export declare function startOfLocalDay(ms: number): number;
  */
 export declare function msUntilNextLocalMidnight(ms: number): number;
 /**
- * Localized elapsed-time label shared by running and settled turn chrome.
+ * Localized elapsed-time label for the running conversation clock.
  * @param ms - Elapsed duration in milliseconds (negatives clamp to zero).
  * @param t - Translate seat supplying the duration templates.
  * @returns Display string in whole seconds; minutes and seconds once the
@@ -25,12 +27,13 @@ export declare function msUntilNextLocalMidnight(ms: number): number;
  */
 export declare function formatRunDuration(ms: number, t: RunDurationTranslate): string;
 /**
- * Sub-turn latency figure: one decimal under ten seconds, whole seconds
- * beyond. Unit-less so the locale template owns the second suffix.
- * @param ms - Latency in milliseconds (negatives clamp to zero).
- * @returns Display number in seconds without unit.
+ * Localized live elapsed time without padded seconds or early rollover.
+ * @param ms - Elapsed duration in milliseconds (negatives clamp to zero).
+ * @param t - Translate seat supplying the duration templates.
+ * @returns Whole seconds without a leading zero; minutes start at 60 seconds
+ * and hours start at exactly 60 minutes.
  */
-export declare function formatLatencySeconds(ms: number): string;
+export declare function formatLiveRunDuration(ms: number, t: RunDurationTranslate): string;
 /**
  * Decode-throughput figure: whole tokens from ten up, one decimal below.
  * @param tps - Tokens per second.

package/lib/types/client/chat/register-node-renderers.d.ts

@@ -1,7 +1,14 @@
 import type { Context } from '@deepseek-ai/cordis';
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { PerformanceUsageMode } from '../../chat-settings.ts';
+import type { ChatPresentationPolicy } from '../presentation-policy.ts';
 /**
  * Register this package's business renderers behind the keyed Chat Node seat.
+ * Renderers whose output depends on the work-details mode receive the policy
+ * through their own registration; the seat and the other renderers do not.
  * @param ctx - owning UI Conversation context.
+ * @param performanceUsage - live statistics detail preference.
+ * @param presentation - live presentation policy.
  */
-export declare function registerChatNodeRenderers(ctx: Context): void;
+export declare function registerChatNodeRenderers(ctx: Context, performanceUsage: ObservableSnapshot<PerformanceUsageMode>, presentation: ObservableSnapshot<ChatPresentationPolicy>): void;
 //# sourceMappingURL=register-node-renderers.d.ts.map

package/lib/types/client/chat/render-entry.d.ts

@@ -0,0 +1,9 @@
+/** Stable React identities for the two grouping reference kinds. */
+import type { RenderEntry } from '@deepseek-ai/dsh-client-ui-conversation/client';
+/**
+ * Identify a rendering position independently of presentation mode.
+ * @param entry - mode-independent rendering reference.
+ * @returns its collision-free React key.
+ */
+export declare function chatRenderKey(entry: RenderEntry): string;
+//# sourceMappingURL=render-entry.d.ts.map

package/lib/types/client/chat/step-process.d.ts

@@ -0,0 +1,11 @@
+/** Localized titles for projected step-process activity. */
+import type { ChatViewSlotProps } from '../contract/slots.ts';
+import type { ProcessActivitySummary } from '../contract/process-groups.ts';
+/**
+ * Compose a closed group's localized title from its top three categories without counts.
+ * @param summary - ranked work and phase evidence for this range.
+ * @param t - Chat namespace translator.
+ * @returns the secondary disclosure title.
+ */
+export declare function processTitle(summary: ProcessActivitySummary, t: ChatViewSlotProps['t']): string;
+//# sourceMappingURL=step-process.d.ts.map

package/lib/types/client/chat/turn-trigger.d.ts

@@ -0,0 +1,15 @@
+/** Presentation of durable non-human messages claimed to begin a Turn. */
+import type { ContextMessageNode } from '../contract/snapshot.ts';
+import type { ChatKey } from '../locale.ts';
+/** Existing primitive glyph selected for a Turn trigger's source family. */
+export type TurnTriggerIcon = 'agent' | 'github' | 'goal' | 'job' | 'plugin' | 'request' | 'schedule' | 'subagent' | 'team' | 'webhook';
+/**
+ * Describe a waking message using its source and recognized producer framing.
+ * @param node - durable context, including the original notification body.
+ * @returns localized title key and source-family icon.
+ */
+export declare function turnTriggerDetails(node: ContextMessageNode): {
+    title: ChatKey;
+    icon: TurnTriggerIcon;
+};
+//# sourceMappingURL=turn-trigger.d.ts.map

package/lib/types/client/chat/use-chat-navigation.d.ts

@@ -0,0 +1,69 @@
+import type { ChatNode } from '../contract/chat-nodes.ts';
+import type { ChatViewSlotProps } from '../contract/slots.ts';
+import type { TurnRailItem } from './turn-rail-items.ts';
+import type { ChatReading, ReadingSample } from './use-chat-reading.ts';
+import type { ChatViewport } from './use-chat-viewport.ts';
+/** History availability and loading operations for the committed Chat window. */
+export interface ChatNavigationInput extends Pick<ChatViewSlotProps, 'loadOlder' | 'loadThrough'> {
+    readonly firstSeq: ChatNode['anchorSeq'] | null;
+    readonly hasMore: boolean;
+    readonly loadingOlder: boolean;
+}
+/** Owns one replaceable turn jump and the anchor retained while history loads. */
+export declare class ChatNavigation {
+    private readonly viewport;
+    private readonly reading;
+    private input;
+    private readonly onBusyTurn;
+    private jump;
+    private settleFrame;
+    constructor(viewport: ChatViewport, reading: ChatReading, input: ChatNavigationInput, onBusyTurn: (turn: number | null) => void);
+    /**
+     * Adopt committed history availability without starting a request.
+     * @param input - history state from the latest committed render.
+     */
+    setInput(input: ChatNavigationInput): void;
+    /** Cancel navigation when opening a Chat view. */
+    reset(): void;
+    /** Cancel local callbacks; late history completions cannot revive a task. */
+    dispose(): void;
+    /** Release the jump, paging anchor, and busy indicator without cancelling shared history I/O. */
+    cancel(): void;
+    private clearTask;
+    /**
+     * Replace the current jump with an explicit turn selection.
+     * @param item - loaded anchor or unloaded turn to fetch before landing.
+     */
+    readonly navigateToTurn: (item: TurnRailItem) => void;
+    /** Request one older page while retaining the current semantic position. */
+    readonly loadEarlier: () => void;
+    /**
+     * Preserve reader ownership across pending history work.
+     * @param sample - settled reader movement that can update or interrupt an anchor.
+     */
+    readerSampled(sample: ReadingSample): void;
+    /**
+     * Preserve one paging anchor after a commit or a later size change, regardless of head identity.
+     * @returns whether the retained anchor handled the layout change.
+     */
+    contentCommitted(): boolean;
+    /** Retarget a still-loading page only after inner or outer reader scrolling ends. */
+    readerSettled(): void;
+    /** Land, retry, or complete the current jump against the committed window. */
+    reconcile(): void;
+    private landJump;
+    private request;
+    private cancelFrame;
+}
+/**
+ * Retain one navigation owner for the component's lifetime.
+ * @param viewport - turn-aware DOM operations.
+ * @param reading - reading and follow policy receiving navigation landings.
+ * @param input - committed history state and load operations.
+ * @returns the navigation owner and its visible busy turn.
+ */
+export declare function useChatNavigation(viewport: ChatViewport, reading: ChatReading, input: ChatNavigationInput): {
+    navigation: ChatNavigation;
+    busyTurn: number | null;
+};
+//# sourceMappingURL=use-chat-navigation.d.ts.map