@qilin-agent/client-ui-chat 3.1.3 → 3.1.4

package/lib/types/client/presentation-policy.d.ts

@@ -1,14 +1,16 @@
-/**
- * Runtime vocabulary derived from the persisted work-details mode. Renderers
- * and seats select single fields of this policy; none of them compares the
- * mode enum, so adding a mode changes only the table below.
- */
+/** Chat presentation derived from Host-backed detail and in-memory collapse timing. */
 import type { ObservableSnapshot } from '@qilin-agent/client-store';
 import type { TranscriptViewMode } from '../chat-settings.ts';
+/** Available points when a completed Turn returns to its historical presentation. */
+export declare const COLLAPSE_TIMINGS: readonly ["completion", "next-input"];
+/** When a completed Turn returns to its historical presentation. */
+export type CollapseTiming = typeof COLLAPSE_TIMINGS[number];
 /** Presentation capabilities that one work-details mode enables. */
 export interface ChatPresentationPolicy {
-    /** Mode this policy was derived from; for diagnostics, never for branching in renderers. */
+    /** Preference identity for layout resets and diagnostics; renderers select the capabilities below. */
     readonly mode: TranscriptViewMode;
+    /** Browser-local experiment; completion retains the default immediate folding and scrolling. */
+    readonly collapseTiming: CollapseTiming;
     /** Whether a normally completed Turn folds its process rows behind the whole-Turn control. */
     readonly foldCompletedTurns: boolean;
     /** Collapsible group headers for all Turns, historical Turns only, or no Turns. */
@@ -19,17 +21,17 @@ export interface ChatPresentationPolicy {
     readonly settledReasoningPreview: boolean;
 }
 /**
- * Resolve the policy constant for one mode. The same mode always yields the
- * same object, so selectors over a policy see stable identities.
+ * Resolve a stable policy for one detail mode and collapse timing.
  * @param mode - persisted work-details mode.
- * @returns the mode's presentation policy.
+ * @param collapseTiming - in-memory timing; defaults to immediate completion folding.
+ * @returns the same policy object for the same pair of choices.
  */
-export declare function presentationPolicyFor(mode: TranscriptViewMode): ChatPresentationPolicy;
+export declare function presentationPolicyFor(mode: TranscriptViewMode, collapseTiming?: CollapseTiming): ChatPresentationPolicy;
 /**
- * Derive a policy observable from the mode observable without a subscription of
- * its own: reads are a table lookup and change notifications are the mode's.
+ * Combine Host-backed detail and in-memory timing without owning subscriptions.
  * @param mode - live work-details mode.
- * @returns observable policy that changes exactly when the mode changes.
+ * @param collapseTiming - live, in-memory collapse timing.
+ * @returns observable policy whose subscriptions follow both preferences.
  */
-export declare function derivePresentationPolicy(mode: ObservableSnapshot<TranscriptViewMode>): ObservableSnapshot<ChatPresentationPolicy>;
+export declare function derivePresentationPolicy(mode: ObservableSnapshot<TranscriptViewMode>, collapseTiming: ObservableSnapshot<CollapseTiming>): ObservableSnapshot<ChatPresentationPolicy>;
 //# sourceMappingURL=presentation-policy.d.ts.map

package/lib/types/client/settings/TranscriptViewRow.d.ts

@@ -2,21 +2,26 @@
 import type { SnapshotStore } from '@qilin-agent/client-store';
 import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
 import { type TranscriptViewMode } from '../../chat-settings.ts';
+import type { CollapseTiming } from '../presentation-policy.ts';
 /** Registration-side work-details preference face. */
 export interface TranscriptViewRowInjected {
     hooks: {
         /** Persisted work-details preference bound as useTranscriptView. */
         transcriptView: SnapshotStore<TranscriptViewMode>;
+        /** Browser-local timing bound as useCollapseTiming. */
+        collapseTiming: SnapshotStore<CollapseTiming>;
     };
     /** Change the work-details presentation. */
     setTranscriptView: (mode: TranscriptViewMode) => void;
+    /** Save collapse timing in this browser without changing Host settings. */
+    setCollapseTiming: (timing: CollapseTiming) => void;
 }
 /** Full Settings-row props. */
 export type TranscriptViewRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'chat'> & InjectFace<TranscriptViewRowInjected>;
 /**
- * Render the work-details mode selector.
+ * Render work-details and browser-local collapse-timing selectors.
  * @param props - composed Settings slot props.
  * @returns the preference row.
  */
-export declare function TranscriptViewRow({ useTranscriptView, setTranscriptView, t }: TranscriptViewRowProps): import("react").JSX.Element;
+export declare function TranscriptViewRow({ useTranscriptView, setTranscriptView, useCollapseTiming, setCollapseTiming, t, }: TranscriptViewRowProps): import("react").JSX.Element;
 //# sourceMappingURL=TranscriptViewRow.d.ts.map

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

@@ -1,16 +1,26 @@
 /** Per-Session Chat view store. */
 import { type EngineStoreHandle } from '@qilin-agent/client-store';
 import type { ChatStoreState, TurnProcessViewEntry } from './contract/store.ts';
+import type { TurnProcessSpec } from './contract/turn-process.ts';
 type ChatActions = {
     setTurnProcessOpen: (draft: ChatStoreState, turn: number, answerStep: number, open: boolean) => void;
 };
 /**
- * Resolve the manually expanded answer for one Turn.
+ * Resolve the manual disclosure choice for one Turn.
  * @param state - Chat store snapshot.
  * @param turn - owning Turn.
  * @returns the Turn's stored entry, when present.
  */
 export declare function storedTurnProcessEntry(state: Readonly<ChatStoreState>, turn: number): Readonly<TurnProcessViewEntry> | undefined;
+/**
+ * Whether a foldable Turn's process is open: the reader's choice for the current answer generation
+ * wins; otherwise the latest completed Turn stays open until the next input, and older Turns fold.
+ * @param state - Chat store snapshot.
+ * @param spec - the Turn's process specification.
+ * @param defaultOpen - whether this Turn is exempt from automatic folding.
+ * @returns the effective open state.
+ */
+export declare function turnProcessOpen(state: Readonly<ChatStoreState>, spec: Pick<TurnProcessSpec, 'turn' | 'answerStep'>, defaultOpen: boolean): boolean;
 /**
  * Create the Chat view store handle.
  * @returns a handle instantiated once per rendered Session scope.

package/lib/types/client/transcript-view.d.ts

@@ -1,17 +1,22 @@
-/** Host-backed work-details presentation policy. */
+/** Host-backed work details and independent, in-memory collapse timing. */
 import { type SnapshotStore } from '@qilin-agent/client-store';
 import type { ConfigForm } from '@qilin-agent/client-ui-settings/client';
+import type { CollapseTiming } from './presentation-policy.ts';
 import { type ChatSettings, type TranscriptViewMode } from '../chat-settings.ts';
 /** Live work-details preference consumed by Chat and its Settings row. */
 export declare class TranscriptViewPolicy {
     private readonly host;
+    private readonly defaultMode;
     private readonly unsubscribe;
-    /** Reactive current mode; defaults to Standard before Host settings arrive. */
+    /** Reactive current mode, including the client default before Host settings arrive. */
     readonly mode: SnapshotStore<TranscriptViewMode>;
+    /** Independent Client-lifetime choice; each new instance starts with completion-time folding. */
+    readonly collapseTiming: SnapshotStore<CollapseTiming>;
     /**
      * @param host - durable Chat settings scope.
+     * @param defaultMode - presentation used without an explicit saved mode.
      */
-    constructor(host: ConfigForm<ChatSettings>);
+    constructor(host: ConfigForm<ChatSettings>, defaultMode?: TranscriptViewMode);
     /** Release the accepted-value subscription. */
     dispose(): void;
     /**
@@ -19,6 +24,11 @@ export declare class TranscriptViewPolicy {
      * @param mode - Compact, Standard, Detailed, or Verbose work details.
      */
     setMode(mode: TranscriptViewMode): void;
+    /**
+     * Keep collapse timing in memory without writing Host or browser storage.
+     * @param timing - immediate completion folding or deferred folding at the next input.
+     */
+    setCollapseTiming(timing: CollapseTiming): void;
     /** Adopt the latest accepted Host section without writing it back. */
     private adopt;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-chat",
   "description": "Chat Conversation target, node definitions, renderers, and details surface",
-  "version": "3.1.3",
+  "version": "3.1.4",
   "publishConfig": {
     "access": "public"
   },
@@ -56,43 +56,43 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "@tanstack/react-virtual": "^3.14.9",
-    "@qilin-agent/api-remotes": "3.1.3",
-    "@qilin-agent/api-session-controller": "3.1.3",
     "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/api-workspace-controller": "3.1.3",
-    "@qilin-agent/agent": "3.1.3",
-    "@qilin-agent/api-workspace-files": "3.1.3",
-    "@qilin-agent/attachment": "3.1.3",
-    "@qilin-agent/client-store": "3.1.3",
-    "@qilin-agent/client-ui-approval": "3.1.3",
-    "@qilin-agent/client-ui-conversation": "3.1.3",
-    "@qilin-agent/client-ui-layout": "3.1.3",
-    "@qilin-agent/client-locale": "3.1.3",
-    "@qilin-agent/client-ui-primitives": "3.1.3",
-    "@qilin-agent/client-ui-session": "3.1.3",
-    "@qilin-agent/client-ui-settings": "3.1.3",
-    "@qilin-agent/client-ui-renderer": "3.1.3",
-    "@qilin-agent/client-ui-sidebar-browser": "3.1.3",
-    "@qilin-agent/client-ui-sidebar-right": "3.1.3",
-    "@qilin-agent/client-ui-sidebar-documentpreview": "3.1.3",
-    "@qilin-agent/client-ui-trajectory": "3.1.3",
-    "@qilin-agent/client-ui-slots": "3.1.3",
-    "@qilin-agent/client-ui-workspace": "3.1.3",
-    "@qilin-agent/commands": "3.1.3",
-    "@qilin-agent/compaction": "3.1.3",
-    "@qilin-agent/llm": "3.1.3",
-    "@qilin-agent/llm-retry": "3.1.3",
-    "@qilin-agent/session-stats": "3.1.3",
-    "@qilin-agent/session": "3.1.3",
-    "@qilin-agent/session-turn-outline": "3.1.3",
-    "@qilin-agent/token-meter": "3.1.3",
-    "@qilin-agent/subagent": "3.1.3",
-    "@qilin-agent/settings": "3.1.3",
-    "@qilin-agent/tools": "3.1.3",
-    "@qilin-agent/util-workspace-path": "3.1.3",
-    "@qilin-agent/client-ui-input-trigger": "3.1.3",
-    "@qilin-agent/util-values": "3.1.3",
-    "@qilin-agent/brand": "3.1.3"
+    "@qilin-agent/api-remotes": "3.1.4",
+    "@qilin-agent/agent": "3.1.4",
+    "@qilin-agent/api-session-controller": "3.1.4",
+    "@qilin-agent/api-workspace-controller": "3.1.4",
+    "@qilin-agent/api-workspace-files": "3.1.4",
+    "@qilin-agent/client-locale": "3.1.4",
+    "@qilin-agent/client-store": "3.1.4",
+    "@qilin-agent/client-ui-approval": "3.1.4",
+    "@qilin-agent/client-ui-conversation": "3.1.4",
+    "@qilin-agent/client-ui-layout": "3.1.4",
+    "@qilin-agent/client-ui-primitives": "3.1.4",
+    "@qilin-agent/attachment": "3.1.4",
+    "@qilin-agent/client-ui-session": "3.1.4",
+    "@qilin-agent/client-ui-settings": "3.1.4",
+    "@qilin-agent/client-ui-renderer": "3.1.4",
+    "@qilin-agent/client-ui-sidebar-right": "3.1.4",
+    "@qilin-agent/client-ui-sidebar-documentpreview": "3.1.4",
+    "@qilin-agent/client-ui-trajectory": "3.1.4",
+    "@qilin-agent/client-ui-sidebar-browser": "3.1.4",
+    "@qilin-agent/client-ui-slots": "3.1.4",
+    "@qilin-agent/commands": "3.1.4",
+    "@qilin-agent/client-ui-workspace": "3.1.4",
+    "@qilin-agent/compaction": "3.1.4",
+    "@qilin-agent/llm-retry": "3.1.4",
+    "@qilin-agent/session-turn-outline": "3.1.4",
+    "@qilin-agent/session": "3.1.4",
+    "@qilin-agent/llm": "3.1.4",
+    "@qilin-agent/subagent": "3.1.4",
+    "@qilin-agent/settings": "3.1.4",
+    "@qilin-agent/token-meter": "3.1.4",
+    "@qilin-agent/tools": "3.1.4",
+    "@qilin-agent/util-workspace-path": "3.1.4",
+    "@qilin-agent/util-values": "3.1.4",
+    "@qilin-agent/brand": "3.1.4",
+    "@qilin-agent/client-ui-input-trigger": "3.1.4",
+    "@qilin-agent/session-stats": "3.1.4"
   },
   "dependencies": {
     "@qilin-agent/schemastery": "~3.18.3"