@deepseek-ai/dsh-client-ui-goal 0.1.3-alpha.2 → 0.1.5-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/client/ui-goal/README.md
-README.md: 8556575b00e1d3073f251d83f3dee0bafb4c8969
-README.zh.md: 22d0417bc2d37719150ec46aad849ad2bce8b460
+README.md: 1fbc1c7df944f1106fedcff79f6b9df35bda480d
+README.zh.md: 01f8902377c98dc39d64b3bfe26108b68cb29fe0

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-This package renders the goal surface in the Web GUI: a strip in the composer-context stack that shows the current goal of the session and offers edit, pause, resume, and clear actions. It reads the live goal from the host-computed projection and routes every mutation through the goal service, surfacing rejections inline. It also projects each durable `/goal` command run as a `Command input` bubble in the chat, so a goal command entered by the user or the model appears in the transcript. Goal creation is outside this plugin. The shipped Web presets other than `minimal` mount `/goal` in their agent scope.
+The Web GUI goal surface shows both the durable goal state and its current process-local activation, and lets users edit, pause, resume, or clear the goal; rejected changes appear inline. It displays durable `/goal` runs as `Command input` bubbles so commands from users or the model remain visible after reload. Goal creation remains outside this package. Shipped Web presets other than `minimal` make `/goal` available to agents.
 
 ## Table of Contents
 
@@ -25,7 +25,7 @@ This package renders the goal surface in the Web GUI: a strip in the composer-co
 <a id="use-this-package"></a>
 ## Use this package
 
-Mount this plugin alongside `ui-conversation` and the goal domain package; the strip then appears as the second card in the composer-context stack (after Todo, before Queue) whenever the session has a goal. An active goal offers pause; a paused one offers resume; edit rewrites the objective; clear removes the goal and suppresses the strip until the projection catches up.
+Mount this plugin alongside `ui-conversation` and the goal domain package; the strip then appears as the second card in the composer-context stack (after Todo, before Queue) whenever the session has a goal. An armed active goal offers pause; an active-but-disarmed or paused goal offers resume; edit rewrites the objective; clear removes the goal and suppresses the strip until the projection catches up.
 
 ### The command-input bubble
 
@@ -43,7 +43,7 @@ A rejected mutation surfaces the Remote error inline on the strip; loading, abse
 <details>
 <summary>Implementation internals — click to expand</summary>
 
-The strip is projection-mode: the live goal arrives through `useProjection('goal')` (seeded by the history tail page and updated by `session/projection` frames), so the plugin owns no domain store, refresh chain, or event listener. The inject face carries only the four mutation verbs through `ctx.remote.goals`; each reads the CAS ref from the session's current projected value at call time, and the RPC's compare-and-set is the staleness guard. The strip single-flights mutations synchronously because a pending render cannot fence same-frame clicks. The command-input projection is a separate Conversation Definition that builds a `command-input` Chat Node before the generic command result Node; it never creates `user/message` or a model turn.
+The durable goal arrives through `useProjection('goal')` (seeded by the history tail page and updated by `session/projection` frames). The inject face carries a registrant-private activation hook source plus the four mutation verbs. That source starts only while the framework hook observes it, reads `ctx.remote.goals.get`, subscribes to `goal/activation-changed`, and refreshes on running-state or connection resets. Live-event epochs invalidate in-flight reads, so a stale HTTP result cannot overwrite a newer activation edge; running refreshes retain the last known activation until the read resolves. The strip owns no domain store or cross-plugin cache. Each mutation reads the CAS ref from the session's current projected value at call time, and the RPC's compare-and-set is the staleness guard. The strip single-flights mutations synchronously because a pending render cannot fence same-frame clicks. The command-input projection is a separate Conversation Definition that builds a `command-input` Chat Node before the generic command result Node; it never creates `user/message` or a model turn.
 
 </details>
 
@@ -76,7 +76,6 @@ None unless the queued goal context is admitted. An admitted context extends the
 
 These limits define the current goal surface. They are current package constraints, not a goal-domain comparison or a task backlog.
 
-- **Durable phase only** — the projection omits process-local activation, so the strip cannot distinguish an active-but-disarmed goal from an armed one; resume re-arms through the RPC side. There is no host-live activation channel.
 - **Preset-independent host state** — switching an active session to `minimal` leaves its host-owned goal intact. `/goal` and goal tools disappear, while this strip can still edit, pause, resume, or clear the goal.
 
 <a id="dev-note"></a>
@@ -89,4 +88,4 @@ None.
 
 </details>
 
-**Runtime invariant:** No companion is published. A single GoalBar dock registration whose disposal is proven by the HMR-safety spec — the plugin owns no store (state arrives on the goal projection), emits no cordis events, and holds no cross-plugin mutable state.
+**Runtime invariant:** No companion is published. A single GoalBar dock registration whose disposal is proven by the HMR-safety spec — durable state arrives on the goal projection, process-local activation arrives through the entry's private hook source, and that source subscribes only while the framework hook observes it.

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-本包在 Web GUI 中渲染 goal 表面：composer 上下文堆栈里的一条条带，显示会话的当前目标，并提供编辑、暂停、恢复与清除动作。它从宿主计算的投影读取活目标，把每次变更都经 goal 服务路由，并把拒绝内联呈现。它还把每条持久的 `/goal` 命令运行投影为聊天中的 `Command input` 气泡，让用户或模型输入的 goal 命令出现在文本记录中。goal 创建不归本插件。除 `minimal` 外，随附的 Web preset 都会在其 agent scope 中挂载 `/goal`。
+Web GUI 的 goal 表面同时显示持久 goal 状态及当前的进程本地激活状态，供用户编辑、暂停、恢复或清除 goal；被拒绝的变更会内联显示。它把持久的 `/goal` 运行显示为 `Command input` 气泡，让用户或模型发出的命令在重新加载后仍然可见。goal 创建仍不归本包。除 `minimal` 外，随附的 Web preset 都会向 agent 提供 `/goal`。
 
 ## 目录
 
@@ -25,7 +25,7 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
-与 `ui-conversation` 及 goal 领域包一起挂载本插件；只要会话存在目标，条带就会作为 composer 上下文堆栈的第二张卡片出现（位于 Todo 之后、Queue 之前）。active 的 goal 提供暂停动作；paused 的提供恢复；编辑重写目标文本；清除移除目标，并在投影追上之前抑制条带。
+与 `ui-conversation` 及 goal 领域包一起挂载本插件；只要会话存在目标，条带就会作为 composer 上下文堆栈的第二张卡片出现（位于 Todo 之后、Queue 之前）。已 armed 的 active goal 提供暂停动作；active-but-disarmed 或 paused 的 goal 提供恢复；编辑重写目标文本；清除移除目标，并在投影追上之前抑制条带。
 
 ### 指令输入气泡
 
@@ -43,7 +43,7 @@ kind: "package-reference"
 <details>
 <summary>实现细节——点击展开</summary>
 
-条带是投影模式：活目标经 `useProjection('goal')` 到达（由历史尾页播种、`session/projection` 帧更新），因此插件不持有领域 store、不设刷新链、不挂事件监听。注入面只携带四个变更动词，经 `ctx.remote.goals` 调用；每个动词在调用时从会话当前投影值读取 CAS ref，比较并交换（RPC 的 CAS）就是陈旧性护栏。由于 React 的 pending 渲染无法拦住同一帧内的点击，条带会同步为变更建立 single-flight 防护。指令输入投影是独立的 Conversation Definition，在通用命令结果 Node 之前构建 `command-input` Chat Node；它绝不创建 `user/message` 或模型轮次。
+持久 goal 经 `useProjection('goal')` 到达（由历史尾页播种、`session/projection` 帧更新）。注入面携带 registrant-private 的 activation hook source 与四个变更动词。该 source 仅在框架 hook 观察期间订阅，读取 `ctx.remote.goals.get`、订阅 `goal/activation-changed`，并在 running 状态或连接 reset 时刷新。live event epoch 会让在途读取失效，因此较旧的 HTTP 响应不能覆盖更新的 activation 边界；running 刷新会保留最后一次已知 activation，直到读取完成。条带不持有领域 store 或跨插件缓存。每个变更在调用时从会话当前投影值读取 CAS ref，比较并交换（RPC 的 CAS）就是陈旧性护栏。由于 React 的 pending 渲染无法拦住同一帧内的点击，条带会同步为变更建立 single-flight 防护。指令输入投影是独立的 Conversation Definition，在通用命令结果 Node 之前构建 `command-input` Chat Node；它绝不创建 `user/message` 或模型轮次。
 
 </details>
 
@@ -76,7 +76,6 @@ kind: "package-reference"
 
 这些限制界定了当前 goal 表面。它们是当前包约束，不是 goal 领域对比或任务积压。
 
-- **只反映持久阶段**——投影省略进程本地的激活状态，因此条带无法区分已激活但未武装的 goal 与已武装的 goal；恢复经 RPC 侧重新武装。不存在宿主实时激活通道。
 - **Host 状态与 preset 无关**——把活跃会话切换到 `minimal` 后，Host 拥有的 goal 仍会保留。`/goal` 与 goal 工具会消失，但该条带仍可编辑、暂停、恢复或清除 goal。
 
 <a id="dev-note"></a>
@@ -89,4 +88,4 @@ kind: "package-reference"
 
 </details>
 
-**运行时不变式：** 不发布伴生入口。插件只注册一个 GoalBar dock，HMR 测试覆盖释放；状态来自 goal projection，本包不持有 store 或跨插件可变状态。
+**运行时不变式：** 不发布伴生入口。插件只注册一个 GoalBar dock，HMR 测试覆盖释放；持久状态来自 goal projection，进程本地 activation 来自入口私有 hook source，且该 source 只在框架 hook 观察期间订阅。

package/lib/client.js

@@ -7,6 +7,122 @@ window.__ModuleLoader__.load({
 		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");
+		//#region lib/types/client/activation-source.js
+		/** Goal activation observable that orders Remote reads and live activation events. */
+		/** Compare two empty-or-populated activation snapshots by value. */
+		function sameSnapshot(left, right) {
+			return left.id === right.id && left.revision === right.revision && left.activation === right.activation;
+		}
+		/** Return the current active CAS ref, or undefined when the goal is not active. */
+		function activeRef(projection) {
+			return projection?.goal.phase === "active" ? projection.goal : void 0;
+		}
+		/**
+		* Create one registrant-private activation source. The source subscribes only
+		* while a framework hook observes it, so unmount releases the Remote event,
+		* projection, running-snapshot, and reset listeners.
+		* @param deps - projection, session, Remote read, and live-event inputs.
+		* @returns stable snapshot source consumed by `useGoalActivation`.
+		*/
+		function createGoalActivationSource(deps) {
+			let snapshot = {};
+			let subscriptions = 0;
+			let disposers = [];
+			let running = deps.session.getSnapshot().running;
+			let eventEpoch = 0;
+			let projectionEpoch = 0;
+			let readEpoch = 0;
+			const listeners = /* @__PURE__ */ new Set();
+			const publish = (next) => {
+				if (sameSnapshot(snapshot, next)) return;
+				snapshot = next;
+				for (const listener of listeners) listener();
+			};
+			const startRead = (ref) => {
+				if (ref === void 0) return;
+				const read = ++readEpoch;
+				const startedAtEvent = eventEpoch;
+				const startedAtProjection = projectionEpoch;
+				deps.getGoal().then((result) => {
+					if (read !== readEpoch || startedAtEvent !== eventEpoch || startedAtProjection !== projectionEpoch) return;
+					if (!result.ok) return;
+					const goal = result.value;
+					/* v8 ignore next 4 -- projection drive is the authoritative clear edge; an active projection with no live goal is transient. */
+					if (goal === void 0) {
+						if (activeRef(deps.projection.getSnapshot()) === void 0) publish({});
+						return;
+					}
+					publish({
+						id: goal.id,
+						revision: goal.revision,
+						activation: goal.activation
+					});
+				});
+			};
+			const refreshProjection = () => {
+				projectionEpoch++;
+				const ref = activeRef(deps.projection.getSnapshot());
+				if (ref === void 0) {
+					/* v8 ignore next -- clearing an already-empty activation snapshot is idempotent. */
+					if (snapshot.id !== void 0) publish({});
+					return;
+				}
+				if (snapshot.id !== ref.id || snapshot.revision !== ref.revision) publish({
+					id: ref.id,
+					revision: ref.revision
+				});
+				startRead(ref);
+			};
+			const onActivation = (goal) => {
+				eventEpoch++;
+				readEpoch++;
+				publish(goal === void 0 ? {} : {
+					id: goal.id,
+					revision: goal.revision,
+					activation: goal.activation
+				});
+			};
+			const onRunning = () => {
+				const next = deps.session.getSnapshot().running;
+				if (next === running) return;
+				running = next;
+				startRead(activeRef(deps.projection.getSnapshot()));
+			};
+			const onReset = () => {
+				eventEpoch++;
+				projectionEpoch++;
+				startRead(activeRef(deps.projection.getSnapshot()));
+			};
+			const start = () => {
+				disposers = [
+					deps.projection.subscribe(refreshProjection),
+					deps.session.subscribe(onRunning),
+					deps.subscribeActivation(onActivation),
+					deps.subscribeReset(onReset)
+				];
+				running = deps.session.getSnapshot().running;
+				refreshProjection();
+			};
+			const stop = () => {
+				for (const dispose of disposers) dispose();
+				disposers = [];
+				readEpoch++;
+			};
+			return {
+				getSnapshot: () => snapshot,
+				subscribe(listener) {
+					listeners.add(listener);
+					if (subscriptions === 0) start();
+					subscriptions++;
+					return () => {
+						listeners.delete(listener);
+						subscriptions--;
+						if (subscriptions === 0) stop();
+					};
+				}
+			};
+		}
+		//#endregion
 		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-goal/src/client/GoalBar.module.css.mjs
 		const css$1 = ".nLMEza_dock{box-sizing:border-box;width:calc(100% - var(--dsh-composer-side-clearance) - var(--dsh-composer-side-clearance) - var(--dsh-composer-dock-inset) - var(--dsh-composer-dock-inset) - var(--dsh-composer-dock-inset) - var(--dsh-composer-dock-inset));margin:0 auto}.nLMEza_bar{box-sizing:border-box;width:100%;max-width:calc(var(--dsh-composer-card-max-width) - 4 * var(--dsh-composer-dock-inset));border:.5px solid var(--dsw-alias-border-l1);background:var(--dsw-specific-tip);border-radius:12px;align-items:center;gap:10px;height:36px;margin:0 auto;padding:4px 5px 4px 12px;display:flex}.nLMEza_goalGlyph{color:var(--dsw-alias-label-tertiary);flex:none;display:inline-flex}.nLMEza_label{color:var(--dsw-alias-label-primary);flex:none;font-size:13px;font-weight:500;line-height:24px}.nLMEza_objective{min-width:0;color:var(--dsw-alias-label-primary-dimmed);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:13px;line-height:20px;overflow:hidden}.nLMEza_error{min-width:0;color:var(--dsw-alias-state-error-primary);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:12px;line-height:20px;overflow:hidden}.nLMEza_objectiveInput{border:.5px solid var(--dsw-alias-border-l4);background:var(--dsw-alias-bg-base);min-width:0;height:26px;color:var(--dsw-alias-label-primary);border-radius:6px;outline:none;flex:1;padding:0 8px;font-size:13px;line-height:20px}.nLMEza_objectiveInput:focus{border-color:var(--dsw-alias-state-business-primary)}.nLMEza_objectiveInput::placeholder{color:var(--dsw-alias-label-caption)}.nLMEza_actions{flex:none;align-items:center;gap:10px;display:flex}.nLMEza_iconBtn{corner-shape:round;width:28px;height:28px;color:var(--dsw-alias-label-tertiary);cursor:pointer;background:0 0;border:none;border-radius:999px;justify-content:center;align-items:center;padding:0;display:inline-flex}.nLMEza_iconBtn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.nLMEza_iconBtn:disabled{opacity:.4;cursor:default}";
 		const tagId$1 = "@deepseek-ai/dsh-client-ui-goal/GoalBar.module.css";
@@ -33,11 +149,11 @@ window.__ModuleLoader__.load({
 		/**
 		* GoalBar: the goal indicator docked above the message composer (input dock
 		* strip). A present goal shows a goal glyph, a phase label, the truncated
-		* objective, and icon actions — resume when paused, edit (inline form in the
-		* same strip), and clear. Goal creation lives on the `/goal` command, not
-		* here: loading (undefined), no goal (null), and complete goals render
-		* nothing. Live state arrives as the projected whole snapshot; the verbs are
-		* the injected face.
+		* objective, and icon actions — resume when active-disarmed or paused, edit
+		* (inline form in the same strip), and clear. Goal creation lives on the
+		* `/goal` command, not here: loading (undefined), no goal (null), and complete
+		* goals render nothing. Durable state arrives as the projected whole snapshot;
+		* process-local activation arrives through the injected activation hook.
 		*/
 		/** Strip label keys per visible phase; complete goals render nothing. */
 		const PHASE_LABELS = {
@@ -45,7 +161,12 @@ window.__ModuleLoader__.load({
 			paused: "phase.paused",
 			blocked: "phase.blocked"
 		};
-		function GoalBar({ goal, onEdit, onPause, onResume, onClear, t }) {
+		/** Strip label for an active goal using its process-local activation. */
+		function activeLabel(activation, t) {
+			if (activation === "disarmed") return t("phase.active.disarmed");
+			return t(PHASE_LABELS.active);
+		}
+		function GoalBar({ goal, activation, onEdit, onPause, onResume, onClear, t }) {
 			const [editing, setEditing] = (0, react.useState)(false);
 			const [draft, setDraft] = (0, react.useState)("");
 			const [pending, setPending] = (0, react.useState)(false);
@@ -143,6 +264,8 @@ window.__ModuleLoader__.load({
 				})
 			});
 			const title = goal.phase === "blocked" ? goal.blockedReason?.message : void 0;
+			const label = goal.phase === "active" ? activeLabel(activation, t) : t(PHASE_LABELS[goal.phase]);
+			const showResume = goal.phase === "paused" || goal.phase === "active" && activation === "disarmed";
 			return (0, react_jsx_runtime.jsx)("div", {
 				className: GoalBar_module_css_default.dock,
 				"data-goal-bar": true,
@@ -156,7 +279,7 @@ window.__ModuleLoader__.load({
 						}),
 						(0, react_jsx_runtime.jsx)("span", {
 							className: GoalBar_module_css_default.label,
-							children: t(PHASE_LABELS[goal.phase])
+							children: label
 						}),
 						(0, react_jsx_runtime.jsx)("span", {
 							className: GoalBar_module_css_default.objective,
@@ -170,7 +293,7 @@ window.__ModuleLoader__.load({
 						(0, react_jsx_runtime.jsxs)("div", {
 							className: GoalBar_module_css_default.actions,
 							children: [
-								goal.phase === "active" && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+								goal.phase === "active" && activation === "armed" && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 									label: t("action.pause"),
 									side: "bottom",
 									delayMs: 500,
@@ -185,7 +308,7 @@ window.__ModuleLoader__.load({
 										children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPauseOutline16, { size: 14 })
 									})
 								}),
-								goal.phase === "paused" && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+								showResume && (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 									label: t("action.resume"),
 									side: "bottom",
 									delayMs: 500,
@@ -237,11 +360,16 @@ window.__ModuleLoader__.load({
 				})
 			});
 		}
-		/** Dock adapter: reads the host-computed 'goal' projection (whole value; absent or null renders nothing). */
-		function GoalDock({ useProjection, onEdit, onPause, onResume, onClear, t }) {
+		/** Dock adapter: overlays process-local activation on the durable goal projection. */
+		function GoalDock({ useProjection, useGoalActivation, onEdit, onPause, onResume, onClear, t }) {
 			const projection = useProjection("goal");
+			const goal = projection === void 0 || projection === null ? projection : projection.goal;
+			const goalId = goal?.id;
+			const revision = goal?.revision;
+			const activation = useGoalActivation((next) => next.id === goalId && next.revision === revision ? next.activation : void 0);
 			return (0, react_jsx_runtime.jsx)(GoalBar, {
-				goal: projection === void 0 ? void 0 : projection === null ? null : projection.goal,
+				goal,
+				...activation === void 0 ? {} : { activation },
 				onEdit,
 				onPause,
 				onResume,
@@ -346,6 +474,7 @@ window.__ModuleLoader__.load({
 		/** Simplified Chinese dictionary (the key-set source of truth). */
 		const zh = {
 			"phase.active": "进行中的目标",
+			"phase.active.disarmed": "未运行的目标",
 			"phase.paused": "已暂停的目标",
 			"phase.blocked": "受阻的目标",
 			"objective.aria": "目标内容",
@@ -360,6 +489,7 @@ window.__ModuleLoader__.load({
 		/** English dictionary, checked complete against the zh key set. */
 		const en = {
 			"phase.active": "Ongoing Goal",
+			"phase.active.disarmed": "Inactive Goal",
 			"phase.paused": "Paused Goal",
 			"phase.blocked": "Blocked Goal",
 			"objective.aria": "Goal objective",
@@ -421,28 +551,41 @@ window.__ModuleLoader__.load({
 				id: "goal",
 				order: 10,
 				locale: NS,
-				inject: (sessionId) => ({
-					onEdit: async (objective) => {
-						const ref = refOf(sessionId);
-						if (ref === void 0) return noCurrentGoal;
-						return await ctx.remote.goals.edit(sessionId, ref, { objective });
-					},
-					onPause: async () => {
-						const ref = refOf(sessionId);
-						if (ref === void 0) return noCurrentGoal;
-						return await ctx.remote.goals.pause(sessionId, ref);
-					},
-					onResume: async () => {
-						const ref = refOf(sessionId);
-						if (ref === void 0) return noCurrentGoal;
-						return await ctx.remote.goals.resume(sessionId, ref);
-					},
-					onClear: async () => {
-						const ref = refOf(sessionId);
-						if (ref === void 0) return noCurrentGoal;
-						return await ctx.remote.goals.clear(sessionId, ref);
-					}
-				})
+				inject: (sessionId) => {
+					const binding = sessions.binding(sessionId);
+					if (binding === void 0) throw new Error(`ui-goal: session "${sessionId}" is unavailable`);
+					return {
+						hooks: { goalActivation: createGoalActivationSource({
+							projection: binding.session.projections.faceOf("goal"),
+							session: binding.session,
+							getGoal: () => ctx.remote.goals.get(sessionId),
+							subscribeActivation: (listener) => ctx.remote.$on("goal/activation-changed", (event) => {
+								if (event.sessionId === sessionId) listener(event.goal);
+							}),
+							subscribeReset: (listener) => ctx.on("connection/reset", listener)
+						}) },
+						onEdit: async (objective) => {
+							const ref = refOf(sessionId);
+							if (ref === void 0) return noCurrentGoal;
+							return await ctx.remote.goals.edit(sessionId, ref, { objective });
+						},
+						onPause: async () => {
+							const ref = refOf(sessionId);
+							if (ref === void 0) return noCurrentGoal;
+							return await ctx.remote.goals.pause(sessionId, ref);
+						},
+						onResume: async () => {
+							const ref = refOf(sessionId);
+							if (ref === void 0) return noCurrentGoal;
+							return await ctx.remote.goals.resume(sessionId, ref);
+						},
+						onClear: async () => {
+							const ref = refOf(sessionId);
+							if (ref === void 0) return noCurrentGoal;
+							return await ctx.remote.goals.clear(sessionId, ref);
+						}
+					};
+				}
 			}, GoalDock));
 		}
 		//#endregion

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

@@ -1,22 +1,24 @@
 /**
  * GoalBar: the goal indicator docked above the message composer (input dock
  * strip). A present goal shows a goal glyph, a phase label, the truncated
- * objective, and icon actions — resume when paused, edit (inline form in the
- * same strip), and clear. Goal creation lives on the `/goal` command, not
- * here: loading (undefined), no goal (null), and complete goals render
- * nothing. Live state arrives as the projected whole snapshot; the verbs are
- * the injected face.
+ * objective, and icon actions — resume when active-disarmed or paused, edit
+ * (inline form in the same strip), and clear. Goal creation lives on the
+ * `/goal` command, not here: loading (undefined), no goal (null), and complete
+ * goals render nothing. Durable state arrives as the projected whole snapshot;
+ * process-local activation arrives through the injected activation hook.
  */
-import type { GoalSnapshot } from '@deepseek-ai/dsh-goal/client';
-import type { PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
-import type { GoalBarActions } from './slots.ts';
+import type { GoalActivation, GoalSnapshot } from '@deepseek-ai/dsh-goal/client';
+import type { InjectFace, PropsLocale } from '@deepseek-ai/dsh-client-ui-slots';
+import type { GoalBarActions, GoalBarInjected } from './slots.ts';
 export interface GoalBarProps extends GoalBarActions {
     /** Current goal snapshot; undefined = capability absent or loading, null = no goal set. */
     goal: GoalSnapshot | null | undefined;
+    /** Process-local continuation activation; absent while the live read is pending. */
+    activation?: GoalActivation;
 }
-export declare function GoalBar({ goal, onEdit, onPause, onResume, onClear, t }: GoalBarProps & PropsLocale<'goal'>): import("react").JSX.Element | null;
-/** Full props of the dock entry: InputZone owner share + session standard kit + injected verbs + the locale seat. */
-export type GoalDockProps = import('@deepseek-ai/dsh-client-ui-slots').PropsRuntime<'conversation.input.dock'> & GoalBarActions & PropsLocale<'goal'>;
-/** Dock adapter: reads the host-computed 'goal' projection (whole value; absent or null renders nothing). */
-export declare function GoalDock({ useProjection, onEdit, onPause, onResume, onClear, t }: GoalDockProps): import("react").JSX.Element;
+export declare function GoalBar({ goal, activation, onEdit, onPause, onResume, onClear, t }: GoalBarProps & PropsLocale<'goal'>): import("react").JSX.Element | null;
+/** Full props of the dock entry: InputZone owner share + injected verbs/activation hook + the locale seat. */
+export type GoalDockProps = import('@deepseek-ai/dsh-client-ui-slots').PropsRuntime<'conversation.input.dock'> & InjectFace<GoalBarInjected> & PropsLocale<'goal'>;
+/** Dock adapter: overlays process-local activation on the durable goal projection. */
+export declare function GoalDock({ useProjection, useGoalActivation, onEdit, onPause, onResume, onClear, t, }: GoalDockProps): import("react").JSX.Element;
 //# sourceMappingURL=GoalBar.d.ts.map

package/lib/types/client/activation-source.d.ts

@@ -0,0 +1,29 @@
+/** Goal activation observable that orders Remote reads and live activation events. */
+import type { RemoteResult } from '@deepseek-ai/dsh-api-remotes/client';
+import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
+import type { GoalActivationChanged, GoalProjection, GoalView } from '@deepseek-ai/dsh-goal/client';
+import type { GoalActivationSnapshot } from './slots.ts';
+/** Live inputs for one Session's goal activation source. */
+export interface GoalActivationDeps {
+    /** Durable projection used to derive the current active goal ref. */
+    readonly projection: HostObservable<GoalProjection | null | undefined>;
+    /** Session snapshot; running flips trigger a fresh authoritative read. */
+    readonly session: HostObservable<{
+        readonly running: boolean;
+    }>;
+    /** Read the current live goal at call time. */
+    readonly getGoal: () => Promise<RemoteResult<GoalView | undefined>>;
+    /** Subscribe to activation edges after the transport delivers them. */
+    readonly subscribeActivation: (listener: (goal: GoalActivationChanged['goal']) => void) => () => void;
+    /** Refresh after a connection-generation reset. */
+    readonly subscribeReset: (listener: () => void) => () => void;
+}
+/**
+ * Create one registrant-private activation source. The source subscribes only
+ * while a framework hook observes it, so unmount releases the Remote event,
+ * projection, running-snapshot, and reset listeners.
+ * @param deps - projection, session, Remote read, and live-event inputs.
+ * @returns stable snapshot source consumed by `useGoalActivation`.
+ */
+export declare function createGoalActivationSource(deps: GoalActivationDeps): HostObservable<GoalActivationSnapshot>;
+//# sourceMappingURL=activation-source.d.ts.map

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

@@ -1,17 +1,15 @@
 /**
  * Goal surface plugin, browser half: the GoalBar entry in the
- * conversation.input.dock strip. Projection-mode surface — the live goal
- * arrives through `useProjection('goal')` (seeded by the history tail page,
- * updated by session/projection frames), so this plugin owns no store, no
- * refresh chain, and no event listener. The inject face carries only the
- * four mutation verbs through the generated Goal Remote API;
- * their CAS ref reads the session's current projected value at call time.
+ * conversation.input.dock strip. The durable goal arrives through
+ * `useProjection('goal')`. A registrant-private activation hook source owns
+ * the live Remote read and event subscription; the inject face carries that
+ * hook plus the four mutation verbs through the generated Goal Remote API.
  * This plugin does not create goals; deployments may expose /goal separately.
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 import { type GoalKey } from './locales.ts';
 export { GoalBar, GoalDock } from './GoalBar.tsx';
-export type { GoalActionResult, GoalBarActions } from './slots.ts';
+export type { GoalActionResult, GoalBarActions, } from './slots.ts';
 export type { GoalKey } from './locales.ts';
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {

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

@@ -2,6 +2,7 @@
 /** Simplified Chinese dictionary (the key-set source of truth). */
 export declare const zh: {
     'phase.active': string;
+    'phase.active.disarmed': string;
     'phase.paused': string;
     'phase.blocked': string;
     'objective.aria': string;
@@ -18,6 +19,7 @@ export type GoalKey = keyof typeof zh;
 /** English dictionary, checked complete against the zh key set. */
 export declare const en: {
     'phase.active': string;
+    'phase.active.disarmed': string;
     'phase.paused': string;
     'phase.blocked': string;
     'objective.aria': string;

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

@@ -1,12 +1,14 @@
 /**
  * GoalBar's injected face. The target 'conversation.input.dock' slot is
  * declared (children table) and typed by ui-conversation; this package only
- * contributes the entry, so no SlotMap merge lives here. The live goal value
- * is NOT part of this face — it arrives through `useProjection('goal')`
- * (the framework standard kit); inject carries only the mutation verbs
- * (callbacks from inject, live state from useProjection).
+ * contributes the entry, so no SlotMap merge lives here. The durable goal
+ * value arrives through `useProjection('goal')` (the framework standard kit);
+ * the injected face carries mutation verbs and a registrant-private
+ * activation hook source.
  */
 import type { RemoteResult } from '@deepseek-ai/dsh-api-remotes/client';
+import type { HostObservable } from '@deepseek-ai/dsh-client-ui-slots';
+import type { GoalActivation, GoalId } from '@deepseek-ai/dsh-goal/client';
 /**
  * The one failure the strip reports without a wire call: the session projects
  * no goal, so no CAS ref exists to address a mutation to.
@@ -24,6 +26,21 @@ export interface GoalLocalFailure {
  * projection — so the success value stays unread here.
  */
 export type GoalActionResult = RemoteResult<unknown> | GoalLocalFailure;
+/** Process-local activation matched to one exact goal revision. */
+export interface GoalActivationSnapshot {
+    /** Exact current goal id, absent before create or after clear. */
+    readonly id?: GoalId;
+    /** Exact current revision for the activation edge. */
+    readonly revision?: number;
+    /** Process-local continuation state; absent while no matching edge is known. */
+    readonly activation?: GoalActivation;
+}
+/** Registrant-private observable source bound by the slot renderer. */
+export interface GoalActivationInjected {
+    readonly hooks: {
+        readonly goalActivation: HostObservable<GoalActivationSnapshot>;
+    };
+}
 /** Injected business face of the GoalBar dock entry: the mutation verbs (function properties: the strip destructures them freely). */
 export interface GoalBarActions {
     /**
@@ -38,4 +55,6 @@ export interface GoalBarActions {
     /** Clear the current goal (tombstone). */
     onClear: () => Promise<GoalActionResult>;
 }
+/** Injected business face of the GoalBar dock entry. */
+export type GoalBarInjected = GoalBarActions & GoalActivationInjected;
 //# sourceMappingURL=slots.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-client-ui-goal",
   "description": "Session goal surface: GoalBar docked above the composer, read from the goal session projection",
-  "version": "0.1.3-alpha.2",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -48,21 +48,21 @@
     "@types/react": "~18.3.1",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-chat": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-test-runtime": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-commands": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-goal": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-chat": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-commands": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-goal": "^0.1.5-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.3-alpha.2"
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.5-alpha.2"
   },
   "files": [
     "lib/index.js",