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

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

@@ -12,8 +12,8 @@ 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 { 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 } from '../contract/composer-submission.ts';
 /** Popup face the shell needs (dismissal only; typed structurally to avoid a value import). */
 export interface PopupDismissFace {
@@ -72,11 +72,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,15 +96,40 @@ 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 - replacement content and explicit permission to clear existing text.
+     * @returns whether text changed, was preserved, or submission prevented editing.
+     */
+    requestDraftInitialization(options: DraftInitializationOptions): DraftInitializationResult;
+    private draftInitializationBlocked;
     /** Append ordered attachment ids unless an admission transaction is locked. */
     addAttachments(ids: readonly DraftAttachmentId[]): boolean;
     /**
@@ -182,6 +212,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 +272,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 +293,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;

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

@@ -11,7 +11,7 @@ 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 +30,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/locales.d.ts

@@ -65,14 +65,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;
@@ -110,6 +102,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;
@@ -450,14 +443,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;
@@ -495,6 +480,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/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/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/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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@qilin-agent/client-ui-conversation",
   "description": "Target-neutral Conversation assembly, shell, composer, queue, and view navigation",
-  "version": "3.1.5",
+  "version": "3.1.6",
   "publishConfig": {
     "access": "public"
   },
@@ -46,10 +46,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@qilin-agent/schemastery": "~3.18.3"
+    "@qilin-agent/schemastery": "~3.18.5"
   },
   "peerDependencies": {
-    "@qilin-agent/kylin": "~4.0.3"
+    "@qilin-agent/kylin": "~4.0.5"
   },
   "devDependencies": {
     "@lexical/headless": "^0.49.0",
@@ -64,38 +64,38 @@
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
     "zod": "^4.4.3",
-    "@qilin-agent/api-remotes": "3.1.5",
-    "@qilin-agent/agent": "3.1.5",
-    "@qilin-agent/api-session-controller": "3.1.5",
-    "@qilin-agent/attachment": "3.1.5",
-    "@qilin-agent/api-workspace-controller": "3.1.5",
-    "@qilin-agent/brand": "3.1.5",
-    "@qilin-agent/client-locale": "3.1.5",
-    "@qilin-agent/client-shortcuts": "3.1.5",
-    "@qilin-agent/client-file-upload": "3.1.5",
-    "@qilin-agent/client-store": "3.1.5",
-    "@qilin-agent/client-test-runtime": "3.1.5",
-    "@qilin-agent/client-ui-layout": "3.1.5",
-    "@qilin-agent/client-ui-primitives": "3.1.5",
-    "@qilin-agent/client-ui-renderer": "3.1.5",
-    "@qilin-agent/client-ui-session": "3.1.5",
-    "@qilin-agent/client-ui-settings": "3.1.5",
-    "@qilin-agent/client-ui-slots": "3.1.5",
-    "@qilin-agent/client-ui-workspace": "3.1.5",
-    "@qilin-agent/commands": "3.1.5",
-    "@qilin-agent/goal": "3.1.5",
-    "@qilin-agent/kylin": "~4.0.3",
-    "@qilin-agent/llm": "3.1.5",
-    "@qilin-agent/plan-mode": "3.1.5",
-    "@qilin-agent/session": "3.1.5",
-    "@qilin-agent/settings": "3.1.5",
-    "@qilin-agent/llm-retry": "3.1.5",
-    "@qilin-agent/token-meter": "3.1.5",
-    "@qilin-agent/tool-todo": "3.1.5",
-    "@qilin-agent/util-crypto": "3.1.5",
-    "@qilin-agent/util-workspace-path": "3.1.5",
-    "@qilin-agent/workspace": "3.1.5",
-    "@qilin-agent/util-values": "3.1.5"
+    "@qilin-agent/agent": "3.1.6",
+    "@qilin-agent/api-remotes": "3.1.6",
+    "@qilin-agent/api-session-controller": "3.1.6",
+    "@qilin-agent/api-workspace-controller": "3.1.6",
+    "@qilin-agent/attachment": "3.1.6",
+    "@qilin-agent/brand": "3.1.6",
+    "@qilin-agent/client-locale": "3.1.6",
+    "@qilin-agent/client-file-upload": "3.1.6",
+    "@qilin-agent/client-shortcuts": "3.1.6",
+    "@qilin-agent/client-store": "3.1.6",
+    "@qilin-agent/client-ui-layout": "3.1.6",
+    "@qilin-agent/client-test-runtime": "3.1.6",
+    "@qilin-agent/client-ui-primitives": "3.1.6",
+    "@qilin-agent/client-ui-renderer": "3.1.6",
+    "@qilin-agent/client-ui-session": "3.1.6",
+    "@qilin-agent/client-ui-workspace": "3.1.6",
+    "@qilin-agent/client-ui-slots": "3.1.6",
+    "@qilin-agent/commands": "3.1.6",
+    "@qilin-agent/goal": "3.1.6",
+    "@qilin-agent/kylin": "~4.0.5",
+    "@qilin-agent/client-ui-settings": "3.1.6",
+    "@qilin-agent/llm": "3.1.6",
+    "@qilin-agent/session": "3.1.6",
+    "@qilin-agent/settings": "3.1.6",
+    "@qilin-agent/llm-retry": "3.1.6",
+    "@qilin-agent/plan-mode": "3.1.6",
+    "@qilin-agent/util-values": "3.1.6",
+    "@qilin-agent/util-crypto": "3.1.6",
+    "@qilin-agent/tool-todo": "3.1.6",
+    "@qilin-agent/token-meter": "3.1.6",
+    "@qilin-agent/util-workspace-path": "3.1.6",
+    "@qilin-agent/workspace": "3.1.6"
   },
   "files": [
     "lib/index.js",

package/lib/types/client/input/editor/claim-decor.d.ts

@@ -1,23 +0,0 @@
-/**
- * Claim-token highlight: while a command claim holds, the draft's leading
- * token renders in the warn color. A TextNode transform keeps the token in
- * its own styled node (splitting when typing merges text into it), and the
- * shell nudges the first leaf dirty when the claim flips so entering and
- * leaving claimed restyles without a text edit.
- */
-import type { LexicalEditor } from 'lexical';
-/**
- * Register the claim-token styling transform.
- * @param editor - the shell-owned editor.
- * @param activeToken - live claim token accessor; null while unclaimed.
- * @returns the unregister disposer.
- */
-export declare function registerClaimDecoration(editor: LexicalEditor, activeToken: () => string | null): () => void;
-/**
- * Nudge the token seat dirty so the transform restyles after a claim flip
- * (claims change phase without a text edit; transforms only run on dirty
- * nodes).
- * @param editor - the shell-owned editor.
- */
-export declare function refreshClaimDecoration(editor: LexicalEditor): void;
-//# sourceMappingURL=claim-decor.d.ts.map

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

@@ -1,26 +0,0 @@
-/**
- * General Settings row for the transcript content width. The pill carries the
- * persisted width — the word for the adaptive column clamp, otherwise the px
- * value — and steps it by CONTENT_WIDTH_STEP. Reverting to the clamp is an
- * explicit action, never a stepper bound.
- */
-import type { SnapshotStore } from '@qilin-agent/client-store';
-import type { InjectFace, PropsLocale, PropsRuntime } from '@qilin-agent/client-ui-slots';
-/** Registration-side preference face. */
-export interface ContentWidthRowInjected {
-    hooks: {
-        /** Persisted transcript width bound as useContentWidth. */
-        contentWidth: SnapshotStore<number>;
-    };
-    /** Persist a width, or {@link CONTENT_WIDTH_ADAPTIVE} to return to the adaptive clamp. */
-    setContentWidth: (px: number) => void;
-}
-/** Full Settings-row props. */
-export type ContentWidthRowProps = PropsRuntime<'settings.general.item'> & PropsLocale<'conversation'> & InjectFace<ContentWidthRowInjected>;
-/**
- * Render the transcript width row.
- * @param props - composed Settings slot props.
- * @returns the preference row.
- */
-export declare function ContentWidthRow({ t, useContentWidth, setContentWidth }: ContentWidthRowProps): import("react").JSX.Element;
-//# sourceMappingURL=ContentWidthRow.d.ts.map