@deepseek-ai/dsh-client-ui-conversation 0.2.0-rc.2 → 0.2.1-alpha.1

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

@@ -160,6 +160,12 @@ export interface ConversationContextReader {
 export type ConversationPublication = 'none' | 'animation-frame' | 'immediate';
 /** Engine-owned Location data publication phase. */
 export type ConversationLocationDataScope = 'step' | 'turn';
+/**
+ * Extract a stable business identity using only the current event.
+ * @param event - durable or transient Client event.
+ * @returns identity and lifecycle role, or null when unrelated.
+ */
+export type ConversationMatchHandler = (event: SessionEventLike) => ConversationMatchResult | null;
 /** One independently registered business Event-to-Node state machine. */
 export interface ConversationNodeDefinition<State = unknown> {
     readonly kind: string;
@@ -213,6 +219,10 @@ export interface ConversationNodeDefinition<State = unknown> {
      */
     buildViewNode?(context: ConversationNodeContext<State>): ConversationViewNode | null;
 }
+/** Registration accepts a function or an immutable table of own event-type handlers. */
+export type ConversationNodeDefinitionInput<State = unknown> = Omit<ConversationNodeDefinition<State>, 'match'> & {
+    readonly match: ConversationMatchHandler | Readonly<Record<string, ConversationMatchHandler>>;
+};
 /** Reference-stable Turn/Step facts published beside view Nodes. */
 export interface ConversationTimelineSnapshot {
     readonly turnOrder: readonly number[];

package/lib/types/client/contract/draft-editor.d.ts

@@ -16,6 +16,18 @@ export interface ReferenceInsert {
     readonly appearance?: 'session' | 'file' | 'folder';
     readonly clipboardText: string;
 }
+/** Persisted reference data without the current editor's occurrence identity. */
+export type DraftReference = Omit<Occurrence, 'occurrenceId'>;
+/**
+ * Editor-independent content. Reference spans are ordered, non-overlapping UTF-16
+ * ranges whose text equals clipboardText; runtime node identities are excluded.
+ */
+export interface DraftSnapshot {
+    readonly text: string;
+    readonly references: readonly DraftReference[];
+}
+/** Plain initial text or an existing document with explicit reference identities. */
+export type DraftInput = string | DraftSnapshot;
 /** Keyboard keys intercepted by an open trigger menu. */
 export type ArbitrateKey = 'up' | 'down' | 'enter' | 'escape' | 'tab' | 'tabBack';
 /** Trigger-menu keyboard routing result. */

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

@@ -7,6 +7,7 @@
  * here is the submit plane (phase, claim, attempt) alone.
  */
 import type { Context } from '@deepseek-ai/cordis';
+import type { SessionBinding } from '@deepseek-ai/dsh-api-session-controller/client';
 import type { InboxState } from '@deepseek-ai/dsh-agent/types';
 import type { ObservableSnapshot, SnapshotStore } from '@deepseek-ai/dsh-client-store';
 import type { Branded } from '@deepseek-ai/dsh-brand';
@@ -161,7 +162,7 @@ export interface InputTarget {
 }
 /** Per-session input facade owned by the conversation wiring layer. */
 export interface SessionInput extends InputTarget {
-    /** Replace the whole draft (persisted-draft seed and programmatic writes). */
+    /** Replace the whole draft with plain text, removing inline reference chips. */
     setDraft(text: string): void;
     /** Append ordered browser-owned attachment ids; busy admission phases refuse. */
     addAttachments(ids: readonly DraftAttachmentId[]): boolean;
@@ -196,7 +197,22 @@ export interface SessionInput extends InputTarget {
 export interface SessionInputResolver {
     /** Resolve the facade for one session-scope ctx. */
     for(actx: Context): SessionInput;
+    /**
+     * Prepare the exact retained Session before navigation publishes it.
+     * @param binding - target Session generation, already retained by the caller.
+     * @param options - content to adopt and explicit permission to replace existing text.
+     * @returns applied, preserved, or blocked by a pending submission or disposal.
+     * @throws when binding is not the currently retained Session generation.
+     */
+    requestDraftInitialization(binding: SessionBinding, options: DraftInitializationOptions): DraftInitializationResult;
+}
+/** Initial text for a target Session; attachments remain under their existing owner. */
+export interface DraftInitializationOptions {
+    readonly prompt?: string;
+    readonly clearPreviousDraft?: boolean;
 }
+/** An initialization request never waits for a React mount or a remote catalog. */
+export type DraftInitializationResult = 'applied' | 'preserved' | 'blocked';
 /**
  * The public input action face provided to every session-scope slot
  * component: stable-identity void callbacks, mirroring the
@@ -213,8 +229,10 @@ export interface InputActions {
      * @returns false when the draft changed or submission locked the editor.
      */
     insertText(text: string, span: TokenSpan): boolean;
-    /** Replace the whole draft (persisted-draft seed and programmatic writes). */
+    /** Replace the whole draft with plain text, removing inline reference chips. */
     setDraft(text: string): void;
+    /** Write the current semantic document through the mounted persistence callback. */
+    persistDraft(): void;
     /** Append ordered browser-owned attachment ids; busy admission phases refuse. */
     addAttachments(ids: readonly DraftAttachmentId[]): boolean;
     /** Remove one browser-owned attachment id; busy admission phases refuse. */

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

@@ -5,6 +5,7 @@ import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { LlmRetryEventData } from '@deepseek-ai/dsh-llm-retry/types';
 import type { TodoItem } from '@deepseek-ai/dsh-tool-todo/client';
 import type { ContextProducerView, KnownContextForm } from './context-producer.ts';
+import type { PartialArguments } from '@deepseek-ai/dsh-util-values';
 export type { TodoItem };
 /** Request configuration recorded for one provider call. */
 export interface AssistantRequestConfig {
@@ -156,6 +157,10 @@ export interface ToolResultNode {
     callId: string;
     /** Parent Tool call for a PTC dispatch result; absent on a root Session result. */
     parentCallId?: string;
+    /** Wire tool name from the paired tool/call; empty when that call left the loaded window. */
+    name: string;
+    /** The argument view of the paired call; see {@link ToolArgs}. */
+    args: ToolArgs;
     /** Call head backfilled from the in-window tool/call; null when window truncation left the call outside (card head shows callId). */
     call: {
         name: string;
@@ -256,8 +261,21 @@ interface ToolCallHead {
     time: number;
     /** Child calls owned by this call, in dispatch order. */
     subCalls: readonly ToolCallBlock[];
+    /** The argument view; see {@link ToolArgs}. */
+    args: ToolArgs;
 }
-/** A named model call whose arguments are not yet available to tool views. */
+/**
+ * Lazy top-level argument readers shared by preparing, start, and result;
+ * {@link PartialArguments} defines field, prefix, length, and completion reads.
+ * A preparing view grows in place. Read it during render or view construction,
+ * not into independent state keyed only by the args or block object identity.
+ * The Definition publishes the initial named block, then republishes when an
+ * observed answer changes. Unread fields alone do not request republication.
+ * Dispatched views are sealed over finished text or parsed values. The view is
+ * empty for a result whose `tool/call` left the loaded window.
+ */
+export type ToolArgs = PartialArguments;
+/** A named model call whose complete arguments are not yet available to tool views. */
 export interface PreparingToolCall extends ToolCallHead {
     readonly phase: 'preparing';
 }

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

@@ -11,7 +11,7 @@ import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { WorkspaceId } from '@deepseek-ai/dsh-workspace/types';
 import type { ComposerBlock } from './composer-blocks.ts';
 import type { DraftAttachmentId, InputActions, InputNotice, InputState } from './input.ts';
-import type { ComposerKeyboard, EditSelection } from './draft-editor.ts';
+import type { ComposerKeyboard, DraftSnapshot, EditSelection } from './draft-editor.ts';
 import type { createConversationStore } from '../stores.ts';
 import type { BusyEnterBehavior } from './composer-submission.ts';
 import type { ConversationSnapshot } from './snapshot.ts';
@@ -410,7 +410,7 @@ export interface ConversationSessionInjected {
         readonly inspectCall: ObservableSnapshot<ConvViewOwnerProps['inspectCall']>;
     };
     /** Bind input draft persistence to the Session-owned store instance. */
-    bindDraftMirror: (write: (text: string) => void) => () => void;
+    bindDraftPersistence: (write: (draft: DraftSnapshot) => void) => () => void;
     /** Select and activate one View while addressing an opaque focus request to it. */
     openView: (view: string, focus: string) => void;
 }

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

@@ -1,4 +1,5 @@
 /** Conversation view and session-local presentation state. */
+import type { DraftInput } from './draft-editor.ts';
 /**
  * One conversation view tab, projected from a 'conversation.view' slot
  * entry's registration options (label falls back to the entry id).
@@ -17,7 +18,7 @@ export interface ConversationViewRequest {
 /** Per-session state owned by the target-neutral Conversation shell. */
 export interface ConversationStoreState {
     /** Composer draft (persisted; survives session switches and reloads). */
-    draft: string;
+    draft: DraftInput;
     /** Preferred `conversation.view` entry id; null resolves to Chat when registered. */
     view: string | null;
     /** Focus request consumed and acknowledged by the addressed View. */

package/lib/types/client/conversation/assembler.d.ts

@@ -2,8 +2,9 @@ import type { SessionAssistantSettlementEntry, SessionEventLikeEntry } from '@de
 import type { LlmAttemptId } from '@deepseek-ai/dsh-llm/brand';
 import type { ConversationNodeDefinition, ConversationPublication, ConversationViewDefinition, ConversationViewSnapshotMap, ConversationViewSnapshotStore } from '../contract/conversation.ts';
 import type { ConversationGroupData, ConversationGroupDefinition, ConversationGroupedView } from '../contract/groups.ts';
+import type { ConversationEventRegistry } from './event-registry.ts';
 /** Event Registry subset consumed by a Session-owned Assembler. */
-export interface ConversationEventDefinitions {
+export interface ConversationEventDefinitions extends Partial<Pick<ConversationEventRegistry, 'forEvent'>> {
     /** @returns ordinary Definitions in registration order. */
     entries(): readonly ConversationNodeDefinition[];
     /** @returns unmatched-event fallback, when registered. */

package/lib/types/client/conversation/event-registry.d.ts

@@ -1,24 +1,40 @@
-import type { ConversationNodeDefinition } from '../contract/conversation.ts';
+import type { ConversationMatchHandler, ConversationNodeDefinition, ConversationNodeDefinitionInput } from '../contract/conversation.ts';
 import { ConversationDefinitionRegistry } from './definition-registry.ts';
+/** A registered Definition and its event-type-selected handler. */
+export interface ConversationEventRoute {
+    readonly definition: ConversationNodeDefinition;
+    readonly match: ConversationMatchHandler;
+}
 /** Runtime registry of independently owned Conversation business Definitions. */
 export declare class ConversationEventRegistry extends ConversationDefinitionRegistry<ConversationNodeDefinition> {
     private fallback;
+    private routes;
+    private unrestricted;
+    private readonly tables;
     /**
      * Register a uniquely named business Definition for the caller's lifetime.
      * @param definition - Definition contribution.
      * @returns idempotent disposer.
      */
-    register(definition: ConversationNodeDefinition): () => void;
+    register(definition: ConversationNodeDefinitionInput): () => void;
     /**
      * Register the sole fallback used only when no ordinary Definition matches.
-     * @param definition - fallback Definition.
+     * @param input - fallback Definition.
      * @returns idempotent disposer.
      */
-    registerFallback(definition: ConversationNodeDefinition): () => void;
+    registerFallback(input: ConversationNodeDefinitionInput): () => void;
     /**
      * Return the current unmatched-event fallback.
      * @returns installed fallback, when present.
      */
     fallbackEntry(): ConversationNodeDefinition | undefined;
+    /**
+     * Read precomputed candidates in registration order; the returned Set is borrowed read-only.
+     * @param type - current event type.
+     * @returns table handlers for this type together with all function-form handlers.
+     */
+    forEvent(type: string): ReadonlySet<ConversationEventRoute>;
+    private resolve;
+    protected refresh(): void;
 }
 //# sourceMappingURL=event-registry.d.ts.map

package/lib/types/client/conversation/location-index.d.ts

@@ -10,8 +10,8 @@ export interface ConversationLocationDataChange {
 /** Session-owned Turn/Step timeline and event-to-Location index. */
 export declare class ConversationLocationIndex {
     private coordinates;
-    private locations;
     private seqsByTurn;
+    private readonly stepsByTurn;
     private timeline;
     private readonly turnDataStores;
     private readonly stepDataStores;
@@ -65,7 +65,7 @@ export declare class ConversationLocationIndex {
      */
     appendBoundary(event: SessionEvent): ReadonlySet<number>;
     /**
-     * Index one non-boundary tail event without rescanning the window.
+     * Index one non-boundary tail event without scanning the window or the Turn's Steps.
      * @param event - contiguous appended event.
      */
     appendNonBoundary(event: SessionEventLike): void;

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

@@ -0,0 +1,21 @@
+import type { DraftInput, DraftSnapshot, Occurrence } from './contract/draft-editor.ts';
+/**
+ * Copy input into the semantic draft representation without editor runtime identities.
+ * @param input - plain text or caller-owned structured content.
+ * @returns an owned snapshot ready for editor import.
+ */
+export declare function resolveDraftInput(input: DraftInput): DraftSnapshot;
+/**
+ * Decode persisted drafts, accepting the earlier plain-string representation.
+ * @param value - JSON value read from browser storage.
+ * @returns the decoded draft, or undefined for invalid data.
+ */
+export declare function parseStoredDraft(value: unknown): DraftSnapshot | undefined;
+/**
+ * Export reference identities without their editor-local occurrence ids.
+ * @param text - current clipboard projection.
+ * @param occurrences - matching reference projections from the same document revision.
+ * @returns an editor-independent snapshot.
+ */
+export declare function snapshotDraft(text: string, occurrences: readonly Occurrence[]): DraftSnapshot;
+//# sourceMappingURL=draft.d.ts.map

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

@@ -7,10 +7,10 @@ export type { ConversationGroupRegistry } from './conversation/group-registry.ts
 export type { ConversationGroupContext, ConversationGroupData, ConversationGroupDataMap, ConversationGroupDefinition, ConversationGroupedView, ConversationGroupInput, GroupKey, GroupNodePosition, GroupReference, GroupSnapshot, GroupUpdate, NodeChange, NodeKey, NodeReference, RenderEntry, } from './contract/groups.ts';
 export { ConversationController, UnsupportedImageMediaTypeError } from './service.ts';
 export type { IConversation } from './service.ts';
-export type { ConversationContextReader, ConversationLocation, ConversationLocationData, ConversationLocationDataScope, ConversationLocationDataSource, ConversationLocationDataStore, ConversationMatch, ConversationMatchResult, ConversationNodeContext, ConversationNodeDefinition, ConversationPreviousContext, ConversationPublication, ConversationStartMatch, ConversationStepDataMap, ConversationTimelineSnapshot, ConversationTurnDataMap, ConversationViewBuilder, ConversationViewDefinition, ConversationViewNode, ConversationViewSnapshotMap, ConversationViewSnapshotStore, StepLocation, TurnLocation, } from './contract/conversation.ts';
+export type { ConversationContextReader, ConversationLocation, ConversationLocationData, ConversationLocationDataScope, ConversationLocationDataSource, ConversationLocationDataStore, ConversationMatch, ConversationMatchHandler, ConversationMatchResult, ConversationNodeContext, ConversationNodeDefinition, ConversationNodeDefinitionInput, ConversationPreviousContext, ConversationPublication, ConversationStartMatch, ConversationStepDataMap, ConversationTimelineSnapshot, ConversationTurnDataMap, ConversationViewBuilder, ConversationViewDefinition, ConversationViewNode, ConversationViewSnapshotMap, ConversationViewSnapshotStore, StepLocation, TurnLocation, } from './contract/conversation.ts';
 export { EMPTY_CONVERSATION_SNAPSHOT, conversationPhase } from './contract/snapshot.ts';
 export type { ConversationPhase, ConversationSnapshot, } from './contract/snapshot.ts';
-export type { AssistantBlock, AssistantMessageNode, AssistantProviderMetadataView, AssistantRequestConfig, AssistantTiming, CommandNode, CompactionSummaryNode, ContextMessageNode, ConversationNode, ModelRetryNode, PartialAssistant, PreparingToolCall, RunningToolCall, StartedToolCall, SteeringMessageNode, TodoItem, ToolCallBlock, ToolResultNode, TurnErrorNode, TurnMaxTokensNode, UnknownSurfaceNode, UserMessageNode, } from './contract/records.ts';
+export type { AssistantBlock, AssistantMessageNode, AssistantProviderMetadataView, AssistantRequestConfig, AssistantTiming, CommandNode, CompactionSummaryNode, ContextMessageNode, ConversationNode, ModelRetryNode, PartialAssistant, PreparingToolCall, RunningToolCall, StartedToolCall, SteeringMessageNode, TodoItem, ToolCallBlock, ToolArgs, ToolResultNode, TurnErrorNode, TurnMaxTokensNode, UnknownSurfaceNode, UserMessageNode, } from './contract/records.ts';
 export type { ContextProducerView, ContextRole, KnownContextForm, } from './contract/context-producer.ts';
 export type { ConversationPromptSnapshot, RequestInspectionSnapshot, RequestPromptChange, RequestPromptInspection, RequestPromptInspector, RequestView, SystemPromptNode, } from './contract/request-inspection.ts';
 export { inspectRequestPrompt } from './contract/request-inspection.ts';
@@ -25,8 +25,8 @@ export type { ConversationLocationDataChange } from './conversation/location-ind
 export { ConversationViewRegistry } from './conversation/view-registry.ts';
 export type { ConversationKey } from './locales.ts';
 export type { ComposerAttachment, ComposerAttachmentsOwnerProps, ComposerAttachmentsProps, ComposerFileAttachment, ComposerImageAttachment, DraftFileUpload, DraftFileUploads, ComposerBarInjected, ComposerBarOwnerProps, ComposerBarProps, ComposerChainProps, ConversationHeaderActionOwnerProps, ConversationHeaderCornerOwnerProps, ConversationHeaderLineageOwnerProps, ConversationContentInputProps, ConversationContentProps, ConversationInjected, ConversationSessionHeaderInjected, ConversationSessionHeaderSlotProps, ConversationSessionInjected, ConversationSessionSlotProps, ConversationSlotProps, ConversationViewsProps, ConversationWidthControlsInputProps, ConversationWidthControlsProps, ConversationStore, ConvViewOwnerProps, ConvViewProps, EmptyWorkspaceOwnerProps, HeroAgentPresetOwnerProps, HeroBrandMarkOwnerProps, InputControlOwnerProps, InputZone, MessageImageLoader, MessageImageSource, MessageImagesOwnerProps, RenderMessageImages, UseConversation, UseConversationViews, } from './contract/slots.ts';
-export type { BeginCommandRequest, CommandClaim, ConsumeTokenRequest, DraftAttachmentId, InputActions, InputState, InsertReferenceRequest, InsertTextRequest, PickOutcome, SessionInput, SessionInputResolver, SubmitAttachment, SubmitOutcome, } from './contract/input.ts';
-export type { ArbitrateKey, ArbitrateOutcome, ReferenceInsert, TokenSpan } from './contract/draft-editor.ts';
+export type { BeginCommandRequest, CommandClaim, ConsumeTokenRequest, DraftAttachmentId, DraftInitializationOptions, DraftInitializationResult, InputActions, InputState, InsertReferenceRequest, InsertTextRequest, PickOutcome, SessionInput, SessionInputResolver, SubmitAttachment, SubmitOutcome, } from './contract/input.ts';
+export type { ArbitrateKey, ArbitrateOutcome, DraftInput, DraftReference, DraftSnapshot, ReferenceInsert, TokenSpan } from './contract/draft-editor.ts';
 export type { ComposerBlock, ComposerBlocks } from './contract/composer-blocks.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {

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

@@ -25,7 +25,7 @@ export interface TextRefRange {
  * exact lexicon member; a `/name` token must end at whitespace or the draft
  * end ('/name/x' is a path, '/name。' is prose).
  * @param draft - draft text.
- * @param lexicon - per-trigger name lists (a missing trigger scans nothing).
+ * @param lexicon - per-trigger name lists; missing catalogs match no named tokens.
  * @returns matched ranges in draft order.
  */
 export declare function scanTextRefs(draft: string, lexicon: ReadonlyMap<'/' | '@', readonly string[]>): TextRefRange[];

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

@@ -1,7 +1,7 @@
 /** The Composer model's private Lexical editor, projections, and node operations. */
 import type { ObservableSnapshot } from '@deepseek-ai/dsh-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 { EditorProjection } from './projection.ts';
 import type { DetectSpan } from './span-map.ts';
 type Lexicon = ReadonlyMap<'/' | '@', readonly string[]>;
@@ -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.
@@ -117,11 +116,11 @@ export declare class DraftEditorRuntime {
      */
     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/facade.d.ts

@@ -12,18 +12,17 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { InboxState } from '@deepseek-ai/dsh-agent/types';
 import { type ObservableSnapshot, type SnapshotStore } from '@deepseek-ai/dsh-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, 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;
 }
 /**
- * Construction dependencies of one facade. The slash/popup faces are THUNKS: the
- * shell is created inside the sessions provide materialization (before the
- * scope record is queryable), where `slash.sessionOf`/`command.popupFor`
- * cannot resolve yet — resolution defers to first interactive use.
+ * Construction dependencies of one input model. Trigger and popup callbacks
+ * resolve the currently available Session-scoped services on demand. InputHub
+ * owns the lexicon subscription through the Session scope's inject lifecycle.
  */
 export interface SessionInputDeps {
     /** Session-scope ctx handed to claim.submit transactions. */
@@ -76,11 +75,12 @@ 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;
     /** 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. */
@@ -101,9 +101,23 @@ export declare class SessionInputShell implements SessionInput {
      * 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 without waiting for another edit. */
+    refreshLexiconSubscription(): void;
+    /** 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 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;
     /**
@@ -245,14 +259,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.

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

@@ -2,7 +2,7 @@ import type { Context } from '@deepseek-ai/cordis';
 import type { SessionBinding } from '@deepseek-ai/dsh-api-session-controller/client';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
 import type { TranslateNS } from '@deepseek-ai/dsh-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). */
@@ -21,11 +21,11 @@ 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
-     * queryable, hence binding-fed and hence the thunked slash/popup deps).
-     * Wires the scoped event listeners + teardown into the session scope.
+     * Resolve the resident shell for an already-retained, addressable Session binding.
+     * Draft import completes before return. The Session scope owns input listeners,
+     * the inject-managed catalog subscription, and shell teardown.
      * @param binding - session assembly handle.
      * @returns the shell.
      */

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, useInspectCall, }: ConversationSessionSlotProps): import("react").JSX.Element | null;
+export declare function DefaultConversationViews({ view, useSession, useConversation, useConversationViews, inputActions, useStore, actions, renderSlot, bindDraftPersistence, openView, useInspectCall, }: 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 '@deepseek-ai/dsh-client-store';
 import type { SessionId } from '@deepseek-ai/dsh-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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-conversation",
   "description": "Target-neutral Conversation assembly, shell, composer, queue, and view navigation",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -42,10 +42,10 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
@@ -60,40 +60,40 @@
     "@lexical/text": "^0.49.0",
     "@lexical/plain-text": "^0.49.0",
     "@lexical/history": "^0.49.0",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-api-remotes": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-attachment": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-brand": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-file-upload": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-store": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-test-runtime": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-layout": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-commands": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-goal": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm-retry": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-plan-mode": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-util-values": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-token-meter": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-tool-todo": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-util-crypto": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-workspace": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-file-reference": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-util-workspace-path": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-agent": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-settings": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-shortcuts": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-client-product-analytics": "0.2.0-rc.2"
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.1",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-goal": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-plan-mode": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-token-meter": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-tool-todo": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-llm-retry": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.1",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.1"
   },
   "files": [
     "lib/index.js",