@qilin-agent/client-ui-conversation 3.1.5 → 3.1.7

package/lib/types/client/input/editor/runtime.d.ts

@@ -1,7 +1,8 @@
 /** The Composer model's private Lexical editor, projections, and node operations. */
 import type { ObservableSnapshot } from '@qilin-agent/client-store';
 import type { LexicalEditor } from 'lexical';
-import type { Occurrence, ReferenceInsert } from '../../contract/draft-editor.ts';
+import type { DraftReference, ReferenceInsert } from '../../contract/draft-editor.ts';
+import type { CommandClaim } from '../../contract/input.ts';
 import type { EditorProjection } from './projection.ts';
 import type { DetectSpan } from './span-map.ts';
 type Lexicon = ReadonlyMap<'/' | '@', readonly string[]>;
@@ -9,7 +10,6 @@ type Lexicon = ReadonlyMap<'/' | '@', readonly string[]>;
 interface DraftEditorRuntimeDeps {
     readonly onUpdate: () => void;
     readonly openReference: (source: string | undefined, reference: Pick<ReferenceInsert, 'ref' | 'appearance'>) => boolean;
-    readonly activeClaimToken: () => string | null;
     readonly lexicon: () => Lexicon;
     readonly resolveLexicon: () => ObservableSnapshot<Lexicon> | undefined;
 }
@@ -24,6 +24,7 @@ export declare class DraftEditorRuntime {
     private occurrenceSeq;
     /** Live lexicon subscription disposer; undefined until the controller resolves. */
     private lexiconOff;
+    private lexiconSource;
     /** @param deps - model callbacks used by editor listeners and transforms. */
     constructor(deps: DraftEditorRuntimeDeps);
     /**
@@ -44,12 +45,10 @@ export declare class DraftEditorRuntime {
      */
     private applyEdit;
     /**
-     * Subscribe the text-ref re-scan to the controller's lexicon once the
-     * controller resolves. The deps thunk cannot resolve at construction (the
-     * shell is created inside the sessions provide materialization), so the
-     * first interactive updates retry until it can.
+     * Reconnect decorations when the optional trigger provider changes.
+     * The rescan reads the current editor and does not replace its content.
      */
-    private ensureLexiconSubscription;
+    refreshLexiconSubscription(): void;
     /**
      * Re-project inside the existing editor update callback.
      * @returns the projection preceding this read.
@@ -63,6 +62,14 @@ export declare class DraftEditorRuntime {
      * @param text - the full next draft.
      */
     setDraft(text: string): void;
+    /**
+     * Add plain text after the current draft as new paragraphs, keeping its text
+     * and references; an empty draft takes the text as its whole content.
+     * Placeholder-sanitized; the caret lands at the end; merged into history
+     * like {@link setDraft}.
+     * @param text - plain text to add.
+     */
+    appendDraft(text: string): void;
     /**
      * Insert pasted plain text over the current editor selection
      * (placeholder-sanitized). The paste event's own default is suppressed by
@@ -103,19 +110,34 @@ export declare class DraftEditorRuntime {
      * @returns whether the range mapped and the edit applied.
      */
     insertReference(span: DetectSpan, ref: ReferenceInsert, tail: string): boolean;
-    /** Refresh claim-token decoration after the model's claim changes. */
-    refreshClaimDecoration(): void;
+    /**
+     * Replace a span with a command chip followed by the claim token's
+     * argument separator, unless the separator already follows.
+     * @param span - detect-coordinate range.
+     * @param claim - the command claim the chip anchors.
+     * @param tail - the character following the range before editing.
+     * @param mergeHistory - merge into the previous history entry (a restored
+     * draft's chip is part of its seed, not an undoable step).
+     * @returns whether the range mapped and the edit applied.
+     */
+    insertCommand(span: DetectSpan, claim: CommandClaim, tail: string, mergeHistory?: boolean): boolean;
+    /**
+     * Insert an ordered file-reference batch after the live selection without deleting it.
+     * @param references - validated references in source order.
+     * @returns whether the live insertion position accepted the batch.
+     */
+    insertFileReferences(references: readonly ReferenceInsert[]): boolean;
     /**
      * Clear committed content using the model's suffix decision inside the editor update.
      * @param prefixLength - returns the clipboard-prefix length to remove, or null to clear the root.
      */
     clearCommittedDraft(prefixLength: (clipboardText: string) => number | null): void;
     /**
-     * Rebuild one model-selected failure snapshot, creating fresh reference nodes.
+     * Import semantic content or a model-selected failure snapshot with fresh reference nodes.
      * @param draft - clipboard text.
      * @param occurrences - reference occurrences in clipboard order.
      */
-    restoreDraft(draft: string, occurrences: readonly Occurrence[]): void;
+    restoreDraft(draft: string, occurrences: readonly DraftReference[]): void;
     /** Cut the editor's undo history after a committed clear or restoration. */
     clearHistory(): void;
 }

package/lib/types/client/input/editor/text-ref.d.ts

@@ -28,17 +28,12 @@ export declare class TextRefNode extends TextNode {
     canInsertTextBefore(): boolean;
 }
 /**
- * Register the plain-text reference entity transform. The claim decoration
- * has precedence on the leading-token seat: while a command claim holds, the
- * claimed token must stay a plain TextNode (transforms register per concrete
- * node class, so a TextRefNode would never receive the TextNode claim
- * transform and the warn color would be lost).
+ * Register the plain-text reference entity transform.
  * @param editor - the shell-owned editor.
  * @param lexiconOf - live per-trigger name-roll accessor (the controller's aggregated store).
- * @param activeToken - live claim token accessor; null while unclaimed.
  * @returns the unregister disposer.
  */
-export declare function registerTextRefDecoration(editor: LexicalEditor, lexiconOf: () => ReadonlyMap<'/' | '@', readonly string[]>, activeToken: () => string | null): () => void;
+export declare function registerTextRefDecoration(editor: LexicalEditor, lexiconOf: () => ReadonlyMap<'/' | '@', readonly string[]>): () => void;
 /**
  * Force a re-scan of the whole document (transforms only visit dirty nodes;
  * a lexicon roll change dirties nothing on its own). Queued, not discrete —

package/lib/types/client/input/editor/view-binding.d.ts

@@ -11,7 +11,7 @@ interface DraftViewGate {
     running: boolean;
     steeringAvailable: boolean;
     busyEnter: BusyEnterBehavior;
-    intakeFiles: (files: readonly File[]) => void;
+    intakeFiles: (files: readonly File[], directories?: ReadonlySet<File>) => void;
     uploadsPending: boolean;
     showToast: (text: string) => void;
     t: ComposerBarProps['t'];

package/lib/types/client/input/facade.d.ts

@@ -12,9 +12,9 @@ import type { Context } from '@qilin-agent/kylin';
 import type { InboxState } from '@qilin-agent/agent/types';
 import { type ObservableSnapshot, type SnapshotStore } from '@qilin-agent/client-store';
 import type { LexicalEditor } from 'lexical';
-import type { CommandClaim, ConsumeTokenRequest, DraftAttachmentId, InputActions, InputNotice, InputState, InputTriggerController, SessionInput, SubmitAttachment, SubmitOutcome } from '../contract/input.ts';
-import type { ArbitrateKey, ArbitrateOutcome, ComposerKeyboard, ReferenceInsert, TokenSpan } from '../contract/draft-editor.ts';
-import type { InputSubmitMode } from '../contract/composer-submission.ts';
+import type { CommandClaim, ConsumeTokenRequest, DraftAttachmentId, DraftInitializationOptions, DraftInitializationResult, InputActions, InputNotice, InputState, InputTriggerController, SessionInput, SubmitAttachment, SubmitOutcome } from '../contract/input.ts';
+import type { ArbitrateKey, ArbitrateOutcome, ComposerKeyboard, DraftInput, DraftSnapshot, ReferenceInsert, TokenSpan } from '../contract/draft-editor.ts';
+import type { InputSubmitMode, MessageSubmission, MessageSubmissionState } from '../contract/composer-submission.ts';
 /** Popup face the shell needs (dismissal only; typed structurally to avoid a value import). */
 export interface PopupDismissFace {
     dismiss(): void;
@@ -50,6 +50,10 @@ export interface SessionInputDeps {
         /** Localized composer notice for a claimed command that does not accept attachments. */
         unsupportedNotice(token: string): string;
     };
+    /** Capture the Session facts an ordinary-message notification reports; optional observations cannot interrupt submission. */
+    submissionState?: () => MessageSubmissionState;
+    /** Receive the ordinary-message occurrence once, before reference serialization. */
+    messageSubmitted?: (submission: MessageSubmission) => void;
 }
 /**
  * The per-session input facade: scoped-event application verbs +
@@ -72,11 +76,16 @@ export declare class SessionInputShell implements SessionInput {
     private rev;
     private readonly unregister;
     private noticeSeq;
-    private lastMirroredDraft;
+    private lastPublishedDraft;
+    private draftSnapshotCache;
     private attachmentIds;
     private disposed;
-    /** Draft persistence mirror (Conversation store write; receives the clipboard projection). */
-    private mirrorFn;
+    /** Conversation store writer for the current semantic document. */
+    private persistDraft;
+    /** A restored draft's command token waiting for the trigger pipeline, with the revision its restore produced. */
+    private pendingCommand;
+    /** The in-flight claim resolution for a restored command chip. */
+    private commandRestore;
     /** The mounted composer's file-picker opener (scoped pick-files event target). */
     private filePicker;
     /** Default sends retained until admission settles or scope disposal releases their attachments. */
@@ -91,17 +100,50 @@ export declare class SessionInputShell implements SessionInput {
     private readonly attachmentFlights;
     private readonly unsubscribeInbox;
     constructor(deps: SessionInputDeps);
-    /** Re-project, run the claim watch, publish, and feed trigger tracking after every editor commit. */
+    /** Re-project, sync the claim with the leading command chip, publish, and feed trigger tracking after every editor commit. */
     private onEditorUpdate;
     /**
      * Replace the whole draft (persisted-draft seed and programmatic writes).
      * Placeholder-sanitized; newlines split paragraphs; the caret lands at the
      * end. Merged into history so a seed is not an undoable step of its own.
-     * @param text - the full next draft.
+     * @param text - plain text or the complete semantic document.
      */
-    setDraft(text: string): void;
+    setDraft(text: DraftInput): void;
+    /**
+     * Reconnect optional catalog notifications and resume a pending command
+     * chip restore without waiting for another edit.
+     */
+    refreshLexiconSubscription(): void;
+    /**
+     * Rebuild the command chip a restored draft carried once the trigger
+     * pipeline can resolve its claim. The rebuild applies only at the revision
+     * the restore produced: an edit made while the claim resolves keeps the
+     * literal token, which Enter still adjudicates as the command.
+     */
+    private restoreCommand;
+    /** Drop a pending or in-flight command chip restore. */
+    private cancelCommandRestore;
+    /** Current semantic document, stable until its content revision changes. */
+    get draftSnapshot(): DraftSnapshot;
+    /** Persist the latest document without changing the editor or binding a writer. */
+    persistCurrentDraft(): void;
+    /**
+     * Apply one new-task request to this already-initialized input model.
+     * @param options - content to adopt and the handling of an existing draft.
+     * @returns applied when the requested text is adopted, even if unchanged;
+     * preserved when the current draft is kept; blocked after disposal or during a pending submission.
+     */
+    requestDraftInitialization(options: DraftInitializationOptions): DraftInitializationResult;
+    private draftInitializationBlocked;
     /** Append ordered attachment ids unless an admission transaction is locked. */
     addAttachments(ids: readonly DraftAttachmentId[]): boolean;
+    /**
+     * Add validated file references and attachment ids while admission is editable.
+     * @param references - reference chips in source order.
+     * @param ids - newly allocated attachment ids.
+     * @returns false when admission is locked or the editor refuses the insertion.
+     */
+    addFiles(references: readonly ReferenceInsert[], ids: readonly DraftAttachmentId[]): boolean;
     /**
      * Remove one attachment id from this draft. Busy admission phases refuse, like
      * {@link addAttachments}: a removal landing while a command submit serializes
@@ -182,6 +224,14 @@ export declare class SessionInputShell implements SessionInput {
      * @returns whether the edit applied (phase, span CAS, and leading guard passed).
      */
     beginCommand(claim: CommandClaim, span: TokenSpan): boolean;
+    /**
+     * Replace [0, span.end) with the command chip and enter claimed.
+     * @param claim - the command claim the chip anchors.
+     * @param span - pick-time span snapshot (detect coordinates).
+     * @param mergeHistory - merge the edit into the previous history entry.
+     * @returns whether the edit applied.
+     */
+    private applyClaim;
     /**
      * Apply one reference insertion (scoped insert-reference event listener
      * body): the editor replaces the span with one chip node, followed by a
@@ -234,14 +284,11 @@ export declare class SessionInputShell implements SessionInput {
     /** Read the live input state (guard derivation reads here). */
     get snapshot(): InputState;
     /**
-     * Bind the draft persistence mirror (Conversation store write). Adopt-on-bind: the
-     * store draft may hold a persisted value from a previous mount; the caller
-     * seeds it via setDraft BEFORE binding, and afterwards every editor-adopted
-     * draft mirrors out.
-     * @param write - store draft write.
+     * Bind the Conversation store writer without importing or saving content.
+     * @param write - semantic draft writer; persistCurrentDraft flushes the initial value.
      * @returns the unbind disposer.
      */
-    bindMirror(write: (text: string) => void): () => void;
+    bindDraftPersistence(write: (draft: DraftSnapshot) => void): () => void;
     /**
      * Bind the mounted composer's file action and live intake availability.
      * @param picker - availability query and native file-dialog opener.
@@ -258,9 +305,7 @@ export declare class SessionInputShell implements SessionInput {
      * @returns whether the opener was called.
      */
     pickFiles(): boolean;
-    /** The claim token the decoration transform styles; null while unclaimed. */
-    private activeClaimToken;
-    /** Dispatch + execute, refreshing the claim decoration when the styled token flips. */
+    /** Dispatch one machine event and execute its effects. */
     private dispatchRun;
     private run;
     private execute;
@@ -277,6 +322,17 @@ export declare class SessionInputShell implements SessionInput {
      * its editor snapshot. Chip-free drafts skip the async detour.
      */
     private sinkSerialized;
+    /**
+     * Capture the notification's Session facts; an observation failure leaves them unknown.
+     * @param mode - delivery mode requested for this attempt.
+     * @returns the immutable occurrence.
+     */
+    private submissionFor;
+    /**
+     * Hand one occurrence to the notification consumer; a consumer failure cannot interrupt sending.
+     * @param submission - captured occurrence.
+     */
+    private notifySubmission;
     /** Settle one detached default send independently of other sends. */
     private settleSink;
     /** Restore one failed detached send without overwriting text entered after a restoration. */

package/lib/types/client/input/hub.d.ts

@@ -1,17 +1,8 @@
-/**
- * InputHub: the SessionInputResolver implementation (`ctx.conversation.input`) — one
- * SessionInputShell per session, created inside the uiSession provide
- * materialization (the 'input' standard-kit entry IS the
- * creation trigger) and torn down by the scope disposer (instance-and-scope
- * share one lifecycle). The hub registers the scoped input-mutation
- * listeners on each Session context and owns the default-sink choreography: every session is a
- * real host entity, so the sink is one unconditional prompt path.
- */
 import type { Context } from '@qilin-agent/kylin';
 import type { SessionBinding } from '@qilin-agent/api-session-controller/client';
 import type { SessionId } from '@qilin-agent/session/types';
 import type { TranslateNS } from '@qilin-agent/client-locale/client';
-import type { InputTriggerController, SessionInputResolver, SessionInput } from '../contract/input.ts';
+import type { DraftInitializationOptions, DraftInitializationResult, InputTriggerController, SessionInputResolver, SessionInput } from '../contract/input.ts';
 import type { ComposerKeyboard } from '../contract/draft-editor.ts';
 import { SessionInputShell } from './facade.ts';
 /** Session-addressed input facade registry (SessionInputResolver face + composer-layer extras). */
@@ -30,6 +21,7 @@ export declare class InputHub implements SessionInputResolver {
      * @returns the resident per-session facade.
      */
     for(actx: Context): SessionInput;
+    requestDraftInitialization(binding: SessionBinding, options: DraftInitializationOptions): DraftInitializationResult;
     /**
      * Resident shell for one session binding — the provide-channel entry
      * (called during scope materialization, BEFORE the scope record is

package/lib/types/client/input/machine.d.ts

@@ -20,10 +20,14 @@ export declare class SubmitMachine {
      * @returns effects for the SessionInput shell, in execution order.
      */
     dispatch(ev: InputEvent): readonly InputEffect[];
-    /** The complete command name retains its claim with or without the argument separator. */
-    private onDraftChanged;
-    /** The editor applied a claim-token replacement; busy phases refuse another claim. */
-    private onClaim;
+    /**
+     * Outside a transaction the claim follows the document's leading command
+     * chip: deleting or displacing the chip releases it, and a history restore
+     * of the chip re-enters claimed. The claim event applies the same rule to a
+     * chip the editor just inserted, before its update commits; busy phases
+     * refuse both.
+     */
+    private followCommand;
     /** Mint an attempt and controller without assigning its lifecycle owner. */
     private mintAttempt;
     /** Mint the frozen command/adjudication attempt. */
@@ -35,7 +39,7 @@ export declare class SubmitMachine {
     private onEnter;
     private onAdjudicated;
     private onAdjudicationFailed;
-    /** Claimed command settlement retains the frozen transaction semantics. */
+    /** Claimed command settlement; after a failure the claim follows the leading command chip again. */
     private onSubmitSettled;
     /** Settle one ordinary send independently of current phase and other detached sends. */
     private onSinkSettled;

package/lib/types/client/input/submission-analytics.d.ts

@@ -0,0 +1,10 @@
+/** Maps ordinary message occurrences to Desktop product events. */
+import type { Context } from '@qilin-agent/kylin';
+import type { MessageSubmission } from '../contract/composer-submission.ts';
+/**
+ * Report the original message occurrence without reading newer Session facts.
+ * @param ctx - client context.
+ * @param submission - occurrence, delivery mode, and captured Session facts.
+ */
+export declare function reportMessageSubmission(ctx: Context, submission: MessageSubmission): void;
+//# sourceMappingURL=submission-analytics.d.ts.map

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

@@ -29,6 +29,9 @@ export declare const zh: {
     'attachment.dropTitle': string;
     'attachment.dropDesc': string;
     'attachment.dropBlocked': string;
+    'attachment.directoryDesktopOnly': string;
+    'attachment.pathUnavailable': string;
+    'attachment.pathUnsupported': string;
     'image.pending': string;
     'image.openOriginal': string;
     'image.openOriginalLabel': string;
@@ -65,14 +68,6 @@ export declare const zh: {
     'settings.enter.description': string;
     'settings.enter.queue': string;
     'settings.enter.steer': string;
-    'settings.width.title': string;
-    'settings.width.description': string;
-    'settings.width.adaptive': string;
-    'settings.width.unit': string;
-    'settings.width.increase': string;
-    'settings.width.decrease': string;
-    'settings.width.customize': string;
-    'settings.width.reset': string;
     'hero.headline': string;
     'hero.tagline': string;
     'hero.greeting.morning': string;
@@ -80,6 +75,8 @@ export declare const zh: {
     'hero.greeting.evening': string;
     'hero.chooseWorkspace': string;
     'session.hierarchy': string;
+    'session.moreViews': string;
+    'session.moreViewsCurrent': string;
     'todo.title': string;
     'todo.progress.done': string;
     'todo.progress.active': string;
@@ -110,6 +107,7 @@ export declare const zh: {
     'row.stopped': string;
     'row.input': string;
     'row.output': string;
+    'row.commandArguments': string;
     'row.inspect': string;
     'tool.title.search': string;
     'tool.title.read': string;
@@ -414,6 +412,9 @@ export declare const en: {
     'attachment.dropTitle': string;
     'attachment.dropDesc': string;
     'attachment.dropBlocked': string;
+    'attachment.directoryDesktopOnly': string;
+    'attachment.pathUnavailable': string;
+    'attachment.pathUnsupported': string;
     'image.pending': string;
     'image.openOriginal': string;
     'image.openOriginalLabel': string;
@@ -450,14 +451,6 @@ export declare const en: {
     'settings.enter.description': string;
     'settings.enter.queue': string;
     'settings.enter.steer': string;
-    'settings.width.title': string;
-    'settings.width.description': string;
-    'settings.width.adaptive': string;
-    'settings.width.unit': string;
-    'settings.width.increase': string;
-    'settings.width.decrease': string;
-    'settings.width.customize': string;
-    'settings.width.reset': string;
     'hero.headline': string;
     'hero.tagline': string;
     'hero.greeting.morning': string;
@@ -465,6 +458,8 @@ export declare const en: {
     'hero.greeting.evening': string;
     'hero.chooseWorkspace': string;
     'session.hierarchy': string;
+    'session.moreViews': string;
+    'session.moreViewsCurrent': string;
     'todo.title': string;
     'todo.progress.done': string;
     'todo.progress.active': string;
@@ -495,6 +490,7 @@ export declare const en: {
     'row.stopped': string;
     'row.input': string;
     'row.output': string;
+    'row.commandArguments': string;
     'row.inspect': string;
     'tool.title.search': string;
     'tool.title.read': string;

package/lib/types/client/skeleton/ConversationSession.d.ts

@@ -10,7 +10,7 @@ export type ConversationSessionHeaderProps = ConversationSessionHeaderSlotProps;
  * @param props - Session identity, parent-owned chrome visibility, view ledger, navigation, render, and locale shares.
  * @returns the title row and, with more than one View, the tab strip.
  */
-export declare function ConversationSessionHeader({ sessionId, hideChrome, useSessions, useConversationViews, useStore, renderSlot, open, selectView, t, }: ConversationSessionHeaderProps): import("react").JSX.Element;
+export declare function ConversationSessionHeader({ sessionId, hideChrome, useSessions, useConversationViews, useStore, renderSlot, open, selectView, setPinned, t, useEntryPins, useEntryActions, }: ConversationSessionHeaderProps): import("react").JSX.Element;
 /**
  * Renders the active Session view inside the resident scrollport and keeps
  * the input draft mirrored while blank Hero chrome is visible.

package/lib/types/client/skeleton/DefaultConversationViews.d.ts

@@ -1,9 +1,9 @@
 import type { ConversationSessionSlotProps } from '../contract/slots.ts';
 /**
  * Renders the active Session view inside the resident scrollport and keeps
- * the input draft mirrored while blank Hero chrome is visible.
+ * the input draft persisted while blank Hero chrome is visible.
  * @param props - Strict Session input/store, view ledger, and render shares.
  * @returns the active view area, or null while the Session remains blank.
  */
-export declare function DefaultConversationViews({ view, useSession, useConversation, useConversationViews, useInput, inputActions, useStore, actions, renderSlot, bindDraftMirror, openView, }: ConversationSessionSlotProps): import("react").JSX.Element | null;
+export declare function DefaultConversationViews({ view, useSession, useConversation, useConversationViews, inputActions, useStore, actions, renderSlot, bindDraftPersistence, openView, }: ConversationSessionSlotProps): import("react").JSX.Element | null;
 //# sourceMappingURL=DefaultConversationViews.d.ts.map

package/lib/types/client/skeleton/InputBar.d.ts

@@ -14,5 +14,5 @@
  */
 import type { ComposerBarProps } from '../contract/slots.ts';
 export type InputBarProps = ComposerBarProps;
-export declare const InputBar: import("react").MemoExoticComponent<({ useSession, useInput, inputActions, keyboard, addFiles, removeAttachment, resolveDraftAttachments, retryFileUpload, toggleCommandMenu, stop, t, renderSlot, useBusyEnter, useFileUploads, useNotices, useLexicon, useMenuLauncher, useProjection, sessionId, variant, disabled: inert, blocked, workspacePickerOpen, onRequestWorkspace, placeholder, accessory, }: InputBarProps) => import("react").JSX.Element>;
+export declare const InputBar: import("react").MemoExoticComponent<({ useSession, useInput, inputActions, keyboard, addFiles, removeAttachment, resolveDraftAttachments, retryFileUpload, toggleCommandMenu, stop, t, renderSlot, useBusyEnter, useFileUploads, useNotices, useLexicon, useMenuLauncher, useStopShortcut, useProjection, sessionId, variant, disabled: inert, blocked, workspacePickerOpen, onRequestWorkspace, placeholder, accessory, }: InputBarProps) => import("react").JSX.Element>;
 //# sourceMappingURL=InputBar.d.ts.map

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

@@ -2,9 +2,10 @@
 import { type EngineStoreHandle } from '@qilin-agent/client-store';
 import type { SessionId } from '@qilin-agent/session/types';
 import type { ConversationStoreState } from './contract/views.ts';
+import type { DraftInput, DraftSnapshot } from './contract/draft-editor.ts';
 /** Declared write set for the Conversation shell. */
 type ConversationActions = {
-    setDraft: (draft: ConversationStoreState, text: string) => void;
+    setDraft: (draft: ConversationStoreState, text: DraftInput) => void;
     setView: (draft: ConversationStoreState, view: string) => void;
     openView: (draft: ConversationStoreState, view: string, focus: string) => void;
     completeViewRequest: (draft: ConversationStoreState) => void;
@@ -14,6 +15,12 @@ type ConversationActions = {
  * @returns the store handle.
  */
 export declare function createConversationStore(): EngineStoreHandle<ConversationStoreState, ConversationActions>;
+/**
+ * Read a Session's draft before its input source is published to React.
+ * @param sessionId - Session-scoped persistence suffix.
+ * @returns saved semantic content, or an empty document when storage is absent or invalid.
+ */
+export declare function readConversationDraft(sessionId: SessionId): DraftSnapshot;
 /**
  * Read the persisted View preference before the Slot store is materialized.
  * @param sessionId - Session-scoped persistence suffix.

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

@@ -0,0 +1,22 @@
+/** In-memory pin choices for the Conversation View tabs. */
+import { type ObservableSnapshot } from '@qilin-agent/client-store';
+/** View whose tab always shows and never enters the customization list. */
+export declare const FIXED_VIEW_ID = "chat";
+/** Unpinned View ids and their only mutation. */
+export interface ViewPins {
+    /** Unpinned View ids; ids of Views that are not registered stay listed. */
+    readonly unpinned: ObservableSnapshot<readonly string[]>;
+    /**
+     * Pin or unpin one View tab; the fixed View is ignored. A pinned tab still
+     * enters More when the header's width budget cannot hold it.
+     * @param id - View id.
+     * @param pinned - Whether the tab is manually pinned.
+     */
+    readonly setPinned: (id: string, pinned: boolean) => void;
+}
+/**
+ * Create the in-memory View pin list; the snapshot keeps its reference until the list changes.
+ * @returns Unpinned View ids and the pin mutation.
+ */
+export declare function createViewPins(): ViewPins;
+//# sourceMappingURL=view-pins.d.ts.map

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

@@ -34,5 +34,9 @@ export interface ConversationSettings {
     contentWidth: number;
 }
 /** Durable conversation schema; also the wire envelope the browser scope validates against. */
+export declare const ConversationSettingsFields: {
+    busyEnter: z<"queue" | "steer", "queue" | "steer", "defined">;
+    contentWidth: z<number, number, "defined">;
+};
 export declare const ConversationSettingsSchema: z<ConversationSettings>;
 //# sourceMappingURL=conversation-settings.d.ts.map

package/lib/types/index.d.ts

@@ -1,9 +1,24 @@
-/** Host registration for browser conversation preferences. */
-import type { Context } from '@qilin-agent/kylin';
+import type { Volatile, Context } from '@qilin-agent/kylin';
+import type { BusyEnterBehavior } from './conversation-settings.ts';
+import z from '@qilin-agent/schemastery';
 export { BUSY_ENTER_BEHAVIORS, BUSY_ENTER_FIELD, CONVERSATION_SETTINGS_NAMESPACE, CONTENT_WIDTH_ADAPTIVE, CONTENT_WIDTH_FIELD, CONTENT_WIDTH_MAX, CONTENT_WIDTH_MIN, CONTENT_WIDTH_STEP, DEFAULT_BUSY_ENTER_BEHAVIOR, DEFAULT_CONTENT_WIDTH, type BusyEnterBehavior, type ConversationSettings, } from './conversation-settings.ts';
-/**
- * Register the durable conversation section when a settings provider exists.
- * @param ctx - Host context whose optional settings service owns the section.
+/** Runtime preferences projected to the browser. */
+export interface Config {
+    /** Enter key behavior while a turn is running. */
+    busyEnter: Volatile<BusyEnterBehavior>;
+    /** Transcript content width in px, or 0 for the layout's adaptive clamp. */
+    contentWidth: Volatile<number>;
+}
+/** Live preferences projected to the browser. */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    busyEnter: z<"queue" | "steer", "queue" | "steer", "volatile-defined">;
+    contentWidth: z<number, number, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    busyEnter: z<"queue" | "steer", "queue" | "steer", "volatile-defined">;
+    contentWidth: z<number, number, "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