@deepseek-ai/dsh-client-ui-workflow-run 0.0.1-rc.2

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-workflow-run/README.md
+README.md: 66539e0c16ac4102f9e1fe881106e6881b36a7d5
+README.zh.md: a803857af24802e8a4645c4d5aca56c04424c85e

package/README.md

@@ -0,0 +1,35 @@
+# @deepseek-ai/dsh-client-ui-workflow-run
+
+English | [中文](README.zh.md)
+
+The browser plugin that reconstructs durable top-level workflow runs as independent Chat nodes. It consumes the four `tool-workflow/*` Session events owned by [`dsh-tool-workflow`](../../workflow/tool-workflow/README.md), registers one `ConversationNodeDefinition`, and renders through the keyed `conversation.chat.node` slot without changing the existing workflow tool card.
+
+## Durable state and replay
+
+`tool-workflow/run-start` creates one Context keyed by `runId`; member starts, member endings, and the run ending update that Context in log order. A history tail containing only updates remains pending until an older page supplies the unique start, after which prepend, complete replay, and live append produce the same state. A closed Turn or Step with missing terminal events presents the affected run or members as interrupted without changing the tool result.
+
+Phase groups come only from members that actually started. Exact phase strings share a group, an omitted phase is distinct from the empty string, and settlement changes status without removing or reordering members.
+
+## Presentation and navigation
+
+The run and each phase have independent disclosure state. The run uses a 32-pixel `--dsw-alias-bg-module-platform` row with persistent right/down chevrons and an inline state dot plus status text, without a badge. Phases use 32-pixel disclosure rows with title and member count in the flexible main area and a fixed precise aggregate-status tail, without another dot. Members use a 16-pixel dot slot, a truncating name area, and a fixed 64-pixel status column. A running run initially expands; a terminal run loaded from history initially collapses. Local choices survive data updates while the keyed node remains mounted and reset only on a full remount.
+
+A member opens a child Session only while every current fact agrees: the member is running, the child id is in the ordinary Session list, the row has `origin: 'subagent'`, its `parentId` is the current Session, and the list row is still running. Underlined member text is the only visible navigation affordance; keyboard focus draws a two-pixel business-primary ring around the name area, while status copy remains `Running`. The component calls only the injected ordinary `sessions.open(id)` action; remote, addressed-only, wrong-parent, or terminal rows remain non-interactive.
+
+## Composition
+
+The package registers its Definition, locale dictionary, and `workflow-run` renderer as Cordis effects. Removing the client entry retracts all three contributions. The shipped Web bundle includes the plugin after `ui-conversation` and `ui-tool`.
+
+## Model Experience
+
+None, as this package renders durable Session facts for humans and adds no prompt, tool schema, request content, or model-visible result.
+
+#### KV Cache effect
+
+None.
+
+## Known Limitations and Deferred Work
+
+- Only top-level calls through `dsh-tool-workflow` produce these records; nested Code Mode calls and direct `WorkflowService` consumers do not.
+- Navigation is intentionally live-only. Terminal members remain visible for review but never expose a cold-session opener from this node.
+- The node shows run, phase, member identity, and status only; scripts, outputs, errors, logs, usage, static topology, and controls remain outside this surface.

package/README.zh.md

@@ -0,0 +1,35 @@
+# @deepseek-ai/dsh-client-ui-workflow-run
+
+[English](README.md) | 中文
+
+这个浏览器插件把持久化的顶层工作流运行重建为独立 Chat 节点。它消费由 [`dsh-tool-workflow`](../../workflow/tool-workflow/README.md) 拥有的四类 `tool-workflow/*` Session 事件，注册一个 `ConversationNodeDefinition`，并通过 keyed `conversation.chat.node` slot 渲染，不改变现有工作流工具卡。
+
+## 持久状态与回放
+
+`tool-workflow/run-start` 以 `runId` 创建唯一 Context；成员开始、成员结束和运行结束事件按日志顺序更新该 Context。只有 update 的历史尾页会保持 pending，直到更早页面补入唯一 start；此后 prepend、完整回放和实时 append 得到相同状态。若所属 Turn 或 Step 已关闭但终点事件缺失，界面把相应运行或成员显示为已中断，而不改写工具结果。
+
+阶段组只来自真正开始过的成员。完全相同的阶段字符串归入同一组，字段缺省与空字符串保持不同身份；成员结算只改变状态，不删除或重排成员。
+
+## 展示与导航
+
+运行和每个阶段分别拥有本地 disclosure 状态。运行使用 32 像素 `--dsw-alias-bg-module-platform` 背景行，常驻向右／向下 chevron，并以内联状态点加状态文字表达结局，不使用胶囊。阶段使用 32 像素 disclosure 行，在可伸缩主区显示标题与成员数，在固定尾部精确显示聚合状态且不重复状态点。成员使用 16 像素状态点槽、可省略名称区和固定 64 像素状态列。运行中记录首次挂载时展开，从历史加载的终态记录首次挂载时折叠。只要 keyed 节点仍挂载，本地选择就在数据更新时保持；只有完整 remount 才重新初始化。
+
+只有所有实时事实同时成立时，成员才可打开子 Session：成员仍在运行、子 id 位于普通 Session 列表、列表行为 `origin: 'subagent'`、`parentId` 等于当前 Session，且列表行仍标记运行。带下划线的成员文字是唯一可见导航提示；键盘聚焦时，名称区显示 2 像素 business-primary 焦点环，右侧状态仍只显示“运行中”。组件只调用注入的普通 `sessions.open(id)`；远程、仅地址化、父级不符或终态的行都不可交互。
+
+## 装配
+
+本包把 Definition、locale 字典和 `workflow-run` renderer 都注册为 Cordis effect；移除客户端 entry 会撤销三者。shipped Web bundle 在 `ui-conversation` 与 `ui-tool` 之后装配该插件。
+
+## Model Experience
+
+无，因为本包只为人类展示持久 Session 事实，不增加 prompt、工具 schema、请求内容或模型可见结果。
+
+#### KV Cache effect
+
+无。
+
+## Known Limitations and Deferred Work
+
+- 只有经 `dsh-tool-workflow` 发起的顶层调用会生成这些记录；嵌套 Code Mode 调用和直接 `WorkflowService` 消费方不会生成。
+- 导航刻意只面向实时运行。终态成员继续保留供复盘，但本节点永不为其提供冷 Session 入口。
+- 节点只显示运行、阶段、成员身份与状态；脚本、输出、错误、日志、用量、静态拓扑和控制操作都不属于本界面。

package/lib/client.js

@@ -0,0 +1,457 @@
+window.__ModuleLoader__.load({
+	id: "@deepseek-ai/dsh-client-ui-workflow-run",
+	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");
+		let _deepseek_ai_dsh_client_runtime_client = require("@deepseek-ai/dsh-client-runtime/client");
+		//#region \0dsh-css:/home/runner/work/deepseek-harness/deepseek-harness/packages/client/ui-workflow-run/src/client/WorkflowRunPanel.module.css.mjs
+		const css = ".DBuyfa_root{width:100%;min-width:0}.DBuyfa_runHeader{box-sizing:border-box;background:var(--dsw-alias-bg-module-platform);cursor:pointer;border-radius:8px;align-items:center;gap:6px;width:100%;min-width:0;height:32px;padding:0 8px;display:flex}.DBuyfa_runHeader:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:-2px}.DBuyfa_runLeading{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;margin-right:0;display:inline-flex}.DBuyfa_runTitle{max-width:42%;color:var(--dsw-alias-label-secondary);text-overflow:ellipsis;white-space:nowrap;flex:none;font-size:14px;font-weight:510;line-height:24px;overflow:hidden}.DBuyfa_runSummary{min-width:0;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:12px;line-height:18px;overflow:hidden}.DBuyfa_statusTail{height:20px;color:var(--dsw-alias-label-secondary);white-space:nowrap;flex:none;align-items:center;gap:4px;font-size:11px;font-weight:510;line-height:16px;display:inline-flex;overflow:hidden}.DBuyfa_phaseHeader{box-sizing:border-box;cursor:pointer;align-items:center;gap:6px;width:100%;min-width:0;height:32px;display:flex}.DBuyfa_phaseHeader:focus-visible{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:-2px;border-radius:4px}.DBuyfa_phaseLeading{width:16px;height:16px;color:var(--dsw-alias-label-tertiary);flex:none;justify-content:center;align-items:center;margin-right:0;display:inline-flex}.DBuyfa_phaseTitle{min-width:0;max-width:42%;color:var(--dsw-alias-label-secondary);text-overflow:ellipsis;white-space:nowrap;flex:0 auto;font-size:14px;line-height:24px;overflow:hidden}.DBuyfa_phaseCount{min-width:0;color:var(--dsw-alias-label-tertiary);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:13px;line-height:20px;overflow:hidden}.DBuyfa_phaseStatus{width:132px;color:var(--dsw-alias-label-secondary);text-align:right;text-overflow:ellipsis;white-space:nowrap;flex:none;font-size:13px;line-height:20px;overflow:hidden}.DBuyfa_separator{background:var(--dsw-alias-label-tertiary);border-radius:50%;flex:none;width:2px;height:2px}.DBuyfa_phaseList{flex-direction:column;gap:4px;min-width:0;padding:4px 0 0 16px;display:flex}.DBuyfa_phase{min-width:0}.DBuyfa_members{flex-direction:column;gap:2px;min-width:0;padding:0 0 0 16px;display:flex}.DBuyfa_memberRow,.DBuyfa_memberButton{width:100%;min-width:0;min-height:24px;color:var(--dsw-alias-label-secondary);font:inherit;text-align:left;background:0 0;border:0;border-radius:4px;align-items:center;gap:12px;padding:0;display:flex}.DBuyfa_memberButton{cursor:pointer}.DBuyfa_memberButton .DBuyfa_memberLabel{color:var(--dsw-alias-state-business-primary);text-underline-position:from-font;text-decoration:underline}.DBuyfa_dotSlot{flex:none;justify-content:center;align-items:center;width:16px;height:24px;display:inline-flex;overflow:hidden}.DBuyfa_memberButton:focus-visible{outline:none}.DBuyfa_memberButton:focus-visible .DBuyfa_memberLabelWrap{outline:2px solid var(--dsw-alias-state-business-primary);outline-offset:-1px}.DBuyfa_memberLabelWrap{border-radius:4px;flex:1;align-items:center;min-width:0;height:24px;padding:0 2px;display:flex;overflow:hidden}.DBuyfa_memberLabel{min-width:0;color:var(--dsw-alias-label-secondary);text-overflow:ellipsis;white-space:nowrap;flex:1;font-size:14px;line-height:24px;overflow:hidden}.DBuyfa_memberStatus{width:64px;color:var(--dsw-alias-label-secondary);text-align:right;text-overflow:ellipsis;white-space:nowrap;flex:none;font-size:13px;line-height:20px;overflow:hidden}.DBuyfa_empty{color:var(--dsw-alias-label-tertiary);padding:0;font-size:13px;line-height:20px}@media (width<=560px){.DBuyfa_phaseList,.DBuyfa_members{padding-left:12px}}";
+		const tagId = "@deepseek-ai/dsh-client-ui-workflow-run/WorkflowRunPanel.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-workflow-run";
+			tag.dataset.pluginCss = tagId;
+			tag.textContent = css;
+			document.head.appendChild(tag);
+		}
+		var WorkflowRunPanel_module_css_default = {
+			"members": "DBuyfa_members",
+			"runLeading": "DBuyfa_runLeading",
+			"phaseLeading": "DBuyfa_phaseLeading",
+			"phaseTitle": "DBuyfa_phaseTitle",
+			"separator": "DBuyfa_separator",
+			"memberLabel": "DBuyfa_memberLabel",
+			"runSummary": "DBuyfa_runSummary",
+			"dotSlot": "DBuyfa_dotSlot",
+			"phaseList": "DBuyfa_phaseList",
+			"memberStatus": "DBuyfa_memberStatus",
+			"runTitle": "DBuyfa_runTitle",
+			"memberRow": "DBuyfa_memberRow",
+			"phaseStatus": "DBuyfa_phaseStatus",
+			"empty": "DBuyfa_empty",
+			"statusTail": "DBuyfa_statusTail",
+			"memberButton": "DBuyfa_memberButton",
+			"memberLabelWrap": "DBuyfa_memberLabelWrap",
+			"phase": "DBuyfa_phase",
+			"phaseHeader": "DBuyfa_phaseHeader",
+			"phaseCount": "DBuyfa_phaseCount",
+			"root": "DBuyfa_root",
+			"runHeader": "DBuyfa_runHeader"
+		};
+		//#endregion
+		//#region lib/types/client/WorkflowRunPanel.js
+		const STATUS_KEYS = {
+			running: "status.running",
+			completed: "status.completed",
+			failed: "status.failed",
+			cancelled: "status.cancelled",
+			interrupted: "status.interrupted"
+		};
+		function dotState(status) {
+			switch (status) {
+				case "running": return "ongoing";
+				case "completed": return "done";
+				case "failed": return "error";
+				case "cancelled":
+				case "interrupted": return "warning";
+				/* v8 ignore next -- WorkflowRunStatus is closed and every variant is handled above. */
+				default: return status;
+			}
+		}
+		function readablePhase(phase, t) {
+			if (phase === null) return t("phase.unassigned");
+			return phase === "" ? t("phase.empty") : phase;
+		}
+		function readableMember(label, t) {
+			return label === "" ? t("member.empty") : label;
+		}
+		function statusCount(status, count, t) {
+			return t(`statusCount.${status}`, { count });
+		}
+		function memberCount(count, t) {
+			return t(count === 1 ? "run.members.one" : "run.members.other", { count });
+		}
+		function phaseStatusSummary(members, t) {
+			const counts = /* @__PURE__ */ new Map();
+			for (const member of members) counts.set(member.status, (counts.get(member.status) ?? 0) + 1);
+			const count = (status) => counts.get(status) ?? 0;
+			const active = [
+				"running",
+				"failed",
+				"cancelled",
+				"interrupted"
+			].filter((status) => count(status) > 0);
+			if (active.length === 0) return statusCount("completed", count("completed"), t);
+			return (active.includes("interrupted") && count("completed") > 0 ? ["completed", ...active] : active).map((status) => statusCount(status, count(status), t)).join(" · ");
+		}
+		function navigableMembers(sessions, phases, parentId) {
+			const ordinary = new Set(sessions.ids);
+			const result = [];
+			for (const phase of phases) for (const member of phase.members) {
+				const summary = sessions.byId[member.childId];
+				if (member.status === "running" && ordinary.has(member.childId) && summary?.origin === "subagent" && summary.parentId === parentId && summary.running) result.push(member.childId);
+			}
+			return result;
+		}
+		function RunHeader({ count, name, onToggle, open, status, t }) {
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DisclosureRow, {
+				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, {}),
+				title: t("run.title", { name }),
+				open,
+				expandable: true,
+				onToggle,
+				expandOnRowClick: true,
+				previewChevron: false,
+				keepContentWhenOpen: true,
+				rowClassName: WorkflowRunPanel_module_css_default.runHeader,
+				leadingClassName: WorkflowRunPanel_module_css_default.runLeading,
+				titleClassName: WorkflowRunPanel_module_css_default.runTitle,
+				collapsedContent: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+					(0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.separator,
+						"aria-hidden": true
+					}),
+					(0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.runSummary,
+						children: memberCount(count, t)
+					}),
+					(0, react_jsx_runtime.jsxs)("span", {
+						className: WorkflowRunPanel_module_css_default.statusTail,
+						"data-status": status,
+						children: [(0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: dotState(status) }), (0, react_jsx_runtime.jsx)("span", { children: t(STATUS_KEYS[status]) })]
+					})
+				] })
+			});
+		}
+		function MemberRow({ member, navigable, openSession, t }) {
+			const name = readableMember(member.label, t);
+			const content = (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				(0, react_jsx_runtime.jsx)("span", {
+					className: WorkflowRunPanel_module_css_default.dotSlot,
+					children: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.StateDot, { state: dotState(member.status) })
+				}),
+				(0, react_jsx_runtime.jsx)("span", {
+					className: WorkflowRunPanel_module_css_default.memberLabelWrap,
+					"data-member-label-wrap": true,
+					children: (0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.memberLabel,
+						"data-member-label": true,
+						children: name
+					})
+				}),
+				(0, react_jsx_runtime.jsx)("span", {
+					className: WorkflowRunPanel_module_css_default.memberStatus,
+					"data-member-status-text": true,
+					children: t(STATUS_KEYS[member.status])
+				})
+			] });
+			if (!navigable) return (0, react_jsx_runtime.jsx)("div", {
+				className: WorkflowRunPanel_module_css_default.memberRow,
+				"data-member-status": member.status,
+				children: content
+			});
+			return (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				className: WorkflowRunPanel_module_css_default.memberButton,
+				"data-member-status": member.status,
+				"aria-label": t("member.open", { name }),
+				onClick: () => {
+					openSession(member.childId);
+				},
+				children: content
+			});
+		}
+		function PhaseSection({ phase, navigable, openSession, t }) {
+			const [open, setOpen] = (0, react.useState)(false);
+			const toggle = () => {
+				setOpen((value) => !value);
+			};
+			return (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.DisclosureRow, {
+				icon: (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, {}),
+				title: readablePhase(phase.phase, t),
+				open,
+				expandable: true,
+				onToggle: toggle,
+				expandOnRowClick: true,
+				previewChevron: false,
+				keepContentWhenOpen: true,
+				className: WorkflowRunPanel_module_css_default.phase,
+				rowClassName: WorkflowRunPanel_module_css_default.phaseHeader,
+				leadingClassName: WorkflowRunPanel_module_css_default.phaseLeading,
+				titleClassName: WorkflowRunPanel_module_css_default.phaseTitle,
+				collapsedContent: (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+					(0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.separator,
+						"aria-hidden": true
+					}),
+					(0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.phaseCount,
+						"data-phase-count": true,
+						children: memberCount(phase.members.length, t)
+					}),
+					(0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.phaseStatus,
+						"data-phase-status-text": true,
+						children: phaseStatusSummary(phase.members, t)
+					})
+				] }),
+				children: (0, react_jsx_runtime.jsx)("div", {
+					className: WorkflowRunPanel_module_css_default.members,
+					children: phase.members.map((member) => (0, react_jsx_runtime.jsx)(MemberRow, {
+						member,
+						navigable: navigable.includes(member.childId),
+						openSession,
+						t
+					}, member.seq))
+				})
+			});
+		}
+		/** Render one durable workflow run with independent run and phase disclosure. */
+		function WorkflowRunPanel({ node, sessionId, useSessions, openSession, t }) {
+			const [open, setOpen] = (0, react.useState)(() => node.data.status === "running");
+			const memberCount = node.data.phases.reduce((count, phase) => count + phase.members.length, 0);
+			const navigable = useSessions((sessions) => navigableMembers(sessions, node.data.phases, sessionId), _deepseek_ai_dsh_client_runtime_client.shallowEqual);
+			return (0, react_jsx_runtime.jsxs)("section", {
+				className: WorkflowRunPanel_module_css_default.root,
+				"data-workflow-run": true,
+				"data-run-status": node.data.status,
+				children: [(0, react_jsx_runtime.jsx)(RunHeader, {
+					count: memberCount,
+					name: node.data.name,
+					open,
+					status: node.data.status,
+					t,
+					onToggle: () => {
+						setOpen((value) => !value);
+					}
+				}), open && (0, react_jsx_runtime.jsx)("div", {
+					className: WorkflowRunPanel_module_css_default.phaseList,
+					children: node.data.phases.length === 0 ? (0, react_jsx_runtime.jsx)("span", {
+						className: WorkflowRunPanel_module_css_default.empty,
+						children: t("run.empty")
+					}) : node.data.phases.map((phase) => (0, react_jsx_runtime.jsx)(PhaseSection, {
+						phase,
+						navigable,
+						openSession,
+						t
+					}, phase.key))
+				})]
+			});
+		}
+		//#endregion
+		//#region lib/types/client/locales.js
+		/** `workflowRun` namespace dictionaries. */
+		/** Dictionary namespace owned by this plugin. */
+		const NS = "workflowRun";
+		/** Simplified Chinese dictionary (the key-set source of truth). */
+		const zh = {
+			"run.title": "{name}",
+			"run.members.one": "{count} 个成员",
+			"run.members.other": "{count} 个成员",
+			"run.empty": "没有启动成员",
+			"phase.unassigned": "未分阶段",
+			"phase.empty": "空阶段名",
+			"statusCount.running": "运行中 {count}",
+			"statusCount.completed": "已完成 {count}",
+			"statusCount.failed": "失败 {count}",
+			"statusCount.cancelled": "已取消 {count}",
+			"statusCount.interrupted": "已中断 {count}",
+			"member.empty": "空成员名",
+			"member.open": "打开 {name}",
+			"status.running": "运行中",
+			"status.completed": "已完成",
+			"status.failed": "失败",
+			"status.cancelled": "已取消",
+			"status.interrupted": "已中断"
+		};
+		/** English dictionary (same key set). */
+		const en = {
+			"run.title": "{name}",
+			"run.members.one": "{count} member",
+			"run.members.other": "{count} members",
+			"run.empty": "No members started",
+			"phase.unassigned": "Unphased",
+			"phase.empty": "Empty phase name",
+			"statusCount.running": "Running {count}",
+			"statusCount.completed": "Completed {count}",
+			"statusCount.failed": "Failed {count}",
+			"statusCount.cancelled": "Cancelled {count}",
+			"statusCount.interrupted": "Interrupted {count}",
+			"member.empty": "Empty member name",
+			"member.open": "Open {name}",
+			"status.running": "Running",
+			"status.completed": "Completed",
+			"status.failed": "Failed",
+			"status.cancelled": "Cancelled",
+			"status.interrupted": "Interrupted"
+		};
+		//#endregion
+		//#region lib/types/client/workflow-definition.js
+		/**
+		* Build a collision-free phase key preserving absent versus empty identity.
+		* @param phase - exact phase string, or null for an omitted field.
+		* @returns the stable renderer key for that phase identity.
+		*/
+		function workflowPhaseKey(phase) {
+			return phase === null ? "missing" : `value:${phase.length}:${phase}`;
+		}
+		function statusFromStopReason(stopReason) {
+			switch (stopReason) {
+				case "completed": return "completed";
+				case "cancelled": return "cancelled";
+				case "error": return "failed";
+				/* v8 ignore next -- WorkflowStopReason is closed and every variant is handled above. */
+				default: return stopReason;
+			}
+		}
+		function statusFromOutcome(outcome) {
+			switch (outcome) {
+				case "completed": return "completed";
+				case "cancelled": return "cancelled";
+				case "failed": return "failed";
+				/* v8 ignore next -- WorkflowAgentOutcome is closed and every variant is handled above. */
+				default: return outcome;
+			}
+		}
+		function locationClosed(location) {
+			if (location.kind === "step") return location.step.status === "closed" || location.turn.status === "closed";
+			return location.kind === "turn" && location.turn.status === "closed";
+		}
+		function projectWorkflow(context, location) {
+			const state = context.state;
+			const interrupted = state.stopReason === void 0 && locationClosed(location);
+			const phases = /* @__PURE__ */ new Map();
+			for (const member of state.members) {
+				const phase = member.phase === void 0 ? null : member.phase;
+				const key = workflowPhaseKey(phase);
+				let group = phases.get(key);
+				if (group === void 0) {
+					group = {
+						phase,
+						members: []
+					};
+					phases.set(key, group);
+				}
+				group.members.push({
+					seq: member.seq,
+					label: member.label,
+					childId: member.childId,
+					status: member.outcome === void 0 ? interrupted ? "interrupted" : "running" : statusFromOutcome(member.outcome)
+				});
+			}
+			const projectedPhases = [...phases].map(([key, phase]) => ({
+				key,
+				phase: phase.phase,
+				members: phase.members
+			}));
+			return {
+				name: state.name,
+				status: state.stopReason === void 0 ? interrupted ? "interrupted" : "running" : statusFromStopReason(state.stopReason),
+				phases: projectedPhases
+			};
+		}
+		function updateAgentStart(state, data) {
+			const member = {
+				seq: data.seq,
+				label: data.label,
+				...data.phase === void 0 ? {} : { phase: data.phase },
+				childId: data.childId
+			};
+			return {
+				...state,
+				members: [...state.members, member]
+			};
+		}
+		function updateAgentEnd(state, data) {
+			return {
+				...state,
+				members: state.members.map((member) => member.seq === data.seq ? {
+					...member,
+					outcome: data.outcome
+				} : member)
+			};
+		}
+		/** Durable workflow event family folded into one keyed Chat node. */
+		const workflowRunDefinition = {
+			kind: "workflow-run",
+			target: "chat",
+			match: (event) => {
+				if (event.type === "tool-workflow/run-start") return {
+					id: String(event.data.runId),
+					role: "start"
+				};
+				if (event.type === "tool-workflow/agent-start" || event.type === "tool-workflow/agent-end" || event.type === "tool-workflow/run-end") return {
+					id: String(event.data.runId),
+					role: "update"
+				};
+				return null;
+			},
+			start: (_context, match) => {
+				if (match.event.type !== "tool-workflow/run-start") throw new Error("workflow-run start requires tool-workflow/run-start");
+				return {
+					name: match.event.data.name,
+					members: []
+				};
+			},
+			update: (context, match) => {
+				if (match.event.type === "tool-workflow/agent-start") return updateAgentStart(context.state, match.event.data);
+				if (match.event.type === "tool-workflow/agent-end") return updateAgentEnd(context.state, match.event.data);
+				if (match.event.type === "tool-workflow/run-end") return {
+					...context.state,
+					stopReason: match.event.data.stopReason
+				};
+				return context.state;
+			},
+			buildViewNode: (context) => {
+				if (context.start === void 0) return null;
+				const data = projectWorkflow(context, context.start.location);
+				return {
+					key: context.key,
+					kind: "workflow-run",
+					id: context.id,
+					target: "chat",
+					anchorSeq: context.start.event.seq,
+					location: context.start.location,
+					visibility: "visible",
+					data
+				};
+			}
+		};
+		//#endregion
+		//#region lib/types/client/index.js
+		/** Browser plugin for durable workflow-run Conversation Nodes. */
+		/** Required services for Definition, keyed renderer, navigation, and copy. */
+		const inject = [
+			"conversationEvents",
+			"slots",
+			"sessions",
+			"locale"
+		];
+		/** Register the workflow Definition, dictionary, and keyed Chat renderer. */
+		function apply(ctx) {
+			ctx.conversationEvents.register(workflowRunDefinition);
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "ui-workflow-run: dictionaries");
+			ctx.slots.inject("conversation.chat.node", () => ctx.slots.register({
+				name: "conversation.chat.node",
+				key: "workflow-run",
+				locale: NS,
+				inject: () => ({ openSession: (id) => {
+					ctx.sessions.open(id);
+				} })
+			}, WorkflowRunPanel));
+		}
+		//#endregion
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});
+
+//# sourceMappingURL=client.js.map

package/lib/index.js

@@ -0,0 +1,6 @@
+//#region lib/types/index.js
+/** Durable workflow-run UI plugin, node half. */
+/** Host plugin body; the feature is entirely browser-side. */
+function apply() {}
+//#endregion
+export { apply };

package/lib/invariant.js

@@ -0,0 +1,17 @@
+//#region lib/types/invariant.js
+/** Package-owned invariant companion for the workflow-run UI plugin. */
+const PACKAGE_NAME = "@deepseek-ai/dsh-client-ui-workflow-run";
+/** Cordis companion plugin name. */
+const name = "client-ui-workflow-run-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: the browser plugin contributes one effect-owned
+* Conversation Definition, keyed renderer, and dictionary; tests prove their
+* disposal and the Host tool package owns the durable event invariant.
+*/
+const install = () => {};
+/** Register this package's invariant companion. */
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

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

@@ -0,0 +1,11 @@
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { type SessionId } from '@deepseek-ai/dsh-client-runtime/client';
+/** Navigation action injected from the plugin's own SessionsService access. */
+export interface WorkflowRunInjected {
+    readonly openSession: (id: SessionId) => void;
+}
+/** Complete keyed Chat renderer props. */
+export type WorkflowRunPanelProps = PropsRuntime<'conversation.chat.node', 'workflow-run'> & PropsLocale<'workflowRun'> & WorkflowRunInjected;
+/** Render one durable workflow run with independent run and phase disclosure. */
+export declare function WorkflowRunPanel({ node, sessionId, useSessions, openSession, t }: WorkflowRunPanelProps): import("react").JSX.Element;
+//# sourceMappingURL=WorkflowRunPanel.d.ts.map

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

@@ -0,0 +1,14 @@
+/** Browser plugin for durable workflow-run Conversation Nodes. */
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client';
+import { type WorkflowRunKey } from './locales.ts';
+declare module '@deepseek-ai/dsh-client-ui-slots' {
+    interface LocaleNamespaceMap {
+        /** Durable workflow-run node copy. */
+        workflowRun: WorkflowRunKey;
+    }
+}
+/** Required services for Definition, keyed renderer, navigation, and copy. */
+export declare const inject: string[];
+/** Register the workflow Definition, dictionary, and keyed Chat renderer. */
+export declare function apply(ctx: ClientContext): void;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1,29 @@
+/** `workflowRun` namespace dictionaries. */
+/** Dictionary namespace owned by this plugin. */
+export declare const NS = "workflowRun";
+/** Simplified Chinese dictionary (the key-set source of truth). */
+export declare const zh: {
+    'run.title': string;
+    'run.members.one': string;
+    'run.members.other': string;
+    'run.empty': string;
+    'phase.unassigned': string;
+    'phase.empty': string;
+    'statusCount.running': string;
+    'statusCount.completed': string;
+    'statusCount.failed': string;
+    'statusCount.cancelled': string;
+    'statusCount.interrupted': string;
+    'member.empty': string;
+    'member.open': string;
+    'status.running': string;
+    'status.completed': string;
+    'status.failed': string;
+    'status.cancelled': string;
+    'status.interrupted': string;
+};
+/** English dictionary (same key set). */
+export declare const en: Record<WorkflowRunKey, string>;
+/** Union of this namespace's dictionary keys. */
+export type WorkflowRunKey = keyof typeof zh;
+//# sourceMappingURL=locales.d.ts.map

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

@@ -0,0 +1,50 @@
+import type { ConversationNodeDefinition } from '@deepseek-ai/dsh-client-runtime/client';
+import type { SessionId } from '@deepseek-ai/dsh-session/types';
+import type { ToolWorkflowAgentStartData } from '@deepseek-ai/dsh-tool-workflow/types';
+import type { WorkflowAgentOutcome, WorkflowStopReason } from '@deepseek-ai/dsh-workflow/types';
+/** Status shown for a workflow, phase, or member. */
+export type WorkflowRunStatus = 'running' | 'completed' | 'failed' | 'cancelled' | 'interrupted';
+/** Final renderer data for one member. */
+export interface WorkflowRunMemberData {
+    readonly seq: number;
+    readonly label: string;
+    readonly childId: SessionId;
+    readonly status: WorkflowRunStatus;
+}
+/** Final renderer data for one exact phase identity. */
+export interface WorkflowRunPhaseData {
+    readonly key: string;
+    /** `null` is the absent field; the empty string remains a distinct identity. */
+    readonly phase: string | null;
+    readonly members: readonly WorkflowRunMemberData[];
+}
+/** Final keyed Chat payload for one workflow run. */
+export interface WorkflowRunChatData {
+    readonly name: string;
+    readonly status: WorkflowRunStatus;
+    readonly phases: readonly WorkflowRunPhaseData[];
+}
+declare module '@deepseek-ai/dsh-client-ui-conversation/client' {
+    interface ChatNodeDataMap {
+        /** Durable top-level workflow run and all members that actually started. */
+        'workflow-run': WorkflowRunChatData;
+    }
+}
+interface WorkflowMemberState extends Omit<ToolWorkflowAgentStartData, 'runId'> {
+    readonly outcome?: WorkflowAgentOutcome;
+}
+interface WorkflowState {
+    readonly name: string;
+    readonly stopReason?: WorkflowStopReason;
+    readonly members: readonly WorkflowMemberState[];
+}
+/**
+ * Build a collision-free phase key preserving absent versus empty identity.
+ * @param phase - exact phase string, or null for an omitted field.
+ * @returns the stable renderer key for that phase identity.
+ */
+export declare function workflowPhaseKey(phase: string | null): string;
+/** Durable workflow event family folded into one keyed Chat node. */
+export declare const workflowRunDefinition: ConversationNodeDefinition<WorkflowState>;
+export {};
+//# sourceMappingURL=workflow-definition.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,4 @@
+/** Durable workflow-run UI plugin, node half. */
+/** Host plugin body; the feature is entirely browser-side. */
+export declare function apply(): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,9 @@
+/** Package-owned invariant companion for the workflow-run UI plugin. */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "client-ui-workflow-run-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/** Register this package's invariant companion. */
+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-workflow-run",
+  "description": "Durable workflow-run Conversation Node and nested member disclosure for dsh web",
+  "version": "0.0.1-rc.2",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/client/ui-workflow-run"
+  },
+  "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-locale",
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-conversation"
+      ],
+      "platform": "web"
+    }
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/client.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "react": "^18.2.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-workflow": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-workflow": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@types/react": "~18.3.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-test-runtime": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-tool-workflow": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-workflow": "^0.0.1-rc.2",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  },
+  "scripts": {
+    "bundle": "tsdown",
+    "watch": "tsdown --watch"
+  }
+}