dsh-plugin-teamflow 0.1.9 → 0.2.0

package/lib/client.js

@@ -29,11 +29,15 @@ window.__ModuleLoader__.load({
 		let react = require("react");
 		react = __toESM(react, 1);
 		//#region descriptors.ts
+		/** 恒等 parse：接受任意 JSON 值，原样返回。 */
+		const JSON_SCHEMA = { parse: (value) => value };
 		/** 统一 strict codec（本插件所有参数/结果均为自由 JSON）。 */
 		const strict = {
 			mode: "strict",
 			typeSymbol: "dsh-plugin-teamflow/types#Json",
-			schema: { parse: (value) => value }
+			schema: JSON_SCHEMA,
+			/** 首次跨边界使用时物化 schema（宿主按需调用，只调一次并缓存）。 */
+			create: () => JSON_SCHEMA
 		};
 		const p = (name) => ({
 			name,
@@ -334,6 +338,14 @@ window.__ModuleLoader__.load({
 		}
 		const stText = (s) => vocab("status", s);
 		const runStatusText = (s) => vocab("runStatus", s);
+		/**
+		* **阶段**状态文案：只有 `cancelled` 与 backlog 词表分道。
+		*
+		* `stText` 是 backlog 卡片词表（`status.cancelled`/`closed`/`verified` 都译「已关闭」），阶段渲染若直接复用它，
+		* 被中断的阶段会显示成「已关闭」（en：Closed）——2026-09-16 中断功能实测截图里，同一屏 run 行写「已取消」、
+		* 阶段节点写「已关闭」。阶段是被**中止**而不是被关闭，故单独取词；其余阶段状态仍走同一张表（不开两套词表）。
+		*/
+		const stageStatusText = (s) => s === "cancelled" ? t("stageStatus.cancelled") : stText(s);
 		const kindTitle = (k) => vocab("kind", k);
 		const roleName = (r) => vocab("role", r);
 		/** 角色 chip（带图标；未知角色回退「⚙️ <raw>」）。 */
@@ -413,6 +425,7 @@ window.__ModuleLoader__.load({
 		function stageLabelOf(s) {
 			const raw = String(s && s.label || "");
 			if (s && s.taskKey) return raw || String(s.taskKey);
+			if (s && phaseKeyOf(s.phase) === "dev" && raw) return raw;
 			return (s && s.phase ? phaseNameOf(s.phase) : "") || raw;
 		}
 		const COLUMNS = {
@@ -527,6 +540,70 @@ window.__ModuleLoader__.load({
 				}
 			}, `${t("common.expandFull")}${more}`));
 		}
+		/**
+		* 中断运行按钮（**两段式内联确认**）：首次点击进入待确认态，3 秒内再点一次才真正执行。
+		*
+		* 为什么不自造对话框：客户端全目录 grep `confirm|dialog` 0 命中——目前没有宿主确认能力依赖，
+		* 内联两段式不引新依赖、也不改宿主能力面，且天然贴合「误点一个跑了几十分钟的 run」的防护诉求。
+		*
+		* 数据面由调用方给（`onConfirm(runId)`）：会话内工作台与全局面板/右栏共用同一个 `teamflow/cancel`
+		* 方法，本件只负责待确认窗口、忙碌态与**点击不冒泡**（面板 run 行整行可点开详情）。
+		* `onConfirm` **必须自行消化错误**（它由调用方 try/catch 并落到可见的 err 提示）；本件兜底只记 console，
+		* 不让点击处理里出现未处理的 rejection。
+		*/
+		function CancelButton({ runId, label, title, onConfirm, style }) {
+			const [arm, setArm] = react.default.useState(false);
+			const [busy, setBusy] = react.default.useState(false);
+			react.default.useEffect(() => {
+				if (!arm) return void 0;
+				const timer = setTimeout(() => setArm(false), 3e3);
+				return () => clearTimeout(timer);
+			}, [arm]);
+			const onClick = async (e) => {
+				if (e && typeof e.stopPropagation === "function") e.stopPropagation();
+				if (busy) return;
+				if (!arm) {
+					setArm(true);
+					return;
+				}
+				setArm(false);
+				setBusy(true);
+				try {
+					await onConfirm(runId);
+				} catch (err) {
+					console.warn("[teamflow] cancel failed", err);
+				} finally {
+					setBusy(false);
+				}
+			};
+			const tone = busy ? {
+				opacity: .6,
+				cursor: "default"
+			} : arm ? {
+				background: T.error,
+				color: "#fff",
+				borderColor: T.error
+			} : null;
+			return h("button", {
+				onClick,
+				disabled: busy,
+				title: title || void 0,
+				style: {
+					font: "inherit",
+					fontSize: 12,
+					padding: "4px 12px",
+					borderRadius: 8,
+					cursor: "pointer",
+					border: `1px solid ${T.error}`,
+					background: "transparent",
+					color: T.error,
+					fontWeight: 600,
+					transition: "background .12s ease, color .12s ease",
+					...style || {},
+					...tone || {}
+				}
+			}, busy ? t("cancel.busy") : arm ? t("cancel.arm") : label || t("cancel.btn"));
+		}
 		function fmtTime(tm) {
 			if (!tm) return "—";
 			const d = new Date(tm);
@@ -690,6 +767,7 @@ window.__ModuleLoader__.load({
 			"runStatus.cancelled": "已取消",
 			"runStatus.interrupted": "已中断",
 			"runStatus.superseded": "已取代",
+			"stageStatus.cancelled": "已中止",
 			"phase.prd": "PRD 产品需求",
 			"phase.design": "UI/UX 设计",
 			"phase.scaffold": "架构规划",
@@ -770,6 +848,13 @@ window.__ModuleLoader__.load({
 			"workbench.history": "历史",
 			"workbench.openRightBarTip": "在右侧栏打开该 run 详情（与任务夹产物并排看）",
 			"workbench.openRightBarBtn": "⇥ 右栏打开",
+			"cancel.btn": "⏹ 中断",
+			"cancel.btnWithId": "⏹ 中断 #{id}",
+			"cancel.arm": "确认中断?",
+			"cancel.busy": "中断中…",
+			"cancel.sent": "已请求中断，等待当前阶段收尾…",
+			"cancel.tip": "中断 {id}\n立即中止当前阶段子代理；已完成阶段保留，之后可用「从断点重跑」继续；取消的 run 不产生提交",
+			"cancel.failed": "中断未生效：该流水线已不在运行中（可能刚结束）",
 			"board.empty": "backlog 为空（还没有流水线运行过）",
 			"board.dragReason": "看板拖拽流转",
 			"board.cardTip": "{id} · {status}{summary}（点击查看详情）",
@@ -951,6 +1036,7 @@ window.__ModuleLoader__.load({
 			"runStatus.cancelled": "Cancelled",
 			"runStatus.interrupted": "Interrupted",
 			"runStatus.superseded": "Superseded",
+			"stageStatus.cancelled": "Stopped",
 			"phase.prd": "PRD",
 			"phase.design": "UI/UX design",
 			"phase.scaffold": "Architecture",
@@ -1031,6 +1117,13 @@ window.__ModuleLoader__.load({
 			"workbench.history": "History",
 			"workbench.openRightBarTip": "Open this run's detail in the right sidebar (side by side with task-folder artifacts)",
 			"workbench.openRightBarBtn": "⇥ Open in right bar",
+			"cancel.btn": "⏹ Stop",
+			"cancel.btnWithId": "⏹ Stop #{id}",
+			"cancel.arm": "Confirm stop?",
+			"cancel.busy": "Stopping…",
+			"cancel.sent": "Stop requested — waiting for the current stage to wind down…",
+			"cancel.tip": "Stop {id}\nAborts the subagent of the current stage immediately; finished stages are kept and can be resumed from the checkpoint later; a cancelled run never commits",
+			"cancel.failed": "Stop had no effect: the pipeline is no longer running (it may have just finished)",
 			"board.empty": "Backlog is empty (no pipeline has run yet)",
 			"board.dragReason": "kanban drag transition",
 			"board.cardTip": "{id} · {status}{summary} (click for details)",
@@ -1400,7 +1493,7 @@ window.__ModuleLoader__.load({
 				} }, p.lastRequirement) : null, p.lastVerdict ? h("div", { style: { marginTop: 4 } }, chip(t("panel.verdict", { v: p.lastVerdict }), stColor(p.lastVerdict === "accepted" ? "accepted" : p.lastVerdict))) : null);
 			})));
 		}
-		function RunList({ runs, activeRunId, onOpenRun, onInlineRun }) {
+		function RunList({ runs, activeRunId, onOpenRun, onInlineRun, onCancel }) {
 			if (!runs.length) return muted(t("runList.empty"), { padding: "2px 2px 8px" });
 			return h("div", { style: {
 				display: "flex",
@@ -1453,7 +1546,15 @@ window.__ModuleLoader__.load({
 				} }, h("span", null, t("runList.stageProgress", {
 					done: r.doneStages,
 					total: r.stageCount
-				})), h("span", null, runUsageText(r.usage)), h("span", null, `${fmtTime(r.startedAt)}${r.endedAt ? ` → ${fmtTime(r.endedAt)}` : ""} ${fmtDur(r.startedAt, r.endedAt)}`))), h("button", {
+				})), h("span", null, runUsageText(r.usage)), h("span", null, `${fmtTime(r.startedAt)}${r.endedAt ? ` → ${fmtTime(r.endedAt)}` : ""} ${fmtDur(r.startedAt, r.endedAt)}`))), r.status === "running" && onCancel ? h(CancelButton, {
+					runId: r.id,
+					title: t("cancel.tip", { id: r.id }),
+					onConfirm: onCancel,
+					style: {
+						fontSize: 11,
+						padding: "2px 9px"
+					}
+				}) : null, h("button", {
 					style: brandBtn,
 					title: t("runList.openRightBarTip"),
 					onClick: (e) => {
@@ -1796,7 +1897,7 @@ window.__ModuleLoader__.load({
 				color: T.text2
 			} }, det.events.slice(-30).map((e, i) => h("div", { key: i }, `${fmtTime(e.at)} ${e.from || "—"} → ${e.to || "—"}${e.by ? ` · ${e.by}` : ""}${e.reason ? ` · ${e.reason}` : ""}`)))) : null);
 		}
-		function RunDetailPane({ snap, product, api }) {
+		function RunDetailPane({ snap, product, api, onCancel }) {
 			const [sel, setSel] = react.default.useState(null);
 			const [err, setErr] = react.default.useState(null);
 			react.default.useEffect(() => {
@@ -1850,7 +1951,16 @@ window.__ModuleLoader__.load({
 				fontSize: 10,
 				color: T.text2,
 				fontFamily: MONO
-			} }, product) : null), h("div", { style: {
+			} }, product) : null, snap.status === "running" && onCancel ? h(CancelButton, {
+				runId: snap.id,
+				title: t("cancel.tip", { id: snap.id }),
+				onConfirm: onCancel,
+				style: {
+					marginLeft: "auto",
+					fontSize: 10.5,
+					padding: "2px 9px"
+				}
+			}) : null), h("div", { style: {
 				fontSize: 12,
 				color: T.text,
 				lineHeight: 1.5
@@ -1902,7 +2012,7 @@ window.__ModuleLoader__.load({
 					fontSize: 11.5,
 					color: T.text,
 					fontWeight: 500
-				} }, stageLabelOf(s)), chip(stText(s.status), color, { dot: true }), s.outcome && s.outcome !== "completed" ? chip(String(s.outcome), stColor(s.outcome)) : null, h("span", { style: {
+				} }, stageLabelOf(s)), chip(stageStatusText(s.status), color, { dot: true }), s.outcome && s.outcome !== "completed" && s.outcome !== "cancelled" ? chip(String(s.outcome), stColor(s.outcome)) : null, h("span", { style: {
 					marginLeft: "auto",
 					fontFamily: MONO,
 					fontSize: 10,
@@ -1938,7 +2048,7 @@ window.__ModuleLoader__.load({
 				fontSize: 11.5,
 				fontWeight: 700,
 				color: T.text
-			} }, t("detail.stageTitle", { seq: sel.seq })), chip(stText(sel.status), stColor(sel.status))), h("button", {
+			} }, t("detail.stageTitle", { seq: sel.seq })), chip(stageStatusText(sel.status), stColor(sel.status))), h("button", {
 				style: panelBtn,
 				onClick: () => setSel(null)
 			}, t("common.collapse"))), h("div", { style: {
@@ -1991,7 +2101,7 @@ window.__ModuleLoader__.load({
 					fontFamily: MONO,
 					color: T.text2
 				}
-			}, h("span", null, `#${a.seq}`), chip(stText(a.status), stColor(a.status)), a.outcome ? h("span", null, a.outcome) : null, h("span", { style: { marginLeft: "auto" } }, `${fmtTime(a.startedAt)} · ${fmtDur(a.startedAt, a.endedAt)}`))))) : null) : null, logs.length ? h("div", null, sectionTitle(t("detail.logs", { n: logs.length })), h("div", { style: {
+			}, h("span", null, `#${a.seq}`), chip(stageStatusText(a.status), stColor(a.status)), a.outcome && a.outcome !== "cancelled" ? h("span", null, a.outcome) : null, h("span", { style: { marginLeft: "auto" } }, `${fmtTime(a.startedAt)} · ${fmtDur(a.startedAt, a.endedAt)}`))))) : null) : null, logs.length ? h("div", null, sectionTitle(t("detail.logs", { n: logs.length })), h("div", { style: {
 				display: "flex",
 				flexDirection: "column",
 				gap: 2,
@@ -2078,6 +2188,16 @@ window.__ModuleLoader__.load({
 				nonce,
 				readTab
 			]);
+			/** 中断后重新拉快照（nonce 触发上面那个 effect 重跑；右栏 tab 是会话级地址，与产品线选择无关）。 */
+			const onCancel = async (rid) => {
+				if (!api) return;
+				try {
+					await api.cancel(rid);
+					setNonce((n) => n + 1);
+				} catch (e) {
+					setErr(String(e && e.message || e));
+				}
+			};
 			if (err && !snap) {
 				const pending = !address && !!readTab;
 				return h("div", { style: {
@@ -2097,7 +2217,8 @@ window.__ModuleLoader__.load({
 			return h(RunDetailPane, {
 				snap,
 				product,
-				api
+				api,
+				onCancel
 			});
 		}
 		function productApi(remote, product) {
@@ -2105,7 +2226,13 @@ window.__ModuleLoader__.load({
 				view: async () => unwrap$1(await remote.productView(product), "productView"),
 				runDetail: async (runId) => unwrap$1(await remote.productRunDetail(product, runId), "productRunDetail"),
 				stageDetail: async (runId, seq) => unwrap$1(await remote.productStageDetail(product, runId, seq), "productStageDetail"),
-				itemDetail: async (kind, id, sessionId) => unwrap$1(await remote.productItemDetail(product, kind, id, sessionId), "productItemDetail")
+				itemDetail: async (kind, id, sessionId) => unwrap$1(await remote.productItemDetail(product, kind, id, sessionId), "productItemDetail"),
+				/** 中断运行：runId 全局寻址（与产品线无关），放这里是为了让面板行/详情/右栏共用同一处解包与报错。 */
+				cancel: async (runId) => {
+					const r = unwrap$1(await remote.cancel(runId), "cancel");
+					if (!r || r.ok !== true) throw new Error(t("cancel.failed"));
+					return true;
+				}
 			};
 		}
 		/** 全局面板 props：root scope 标准 props（useSessions 取当前会话）+ 插件注入（remote/打开回调）。 */
@@ -2165,8 +2292,10 @@ window.__ModuleLoader__.load({
 			/**
 			* **跳到资源所属的会话，再在那个会话的右栏打开**（全局面板的正确语义）。
 			* 右侧栏是会话级的：从全局面板看 tetris 的 run 却把 tab 挂到"用户当前所在会话"上没有意义
-			* （用户 2026-09-11 提出）。所以先 `sessions.open(ownerSession)`，等当前会话真的切过去、
-			* 且对话 seat 挂载 bind 之后再 openResource（两者都要等，故小步重试 + 就绪判据）。
+			* （用户 2026-09-11 提出）。所以先 `uiWorkspace.openSession(ownerSession)`，再小步重试等右栏 seat 就绪后 openResource。
+			* **2026-09-23 迁移（宿主 0.1.7-alpha.1）**：`sessions.open` 与 `sessions.openSubagent` 同批被移除，
+			* 跳会话唯一入口改为 `uiWorkspace.openSession(target)`；同时 `SessionListState` 已无 `current` 字段，
+			* 故原先"等当前会话真的切过去"的判据删除（契约变更后它恒为 undefined，等于死代码），只留时间维度的重试。
 			* @param target.ownerSession - 资源所属会话（run 的发起会话 / 产物地址里的会话）
 			* @param target.address - host 生成的 dsh-resource 地址
 			* @param target.label - 提示用的名字
@@ -2174,13 +2303,13 @@ window.__ModuleLoader__.load({
 			*/
 			const goOwnerSessionAndOpen = (target) => {
 				const { ownerSession, address, label, fallback } = target || {};
-				const sessions = props.sessions;
-				if (!ownerSession || !sessions || typeof sessions.open !== "function") {
+				const ws = props.uiWorkspace;
+				if (!ownerSession || !ws || typeof ws.openSession !== "function") {
 					openInConversationRightbar(address, label, fallback);
 					return;
 				}
 				try {
-					sessions.open(ownerSession);
+					ws.openSession(ownerSession);
 				} catch (e) {
 					setHint(t("panel.hintSessionGone", { sid: String(ownerSession).slice(0, 8) }));
 					if (fallback) fallback();
@@ -2192,13 +2321,7 @@ window.__ModuleLoader__.load({
 				let tries = 0;
 				const tick = () => {
 					tries += 1;
-					let nowCurrent = null;
-					try {
-						nowCurrent = sessions.list && sessions.list.getSnapshot ? sessions.list.getSnapshot().current : null;
-					} catch (e) {
-						nowCurrent = null;
-					}
-					if ((nowCurrent === ownerSession || tries >= 6) && props.openResource && address && props.openResource(address, label, tries < 6)) return;
+					if (props.openResource && address && props.openResource(address, label, tries < 6)) return;
 					if (tries < 14) {
 						setTimeout(tick, 130);
 						return;
@@ -2328,6 +2451,25 @@ window.__ModuleLoader__.load({
 				}
 			};
 			const closeDetail = () => setDetail(null);
+			/** 中断运行（面板内两个入口共用）：成功后刷新产品线视图；详情浮层开着就顺手把快照也换新。 */
+			const cancelRun = async (runId) => {
+				if (!api) return;
+				try {
+					await api.cancel(runId);
+					loadView(state.current, true);
+					if (detail && detail.kind === "run" && detail.data && detail.data.id === runId) setDetail({
+						kind: "run",
+						data: await api.runDetail(runId),
+						run: detail.run
+					});
+					setHint(t("cancel.sent"));
+				} catch (e) {
+					setState((s) => ({
+						...s,
+						err: String(e && e.message || e)
+					}));
+				}
+			};
 			const openRun = (r) => {
 				goOwnerSessionAndOpen({
 					ownerSession: r.ownerSession,
@@ -2516,7 +2658,8 @@ window.__ModuleLoader__.load({
 				runs: visibleRuns,
 				activeRunId: detail && detail.kind === "run" && detail.run ? detail.run.id : null,
 				onOpenRun: openRun,
-				onInlineRun: showInline
+				onInlineRun: showInline,
+				onCancel: cancelRun
 			}) : muted(t("panel.emptyRunFilter"), { fontSize: 10.5 }), muted(t("panel.runHint"), {
 				fontSize: 10,
 				marginTop: 8
@@ -2570,7 +2713,8 @@ window.__ModuleLoader__.load({
 			}, t("common.close")))), h(RunDetailPane, {
 				snap: detail && detail.data,
 				product: state.current,
-				api
+				api,
+				onCancel: cancelRun
 			}))) : null));
 		}
 		//#endregion
@@ -2592,7 +2736,7 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"remote",
 			"slots",
-			"sessions",
+			"uiWorkspace",
 			"locale"
 		];
 		const NODE_W = 300;
@@ -2613,7 +2757,7 @@ window.__ModuleLoader__.load({
 			let maxH = 0;
 			groups.forEach((g, i) => {
 				const anyRun = g.stages.some((s) => s.status === "running");
-				const anyFail = g.stages.some((s) => s.status === "failed" || s.status === "needs-human" || s.status === "cancelled");
+				const anyFail = g.stages.some((s) => s.status === "failed" || s.status === "needs-human");
 				const allDone = g.stages.length > 0 && g.stages.every((s) => s.status === "done");
 				const headColor = anyRun ? T.brand : anyFail ? T.error : allDone ? T.success : T.text2;
 				const h = 48 + g.stages.reduce((a, s) => a + cardH(s), 0) + Math.max(0, g.stages.length - 1) * 7;
@@ -2725,7 +2869,7 @@ window.__ModuleLoader__.load({
 					lineHeight: "15px",
 					flex: "0 0 auto"
 				}
-			}, `↻${s.attempts.length - 1}`) : null, chip(stText(s.status), color, { dot: true }), h("span", { style: {
+			}, `↻${s.attempts.length - 1}`) : null, chip(stageStatusText(s.status), color, { dot: true }), h("span", { style: {
 				color: T.text2,
 				fontSize: 11,
 				opacity: .5
@@ -2838,7 +2982,7 @@ window.__ModuleLoader__.load({
 		/** 阶段详情抽屉（卡片点击打开；浮于画布右侧，不参与拖动/缩放）。
 		* 2026-09-06 状态机化：同任务多次尝试 → 顶部尝试时间线 + 选中展开（默认最新）；
 		* 单次尝试保持现状（不渲染时间线）。 */
-		function StageDetailDrawer({ det, onClose, sessionId, sessions }) {
+		function StageDetailDrawer({ det, onClose, sessionId, uiWorkspace }) {
 			const [sel, setSel] = react.default.useState(null);
 			const st = det.stage;
 			const d = det.data;
@@ -2849,11 +2993,11 @@ window.__ModuleLoader__.load({
 			const ownerSession = d && d.ownerSession ? String(d.ownerSession) : null;
 			const mySession = sessionId ? String(sessionId) : null;
 			const crossSession = !!ownerSession && !!mySession && ownerSession !== mySession;
-			const hasChild = !!(!crossSession && cur && cur.childId && sessions && typeof sessions.openSubagent === "function");
+			const hasChild = !!(!crossSession && cur && cur.childId && uiWorkspace && typeof uiWorkspace.openSession === "function");
 			const openChild = () => {
 				if (crossSession || !hasChild) return;
 				try {
-					sessions.openSubagent({
+					uiWorkspace.openSession({
 						parentSessionId: ownerSession || sessionId,
 						childSessionId: cur.childId,
 						mode: "one-shot"
@@ -2928,7 +3072,7 @@ window.__ModuleLoader__.load({
 				marginTop: 1,
 				fontFamily: MONO,
 				fontVariantNumeric: "tabular-nums"
-			} }, `${st ? `#${st.seq} · ${st.phase}` : ""}${st && (st.startedAt || st.endedAt) ? ` · ${fmtDur(st.startedAt, st.endedAt)}` : ""}`)), st ? chip(stText(st.status), color, { dot: true }) : null, h("button", {
+			} }, `${st ? `#${st.seq} · ${st.phase}` : ""}${st && (st.startedAt || st.endedAt) ? ` · ${fmtDur(st.startedAt, st.endedAt)}` : ""}`)), st ? chip(stageStatusText(st.status), color, { dot: true }) : null, h("button", {
 				onClick: onClose,
 				style: closeBtn,
 				title: t("common.close")
@@ -2993,7 +3137,7 @@ window.__ModuleLoader__.load({
 					color: aColor,
 					flex: "0 0 64px",
 					fontWeight: 700
-				} }, a.status === "done" ? t("stage.attemptDone") : a.status === "failed" ? t("stage.attemptFailed", { outcome: a.outcome || t("common.failed") }) : t("stage.attemptRunning")), h("span", { style: {
+				} }, a.status === "done" ? t("stage.attemptDone") : a.status === "failed" ? t("stage.attemptFailed", { outcome: a.outcome || t("common.failed") }) : a.status === "cancelled" ? t("stageStatus.cancelled") : t("stage.attemptRunning")), h("span", { style: {
 					flex: 1,
 					minWidth: 0,
 					fontSize: 10.5,
@@ -3099,7 +3243,7 @@ window.__ModuleLoader__.load({
 				overflowY: "auto"
 			} }, outText))));
 		}
-		function PipelinePanel({ active, api, runId, sessionId, sessions }) {
+		function PipelinePanel({ active, api, runId, sessionId, uiWorkspace }) {
 			if (!active) return h("div", { style: {
 				color: T.text2,
 				fontSize: 13,
@@ -3438,7 +3582,7 @@ window.__ModuleLoader__.load({
 				det,
 				onClose: closeDet,
 				sessionId,
-				sessions
+				uiWorkspace
 			}) : null);
 		}
 		function BoardPanel({ backlog, api, onRefresh, sessionId, onShowRun, openArtifact }) {
@@ -4456,6 +4600,26 @@ window.__ModuleLoader__.load({
 				setBusy(false);
 			};
 			const anyRunning = runs.some((r) => r.status === "running" || r.status === "pending");
+			const runningRun = !!(activeRun && activeRun.status === "running");
+			/** 中断请求已发出：按钮先隐藏，等 2s 轮询把状态刷成 cancelled（避免重复点出「未生效」提示）。 */
+			const [cancelSentFor, setCancelSentFor] = react.default.useState(null);
+			react.default.useEffect(() => {
+				setCancelSentFor(null);
+			}, [activeRun && activeRun.id, activeRun && activeRun.status]);
+			const onCancel = async (id) => {
+				if (!api) return;
+				try {
+					const r = unwrap(await api.cancel(id), "cancel");
+					if (!r || r.ok !== true) throw new Error(t("cancel.failed"));
+					setCancelSentFor(id);
+					refresh();
+				} catch (e) {
+					setState((s) => ({
+						...s,
+						err: String(e && e.message || e)
+					}));
+				}
+			};
 			const btn = {
 				font: "inherit",
 				fontSize: 12,
@@ -4545,7 +4709,12 @@ window.__ModuleLoader__.load({
 					alignItems: "center",
 					gap: 5
 				}
-			}, t("workbench.refresh")), canResume ? h("button", {
+			}, t("workbench.refresh")), runningRun && cancelSentFor !== activeRun.id ? h(CancelButton, {
+				runId: activeRun.id,
+				label: t("cancel.btnWithId", { id: String(activeRun.id).slice(-6) }),
+				title: t("cancel.tip", { id: activeRun.id }),
+				onConfirm: onCancel
+			}) : null, canResume ? h("button", {
 				onClick: onResume,
 				disabled: busy,
 				title: t("workbench.resumeTip", {
@@ -4690,7 +4859,7 @@ window.__ModuleLoader__.load({
 				api,
 				runId: activeRun ? activeRun.id : null,
 				sessionId: props.sessionId,
-				sessions: props.sessions
+				uiWorkspace: props.uiWorkspace
 			}) : h(BoardPanel, {
 				backlog,
 				api,
@@ -4769,7 +4938,7 @@ window.__ModuleLoader__.load({
 				locale: NS,
 				inject: () => ({
 					remote: teamflow,
-					sessions: ctx.get("sessions"),
+					uiWorkspace: ctx.get("uiWorkspace"),
 					layout: ctx.get("layout"),
 					openResource: openResourceSafe,
 					openArtifact
@@ -4800,7 +4969,7 @@ window.__ModuleLoader__.load({
 				inject: (sessionId) => ({
 					sessionId,
 					remote: teamflow,
-					sessions: ctx.get("sessions"),
+					uiWorkspace: ctx.get("uiWorkspace"),
 					openArtifact,
 					openResource: openResourceSafe
 				})

package/lib/descriptors.mjs

@@ -1,9 +1,13 @@
 //#region descriptors.ts
+/** 恒等 parse：接受任意 JSON 值，原样返回。 */
+const JSON_SCHEMA = { parse: (value) => value };
 /** 统一 strict codec（本插件所有参数/结果均为自由 JSON）。 */
 const strict = {
 	mode: "strict",
 	typeSymbol: "dsh-plugin-teamflow/types#Json",
-	schema: { parse: (value) => value }
+	schema: JSON_SCHEMA,
+	/** 首次跨边界使用时物化 schema（宿主按需调用，只调一次并缓存）。 */
+	create: () => JSON_SCHEMA
 };
 const p = (name) => ({
 	name,