dsh-sidenote 0.3.2 → 0.3.3

package/lib/client.js

@@ -4,57 +4,117 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react_jsx_runtime = require("react/jsx-runtime");
 		let react_dom_client = require("react-dom/client");
-		//#region src/client/host/probes.ts
-		const PROBES = [
-			{
-				name: "Session.open()（非 staged 会话开窗）",
-				check: (ctx) => {
-					return typeof ctx.sessions?.binding === "function";
-				},
-				fallback: "侧边聊天消息流降级为只发不收"
-			},
-			{
-				name: "conversation.input 输入机器",
-				check: (ctx) => {
-					return typeof (ctx.get?.("conversation"))?.input?.for === "function";
-				},
-				fallback: "侧边 composer 降级为本地草稿 + session.prompt"
-			},
-			{
-				name: "commandUi（斜杠命令注册）",
-				check: (ctx) => {
-					return typeof (ctx.get?.("commandUi"))?.register === "function";
-				},
-				fallback: "/side 与「/侧边」命令不可用（菜单/顶栏入口仍在）"
-			},
-			{
-				name: "ctx.modules.import（动态组件复用）",
-				check: (ctx) => {
-					return typeof ctx.modules?.import === "function";
-				},
-				fallback: "ProducedFiles 等动态复用件降级为自绘"
+		//#region src/client/sidechat/native.ts
+		/** better-sidebar version that moved the right column to DSH's native sidebar. */
+		const NATIVE_SIDEBAR_MINOR = 19;
+		let root;
+		/** Remember the plugin root context at activation (see module docstring). */
+		function setRootContext(ctx) {
+			root = ctx;
+		}
+		/** Plugin root context; falls back to the caller's context (legacy behaviour). */
+		function rootContext(fallback) {
+			return root ?? fallback;
+		}
+		/**
+		* True when the host keeps sidebar tabs outside the legacy layout store
+		* (better-sidebar >= 0.19). Version parse is best-effort: an unparsable
+		* version reports false, which keeps the pre-0.19 behaviour.
+		*/
+		function nativeSidebarHost(ctx) {
+			try {
+				const [major = 0, minor = 0] = ctx.betterSidebar.version.split(".").map((part) => Number.parseInt(part, 10));
+				return major > 0 || minor >= NATIVE_SIDEBAR_MINOR;
+			} catch {
+				return false;
 			}
-		];
-		/** 激活时跑一遍探测清单；缺失项逐项 warn-once。返回缺失项数（测试可断言）。 */
-		function probeHost(ctx) {
-			let missing = 0;
-			for (const probe of PROBES) {
-				let ok = false;
-				try {
-					ok = probe.check(ctx);
-				} catch {
-					ok = false;
-				}
-				if (!ok) {
-					missing += 1;
-					console.warn(`[dsh-sidenote] 宿主能力缺失：${probe.name} → ${probe.fallback}`);
-				}
+		}
+		/** Native tab id → live panel. Native layouts are memory-only, so is this. */
+		const liveSideChats = /* @__PURE__ */ new Map();
+		/**
+		* Publish a mounted panel so programmatic entry points can focus it and seed
+		* its draft. Returns the disposer for the panel's effect cleanup.
+		*/
+		function registerLiveSideChat(sessionId, tabId, seedDraft, readMeta) {
+			const entry = {
+				tabId,
+				sessionId,
+				seedDraft,
+				readMeta
+			};
+			liveSideChats.set(tabId, entry);
+			const opening = openings.get(sessionId);
+			if (opening !== void 0) {
+				openings.delete(sessionId);
+				for (const draft of opening.drafts) seedDraft(draft);
+			}
+			return () => {
+				if (liveSideChats.get(tabId) === entry) liveSideChats.delete(tabId);
+			};
+		}
+		/** 标记失效应力：openTab 被静默拒绝/面板未挂载时，超时后允许重试。 */
+		const OPENING_TTL_MS = 1e4;
+		const openings = /* @__PURE__ */ new Map();
+		/** 标记一次已发起、面板尚未注册的 native 打开（create/reopen 铸造后调用）。 */
+		function markSideChatOpening(sessionId) {
+			openings.set(sessionId, {
+				at: Date.now(),
+				drafts: []
+			});
+		}
+		/** 进行中的打开；TTL 外视为 openTab 被拒/面板未挂载，清除并返回 undefined。 */
+		function sideChatOpening(sessionId) {
+			const mark = openings.get(sessionId);
+			if (mark === void 0) return void 0;
+			if (Date.now() - mark.at > OPENING_TTL_MS) {
+				openings.delete(sessionId);
+				return;
+			}
+			return mark;
+		}
+		/**
+		* Most recently registered live panel of a session — the open-or-focus target
+		* when the legacy snapshot cannot see the tab (mirrors "last opened wins").
+		*/
+		function lastLiveSideChat(sessionId) {
+			let found;
+			for (const entry of liveSideChats.values()) if (entry.sessionId === sessionId) found = entry;
+			return found;
+		}
+		/** Native tab shell for reads that go through the layout snapshot (`readTab`). */
+		function nativeTabShell(tabId, type) {
+			const entry = liveSideChats.get(tabId);
+			if (entry === void 0) return void 0;
+			return {
+				id: entry.tabId,
+				type,
+				title: "",
+				meta: entry.readMeta()
+			};
+		}
+		/**
+		* 聚焦一个 native tab：better-sidebar >= 0.19 的 `surface.activate` 是空操作
+		* （只返回记录存在性——authority: dsh-better-sidebar src/client/native/surface.ts），
+		* 真实聚焦面是 dsh 0.1.5 的 `ISidebarRight.focus`（authority:
+		* dsh-client-ui-sidebar-right lib/types/client/service.d.ts `focus(tabId)`）。
+		* focus 只标记活动 tab/pane，不展开折叠的栏——聚焦的语义包含「让用户看见」，
+		* 故折叠时补 toggleExpanded（authority: 同文件 `isExpanded/toggleExpanded`）。
+		* @returns true = 已通过 focus 聚焦；false = 面缺席（调用方回退 activateTab）。
+		*/
+		function focusNativeTab(ctx, tabId) {
+			try {
+				const face = ctx.get("sidebarRight");
+				if (typeof face?.focus !== "function") return false;
+				face.focus(tabId);
+				if (face.isExpanded?.() === false) face.toggleExpanded?.();
+				return true;
+			} catch {
+				return false;
 			}
-			return missing;
 		}
 		//#endregion
 		//#region src/client/locales.ts
@@ -350,135 +410,6 @@ window.__ModuleLoader__.load({
 			return text;
 		}
 		//#endregion
-		//#region src/client/reflow.ts
-		/**
-		* 回流通道的受控对象层（Delivery_02 Workitem_04 v2）：侧边聊天的结论以
-		* 「待回流对象」进入主会话——主 composer 上方的 chip（可预览/可移除），
-		* 发送瞬间由 annotate/send.ts 拦截器与注释协议块一起序列化进消息。
-		* 不经草稿文本流（用户裁定：直接进草稿「很脏」）。
-		*
-		* 气泡留痕：序列化形态是 XML 协议块（见 buildReflowBlock），随注释协议块
-		* 一起作为消息连续前缀注入，bubble.ts 反解析后折叠为「含侧边回流上下文」标签。
-		*
-		* 持久化：localStorage 按会话键（dsh-sidenote:reflow:v1:<sessionId>），
-		* 与注释 store 同款纪律（刷新不丢、容错 revive、空删键）。
-		*/
-		const STORAGE_PREFIX$1 = "dsh-sidenote:reflow:v1:";
-		/**
-		* 回流块序列化（XML 形态，与注释协议同族）：
-		*
-		*   <reflow source="侧边 2" reason="用户选择从侧边聊天带回主线">
-		*   <问>用户在侧边聊天里的提问</问>
-		*   <答>结论全文（不截断）</答>
-		*   </reflow>
-		*
-		* 问答成对：只有答没有问，模型理解打折；question 缺省时只有 <答>。
-		* 来源与意图放在属性里，内容行保持纯净；模型对 XML 包裹的上下文理解最好
-		* （Claude 官方推荐形态 / Codex additionalContext 同款思路）。
-		*/
-		function buildReflowBlock(item) {
-			const parts = [];
-			if (item.question !== void 0 && item.question.trim() !== "") parts.push(`<问>${item.question}</问>`);
-			parts.push(`<答>${item.text}</答>`);
-			return `<reflow source="${item.sideTitle}" reason="${t("reflowReason")}">\n${parts.join("\n")}\n</reflow>`;
-		}
-		function revive(value) {
-			if (typeof value !== "object" || value === null) return null;
-			const r = value;
-			if (typeof r.id !== "number" || typeof r.sessionId !== "string" || r.sessionId === "") return null;
-			if (typeof r.sideTitle !== "string" || typeof r.text !== "string") return null;
-			return {
-				id: r.id,
-				sessionId: r.sessionId,
-				sideTitle: r.sideTitle,
-				text: r.text,
-				...typeof r.question === "string" && r.question.trim() !== "" ? { question: r.question } : {},
-				createdAt: typeof r.createdAt === "number" ? r.createdAt : 0
-			};
-		}
-		function createReflowStore(now = () => Date.now(), storage) {
-			let items = [];
-			let nextId = 1;
-			let version = 0;
-			const listeners = /* @__PURE__ */ new Set();
-			const store = storage === void 0 ? typeof localStorage !== "undefined" ? localStorage : null : storage;
-			if (store != null) try {
-				const keys = [];
-				for (let i = 0; i < store.length; i += 1) {
-					const key = store.key(i);
-					if (typeof key === "string" && key.startsWith(STORAGE_PREFIX$1)) keys.push(key);
-				}
-				for (const key of keys) {
-					const parsed = JSON.parse(store.getItem(key) ?? "null");
-					if (!Array.isArray(parsed)) continue;
-					for (const raw of parsed) {
-						const item = revive(raw);
-						if (item === null) continue;
-						items.push(item);
-						nextId = Math.max(nextId, item.id + 1);
-					}
-				}
-			} catch (error) {
-				console.warn("[dsh-sidenote] 回流持久化读取失败（按空起步）:", error);
-			}
-			const persist = (sessionId) => {
-				if (store == null) return;
-				try {
-					const mine = items.filter((i) => i.sessionId === sessionId);
-					const key = STORAGE_PREFIX$1 + sessionId;
-					if (mine.length === 0) store.removeItem(key);
-					else store.setItem(key, JSON.stringify(mine));
-				} catch (error) {
-					console.warn("[dsh-sidenote] 回流持久化写入失败:", error);
-				}
-			};
-			const notify = () => {
-				version += 1;
-				for (const fn of [...listeners]) fn();
-			};
-			return {
-				getSnapshot: () => version,
-				subscribe(fn) {
-					listeners.add(fn);
-					return () => {
-						listeners.delete(fn);
-					};
-				},
-				add(sessionId, sideTitle, text, question) {
-					const item = {
-						id: nextId,
-						sessionId,
-						sideTitle,
-						text,
-						...typeof question === "string" && question.trim() !== "" ? { question } : {},
-						createdAt: now()
-					};
-					nextId += 1;
-					items = [...items, item];
-					persist(sessionId);
-					notify();
-					return item;
-				},
-				remove(id) {
-					const target = items.find((i) => i.id === id);
-					if (target === void 0) return;
-					items = items.filter((i) => i.id !== id);
-					persist(target.sessionId);
-					notify();
-				},
-				clearSession(sessionId) {
-					if (!items.some((i) => i.sessionId === sessionId)) return;
-					items = items.filter((i) => i.sessionId !== sessionId);
-					persist(sessionId);
-					notify();
-				},
-				list: (sessionId) => items.filter((i) => i.sessionId === sessionId)
-			};
-		}
-		//#endregion
-		//#region src/client/bridge.ts
-		const sideChatBridge = { current: null };
-		//#endregion
 		//#region src/client/annotate/format.ts
 		/** 协议头（双语）：zh「我批注了以下 2 处内容：」/ en 见 locales。 */
 		function protocolHeader(n) {
@@ -831,6 +762,540 @@ window.__ModuleLoader__.load({
 			};
 		}
 		//#endregion
+		//#region src/client/sidechat/open.ts
+		/**
+		* 从最新快照读一个 Tab（meta 合并写入前的读取面；布局即注册表）。
+		* better-sidebar >= 0.19: the open tab lives in the native right sidebar, not
+		* in the layout snapshot — fall back to the live-panel registry.
+		*/
+		function readTab(ctx, tabId) {
+			return collectTabs(ctx.betterSidebar.getSnapshot().state).find((candidate) => candidate.id === tabId) ?? nativeTabShell(tabId, "dsh-sidenote:side");
+		}
+		/**
+		* 为 sessionId 新建或聚焦一个侧边聊天 Tab；draftText 给出时写入其草稿。
+		* @returns false = 未能打开（调用方保持自己的流程）。
+		*/
+		function openOrFocusSideChat(ctx, sessionId, draftText) {
+			try {
+				const snapshot = ctx.betterSidebar.getSnapshot();
+				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return false;
+				const existing = collectSideTabs(snapshot.state);
+				const live = lastLiveSideChat(sessionId);
+				if (live !== void 0) {
+					if (draftText !== void 0 && draftText !== "") live.seedDraft(draftText);
+					if (!focusNativeTab(ctx, live.tabId)) ctx.betterSidebar.activateTab(live.tabId, { sessionId });
+					return true;
+				}
+				if (existing.length > 0) {
+					const target = existing[existing.length - 1];
+					if (draftText !== void 0 && draftText !== "") {
+						const meta = parseSideChatMeta(target.meta);
+						const input = meta.childId === void 0 ? null : resolveSessionInput(ctx, meta.childId);
+						if (input !== null) input.setDraft(appendDraftText(readInputDraft(input), draftText));
+						else ctx.betterSidebar.updateTab(target.id, { meta: {
+							...meta,
+							pendingDraft: appendDraftText(meta.pendingDraft ?? "", draftText)
+						} });
+					}
+					ctx.betterSidebar.activateTab(target.id, { sessionId });
+					return true;
+				}
+				const opening = sideChatOpening(sessionId);
+				if (opening !== void 0) {
+					if (draftText !== void 0 && draftText !== "") opening.drafts.push(draftText);
+					return true;
+				}
+				return createSideChat(ctx, sessionId, draftText);
+			} catch (error) {
+				console.warn("[dsh-sidenote] 打开侧边聊天失败:", error);
+				return false;
+			}
+		}
+		/**
+		* 无条件新建一个侧边聊天 Tab（/side「新建侧边聊天」选项的语义——既有实例
+		* 在弹层里另有聚焦项，「新建」必须真的新建，否则标签与行为不符）。
+		* @returns false = 未能创建（调用方保持自己的流程）。
+		*/
+		function createSideChat(ctx, sessionId, draftText) {
+			try {
+				const snapshot = ctx.betterSidebar.getSnapshot();
+				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return false;
+				if (!ctx.betterSidebar.isTabEnabled("dsh-sidenote:side")) return false;
+				const before = new Set(collectTabs(snapshot.state).map((tab) => tab.id));
+				const seed = draftText !== void 0 && draftText !== "" ? {
+					type: SIDE_TAB_TYPE,
+					meta: { pendingDraft: draftText }
+				} : { type: SIDE_TAB_TYPE };
+				ctx.betterSidebar.openTab(seed, { sessionId });
+				const created = collectSideTabs(ctx.betterSidebar.getSnapshot().state).find((tab) => !before.has(tab.id));
+				if (created === void 0) {
+					if (!nativeSidebarHost(ctx)) return false;
+					markSideChatOpening(sessionId);
+					return true;
+				}
+				if (draftText !== void 0 && draftText !== "") ctx.betterSidebar.updateTab(created.id, { meta: { pendingDraft: draftText } });
+				return true;
+			} catch (error) {
+				console.warn("[dsh-sidenote] 新建侧边聊天失败:", error);
+				return false;
+			}
+		}
+		/**
+		* 桥接/命令的目标预览：askInSideChat 此时若执行会落在哪个 Tab 的标题
+		* （既有并存 = 最后一个；无 = 即将新建的首个标题）。用于编辑器上标明
+		* 「发送至：侧边 N」。会话不在屏上/状态缺失时返回 undefined。
+		*/
+		function sideChatTargetTitle(ctx, sessionId) {
+			try {
+				const snapshot = ctx.betterSidebar.getSnapshot();
+				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return void 0;
+				const existing = collectSideTabs(snapshot.state);
+				if (existing.length > 0) return existing[existing.length - 1].title;
+				return sideTabTitle([]);
+			} catch {
+				return;
+			}
+		}
+		/**
+		* 重开最近关闭的侧边聊天（D3 后悔药）：开 Tab + meta 预置 childId/
+		* parentSessionId——面板挂载后走绑定恢复路径（不重新 fork）。
+		* 会话本体必须仍 archived 在列（若被清理，面板落「会话已不存在」态——
+		* 有现成错误态兜着）。
+		*/
+		function reopenSideChat(ctx, sessionId, childId, title) {
+			try {
+				const snapshot = ctx.betterSidebar.getSnapshot();
+				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return false;
+				if (!ctx.betterSidebar.isTabEnabled("dsh-sidenote:side")) return false;
+				const before = new Set(collectTabs(snapshot.state).map((tab) => tab.id));
+				const meta = {
+					childId,
+					parentSessionId: sessionId
+				};
+				ctx.betterSidebar.openTab({
+					type: SIDE_TAB_TYPE,
+					...title !== void 0 ? { title } : {},
+					meta
+				}, { sessionId });
+				const created = collectSideTabs(ctx.betterSidebar.getSnapshot().state).find((tab) => !before.has(tab.id));
+				if (created === void 0) {
+					if (!nativeSidebarHost(ctx)) return false;
+					markSideChatOpening(sessionId);
+					return true;
+				}
+				ctx.betterSidebar.updateTab(created.id, {
+					...title !== void 0 ? { title } : {},
+					meta
+				});
+				return true;
+			} catch (error) {
+				console.warn("[dsh-sidenote] 重开侧边聊天失败:", error);
+				return false;
+			}
+		}
+		//#endregion
+		//#region src/client/sidechat/lifecycle.ts
+		/**
+		* 首开编排：fork（全量历史快照）→ 登记 meta（先行，绝不丢登记）→
+		* 归档隐藏出会话列表（best-effort）→ 模型跟随主会话（best-effort）。
+		* fork 失败抛错（面板组件转错误态）；后两步失败只告警不阻断。
+		* @returns fork 出的子会话 id。
+		*/
+		async function forkAndRegister(ctx, parentSessionId, tabId) {
+			let boundarySeq;
+			try {
+				const snap = chatSourceOf(ctx, ctx.sessions.binding(parentSessionId))?.getLegacy();
+				let max = -1;
+				for (const node of snap?.nodes ?? []) {
+					const seq = node.seq;
+					if (typeof seq === "number" && seq > max) max = seq;
+				}
+				if (max >= 0) boundarySeq = max;
+			} catch {}
+			const forked = await ctx.sessions.fork({ sessionId: parentSessionId });
+			const owner = rootContext(ctx);
+			updateTabMeta(ctx, tabId, (current) => ({
+				...current,
+				childId: forked,
+				parentSessionId,
+				...boundarySeq !== void 0 ? { boundarySeq } : {}
+			}));
+			try {
+				await owner.workspaces.archiveSession(forked);
+			} catch (error) {
+				console.warn("[dsh-sidenote] 归档侧边会话失败（会话列表可能短暂可见）:", error);
+			}
+			try {
+				const selection = await readModelSelection(owner, parentSessionId);
+				if (selection === void 0) console.warn("[dsh-sidenote] 同步主会话模型跳过：主机模型 API 不可用");
+				else if (!await writeModelSelection(owner, forked, selection)) console.warn("[dsh-sidenote] 同步主会话模型失败（子会话用默认模型）");
+			} catch (error) {
+				console.warn("[dsh-sidenote] 同步主会话模型失败（子会话用默认模型）:", error);
+			}
+			return forked;
+		}
+		/** Tab meta 读-改-写（布局持久化寄存处）；tab 已消失时 no-op。 */
+		function updateTabMeta(ctx, tabId, mutate) {
+			const current = parseSideChatMeta(readTab(ctx, tabId)?.meta);
+			ctx.betterSidebar.updateTab(tabId, { meta: mutate(current) });
+		}
+		/**
+		* 程序化入口（/side、bridge 划选提问）打开 Tab 时面板可能处于折叠态——
+		* 类型型 openTab 不自动展开（better-sidebar 只对 path/url 内容型打开展开）。
+		* 幂等展开（off-face：store.update 是 SidebarStore 公开 mutator 面；
+		* feature-check + 吞错，兜底失败不影响功能）。
+		*/
+		function ensurePanelOpen(store) {
+			const mutable = store;
+			try {
+				mutable?.update?.((state) => {
+					if (state.panelOpen === false) state.panelOpen = true;
+				});
+			} catch {}
+		}
+		/**
+		* 打开非 staged 会话的事件窗口（off-face：open() 在 concrete Session 上是
+		* public 且幂等，但不在 SessionFace 契约上——契约面只有 staged 会话会被
+		* 运行时自动 open）。feature-check + 吞错，运行时若移除则降级为只发不收。
+		*/
+		function openSessionWindow(session) {
+			const openable = session;
+			if (typeof openable?.open !== "function") return;
+			openable.open().catch((error) => {
+				console.warn("[dsh-sidenote] 会话窗口打开失败:", error);
+			});
+		}
+		/**
+		* Current model selection of a session, read from its `modelSelection`
+		* projection (dsh >= 0.1.2): the durable selection is projected state, so no RPC
+		* is needed and the read is safe for any session id. Snapshot shape authority:
+		* `@deepseek-ai/dsh-api-session-controller/lib/types/types.d.ts`
+		* (`ModelSelectionProjection = { lastUsed, next }`，两者均可为 null——
+		* `next` 缺省时按投影文档回落 `lastUsed`）。
+		*/
+		function projectedModelSelection(ctx, sessionId) {
+			try {
+				const snapshot = (ctx.sessions.binding(sessionId)?.session)?.projections?.faceOf?.("modelSelection")?.getSnapshot?.();
+				return snapshot?.next ?? snapshot?.lastUsed ?? void 0;
+			} catch {
+				return;
+			}
+		}
+		/**
+		* Remote session face carrying `selectModel`/`modelCatalog`（dsh 0.1.5 删除
+		* `connection.api.sessions.*` client 面后的模型 RPC 面；事实上 0.1.2-rc.1
+		* 起存在——authority: dsh-api-session-controller lib/typert.remote-client.d.ts）。
+		* 探测走 `ctx.get`（cordis 的 get 不受 inject 门禁限制，本插件为兼容旧宿主
+		* 不声明 inject 'remote.session'；机制见 contracts.ts RemoteSessionModelFace）。
+		* `ctx.get('remote')` 返回命名空间容器时下钻其 `.session` 成员。
+		*/
+		function remoteSessionFace(ctx) {
+			for (const name of ["remote.session", "remote"]) {
+				let candidate;
+				try {
+					candidate = ctx.get(name);
+				} catch {
+					continue;
+				}
+				const face = candidate;
+				if (typeof face?.selectModel === "function") return face;
+				if (typeof face?.session?.selectModel === "function") return face.session;
+			}
+		}
+		/**
+		* 读会话当前模型选择：投影面（0.1.2+，同步无 RPC）优先；旧
+		* `connection.api.sessions.models` RPC（<= 0.1.2 的 client 面，0.1.5 已删）
+		* 回退（双版本链，同 chatSourceOf 先例）。永不抛错。
+		*/
+		async function readModelSelection(ctx, sessionId) {
+			const projected = projectedModelSelection(ctx, sessionId);
+			if (projected !== void 0) return projected;
+			try {
+				const res = await ctx.connection.api.sessions.models({ sessionId });
+				if (res.result.ok) return res.result.value.current;
+			} catch {}
+		}
+		/**
+		* 写会话模型选择：`remote.session.selectModel`（新面）优先，旧
+		* `connection.api.sessions.selectModel` 回退。面在而调用失败（模型不可路由等）
+		* 属真实失败，不再落旧面重试。
+		*/
+		async function writeModelSelection(ctx, sessionId, selection) {
+			const request = {
+				sessionId,
+				provider: selection.provider,
+				model: selection.model,
+				...selection.reasoningEffort !== void 0 ? { reasoningEffort: selection.reasoningEffort } : {}
+			};
+			const face = remoteSessionFace(ctx);
+			if (face !== void 0) try {
+				return (await face.selectModel(request)).ok;
+			} catch {
+				return false;
+			}
+			try {
+				return (await ctx.connection.api.sessions.selectModel(request)).result.ok;
+			} catch {
+				return false;
+			}
+		}
+		/** 读子会话当前模型名（composer 模型标签用）；任何失败回退 null（默认文案）。 */
+		async function readModelName(ctx, sessionId) {
+			return (await readModelSelection(ctx, sessionId))?.model ?? null;
+		}
+		/**
+		* 0.1.2 优先：`uiConversation` 服务 → binding(会话 binding) → target('chat')
+		* → 快照 .legacy 切片（0.1.2 把内容面从 Session 快照顶层拆到此处——
+		* 根因与证据见 reports/ux-review/W00-fork-replay-012.md）；0.1.1 回退
+		* Session 快照顶层（nodes 直接在）。均 miss 返回 undefined（面板维持
+		* 既有降级，不崩）。
+		*/
+		function chatSourceOf(ctx, binding) {
+			const session = binding?.session;
+			if (session === void 0) return void 0;
+			try {
+				const target = ctx.get("uiConversation")?.binding?.(binding)?.target?.("chat");
+				if (target !== void 0 && typeof target.getSnapshot === "function" && typeof target.subscribe === "function") return {
+					subscribe: (fn) => target.subscribe(fn),
+					getLegacy: () => {
+						return target.getSnapshot()?.legacy ?? null;
+					}
+				};
+			} catch {}
+			const snap = session.getSnapshot();
+			if (snap !== null && Array.isArray(snap.nodes)) return {
+				subscribe: (fn) => session.subscribe(fn),
+				getLegacy: () => session.getSnapshot()
+			};
+		}
+		/**
+		* 拉会话模型目录：0.1.5 走 `remote.session.modelCatalog()`（目录是宿主级，
+		* 菜单选中项所需的 current 由投影/旧面补上）；旧面回退
+		* `connection.api.sessions.models`。失败 null → 菜单保持只读标签态。
+		*/
+		async function listModels(ctx, sessionId) {
+			const face = remoteSessionFace(ctx);
+			if (typeof face?.modelCatalog === "function") try {
+				const result = await face.modelCatalog();
+				if (result.ok) {
+					const catalog = result.value;
+					return {
+						current: await readModelSelection(ctx, sessionId) ?? catalog.default,
+						routable: catalog.routableProviders.length > 0,
+						groups: catalog.groups,
+						...catalog.failures !== void 0 ? { failures: catalog.failures } : {}
+					};
+				}
+			} catch {}
+			try {
+				const res = await ctx.connection.api.sessions.models({ sessionId });
+				return res.result.ok ? res.result.value : null;
+			} catch {
+				return null;
+			}
+		}
+		/** 切换子会话模型；成功返回新模型展示名，失败 null（best-effort）。 */
+		async function switchModel(ctx, sessionId, provider, model) {
+			return await writeModelSelection(ctx, sessionId, {
+				provider,
+				model
+			}) ? model : null;
+		}
+		//#endregion
+		//#region src/client/host/probes.ts
+		const PROBES = [
+			{
+				name: "Session.open()（非 staged 会话开窗）",
+				check: (ctx) => {
+					return typeof ctx.sessions?.binding === "function";
+				},
+				fallback: "侧边聊天消息流降级为只发不收"
+			},
+			{
+				name: "conversation.input 输入机器",
+				check: (ctx) => {
+					return typeof (ctx.get?.("conversation"))?.input?.for === "function";
+				},
+				fallback: "侧边 composer 降级为本地草稿 + session.prompt"
+			},
+			{
+				name: "commandUi（斜杠命令注册）",
+				check: (ctx) => {
+					return typeof (ctx.get?.("commandUi"))?.register === "function";
+				},
+				fallback: "/side 与「/侧边」命令不可用（菜单/顶栏入口仍在）"
+			},
+			{
+				name: "ctx.modules.import（动态组件复用）",
+				check: (ctx) => {
+					return typeof ctx.modules?.import === "function";
+				},
+				fallback: "ProducedFiles 等动态复用件降级为自绘"
+			},
+			{
+				name: "sidebarRight.focus（native tab 程序化聚焦）",
+				check: (ctx) => {
+					if (!nativeSidebarHost(ctx)) return true;
+					return typeof (ctx.get?.("sidebarRight"))?.focus === "function";
+				},
+				fallback: "聚焦既有侧边聊天 tab 不可用（activateTab 在 native 面是空操作）"
+			},
+			{
+				name: "会话模型面（remote.session / connection.api.sessions 双版本链）",
+				check: (ctx) => {
+					if (remoteSessionFace(ctx) !== void 0) return true;
+					return typeof ctx.connection?.api?.sessions?.models === "function";
+				},
+				fallback: "fork 模型同步、模型标签与模型切换不可用（子会话用宿主默认模型）"
+			}
+		];
+		/** 激活时跑一遍探测清单；缺失项逐项 warn-once。返回缺失项数（测试可断言）。 */
+		function probeHost(ctx) {
+			let missing = 0;
+			for (const probe of PROBES) {
+				let ok = false;
+				try {
+					ok = probe.check(ctx);
+				} catch {
+					ok = false;
+				}
+				if (!ok) {
+					missing += 1;
+					console.warn(`[dsh-sidenote] 宿主能力缺失：${probe.name} → ${probe.fallback}`);
+				}
+			}
+			return missing;
+		}
+		//#endregion
+		//#region src/client/reflow.ts
+		/**
+		* 回流通道的受控对象层（Delivery_02 Workitem_04 v2）：侧边聊天的结论以
+		* 「待回流对象」进入主会话——主 composer 上方的 chip（可预览/可移除），
+		* 发送瞬间由 annotate/send.ts 拦截器与注释协议块一起序列化进消息。
+		* 不经草稿文本流（用户裁定：直接进草稿「很脏」）。
+		*
+		* 气泡留痕：序列化形态是 XML 协议块（见 buildReflowBlock），随注释协议块
+		* 一起作为消息连续前缀注入，bubble.ts 反解析后折叠为「含侧边回流上下文」标签。
+		*
+		* 持久化：localStorage 按会话键（dsh-sidenote:reflow:v1:<sessionId>），
+		* 与注释 store 同款纪律（刷新不丢、容错 revive、空删键）。
+		*/
+		const STORAGE_PREFIX$1 = "dsh-sidenote:reflow:v1:";
+		/**
+		* 回流块序列化（XML 形态，与注释协议同族）：
+		*
+		*   <reflow source="侧边 2" reason="用户选择从侧边聊天带回主线">
+		*   <问>用户在侧边聊天里的提问</问>
+		*   <答>结论全文（不截断）</答>
+		*   </reflow>
+		*
+		* 问答成对：只有答没有问，模型理解打折；question 缺省时只有 <答>。
+		* 来源与意图放在属性里，内容行保持纯净；模型对 XML 包裹的上下文理解最好
+		* （Claude 官方推荐形态 / Codex additionalContext 同款思路）。
+		*/
+		function buildReflowBlock(item) {
+			const parts = [];
+			if (item.question !== void 0 && item.question.trim() !== "") parts.push(`<问>${item.question}</问>`);
+			parts.push(`<答>${item.text}</答>`);
+			return `<reflow source="${item.sideTitle}" reason="${t("reflowReason")}">\n${parts.join("\n")}\n</reflow>`;
+		}
+		function revive(value) {
+			if (typeof value !== "object" || value === null) return null;
+			const r = value;
+			if (typeof r.id !== "number" || typeof r.sessionId !== "string" || r.sessionId === "") return null;
+			if (typeof r.sideTitle !== "string" || typeof r.text !== "string") return null;
+			return {
+				id: r.id,
+				sessionId: r.sessionId,
+				sideTitle: r.sideTitle,
+				text: r.text,
+				...typeof r.question === "string" && r.question.trim() !== "" ? { question: r.question } : {},
+				createdAt: typeof r.createdAt === "number" ? r.createdAt : 0
+			};
+		}
+		function createReflowStore(now = () => Date.now(), storage) {
+			let items = [];
+			let nextId = 1;
+			let version = 0;
+			const listeners = /* @__PURE__ */ new Set();
+			const store = storage === void 0 ? typeof localStorage !== "undefined" ? localStorage : null : storage;
+			if (store != null) try {
+				const keys = [];
+				for (let i = 0; i < store.length; i += 1) {
+					const key = store.key(i);
+					if (typeof key === "string" && key.startsWith(STORAGE_PREFIX$1)) keys.push(key);
+				}
+				for (const key of keys) {
+					const parsed = JSON.parse(store.getItem(key) ?? "null");
+					if (!Array.isArray(parsed)) continue;
+					for (const raw of parsed) {
+						const item = revive(raw);
+						if (item === null) continue;
+						items.push(item);
+						nextId = Math.max(nextId, item.id + 1);
+					}
+				}
+			} catch (error) {
+				console.warn("[dsh-sidenote] 回流持久化读取失败（按空起步）:", error);
+			}
+			const persist = (sessionId) => {
+				if (store == null) return;
+				try {
+					const mine = items.filter((i) => i.sessionId === sessionId);
+					const key = STORAGE_PREFIX$1 + sessionId;
+					if (mine.length === 0) store.removeItem(key);
+					else store.setItem(key, JSON.stringify(mine));
+				} catch (error) {
+					console.warn("[dsh-sidenote] 回流持久化写入失败:", error);
+				}
+			};
+			const notify = () => {
+				version += 1;
+				for (const fn of [...listeners]) fn();
+			};
+			return {
+				getSnapshot: () => version,
+				subscribe(fn) {
+					listeners.add(fn);
+					return () => {
+						listeners.delete(fn);
+					};
+				},
+				add(sessionId, sideTitle, text, question) {
+					const item = {
+						id: nextId,
+						sessionId,
+						sideTitle,
+						text,
+						...typeof question === "string" && question.trim() !== "" ? { question } : {},
+						createdAt: now()
+					};
+					nextId += 1;
+					items = [...items, item];
+					persist(sessionId);
+					notify();
+					return item;
+				},
+				remove(id) {
+					const target = items.find((i) => i.id === id);
+					if (target === void 0) return;
+					items = items.filter((i) => i.id !== id);
+					persist(target.sessionId);
+					notify();
+				},
+				clearSession(sessionId) {
+					if (!items.some((i) => i.sessionId === sessionId)) return;
+					items = items.filter((i) => i.sessionId !== sessionId);
+					persist(sessionId);
+					notify();
+				},
+				list: (sessionId) => items.filter((i) => i.sessionId === sessionId)
+			};
+		}
+		//#endregion
+		//#region src/client/bridge.ts
+		const sideChatBridge = { current: null };
+		//#endregion
 		//#region src/client/chat/cards.ts
 		/** ContentBlock[] → 纯文本（transcript.ts 同款的极简版，避免互依赖）。 */
 		function blocksText(content) {
@@ -1694,92 +2159,92 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var sidechat_module_css_default = {
-			"composerCard": "_5KEEsG_composerCard",
-			"streamingHint": "_5KEEsG_streamingHint",
-			"stopButton": "_5KEEsG_stopButton",
-			"transcript": "_5KEEsG_transcript",
-			"rowPreview": "_5KEEsG_rowPreview",
-			"toolGenericBody": "_5KEEsG_toolGenericBody",
-			"densityRow": "_5KEEsG_densityRow",
-			"pendingReason": "_5KEEsG_pendingReason",
-			"toolError": "_5KEEsG_toolError",
-			"pendingOptionDesc": "_5KEEsG_pendingOptionDesc",
-			"empty": "_5KEEsG_empty",
-			"stateScreen": "_5KEEsG_stateScreen",
-			"slashMenu": "_5KEEsG_slashMenu",
-			"userBubble": "_5KEEsG_userBubble",
-			"dotPending": "_5KEEsG_dotPending",
-			"pendingOptionActive": "_5KEEsG_pendingOptionActive",
-			"pendingDesc": "_5KEEsG_pendingDesc",
-			"pendingActions": "_5KEEsG_pendingActions",
-			"todoDot": "_5KEEsG_todoDot",
-			"todoText": "_5KEEsG_todoText",
-			"emptyIcon": "_5KEEsG_emptyIcon",
-			"reflowButton": "_5KEEsG_reflowButton",
-			"pendingBtnPrimary": "_5KEEsG_pendingBtnPrimary",
 			"reasoningBody": "_5KEEsG_reasoningBody",
-			"inheritedBody": "_5KEEsG_inheritedBody",
-			"attachRail": "_5KEEsG_attachRail",
-			"pendingBtnGhost": "_5KEEsG_pendingBtnGhost",
-			"dotIdle": "_5KEEsG_dotIdle",
-			"slashItemName": "_5KEEsG_slashItemName",
+			"pendingTitle": "_5KEEsG_pendingTitle",
+			"todoItem": "_5KEEsG_todoItem",
+			"todoDot": "_5KEEsG_todoDot",
+			"composer": "_5KEEsG_composer",
 			"sendButton": "_5KEEsG_sendButton",
-			"slashItemActive": "_5KEEsG_slashItemActive",
+			"userBubble": "_5KEEsG_userBubble",
+			"toolLocations": "_5KEEsG_toolLocations",
+			"pendingCard": "_5KEEsG_pendingCard",
+			"pendingQuestion": "_5KEEsG_pendingQuestion",
+			"errorRow": "_5KEEsG_errorRow",
+			"composerFoot": "_5KEEsG_composerFoot",
+			"sentChip": "_5KEEsG_sentChip",
+			"noticeRow": "_5KEEsG_noticeRow",
+			"stopButton": "_5KEEsG_stopButton",
 			"stateDetail": "_5KEEsG_stateDetail",
+			"flowRowError": "_5KEEsG_flowRowError",
 			"emptyTitle": "_5KEEsG_emptyTitle",
+			"slashGroupTitle": "_5KEEsG_slashGroupTitle",
 			"pendingCustom": "_5KEEsG_pendingCustom",
-			"dotRunning": "_5KEEsG_dotRunning",
-			"densityToggle": "_5KEEsG_densityToggle",
-			"pendingOption": "_5KEEsG_pendingOption",
-			"modelLabel": "_5KEEsG_modelLabel",
-			"body": "_5KEEsG_body",
-			"toolHead": "_5KEEsG_toolHead",
-			"reasoning": "_5KEEsG_reasoning",
-			"pendingQHeader": "_5KEEsG_pendingQHeader",
+			"pendingBtnGhost": "_5KEEsG_pendingBtnGhost",
+			"attachButton": "_5KEEsG_attachButton",
+			"pendingOptionDesc": "_5KEEsG_pendingOptionDesc",
 			"writeNotice": "_5KEEsG_writeNotice",
 			"input": "_5KEEsG_input",
+			"userRow": "_5KEEsG_userRow",
+			"sidechat-pulse": "_5KEEsG_sidechat-pulse",
+			"empty": "_5KEEsG_empty",
+			"emptyIcon": "_5KEEsG_emptyIcon",
+			"toolCard": "_5KEEsG_toolCard",
+			"composerCard": "_5KEEsG_composerCard",
+			"toolError": "_5KEEsG_toolError",
+			"attachImg": "_5KEEsG_attachImg",
+			"pendingQHeader": "_5KEEsG_pendingQHeader",
+			"pendingActions": "_5KEEsG_pendingActions",
+			"toolHead": "_5KEEsG_toolHead",
 			"sentChipRow": "_5KEEsG_sentChipRow",
-			"todoItem": "_5KEEsG_todoItem",
-			"composer": "_5KEEsG_composer",
-			"slashItem": "_5KEEsG_slashItem",
+			"pendingBtnPrimary": "_5KEEsG_pendingBtnPrimary",
+			"dotPending": "_5KEEsG_dotPending",
+			"rowActions": "_5KEEsG_rowActions",
+			"transcript": "_5KEEsG_transcript",
+			"modelLabel": "_5KEEsG_modelLabel",
 			"flowRow": "_5KEEsG_flowRow",
-			"pendingHead": "_5KEEsG_pendingHead",
+			"toolBodyText": "_5KEEsG_toolBodyText",
+			"toolGenericBody": "_5KEEsG_toolGenericBody",
 			"composerChips": "_5KEEsG_composerChips",
-			"errorRow": "_5KEEsG_errorRow",
-			"slashItemDetail": "_5KEEsG_slashItemDetail",
-			"toolRunning": "_5KEEsG_toolRunning",
-			"noticeRow": "_5KEEsG_noticeRow",
-			"pendingTitle": "_5KEEsG_pendingTitle",
-			"jumpBottom": "_5KEEsG_jumpBottom",
-			"flowRowError": "_5KEEsG_flowRowError",
-			"sidechat-pulse": "_5KEEsG_sidechat-pulse",
-			"root": "_5KEEsG_root",
-			"emptyText": "_5KEEsG_emptyText",
-			"slashGroupTitle": "_5KEEsG_slashGroupTitle",
-			"toolCard": "_5KEEsG_toolCard",
+			"attachRail": "_5KEEsG_attachRail",
+			"pendingQText": "_5KEEsG_pendingQText",
+			"pendingOption": "_5KEEsG_pendingOption",
+			"dotIdle": "_5KEEsG_dotIdle",
+			"stateScreen": "_5KEEsG_stateScreen",
+			"attachRemove": "_5KEEsG_attachRemove",
+			"dotRunning": "_5KEEsG_dotRunning",
+			"actionGroup": "_5KEEsG_actionGroup",
 			"assistantBody": "_5KEEsG_assistantBody",
-			"composerFoot": "_5KEEsG_composerFoot",
-			"attachButton": "_5KEEsG_attachButton",
-			"userRow": "_5KEEsG_userRow",
-			"todoBody": "_5KEEsG_todoBody",
-			"toolBodyText": "_5KEEsG_toolBodyText",
-			"pendingCard": "_5KEEsG_pendingCard",
+			"todoText": "_5KEEsG_todoText",
+			"pendingReason": "_5KEEsG_pendingReason",
+			"root": "_5KEEsG_root",
+			"pendingOptionActive": "_5KEEsG_pendingOptionActive",
 			"parentStrip": "_5KEEsG_parentStrip",
-			"toolLocations": "_5KEEsG_toolLocations",
-			"actionGroup": "_5KEEsG_actionGroup",
+			"toolRunning": "_5KEEsG_toolRunning",
+			"modelSelect": "_5KEEsG_modelSelect",
+			"pendingDesc": "_5KEEsG_pendingDesc",
+			"body": "_5KEEsG_body",
+			"densityToggle": "_5KEEsG_densityToggle",
 			"headerSide": "_5KEEsG_headerSide",
-			"attachImg": "_5KEEsG_attachImg",
-			"attachRemove": "_5KEEsG_attachRemove",
-			"assistantRow": "_5KEEsG_assistantRow",
-			"pendingQuestion": "_5KEEsG_pendingQuestion",
-			"writeNoticeClose": "_5KEEsG_writeNoticeClose",
-			"toolBody": "_5KEEsG_toolBody",
-			"sentChip": "_5KEEsG_sentChip",
+			"reflowButton": "_5KEEsG_reflowButton",
+			"emptyText": "_5KEEsG_emptyText",
+			"densityRow": "_5KEEsG_densityRow",
+			"jumpBottom": "_5KEEsG_jumpBottom",
+			"inheritedBody": "_5KEEsG_inheritedBody",
+			"reasoning": "_5KEEsG_reasoning",
 			"pendingBar": "_5KEEsG_pendingBar",
-			"rowActions": "_5KEEsG_rowActions",
-			"modelSelect": "_5KEEsG_modelSelect",
+			"toolBody": "_5KEEsG_toolBody",
+			"writeNoticeClose": "_5KEEsG_writeNoticeClose",
+			"slashItemActive": "_5KEEsG_slashItemActive",
+			"slashMenu": "_5KEEsG_slashMenu",
+			"todoBody": "_5KEEsG_todoBody",
+			"streamingHint": "_5KEEsG_streamingHint",
+			"rowPreview": "_5KEEsG_rowPreview",
+			"slashItem": "_5KEEsG_slashItem",
+			"slashItemDetail": "_5KEEsG_slashItemDetail",
 			"attachThumb": "_5KEEsG_attachThumb",
-			"pendingQText": "_5KEEsG_pendingQText"
+			"pendingHead": "_5KEEsG_pendingHead",
+			"slashItemName": "_5KEEsG_slashItemName",
+			"assistantRow": "_5KEEsG_assistantRow"
 		};
 		//#endregion
 		//#region src/client/chat/ToolCard.tsx
@@ -2258,266 +2723,71 @@ window.__ModuleLoader__.load({
 							className: sidechat_module_css_default.toolBody,
 							children: message.text
 						})]
-					});
-				case "error": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: sidechat_module_css_default.errorRow,
-					children: message.text
-				});
-				case "notice": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-					className: sidechat_module_css_default.noticeRow,
-					children: message.text
-				});
-			}
-		}, rowPropsEqual);
-		/** memo 比较器：transcriptOf 每次快照重建消息对象（引用必变），按字段值比。 */
-		function rowPropsEqual(prev, next) {
-			if (prev.fold !== next.fold || prev.reflow !== next.reflow) return false;
-			if (prev.parentSessionId !== next.parentSessionId || prev.sideTitle !== next.sideTitle) return false;
-			if (prev.question !== next.question) return false;
-			const a = prev.message;
-			const b = next.message;
-			return a === b || a.key === b.key && a.role === b.role && a.text === b.text && a.reasoning === b.reasoning && a.streaming === b.streaming && a.isError === b.isError && a.interrupted === b.interrupted && a.toolName === b.toolName && a.card === b.card && a.seq === b.seq;
-		}
-		//#endregion
-		//#region src/client/sidechat/open.ts
-		/** 从最新快照读一个 Tab（meta 合并写入前的读取面；布局即注册表）。 */
-		function readTab(ctx, tabId) {
-			return collectTabs(ctx.betterSidebar.getSnapshot().state).find((tab) => tab.id === tabId);
-		}
-		/**
-		* 为 sessionId 新建或聚焦一个侧边聊天 Tab；draftText 给出时写入其草稿。
-		* @returns false = 未能打开（调用方保持自己的流程）。
-		*/
-		function openOrFocusSideChat(ctx, sessionId, draftText) {
-			try {
-				const snapshot = ctx.betterSidebar.getSnapshot();
-				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return false;
-				const existing = collectSideTabs(snapshot.state);
-				if (existing.length > 0) {
-					const target = existing[existing.length - 1];
-					if (draftText !== void 0 && draftText !== "") {
-						const meta = parseSideChatMeta(target.meta);
-						const input = meta.childId === void 0 ? null : resolveSessionInput(ctx, meta.childId);
-						if (input !== null) input.setDraft(appendDraftText(readInputDraft(input), draftText));
-						else ctx.betterSidebar.updateTab(target.id, { meta: {
-							...meta,
-							pendingDraft: appendDraftText(meta.pendingDraft ?? "", draftText)
-						} });
-					}
-					ctx.betterSidebar.activateTab(target.id, { sessionId });
-					return true;
-				}
-				return createSideChat(ctx, sessionId, draftText);
-			} catch (error) {
-				console.warn("[dsh-sidenote] 打开侧边聊天失败:", error);
-				return false;
-			}
-		}
-		/**
-		* 无条件新建一个侧边聊天 Tab（/side「新建侧边聊天」选项的语义——既有实例
-		* 在弹层里另有聚焦项，「新建」必须真的新建，否则标签与行为不符）。
-		* @returns false = 未能创建（调用方保持自己的流程）。
-		*/
-		function createSideChat(ctx, sessionId, draftText) {
-			try {
-				const snapshot = ctx.betterSidebar.getSnapshot();
-				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return false;
-				const before = new Set(collectTabs(snapshot.state).map((tab) => tab.id));
-				ctx.betterSidebar.openTab({ type: SIDE_TAB_TYPE }, { sessionId });
-				const created = collectSideTabs(ctx.betterSidebar.getSnapshot().state).find((tab) => !before.has(tab.id));
-				if (created === void 0) return false;
-				if (draftText !== void 0 && draftText !== "") ctx.betterSidebar.updateTab(created.id, { meta: { pendingDraft: draftText } });
-				return true;
-			} catch (error) {
-				console.warn("[dsh-sidenote] 新建侧边聊天失败:", error);
-				return false;
-			}
-		}
-		/**
-		* 桥接/命令的目标预览：askInSideChat 此时若执行会落在哪个 Tab 的标题
-		* （既有并存 = 最后一个；无 = 即将新建的首个标题）。用于编辑器上标明
-		* 「发送至：侧边 N」。会话不在屏上/状态缺失时返回 undefined。
-		*/
-		function sideChatTargetTitle(ctx, sessionId) {
-			try {
-				const snapshot = ctx.betterSidebar.getSnapshot();
-				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return void 0;
-				const existing = collectSideTabs(snapshot.state);
-				if (existing.length > 0) return existing[existing.length - 1].title;
-				return sideTabTitle([]);
-			} catch {
-				return;
-			}
-		}
-		/**
-		* 重开最近关闭的侧边聊天（D3 后悔药）：开 Tab + meta 预置 childId/
-		* parentSessionId——面板挂载后走绑定恢复路径（不重新 fork）。
-		* 会话本体必须仍 archived 在列（若被清理，面板落「会话已不存在」态——
-		* 有现成错误态兜着）。
-		*/
-		function reopenSideChat(ctx, sessionId, childId, title) {
-			try {
-				const snapshot = ctx.betterSidebar.getSnapshot();
-				if (snapshot.sessionId !== sessionId || snapshot.state === void 0) return false;
-				const before = new Set(collectTabs(snapshot.state).map((tab) => tab.id));
-				ctx.betterSidebar.openTab({ type: SIDE_TAB_TYPE }, { sessionId });
-				const created = collectSideTabs(ctx.betterSidebar.getSnapshot().state).find((tab) => !before.has(tab.id));
-				if (created === void 0) return false;
-				ctx.betterSidebar.updateTab(created.id, {
-					...title !== void 0 ? { title } : {},
-					meta: {
-						childId,
-						parentSessionId: sessionId
-					}
+					});
+				case "error": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: sidechat_module_css_default.errorRow,
+					children: message.text
+				});
+				case "notice": return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					className: sidechat_module_css_default.noticeRow,
+					children: message.text
 				});
-				return true;
-			} catch (error) {
-				console.warn("[dsh-sidenote] 重开侧边聊天失败:", error);
-				return false;
 			}
+		}, rowPropsEqual);
+		/** memo 比较器：transcriptOf 每次快照重建消息对象（引用必变），按字段值比。 */
+		function rowPropsEqual(prev, next) {
+			if (prev.fold !== next.fold || prev.reflow !== next.reflow) return false;
+			if (prev.parentSessionId !== next.parentSessionId || prev.sideTitle !== next.sideTitle) return false;
+			if (prev.question !== next.question) return false;
+			const a = prev.message;
+			const b = next.message;
+			return a === b || a.key === b.key && a.role === b.role && a.text === b.text && a.reasoning === b.reasoning && a.streaming === b.streaming && a.isError === b.isError && a.interrupted === b.interrupted && a.toolName === b.toolName && a.card === b.card && a.seq === b.seq;
 		}
 		//#endregion
-		//#region src/client/sidechat/lifecycle.ts
-		/**
-		* 首开编排：fork（全量历史快照）→ 登记 meta（先行，绝不丢登记）→
-		* 归档隐藏出会话列表（best-effort）→ 模型跟随主会话（best-effort）。
-		* fork 失败抛错（面板组件转错误态）；后两步失败只告警不阻断。
-		* @returns fork 出的子会话 id。
-		*/
-		async function forkAndRegister(ctx, parentSessionId, tabId) {
-			let boundarySeq;
-			try {
-				const snap = chatSourceOf(ctx, ctx.sessions.binding(parentSessionId))?.getLegacy();
-				let max = -1;
-				for (const node of snap?.nodes ?? []) {
-					const seq = node.seq;
-					if (typeof seq === "number" && seq > max) max = seq;
-				}
-				if (max >= 0) boundarySeq = max;
-			} catch {}
-			const forked = await ctx.sessions.fork({ sessionId: parentSessionId });
-			updateTabMeta(ctx, tabId, (current) => ({
-				...current,
-				childId: forked,
-				parentSessionId,
-				...boundarySeq !== void 0 ? { boundarySeq } : {}
-			}));
-			try {
-				await ctx.workspaces.archiveSession(forked);
-			} catch (error) {
-				console.warn("[dsh-sidenote] 归档侧边会话失败（会话列表可能短暂可见）:", error);
-			}
-			try {
-				const parentModels = await ctx.connection.api.sessions.models({ sessionId: parentSessionId });
-				if (parentModels.result.ok) {
-					const current = parentModels.result.value.current;
-					await ctx.connection.api.sessions.selectModel({
-						sessionId: forked,
-						provider: current.provider,
-						model: current.model,
-						...current.reasoningEffort !== void 0 ? { reasoningEffort: current.reasoningEffort } : {}
-					});
-				}
-			} catch (error) {
-				console.warn("[dsh-sidenote] 同步主会话模型失败（子会话用默认模型）:", error);
-			}
-			return forked;
-		}
-		/** Tab meta 读-改-写（布局持久化寄存处）；tab 已消失时 no-op。 */
-		function updateTabMeta(ctx, tabId, mutate) {
-			const current = parseSideChatMeta(readTab(ctx, tabId)?.meta);
-			ctx.betterSidebar.updateTab(tabId, { meta: mutate(current) });
-		}
-		/**
-		* 程序化入口（/side、bridge 划选提问）打开 Tab 时面板可能处于折叠态——
-		* 类型型 openTab 不自动展开（better-sidebar 只对 path/url 内容型打开展开）。
-		* 幂等展开（off-face：store.update 是 SidebarStore 公开 mutator 面；
-		* feature-check + 吞错，兜底失败不影响功能）。
-		*/
-		function ensurePanelOpen(store) {
-			const mutable = store;
-			try {
-				mutable?.update?.((state) => {
-					if (state.panelOpen === false) state.panelOpen = true;
-				});
-			} catch {}
-		}
-		/**
-		* 打开非 staged 会话的事件窗口（off-face：open() 在 concrete Session 上是
-		* public 且幂等，但不在 SessionFace 契约上——契约面只有 staged 会话会被
-		* 运行时自动 open）。feature-check + 吞错，运行时若移除则降级为只发不收。
-		*/
-		function openSessionWindow(session) {
-			const openable = session;
-			if (typeof openable?.open !== "function") return;
-			openable.open().catch((error) => {
-				console.warn("[dsh-sidenote] 会话窗口打开失败:", error);
-			});
-		}
-		/** 读子会话当前模型名（composer 模型标签用）；任何失败回退 null（默认文案）。 */
-		async function readModelName(ctx, sessionId) {
+		//#region src/client/sidechat/recentClosed.ts
+		const KEY_PREFIX = "dsh-sidenote:closed-side:v1:";
+		const CAP = 5;
+		function readAll(storageKey) {
 			try {
-				const res = await ctx.connection.api.sessions.models({ sessionId });
-				return res.result.ok ? res.result.value.current.model : null;
+				const raw = localStorage.getItem(storageKey);
+				if (raw === null) return [];
+				const parsed = JSON.parse(raw);
+				if (!Array.isArray(parsed)) return [];
+				return parsed.filter((e) => typeof e === "object" && e !== null && typeof e.childId === "string" && typeof e.parentSessionId === "string" && typeof e.title === "string");
 			} catch {
-				return null;
+				return [];
 			}
 		}
-		/**
-		* 0.1.2 优先：`uiConversation` 服务 → binding(会话 binding) → target('chat')
-		* → 快照 .legacy 切片（0.1.2 把内容面从 Session 快照顶层拆到此处——
-		* 根因与证据见 reports/ux-review/W00-fork-replay-012.md）；0.1.1 回退
-		* Session 快照顶层（nodes 直接在）。均 miss 返回 undefined（面板维持
-		* 既有降级，不崩）。
-		*/
-		function chatSourceOf(ctx, binding) {
-			const session = binding?.session;
-			if (session === void 0) return void 0;
+		function recordClosedSideChat(parentSessionId, entry) {
 			try {
-				const target = ctx.get("uiConversation")?.binding?.(binding)?.target?.("chat");
-				if (target !== void 0 && typeof target.getSnapshot === "function" && typeof target.subscribe === "function") return {
-					subscribe: (fn) => target.subscribe(fn),
-					getLegacy: () => {
-						return target.getSnapshot()?.legacy ?? null;
-					}
-				};
+				const key = KEY_PREFIX + parentSessionId;
+				const list = [entry, ...readAll(key).filter((e) => e.childId !== entry.childId)].slice(0, CAP);
+				localStorage.setItem(key, JSON.stringify(list));
 			} catch {}
-			const snap = session.getSnapshot();
-			if (snap !== null && Array.isArray(snap.nodes)) return {
-				subscribe: (fn) => session.subscribe(fn),
-				getLegacy: () => session.getSnapshot()
-			};
 		}
-		/** 拉会话模型目录（models RPC 容错；失败 null → 菜单保持只读标签态）。 */
-		async function listModels(ctx, sessionId) {
-			try {
-				const res = await ctx.connection.api.sessions.models({ sessionId });
-				return res.result.ok ? res.result.value : null;
-			} catch {
-				return null;
-			}
+		/** 读某主会话的最近关闭列表（新者在前）。 */
+		function listClosedSideChats(parentSessionId) {
+			if (typeof localStorage === "undefined") return [];
+			return readAll(KEY_PREFIX + parentSessionId);
 		}
-		/** 切换子会话模型；成功返回新模型展示名，失败 null（best-effort）。 */
-		async function switchModel(ctx, sessionId, provider, model) {
+		/** 重开消费：从列表移除（重开后若再关会重新入列）。 */
+		function dropClosedSideChat(parentSessionId, childId) {
 			try {
-				return (await ctx.connection.api.sessions.selectModel({
-					sessionId,
-					provider,
-					model
-				})).result.ok ? model : null;
-			} catch {
-				return null;
-			}
+				const key = KEY_PREFIX + parentSessionId;
+				const list = readAll(key).filter((e) => e.childId !== childId);
+				if (list.length === 0) localStorage.removeItem(key);
+				else localStorage.setItem(key, JSON.stringify(list));
+			} catch {}
 		}
 		//#endregion
 		//#region src/client/sidechat/ModelMenu.tsx
 		/**
 		* 模型选择器（WI-02）：composer 脚部的模型 chip → 两级 Menu（provider 分组
-		* 标签 + 型号行）。数据走 wire 面（sessions.models/selectModel——fork 时
-		* 同步主会话的同款通道）；切的是子会话自己的选择，不回写主会话。
+		* 标签 + 型号行）。数据面走 lifecycle.ts 的双版本链（0.1.5 的
+		* remote.session.modelCatalog/selectModel 优先，<= 0.1.2 的
+		* connection.api.sessions 回退）；切的是子会话自己的选择，不回写主会话。
 		*
-		* 懒加载：首次打开才拉目录（models RPC 有成本）；切换后本地标签立即更新
-		* （selectModel 返回的 selected 为准）。
+		* 懒加载：首次打开才拉目录（catalog RPC 有成本）；切换后本地标签立即更新。
 		*/
 		function ModelMenu(props) {
 			useLocaleTick();
@@ -3437,6 +3707,47 @@ window.__ModuleLoader__.load({
 				ctx,
 				tab.id
 			]);
+			const composerRef = (0, react.useRef)(composer);
+			composerRef.current = composer;
+			const metaRef = (0, react.useRef)(tab.meta);
+			metaRef.current = tab.meta;
+			const phaseRef = (0, react.useRef)(phase);
+			phaseRef.current = phase;
+			const titleRef = (0, react.useRef)(tab.title);
+			titleRef.current = tab.title;
+			(0, react.useEffect)(() => {
+				const metaNow = parseSideChatMeta(metaRef.current);
+				if (nativeSidebarHost(ctx) && metaNow.childId !== void 0) dropClosedSideChat(scope.sessionId, metaNow.childId);
+				const dispose = registerLiveSideChat(scope.sessionId, tab.id, (text) => {
+					if (phaseRef.current !== "chat") {
+						updateTabMeta(ctx, tab.id, (m) => ({
+							...m,
+							pendingDraft: appendDraftText(m.pendingDraft ?? "", text)
+						}));
+						return;
+					}
+					composerRef.current.appendDraft(text);
+					requestAnimationFrame(() => {
+						rootRef.current?.querySelector("textarea")?.focus();
+					});
+				}, () => metaRef.current);
+				return () => {
+					dispose();
+					if (nativeSidebarHost(ctx)) {
+						const m = parseSideChatMeta(metaRef.current);
+						if (m.childId !== void 0 && m.parentSessionId !== void 0) recordClosedSideChat(m.parentSessionId, {
+							childId: m.childId,
+							parentSessionId: m.parentSessionId,
+							title: titleRef.current,
+							closedAt: Date.now()
+						});
+					}
+				};
+			}, [
+				scope.sessionId,
+				tab.id,
+				ctx
+			]);
 			const promote = (0, react.useCallback)(() => {
 				if (childId === void 0) return;
 				(async () => {
@@ -3607,42 +3918,6 @@ window.__ModuleLoader__.load({
 			});
 		}
 		//#endregion
-		//#region src/client/sidechat/recentClosed.ts
-		const KEY_PREFIX = "dsh-sidenote:closed-side:v1:";
-		const CAP = 5;
-		function readAll(storageKey) {
-			try {
-				const raw = localStorage.getItem(storageKey);
-				if (raw === null) return [];
-				const parsed = JSON.parse(raw);
-				if (!Array.isArray(parsed)) return [];
-				return parsed.filter((e) => typeof e === "object" && e !== null && typeof e.childId === "string" && typeof e.parentSessionId === "string" && typeof e.title === "string");
-			} catch {
-				return [];
-			}
-		}
-		function recordClosedSideChat(parentSessionId, entry) {
-			try {
-				const key = KEY_PREFIX + parentSessionId;
-				const list = [entry, ...readAll(key).filter((e) => e.childId !== entry.childId)].slice(0, CAP);
-				localStorage.setItem(key, JSON.stringify(list));
-			} catch {}
-		}
-		/** 读某主会话的最近关闭列表（新者在前）。 */
-		function listClosedSideChats(parentSessionId) {
-			if (typeof localStorage === "undefined") return [];
-			return readAll(KEY_PREFIX + parentSessionId);
-		}
-		/** 重开消费：从列表移除（重开后若再关会重新入列）。 */
-		function dropClosedSideChat(parentSessionId, childId) {
-			try {
-				const key = KEY_PREFIX + parentSessionId;
-				const list = readAll(key).filter((e) => e.childId !== childId);
-				if (list.length === 0) localStorage.removeItem(key);
-				else localStorage.setItem(key, JSON.stringify(list));
-			} catch {}
-		}
-		//#endregion
 		//#region src/client/sidechat/header.tsx
 		/**
 		* 顶栏「侧边」入口（Delivery_02 Workitem_02 发现性）：注册进宿主的
@@ -3684,11 +3959,16 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/sidechat/slash.ts
+		/** 0.1.5 信号：`connection.api.sessions` 面在 0.1.5 被删（与模型面迁移同判据）。 */
+		function isDsh015Plus(ctx) {
+			const legacy = ctx.connection?.api?.sessions;
+			return legacy === void 0 || legacy === null;
+		}
 		/** 单个命令名对应的完整贡献（side / 侧边 共用）。 */
 		function makeContribution(ctx, name) {
 			return {
 				name,
-				description: t("cmdDesc"),
+				description: isDsh015Plus(ctx) ? () => t("cmdDesc") : t("cmdDesc"),
 				available: (session) => canForkFrom(ctx, session.sessionId),
 				ui: {
 					kind: "popupSelect",
@@ -4389,43 +4669,43 @@ window.__ModuleLoader__.load({
 			document.head.appendChild(tag);
 		}
 		var annotate_module_css_default = {
-			"toolbarButton": "_SVViG_toolbarButton",
-			"editorSpacer": "_SVViG_editorSpacer",
-			"sentCardTitle": "_SVViG_sentCardTitle",
-			"chipRemove": "_SVViG_chipRemove",
-			"toolbarBelow": "_SVViG_toolbarBelow",
-			"editorTextarea": "_SVViG_editorTextarea",
-			"chipWrap": "_SVViG_chipWrap",
-			"chipClearAll": "_SVViG_chipClearAll",
 			"editorNew": "_SVViG_editorNew",
-			"badge": "_SVViG_badge",
-			"editorAskRow": "_SVViG_editorAskRow",
 			"chipText": "_SVViG_chipText",
-			"badgeSent": "_SVViG_badgeSent",
-			"editorError": "_SVViG_editorError",
-			"cancelButton": "_SVViG_cancelButton",
-			"deleteButton": "_SVViG_deleteButton",
-			"chipPanel": "_SVViG_chipPanel",
-			"chipNote": "_SVViG_chipNote",
+			"toolbarBelow": "_SVViG_toolbarBelow",
+			"sentCardTitle": "_SVViG_sentCardTitle",
+			"chipClearAll": "_SVViG_chipClearAll",
+			"chip": "_SVViG_chip",
 			"highlight": "_SVViG_highlight",
+			"chipNote": "_SVViG_chipNote",
+			"chipRemove": "_SVViG_chipRemove",
+			"editorEdit": "_SVViG_editorEdit",
+			"sentCardNote": "_SVViG_sentCardNote",
+			"editorFooter": "_SVViG_editorFooter",
+			"toolbar": "_SVViG_toolbar",
 			"dshSidenoteHintIn": "_SVViG_dshSidenoteHintIn",
-			"sentChipRow": "_SVViG_sentChipRow",
-			"hintClose": "_SVViG_hintClose",
-			"chipNumber": "_SVViG_chipNumber",
-			"saveButton": "_SVViG_saveButton",
-			"chip": "_SVViG_chip",
-			"chipRow": "_SVViG_chipRow",
-			"sentChip": "_SVViG_sentChip",
 			"sentCardQuote": "_SVViG_sentCardQuote",
-			"hint": "_SVViG_hint",
 			"editorInput": "_SVViG_editorInput",
-			"toolbar": "_SVViG_toolbar",
+			"deleteButton": "_SVViG_deleteButton",
+			"badge": "_SVViG_badge",
 			"confirmButton": "_SVViG_confirmButton",
-			"editorEdit": "_SVViG_editorEdit",
-			"editorAsk": "_SVViG_editorAsk",
+			"saveButton": "_SVViG_saveButton",
+			"badgeSent": "_SVViG_badgeSent",
+			"sentChip": "_SVViG_sentChip",
+			"chipNumber": "_SVViG_chipNumber",
+			"hint": "_SVViG_hint",
+			"hintClose": "_SVViG_hintClose",
 			"editorTarget": "_SVViG_editorTarget",
-			"sentCardNote": "_SVViG_sentCardNote",
-			"editorFooter": "_SVViG_editorFooter"
+			"chipWrap": "_SVViG_chipWrap",
+			"cancelButton": "_SVViG_cancelButton",
+			"editorError": "_SVViG_editorError",
+			"editorAskRow": "_SVViG_editorAskRow",
+			"sentChipRow": "_SVViG_sentChipRow",
+			"editorTextarea": "_SVViG_editorTextarea",
+			"editorAsk": "_SVViG_editorAsk",
+			"chipRow": "_SVViG_chipRow",
+			"chipPanel": "_SVViG_chipPanel",
+			"toolbarButton": "_SVViG_toolbarButton",
+			"editorSpacer": "_SVViG_editorSpacer"
 		};
 		//#endregion
 		//#region src/client/annotate/hint.tsx
@@ -5537,6 +5817,7 @@ window.__ModuleLoader__.load({
 			"locale"
 		];
 		function apply(ctx) {
+			setRootContext(ctx);
 			attachLocale(ctx.locale);
 			probeHost(ctx);
 			const reflow = createReflowStore();