@deepseek-ai/dsh-client-ui-conversation 0.2.1-alpha.1 → 0.2.1-alpha.3

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

@@ -5,6 +5,16 @@ import type { ConversationGroupData, ConversationGroupedView, ConversationGroupI
 export interface ConversationMatchResult {
     readonly id: string;
     readonly role: 'start' | 'update';
+    /**
+     * Claim this event on the Definition's target: no other Definition of the
+     * same target receives it, and that target's unmatched-event fallback does
+     * not run. Definitions of other targets and Definitions without a target
+     * still receive it. Two claims on one target, or a claim from a Definition
+     * without a target, throw during dispatch. A claim returned by the fallback
+     * itself has no effect, because the fallback runs only when no Definition of
+     * its target matched.
+     */
+    readonly exclusive?: true;
 }
 /** Merge-extensible business values published against one Turn. */
 export interface ConversationTurnDataMap {

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

@@ -122,8 +122,9 @@ export type ModelRetryNode = LlmRetryEventData & {
     retryState: 'scheduled' | 'started' | 'cancelled';
 };
 /**
- * Durable terminal failure for a turn that ended with an error reason; the
- * turn's settled retry chain renders separately and never replaces this node.
+ * Durable terminal notice for a turn that ended with an error, a sign-out
+ * cancellation, or an interruption by a DSH stop; the turn's settled retry
+ * chain renders separately and never replaces this node.
  */
 export interface TurnErrorNode {
     kind: 'turn-error';
@@ -135,7 +136,11 @@ export interface TurnErrorNode {
     step: number;
     /** Sanitized provider message; empty when a known code owns localized copy. */
     message: string;
-    /** Stable provider failure code, when recorded. */
+    /**
+     * Stable provider failure code when recorded, or a Client display code:
+     * `ACCOUNT_SIGNED_OUT` for a sign-out cancellation, `INTERRUPTED` for a
+     * turn closed after DSH stopped.
+     */
     code?: string;
 }
 /** Durable notice for a turn ended by the per-request output-token cap. */

package/lib/types/client/contract/request-inspection.d.ts

@@ -83,8 +83,9 @@ interface RequestViewBase {
     startedAt: number;
     completedAt: number | null;
     status: 'running' | 'complete' | 'error';
+    /** Failure detail; with assistant retry metadata, the last failed attempt even while running or after recovery. */
     error?: string;
-    /** Stable provider code for localized presentation of known failures. */
+    /** Stable provider code for `error`, including retained attempt failures, for localized presentation. */
     errorCode?: string;
     providerMetadata?: AssistantProviderMetadataView;
     requestConfig?: AssistantRequestConfig;

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

@@ -3,6 +3,7 @@ import type { ReactNode, RefObject } from 'react';
 import type { FileAttachmentRef, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { SessionSnapshot } from '@deepseek-ai/dsh-api-session-controller/client';
 import type { FileUploadReceiptId } from '@deepseek-ai/dsh-client-file-upload/client';
+import type { ImageLightboxLabels } from '@deepseek-ai/dsh-client-ui-primitives';
 import type { WorkspaceSnapshot } from '@deepseek-ai/dsh-api-workspace-controller/client';
 import type { MaybeSnapshotSelectorHook, ObservableSnapshot, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-store';
 import type { FactoryComponentPropsOf, FactoryLocalComponentPropsOf, InjectFace, PropsLocale, PropsRenderFactories, PropsRenderSlots, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
@@ -16,6 +17,7 @@ import type { createConversationStore } from '../stores.ts';
 import type { BusyEnterBehavior } from './composer-submission.ts';
 import type { ConversationSnapshot } from './snapshot.ts';
 import type { ViewTab } from './views.ts';
+import type { UserTextDocumentInput, UserTextEvaluator, UserTextId, UserTextNode } from './user-text.ts';
 /** Browser-owned draft attachment that has not crossed the durable Host boundary. */
 export type ComposerAttachment = ComposerImageAttachment | ComposerFileAttachment;
 /** Browser-owned image, base64-encoded into the prompt at send time. */
@@ -110,14 +112,88 @@ export interface MessageImagesOwnerProps {
     /** Fixed, uncropped thumbnail for an attachment list row. */
     thumbnail?: boolean;
 }
-/** Slot-backed renderer used by Conversation targets without importing an attachment implementation. */
-export type RenderMessageImages = (owner: Omit<MessageImagesOwnerProps, 'loadImage'>) => ReactNode;
+/** Message-image strings the owner resolves from its own locale namespace. */
+export interface MessageImageLabels {
+    /** Fallback display name for an unnamed image. */
+    image: string;
+    /** Thumbnail tooltip inviting the original-image preview. */
+    open: string;
+    /** Accessible thumbnail label; receives the image's display name. */
+    openNamed: (label: string) => string;
+    /** Loading placeholder shown until bytes resolve. */
+    loading: string;
+    /** Retry-control label shown when the load fails. */
+    loadFailed: string;
+    /** Lightbox strings forwarded to the opened preview. */
+    lightbox: ImageLightboxLabels;
+}
+/** Root-scoped image gallery input with explicit reading authority and optional caller copy. */
+export interface MessageImagesContentInput extends MessageImagesOwnerProps {
+    readonly labels?: MessageImageLabels;
+}
+/** Transform inputs and independently controlled rendering behavior. */
+export interface UserTextInput extends UserTextDocumentInput {
+    /** Enable renderer-owned reference actions; omitted values keep references read-only. */
+    readonly interactive?: boolean;
+    /** Use CSS single-line overflow ellipsis without shortening source text. */
+    readonly ellipsis?: boolean;
+}
+/** Rule invalidation and document evaluation supplied by the data layer. */
+export interface UserTextInjected {
+    hooks: {
+        userTextRevision: ObservableSnapshot<number>;
+    };
+    /** Each invocation creates a caller-owned data-layer cache without registry subscriptions. */
+    createUserTextEvaluator: () => UserTextEvaluator;
+    /** Report a failed rule while the original text remains visible. */
+    reportTransformFailure: (error: unknown) => void;
+}
+/** JSON-only owner data common to every business text node. */
+export interface UserTextNodeOwnerProps {
+    readonly raw: string;
+    readonly interactive: boolean;
+}
+/** Complete props for the selected business node, including its Session scope. */
+export type UserTextNodeProps<Id extends UserTextId = UserTextId> = PropsRuntime<'conversation.user.text.node', Id>;
 /** Selector hook over the current Session's assembled Conversation. */
 export type UseConversation = SnapshotSelectorHook<ConversationSnapshot>;
 /** Selector hook over the registered Conversation View roster. */
 export type UseConversationViews = SnapshotSelectorHook<readonly ViewTab[]>;
 declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotFactoryMap {
+        /** Parse one original text and render its business nodes through the owned keyed Slot. */
+        'conversation.user.text': {
+            scope: 'session';
+            props: UserTextInput;
+            inject: UserTextInjected;
+            children: {
+                'conversation.user.text.node': {
+                    kind: 'keyed';
+                    scope: 'session';
+                    inline: true;
+                };
+            };
+        };
+        /** Official reusable gallery, with explicit authorized loading and optional caller copy. */
+        'conversation.images.content': {
+            scope: 'root';
+            props: MessageImagesContentInput;
+            locale: 'conversation';
+        };
+    }
     interface SlotMap {
+        /** One business-owned inline renderer for a pure JSON text node. */
+        'conversation.user.text.node': {
+            kind: 'keyed';
+            scope: 'session';
+            inline: true;
+            owner: UserTextNodeOwnerProps;
+            keyProps: {
+                [Id in UserTextId]: {
+                    node: UserTextNode<Id>;
+                };
+            };
+        };
         /** Conversation shell beneath its root-scoped main-panel entry. */
         'main.conversation': {
             kind: 'single';
@@ -210,6 +286,11 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
             scope: 'session-maybe';
             owner: HeroAgentPresetOwnerProps;
         };
+        /** Compact options right-aligned in the New Session row after the workspace and preset controls; rendered only with a Session. */
+        'conversation.hero.options': {
+            kind: 'list';
+            scope: 'session';
+        };
         /** Full-width entries above the composer card. */
         'conversation.input.dock': {
             kind: 'list';
@@ -311,6 +392,10 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
                     kind: 'single';
                     scope: 'session-maybe';
                 };
+                'conversation.hero.options': {
+                    kind: 'list';
+                    scope: 'session';
+                };
             };
             inject: ConversationInjected;
             locale: 'conversation';

package/lib/types/client/contract/user-text.d.ts

@@ -0,0 +1,60 @@
+/** Readonly JSON candidates, forward matching, and tracked caller Facts. */
+import type { UserTextDataMap, UserTextFacts } from '../index.ts';
+/** Registered business IDs plus the document-owned `text` ID. */
+export type UserTextId = Extract<keyof UserTextDataMap, string>;
+type JsonPayload<T> = T extends string | number | boolean | null ? T : T extends (...args: never[]) => unknown ? never : T extends readonly unknown[] ? {
+    readonly [K in keyof T]: JsonPayload<T[K]>;
+} : T extends object ? {
+    readonly [K in keyof T]: JsonPayload<T[K]>;
+} : never;
+/** Original UTF-16 text and readonly Facts; absence is observable through `context.read`. */
+export interface UserTextDocumentInput {
+    readonly text: string;
+    readonly facts: Readonly<Partial<UserTextFacts>>;
+}
+/** Discriminated JSON node over a nonempty half-open UTF-16 range in the original text. */
+export type UserTextNode<K extends UserTextId = UserTextId> = {
+    [Id in K]: {
+        readonly id: Id;
+        readonly start: number;
+        readonly end: number;
+        readonly data: JsonPayload<UserTextDataMap[Id]>;
+    };
+}[K];
+/** Facts reader valid only during its owning synchronous query; never retain it. */
+export interface UserTextTransformContext {
+    /**
+     * Record a field dependency, including an absent value; throws after the call returns or throws.
+     * @param key - field of the caller's readonly Facts snapshot.
+     * @returns the borrowed readonly value, or undefined when absent.
+     */
+    read<K extends keyof UserTextFacts>(key: K): UserTextFacts[K] | undefined;
+}
+/** One forward matcher for business references or Text replacements; order only resolves same-start candidates. */
+export interface UserTextRule<out Id extends string = string> {
+    readonly id: Id;
+    /** Finite ascending priority; equal values use stable ID ordering, never plugin load order. */
+    readonly order: number;
+    /**
+     * Find one nearest original-text candidate at or after `from`, resolving own same-start alternatives deterministically.
+     * Search uses original lexical boundaries, not the beginning of a sliced suffix. Queries are independent of accepted nodes.
+     * @param text - complete original text; neither this string nor caller Facts may be mutated.
+     * @param from - inclusive original UTF-16 start offset, advancing within one reconciliation.
+     * @param context - synchronous Facts reader; all retained queries contribute dependencies.
+     * @returns one nonempty node using this rule's ID or `text`, or undefined when no later candidate exists.
+     * Text candidates preserve the exact source substring and may supply `data.display`.
+     */
+    match(this: void, text: string, from: number, context: UserTextTransformContext): (UserTextNode & {
+        readonly id: Id;
+    }) | UserTextNode<'text'> | undefined;
+}
+/**
+ * Reconcile one document using current rules and independently cached candidate queries.
+ * Reentrant calls throw. Failures carry ruleId and cause without publishing partial output;
+ * failed queries retry when their offset, definition, original text, or read Facts change.
+ * @param input - original text and readonly JSON Facts; fields are compared with Object.is.
+ * @returns readonly nodes covering the text, or [] for empty text; equivalent results retain identities.
+ */
+export type UserTextEvaluator = (input: UserTextDocumentInput) => readonly UserTextNode[];
+export {};
+//# sourceMappingURL=user-text.d.ts.map

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

@@ -44,6 +44,9 @@ export declare class ConversationNodeAssembler implements ConversationViewSnapsh
     private readonly groups;
     private readonly pendingGroupStores;
     private readonly activeTargets;
+    /** Matches of the event in dispatch, kept by index; dispatch is not reentrant and reuses both arrays. */
+    private readonly matchedDefinitions;
+    private readonly matchedResults;
     private hasMore;
     private replacePending;
     private timelineDirty;

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

@@ -11,6 +11,7 @@ import { type SystemPromptState } from '../contract/system-prompt.ts';
 import { ConversationEventRegistry } from './event-registry.ts';
 import { ConversationViewRegistry } from './view-registry.ts';
 import { ConversationGroupRegistry } from './group-registry.ts';
+import { UserTextRegistry } from './user-text-registry.ts';
 /** Observable faces published for one Session's Conversation assembly. */
 export interface ConversationBinding {
     readonly snapshot: ObservableSnapshot<ConversationSnapshot>;
@@ -42,6 +43,8 @@ export declare class UiConversation extends Service {
     readonly views: ConversationViewRegistry;
     /** Business grouping rules over already materialized target Nodes. */
     readonly groups: ConversationGroupRegistry;
+    /** Pure text rules and parser snapshots, independent of durable Session assembly. */
+    readonly userText: UserTextRegistry;
     private readonly bindings;
     private readonly images;
     /**

package/lib/types/client/conversation/user-text-document.d.ts

@@ -0,0 +1,21 @@
+import type { UserTextDocumentInput, UserTextNode, UserTextRule } from '../contract/user-text.ts';
+/** Data-layer cache owned by one caller; initialization and refresh share one reconciliation. */
+export declare class UserTextDocument {
+    private text;
+    private rules;
+    private initial;
+    private output;
+    private readonly matchers;
+    private complete;
+    private evaluating;
+    /**
+     * Reconcile original text using current rule definitions and valid query records.
+     * @param input - original text and readonly Facts, compared by fields actually read.
+     * @param rules - unique definitions ordered by ascending order and stable ID.
+     * @returns complete readonly nodes; failures retain caches but publish no partial result.
+     */
+    evaluate(input: UserTextDocumentInput, rules: readonly UserTextRule[]): readonly UserTextNode[];
+    private prepare;
+    private reconcile;
+}
+//# sourceMappingURL=user-text-document.d.ts.map

package/lib/types/client/conversation/user-text-registry.d.ts

@@ -0,0 +1,26 @@
+/** Effect-owned user-text rules and their revision; document caches belong only to evaluator callers. */
+import type { UserTextEvaluator, UserTextRule } from '../contract/user-text.ts';
+import { ConversationDefinitionRegistry } from './definition-registry.ts';
+/** Observable rule revision with no retained documents or document subscriptions. */
+export declare class UserTextRegistry extends ConversationDefinitionRegistry<UserTextRule> {
+    private rules;
+    private revision;
+    /**
+     * Register a uniquely named rule; invalid IDs, duplicate IDs and non-finite order throw before publication.
+     * @param rule - readonly synchronous candidate matcher with a nonempty ID other than the reserved `text` ID.
+     * @returns idempotent disposer; removal synchronously publishes a new revision.
+     */
+    register(rule: UserTextRule): () => void;
+    /**
+     * Create an independent document evaluator; it reads current rules at each call and never subscribes.
+     * @returns callback owning its document cache, released when the caller releases the callback.
+     */
+    createEvaluator(): UserTextEvaluator;
+    /**
+     * Read the observable rule revision.
+     * @returns monotonic revision, stable until a successful registration or disposal.
+     */
+    getSnapshot(): number;
+    protected refresh(): void;
+}
+//# sourceMappingURL=user-text-registry.d.ts.map

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

@@ -1,4 +1,23 @@
-/** Browser Conversation assemble core, React adapter, shell, and input plugin. */
+/** Browser Conversation assemble core, React adapter, shell, input, and text projection plugin. */
+export type {} from './user-text/session-reference-rule.ts';
+/** Declaration-merged node payloads; IDs also identify the corresponding keyed renderer. */
+export interface UserTextDataMap {
+    text: {
+        /** Exact original substring; display transforms never change source text or UTF-16 coordinates. */
+        readonly text: string;
+        /** Optional display-only text; absence renders the original substring, while an empty string hides it. */
+        readonly display?: string;
+    };
+}
+/** Caller-supplied JSON business facts and text-transform flags, never services or actions; absent flags are disabled. */
+export interface UserTextFacts {
+    /** Collapse whitespace runs in ordinary display text to one space. */
+    readonly collapseWhitespace: boolean;
+    /** Remove display whitespace only at the document's outer edges, without crossing business nodes. */
+    readonly trimWhitespace: boolean;
+}
+export type { UserTextDocumentInput, UserTextEvaluator, UserTextId, UserTextNode, UserTextRule, UserTextTransformContext, } from './contract/user-text.ts';
+export type { UserTextRegistry } from './conversation/user-text-registry.ts';
 export { apply, Config, inject } from './apply.ts';
 export type { Config as ConversationConfig } from './apply.ts';
 export { UiConversation } from './conversation/assembly.ts';
@@ -24,7 +43,7 @@ export { ConversationLocationIndex } from './conversation/location-index.ts';
 export type { ConversationLocationDataChange } from './conversation/location-index.ts';
 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 { 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, MessageImageLabels, MessageImageLoader, MessageImageSource, MessageImagesContentInput, MessageImagesOwnerProps, UseConversation, UserTextInput, UserTextInjected, UserTextNodeOwnerProps, UserTextNodeProps, UseConversationViews, } from './contract/slots.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';

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

@@ -302,9 +302,12 @@ export declare const zh: {
     'row.preparing': string;
     'row.failed': string;
     'row.stopped': string;
+    'row.commandArguments': string;
     'row.input': string;
     'row.output': string;
     'row.inspect': string;
+    'row.imageSize': string;
+    'row.imageSizeDownscaled': string;
     'tool.title.search': string;
     'tool.title.read': string;
     'tool.title.bash': string;
@@ -363,6 +366,7 @@ export declare const zh: {
     'terminal.signal': string;
     'terminal.exitCode': string;
     'terminal.noExitCode': string;
+    'terminal.commandLine': string;
     'terminal.running': string;
     'terminal.failed': string;
     'terminal.done': string;
@@ -676,9 +680,12 @@ export declare const en: {
     'row.preparing': string;
     'row.failed': string;
     'row.stopped': string;
+    'row.commandArguments': string;
     'row.input': string;
     'row.output': string;
     'row.inspect': string;
+    'row.imageSize': string;
+    'row.imageSizeDownscaled': string;
     'tool.title.search': string;
     'tool.title.read': string;
     'tool.title.bash': string;
@@ -737,6 +744,7 @@ export declare const en: {
     'terminal.signal': string;
     'terminal.exitCode': string;
     'terminal.noExitCode': string;
+    'terminal.commandLine': string;
     'terminal.running': string;
     'terminal.failed': string;
     'terminal.done': string;

package/lib/types/client/queue/QueueDock.d.ts

@@ -1,6 +1,6 @@
 import type { Context } from '@deepseek-ai/cordis';
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
-import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PropsLocale, PropsRenderFactories, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
 import type { QueueAction } from '@deepseek-ai/dsh-api-session-controller/types';
 import type { MessageId } from '@deepseek-ai/dsh-llm/brand';
 /** Queue operations injected by the session-scoped registration. */
@@ -11,13 +11,13 @@ export interface QueueDockInjected {
     loadImage: (attachment: ImageAttachmentRef) => Promise<string>;
 }
 /** Full props of a dock entry: InputZone owner share + session standard kit + global seat + the locale seat. */
-export type QueueDockProps = PropsRuntime<'conversation.input.dock'> & QueueDockInjected & PropsLocale<'conversation'>;
+export type QueueDockProps = PropsRuntime<'conversation.input.dock'> & QueueDockInjected & PropsLocale<'conversation'> & PropsRenderFactories;
 /**
  * Queue strip: one item renders directly; multiple items default to a
  * collapsible count header; an empty queue renders nothing. Local queued submissions
  * show sending status and disabled actions until their Host queue rows arrive.
  */
-export declare function QueueDock({ useSession, useProjection, updateQueue, notify, loadImage, t }: QueueDockProps): import("react").JSX.Element | null;
+export declare function QueueDock({ useSession, useProjection, updateQueue, notify, loadImage, renderFactorySlot, t }: QueueDockProps): import("react").JSX.Element | null;
 /** Registers queue actions backed by the session-scoped conversation service. */
 export declare const queueDockEntry: {
     name: string;

package/lib/types/client/user-text/UserText.d.ts

@@ -0,0 +1,22 @@
+import type { FactoryComponentPropsOf } from '@deepseek-ai/dsh-client-ui-slots';
+import type { UserTextNodeProps } from '../contract/slots.ts';
+/**
+ * Render original text through pure matching rules and business-owned node Slots.
+ * A failed parse retains the entire original text and reports the rule error.
+ * @param props - original text, confirmed facts, display policy, and framework seats.
+ * @returns ordered inline nodes with raw-text fallbacks for missing registrations.
+ */
+export declare function UserText({ text, facts, interactive, ellipsis, useUserTextRevision, createUserTextEvaluator, reportTransformFailure, renderSlot, }: FactoryComponentPropsOf<'conversation.user.text'>): import("react").JSX.Element;
+/**
+ * Display an unmatched substring without business interpretation.
+ * @param props - parser-produced plain-text node.
+ * @returns its inline text.
+ */
+export declare function PlainUserText({ node }: UserTextNodeProps<'text'>): import("react").JSX.Element;
+/**
+ * Display a confirmed Session label without inventing navigation behavior.
+ * @param props - Session reference JSON and its original spelling.
+ * @returns the existing non-interactive Session chip.
+ */
+export declare function SessionReference({ node, raw }: UserTextNodeProps<'session'>): import("react").JSX.Element;
+//# sourceMappingURL=UserText.d.ts.map

package/lib/types/client/user-text/session-reference-rule.d.ts

@@ -0,0 +1,15 @@
+/** Original-text Session candidates with explicit wire spelling and longest known labels. */
+import type { UserTextRule } from '@deepseek-ai/dsh-client-ui-conversation/client';
+declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
+    interface UserTextDataMap {
+        session: {
+            readonly label: string;
+        };
+    }
+    interface UserTextFacts {
+        sessionLabels: readonly string[];
+    }
+}
+/** Find the nearest Session reference; bare labels read their Facts only at a non-wire @ position. */
+export declare const sessionReferenceRule: UserTextRule<'session'>;
+//# sourceMappingURL=session-reference-rule.d.ts.map

package/lib/types/client/user-text/whitespace-rules.d.ts

@@ -0,0 +1,7 @@
+/** Whitespace candidates use the same cursor, priority and Facts cache as reference candidates. */
+import type { UserTextRule } from '../contract/user-text.ts';
+/** Offer the next whitespace run whose display collapses to one space. */
+export declare const collapseWhitespaceRule: UserTextRule<'text.collapse-whitespace'>;
+/** Offer original document-edge whitespace, winning same-start collisions with collapse. */
+export declare const trimWhitespaceRule: UserTextRule<'text.trim-whitespace'>;
+//# sourceMappingURL=whitespace-rules.d.ts.map

package/locale/en.json

@@ -0,0 +1,5 @@
+{
+  "meta": {
+    "title": "ui-conversation"
+  }
+}

package/locale/zh.json

@@ -0,0 +1,6 @@
+{
+  "meta": {
+    "title": "会话界面框架",
+    "description": "组织对话内容、输入框、消息队列和视图导航。"
+  }
+}

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.1-alpha.1",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -23,7 +23,8 @@
       "default": "./lib/client.js"
     },
     "./src/*": "./src/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json"
   },
   "dsh": {
     "client": {
@@ -42,60 +43,59 @@
   },
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2"
   },
   "devDependencies": {
-    "@types/react": "~18.3.1",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-api-session-controller": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-api-workspace-controller": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-file-upload": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-store": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-test-runtime": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-layout": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-workspace": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-commands": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-goal": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm-retry": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-plan-mode": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-values": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-token-meter": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-tool-todo": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-crypto": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-workspace": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-file-reference": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-util-workspace-path": "0.2.1-alpha.3",
     "react": "^18.2.0",
     "@lexical/headless": "^0.49.0",
     "react-dom": "^18.2.0",
-    "@types/react-dom": "~18.3.0",
-    "zod": "^4.4.3",
+    "zod": "4.4.3",
     "lexical": "^0.49.0",
     "clsx": "^2.0.0",
     "@lexical/utils": "^0.49.0",
     "@lexical/text": "^0.49.0",
     "@lexical/plain-text": "^0.49.0",
     "@lexical/history": "^0.49.0",
-    "@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"
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-settings": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-shortcuts": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-client-product-analytics": "0.2.1-alpha.3"
   },
   "files": [
+    "locale/*.json",
     "lib/index.js",
     "lib/client.js",
     "lib/types/**/*.d.ts"