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

package/lib/index.js

@@ -5,6 +5,12 @@ import z from "@qilin-agent/schemastery";
 const CHAT_SETTINGS_NAMESPACE = "ui-chat";
 /** Field carrying the work-details presentation mode. */
 const TRANSCRIPT_VIEW_FIELD = "transcriptView";
+/** Field carrying the independent work-details collapse timing. */
+const COLLAPSE_TIMING_FIELD = "collapseTiming";
+/** Available points when a completed Turn returns to its historical presentation. */
+const COLLAPSE_TIMINGS = ["completion", "next-input"];
+/** Preserve completion-time folding when no timing preference is saved. */
+const DEFAULT_COLLAPSE_TIMING = "completion";
 /** Work-details presentation modes a user can choose. */
 const TRANSCRIPT_VIEW_MODES = [
 	"compact",
@@ -35,20 +41,28 @@ const DEFAULT_PERFORMANCE_USAGE = "detailed";
 const DEFAULT_LINK_OPENING = "sidebar";
 /** Durable Chat schema; also the wire envelope the browser scope validates against. */
 const ChatSettingsFields = {
+	[COLLAPSE_TIMING_FIELD]: z.union([...COLLAPSE_TIMINGS]).default(DEFAULT_COLLAPSE_TIMING),
 	linkOpening: z.union(["sidebar", "new-tab"]).default(DEFAULT_LINK_OPENING),
 	performanceUsage: z.union([...PERFORMANCE_USAGE_MODES]).default(DEFAULT_PERFORMANCE_USAGE),
 	[TRANSCRIPT_VIEW_FIELD]: z.union([...TRANSCRIPT_VIEW_SETTING_VALUES]).default(DEFAULT_TRANSCRIPT_VIEW_MODE).loose()
 };
-/** Schema for shared configuration values. */
-const ChatSettingsSchema = z.object(ChatSettingsFields);
+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(),
+	collapseTiming: ChatSettingsFields.collapseTiming.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, ChatSettingsFields, DEFAULT_LINK_OPENING, DEFAULT_PERFORMANCE_USAGE, DEFAULT_TRANSCRIPT_VIEW_MODE, LEGACY_EXPANDED_TRANSCRIPT_VIEW_MODE, LEGACY_TRANSCRIPT_VIEW_MODE, PERFORMANCE_USAGE_MODES, TRANSCRIPT_VIEW_FIELD, TRANSCRIPT_VIEW_MODES, apply };
+export { CHAT_SETTINGS_NAMESPACE, Config, DEFAULT_LINK_OPENING, DEFAULT_PERFORMANCE_USAGE, DEFAULT_TRANSCRIPT_VIEW_MODE, LEGACY_EXPANDED_TRANSCRIPT_VIEW_MODE, LEGACY_TRANSCRIPT_VIEW_MODE, PERFORMANCE_USAGE_MODES, TRANSCRIPT_VIEW_FIELD, TRANSCRIPT_VIEW_MODES, apply };

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

@@ -4,6 +4,14 @@ import z from '@qilin-agent/schemastery';
 export declare const CHAT_SETTINGS_NAMESPACE = "ui-chat";
 /** Field carrying the work-details presentation mode. */
 export declare const TRANSCRIPT_VIEW_FIELD = "transcriptView";
+/** Field carrying the independent work-details collapse timing. */
+export declare const COLLAPSE_TIMING_FIELD = "collapseTiming";
+/** 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];
+/** Preserve completion-time folding when no timing preference is saved. */
+export declare const DEFAULT_COLLAPSE_TIMING: CollapseTiming;
 /** Work-details presentation modes a user can choose. */
 export declare const TRANSCRIPT_VIEW_MODES: readonly ["compact", "standard", "detailed", "verbose"];
 /** Work-details presentation mode. */
@@ -31,6 +39,8 @@ export declare const DEFAULT_LINK_OPENING: LinkOpening;
 export interface ChatSettings {
     /** Work-details preference; legacy values are accepted only from existing saved settings. */
     transcriptView: TranscriptViewMode | typeof LEGACY_TRANSCRIPT_VIEW_MODE | typeof LEGACY_EXPANDED_TRANSCRIPT_VIEW_MODE;
+    /** Independent collapse timing; absence preserves completion-time folding. */
+    collapseTiming?: CollapseTiming;
     /** Detail level for composer statistics and completed-Turn usage. */
     performanceUsage: PerformanceUsageMode;
     /** Default destination for Chat HTTP(S) links. */
@@ -38,6 +48,7 @@ export interface ChatSettings {
 }
 /** Durable Chat schema; also the wire envelope the browser scope validates against. */
 export declare const ChatSettingsFields: {
+    collapseTiming: z<"completion" | "next-input", "completion" | "next-input", "defined">;
     linkOpening: z<"sidebar" | "new-tab", "sidebar" | "new-tab", "defined">;
     performanceUsage: z<"compact" | "detailed", "compact" | "detailed", "defined">;
     transcriptView: z<"compact" | "standard" | "detailed" | "verbose" | "normal" | "expanded", "compact" | "standard" | "detailed" | "verbose" | "normal" | "expanded", "defined">;

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

@@ -2,6 +2,8 @@ import type { ChatNodeOwnerProps, ChatFlowSlotProps, UsePresentation } from '../
 import type { ChatNodeStore } from '../contract/snapshot.ts';
 interface ChatNodeSeatProps extends ChatNodeOwnerProps {
     readonly nodeKey: string;
+    /** Nesting level inside a process group; absent for a root row. */
+    readonly depth?: number;
     /** A replaced Builder must rebind keyed hooks even when references and keys survive. */
     readonly nodeStore: ChatNodeStore;
     readonly useChatNode: ChatFlowSlotProps['useChatNode'];
@@ -20,6 +22,6 @@ interface ChatNodeSeatProps extends ChatNodeOwnerProps {
  * 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, editUserMessage, loadImage, renderMessageImages, fileMentions, useStore, actions, renderSlot, t, useChatNodeBottom, deferCollapse, useGroupAction, }: ChatNodeSeatProps) => import("react").JSX.Element | null>;
+export declare const ChatNodeSeat: import("react").MemoExoticComponent<({ nodeKey, groupPart, depth, useChatNode, useChatNodeProcess, usePresentation, cwd, openFile, openSkill, inspectCall, forkAt, editUserMessage, loadImage, renderMessageImages, fileMentions, useStore, actions, renderSlot, t, useChatNodeBottom, deferCollapse, useGroupAction, }: ChatNodeSeatProps) => import("react").JSX.Element | null>;
 export {};
 //# sourceMappingURL=ChatNodeSeat.d.ts.map

package/lib/types/client/chat/flow-motion.d.ts

@@ -1,7 +1,8 @@
 /**
- * Fade-then-close transitions owned by one Chat viewport. Rows fade before their boxes close;
- * the owner reserves removed height and holds scrolling until that viewport's folds finish.
- * Motion is opt-in under `[data-chat-motion]`, respects reduced motion, and clears temporary styles.
+ * Fold transitions owned by one Chat viewport. Every batch containing a closing row moves its boxes and
+ * the scrollport on one frame clock; a batch that only reveals rows, or a viewport without a reading
+ * policy, uses CSS transitions. Motion is opt-in under `[data-chat-motion]`, respects reduced motion,
+ * and clears temporary styles.
  */
 import { type RefObject } from 'react';
 /** Row-local operations supplied by the containing viewport. */
@@ -13,12 +14,55 @@ export interface FlowMotionRows {
     /** @param element - row whose active transition should be cancelled without hiding it. */
     cancelMotion(element: HTMLElement): void;
 }
+/** Geometry captured before one fold batch changes its boxes. */
+export interface InputFoldBox {
+    readonly element: HTMLElement;
+    readonly height: number;
+    readonly marginTop: number;
+    readonly closing: boolean;
+}
+/** The viewport moves on the same progress that changes the folded boxes. */
+export interface InputFoldDriver {
+    /**
+     * Capture geometry and choose the landing before the frame clock changes the boxes.
+     * @param boxes - non-nested boxes whose layout changes on this clock.
+     * @returns closing boxes that scroll with the content and stay opaque; the rest fade in place. The driver
+     * may add boxes while the batch runs, when a newer tail request takes it over.
+     */
+    begin(boxes: readonly InputFoldBox[]): ReadonlySet<HTMLElement>;
+    /**
+     * Reserve scroll range before box writes.
+     * @param progress - shared eased progress from zero to one.
+     * @param cancelled - a reading gesture stopped a tail landing's automatic target; a landing that keeps
+     * the reader's content still continues and includes the reader's own movement.
+     */
+    prepare(progress: number, cancelled: boolean): void;
+    /**
+     * Apply viewport geometry after box writes.
+     * @param progress - shared eased progress from zero to one.
+     * @param cancelled - a reading gesture stopped a tail landing's automatic target.
+     * @returns actual scrollTop displacement from the batch start, for closing-content visual compensation.
+     */
+    frame(progress: number, cancelled: boolean): number;
+    /**
+     * Install the final geometry after the last frame or cancellation.
+     * @param cancelled - a reading gesture stopped the automatic target, every closing row reopened, or the
+     * viewport detached; the driver commits no obsolete landing.
+     */
+    finish(cancelled: boolean): void;
+}
 /** Animation lifetime and fold coordination for one viewport. */
 export interface FlowMotion extends FlowMotionRows {
     /** @returns whether a row owned by this viewport is closing. */
     foldActive(): boolean;
     /** @param listener - callback after the last fold. @returns cancellation for a pending callback. */
     onFoldIdle(listener: () => void): () => void;
+    /** Stop the running batch's automatic target while letting its boxes finish. */
+    cancelInput(): void;
+    /** Restore the running batch's automatic target after a newer request takes it over. */
+    resumeInput(): void;
+    /** @returns whether a fold batch runs, or one is scheduled for this commit's closing rows. */
+    inputActive(): boolean;
     /** Cancel owned animations and pending work when the viewport detaches. */
     clear(): void;
 }
@@ -36,16 +80,16 @@ export declare function motionEnabled(element: HTMLElement): boolean;
 export declare function hiddenOrCollapsing(element: HTMLElement): boolean;
 /**
  * Create animation coordination without cross-viewport broadcasts.
- * @param reserve - reserve the deduplicated removed height in this viewport.
+ * @param driver - the viewport's driver for the next batch; null while detached.
  * @param foldingChanged - disable or restore this viewport's native scroll anchoring.
  * @returns stable callbacks and cleanup for this viewport's animations.
  */
-export declare function createFlowMotion(reserve: (px: number) => void, foldingChanged: (active: boolean) => void): FlowMotion;
+export declare function createFlowMotion(driver: () => InputFoldDriver | null, foldingChanged: (active: boolean) => void): FlowMotion;
 /**
  * Apply searchable hiding with the containing Chat viewport's optional fold animation.
  * @param hidden - desired visibility.
  * @param reveal - browser-find and focus-protection callback.
- * @param motion - owning viewport's row callbacks; absent in standalone rendering.
+ * @param motion - owning viewport's row callbacks; undefined applies visibility synchronously.
  * @returns the stable subtree ref.
  */
 export declare function useFlowHidden(hidden: boolean, reveal: () => void, motion: FlowMotionRows | undefined): RefObject<HTMLDivElement>;

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

@@ -23,9 +23,9 @@ export declare class ChatReading {
     private readonly follow;
     private sampleTimer;
     private probeFrame;
+    private sampled;
     /** Settled reader row and offset, re-aligned when a layout change moves it. */
     private readerPosition;
-    private sampled;
     constructor(viewport: ChatViewport, store: PositionStore, state: ChatReadingState, onChange: (state: ChatReadingState) => void, follow: ScrollFollow);
     /**
      * Expose pending reader ownership to navigation and resize handlers.
@@ -57,6 +57,16 @@ export declare class ChatReading {
      * @param behavior - immediate positioning, or one native animation when the reader's own input moved the tail.
      */
     followTail(behavior?: 'instant' | 'smooth'): void;
+    /**
+     * Follow the tail on the active fold's animation clock.
+     * @returns whether a fold batch owns the tail movement instead of a separate scroll animation.
+     */
+    followInputFold(): boolean;
+    /**
+     * Let fold batches read follow intent and commit their tail landings.
+     * @returns a disposer that disconnects this reading policy from the viewport.
+     */
+    bindFolds(): () => void;
     /** Stop a native follow animation where it is; the next sampled position decides follow intent. */
     interruptFollow(): void;
     /** Restore the Session's semantic position, or follow the tail when none is saved. */

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

@@ -17,13 +17,21 @@ export interface ViewportLanding {
 }
 interface ViewportEvents {
     scroll: (event: ViewportScroll) => void;
-    /** Settled scroll; `outer` distinguishes the transcript scroller from a process body. */
     scrollEnd: (outer: boolean) => void;
     resize: () => void;
     interact: () => void;
     /** Any reading gesture, before paging ownership is consulted. */
     intent?: () => void;
 }
+/** Reading policy that fold batches consult and report tail landings to. */
+export interface FoldReader {
+    /** Follow intent at batch start selects the tail landing; tail landings commit it. */
+    readonly follow: ScrollFollow;
+    /** @param landing - the actual geometry after a batch landed at the tail. */
+    readonly landedAtTail: (landing: ViewportLanding) => void;
+    /** @returns whether reader movement awaits sampling; until then follow intent is undecided. */
+    readonly pending: () => boolean;
+}
 /** Owns one Chat scrollport's DOM operations, event listeners, and size observer. */
 export declare class ChatViewport {
     private elements;
@@ -31,9 +39,16 @@ export declare class ChatViewport {
     private events;
     private turns;
     private observation;
+    private paging;
+    private reader;
+    /** A transcript resize observed since the previous sample. */
     private resized;
+    /** Reader input observed since the previous sample. */
     private readerIntent;
-    private paging;
+    /** The pending or running fold batch lands at the tail. */
+    private tailRequested;
+    /** Switches the running batch to a tail landing; null while no batch runs. */
+    private retarget;
     /** Transition state and row callbacks owned by this viewport's attachment. */
     readonly motion: import("./flow-motion.ts").FlowMotion;
     /**
@@ -65,17 +80,57 @@ export declare class ChatViewport {
     private spacerHeight;
     private setSpacer;
     /**
-     * Add room below the flow before rows above the reader close, so the scrollport never clamps:
-     * the closing gap pulls the content below it upward while everything above stays put.
-     * @param px - height about to leave the flow.
+     * Connect the reading policy that fold batches consult.
+     * @param reader - follow intent and the tail-landing commit.
+     * @returns a disposer that disconnects only this reader.
+     */
+    bindReader(reader: FoldReader): () => void;
+    /**
+     * Land the pending or running fold batch at the tail instead of starting a separate scroll.
+     * @param follow - follow controller whose native animation yields to the batch.
+     * @returns whether a fold owns the tail movement.
+     */
+    followInputFold(follow: ScrollFollow): boolean;
+    /**
+     * Drive one fold batch on its frame clock. A tail landing ends at the floor, never above the reader's
+     * compensated position; a reader landing keeps the visible content still. Both install only the room
+     * the landing lacks.
+     * @returns the batch driver, or null while detached or without a reading policy.
+     */
+    private foldDriver;
+    /**
+     * Find the first visible top-level row at or below the scrollport top that holds no batch box.
+     * Binary search over the ordered top-level rows reads O(log n) boxes.
+     * @returns the reference row, or null when every visible row folds.
      */
-    reserveBelow(px: number): void;
+    private readingReference;
+    /**
+     * Consume the pending transcript resize. A delivery that arrives with one is the
+     * browser's layout compensation, not a reader choice, so it must not re-anchor the
+     * semantic position.
+     * @returns whether the transcript resized since the previous sample.
+     */
+    consumeResize(): boolean;
+    /**
+     * Consume reader input recorded since the previous sample. Geometry alone cannot
+     * separate a reader scroll from the browser's layout compensation, so a transcript
+     * that moved with reader input present is the reader's own choice.
+     * @returns whether wheel, touch, pointer, key, or find-in-page input arrived.
+     */
+    consumeReaderIntent(): boolean;
+    /**
+     * Re-align the reader's own settled row after a layout change moved it. A missing row
+     * leaves the scrollport untouched: the raw position is only meaningful for the row it
+     * was sampled against.
+     * @param position - semantic position sampled while the reader owned the transcript.
+     * @returns the actual landing, or null when the row is absent or still aligned.
+     */
+    restoreReaderRow(position: ChatScrollPosition | null): ViewportLanding | null;
     /** Clear fold reservations after a display-mode change, allowing the scroll range to shrink. */
     resetBelow(): void;
     /**
-     * Give reserved room back only as content grows into it, never by scrolling back down: growth fills
-     * the blank before it moves the floor. Holds still while rows are closing, because trimming mid-close
-     * would let the next frame clamp.
+     * Give reserved room back after acknowledged scrolling or content growth without clamping the reader.
+     * Holds still during folds and unsampled movement; following includes the room that remains.
      */
     reclaimBelow(): void;
     /**
@@ -88,21 +143,6 @@ export declare class ChatViewport {
      * @param metrics - settled reader position used as the next attribution baseline.
      */
     acknowledge(metrics: ViewportMetrics): void;
-    /**
-     * Consume the pending transcript resize.
-     * A delivery that arrives with one is the browser's layout compensation,
-     * not a reader choice, so it must not re-anchor the semantic position.
-     * @returns whether the transcript resized since the previous sample.
-     */
-    consumeResize(): boolean;
-    /**
-     * Consume reader input recorded since the previous sample.
-     * Geometry alone cannot separate a reader scroll from the browser's layout
-     * compensation, so a transcript that moved with reader input present is the
-     * reader's own choice.
-     * @returns whether wheel, touch, pointer, key, or find-in-page input arrived.
-     */
-    consumeReaderIntent(): boolean;
     /**
      * Compare the current scroll geometry with the last acknowledged position.
      * @returns current metrics and movement attribution, or null while detached.
@@ -142,14 +182,6 @@ export declare class ChatViewport {
      * @returns the actual landing, or null while detached.
      */
     restore(position: ChatScrollPosition): ViewportLanding | null;
-    /**
-     * Re-align the reader's own settled row after a layout change moved it.
-     * A missing row leaves the scrollport untouched: the raw position is only
-     * meaningful for the row it was sampled against.
-     * @param position - semantic position sampled while the reader owned the transcript.
-     * @returns the actual landing, or null when the row is absent or still aligned.
-     */
-    restoreReaderRow(position: ChatScrollPosition | null): ViewportLanding | null;
     /** Retain the first eligible transcript seat in DOM order; selection reads no geometry. */
     beginPaging(): void;
     /**
@@ -172,7 +204,7 @@ export declare class ChatViewport {
      */
     preserve(): ViewportLanding | null;
     /**
-     * Align the scrollport with its current floor.
+     * Align with the physical floor, including fold room that newer content has not yet filled.
      * @param follow - independent follow intent and scrolling controller.
      * @param behavior - immediate positioning, or one native animation for a reader-caused tail change.
      * @returns the actual floor landing, or null while detached. A smooth landing reports the starting

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

@@ -52,6 +52,8 @@ export declare const zh: {
     'fileOpen.title': string;
     'fileOpen.unknown': string;
     'message.extraBlock': string;
+    'secret.reveal': string;
+    'secret.hide': string;
     'message.systemPrompt': string;
     'message.systemPromptUpdate': string;
     'message.contextInjection': string;
@@ -164,6 +166,11 @@ export declare const zh: {
     'message.retry.delay': string;
     'message.retry.failure': string;
     'message.failure.auth': string;
+    'message.taskStopped': string;
+    'message.failure.accountSignedOut': string;
+    'message.failure.interrupted': string;
+    'message.failure.accountSignInRequired': string;
+    'message.failure.quota': string;
     'message.turnError': string;
     'message.maxTokens': string;
     'message.maxTokens.hint': string;
@@ -244,6 +251,8 @@ export declare const en: {
     'fileOpen.title': string;
     'fileOpen.unknown': string;
     'message.extraBlock': string;
+    'secret.reveal': string;
+    'secret.hide': string;
     'message.systemPrompt': string;
     'message.systemPromptUpdate': string;
     'message.contextInjection': string;
@@ -356,6 +365,11 @@ export declare const en: {
     'message.retry.delay': string;
     'message.retry.failure': string;
     'message.failure.auth': string;
+    'message.taskStopped': string;
+    'message.failure.accountSignedOut': string;
+    'message.failure.interrupted': string;
+    'message.failure.accountSignInRequired': string;
+    'message.failure.quota': string;
     'message.turnError': string;
     'message.maxTokens': string;
     'message.maxTokens.hint': string;

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

@@ -1,15 +1,12 @@
-/** Chat presentation derived from Host-backed detail and in-memory collapse timing. */
+/** Chat presentation derived from Host-backed detail and 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];
+import type { CollapseTiming, TranscriptViewMode } from '../chat-settings.ts';
+export { COLLAPSE_TIMINGS, type CollapseTiming } from '../chat-settings.ts';
 /** Presentation capabilities that one work-details mode enables. */
 export interface ChatPresentationPolicy {
     /** 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. */
+    /** Saved collapse timing; 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;
@@ -23,14 +20,14 @@ export interface ChatPresentationPolicy {
 /**
  * Resolve a stable policy for one detail mode and collapse timing.
  * @param mode - persisted work-details mode.
- * @param collapseTiming - in-memory timing; defaults to immediate completion folding.
+ * @param collapseTiming - persisted timing; defaults to immediate completion folding.
  * @returns the same policy object for the same pair of choices.
  */
 export declare function presentationPolicyFor(mode: TranscriptViewMode, collapseTiming?: CollapseTiming): ChatPresentationPolicy;
 /**
- * Combine Host-backed detail and in-memory timing without owning subscriptions.
+ * Combine Host-backed detail and persisted timing without owning subscriptions.
  * @param mode - live work-details mode.
- * @param collapseTiming - live, in-memory collapse timing.
+ * @param collapseTiming - live Host-backed collapse timing.
  * @returns observable policy whose subscriptions follow both preferences.
  */
 export declare function derivePresentationPolicy(mode: ObservableSnapshot<TranscriptViewMode>, collapseTiming: ObservableSnapshot<CollapseTiming>): ObservableSnapshot<ChatPresentationPolicy>;

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

@@ -8,18 +8,18 @@ export interface TranscriptViewRowInjected {
     hooks: {
         /** Persisted work-details preference bound as useTranscriptView. */
         transcriptView: SnapshotStore<TranscriptViewMode>;
-        /** Browser-local timing bound as useCollapseTiming. */
+        /** Persisted collapse 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. */
+    /** Persist collapse timing independently of the work-details mode. */
     setCollapseTiming: (timing: CollapseTiming) => void;
 }
 /** Full Settings-row props. */
 export type TranscriptViewRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'chat'> & InjectFace<TranscriptViewRowInjected>;
 /**
- * Render work-details and browser-local collapse-timing selectors.
+ * Render the independent, Host-backed work-details and collapse-timing selectors.
  * @param props - composed Settings slot props.
  * @returns the preference row.
  */

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

@@ -1,4 +1,4 @@
-/** Host-backed work details and independent, in-memory collapse timing. */
+/** Independent work-details preferences backed by the same Host configuration form. */
 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';
@@ -10,7 +10,7 @@ export declare class TranscriptViewPolicy {
     private readonly unsubscribe;
     /** 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. */
+    /** Reactive collapse timing, defaulting to completion until Host settings arrive. */
     readonly collapseTiming: SnapshotStore<CollapseTiming>;
     /**
      * @param host - durable Chat settings scope.
@@ -25,7 +25,7 @@ export declare class TranscriptViewPolicy {
      */
     setMode(mode: TranscriptViewMode): void;
     /**
-     * Keep collapse timing in memory without writing Host or browser storage.
+     * Publish and persist collapse timing without changing the work-details mode.
      * @param timing - immediate completion folding or deferred folding at the next input.
      */
     setCollapseTiming(timing: CollapseTiming): void;

package/lib/types/index.d.ts

@@ -1,6 +1,32 @@
-/** Host registration for browser Chat preferences. */
-import type { Context } from '@qilin-agent/kylin';
-export { CHAT_SETTINGS_NAMESPACE, ChatSettingsFields, DEFAULT_LINK_OPENING, DEFAULT_PERFORMANCE_USAGE, DEFAULT_TRANSCRIPT_VIEW_MODE, LEGACY_EXPANDED_TRANSCRIPT_VIEW_MODE, LEGACY_TRANSCRIPT_VIEW_MODE, PERFORMANCE_USAGE_MODES, TRANSCRIPT_VIEW_FIELD, TRANSCRIPT_VIEW_MODES, type ChatSettings, type LinkOpening, type PerformanceUsageMode, type TranscriptViewMode, } from './chat-settings.ts';
-/** Register the durable Chat settings section when a provider exists. */
+import type { Volatile, Context } from '@qilin-agent/kylin';
+import type { ChatSettings, CollapseTiming, LinkOpening, PerformanceUsageMode } from './chat-settings.ts';
+import z from '@qilin-agent/schemastery';
+export { CHAT_SETTINGS_NAMESPACE, DEFAULT_LINK_OPENING, DEFAULT_PERFORMANCE_USAGE, DEFAULT_TRANSCRIPT_VIEW_MODE, LEGACY_EXPANDED_TRANSCRIPT_VIEW_MODE, LEGACY_TRANSCRIPT_VIEW_MODE, PERFORMANCE_USAGE_MODES, TRANSCRIPT_VIEW_FIELD, TRANSCRIPT_VIEW_MODES, type ChatSettings, type LinkOpening, type PerformanceUsageMode, type TranscriptViewMode, } from './chat-settings.ts';
+/** Runtime preferences projected to the browser. */
+export interface Config {
+    /** Completed turn transcript presentation. */
+    transcriptView: Volatile<ChatSettings['transcriptView']>;
+    /** When completed work details return to their historical presentation. */
+    collapseTiming: Volatile<CollapseTiming>;
+    /** Performance and usage detail level. */
+    performanceUsage: Volatile<PerformanceUsageMode>;
+    /** Default destination for Chat HTTP(S) links. */
+    linkOpening: Volatile<LinkOpening>;
+}
+/** Live preferences projected to the browser. */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    transcriptView: z<"compact" | "standard" | "detailed" | "verbose" | "normal" | "expanded", "compact" | "standard" | "detailed" | "verbose" | "normal" | "expanded", "volatile-defined">;
+    collapseTiming: z<"completion" | "next-input", "completion" | "next-input", "volatile-defined">;
+    performanceUsage: z<"compact" | "detailed", "compact" | "detailed", "volatile-defined">;
+    linkOpening: z<"sidebar" | "new-tab", "sidebar" | "new-tab", "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    transcriptView: z<"compact" | "standard" | "detailed" | "verbose" | "normal" | "expanded", "compact" | "standard" | "detailed" | "verbose" | "normal" | "expanded", "volatile-defined">;
+    collapseTiming: z<"completion" | "next-input", "completion" | "next-input", "volatile-defined">;
+    performanceUsage: z<"compact" | "detailed", "compact" | "detailed", "volatile-defined">;
+    linkOpening: z<"sidebar" | "new-tab", "sidebar" | "new-tab", "volatile-defined">;
+}>>, "plain">;
+/** Host preferences are consumed through the configuration form projection.
+ * @param ctx Plugin context used for optional settings presentation.
+ */
 export declare function apply(ctx: Context): void;
 //# sourceMappingURL=index.d.ts.map