@deepseek-ai/dsh-client-ui-plan 0.1.6-alpha.1 → 0.1.7-alpha.1

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-plan/README.md
-README.md: 4ff275834ec069315580c205b8fd0bf0dee9cfeb
-README.zh.md: 588698b273bc52b1e601c7010516c24a9248e543
+README.md: e9e38251ff69ed601e486b4c1ce351b236e7bcb7
+README.zh.md: 91fe232d27007fea8264e98c895ca2788585710c

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-This package renders the plan-mode status chip in the Web GUI: when the host-computed projection's effective target is plan mode, the composer shows a warn-colored "Plan ×" button that turns plan mode off; otherwise the seat stays empty. Plan mode itself — the `/plan` command, the committed `plan/mode` state, the projection unit, and the policy section — belongs to `dsh-plan-mode`; this package only renders the projection and sends what a user could equally type. The model exits plan mode through the stable `exit_plan_mode` tool; its plan review uses the composed Web question channel.
+Plan mode lets you review a plan before implementation. Enter with `/plan` and leave with the composer chip. Submitted plans open automatically in the right sidebar for review and remain available from cards in the completed Turn’s final artifact area after approval, rejection, or dismissal. Reopening a plan focuses its existing tab, and browser reload restores the document from Session history.
 
 ## Table of Contents
 
@@ -29,7 +29,13 @@ Mount this plugin alongside `ui-conversation` and `dsh-plan-mode`; the chip then
 
 ### What the chip shows
 
-While the effective target is plan mode, the seat renders the warn-colored "Plan ×" status button, which executes `/plan off`. Otherwise the seat stays empty: a host without plan mode, or a Draft with no session, shows nothing. While plan mode is the effective target, the composer textarea's placeholder switches to the plan-task hint — "describe your task to generate plan" — unless the owning surface supplies its own placeholder.
+While the effective target is plan mode, the seat renders the blue "Plan" status button — the plan glyph ahead of the label, swapped for a circled cross while the enabled button is hovered or keyboard-focused — which executes `/plan off`. Otherwise the seat stays empty: a host without plan mode, or a Draft with no session, shows nothing. While plan mode is the effective target, the composer textarea's placeholder switches to the plan-task hint — "describe your task to generate plan" — unless the owning surface supplies its own placeholder.
+
+### Reading submitted plans
+
+When a Turn ends, each submitted plan appears in its final artifact area, using the file-delivery card treatment with a Markdown icon, title, and Open action. A pending plan opens automatically once per submission in the current browser session. Closing it stays effective across review remounts; a new submission opens its own plan. Historical cards open only when clicked. Use the card or review strip’s View full plan link to read the complete Markdown. Plan tabs show a plain text file icon. Different submissions retain separate tabs; the review buttons alone decide whether implementation may begin.
+
+A review without a logged invocation also opens automatically. Its complete text lives only in the tab’s navigation memory, and the pending review card can reopen it. Reloading the page loses that text; an expired preview directs the user back to a pending review. Plans opened from an embedded child conversation use the visible sidebar while retaining the child’s address for document reads.
 
 ### Failures
 
@@ -43,7 +49,11 @@ Admission failures (`matched: false`, business errors, transport faults) surface
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-The chip occupies the conversation-declared `conversation.input.plan` single seat; the node half is an empty apply (the roster row). Reads ride the generic projection pair through the standard-kit `useProjection`: the effective target is `pending ? !active : active` — a folded host value, not client optimism, so an arriving frame corrects the chip either way. The seat's injected face carries one verb, `exitPlanMode`, which executes `/plan off` through `ctx.remote.commands.execute` and maps admission failures to an inline error line. The placeholder and hint text live in ui-conversation's `conversation` locale namespace and are shared verbatim with the claimed `/plan` command hint. The accessible description is "Plan mode on, press to turn off".
+The chip occupies the conversation-declared `conversation.input.plan` single seat; the node half is an empty apply (the roster row). Reads ride the generic projection pair through the standard-kit `useProjection`: the effective target is `pending ? !active : active` — a folded host value, not client optimism, so an arriving frame corrects the chip either way. The seat's injected face carries one verb, `exitPlanMode`, which executes `/plan off` through `ctx.remote.commands.execute` and maps admission failures to an inline error line. The placeholder and hint text live in ui-conversation's `conversation` locale namespace and are shared verbatim with the claimed `/plan` command hint.
+
+Plan cards derive from native `tool/call` or PTC dispatch arguments through a Conversation Definition, with each invocation’s resolved Turn location. They contribute to the additive `conversation.chat.turnTail` list alongside file deliveries. The plan resource address identifies the invocation and its complete ordinary or direct-parent subagent Session address; its provider reads existing Session history, including older pages, without storing document text in sidebar layout. The question plugin owns the review action slot and supplies its request key, complete text, and optional invocation identity. The automatic open reads `ctx.sidebarRight.mounted` through a bound hook and runs once a seat is on screen: a review arriving while a global panel is active mounts ahead of the returning seat in the same commit, before that seat binds. The [decision](../../../.agents/notes/implemented/feature/2026-09-17-persistent-plan-cards.md) explains why review lifetime and document lifetime remain separate. Subagent plan addresses also preserve unknown mode so history reads can resolve the child descriptor.
+
+The framework-bound `usePlans(turn)` exposes only submitted-plan data for that Turn. Chat indexes membership on Node updates and orders this collection when read; card rendering neither scans the transcript nor subscribes to other Turns or Node kinds.
 
 </details>
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-本包在 Web GUI 中渲染 plan 模式状态徽章：当宿主计算的投影有效目标为 plan 模式时，composer 显示一个 warn 色「Plan ×」按钮，可关闭 plan 模式；否则该座位保持为空。plan 模式本身——`/plan` 命令、已提交的 `plan/mode` 状态、投影单元与 policy 段——归 `dsh-plan-mode` 所有；本包只渲染投影并发送用户同样可以手敲的内容。模型经稳定的 `exit_plan_mode` 工具退出 plan 模式；其 plan 评审走已组合的 Web question 通道。
+计划模式让你在实施前审阅计划。通过 `/plan` 进入，通过编辑器中的状态按钮退出。提交的计划自动在右侧边栏打开供审阅；批准、拒绝或关闭审批后，仍可通过已完成回合末尾的产物卡片查看。重新打开同一计划会聚焦已有标签页，刷新浏览器后会从会话历史恢复正文。
 
 ## 目录
 
@@ -25,11 +25,17 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
-与 `ui-conversation` 及 `dsh-plan-mode` 一起挂载本插件；plan 模式激活时，徽章随即占据 composer 的 plan 座位（访问模式控件右侧）。经 `/plan` 命令路径进入 plan 模式——从 composer 的 `+` Command 菜单选择 Plan，或键入 `/plan`——再用徽章将其关闭。
+与 `ui-conversation` 及 `dsh-plan-mode` 一起挂载本插件；plan 模式激活时，徽章随即占据 composer 的 plan 座位（访问模式控件右侧）。经 `/plan` 命令路径进入 plan 模式——从 composer 的 `+` Command 菜单选择「计划」，或键入 `/plan`——再用徽章将其关闭。
 
 ### 徽章显示什么
 
-当有效目标为 plan 模式时，该座位渲染 warn 色「Plan ×」状态按钮，执行 `/plan off`。否则座位保持为空：未组合 plan-mode 的宿主，或尚无会话的 Draft，都不显示任何内容。plan 模式为有效目标期间，composer 文本框的 placeholder 切换为 plan 任务提示——「describe your task to generate plan」——除非所属 surface 提供自己的 placeholder。
+当有效目标为 plan 模式时，该座位渲染蓝色「计划」状态按钮——标签前是计划图标，按钮可用且被悬停或键盘聚焦时换成圆形 ×——点击执行 `/plan off`。否则座位保持为空：未组合 plan-mode 的宿主，或尚无会话的 Draft，都不显示任何内容。plan 模式为有效目标期间，composer 文本框的 placeholder 切换为 plan 任务提示——「describe your task to generate plan」——除非所属 surface 提供自己的 placeholder。
+
+### 查看已提交的计划
+
+回合结束后，每次提交的计划都会显示在该回合末尾的产物区域，并采用文件产物卡片的样式，包含 Markdown 图标、标题和“打开”操作。在当前浏览器会话中，每份待审计划自动打开一次；关闭后，重新挂载审批组件不会再次展开，新提交会打开其对应计划。历史卡片仅在点击后打开。通过卡片或审批条带上的“查看全文”链接可阅读完整 Markdown。计划标签页显示纯文本文件图标。不同提交保留独立标签页；是否开始实施仍由审批按钮决定。
+
+没有已记录调用标识的审批也会自动打开。完整正文只保存在标签页的导航内存中，待处理审批卡片可以重新打开它。刷新页面会丢失该正文；失效的预览会提示用户返回待处理审批。在嵌入式子对话中打开计划时，预览使用当前可见的侧栏，读取文档仍保留子会话地址。
 
 ### 失败
 
@@ -43,7 +49,11 @@ kind: "package-reference"
 <details>
 <summary>实现细节——点击展开</summary>
 
-徽章占据 conversation 声明的 `conversation.input.plan` 单实例座位；node 半部是空 apply（roster 行）。读取经 standard-kit 的 `useProjection` 走通用投影对：有效目标是 `pending ? !active : active`——折叠的宿主值而非客户端乐观态，因此到达的帧无论哪个方向都会纠正徽章。座位注入面携带一个动词 `exitPlanMode`，经 `ctx.remote.commands.execute` 执行 `/plan off`，并把准入失败映射为一行内联错误。placeholder 与提示文案位于 ui-conversation 的 `conversation` locale 命名空间，与已认领 `/plan` 命令的提示逐字共用。无障碍描述是「Plan mode on, press to turn off」。
+徽章占据 conversation 声明的 `conversation.input.plan` 单实例座位；node 半部是空 apply（roster 行）。读取经 standard-kit 的 `useProjection` 走通用投影对：有效目标是 `pending ? !active : active`——折叠的宿主值而非客户端乐观态，因此到达的帧无论哪个方向都会纠正徽章。座位注入面携带一个动词 `exitPlanMode`，经 `ctx.remote.commands.execute` 执行 `/plan off`，并把准入失败映射为一行内联错误。placeholder 与提示文案位于 ui-conversation 的 `conversation` locale 命名空间，与已认领 `/plan` 命令的提示逐字共用。
+
+计划卡片通过 Conversation Definition 从原生 `tool/call` 或 PTC dispatch 参数派生，并使用每次调用已解析的回合位置。它们与文件产物一起贡献到可追加的 `conversation.chat.turnTail` 列表。计划资源地址标识调用及完整的普通会话地址或子会话直接父级地址；provider 读取已有会话历史及较早分页，不把正文存入侧边栏布局。提问插件拥有审批操作插槽，并提供请求键、完整正文和可选的调用标识。自动打开通过绑定的 hook 读取 `ctx.sidebarRight.mounted`，在座位出现在屏幕上后才执行：全局面板打开期间到达的审批，会在返回时与座位在同一次提交里先挂载、早于座位完成绑定。[决策记录](../../../.agents/notes/implemented/feature/2026-09-17-persistent-plan-cards.zh.md)说明审批与文档为何保持独立生命周期。 子代理计划地址也保留未知模式，以便历史读取解析子 descriptor。
+
+框架绑定的 `usePlans(turn)` 只提供该回合的已提交计划数据。Chat 随节点更新维护成员索引，并在读取时排列该集合；卡片渲染不扫描整段对话，也不订阅其他回合或节点类型。
 
 </details>
 

package/lib/client.js

@@ -4,11 +4,474 @@ 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_jsx_runtime = require("react/jsx-runtime");
 		let react = require("react");
-		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		require("@deepseek-ai/cordis");
+		let _deepseek_ai_dsh_client_store = require("@deepseek-ai/dsh-client-store");
+		//#region ../../util/crypto/src/index.ts
+		/**
+		* Random v4 UUID, minted from `crypto.getRandomValues`.
+		* @returns the UUID string.
+		*/
+		function randomUUID() {
+			const bytes = globalThis.crypto.getRandomValues(new Uint8Array(16));
+			const hex = Array.from(bytes, (byte, index) => {
+				return (index === 6 ? byte & 15 | 64 : index === 8 ? byte & 63 | 128 : byte).toString(16).padStart(2, "0");
+			}).join("");
+			return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+		}
+		//#endregion
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-plan/src/client/PlanPreview.module.css.mjs
+		const css$1 = ".k74WwW_cards{flex-direction:column;gap:10px;display:flex}.k74WwW_card{--plan-card-fill:var(--dsw-static-neutral-50);--plan-card-hover:var(--dsw-static-neutral-100);box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l1);background:var(--plan-card-fill);width:100%;min-width:0;height:60px;color:var(--dsw-alias-label-primary);font:inherit;text-align:left;cursor:pointer;border-radius:18px;align-items:center;gap:10px;margin:0;padding:8px 10px;transition:background-color .12s;display:flex}body[data-ds-dark-theme] .k74WwW_card{--plan-card-fill:var(--dsw-static-neutral-850);--plan-card-hover:var(--dsw-static-neutral-800)}.k74WwW_card:hover{background:var(--plan-card-hover)}.k74WwW_card:focus-visible{outline:2px solid var(--dsw-alias-label-primary);outline-offset:3px}.k74WwW_cardIcon{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l1);background:var(--plan-card-fill);border-radius:10px;flex:none;place-items:center;width:40px;height:40px;display:grid}.k74WwW_cardDetails{flex-direction:column;flex:1;gap:2px;min-width:0;display:flex}.k74WwW_cardTitle{text-overflow:ellipsis;white-space:nowrap;font-size:13px;font-weight:500;line-height:20px;overflow:hidden}.k74WwW_cardDescription{text-overflow:ellipsis;white-space:nowrap;color:var(--dsw-alias-label-tertiary);font-size:10px;line-height:16px;overflow:hidden}.k74WwW_cardOpen{box-sizing:border-box;border:.5px solid var(--dsw-alias-border-l3);background:var(--dsw-alias-button-floating-fill);border-radius:10px;flex:none;align-items:center;height:28px;padding:4px 8px;font-size:12px;line-height:18px;display:inline-flex}.k74WwW_reviewLink{color:var(--dsw-alias-label-secondary);font:inherit;cursor:pointer;background:0 0;border:0;align-items:center;gap:4px;padding:0;display:inline-flex}.k74WwW_reviewLink:hover{color:var(--dsw-alias-label-primary)}.k74WwW_reviewLink:focus-visible{outline:2px solid var(--dsw-alias-label-primary);outline-offset:3px}.k74WwW_preview{box-sizing:border-box;height:100%;padding:20px 24px 40px;position:relative;overflow:auto}.k74WwW_document{color:var(--dsw-alias-label-primary);overflow-wrap:anywhere;font-size:14px;line-height:1.75}.k74WwW_message{color:var(--dsw-alias-label-secondary);padding:24px;font-size:14px}.k74WwW_titleIcon{flex:none}@media (width<=767px){.k74WwW_preview{padding:16px 18px 32px}}";
+		const tagId$1 = "@deepseek-ai/dsh-client-ui-plan/PlanPreview.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$1) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-plan";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var PlanPreview_module_css_default = {
+			"card": "k74WwW_card",
+			"cardDescription": "k74WwW_cardDescription",
+			"cardDetails": "k74WwW_cardDetails",
+			"cardIcon": "k74WwW_cardIcon",
+			"cardOpen": "k74WwW_cardOpen",
+			"cardTitle": "k74WwW_cardTitle",
+			"cards": "k74WwW_cards",
+			"document": "k74WwW_document",
+			"message": "k74WwW_message",
+			"preview": "k74WwW_preview",
+			"reviewLink": "k74WwW_reviewLink",
+			"titleIcon": "k74WwW_titleIcon"
+		};
+		//#endregion
+		//#region lib/types/client/PlanCard.js
+		/** Persistent transcript cards and pending-review sidebar navigation. */
+		/**
+		* Render the completed Turn's submitted plans in invocation order.
+		* @param props - Logged plan, localized copy, and Session-bound navigation.
+		* @returns keyboard-accessible plan cards, or null for a Turn without plans.
+		*/
+		function PlanCards({ turn, usePlans, openPlan, t }) {
+			const plans = usePlans(String(turn.turn));
+			if (plans === void 0 || plans.length === 0) return null;
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: PlanPreview_module_css_default.cards,
+				"data-plan-artifacts": true,
+				children: plans.map((plan) => (0, react_jsx_runtime.jsxs)("button", {
+					type: "button",
+					className: PlanPreview_module_css_default.card,
+					"data-plan-card": plan.callId,
+					"aria-label": t("preview.openNamed", { title: plan.title }),
+					onClick: () => {
+						openPlan(plan.callId);
+					},
+					children: [
+						(0, react_jsx_runtime.jsx)("span", {
+							className: PlanPreview_module_css_default.cardIcon,
+							children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.FileTypeIcon, {
+								kind: "markdown",
+								size: 20
+							})
+						}),
+						(0, react_jsx_runtime.jsxs)("span", {
+							className: PlanPreview_module_css_default.cardDetails,
+							children: [(0, react_jsx_runtime.jsx)("span", {
+								className: PlanPreview_module_css_default.cardTitle,
+								children: plan.title
+							}), (0, react_jsx_runtime.jsx)("span", {
+								className: PlanPreview_module_css_default.cardDescription,
+								children: t("preview.document")
+							})]
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: PlanPreview_module_css_default.cardOpen,
+							children: t("preview.action")
+						})
+					]
+				}, plan.callId))
+			});
+		}
+		/**
+		* Open each pending plan automatically and retain a manual opener without answering it.
+		*
+		* The automatic open waits for a mounted Sidebar seat: a review that arrives
+		* while the Conversation is off screen mounts in the same commit as the seat,
+		* ahead of it, and the seat binds from its own effect. Reading the bound
+		* session through the hook opens once that binding exists.
+		* @param props - Review identity, Session store, localized copy, and navigation.
+		* @returns an opener for either logged or temporary plan text.
+		*/
+		function PlanReviewOpen({ review, requestKey, openReview, useSidebarMounted, t, useStore, actions }) {
+			const identity = review.callId === void 0 ? `review:${requestKey}` : `call:${review.callId}`;
+			const opened = useStore((state) => state.opened[identity] === true);
+			const mounted = useSidebarMounted((session) => session !== void 0);
+			(0, react.useEffect)(() => {
+				if (opened || !mounted) return;
+				openReview(review, requestKey);
+				actions.markOpened(identity);
+			}, [
+				identity,
+				opened,
+				mounted,
+				openReview,
+				review,
+				requestKey,
+				actions
+			]);
+			return (0, react_jsx_runtime.jsxs)("button", {
+				type: "button",
+				className: PlanPreview_module_css_default.reviewLink,
+				title: t("preview.open"),
+				"aria-label": t("preview.open"),
+				onClick: () => {
+					openReview(review, requestKey);
+				},
+				children: [t("preview.full"), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutlineRegular, { size: 14 })]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/review-preview.js
+		/**
+		* Name one temporary review within its browser lifetime and Session.
+		* @param sessionId - Session displaying the review.
+		* @param requestKey - Browser-unique pending request identity.
+		* @returns the address used to focus or reopen its preview.
+		*/
+		function reviewPreviewAddress(sessionId, requestKey) {
+			return `dsh-resource://plan-review/${encodeURIComponent(sessionId)}/${encodeURIComponent(requestKey)}`;
+		}
+		/**
+		* Recognize temporary plan navigation without interpreting it as logged history.
+		* @param address - Saved or caller-supplied navigation address.
+		* @returns whether the address identifies a temporary review preview.
+		*/
+		function isReviewPreviewAddress(address) {
+			return /^dsh-resource:\/\/plan-review\/[^/?#]+\/[^/?#]+$/.test(address);
+		}
+		//#endregion
+		//#region lib/types/client/failure-line.js
+		/**
+		* Explain a failed plan read in the current locale.
+		* @param t - Plan namespace translator.
+		* @param failure - Failure reported by the resource provider.
+		* @returns localized plan copy, or the external failure's diagnostic.
+		*/
+		function planFailureLine(t, failure) {
+			switch (failure.code) {
+				case "plan/invalid-address": return t("preview.invalidAddress");
+				case "plan/unavailable": return t("preview.historyUnavailable");
+				case "plan/not-found": return t("preview.notFound");
+				default: return failure.message;
+			}
+		}
+		//#endregion
+		//#region lib/types/client/PlanPreview.js
+		/** Read-only Markdown viewer for logged plans and temporary review documents. */
+		/**
+		* Render the submitted plan with its complete Markdown.
+		* @param props - Framework-bound tab identity, resource, and copy.
+		* @returns the plan document or a localized loading/failure state.
+		*/
+		function PlanPreview({ useTabInfo, useResource, t }) {
+			const tab = useTabInfo();
+			const resource = useResource(tab.tab.navigation.address);
+			const temporary = isReviewPreviewAddress(tab.tab.navigation.address);
+			const params = tab.tab.navigation.params;
+			const plan = temporary ? params !== void 0 && "planReview" in params ? params.planReview : void 0 : resource.value;
+			const labels = (0, react.useMemo)(() => ({
+				code: {
+					copyLabel: t("copy"),
+					copiedLabel: t("copied")
+				},
+				footnotes: t("markdown.footnotes")
+			}), [t]);
+			if (plan === void 0) return (0, react_jsx_runtime.jsxs)("div", {
+				className: PlanPreview_module_css_default.message,
+				role: "status",
+				children: [temporary ? t("preview.expired") : resource.status === "none" ? t("preview.unavailable") : resource.status === "failed" ? t("preview.failed") : t("preview.loading"), !temporary && resource.failure !== void 0 && (0, react_jsx_runtime.jsx)("p", { children: planFailureLine(t, resource.failure) })]
+			});
+			return (0, react_jsx_runtime.jsx)("section", {
+				className: PlanPreview_module_css_default.preview,
+				"data-plan-preview": "callId" in plan ? plan.callId : tab.tab.navigation.address,
+				"aria-label": plan.title,
+				children: (0, react_jsx_runtime.jsx)("div", {
+					className: PlanPreview_module_css_default.document,
+					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.MarkdownText, {
+						text: plan.markdown,
+						labels
+					})
+				})
+			});
+		}
+		/**
+		* Display a plain file icon and the heading in its tab after resource recovery.
+		* @param props - Framework-bound tab identity and resource reader.
+		* @returns a decorative file icon followed by the recovered title or initial localized label.
+		*/
+		function PlanTitle({ useTabInfo, useResource }) {
+			const tab = useTabInfo();
+			const resource = useResource(tab.tab.navigation.address);
+			const params = tab.tab.navigation.params;
+			const plan = isReviewPreviewAddress(tab.tab.navigation.address) ? params !== void 0 && "planReview" in params ? params.planReview : void 0 : resource.value;
+			return (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.FileTypeIcon, {
+				kind: "other",
+				size: 16,
+				className: PlanPreview_module_css_default.titleIcon
+			}), plan?.title ?? tab.tab.title] });
+		}
+		//#endregion
+		//#region lib/types/client/plan.js
+		function record(value) {
+			return typeof value === "object" && value !== null && !Array.isArray(value);
+		}
+		/**
+		* Read a complete plan from untrusted logged arguments.
+		* @param event - Native call or PTC dispatch event from Session history.
+		* @returns the submitted plan, or undefined for unrelated or malformed data.
+		*/
+		function submittedPlan(event) {
+			if (event.type !== "tool/call" && event.type !== "tool/ptc-dispatch-start" && event.type !== "tool/ptc-dispatch") return void 0;
+			const data = event.data;
+			if (!record(data) || data.name !== "exit_plan_mode") return void 0;
+			const callId = event.type === "tool/call" ? data.callId : data.subCallId;
+			if (typeof callId !== "string" || callId === "") return void 0;
+			let args = data.arguments;
+			if (event.type === "tool/call") {
+				if (typeof args !== "string") return void 0;
+				try {
+					args = JSON.parse(args);
+				} catch (_error) {
+					return;
+				}
+			}
+			if (!record(args) || typeof args.plan !== "string") return void 0;
+			const markdown = args.plan;
+			const title = /^#\s+(\S[^\r\n]*)/.exec(markdown.trim())?.[1];
+			return title === void 0 ? void 0 : {
+				callId,
+				markdown,
+				title
+			};
+		}
+		/**
+		* Encode the durable identity of a plan without retaining its text in layout storage.
+		* @param target - Session and tool-call identity.
+		* @returns the plan resource address.
+		*/
+		function planAddress(target) {
+			const { session, callId } = target;
+			return `dsh-resource://plan/${(session.kind === "session" ? [session.sessionId, callId] : [
+				"subagent",
+				session.parentSessionId,
+				session.childSessionId,
+				session.mode,
+				callId
+			]).map(encodeURIComponent).join("/")}`;
+		}
+		/**
+		* Validate a saved or caller-supplied plan resource address.
+		* @param address - Address submitted to the sidebar or resource provider.
+		* @returns the decoded identity, or undefined for an unsupported address.
+		*/
+		function parsePlanAddress(address) {
+			const match = /^dsh-resource:\/\/plan\/([^?#]+)$/.exec(address);
+			if (match === null) return void 0;
+			try {
+				const parts = match[1].split("/").map(decodeURIComponent);
+				if (parts.some((part) => part === "")) return void 0;
+				if (parts.length === 2) return {
+					session: {
+						kind: "session",
+						sessionId: parts[0]
+					},
+					callId: parts[1]
+				};
+				if (parts.length === 5 && parts[0] === "subagent" && (parts[3] === "one-shot" || parts[3] === "continuable" || parts[3] === "unknown")) return {
+					session: {
+						kind: "subagent",
+						parentSessionId: parts[1],
+						childSessionId: parts[2],
+						mode: parts[3]
+					},
+					callId: parts[4]
+				};
+				return;
+			} catch (_error) {
+				return;
+			}
+		}
+		//#endregion
+		//#region lib/types/client/plan-definition.js
+		/** One card per invocation; a later PTC settlement retains the original card position. */
+		const planDefinition = {
+			kind: "submitted-plan",
+			target: "chat",
+			match: (event) => {
+				const plan = submittedPlan(event);
+				return plan === void 0 ? null : {
+					id: plan.callId,
+					role: event.type === "tool/ptc-dispatch" ? "update" : "start"
+				};
+			},
+			start: (_context, match) => submittedPlan(match.event),
+			update: (context) => context.state,
+			buildViewNode: (context) => {
+				const start = context.start ?? context.matches[0];
+				const data = context.state ?? (start === void 0 ? void 0 : submittedPlan(start.event));
+				if (data === void 0 || start === void 0) return null;
+				return {
+					key: context.key,
+					kind: "submitted-plan",
+					id: context.id,
+					target: "chat",
+					anchorSeq: start.event.seq,
+					location: start.location,
+					visibility: "hidden",
+					data
+				};
+			}
+		};
+		//#endregion
+		//#region ../../typert/protocol/src/remote-error.ts
+		/**
+		* One Remote call failure: a real Error carrying its stable code and typed
+		* details. Owners throw it at the failure point; the Host Gateway encodes it
+		* onto the wire unchanged; the Client face rebuilds an instance for the
+		* `RemoteResult` error branch, so `throw result.error` keeps throw semantics.
+		* Discrimination is always by `code`, never by instanceof.
+		*/
+		var RemoteError = class extends Error {
+			code;
+			details;
+			/** Structural marker: cross-realm/bundle identification never uses instanceof. */
+			isDSHRemoteError = true;
+			/**
+			* @param code - stable failure code declared in {@link RemoteErrorDetailsMap}.
+			* @param message - human diagnostic carried across the wire.
+			* @param details - structured payload typed by the code.
+			* @param options - standard Error options (`cause` survives in-process only).
+			*/
+			constructor(code, message, details, options) {
+				super(message, options);
+				this.code = code;
+				this.details = details;
+				this.name = "RemoteError";
+			}
+		};
+		/**
+		* Structurally identify a RemoteError thrown across module or realm copies of
+		* this class. Mechanism-internal: the Gateway and test assertions use it;
+		* business code receives typed failures and never needs it.
+		* @param value - a caught value.
+		* @returns the failure when the marker matches, otherwise undefined.
+		*/
+		function remoteErrorOf(value) {
+			if (typeof value === "object" && value !== null && value.isDSHRemoteError === true && typeof value.code === "string") return value;
+		}
+		//#endregion
+		//#region ../../typert/protocol/src/index.ts
+		/**
+		* Remote decorators and explicit Gateway bindings backed by versioned
+		* descriptors carried on decorated class prototypes. Strict reflection
+		* remains a Typert compiler responsibility.
+		* @module @deepseek-ai/dsh-typert-protocol
+		*/
+		//#endregion
+		//#region lib/types/client/plan-resource.js
+		/**
+		* Bind plan reads to the generated Session Remote face.
+		* Opening a follow reads projections and may activate a prepared Session on the Host.
+		* Generated Remote streams can throw carrier failures; the provider reports failed
+		* reads as resource failure frames and preserves Remote error codes.
+		* @param remote - Existing Session history API.
+		* @returns a provider whose reads stop after finding the exact invocation.
+		*/
+		function planResourceProvider(remote) {
+			return {
+				protocol: "plan",
+				async *open(address, { signal }) {
+					const aborted = () => signal.aborted;
+					if (aborted()) return;
+					const target = parsePlanAddress(address);
+					if (target === void 0) {
+						yield {
+							ok: false,
+							error: new RemoteError("plan/invalid-address", "Invalid plan resource address.", {})
+						};
+						return;
+					}
+					const sessionAddress = target.session;
+					try {
+						let snapshot;
+						for await (const frame of remote.follow({ address: sessionAddress }, signal)) if (frame.type === "snapshot") {
+							snapshot = frame;
+							break;
+						}
+						if (aborted()) return;
+						if (snapshot === void 0) throw new RemoteError("plan/unavailable", "Session history ended before the plan could be read.", {});
+						let page = {
+							records: snapshot.records,
+							hasMore: snapshot.hasMore
+						};
+						while (true) {
+							for (const entry of page.records) {
+								const plan = submittedPlan(entry.event);
+								if (plan?.callId === target.callId) {
+									yield {
+										ok: true,
+										value: plan
+									};
+									return;
+								}
+							}
+							const beforeSeq = page.records[0]?.event.seq;
+							if (!page.hasMore || beforeSeq === void 0) break;
+							const next = await remote.page({
+								address: sessionAddress,
+								throughSeq: snapshot.cursor,
+								beforeSeq
+							}, signal);
+							if (aborted()) return;
+							if (!next.ok) {
+								yield next;
+								return;
+							}
+							page = next.value;
+						}
+						yield {
+							ok: false,
+							error: new RemoteError("plan/not-found", "The submitted plan was not found in this Session.", {})
+						};
+					} catch (error) {
+						if (!aborted()) yield {
+							ok: false,
+							error: remoteErrorOf(error) ?? new RemoteError("plan/read-failed", error instanceof Error ? error.message : String(error), {})
+						};
+					}
+				}
+			};
+		}
+		//#endregion
+		//#region lib/types/client/review-store.js
+		/** Session-owned memory of pending plans already opened automatically. */
+		/**
+		* Keep manual sidebar closure effective across review component remounts.
+		* @returns a transient store handle whose instances belong to Session scopes.
+		*/
+		function createPlanReviewStore() {
+			return (0, _deepseek_ai_dsh_client_store.defineStore)({
+				init: () => ({ opened: {} }),
+				actions: { markOpened: (draft, reviewKey) => {
+					draft.opened[reviewKey] = true;
+				} }
+			});
+		}
+		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-plan/src/client/PlanModeControl.module.css.mjs
-		const css = ".rS3zOq_wrap{align-items:center;gap:6px;display:inline-flex}.rS3zOq_chip{corner-shape:round;background:var(--dsw-alias-state-warn-tertiary);min-width:34px;color:var(--dsw-alias-state-warn-label);cursor:pointer;border:none;border-radius:999px;align-items:center;gap:4px;padding:2px 8px;font-size:13px;font-weight:500;line-height:20px;display:inline-flex}.rS3zOq_chip:hover:not(:disabled){color:var(--dsw-alias-state-warn-primary)}.rS3zOq_chip:focus-visible{outline:2px solid var(--dsw-alias-state-warn-label);outline-offset:2px}.rS3zOq_chip:disabled{opacity:.6;cursor:default}.rS3zOq_close{color:currentColor;align-items:center;display:inline-flex}.rS3zOq_error{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:18px}";
+		const css = ".rS3zOq_wrap{align-items:center;gap:6px;display:inline-flex}.rS3zOq_chip{background:var(--dsw-alias-state-business-tertiary);min-width:34px;height:28px;color:var(--dsw-alias-state-business-primary);cursor:pointer;border:none;border-radius:14px;align-items:center;gap:4px;padding:0 8px;font-size:13px;font-weight:500;line-height:20px;display:inline-flex}.rS3zOq_chip:hover:not(:disabled){background:color-mix(in srgb, var(--dsw-alias-state-business-tertiary), var(--dsw-alias-state-business-primary) 6%)}.rS3zOq_chip:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:2px}.rS3zOq_chip:disabled{opacity:.6;cursor:default}.rS3zOq_glyph{color:currentColor;flex:none;width:14px;height:14px;display:inline-flex}.rS3zOq_hoverGlyph,.rS3zOq_chip:hover:not(:disabled) .rS3zOq_restGlyph,.rS3zOq_chip:focus-visible .rS3zOq_restGlyph{display:none}.rS3zOq_chip:hover:not(:disabled) .rS3zOq_hoverGlyph,.rS3zOq_chip:focus-visible .rS3zOq_hoverGlyph{display:block}.rS3zOq_error{color:var(--dsw-alias-state-error-primary);font-size:12px;line-height:18px}";
 		const tagId = "@deepseek-ai/dsh-client-ui-plan/PlanModeControl.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -19,8 +482,10 @@ window.__ModuleLoader__.load({
 		}
 		var PlanModeControl_module_css_default = {
 			"chip": "rS3zOq_chip",
-			"close": "rS3zOq_close",
 			"error": "rS3zOq_error",
+			"glyph": "rS3zOq_glyph",
+			"hoverGlyph": "rS3zOq_hoverGlyph",
+			"restGlyph": "rS3zOq_restGlyph",
 			"wrap": "rS3zOq_wrap"
 		};
 		//#endregion
@@ -65,11 +530,17 @@ window.__ModuleLoader__.load({
 					title: t("chip.on.title"),
 					disabled: locked || leaving,
 					onClick: off,
-					children: [t("chip.label"), (0, react_jsx_runtime.jsx)("span", {
-						className: PlanModeControl_module_css_default.close,
+					children: [(0, react_jsx_runtime.jsxs)("span", {
+						className: PlanModeControl_module_css_default.glyph,
 						"aria-hidden": true,
-						children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseFill14, { size: 12 })
-					})]
+						children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlanOutlineRegular, {
+							className: PlanModeControl_module_css_default.restGlyph,
+							size: 14
+						}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseCircleFillRegular, {
+							className: PlanModeControl_module_css_default.hoverGlyph,
+							size: 14
+						})]
+					}), t("chip.label")]
 				}), error !== null && (0, react_jsx_runtime.jsx)("span", {
 					className: PlanModeControl_module_css_default.error,
 					role: "status",
@@ -83,35 +554,63 @@ window.__ModuleLoader__.load({
 		/** `plan` namespace dictionaries (the composer plan chip's copy). */
 		/** Simplified Chinese dictionary (the key-set source of truth). */
 		const zh = {
-			"chip.label": "Plan",
-			"chip.on.aria": "plan mode 已开启，按下关闭",
-			"chip.on.title": "plan mode 已开启 — 点击关闭（/plan off）",
-			"chip.off.aria": "plan mode 已关闭，按下开启",
-			"chip.off.title": "plan mode 已关闭 — 点击开启（/plan）",
-			"chip.exitFailed": "退出 plan mode 失败"
+			"chip.label": "计划",
+			"preview.title": "计划",
+			"preview.document": "计划 · Markdown",
+			"preview.action": "打开",
+			"preview.open": "在侧边栏打开计划",
+			"preview.full": "查看全文",
+			"preview.openNamed": "打开计划：{title}",
+			"preview.loading": "正在读取计划…",
+			"preview.failed": "无法读取计划",
+			"preview.invalidAddress": "计划地址无效",
+			"preview.historyUnavailable": "无法读取会话历史",
+			"preview.notFound": "未找到这份计划",
+			"preview.unavailable": "计划预览不可用",
+			"preview.expired": "临时计划预览已失效，请从仍在等待审批的卡片重新打开。",
+			"chip.on.aria": "计划模式已开启，按下关闭",
+			"chip.on.title": "计划模式已开启 — 点击关闭（/plan off）",
+			"chip.exitFailed": "退出计划模式失败"
 		};
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
 			"chip.label": "Plan",
+			"preview.title": "Plan",
+			"preview.document": "Plan · Markdown",
+			"preview.action": "Open",
+			"preview.open": "Open plan in sidebar",
+			"preview.full": "View full plan",
+			"preview.openNamed": "Open plan: {title}",
+			"preview.loading": "Loading plan…",
+			"preview.failed": "Could not load plan",
+			"preview.invalidAddress": "Invalid plan address",
+			"preview.historyUnavailable": "Session history is unavailable",
+			"preview.notFound": "This plan was not found",
+			"preview.unavailable": "Plan preview is unavailable",
+			"preview.expired": "This temporary plan preview has expired. Reopen it from the pending review card.",
 			"chip.on.aria": "Plan mode on, press to turn off",
 			"chip.on.title": "Plan mode on — click to turn off (/plan off)",
-			"chip.off.aria": "Plan mode off, press to turn on",
-			"chip.off.title": "Plan mode off — click to turn on (/plan)",
 			"chip.exitFailed": "Failed to exit plan mode"
 		};
 		//#endregion
 		//#region lib/types/client/index.js
 		/** Dictionary namespace owned by this plugin. */
 		const NS = "plan";
-		/** Required services: the seat's slot registry, commands Remote, and locale registry. */
+		/** Services for plan controls, Conversation projection, and resource navigation. */
 		const inject = [
 			"slots",
 			"remote",
 			"remote.commands",
-			"locale"
+			"remote.session",
+			"sessions",
+			"locale",
+			"uiConversation",
+			"resources",
+			"sidebarRight",
+			"sidebarRightTabs"
 		];
 		/**
-		* Client plugin body: register the plan chip over the command channel.
+		* Register plan controls, permanent Chat cards, and sidebar document reading.
 		* @param ctx - client root context.
 		*/
 		function apply(ctx) {
@@ -119,6 +618,80 @@ window.__ModuleLoader__.load({
 				zh,
 				en
 			}), "ui-plan: dictionaries");
+			const previewId = "@deepseek-ai/dsh-client-ui-plan";
+			const t = ctx.locale.bind(NS);
+			ctx.effect(() => ctx.uiConversation.events.register(planDefinition), "ui-plan: conversation definition");
+			ctx.effect(() => ctx.resources.register(planResourceProvider(ctx.remote.session)), "ui-plan: resources");
+			ctx.effect(() => ctx.sidebarRightTabs.register({
+				id: previewId,
+				kind: "plan",
+				patterns: ["dsh-resource://plan/**", "dsh-resource://plan-review/**"],
+				priority: "builtin",
+				canOpen: (address) => parsePlanAddress(address) !== void 0 || isReviewPreviewAddress(address),
+				title: () => t("preview.title")
+			}), "ui-plan: sidebar type");
+			const open = (sessionId) => ({ openPlan: (callId) => {
+				const child = ctx.sessions.subagentAddress(sessionId);
+				const session = child === void 0 ? {
+					kind: "session",
+					sessionId
+				} : {
+					kind: "subagent",
+					...child
+				};
+				ctx.sidebarRight.openResource(planAddress({
+					session,
+					callId
+				}));
+			} });
+			const reviewWindow = randomUUID();
+			const reviewStore = createPlanReviewStore();
+			ctx.slots.inject("conversation.chat.turnTail", () => ctx.slots.register({
+				name: "conversation.chat.turnTail",
+				id: previewId,
+				locale: NS,
+				inject: (sessionId) => {
+					const binding = ctx.sessions.binding(sessionId);
+					if (binding === void 0) throw new Error(`ui-plan: unknown session "${sessionId}"`);
+					const chat = ctx.uiConversation.binding(binding).target("chat");
+					return {
+						...open(sessionId),
+						keyedHooks: { plans: (turn) => {
+							const snapshot = chat.getSnapshot();
+							if (snapshot === void 0) throw new Error("ui-plan: Chat target is unavailable");
+							return snapshot.nodes.turnDataSource(Number(turn), "submitted-plan");
+						} }
+					};
+				}
+			}, PlanCards));
+			ctx.slots.inject("conversation.plan-review.actions", () => ctx.slots.register({
+				name: "conversation.plan-review.actions",
+				id: previewId,
+				locale: NS,
+				store: reviewStore,
+				inject: (sessionId) => ({
+					openReview: (review, requestKey) => {
+						if (review.callId !== void 0) {
+							open(sessionId).openPlan(review.callId);
+							return;
+						}
+						ctx.sidebarRight.openResource(reviewPreviewAddress(sessionId, `${reviewWindow}:${requestKey}`), { params: { planReview: {
+							markdown: review.plan,
+							title: (0, _deepseek_ai_dsh_client_ui_primitives.extractMarkdownPlainText)(review.plan, { mode: "first-line" })
+						} } });
+					},
+					hooks: { sidebarMounted: ctx.sidebarRight.mounted }
+				})
+			}, PlanReviewOpen));
+			ctx.slots.inject("sidebar.right.pane.tab", () => ctx.slots.register({
+				name: "sidebar.right.pane.tab",
+				key: previewId,
+				locale: NS
+			}, PlanPreview));
+			ctx.slots.inject("sidebar.right.pane.tab.title", () => ctx.slots.register({
+				name: "sidebar.right.pane.tab.title",
+				key: previewId
+			}, PlanTitle));
 			ctx.slots.inject("conversation.input.plan", () => ctx.slots.register({
 				name: "conversation.input.plan",
 				locale: NS,

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

@@ -0,0 +1,45 @@
+import type { ObservableSnapshot } from '@deepseek-ai/dsh-client-store';
+import type { SubmittedPlan } from './plan.ts';
+import type { HostObservable, InjectFace, PropsLocale, PropsRuntime, PropsStore } from '@deepseek-ai/dsh-client-ui-slots';
+import type { ToolCallId } from '@deepseek-ai/dsh-llm/brand';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { createPlanReviewStore } from './review-store.ts';
+/** Session-bound navigation for logged plans. */
+export interface PlanOpenInjected {
+    /** Open or focus the exact submitted plan. */
+    openPlan: (callId: ToolCallId) => void;
+}
+/** Turn-keyed submitted plans and Session-bound navigation. */
+export interface PlanCardsInjected extends PlanOpenInjected {
+    keyedHooks: {
+        /** Resolve only this Turn's submitted plans, in invocation order. */
+        plans: (turn: string) => ObservableSnapshot<readonly SubmittedPlan[]>;
+    };
+}
+/** Session-bound preview navigation for one pending review. */
+export interface PlanReviewOpenInjected {
+    /** Open the logged plan, or the request's temporary document when no invocation exists. */
+    openReview: (review: PropsRuntime<'conversation.plan-review.actions'>['review'], requestKey: string) => void;
+    readonly hooks: {
+        /** The session whose right Sidebar seat is mounted; `undefined` while none is on screen. */
+        readonly sidebarMounted: HostObservable<SessionId | undefined>;
+    };
+}
+/**
+ * Render the completed Turn's submitted plans in invocation order.
+ * @param props - Logged plan, localized copy, and Session-bound navigation.
+ * @returns keyboard-accessible plan cards, or null for a Turn without plans.
+ */
+export declare function PlanCards({ turn, usePlans, openPlan, t }: PropsRuntime<'conversation.chat.turnTail'> & InjectFace<PlanCardsInjected> & PropsLocale<'plan'>): import("react").JSX.Element | null;
+/**
+ * Open each pending plan automatically and retain a manual opener without answering it.
+ *
+ * The automatic open waits for a mounted Sidebar seat: a review that arrives
+ * while the Conversation is off screen mounts in the same commit as the seat,
+ * ahead of it, and the seat binds from its own effect. Reading the bound
+ * session through the hook opens once that binding exists.
+ * @param props - Review identity, Session store, localized copy, and navigation.
+ * @returns an opener for either logged or temporary plan text.
+ */
+export declare function PlanReviewOpen({ review, requestKey, openReview, useSidebarMounted, t, useStore, actions }: PropsRuntime<'conversation.plan-review.actions'> & InjectFace<PlanReviewOpenInjected> & PropsLocale<'plan'> & PropsStore<ReturnType<typeof createPlanReviewStore>>): import("react").JSX.Element;
+//# sourceMappingURL=PlanCard.d.ts.map

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

@@ -0,0 +1,16 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+type PlanPreviewProps = PropsRuntime<'sidebar.right.pane.tab'> & PropsLocale<'plan'>;
+/**
+ * Render the submitted plan with its complete Markdown.
+ * @param props - Framework-bound tab identity, resource, and copy.
+ * @returns the plan document or a localized loading/failure state.
+ */
+export declare function PlanPreview({ useTabInfo, useResource, t }: PlanPreviewProps): import("react").JSX.Element;
+/**
+ * Display a plain file icon and the heading in its tab after resource recovery.
+ * @param props - Framework-bound tab identity and resource reader.
+ * @returns a decorative file icon followed by the recovered title or initial localized label.
+ */
+export declare function PlanTitle({ useTabInfo, useResource }: PropsRuntime<'sidebar.right.pane.tab.title'>): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=PlanPreview.d.ts.map

package/lib/types/client/failure-line.d.ts

@@ -0,0 +1,11 @@
+/** Localized plan-owned failures and unmodified external diagnostics. */
+import type { RemoteFailure } from '@deepseek-ai/dsh-typert-protocol';
+import type { TranslateNS } from '@deepseek-ai/dsh-client-locale/client';
+/**
+ * Explain a failed plan read in the current locale.
+ * @param t - Plan namespace translator.
+ * @param failure - Failure reported by the resource provider.
+ * @returns localized plan copy, or the external failure's diagnostic.
+ */
+export declare function planFailureLine(t: TranslateNS<'plan'>, failure: RemoteFailure): string;
+//# sourceMappingURL=failure-line.d.ts.map

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

@@ -15,10 +15,10 @@ export interface PlanChipInjected {
      */
     exitPlanMode: () => Promise<string | null>;
 }
-/** Required services: the seat's slot registry, commands Remote, and locale registry. */
+/** Services for plan controls, Conversation projection, and resource navigation. */
 export declare const inject: string[];
 /**
- * Client plugin body: register the plan chip over the command channel.
+ * Register plan controls, permanent Chat cards, and sidebar document reading.
  * @param ctx - client root context.
  */
 export declare function apply(ctx: ClientContext): void;

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

@@ -2,10 +2,21 @@
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
     'chip.label': string;
+    'preview.title': string;
+    'preview.document': string;
+    'preview.action': string;
+    'preview.open': string;
+    'preview.full': string;
+    'preview.openNamed': string;
+    'preview.loading': string;
+    'preview.failed': string;
+    'preview.invalidAddress': string;
+    'preview.historyUnavailable': string;
+    'preview.notFound': string;
+    'preview.unavailable': string;
+    'preview.expired': string;
     'chip.on.aria': string;
     'chip.on.title': string;
-    'chip.off.aria': string;
-    'chip.off.title': string;
     'chip.exitFailed': string;
 };
 /** The plan namespace key union. */
@@ -13,10 +24,21 @@ export type PlanKey = keyof typeof zh;
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
     'chip.label': string;
+    'preview.title': string;
+    'preview.document': string;
+    'preview.action': string;
+    'preview.open': string;
+    'preview.full': string;
+    'preview.openNamed': string;
+    'preview.loading': string;
+    'preview.failed': string;
+    'preview.invalidAddress': string;
+    'preview.historyUnavailable': string;
+    'preview.notFound': string;
+    'preview.unavailable': string;
+    'preview.expired': string;
     'chip.on.aria': string;
     'chip.on.title': string;
-    'chip.off.aria': string;
-    'chip.off.title': string;
     'chip.exitFailed': string;
 };
 //# sourceMappingURL=locales.d.ts.map

package/lib/types/client/plan-definition.d.ts

@@ -0,0 +1,11 @@
+import type { ConversationNodeDefinition } from '@deepseek-ai/dsh-client-ui-conversation/client';
+import { type SubmittedPlan } from './plan.ts';
+declare module '@deepseek-ai/dsh-client-ui-chat/client' {
+    interface ChatNodeDataMap {
+        /** Complete plan submitted through exit_plan_mode, including rejected or dismissed reviews. */
+        'submitted-plan': SubmittedPlan;
+    }
+}
+/** One card per invocation; a later PTC settlement retains the original card position. */
+export declare const planDefinition: ConversationNodeDefinition<SubmittedPlan>;
+//# sourceMappingURL=plan-definition.d.ts.map

package/lib/types/client/plan-resource.d.ts

@@ -0,0 +1,32 @@
+/** Read immutable plan arguments from a Session snapshot and earlier history pages. */
+import type { Context } from '@deepseek-ai/cordis';
+import type { ResourceProvider } from '@deepseek-ai/dsh-client-resources/client';
+import { type SubmittedPlan } from './plan.ts';
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        /** The resource URL does not identify a plan invocation. */
+        'plan/invalid-address': Record<string, never>;
+        /** Session history ended before an opening snapshot. */
+        'plan/unavailable': Record<string, never>;
+        /** The Session has no readable plan for this invocation. */
+        'plan/not-found': Record<string, never>;
+        /** The Session history read failed. */
+        'plan/read-failed': Record<string, never>;
+    }
+}
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface ResourceProtocolMap {
+        /** Immutable Markdown from a logged exit_plan_mode invocation. */
+        plan: SubmittedPlan;
+    }
+}
+/**
+ * Bind plan reads to the generated Session Remote face.
+ * Opening a follow reads projections and may activate a prepared Session on the Host.
+ * Generated Remote streams can throw carrier failures; the provider reports failed
+ * reads as resource failure frames and preserves Remote error codes.
+ * @param remote - Existing Session history API.
+ * @returns a provider whose reads stop after finding the exact invocation.
+ */
+export declare function planResourceProvider(remote: Pick<Context['remote']['session'], 'follow' | 'page'>): ResourceProvider<'plan'>;
+//# sourceMappingURL=plan-resource.d.ts.map

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

@@ -0,0 +1,39 @@
+/** Plan text and resource identities derived from logged native or PTC calls. */
+import type { ToolCallId } from '@deepseek-ai/dsh-llm/brand';
+import type { SessionAddress } from '@deepseek-ai/dsh-api-session-controller/types';
+/** Complete Markdown and the heading displayed by a plan preview. */
+export interface PlanDocument {
+    readonly markdown: string;
+    readonly title: string;
+}
+/** One submitted plan, identified by its originating tool invocation. */
+export interface SubmittedPlan extends PlanDocument {
+    readonly callId: ToolCallId;
+}
+/** A saved sidebar resource names one invocation in one Session. */
+export interface PlanAddress {
+    readonly session: SessionAddress;
+    readonly callId: ToolCallId;
+}
+/**
+ * Read a complete plan from untrusted logged arguments.
+ * @param event - Native call or PTC dispatch event from Session history.
+ * @returns the submitted plan, or undefined for unrelated or malformed data.
+ */
+export declare function submittedPlan(event: {
+    readonly type: string;
+    readonly data: unknown;
+}): SubmittedPlan | undefined;
+/**
+ * Encode the durable identity of a plan without retaining its text in layout storage.
+ * @param target - Session and tool-call identity.
+ * @returns the plan resource address.
+ */
+export declare function planAddress(target: PlanAddress): string;
+/**
+ * Validate a saved or caller-supplied plan resource address.
+ * @param address - Address submitted to the sidebar or resource provider.
+ * @returns the decoded identity, or undefined for an unsupported address.
+ */
+export declare function parsePlanAddress(address: string): PlanAddress | undefined;
+//# sourceMappingURL=plan.d.ts.map

package/lib/types/client/review-preview.d.ts

@@ -0,0 +1,25 @@
+/** Temporary review previews carry their document in in-memory tab navigation. */
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { PlanDocument } from './plan.ts';
+declare module '@deepseek-ai/dsh-client-ui-sidebar-right/client' {
+    interface SidebarRightResourceParamsMap {
+        /** Review text without a logged invocation; never persisted in sidebar layout. */
+        'plan-review': {
+            planReview: PlanDocument;
+        };
+    }
+}
+/**
+ * Name one temporary review within its browser lifetime and Session.
+ * @param sessionId - Session displaying the review.
+ * @param requestKey - Browser-unique pending request identity.
+ * @returns the address used to focus or reopen its preview.
+ */
+export declare function reviewPreviewAddress(sessionId: SessionId, requestKey: string): string;
+/**
+ * Recognize temporary plan navigation without interpreting it as logged history.
+ * @param address - Saved or caller-supplied navigation address.
+ * @returns whether the address identifies a temporary review preview.
+ */
+export declare function isReviewPreviewAddress(address: string): boolean;
+//# sourceMappingURL=review-preview.d.ts.map

package/lib/types/client/review-store.d.ts

@@ -0,0 +1,15 @@
+/** Session-owned memory of pending plans already opened automatically. */
+import { type EngineStoreHandle } from '@deepseek-ai/dsh-client-store';
+interface PlanReviewState {
+    opened: Partial<Record<string, true>>;
+}
+type PlanReviewActions = {
+    markOpened: (draft: PlanReviewState, reviewKey: string) => void;
+};
+/**
+ * Keep manual sidebar closure effective across review component remounts.
+ * @returns a transient store handle whose instances belong to Session scopes.
+ */
+export declare function createPlanReviewStore(): EngineStoreHandle<PlanReviewState, PlanReviewActions>;
+export {};
+//# sourceMappingURL=review-store.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-plan",
-  "description": "Plan-mode composer control: the conversation.input.plan seat over the plan projection and the /plan command channel",
-  "version": "0.1.6-alpha.1",
+  "description": "Plan mode controls, persistent transcript plan cards, and sidebar Markdown previews",
+  "version": "0.1.7-alpha.1",
   "publishConfig": {
     "access": "public"
   },
@@ -30,29 +30,44 @@
       "inject": [
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-client-locale",
-        "@deepseek-ai/dsh-client-ui-conversation"
+        "@deepseek-ai/dsh-client-ui-conversation",
+        "@deepseek-ai/dsh-client-ui-sidebar-right",
+        "@deepseek-ai/dsh-client-ui-chat",
+        "@deepseek-ai/dsh-client-ui-user-questions",
+        "@deepseek-ai/dsh-client-resources",
+        "@deepseek-ai/dsh-api-session-controller"
       ],
       "platform": "web"
     }
   },
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "^4.0.3"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-plan-mode": "^0.1.6-alpha.1",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-session": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.6-alpha.1",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.6-alpha.1"
+    "@deepseek-ai/dsh-api-remotes": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-store": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-plan-mode": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-alpha.1",
+    "@deepseek-ai/cordis": "^4.0.3",
+    "@deepseek-ai/dsh-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-sidebar-right": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-ui-user-questions": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-client-resources": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-llm": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-tools": "^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.7-alpha.1"
   },
   "files": [
     "lib/index.js",