@deepseek-ai/dsh-client-ui-conversation 0.1.2-alpha.2 → 0.1.2-alpha.3

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

@@ -217,7 +217,7 @@ export interface ConversationViewBuilder<Node extends ConversationViewNode = Con
         readonly timeline: ConversationTimelineSnapshot;
     }): Snapshot;
 }
-/** Registry contribution that creates one isolated view builder per Session. */
+/** Registry contribution that creates an isolated builder when a Session first uses this target. */
 export interface ConversationViewDefinition<Node extends ConversationViewNode = ConversationViewNode, Snapshot = unknown> {
     readonly target: string;
     /** @returns a new Session-owned incremental builder. */

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

@@ -264,6 +264,8 @@ export interface ConversationSessionInjected {
     };
     /** Bind input draft persistence to the Session-owned store instance. */
     bindDraftMirror: (write: (text: string) => void) => () => void;
+    /** Select and activate one View while addressing an opaque focus request to it. */
+    openView: (view: string, focus: string) => void;
 }
 /** Business callbacks injected into the strict Session header. */
 export interface ConversationSessionHeaderInjected {
@@ -273,6 +275,8 @@ export interface ConversationSessionHeaderInjected {
     };
     /** Select a Session through the Session Controller. */
     open: (sessionId: SessionId) => void;
+    /** Select and activate one registered Conversation View. */
+    selectView: (view: string) => void;
 }
 /** Owner share of the resident composer bar. */
 export interface ComposerBarOwnerProps {

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

@@ -22,12 +22,15 @@ export declare class ConversationNodeAssembler implements ConversationViewSnapsh
     private readonly contexts;
     private readonly contextsByKind;
     private readonly contextsBySeq;
+    private readonly contextsByTarget;
     private readonly inputs;
     private readonly locationIndex;
     private readonly dirty;
+    private readonly dirtyByTarget;
     private readonly revised;
     private readonly dependents;
     private readonly views;
+    private readonly activeTargets;
     private hasMore;
     private replacePending;
     private timelineDirty;
@@ -62,30 +65,40 @@ export declare class ConversationNodeAssembler implements ConversationViewSnapsh
      */
     rebuildRegistry(): ConversationPublication;
     /**
-     * Materialize dirty Contexts and advance every registered view builder.
+     * Materialize dirty Contexts and advance every active view builder.
      * @returns whether any view snapshot was rebuilt or incrementally applied.
      */
     flush(): boolean;
+    /**
+     * Add one target to the monotonic active set and materialize its current snapshot.
+     * Pending Context work is flushed before the first complete replacement.
+     * @param target - registered or subsequently registered view target.
+     * @returns whether any active target snapshot changed.
+     */
+    activateTarget(target: string): boolean;
     /**
      * Read the latest snapshot of a registered target.
      * @param target - registered view target.
-     * @returns target snapshot, or undefined when no builder is registered.
+     * @returns target snapshot, or undefined before registration or activation.
      */
     snapshot(target: string): unknown;
     get<Target extends Extract<keyof ConversationViewSnapshotMap, string>>(target: Target): ConversationViewSnapshotMap[Target] | undefined;
     /**
      * Read targets whose owners classify their latest snapshot as visible activity.
-     * @returns active target ids.
+     * @returns target ids contributing visible activity.
      */
-    activeTargets(): ReadonlySet<string>;
+    activityTargets(): ReadonlySet<string>;
     private sortedInputs;
     private matchInput;
     private collectInput;
     private dispatchInput;
+    private createContext;
     private acceptMatch;
     private applyPendingMatches;
     private replayContexts;
     private replayContext;
+    private indexTargetContext;
+    private markDirty;
     private replaceDependencies;
     private replayRevisedDependents;
     private readerFor;
@@ -96,6 +109,9 @@ export declare class ConversationNodeAssembler implements ConversationViewSnapsh
     private replayDependencies;
     private refreshMatchLocations;
     private buildNode;
+    private replaceView;
+    private buildTargetNodes;
+    private buildTargetUpserts;
     private buildLocationData;
     private replaceLocationData;
     private applyDirtyLocationData;

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

@@ -12,8 +12,15 @@ import { ConversationViewRegistry } from './view-registry.ts';
 /** Observable faces published for one Session's Conversation assembly. */
 export interface ConversationBinding {
     readonly snapshot: ObservableSnapshot<ConversationSnapshot>;
+    /**
+     * Add one selected target to the Session's monotonic active set.
+     * @param target - registered or subsequently registered Conversation target.
+     */
+    activate(target: string): void;
     /**
      * Resolve one target-owned snapshot source.
+     * The first subscriber activates the target unless shell selection already
+     * activated it; activation lasts for the remaining Session lifetime.
      * @param target - registered Conversation target.
      * @returns identity-stable source following the target.
      */

package/lib/types/client/image-labels.d.ts

@@ -10,7 +10,7 @@ import type { ConversationKey } from './locales.ts';
 export declare function imageSizeText(bytes: number): string;
 /**
  * Product copy for a host attachment rejection (the `details.reason` of
- * `session/attachment-invalid` or `subagent/attachment-unsupported`).
+ * `session/attachment-invalid` or `subagent/attachment-invalid`).
  * User-solvable reasons name the limit and the way out;
  * reasons the user cannot act on fold into one send-failed line carrying the
  * reason code for a bug report.

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

@@ -39,7 +39,6 @@ export declare const zh: {
     'image.tooManyPixels': string;
     'image.dimensionTooLarge': string;
     'image.modelUnsupported': string;
-    'image.subagentUnsupported': string;
     'image.sendFailed': string;
     'context.aria': string;
     'context.used': string;
@@ -125,6 +124,7 @@ export declare const zh: {
     'web.contentTruncated': string;
     'details.running': string;
     'queue.count': string;
+    'queue.image': string;
     'queue.edit': string;
     'queue.edit.unsupported': string;
     'queue.save': string;
@@ -187,7 +187,6 @@ export declare const en: {
     'image.tooManyPixels': string;
     'image.dimensionTooLarge': string;
     'image.modelUnsupported': string;
-    'image.subagentUnsupported': string;
     'image.sendFailed': string;
     'context.aria': string;
     'context.used': string;
@@ -273,6 +272,7 @@ export declare const en: {
     'web.contentTruncated': string;
     'details.running': string;
     'queue.count': string;
+    'queue.image': string;
     'queue.edit': string;
     'queue.edit.unsupported': string;
     'queue.save': string;

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

@@ -1,10 +1,13 @@
 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 { QueueAction, QueueItemId } from '../contract/queue.ts';
 /** Queue operations injected by the session-scoped registration. */
 export interface QueueDockInjected {
     updateQueue: (itemId: QueueItemId, action: QueueAction) => Promise<void>;
     notify: (level: 'info' | 'error', text: string) => void;
+    /** Resolve one durable queued image into a session-scoped browser URL. */
+    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'>;
@@ -12,7 +15,7 @@ export type QueueDockProps = PropsRuntime<'conversation.input.dock'> & QueueDock
  * Queue strip: one item renders directly; multiple items default to a
  * collapsible count header; an empty queue renders nothing.
  */
-export declare function QueueDock({ useSession, updateQueue, notify, t }: QueueDockProps): import("react").JSX.Element | null;
+export declare function QueueDock({ useSession, updateQueue, notify, loadImage, 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/skeleton/ConversationSession.d.ts

@@ -9,12 +9,12 @@ export type ConversationSessionHeaderProps = ConversationSessionHeaderSlotProps;
  * @param props - Strict Session store, view ledger, navigation, render, and locale shares.
  * @returns the hidden blank-session header or visible title and tabs.
  */
-export declare function ConversationSessionHeader({ sessionId, useSession, useSessions, useConversation, useConversationViews, useStore, actions, renderSlot, open, t, }: ConversationSessionHeaderProps): import("react").JSX.Element;
+export declare function ConversationSessionHeader({ sessionId, useSession, useSessions, useConversation, useConversationViews, useStore, renderSlot, open, selectView, t, }: ConversationSessionHeaderProps): import("react").JSX.Element;
 /**
  * Renders the active Session view inside the resident scrollport and keeps
  * the input draft mirrored while blank Hero chrome is visible.
  * @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 ConversationSession({ useSession, useConversation, useConversationViews, useInput, inputActions, useStore, actions, renderSlot, bindDraftMirror, }: ConversationSessionProps): import("react").JSX.Element | null;
+export declare function ConversationSession({ useSession, useConversation, useConversationViews, useInput, inputActions, useStore, actions, renderSlot, bindDraftMirror, openView, }: ConversationSessionProps): import("react").JSX.Element | null;
 //# sourceMappingURL=ConversationSession.d.ts.map

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

@@ -1,5 +1,6 @@
 /** Per-session Conversation store shared by the shell body and header. */
 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';
 /** Declared write set for the Conversation shell. */
 type ConversationActions = {
@@ -13,5 +14,11 @@ type ConversationActions = {
  * @returns the store handle.
  */
 export declare function createConversationStore(): EngineStoreHandle<ConversationStoreState, ConversationActions>;
+/**
+ * Read the persisted View preference before the Slot store is materialized.
+ * @param sessionId - Session-scoped persistence suffix.
+ * @returns the preferred View id, or null when storage has no usable value.
+ */
+export declare function readConversationViewPreference(sessionId: SessionId): string | null;
 export {};
 //# sourceMappingURL=stores.d.ts.map

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

@@ -0,0 +1,9 @@
+import type { ViewTab } from './contract/views.ts';
+/**
+ * Resolve a preferred registered View, then Chat, without choosing another View.
+ * @param tabs - currently registered Views.
+ * @param selectedId - preferred View identity, when one is stored.
+ * @returns the selected View, Chat fallback, or undefined when neither is registered.
+ */
+export declare function resolveActiveView(tabs: readonly ViewTab[], selectedId: string | null): ViewTab | undefined;
+//# sourceMappingURL=view-selection.d.ts.map

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.1.2-alpha.2",
+  "version": "0.1.2-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -64,35 +64,35 @@
     "@types/react-dom": "~18.3.0",
     "zod": "^4.4.3",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-layout": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-goal": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-llm-retry": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-permission-presets": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-plan-mode": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-token-meter": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-tool-todo": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-util-crypto": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-util-workspace-path": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.2"
+    "@deepseek-ai/dsh-api-workspace-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-layout": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-workspace": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-commands": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-goal": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-llm-retry": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-permission-presets": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-session": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-token-meter": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-tool-todo": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-util-workspace-path": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-settings": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-workspace": "^0.1.2-alpha.3",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.2-alpha.3"
   },
   "files": [
     "lib/index.js",