@deepseek-ai/dsh-client-ui-session 0.1.5-rc.2 → 0.1.6-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-session/README.md
-README.md: 75fd792866afc29c6c99fd0879588e80b75b22dc
-README.zh.md: bad90a7602bf097a3ba24e7a39c7cb8e5776d141
+README.md: 4fff368e58d7b422ba6948be78e543c31f5cef59
+README.zh.md: db37539b59231bfef50f3bdcc33aeae94e881a44

package/README.md

@@ -8,7 +8,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-React and Slot adapter for Session Controller state. It contributes Session list and pending-interaction hooks at root scope, materializes per-Session hooks and props, and owns the standard `SessionProvider` rendering behavior without taking ownership of Session transport or lifecycle state. Use it when a browser feature needs Session state through standard React props and hooks.
+Use this package to expose Session catalog, retain information, and unified UI status through standard Slot hooks. It materializes per-`SessionBinding` hooks and props, while `SessionProvider` can inherit an outer binding or bind an explicit `SessionReference`. It owns process-local pending-interaction and completion-reminder policy without owning Controller transport, history, or references.
 
 ## Table of Contents
 

package/README.zh.md

@@ -8,7 +8,7 @@ kind: "package-reference"
 
 ## 概述
 
-面向 Session Controller 状态的 React 与 Slot adapter。本包在 root scope 提供 Session list 和 pending-interaction hook，物化逐 Session hook 与 prop，并拥有标准 `SessionProvider` 渲染行为，但不接管 Session transport 或 lifecycle 状态。当浏览器功能需要通过标准 React prop 和 hook 读取 Session 状态时，请使用它。
+使用本包可通过标准 Slot 钩子公开 Session catalog、retain 信息与统一 UI 状态。它按 `SessionBinding` 物化钩子和 prop，而 `SessionProvider` 可以继承外围 binding 或绑定显式 `SessionReference`。它拥有进程本地的 pending-interaction 与完成提醒策略，但不拥有 Controller transport、历史或 reference。
 
 ## 目录
 
@@ -31,7 +31,7 @@ kind: "package-reference"
 
 <a id="known-limitations-and-deferred-work"></a>
 
-- **Pending interaction 是进程本地投影**——浏览器重连后，所属 Remote waterfall 必须重放仍未完成的请求。
+- **Pending interaction 是进程本地投影**——浏览器重连后，所属 Remote waterfall（瀑布式事件）必须重放仍未完成的请求。
 
 
 <a id="dev-note"></a>
@@ -44,4 +44,4 @@ kind: "package-reference"
 
 </details>
 
-**运行时不变式：** 不发布伴生入口。adapter materialization 路径已经强制 Session binding 一致。
+**运行时不变式：** 不发布伴生入口。适配器 materialization 路径已经强制 Session 绑定一致。

package/lib/client.js

@@ -8,19 +8,79 @@ window.__ModuleLoader__.load({
 		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
 		let _deepseek_ai_dsh_client_ui_slots = require("@deepseek-ai/dsh-client-ui-slots");
 		let react_jsx_runtime = require("react/jsx-runtime");
-		let react = require("react");
+		//#region ../../util/values/src/index.ts
+		/**
+		* Weak-key lookup with a strongly retained iterable set of associated values.
+		*
+		* Each value must belong to only one key. The container performs no automatic
+		* cleanup; owners delete associations or clear the container at lifecycle end.
+		*/
+		var WeakMapWithValues = class {
+			keys = /* @__PURE__ */ new WeakMap();
+			valueSet = /* @__PURE__ */ new Set();
+			/** Live strongly retained values in insertion order. */
+			values = this.valueSet;
+			/**
+			* Read the value associated with a key.
+			* @param key - weakly held lookup key.
+			* @returns the associated value, or absence.
+			*/
+			get(key) {
+				return this.keys.get(key);
+			}
+			/**
+			* Test whether a key has an association.
+			* @param key - weakly held lookup key.
+			* @returns whether the key is present.
+			*/
+			has(key) {
+				return this.keys.has(key);
+			}
+			/**
+			* Associate one key with one caller-unique value.
+			* @param key - weakly held lookup key.
+			* @param value - strongly retained value that belongs to no other key.
+			* @returns this container.
+			*/
+			set(key, value) {
+				if (this.keys.has(key)) {
+					const previous = this.keys.get(key);
+					if (previous === value) return this;
+					this.valueSet.delete(previous);
+				}
+				this.keys.set(key, value);
+				this.valueSet.add(value);
+				return this;
+			}
+			/**
+			* Remove one association and its strongly retained value.
+			* @param key - weakly held lookup key.
+			* @returns whether an association was removed.
+			*/
+			delete(key) {
+				if (!this.keys.has(key)) return false;
+				const value = this.keys.get(key);
+				const deleted = this.keys.delete(key);
+				this.valueSet.delete(value);
+				return deleted;
+			}
+			/** Remove every association and strongly retained value. */
+			clear() {
+				this.keys = /* @__PURE__ */ new WeakMap();
+				this.valueSet.clear();
+			}
+		};
+		//#endregion
 		//#region lib/types/client/session-provider.js
-		/** Session-owned rendering semantics for the standard SessionProvider seat. */
 		/**
 		* Render the selected Session body or its empty branch.
 		* @param binding - current Session scope binding.
 		* @param props - standard Session area render props.
-		* @returns the selected Session subtree, keyed by Session identity.
+		* @returns the selected Session subtree.
 		*/
 		function renderSessionArea(binding, { empty, children }) {
-			const sessionId = binding.key;
-			if (sessionId === void 0) return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: empty?.() ?? null });
-			return (0, react_jsx_runtime.jsx)(react.Fragment, { children }, sessionId);
+			if (binding.key === void 0) return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: empty?.() ?? null });
+			return (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children });
 		}
 		//#endregion
 		//#region lib/types/client/index.js
@@ -72,20 +132,25 @@ window.__ModuleLoader__.load({
 		var UiSession = class extends _deepseek_ai_cordis.Service {
 			sessions;
 			descriptors = [BUILTIN_SOURCE];
-			bindings = /* @__PURE__ */ new Map();
+			bindings = new WeakMapWithValues();
 			absent;
-			currentBinding;
-			currentListeners = /* @__PURE__ */ new Set();
+			current;
 			pendingDomains = [];
 			pendingSnapshot = /* @__PURE__ */ new Map();
-			pendingListeners = /* @__PURE__ */ new Set();
-			/** Root source of pending UI interactions, independent from Controller snapshots. */
-			pendingInteractions = {
-				getSnapshot: () => this.pendingSnapshot,
+			running = /* @__PURE__ */ new Map();
+			completionUnread = /* @__PURE__ */ new Set();
+			statusSnapshot = /* @__PURE__ */ new Map();
+			statusListeners = /* @__PURE__ */ new Set();
+			mainRetainId;
+			disposeMainRetain = () => {};
+			active = true;
+			/** Root source combining running, pending-interaction, and completion-reminder facts. */
+			sessionStatus = {
+				getSnapshot: () => this.statusSnapshot,
 				subscribe: (listener) => {
-					this.pendingListeners.add(listener);
+					this.statusListeners.add(listener);
 					return () => {
-						this.pendingListeners.delete(listener);
+						this.statusListeners.delete(listener);
 					};
 				}
 			};
@@ -98,34 +163,51 @@ window.__ModuleLoader__.load({
 			constructor(ctx, sessions) {
 				super(ctx, "uiSession");
 				this.sessions = sessions;
-				this.absent = this.materializeAbsent();
-				this.currentBinding = this.resolveCurrent();
+				this.absent = createBindingSource(this.materializeAbsent());
+				this.current = createBindingSource(this.absent.value);
 				this.adapter = {
-					current: {
-						getSnapshot: () => this.currentBinding,
-						subscribe: (listener) => {
-							this.currentListeners.add(listener);
-							return () => {
-								this.currentListeners.delete(listener);
-							};
-						}
-					},
-					resolve: (key) => this.resolve(key),
+					current: this.current,
+					bindingSource: (target) => this.bindingSource(target),
 					renderArea: renderSessionArea
 				};
 				ctx.effect(() => {
 					const disposeList = sessions.list.subscribe(() => {
-						this.publishCurrent();
+						this.publishMain();
 					});
+					const disposeStatus = sessions.list.subscribe(() => {
+						this.reconcileStatus();
+					});
+					const disposeRemoteStatus = ctx.remote.$on("api-session/status", (sessionId, running) => {
+						this.observeRunning(sessionId, running);
+					});
+					this.publishMain();
+					this.reconcileStatus();
 					return () => {
+						this.active = false;
 						disposeList();
-						const records = [...this.bindings.values()];
+						disposeStatus();
+						disposeRemoteStatus();
+						this.disposeMainRetain();
+						const records = [...this.bindings.values];
 						this.bindings.clear();
 						for (const record of records) record.release();
 					};
 				}, "ui-session: Session binding projection");
 			}
 			/**
+			* Resolve a stable renderer source for an owned Session reference or explicit absence.
+			* @param reference - active reference supplied by the Provider owner, or absence.
+			* @returns the binding source, which falls back to the absent projection when its generation ends.
+			* @throws when the reference does not belong to the active Controller generation.
+			*/
+			bindingSource(reference) {
+				if (!this.active) return this.absent;
+				if (reference === void 0) return this.absent;
+				const owner = reference.binding;
+				if (this.sessions.binding(reference.sessionId) !== owner) throw new Error("ui-session: Session reference is not active in this Controller");
+				return this.sourceFor(owner);
+			}
+			/**
 			* Register one Session-scoped standard-source contribution.
 			* @param descriptor - static member roster and per-binding resolver.
 			* @returns disposer owned by the caller's Cordis fiber.
@@ -177,38 +259,42 @@ window.__ModuleLoader__.load({
 			}
 			rebuildBindings() {
 				const absent = this.materializeAbsent();
-				const bindings = /* @__PURE__ */ new Map();
-				try {
-					for (const [sessionId, cached] of this.bindings) bindings.set(sessionId, this.createMaterializedBinding(cached.owner));
-				} catch (error) {
-					for (const record of bindings.values()) record.release();
-					throw error;
-				}
-				const previous = this.bindings;
-				this.absent = absent;
-				this.bindings = bindings;
-				for (const record of previous.values()) record.release();
-				this.publishCurrent();
+				const updates = [...this.bindings.values].map((record) => ({
+					source: record.source,
+					value: this.materialize(record.owner)
+				}));
+				this.absent.value = absent;
+				for (const { source, value } of updates) source.value = value;
+				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.absent.listeners, "[ui-session] absent binding");
+				for (const { source } of updates) (0, _deepseek_ai_dsh_client_store.notifySubscribers)(source.listeners, "[ui-session] Session binding");
+				this.publishMain();
 			}
-			resolve(key) {
-				const owner = this.sessions.binding(key);
-				if (owner === void 0) return void 0;
-				const cached = this.bindings.get(key);
-				if (cached?.owner === owner) return cached.value;
+			sourceFor(owner) {
+				const cached = this.bindings.get(owner);
+				if (cached !== void 0) return cached.source;
 				const record = this.createMaterializedBinding(owner);
-				this.bindings.set(key, record);
-				cached?.release();
-				return record.value;
+				this.bindings.set(owner, record);
+				return record.source;
 			}
-			resolveCurrent() {
-				const current = this.sessions.list.getSnapshot().current;
-				return current === void 0 ? this.absent : this.resolve(current) ?? this.absent;
+			publishMain() {
+				if (!this.active) return;
+				const byId = this.sessions.list.getSnapshot().byId;
+				const currentId = this.current.value.key;
+				const nextId = currentId !== void 0 && (this.sessions.retainInfo(currentId).getSnapshot().retainedBy.mainView ?? 0) > 0 ? currentId : Object.values(byId).find((candidate) => (candidate.retainedBy.mainView ?? 0) > 0)?.id;
+				this.watchMainRetention(nextId);
+				const owner = nextId === void 0 ? void 0 : this.sessions.binding(nextId);
+				const value = owner === void 0 ? this.absent.value : this.sourceFor(owner).value;
+				if (this.current.value === value) return;
+				this.current.value = value;
+				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.current.listeners, "[ui-session] main binding");
 			}
-			publishCurrent() {
-				const next = this.resolveCurrent();
-				if (next === this.currentBinding) return;
-				this.currentBinding = next;
-				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.currentListeners, "[ui-session] current binding");
+			watchMainRetention(sessionId) {
+				if (sessionId === this.mainRetainId) return;
+				this.disposeMainRetain();
+				this.mainRetainId = sessionId;
+				this.disposeMainRetain = sessionId === void 0 ? () => {} : this.sessions.retainInfo(sessionId).subscribe(() => {
+					this.publishMain();
+				});
 			}
 			publishPendingInteractions() {
 				const next = /* @__PURE__ */ new Map();
@@ -223,20 +309,67 @@ window.__ModuleLoader__.load({
 				const projected = new Map([...next].map(([sessionId, value]) => [sessionId, value.interaction]));
 				if (samePendingInteractions(this.pendingSnapshot, projected)) return;
 				this.pendingSnapshot = projected;
-				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.pendingListeners, "[ui-session] pending interactions");
+				this.publishStatus();
+			}
+			observeRunning(sessionId, running) {
+				const previous = this.running.get(sessionId);
+				const beforeBaseline = this.sessions.list.getSnapshot().phase === "pending";
+				this.running.set(sessionId, running);
+				if (running) this.completionUnread.delete(sessionId);
+				else if ((previous === true || previous === void 0 && beforeBaseline) && !this.isMain(sessionId)) this.completionUnread.add(sessionId);
+				this.publishStatus();
+			}
+			reconcileStatus() {
+				const list = this.sessions.list.getSnapshot();
+				const present = new Set(Object.keys(list.byId));
+				for (const id of present) {
+					const row = list.byId[id];
+					if (row === void 0) continue;
+					const previous = this.running.get(id);
+					if (previous === void 0) this.running.set(id, row.running);
+					else if (previous !== row.running) this.observeRunning(id, row.running);
+					if ((row.retainedBy.mainView ?? 0) > 0) this.completionUnread.delete(id);
+				}
+				if (list.phase === "ready") for (const id of this.running.keys()) {
+					if (present.has(id)) continue;
+					this.running.delete(id);
+					this.completionUnread.delete(id);
+				}
+				this.publishStatus();
+			}
+			isMain(sessionId) {
+				return (this.sessions.list.getSnapshot().byId[sessionId]?.retainedBy.mainView ?? 0) > 0;
+			}
+			publishStatus() {
+				const ids = new Set([
+					...Object.keys(this.sessions.list.getSnapshot().byId),
+					...this.running.keys(),
+					...this.pendingSnapshot.keys(),
+					...this.completionUnread
+				]);
+				const next = /* @__PURE__ */ new Map();
+				for (const id of ids) next.set(id, {
+					running: this.running.get(id),
+					pendingInteraction: this.pendingSnapshot.get(id),
+					completionUnread: this.completionUnread.has(id)
+				});
+				if (sameSessionStatus(this.statusSnapshot, next)) return;
+				this.statusSnapshot = next;
+				(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.statusListeners, "[ui-session] Session status");
 			}
 			createMaterializedBinding(owner) {
 				const value = this.materialize(owner);
+				this.ctx.slots.bindStoreScope(value);
+				const source = createBindingSource(value);
 				const releaseEffect = owner.ctx.effect(() => () => {
-					if (this.bindings.get(owner.sessionId) !== record) return;
-					this.bindings.delete(owner.sessionId);
-					if (this.currentBinding !== value) return;
-					this.currentBinding = this.absent;
-					(0, _deepseek_ai_dsh_client_store.notifySubscribers)(this.currentListeners, "[ui-session] current binding");
+					if (this.bindings.get(owner) === record) this.bindings.delete(owner);
+					source.value = this.absent.value;
+					(0, _deepseek_ai_dsh_client_store.notifySubscribers)(source.listeners, "[ui-session] Session binding");
+					this.publishMain();
 				}, `ui-session: binding ${owner.sessionId}`);
 				const record = {
 					owner,
-					value,
+					source,
 					release: () => {
 						releaseEffect();
 					}
@@ -255,15 +388,13 @@ window.__ModuleLoader__.load({
 					copyDeclared("keyed hook", keyedHooks, descriptor.keyedHooks, contribution.keyedHooks, finalProps);
 					copyDeclared("prop", props, descriptor.props, contribution.props, finalProps);
 				}
-				const value = {
+				return {
 					key: binding.sessionId,
 					ctx: binding.ctx,
 					hooks,
 					keyedHooks,
 					props
 				};
-				this.ctx.slots.bindStoreScope(value);
-				return value;
 			}
 			materializeAbsent() {
 				const hooks = {};
@@ -283,6 +414,20 @@ window.__ModuleLoader__.load({
 				};
 			}
 		};
+		function createBindingSource(value) {
+			const source = {
+				value,
+				listeners: /* @__PURE__ */ new Set(),
+				getSnapshot: () => source.value,
+				subscribe: (listener) => {
+					source.listeners.add(listener);
+					return () => {
+						source.listeners.delete(listener);
+					};
+				}
+			};
+			return source;
+		}
 		function validateContribution(descriptor, contribution) {
 			rejectUndeclared("hook", descriptor.hooks, contribution.hooks);
 			rejectUndeclared("keyed hook", descriptor.keyedHooks, contribution.keyedHooks);
@@ -311,19 +456,34 @@ window.__ModuleLoader__.load({
 			finalProps.add(propName);
 		}
 		/** Required Controller and renderer services. */
-		const inject = ["sessions", "slots"];
+		const inject = [
+			"sessions",
+			"slots",
+			"remote"
+		];
 		/**
 		* Install the Session root source and scoped adapter.
 		* @param ctx - Client Cordis context.
 		*/
 		function apply(ctx) {
 			const service = new UiSession(ctx, ctx.sessions);
-			ctx.slots.provideRoot({ hooks: {
-				sessions: ctx.sessions.list,
-				sessionPendingInteraction: service.pendingInteractions
-			} });
+			ctx.slots.provideRoot({
+				hooks: {
+					sessions: ctx.sessions.list,
+					sessionStatus: service.sessionStatus
+				},
+				keyedHooks: { sessionRetainInfo: (key) => ctx.sessions.retainInfo(key) }
+			});
 			ctx.slots.installScope("session", service.adapter);
 		}
+		function sameSessionStatus(left, right) {
+			if (left.size !== right.size) return false;
+			for (const [id, status] of left) {
+				const candidate = right.get(id);
+				if (candidate === void 0 || candidate.running !== status.running || candidate.pendingInteraction !== status.pendingInteraction || candidate.completionUnread !== status.completionUnread) return false;
+			}
+			return true;
+		}
 		function samePendingInteractions(left, right) {
 			if (left.size !== right.size) return false;
 			for (const [sessionId, interaction] of left) if (right.get(sessionId) !== interaction) return false;

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

@@ -1,8 +1,8 @@
 /** Session Controller adapter for React selector hooks and Slot scope data. */
 import { Service, type Context } from '@deepseek-ai/cordis';
-import type { ISessions, SessionBinding, SessionListState, SessionSnapshot, UseProjection } from '@deepseek-ai/dsh-api-session-controller/client';
+import type { ISessions, SessionBinding, SessionListState, SessionReference, SessionRetainInfo, SessionSnapshot, UseProjection } from '@deepseek-ai/dsh-api-session-controller/client';
 import type { SessionId } from '@deepseek-ai/dsh-session/types';
-import type { HostObservable, KeyedStandardSource, MaybeSnapshotSelectorHook, SlotScopeAdapter, SnapshotSelectorHook } from '@deepseek-ai/dsh-client-ui-slots';
+import type { HostObservable, KeyedStandardSource, MaybeSnapshotSelectorHook, SlotScopeAdapter, SnapshotSelectorHook, StandardSourceBinding } from '@deepseek-ai/dsh-client-ui-slots';
 /** Selector hook over the Session Controller list and current selection. */
 export type UseSessions = SnapshotSelectorHook<SessionListState>;
 /** Selector hook over one Session's lifecycle and control state. */
@@ -18,25 +18,61 @@ export interface SessionPendingInteractionBase {
     /** Session whose UI can answer this interaction. */
     readonly sessionId: SessionId;
 }
-/** Declaration-merged roster of domain-owned pending interaction values. */
+/** Declaration-merged map of domain keys to their pending-interaction values. */
 export interface SessionPendingInteractionMap {
 }
-/** Every pending interaction contributed by the assembled Client. */
+/** Union of every pending-interaction value contributed by the assembled Client. */
 export type SessionPendingInteraction = [
     keyof SessionPendingInteractionMap
 ] extends [never] ? SessionPendingInteractionBase : SessionPendingInteractionMap[keyof SessionPendingInteractionMap];
-/** Current effective pending interaction by Session. */
-export type SessionPendingInteractionSnapshot = ReadonlyMap<SessionId, SessionPendingInteraction>;
-/** Selector hook over Session-scoped pending interactions. */
-export type UseSessionPendingInteraction = SnapshotSelectorHook<SessionPendingInteractionSnapshot>;
+/** Independent UI status facts for one Session identity. */
+export interface SessionStatus {
+    /** Latest known running state; absent until a baseline or event establishes it. */
+    readonly running: boolean | undefined;
+    /** Highest-precedence domain request currently awaiting user interaction. */
+    readonly pendingInteraction: SessionPendingInteraction | undefined;
+    /** Whether an observed stop outside the main view still needs acknowledgement. */
+    readonly completionUnread: boolean;
+}
+/** Current UI status indexed by Session identity. */
+export type SessionStatusSnapshot = ReadonlyMap<SessionId, SessionStatus>;
+/** Selector hook over the unified Session UI status snapshot. */
+export type UseSessionStatus = SnapshotSelectorHook<SessionStatusSnapshot>;
+/** Selector hook for explicit or surrounding-Provider Session reference counts. */
+export interface UseSessionRetainInfo {
+    /**
+     * Read the complete retain information for an explicit Session identity.
+     * @param sessionId - Session identity to inspect without retaining it.
+     * @returns current local reference counts, or absence while the source is unavailable.
+     */
+    (sessionId: SessionId): SessionRetainInfo | undefined;
+    /**
+     * Select from the retain information for an explicit Session identity.
+     * @param sessionId - Session identity to inspect without retaining it.
+     * @param selector - projection over the current value.
+     * @param equal - optional selected-value equality.
+     * @returns selected value.
+     */
+    <Selected>(sessionId: SessionId, selector: (value: SessionRetainInfo | undefined) => Selected, equal?: (left: Selected, right: Selected) => boolean): Selected;
+    /**
+     * Select from the surrounding Provider's Session retain information.
+     * @param selector - projection receiving absence outside a Session binding.
+     * @param equal - optional selected-value equality.
+     * @returns selected value.
+     */
+    <Selected>(selector: (value: SessionRetainInfo | undefined) => Selected, equal?: (left: Selected, right: Selected) => boolean): Selected;
+}
 /** Publish one pending interaction and define how plugin teardown delegates it. */
 export type PendingInteractionPublisher<T extends SessionPendingInteractionBase> = (interaction: T, delegate: () => Promise<void>) => () => void;
 declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface SlotScopeTargetMap {
+        session: SessionReference;
+    }
     interface GlobalStandardProps {
         /** Session list and current selection. */
         useSessions: UseSessions;
-        /** Pending user interaction presented by a Session-scoped UI consumer. */
-        useSessionPendingInteraction: UseSessionPendingInteraction;
+        useSessionStatus: UseSessionStatus;
+        useSessionRetainInfo: UseSessionRetainInfo;
     }
     interface SessionStandardProps {
         /** Current Session lifecycle and control state. */
@@ -55,6 +91,11 @@ declare module '@deepseek-ai/dsh-client-ui-slots' {
         useProjection: UseProjection;
     }
 }
+declare module '@deepseek-ai/dsh-api-session-controller/client' {
+    interface SessionReferenceSourceMap {
+        mainView: unknown;
+    }
+}
 declare module '@deepseek-ai/cordis' {
     interface Context {
         /** Session Controller adapter and session-scoped source registry. */
@@ -85,15 +126,20 @@ export interface SessionSourceDescriptor<Hooks extends SessionSourceRoster = Ses
 export declare class UiSession extends Service {
     private readonly sessions;
     private readonly descriptors;
-    private bindings;
-    private absent;
-    private currentBinding;
-    private readonly currentListeners;
+    private readonly bindings;
+    private readonly absent;
+    private readonly current;
     private readonly pendingDomains;
     private pendingSnapshot;
-    private readonly pendingListeners;
-    /** Root source of pending UI interactions, independent from Controller snapshots. */
-    readonly pendingInteractions: HostObservable<SessionPendingInteractionSnapshot>;
+    private readonly running;
+    private readonly completionUnread;
+    private statusSnapshot;
+    private readonly statusListeners;
+    private mainRetainId;
+    private disposeMainRetain;
+    private active;
+    /** Root source combining running, pending-interaction, and completion-reminder facts. */
+    readonly sessionStatus: HostObservable<SessionStatusSnapshot>;
     /** Renderer-facing adapter for `session` and `session-maybe` scopes. */
     readonly adapter: SlotScopeAdapter;
     /**
@@ -101,6 +147,13 @@ export declare class UiSession extends Service {
      * @param sessions - Controller-owned Session object layer.
      */
     constructor(ctx: Context, sessions: ISessions);
+    /**
+     * Resolve a stable renderer source for an owned Session reference or explicit absence.
+     * @param reference - active reference supplied by the Provider owner, or absence.
+     * @returns the binding source, which falls back to the absent projection when its generation ends.
+     * @throws when the reference does not belong to the active Controller generation.
+     */
+    bindingSource(reference: SessionReference | undefined): HostObservable<StandardSourceBinding>;
     /**
      * Register one Session-scoped standard-source contribution.
      * @param descriptor - static member roster and per-binding resolver.
@@ -116,10 +169,14 @@ export declare class UiSession extends Service {
      */
     registerPendingInteraction<T extends SessionPendingInteractionBase>(precedence: (interaction: T) => number): PendingInteractionPublisher<T>;
     private rebuildBindings;
-    private resolve;
-    private resolveCurrent;
-    private publishCurrent;
+    private sourceFor;
+    private publishMain;
+    private watchMainRetention;
     private publishPendingInteractions;
+    private observeRunning;
+    private reconcileStatus;
+    private isMain;
+    private publishStatus;
     private createMaterializedBinding;
     private materialize;
     private materializeAbsent;

package/lib/types/client/session-provider.d.ts

@@ -1,11 +1,11 @@
 /** Session-owned rendering semantics for the standard SessionProvider seat. */
-import { type ReactNode } from 'react';
+import type { ReactNode } from 'react';
 import type { SessionAreaProps, StandardSourceBinding } from '@deepseek-ai/dsh-client-ui-slots';
 /**
  * Render the selected Session body or its empty branch.
  * @param binding - current Session scope binding.
  * @param props - standard Session area render props.
- * @returns the selected Session subtree, keyed by Session identity.
+ * @returns the selected Session subtree.
  */
 export declare function renderSessionArea(binding: StandardSourceBinding, { empty, children }: SessionAreaProps): ReactNode;
 //# sourceMappingURL=session-provider.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-session",
   "description": "Session Controller adapter for React and session-scoped slots",
-  "version": "0.1.5-rc.2",
+  "version": "0.1.6-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -28,6 +28,7 @@
   "dsh": {
     "client": {
       "inject": [
+        "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-api-session-controller",
         "@deepseek-ai/dsh-client-ui-renderer"
       ],
@@ -42,11 +43,13 @@
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-store": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-store": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.6-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2"
   },
   "files": [
     "lib/index.js",