@deepseek-ai/dsh-client-ui-goal 0.0.1-rc.1

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
+# 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: a53fb3a89eaee364cb025ca728ca42ce934887b0
+README.zh.md: 1ad9f50aee5b103f6455e4d4b7d29fa9eb29a108

package/README.md

@@ -0,0 +1,19 @@
+# @deepseek-ai/dsh-client-ui-goal
+
+English | [中文](README.zh.md)
+
+Goal surface plugin, browser half: the `GoalBar` strip is the second standalone card in the `conversation.input.dock` composer-context stack (order 10, after Todo and before Queue). The live goal arrives through `useProjection('goal')` — the host-computed whole value 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 slot inject face carries only the four mutation verbs (edit / pause / resume / clear through `ctx.remote.goals` — an active goal offers the pause action, a paused one resume); each reads the CAS ref from the session's current projected value at call time and surfaces the rejected Remote error inline. The strip single-flights mutations synchronously because React's pending render cannot fence same-frame clicks; after a successful clear it immediately suppresses that exact goal id while the authoritative null projection catches up. Goal creation stays on the `/goal` host command; loading, absent, completed, and successfully cleared goals render nothing.
+
+The `/client` export surface is the plugin body (`apply`/`inject`), the `GoalBar`/`GoalDock` components, and the injected verb face types.
+
+## Model Experience
+
+Indirectly, through the `goals/edit`, `goals/pause`, `goals/resume`, and `goals/clear` Remote methods the strip invokes: each accepted mutation commits in a durable `agent/inbox/spliced` insertion, which the goal projection folds immediately, and queues a `goal/change` context message. The model sees that context only if a later pre-step admits it; discarding the queued message does not roll back the projected state. The strip itself adds no prompt content.
+
+#### KV Cache effect
+
+None unless the queued goal context is admitted. An admitted context extends the history tail like any other message; an insertion discarded before admission does not affect the cache.
+
+## Known Limitations and Deferred Work
+
+- **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.

package/README.zh.md

@@ -0,0 +1,19 @@
+# @deepseek-ai/dsh-client-ui-goal
+
+[English](README.md) | 中文
+
+Goal 界面插件（浏览器端部分）：`GoalBar` 条带是 `conversation.input.dock` composer 上下文堆栈中的第二张独立卡片（order 10，位于 Todo 之后、Queue 之前）。活值经 `useProjection('goal')` 到达——host 计算的全量值由历史尾页播种、由 `session/projection` 帧更新——因此本插件不持有领域 store、不设刷新链、不挂事件监听。slot 注入面只携带四个变更动词（edit / pause / resume / clear，经 `ctx.remote.goals` 调用——active 的 goal 提供暂停动作，paused 的提供恢复）；每个动词在调用时从会话当前投影值读取 CAS ref，并将 Remote 调用的拒绝错误内联呈现。由于 React 的 pending 渲染无法拦住同一帧内的点击，横条会同步为变更建立 single-flight 防护；清除成功后，会立即抑制该 goal id 对应的目标显示，直到权威的 null 投影追上。goal 的创建仍归 `/goal` host 命令；加载中、无 goal、已完成和已成功清除的 goal 一律不渲染。
+
+`/client` 的导出接口包括插件本体（`apply`/`inject`）、`GoalBar`/`GoalDock` 组件与注入动词面类型。
+
+## 模型体验
+
+间接影响：条带通过调用 `goals/edit`、`goals/pause`、`goals/resume` 和 `goals/clear` Remote 方法提交变更；每次被接受的变更都会在持久 `agent/inbox/spliced` 插入项中提交，goal 投影会立即折叠该插入项，同时将一条 `goal/change` 上下文消息排队。只有后续 pre-step 准入该上下文时，模型才会看到它；丢弃已排队的消息不会回滚投影状态。条带自身不添加任何提示词内容。
+
+#### KV Cache 影响
+
+除非已排队的 goal 上下文获准，否则没有影响。获准的上下文会像其他消息一样扩展历史尾部；准入前被丢弃的插入项不会影响缓存。
+
+## 已知限制与暂缓事项
+
+- **只反映持久 phase**——投影省略进程本地 activation，因此条带无法区分 active-but-disarmed 与 armed 状态；resume 通过 RPC 重新置为 armed 状态。不存在 host 实时 activation 通道。

package/lib/client.js

@@ -0,0 +1,383 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-goal",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		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 \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-goal/src/client/GoalBar.module.css.mjs
+		const css = ".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:1px 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:1px solid var(--dsw-alias-border-l2);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{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 = "@deepseek-ai/dsh-client-ui-goal/GoalBar.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@deepseek-ai/dsh-client-ui-goal";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var GoalBar_module_css_default = {
+			"actions": "nLMEza_actions",
+			"goalGlyph": "nLMEza_goalGlyph",
+			"dock": "nLMEza_dock",
+			"objectiveInput": "nLMEza_objectiveInput",
+			"objective": "nLMEza_objective",
+			"error": "nLMEza_error",
+			"label": "nLMEza_label",
+			"bar": "nLMEza_bar",
+			"iconBtn": "nLMEza_iconBtn"
+		};
+		//#endregion
+		//#region lib/types/client/GoalBar.js
+		/**
+		* 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.
+		*/
+		/** Strip label keys per visible phase; complete goals render nothing. */
+		const PHASE_LABELS = {
+			active: "phase.active",
+			paused: "phase.paused",
+			blocked: "phase.blocked"
+		};
+		function GoalBar({ goal, 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);
+			const [actionError, setActionError] = (0, react.useState)(null);
+			const [clearedGoalId, setClearedGoalId] = (0, react.useState)(null);
+			const pendingRef = (0, react.useRef)(false);
+			const goalId = goal?.id;
+			(0, react.useEffect)(() => {
+				setEditing(false);
+				setActionError(null);
+				setClearedGoalId(null);
+			}, [goalId]);
+			const runAction = (0, react.useCallback)(async (action) => {
+				if (pendingRef.current) return void 0;
+				pendingRef.current = true;
+				setPending(true);
+				setActionError(null);
+				const result = await action();
+				pendingRef.current = false;
+				setPending(false);
+				if (!result.ok) setActionError(`${result.error.message} (${result.error.code})`);
+				return result;
+			}, []);
+			const handleEdit = (0, react.useCallback)(async () => {
+				const trimmed = draft.trim();
+				if (trimmed === "") return;
+				if ((await runAction(() => onEdit(trimmed)))?.ok) setEditing(false);
+			}, [
+				draft,
+				onEdit,
+				runAction
+			]);
+			const handleClear = (0, react.useCallback)(async (clearedId) => {
+				if ((await runAction(onClear))?.ok) setClearedGoalId(clearedId);
+			}, [onClear, runAction]);
+			if (goal === void 0 || goal === null || goal.phase === "complete" || goal.id === clearedGoalId) return null;
+			if (editing) return (0, react_jsx_runtime.jsx)("div", {
+				className: GoalBar_module_css_default.dock,
+				"data-goal-bar": true,
+				children: (0, react_jsx_runtime.jsxs)("div", {
+					className: GoalBar_module_css_default.bar,
+					children: [
+						(0, react_jsx_runtime.jsx)("input", {
+							className: GoalBar_module_css_default.objectiveInput,
+							type: "text",
+							"aria-label": t("objective.aria"),
+							value: draft,
+							onChange: (e) => {
+								setDraft(e.target.value);
+							},
+							onKeyDown: (e) => {
+								if (e.key === "Enter") handleEdit();
+								if (e.key === "Escape") setEditing(false);
+							},
+							autoFocus: true
+						}),
+						actionError !== null && (0, react_jsx_runtime.jsx)("span", {
+							className: GoalBar_module_css_default.error,
+							role: "alert",
+							children: actionError
+						}),
+						(0, react_jsx_runtime.jsxs)("div", {
+							className: GoalBar_module_css_default.actions,
+							children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+								label: t("action.save"),
+								side: "bottom",
+								delayMs: 500,
+								children: (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: GoalBar_module_css_default.iconBtn,
+									onClick: () => {
+										handleEdit();
+									},
+									disabled: pending || draft.trim() === "",
+									"aria-label": t("action.save"),
+									children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline16, { size: 14 })
+								})
+							}), (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+								label: t("action.cancel"),
+								side: "bottom",
+								delayMs: 500,
+								children: (0, react_jsx_runtime.jsx)("button", {
+									type: "button",
+									className: GoalBar_module_css_default.iconBtn,
+									onClick: () => {
+										setEditing(false);
+									},
+									disabled: pending,
+									"aria-label": t("action.cancel"),
+									children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, { size: 14 })
+								})
+							})]
+						})
+					]
+				})
+			});
+			const title = goal.phase === "blocked" ? goal.blockedReason?.message : void 0;
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: GoalBar_module_css_default.dock,
+				"data-goal-bar": true,
+				children: (0, react_jsx_runtime.jsxs)("div", {
+					className: GoalBar_module_css_default.bar,
+					title,
+					children: [
+						(0, react_jsx_runtime.jsx)("span", {
+							className: GoalBar_module_css_default.goalGlyph,
+							children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconGoalOutline16, { size: 14 })
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: GoalBar_module_css_default.label,
+							children: t(PHASE_LABELS[goal.phase])
+						}),
+						(0, react_jsx_runtime.jsx)("span", {
+							className: GoalBar_module_css_default.objective,
+							children: goal.objective
+						}),
+						actionError !== null && (0, react_jsx_runtime.jsx)("span", {
+							className: GoalBar_module_css_default.error,
+							role: "alert",
+							children: actionError
+						}),
+						(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, {
+									label: t("action.pause"),
+									side: "bottom",
+									delayMs: 500,
+									children: (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: GoalBar_module_css_default.iconBtn,
+										disabled: pending,
+										onClick: () => {
+											runAction(onPause);
+										},
+										"aria-label": t("action.pause"),
+										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, {
+									label: t("action.resume"),
+									side: "bottom",
+									delayMs: 500,
+									children: (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: GoalBar_module_css_default.iconBtn,
+										disabled: pending,
+										onClick: () => {
+											runAction(onResume);
+										},
+										"aria-label": t("action.resume"),
+										children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPlayOutline16, { size: 14 })
+									})
+								}),
+								(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+									label: t("action.edit"),
+									side: "bottom",
+									delayMs: 500,
+									children: (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: GoalBar_module_css_default.iconBtn,
+										disabled: pending,
+										onClick: () => {
+											setDraft(goal.objective);
+											setEditing(true);
+										},
+										"aria-label": t("action.edit"),
+										children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 })
+									})
+								}),
+								(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+									label: t("action.clear"),
+									side: "bottom",
+									delayMs: 500,
+									children: (0, react_jsx_runtime.jsx)("button", {
+										type: "button",
+										className: GoalBar_module_css_default.iconBtn,
+										disabled: pending,
+										onClick: () => {
+											handleClear(goal.id);
+										},
+										"aria-label": t("action.clear"),
+										children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconTrashOutline16, { size: 14 })
+									})
+								})
+							]
+						})
+					]
+				})
+			});
+		}
+		/** Dock adapter: reads the host-computed 'goal' projection (whole value; absent or null renders nothing). */
+		function GoalDock({ useProjection, onEdit, onPause, onResume, onClear, t }) {
+			const projection = useProjection("goal");
+			return (0, react_jsx_runtime.jsx)(GoalBar, {
+				goal: projection === void 0 ? void 0 : projection === null ? null : projection.goal,
+				onEdit,
+				onPause,
+				onResume,
+				onClear,
+				t
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `goal` namespace dictionaries. */
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"phase.active": "进行中的目标",
+			"phase.paused": "已暂停的目标",
+			"phase.blocked": "受阻的目标",
+			"objective.aria": "目标内容",
+			"action.save": "保存目标",
+			"action.cancel": "取消编辑",
+			"action.pause": "暂停目标",
+			"action.resume": "恢复目标",
+			"action.edit": "编辑目标",
+			"action.clear": "清除目标"
+		};
+		/** English dictionary, checked complete against the zh key set. */
+		const en = {
+			"phase.active": "Ongoing Goal",
+			"phase.paused": "Paused Goal",
+			"phase.blocked": "Blocked Goal",
+			"objective.aria": "Goal objective",
+			"action.save": "Save goal",
+			"action.cancel": "Cancel edit",
+			"action.pause": "Pause goal",
+			"action.resume": "Resume goal",
+			"action.edit": "Edit goal",
+			"action.clear": "Clear goal"
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "goal";
+		/** Required services: slots for the dock entry, sessions for the projected ref, API for Remote mutations, locale for the copy. */
+		const inject = [
+			"slots",
+			"sessions",
+			"remote",
+			"remote.goals",
+			"locale"
+		];
+		/** Map one generated Remote call, including synchronous namespace lookup failures, to the fields rendered by the goal strip. */
+		async function settle(invoke) {
+			try {
+				await invoke();
+				return { ok: true };
+			} catch (error) {
+				const cause = error instanceof Error ? error.cause : void 0;
+				if (isRemoteError(cause)) return {
+					ok: false,
+					error: {
+						code: cause.code,
+						message: cause.message
+					}
+				};
+				return {
+					ok: false,
+					error: {
+						code: "internal",
+						message: error instanceof Error ? error.message : "goal mutation failed"
+					}
+				};
+			}
+		}
+		function isRemoteError(value) {
+			return value !== null && typeof value === "object" && typeof value.code === "string" && typeof value.message === "string";
+		}
+		/**
+		* Client plugin body: the GoalBar dock entry with its mutation verbs.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-goal: dictionaries");
+			const sessions = ctx.sessions;
+			/** The session's current projected CAS ref, read at verb call time (no staleness fence: the RPC's CAS is the guard). */
+			const refOf = (sessionId) => {
+				const projection = (sessions.binding(sessionId)?.session.projections.faceOf("goal"))?.getSnapshot();
+				if (projection == null) return void 0;
+				return {
+					id: projection.goal.id,
+					revision: projection.goal.revision
+				};
+			};
+			const noCurrentGoal = {
+				ok: false,
+				error: {
+					code: "no-current-goal",
+					message: "no current goal to mutate"
+				}
+			};
+			ctx.slots.inject("conversation.input.dock", () => ctx.slots.register({
+				name: "conversation.input.dock",
+				id: "goal",
+				order: 10,
+				locale: NS,
+				inject: (sessionId) => ({
+					onEdit: async (objective) => {
+						const ref = refOf(sessionId);
+						if (ref === void 0) return noCurrentGoal;
+						return settle(() => ctx.remote.goals.edit(sessionId, ref, { objective }));
+					},
+					onPause: async () => {
+						const ref = refOf(sessionId);
+						if (ref === void 0) return noCurrentGoal;
+						return settle(() => ctx.remote.goals.pause(sessionId, ref));
+					},
+					onResume: async () => {
+						const ref = refOf(sessionId);
+						if (ref === void 0) return noCurrentGoal;
+						return settle(() => ctx.remote.goals.resume(sessionId, ref));
+					},
+					onClear: async () => {
+						const ref = refOf(sessionId);
+						if (ref === void 0) return noCurrentGoal;
+						return settle(() => ctx.remote.goals.clear(sessionId, ref));
+					}
+				})
+			}, GoalDock));
+		}
+		//#endregion
+		exports.GoalBar = GoalBar;
+		exports.GoalDock = GoalDock;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,11 @@
+//#region lib/types/index.js
+/**
+* Goal surface plugin, node half. Pure UI plugin: the empty apply exists so
+* the plugin appears in the host cordis.yml / Loader; the browser half
+* ships via exports["./client"], discovered through the package.json
+* dsh.client declaration.
+*/
+/** Host plugin body — no host-side behavior for this surface plugin. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,25 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-goal`.
+* @module @deepseek-ai/dsh-client-ui-goal/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-goal";
+/** Cordis companion plugin name. */
+const name = "client-ui-goal-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: 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.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,22 @@
+/**
+ * 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.
+ */
+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';
+export interface GoalBarProps extends GoalBarActions {
+    /** Current goal snapshot; undefined = capability absent or loading, null = no goal set. */
+    goal: GoalSnapshot | null | undefined;
+}
+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;
+//# sourceMappingURL=GoalBar.d.ts.map

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

@@ -0,0 +1,29 @@
+/**
+ * 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.
+ * Goal creation stays on the /goal host command.
+ */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type GoalKey } from './locales.ts';
+export { GoalBar, GoalDock } from './GoalBar.tsx';
+export type { GoalActionResult, GoalBarActions } from './slots.ts';
+export type { GoalKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The goal strip's copy. */
+        goal: GoalKey;
+    }
+}
+/** Required services: slots for the dock entry, sessions for the projected ref, API for Remote mutations, locale for the copy. */
+export declare const inject: string[];
+/**
+ * Client plugin body: the GoalBar dock entry with its mutation verbs.
+ * @param ctx - client root context.
+ */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,30 @@
+/** `goal` namespace dictionaries. */
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'phase.active': string;
+    'phase.paused': string;
+    'phase.blocked': string;
+    'objective.aria': string;
+    'action.save': string;
+    'action.cancel': string;
+    'action.pause': string;
+    'action.resume': string;
+    'action.edit': string;
+    'action.clear': string;
+};
+/** The goal namespace key union. */
+export type GoalKey = keyof typeof zh;
+/** English dictionary, checked complete against the zh key set. */
+export declare const en: {
+    'phase.active': string;
+    'phase.paused': string;
+    'phase.blocked': string;
+    'objective.aria': string;
+    'action.save': string;
+    'action.cancel': string;
+    'action.pause': string;
+    'action.resume': string;
+    'action.edit': string;
+    'action.clear': string;
+};
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,33 @@
+/**
+ * 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).
+ */
+/** Settled outcome of one goal mutation, rendered inline by the strip. */
+export type GoalActionResult = {
+    ok: true;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+    };
+};
+/** Injected business face of the GoalBar dock entry: the mutation verbs (function properties: the strip destructures them freely). */
+export interface GoalBarActions {
+    /**
+     * Replace the current goal's objective (CAS on the projected ref).
+     * @param objective - replacement objective text.
+     */
+    onEdit: (objective: string) => Promise<GoalActionResult>;
+    /** Pause an active goal. */
+    onPause: () => Promise<GoalActionResult>;
+    /** Resume a paused goal. */
+    onResume: () => Promise<GoalActionResult>;
+    /** Clear the current goal (tombstone). */
+    onClear: () => Promise<GoalActionResult>;
+}
+//# sourceMappingURL=slots.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Goal surface plugin, node half. Pure UI plugin: the empty apply exists so
+ * the plugin appears in the host cordis.yml / Loader; the browser half
+ * ships via exports["./client"], discovered through the package.json
+ * dsh.client declaration.
+ */
+/** Host plugin body — no host-side behavior for this surface plugin. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-client-ui-goal`.
+ * @module @deepseek-ai/dsh-client-ui-goal/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-goal-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@deepseek-ai/dsh-client-ui-goal",
+  "description": "Session goal surface: GoalBar docked above the composer, read from the goal session projection",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-goal"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "BSD-3-Clause",
+  "peerDependencies": {
+    "react": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-goal": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-api-remotes": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-goal": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}