@prettier-ai/dsh-client-ui-goal 0.1.2-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DeepSeek
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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: 05c44fee27f0500c6a5d53496fde3d447edbf424
+README.zh.md: f280356eb37b364f49851ca24d73370eb62e6795

package/README.md

@@ -0,0 +1,90 @@
+---
+description: "Goal surface for the Web GUI: the composer-context strip that shows the current goal and edits, pauses, resumes, or clears it; for users and maintainers of the goal experience."
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-client-ui-goal
+
+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.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+-----
+
+<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.
+
+### The command-input bubble
+
+Each durable `/goal` run projects as a right-aligned monospace user-style bubble labeled `Command input` (or `指令输入`), rendered before the generic command result row. It carries no timestamp, copy, or branch actions, and reloading reconstructs it from the run.
+
+### Failures
+
+A rejected mutation surfaces the Remote error inline on the strip; loading, absent, completed, and successfully cleared goals render nothing.
+
+-----
+
+<a id="understand-the-implementation"></a>
+## Understand the implementation
+
+<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.
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## Further Exploration
+
+Read these pages when the goal surface is not enough. They move from the browser strip to the goal domain and the slots it fills.
+
+- [dsh-goal](../../goal/goal/README.md) — the goal domain, projection, and `/goal` command this surface reads and mutates.
+- [ui-conversation](../ui-conversation/README.md) — declares the `conversation.input.dock` slot and owns the composer.
+- [Client package map](../README.md) — adjacent browser UI packages.
+
+-----
+
+<a id="model-experience"></a>
+## Model Experience
+
+Indirectly, through the `goals/edit`, `goals/pause`, `goals/resume`, and `goals/clear` mutations the strip routes; the host GoalService owns the model-visible goal context message those mutations queue.
+
+#### 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
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+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>
+### Dev Note
+
+<details>
+<summary>Working context for maintainers — click to expand</summary>
+
+None.
+
+</details>

package/README.zh.md

@@ -0,0 +1,90 @@
+---
+description: "Web GUI 的 goal 表面：显示当前目标并支持编辑、暂停、恢复或清除的 composer 上下文条带；供 goal 体验的用户与维护者阅读。"
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-client-ui-goal
+
+[English](README.md) | 中文
+
+## 概述
+
+本包在 Web GUI 中渲染 goal 表面：composer 上下文堆栈里的一条条带，显示会话的当前目标，并提供编辑、暂停、恢复与清除动作。它从宿主计算的投影读取活目标，把每次变更都经 goal 服务路由，并把拒绝内联呈现。它还把每条持久的 `/goal` 命令运行投影为聊天中的 `Command input` 气泡，让用户或模型输入的 goal 命令出现在文本记录中。goal 创建不归本插件。除 `minimal` 外，随附的 Web preset 都会在其 agent scope 中挂载 `/goal`。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与延期工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+-----
+
+<a id="use-this-package"></a>
+## 使用本包
+
+与 `ui-conversation` 及 goal 领域包一起挂载本插件；只要会话存在目标，条带就会作为 composer 上下文堆栈的第二张卡片出现（位于 Todo 之后、Queue 之前）。active 的 goal 提供暂停动作；paused 的提供恢复；编辑重写目标文本；清除移除目标，并在投影追上之前抑制条带。
+
+### 指令输入气泡
+
+每条持久的 `/goal` 运行都投影为一个右对齐的等宽用户样式气泡，标签为 `Command input`（或 `指令输入`），渲染在通用命令结果行之前。它不含时间戳、复制或分支操作，重新加载时会依据运行记录重建。
+
+### 失败
+
+被拒绝的变更会把 Remote 错误内联呈现到条带上；加载中、无目标、已完成与成功清除的目标一律不渲染。
+
+-----
+
+<a id="understand-the-implementation"></a>
+## 理解实现
+
+<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` 或模型轮次。
+
+</details>
+
+-----
+
+<a id="further-exploration"></a>
+## 进一步探索
+
+当 goal 表面不够用时阅读以下页面。它们从浏览器条带进入 goal 领域与它所填充的槽位。
+
+- [dsh-goal](../../goal/goal/README.zh.md)——本表面读取并变更的 goal 领域、投影与 `/goal` 命令。
+- [ui-conversation](../ui-conversation/README.zh.md)——声明 `conversation.input.dock` 槽位并拥有 composer。
+- [客户端包映射](../README.zh.md)——相邻的浏览器 UI 包。
+
+-----
+
+<a id="model-experience"></a>
+## 模型体验
+
+间接影响：条带路由 `goals/edit`、`goals/pause`、`goals/resume` 与 `goals/clear` 变更；宿主 GoalService 拥有这些变更排队的模型可见 goal 上下文消息。
+
+#### KV Cache 影响
+
+除非已排队的 goal 上下文获准，否则没有影响。获准的上下文会像其他消息一样扩展历史尾部；准入前被丢弃的插入项不会影响缓存。
+
+## 已知限制与延期工作
+
+<a id="known-limitations-and-deferred-work"></a>
+
+
+这些限制界定了当前 goal 表面。它们是当前包约束，不是 goal 领域对比或任务积压。
+
+- **只反映持久阶段**——投影省略进程本地的激活状态，因此条带无法区分已激活但未武装的 goal 与已武装的 goal；恢复经 RPC 侧重新武装。不存在宿主实时激活通道。
+- **Host 状态与 preset 无关**——把活跃会话切换到 `minimal` 后，Host 拥有的 goal 仍会保留。`/goal` 与 goal 工具会消失，但该条带仍可编辑、暂停、恢复或清除 goal。
+
+<a id="dev-note"></a>
+### 开发备注
+
+<details>
+<summary>维护者的工作上下文——点击展开</summary>
+
+无。
+
+</details>

package/lib/client.js

@@ -0,0 +1,448 @@
+window.__ModuleLoader__.load({
+	id: "@prettier-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 _prettier_ai_dsh_client_ui_primitives = require("@prettier-ai/dsh-client-ui-primitives");
+		//#region \0dsh-css:/home/runner/work/dsh-publisher/dsh-publisher/upstream/packages/client/ui-goal/src/client/GoalBar.module.css.mjs
+		const css$1 = ".pLGJta_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}.pLGJta_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}.pLGJta_goalGlyph{color:var(--dsw-alias-label-tertiary);flex:none;display:inline-flex}.pLGJta_label{color:var(--dsw-alias-label-primary);flex:none;font-size:13px;font-weight:500;line-height:24px}.pLGJta_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}.pLGJta_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}.pLGJta_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}.pLGJta_objectiveInput:focus{border-color:var(--dsw-alias-state-business-primary)}.pLGJta_objectiveInput::placeholder{color:var(--dsw-alias-label-caption)}.pLGJta_actions{flex:none;align-items:center;gap:10px;display:flex}.pLGJta_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}.pLGJta_iconBtn:hover{background:var(--dsw-alias-interactive-bg-hover);color:var(--dsw-alias-label-secondary)}.pLGJta_iconBtn:disabled{opacity:.4;cursor:default}";
+		const tagId$1 = "@prettier-ai/dsh-client-ui-goal/GoalBar.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 = "@prettier-ai/dsh-client-ui-goal";
+			tag.dataset.pluginCss = tagId$1;
+			tag.textContent = css$1;
+			document.head.appendChild(tag);
+		}
+		var GoalBar_module_css_default = {
+			"actions": "pLGJta_actions",
+			"bar": "pLGJta_bar",
+			"dock": "pLGJta_dock",
+			"error": "pLGJta_error",
+			"goalGlyph": "pLGJta_goalGlyph",
+			"iconBtn": "pLGJta_iconBtn",
+			"label": "pLGJta_label",
+			"objective": "pLGJta_objective",
+			"objectiveInput": "pLGJta_objectiveInput"
+		};
+		//#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)(_prettier_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)(_prettier_ai_dsh_client_ui_primitives.IconCheckOutline16, { size: 14 })
+								})
+							}), (0, react_jsx_runtime.jsx)(_prettier_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)(_prettier_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)(_prettier_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)(_prettier_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)(_prettier_ai_dsh_client_ui_primitives.IconPauseOutline16, { size: 14 })
+									})
+								}),
+								goal.phase === "paused" && (0, react_jsx_runtime.jsx)(_prettier_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)(_prettier_ai_dsh_client_ui_primitives.IconPlayOutline16, { size: 14 })
+									})
+								}),
+								(0, react_jsx_runtime.jsx)(_prettier_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)(_prettier_ai_dsh_client_ui_primitives.IconEditOutline16, { size: 14 })
+									})
+								}),
+								(0, react_jsx_runtime.jsx)(_prettier_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)(_prettier_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 \0dsh-css:/home/runner/work/dsh-publisher/dsh-publisher/upstream/packages/client/ui-goal/src/client/GoalCommandInputView.module.css.mjs
+		const css = ".D3Tq-q_row{flex-direction:column;align-items:flex-end;gap:6px;display:flex}.D3Tq-q_stack{min-width:0;max-width:min(calc(var(--dsh-chat-content-width,748px) * .702), 82%);flex-direction:column;align-items:flex-end;display:flex}.D3Tq-q_bubble{overflow-wrap:anywhere;background:var(--dsw-specific-bubble);max-width:100%;color:var(--dsw-alias-label-primary);font:var(--dsw-font-markdown-code);font-size:var(--dsh-content-font-size,14px);line-height:calc(22px + var(--dsh-content-font-delta,0px));white-space:pre-wrap;border-radius:22px;padding:10px 16px}";
+		const tagId = "@prettier-ai/dsh-client-ui-goal/GoalCommandInputView.module.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const tag = document.createElement("style");
+			tag.dataset.plugin = "@prettier-ai/dsh-client-ui-goal";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var GoalCommandInputView_module_css_default = {
+			"bubble": "D3Tq-q_bubble",
+			"row": "D3Tq-q_row",
+			"stack": "D3Tq-q_stack"
+		};
+		//#endregion
+		//#region lib/types/client/GoalCommandInputView.js
+		/** Right-aligned `/goal` input bubble without ordinary message actions. */
+		const GoalCommandInputView = (0, react.memo)(function GoalCommandInputView({ node, t }) {
+			const data = node.data;
+			return (0, react_jsx_runtime.jsx)("div", {
+				className: GoalCommandInputView_module_css_default.row,
+				"data-command-input": "",
+				role: "group",
+				"aria-label": t("commandInput.aria"),
+				children: (0, react_jsx_runtime.jsx)("div", {
+					className: GoalCommandInputView_module_css_default.stack,
+					children: (0, react_jsx_runtime.jsx)("div", {
+						className: GoalCommandInputView_module_css_default.bubble,
+						children: (0, react_jsx_runtime.jsx)(_prettier_ai_dsh_client_ui_primitives.MessageText, { text: data.text })
+					})
+				})
+			});
+		});
+		//#endregion
+		//#region lib/types/client/goal-command-input.js
+		/**
+		* Derive the visible command line from its structured durable run.
+		* @param event - `/goal` command run.
+		* @returns command text with trailing parser whitespace removed.
+		*/
+		function goalCommandText(event) {
+			return `/${event.data.name}${(event.data.args ?? "").trimEnd()}`;
+		}
+		/** Goal-owned command input projection; the generic command Definition retains the result row. */
+		const goalCommandInputDefinition = {
+			kind: "goal-command-input",
+			target: "chat",
+			match: (event) => event.type === "command/run" && event.data.name === "goal" ? {
+				id: String(event.data.commandId),
+				role: "start"
+			} : null,
+			start: (_context, match) => {
+				if (match.event.type !== "command/run") throw new Error("goal-command-input start requires command/run");
+				return {
+					commandId: match.event.data.commandId,
+					seq: match.event.seq,
+					time: match.event.time,
+					text: goalCommandText(match.event)
+				};
+			},
+			update: (context) => context.state,
+			buildViewNode: (context) => {
+				if (context.state === void 0) return null;
+				return {
+					key: context.key,
+					kind: "command-input",
+					id: context.id,
+					target: "chat",
+					anchorSeq: context.state.seq - .1,
+					location: context.start?.location ?? { kind: "unresolved" },
+					visibility: "visible",
+					data: {
+						commandId: context.state.commandId,
+						text: context.state.text,
+						time: context.state.time
+					}
+				};
+			}
+		};
+		//#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": "目标内容",
+			"commandInput.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",
+			"commandInput.aria": "Command input",
+			"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 for the Goal dock, command-input projection, Remote mutations, and copy. */
+		const inject = [
+			"slots",
+			"sessions",
+			"remote",
+			"remote.goals",
+			"locale",
+			"uiConversation"
+		];
+		/**
+		* Client plugin body: the GoalBar dock entry with its mutation verbs.
+		* @param ctx - client root context.
+		*/
+		function apply(ctx) {
+			ctx.uiConversation.events.register(goalCommandInputDefinition);
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-goal: dictionaries");
+			ctx.slots.inject("conversation.chat.node", () => ctx.slots.register({
+				name: "conversation.chat.node",
+				key: "command-input",
+				locale: NS
+			}, GoalCommandInputView));
+			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",
+					details: {}
+				}
+			};
+			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 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
+		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 `@prettier-ai/dsh-client-ui-goal`.
+* @module @prettier-ai/dsh-client-ui-goal/invariant
+*/
+const PACKAGE_NAME = "@prettier-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 '@prettier-ai/dsh-goal/client';
+import type { PropsLocale } from '@prettier-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('@prettier-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/GoalCommandInputView.d.ts

@@ -0,0 +1,6 @@
+import type { PropsLocale, PropsRuntime } from '@prettier-ai/dsh-client-ui-slots';
+type GoalCommandInputViewProps = PropsRuntime<'conversation.chat.node', 'command-input'> & PropsLocale<'goal'>;
+/** Right-aligned `/goal` input bubble without ordinary message actions. */
+export declare const GoalCommandInputView: import("react").MemoExoticComponent<({ node, t, }: GoalCommandInputViewProps) => import("react").JSX.Element>;
+export {};
+//# sourceMappingURL=GoalCommandInputView.d.ts.map

package/lib/types/client/goal-command-input.d.ts

@@ -0,0 +1,28 @@
+import type { SessionEvent } from '@prettier-ai/dsh-session/types';
+import type { CommandId } from '@prettier-ai/dsh-commands/brand';
+import type { ConversationNodeDefinition } from '@prettier-ai/dsh-client-ui-conversation/client';
+/** Goal-owned human command input projected independently of model messages. */
+export interface GoalCommandInputData {
+    readonly commandId: CommandId;
+    readonly text: string;
+    readonly time: number;
+}
+declare module '@prettier-ai/dsh-client-ui-chat/client' {
+    interface ChatNodeDataMap {
+        /** Human-entered `/goal` command input. */
+        'command-input': GoalCommandInputData;
+    }
+}
+interface GoalCommandInputState extends GoalCommandInputData {
+    readonly seq: number;
+}
+/**
+ * Derive the visible command line from its structured durable run.
+ * @param event - `/goal` command run.
+ * @returns command text with trailing parser whitespace removed.
+ */
+export declare function goalCommandText(event: SessionEvent<'command/run'>): string;
+/** Goal-owned command input projection; the generic command Definition retains the result row. */
+export declare const goalCommandInputDefinition: ConversationNodeDefinition<GoalCommandInputState>;
+export {};
+//# sourceMappingURL=goal-command-input.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.
+ * This plugin does not create goals; deployments may expose /goal separately.
+ */
+import type { Context as ClientContext } from '@prettier-ai/cordis';
+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 '@prettier-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** The goal strip's copy. */
+        goal: GoalKey;
+    }
+}
+/** Required services for the Goal dock, command-input projection, Remote mutations, and 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,32 @@
+/** `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;
+    'commandInput.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;
+    'commandInput.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,30 @@
+/**
+ * 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).
+ */
+import type { RemoteResult } from '@prettier-ai/dsh-typert-protocol';
+/**
+ * Settled outcome of one goal mutation, rendered inline by the strip. The
+ * strip renders the failure only — the mutated goal arrives through the
+ * projection — so the success value stays unread here.
+ */
+export type GoalActionResult = RemoteResult<unknown>;
+/** 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 `@prettier-ai/dsh-client-ui-goal`.
+ * @module @prettier-ai/dsh-client-ui-goal/invariant
+ */
+import type { Context } from '@prettier-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,94 @@
+{
+  "name": "@prettier-ai/dsh-client-ui-goal",
+  "description": "Session goal surface: GoalBar docked above the composer, read from the goal session projection",
+  "version": "0.1.2-alpha.1",
+  "publishConfig": {
+    "access": "public"
+  },
+  "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": [
+        "@prettier-ai/dsh-api-remotes",
+        "@prettier-ai/dsh-api-session-controller",
+        "@prettier-ai/dsh-client-locale",
+        "@prettier-ai/dsh-client-ui-chat",
+        "@prettier-ai/dsh-client-ui-conversation",
+        "@prettier-ai/dsh-client-ui-renderer",
+        "@prettier-ai/dsh-client-ui-session"
+      ],
+      "platform": "web"
+    }
+  },
+  "license": "MIT",
+  "peerDependencies": {
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-chat": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-goal": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-commands": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.1.0",
+    "@types/react": "~18.3.1",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "@prettier-ai/dsh-api-remotes": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-api-session-controller": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-locale": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-test-runtime": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-chat": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-conversation": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-primitives": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-slots": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-renderer": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-client-ui-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-goal": "^0.1.2-alpha.1",
+    "@prettier-ai/cordis": "^4.0.1",
+    "@prettier-ai/dsh-commands": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-invariants": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-session": "^0.1.2-alpha.1",
+    "@prettier-ai/dsh-typert-protocol": "^0.1.2-alpha.1"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}