@prettier-ai/dsh-client-ui-chat 0.1.2-alpha.1 → 0.1.2-alpha.3

package/lib/index.js

@@ -1,4 +1,3 @@
-import { settingsNamespace } from "@prettier-ai/dsh-settings";
 import z from "@prettier-ai/schemastery";
 //#region lib/types/chat-settings.js
 /** Chat transcript preferences stored in the Host user-settings document. */
@@ -18,7 +17,7 @@ const ChatSettingsSchema = z.object({ [TRANSCRIPT_VIEW_FIELD]: z.union([...TRANS
 /** Register the durable Chat settings section when a provider exists. */
 function apply(ctx) {
 	ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.register(settingsNamespace(CHAT_SETTINGS_NAMESPACE), ChatSettingsSchema);
+		settingsCtx.settings.register(CHAT_SETTINGS_NAMESPACE, ChatSettingsSchema);
 	});
 }
 //#endregion

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, useSessions, useStore, actions, renderSlot, sessionId, openFile, loadOlder, loadImage, openView, chatScroll, forkAt, fileMentions, useTranscriptView, t, }: ChatViewSlotProps): import("react").JSX.Element;
+export declare function ChatView({ useSession, useChat, useSessions, useStore, actions, renderSlot, sessionId, openFile, loadOlder, loadThrough, loadImage, openView, chatScroll, forkAt, fileMentions, useTranscriptView, useProjection, t, }: ChatViewSlotProps): import("react").JSX.Element;
 //# sourceMappingURL=ChatView.d.ts.map

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

@@ -5,12 +5,6 @@ export interface MessageIconActionsProps {
     text: string;
     /** Unix epoch ms for the clock label; omitted for transient messages. */
     time?: number | undefined;
-    /** Turn wall time in ms, appended to the clock as `· Ran for 15s`; omitted when the turn's start is unknown. */
-    runMs?: number | undefined;
-    /** Turn first-step TTFT in ms, appended as `· TTFT 1.2s`; omitted when unrecorded. */
-    ttftMs?: number | undefined;
-    /** Turn decode throughput, appended as `· 34 tok/s`; omitted when unrecorded. */
-    tokensPerSecond?: number | undefined;
     /** Clock before icons (user) or after (assistant). */
     clock: 'start' | 'end';
     /** Fork the session at this message; omission hides the branch action. */
@@ -24,6 +18,11 @@ export interface MessageIconActionsProps {
      * built-in copy and branch controls.
      */
     extraActions?: ReactNode;
+    /**
+     * Icon-row Turn-usage trigger (the TurnUsagePanel pill), seated after the
+     * branch control at the end of the icon cluster.
+     */
+    usageAction?: ReactNode;
     /** The owning view's locale seat, passed down as a plain prop. */
     t: ChatViewSlotProps['t'];
 }
@@ -32,5 +31,5 @@ export interface MessageIconActionsProps {
  * @param props - Copy text, event time, clock side, branch callback, className.
  * @returns The actions row element.
  */
-export declare function MessageIconActions({ text, time, runMs, ttftMs, tokensPerSecond, clock, onBranch, branchUnavailable, className, extraActions, t, }: MessageIconActionsProps): import("react").JSX.Element;
+export declare function MessageIconActions({ text, time, clock, onBranch, branchUnavailable, className, extraActions, usageAction, t, }: MessageIconActionsProps): import("react").JSX.Element;
 //# sourceMappingURL=MessageIconActions.d.ts.map

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

@@ -13,10 +13,10 @@ export declare function PendingSteeringBubble({ content, renderMessageImages, t
     t: ChatViewSlotProps['t'];
 }): ReactNode;
 /**
- * Render one local submission echo with the exact visual language of the
- * durable user node that replaces it: draft text plus object-URL previews,
- * visible from the submit click until the durable `user/message` (or its
- * queue occurrence) renders.
+ * Render one local transcript or steering submission echo with the same
+ * visual language and surface marker as the Host occurrence that replaces
+ * it: draft text plus object-URL previews, visible from the submit click
+ * until the durable `user/message` or steering occurrence renders.
  * @param props - the session snapshot's pending submission and render seats.
  * @returns the echoed user bubble.
  */
@@ -26,7 +26,7 @@ export declare function PendingSubmissionBubble({ submission, renderMessageImage
     t: ChatViewSlotProps['t'];
 }): ReactNode;
 /** User and admitted-steering keyed Chat renderer. */
-export declare const UserMessageNodeView: import("react").MemoExoticComponent<({ node, renderMessageImages, t, }: ChatNodeViewProps<"user" | "steering">) => import("react").JSX.Element>;
+export declare const UserMessageNodeView: import("react").MemoExoticComponent<({ node, renderMessageImages, useChat, t, }: ChatNodeViewProps<"user" | "steering">) => import("react").JSX.Element>;
 /** Injected-context keyed Chat renderer. */
 export declare const ContextMessageNodeView: import("react").MemoExoticComponent<({ node, t }: ChatNodeViewProps<"context">) => import("react").JSX.Element>;
 /** Automatic compaction keyed Chat renderer. */

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

@@ -1,16 +1,21 @@
 import type { ChatViewSlotProps } from '../contract/slots.ts';
-import type { TurnNavigationItem } from '../contract/snapshot.ts';
+import type { TurnRailItem } from './turn-rail-items.ts';
 interface TurnNavigatorProps {
-    readonly items: readonly TurnNavigationItem[];
+    readonly items: readonly TurnRailItem[];
     readonly activeTurn: number | null;
-    readonly onNavigate: (item: TurnNavigationItem) => void;
+    /** Turn whose jump is still paging history in; its mark pulses. */
+    readonly busyTurn: number | null;
+    readonly onNavigate: (item: TurnRailItem) => void;
     readonly t: ChatViewSlotProps['t'];
 }
-declare function TurnNavigatorRail({ items, activeTurn, onNavigate, t }: TurnNavigatorProps): import("react").JSX.Element | null;
+declare function TurnNavigatorRail({ items, activeTurn, busyTurn, onNavigate, t }: TurnNavigatorProps): import("react").JSX.Element | null;
 /**
- * Compact rail of the currently loaded Turns with hover and focus previews.
+ * 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 loaded Turn while the
+ * 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

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

@@ -0,0 +1,30 @@
+import type { TurnTokenUsage } from '../contract/chat-nodes.ts';
+import type { ChatViewSlotProps } from '../contract/slots.ts';
+export interface TurnUsagePanelProps {
+    usage: TurnTokenUsage;
+    /** 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/turn-rail-items.d.ts

@@ -0,0 +1,36 @@
+/**
+ * View-layer union of the host turn outline and the loaded rail items. The
+ * conversation snapshot never carries projection values, so this merge is the
+ * one place the rail's two sources meet: the `turnOutline` projection names
+ * every turn of the session, and the loaded window supplies anchors and
+ * richer previews for the turns it holds.
+ */
+import type { TurnNavigationItem } from '../contract/snapshot.ts';
+/** One rail mark: a loaded Turn scrolls to its row; an unloaded one pages history through its seq first. */
+export interface TurnRailItem {
+    readonly turn: number;
+    /** Bounded prompt preview (loaded window first, outline fallback). */
+    readonly prompt: string;
+    /** Bounded response preview (loaded window first, outline fallback). */
+    readonly response: string;
+    /** How the rail reaches the Turn. */
+    readonly anchor: {
+        readonly kind: 'loaded';
+        readonly key: string;
+    } | {
+        readonly kind: 'unloaded';
+        readonly seq: number;
+    };
+}
+/**
+ * Merge the host outline with the loaded rail items into the full ladder.
+ * A turn present in both sides keeps the loaded anchor, taking an outline
+ * preview only where the window's own is empty (a mid-Turn window head, or a
+ * turn whose loaded nodes carry no text); turns on one side only pass
+ * through. Result ascends by turn.
+ * @param loaded - loaded-window rail items (timeline order).
+ * @param outline - `turnOutline` projection value, treated as wire data.
+ * @returns every known turn, ascending; a stable empty array when none.
+ */
+export declare function mergeTurnRailItems(loaded: readonly TurnNavigationItem[], outline: unknown): readonly TurnRailItem[];
+//# sourceMappingURL=turn-rail-items.d.ts.map

package/lib/types/client/contract/slots.d.ts

@@ -95,6 +95,8 @@ export interface ChatViewInjected {
     openDetails: (target: SelectionTarget) => void;
     openFile: (path: string) => Promise<void>;
     loadOlder: () => void;
+    /** Jump loader: page history back through seq; resolves when the window covers it. */
+    loadThrough: (seq: number) => Promise<void>;
     loadImage: MessageImageLoader;
     chatScroll: {
         save: (position: ChatScrollPosition | null) => void;

package/lib/types/client/conversation-nodes/inbox.d.ts

@@ -1,19 +1,28 @@
 import type { Context } from '@prettier-ai/cordis';
 import type { ConversationNodeDefinition } from '@prettier-ai/dsh-client-ui-conversation/client';
-interface InboxIdentity {
-    readonly id: string;
+interface PendingSnapshot {
+    readonly kind: 'snapshot';
+    readonly ids: readonly string[];
 }
-/** Cumulative state after one durable inbox splice. */
+interface PendingSplice {
+    readonly kind: 'splice';
+    readonly previous: PendingState;
+    readonly start: number;
+    readonly removedCount: number;
+    readonly inserted: readonly string[];
+}
+type PendingState = PendingSnapshot | PendingSplice;
+/** Persistent next-step state after one durable Inbox splice. */
 export interface InboxState {
-    readonly pending: readonly InboxIdentity[];
-    readonly claimed: ReadonlySet<string>;
+    /** Persistent splice chain materialized only when a next-step batch is claimed. */
+    readonly pending: PendingState;
+    /** Message ids in the current claim, shared until the next claim. */
+    readonly currentClaimed: ReadonlySet<string>;
 }
-/** Cumulative next-turn inbox splice Definition. */
-export declare const nextTurnInboxDefinition: ConversationNodeDefinition<InboxState>;
-/** Cumulative next-step inbox splice Definition used to classify steering. */
+/** Persistent next-step Inbox state used to classify the current claimed batch as steering. */
 export declare const nextStepInboxDefinition: ConversationNodeDefinition<InboxState>;
 /**
- * Register the two durable Inbox-state contributions.
+ * Register the next-step Inbox state used by Chat message classification.
  * @param ctx - owning UI Conversation context.
  */
 export declare function registerInboxConversationNodes(ctx: Context): void;

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

@@ -29,6 +29,7 @@ export declare const zh: {
     'chat.deepDiving': string;
     'chat.turnNavigation.label': string;
     'chat.turnNavigation.jump': string;
+    'chat.turnNavigation.jumpLoad': string;
     'chat.turnNavigation.turn': string;
     'settings.transcript.title': string;
     'settings.transcript.description': string;
@@ -86,18 +87,21 @@ export declare const zh: {
     'message.maxTokens': string;
     'message.maxTokens.hint': string;
     'message.ranFor': string;
-    'message.ttft': string;
     'message.tokensPerSecond': string;
     'message.turnUsage.title': string;
-    'message.turnUsage.summaryWithCache': string;
+    'message.turnUsage.consumed': string;
     'message.turnUsage.model': string;
+    'message.turnUsage.cacheHit': string;
     'message.turnUsage.input': string;
     'message.turnUsage.cacheRead': string;
     'message.turnUsage.cacheWrite': string;
     'message.turnUsage.output': string;
     'message.turnUsage.reasoning': string;
-    'message.turnUsage.total': string;
     'message.turnUsage.count': string;
+    'message.turnTime.title': string;
+    'message.turnTime.duration': string;
+    'message.turnTime.speed': string;
+    'message.turnTime.ttft': string;
     'duration.seconds': string;
     'duration.minutes': string;
     'command.running': string;
@@ -140,6 +144,7 @@ export declare const en: {
     'chat.deepDiving': string;
     'chat.turnNavigation.label': string;
     'chat.turnNavigation.jump': string;
+    'chat.turnNavigation.jumpLoad': string;
     'chat.turnNavigation.turn': string;
     'settings.transcript.title': string;
     'settings.transcript.description': string;
@@ -197,18 +202,21 @@ export declare const en: {
     'message.maxTokens': string;
     'message.maxTokens.hint': string;
     'message.ranFor': string;
-    'message.ttft': string;
     'message.tokensPerSecond': string;
     'message.turnUsage.title': string;
-    'message.turnUsage.summaryWithCache': string;
+    'message.turnUsage.consumed': string;
     'message.turnUsage.model': string;
+    'message.turnUsage.cacheHit': string;
     'message.turnUsage.input': string;
     'message.turnUsage.cacheRead': string;
     'message.turnUsage.cacheWrite': string;
     'message.turnUsage.output': string;
     'message.turnUsage.reasoning': string;
-    'message.turnUsage.total': string;
     'message.turnUsage.count': string;
+    'message.turnTime.title': string;
+    'message.turnTime.duration': string;
+    'message.turnTime.speed': string;
+    'message.turnTime.ttft': string;
     'duration.seconds': string;
     'duration.minutes': string;
     'command.running': string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prettier-ai/dsh-client-ui-chat",
   "description": "Chat Conversation target, node definitions, renderers, and details surface",
-  "version": "0.1.2-alpha.1",
+  "version": "0.1.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -47,66 +47,45 @@
   },
   "license": "MIT",
   "peerDependencies": {
-    "@prettier-ai/cordis": "^4.0.1",
-    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-agent": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-attachment": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-approval": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-workspace": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-compaction": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-commands": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-llm": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-llm-retry": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-layout": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-settings": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-session-stats": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-tools": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-token-meter": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.1"
+    "@prettier-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",
-    "@prettier-ai/cordis": "^4.0.1",
-    "@prettier-ai/dsh-agent": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-attachment": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-approval": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-layout": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-workspace": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-commands": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-compaction": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-llm": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-llm-retry": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-session-stats": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-settings": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-token-meter": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-tools": "^0.1.2-alpha.1",
-    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.1"
+    "react-dom": "^18.2.0",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.3",
+    "@prettier-ai/cordis": "^4.0.2",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-agent": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-api-workspace-controller": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-attachment": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-approval": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-store": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-layout": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-workspace": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-client-ui-settings": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-commands": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-compaction": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-llm-retry": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-llm": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-session-stats": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-session-turn-outline": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-token-meter": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-util-workspace-path": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-settings": "^0.1.2-alpha.3",
+    "@prettier-ai/dsh-tools": "^0.1.2-alpha.3"
   },
   "dependencies": {
-    "@prettier-ai/schemastery": "^3.18.1"
+    "@prettier-ai/schemastery": "^3.18.2"
   },
   "files": [
     "lib/index.js",

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

@@ -1,9 +0,0 @@
-import type { TurnTokenUsage } from '../contract/chat-nodes.ts';
-import type { ChatViewSlotProps } from '../contract/slots.ts';
-export interface TurnUsageDisclosureProps {
-    usage: TurnTokenUsage;
-    t: ChatViewSlotProps['t'];
-}
-/** Compact per-Turn usage summary with an opt-in bucket breakdown. */
-export declare function TurnUsageDisclosure({ usage, t }: TurnUsageDisclosureProps): import("react").JSX.Element;
-//# sourceMappingURL=TurnUsageDisclosure.d.ts.map