@tea-agent/loop-agent 0.41.1 → 0.42.0-next.10

package/dist/worker/observe/static/api.js

@@ -84,6 +84,29 @@ export async function fetchDagNodeInput(runId, nodeId) {
 	return fetchJsonResult(url);
 }
 
+export async function fetchDagNodeContext(runId, nodeId, attempt) {
+	const params = new URLSearchParams();
+	if (attempt != null) params.set("attempt", String(attempt));
+	const query = params.toString();
+	const url = `/api/dag-runs/${encodeURIComponent(runId)}/nodes/${encodeURIComponent(nodeId)}/context${query ? `?${query}` : ""}`;
+	return fetchJsonResult(url);
+}
+
+export async function fetchDagNodeArtifacts(runId, nodeId) {
+	const url = `/api/dag-runs/${encodeURIComponent(runId)}/nodes/${encodeURIComponent(nodeId)}/artifacts`;
+	return fetchJsonResult(url);
+}
+
+export async function fetchDagNodeArtifactPreview(runId, nodeId, artifactId) {
+	const params = new URLSearchParams({ artifactId: String(artifactId ?? "") });
+	const url = `/api/dag-runs/${encodeURIComponent(runId)}/nodes/${encodeURIComponent(nodeId)}/artifacts/preview?${params.toString()}`;
+	return fetchJsonResult(url);
+}
+
+export async function fetchDagRunLineage(runId) {
+	return fetchJsonResult(`/api/dag-runs/${encodeURIComponent(runId)}/lineage`);
+}
+
 export async function fetchDagNodeProcess(runId, nodeId, key) {
 	const params = new URLSearchParams();
 	if (key) params.set("key", String(key));
@@ -123,18 +146,28 @@ export function artifactUrl(artifactPath) {
  * Experimental (prompt-override rerun only): POST one allowlisted operator
  * action through the Console mutation gate using the SCOPED inspect token
  * (window.__INSPECT_MUTATION_TOKEN__). The server injects it into /inspect
- * HTML by default; HARNESS_DAG_RERUN_PROMPT_OVERRIDE=0|false|off disables
- * injection. The token only authorizes dagRerunPlan / dagRerun — never general
+ * HTML and into the Console SPA (which hosts the /inspect workspace) by
+ * default; HARNESS_DAG_RERUN_PROMPT_OVERRIDE=0|false|off disables injection.
+ * The token only authorizes dagRerunPlan / dagRerun — never general
  * Console mutations.
  * Absent token → the call is not attempted.
  */
-export async function postOperatorAction(action, actionParams = {}) {
+export async function postOperatorAction(
+	action,
+	actionParams = {},
+	clientRequestId,
+) {
 	const token = globalThis.__INSPECT_MUTATION_TOKEN__;
 	if (!token) {
 		return {
 			ok: false,
 			status: 0,
-			body: { error: { code: "PROMPT_OVERRIDE_DISABLED", message: "提示词重启未启用（服务端未注入确认 token）" } },
+			body: {
+				error: {
+					code: "PROMPT_OVERRIDE_DISABLED",
+					message: "提示词重启未启用（服务端未注入确认 token）",
+				},
+			},
 		};
 	}
 	const workspaceId = workspaceScope();
@@ -158,7 +191,12 @@ export async function postOperatorAction(action, actionParams = {}) {
 				"Content-Type": "application/json",
 				"x-loop-console-confirmation": token,
 			},
-			body: JSON.stringify({ workspaceId, action, actionParams }),
+			body: JSON.stringify({
+				workspaceId,
+				action,
+				actionParams,
+				clientRequestId,
+			}),
 		});
 		let body = null;
 		try {
@@ -172,6 +210,32 @@ export async function postOperatorAction(action, actionParams = {}) {
 	}
 }
 
+export async function downloadContextExport(downloadUrl) {
+	const token = globalThis.__INSPECT_MUTATION_TOKEN__;
+	if (!token) throw new Error("导出下载能力未启用");
+	const res = await fetchWithWorkspaceScope(downloadUrl, {
+		method: "GET",
+		credentials: "same-origin",
+		headers: { "x-loop-console-confirmation": token },
+	});
+	if (!res.ok) {
+		let message = `下载失败：HTTP ${res.status}`;
+		try {
+			const body = await res.json();
+			message = body?.error?.message ?? message;
+		} catch {
+			// Preserve bounded local fallback copy.
+		}
+		throw new Error(message);
+	}
+	return {
+		blob: await res.blob(),
+		filename:
+			/filename="([^"]+)"/.exec(res.headers.get("content-disposition") ?? "")?.[1] ??
+			"context-bundle.zip",
+	};
+}
+
 /** Poll a Console operation snapshot (read-only GET). */
 export async function fetchOperatorOperation(operationId) {
 	try {

package/dist/worker/observe/static/dag-context-reason-labels.d.ts

@@ -0,0 +1,9 @@
+export function contextTransferReasonLabel(
+	reasonCode: string | null | undefined,
+): string | null;
+export function formatContextTransferReasonList(
+	reasonCodes: readonly (string | null | undefined)[] | null | undefined,
+): string | null;
+export function describeTransferError(
+	message: string | null | undefined,
+): string | null;

package/dist/worker/observe/static/dag-context-reason-labels.js

@@ -0,0 +1,120 @@
+/**
+ * Context transfer / artifact revision 稳定 reason code 的操作者文案映射
+ * （Observe UI，exec-plan 2026-08-25-console-node-context-artifact-rerun W1.5）。
+ *
+ * 表驱动纯函数：已知 code 映射为中文业务术语，未知 code fail-closed 返回
+ * null（调用方保留原始 token 展示，不猜测、不解释为成功）。
+ * 冻结 code 清单见 src/shared/context-transfer.ts CONTEXT_TRANSFER_REASON_CODES；
+ * 附加条目为 Console operation / rerun 执行面会透传到 Inspector 的错误码。
+ */
+
+const CONTEXT_TRANSFER_REASON_LABELS = {
+	CONTEXT_RECEIPT_MISSING: "该节点没有执行时上下文回执",
+	CONTEXT_COMPONENT_UNAVAILABLE: "部分上下文组件当前不可用",
+	CONTEXT_BUNDLE_INEXACT: "导出等级为近似恢复，不是精确重放",
+	CONTEXT_BUNDLE_TOO_LARGE: "导出内容超出体积上限",
+	RAW_EXPORT_ACKNOWLEDGEMENT_REQUIRED: "原文导出需要显式确认敏感数据风险",
+	SECRET_SCAN_CONFIRMATION_REQUIRED: "候选文件疑似包含凭据，需确认后才能继续",
+	ARTIFACT_BINDING_UNAVAILABLE: "缺少结构化产物关系",
+	ARTIFACT_NOT_REVISION_ELIGIBLE: "该产物不允许修订替换",
+	ARTIFACT_IDENTITY_AMBIGUOUS: "产物身份不唯一，无法安全定位",
+	ARTIFACT_REVISION_SCHEMA_INVALID: "候选文件不符合声明的数据结构",
+	ARTIFACT_REVISION_PATH_INVALID: "候选目标路径无效",
+	ARTIFACT_REVISION_EXPIRED: "修订候选已过期，需要重新上传",
+	ARTIFACT_REVISION_DRIFT: "候选文件与登记内容不一致",
+	ARTIFACT_REVISION_QUOTA_EXCEEDED: "修订暂存区配额已满，请先清理或等待过期回收",
+	ARTIFACT_CONSUMER_UNKNOWN: "无法确定受影响的下游节点",
+	ARTIFACT_IMPACT_UNSAFE: "影响范围包含不能自动重跑的节点",
+	RERUN_PLAN_DRIFT: "继续运行计划与当前事实发生漂移",
+	WORKER_MANAGED_CONTINUATION_UNSUPPORTED: "由 Worker 托管的运行暂不支持派生继续",
+	WORKER_CONTINUATION_AUTHORITY_MISMATCH: "Worker 派生运行的归属事实不一致",
+	WORKER_CONTINUATION_NEEDS_RECONCILE: "Worker 派生运行已存在，需要先恢复核对",
+	WORKER_CONTINUATION_LEASE_CONFLICT: "该 Worker Task 已有运行占用",
+	INELIGIBLE: "当前不满足继续运行的条件",
+	PARENT_IMMUTABILITY_VIOLATION: "父运行事实发生变化，已阻止派生",
+	PARENT_LIFECYCLE: "父运行状态不允许派生继续",
+	PLAN_DRIFT: "计划与执行前校验不一致",
+	REQUEST_ID_REUSE_CONFLICT: "相同请求 ID 已被其他操作占用",
+	OPERATION_NEEDS_RECONCILE: "操作记录需要先恢复核对",
+	CONTEXT_EXPORT_FAILED: "上下文导出失败",
+	CONTEXT_EXPORT_UNAVAILABLE: "导出内容不存在或已过期",
+	LEASE_HELD: "资源正被其他操作占用",
+	NOT_FOUND: "目标不存在或已过期",
+	// Console operation 面会透传的通用错误码。
+	INVALID_INPUT: "请求参数不完整或不合法",
+	INTERNAL_ERROR: "内部错误，请重试；若持续失败请查看操作诊断",
+	OPERATION_NOT_FOUND: "操作不存在或已被清理",
+	OPERATION_NOT_TERMINAL: "操作尚未结束，请稍后查询",
+};
+
+// 非 reason-code 形态、但会透传到检查器状态行的运行时错误 → 中文语义。
+const RUNTIME_ERROR_PATTERNS = [
+	{
+		pattern: /controller identity changed|package fingerprint changed/i,
+		copy:
+			"控制器版本已变更：Console 启动后代码被重新构建。请重启 Console 进程加载当前构建后重试本操作。",
+	},
+	{
+		pattern:
+			/invalid (?:confirmation header |boot capability )?token|mutation requires (?:boot capability cookie|confirmation header token)/i,
+		copy:
+			"页面凭证已失效（Console 可能已重启，或页面是重启前的旧缓存）。请强制刷新页面（Cmd/Ctrl+Shift+R）后重试。",
+	},
+	{
+		pattern: /context receipt missing/i,
+		copy: "该节点没有执行时上下文回执，无法生成交接包。",
+	},
+];
+
+/**
+ * 已知 reason code → 中文业务术语；未知或缺失返回 null（调用方应原样展示
+ * 原始 token，保持诚实降级）。
+ */
+export function contextTransferReasonLabel(reasonCode) {
+	const key = String(reasonCode ?? "");
+	if (!key) return null;
+	return CONTEXT_TRANSFER_REASON_LABELS[key] ?? null;
+}
+
+/**
+ * reason code 列表 → 面向操作者的展示串：已知项输出「中文（CODE）」，
+ * 未知项原样保留；空输入返回 null 供调用方守卫。
+ */
+export function formatContextTransferReasonList(reasonCodes) {
+	const codes = (Array.isArray(reasonCodes) ? reasonCodes : [])
+		.map((code) => String(code ?? ""))
+		.filter((code) => code.length > 0);
+	if (codes.length === 0) return null;
+	return codes
+		.map((code) => {
+			const label = contextTransferReasonLabel(code);
+			return label ? `${label}（${code}）` : code;
+		})
+		.join("；");
+}
+
+const REASON_CODE_SCAN_PATTERN = new RegExp(
+	`\\b(?:${Object.keys(CONTEXT_TRANSFER_REASON_LABELS).join("|")})\\b`,
+);
+
+/**
+ * 任意错误信息 → 面向操作者的语义化文案。扫描消息中嵌入的已知 reason
+ * code，命中时以中文业务术语开头并保留原码与原始信息；未命中已知 code
+ * 返回 null（调用方原样展示，不猜测成功、不编造解释）。
+ */
+export function describeTransferError(message) {
+	const raw = String(message ?? "").trim();
+	if (!raw) return null;
+	for (const entry of RUNTIME_ERROR_PATTERNS) {
+		if (entry.pattern.test(raw)) return entry.copy;
+	}
+	const match = REASON_CODE_SCAN_PATTERN.exec(raw);
+	if (!match) return null;
+	const label = contextTransferReasonLabel(match[0]);
+	if (!label) return null;
+	if (raw === match[0]) return `${label}（${match[0]}）`;
+	const rest = raw.replace(match[0], "").replace(/^[\s:：-]+/, "").trim();
+	return rest
+		? `${label}（${match[0]}）；原始信息：${rest}`
+		: `${label}（${match[0]}）`;
+}

package/dist/worker/observe/static/dag-helpers.js

@@ -6,7 +6,7 @@ import {
 	formatDuration,
 	formatAgo,
 } from "./format.js";
-import { navigate } from "./router.js";
+import { inspectPathToCanonicalHref, navigate } from "./router.js";
 
 export function isNodeActive(status) {
 	if (!status) return false;
@@ -151,7 +151,9 @@ export function frontendLintSummary(frontendLint) {
 	card.appendChild(meta);
 
 	const link = el("a", "active-dag-link", UI_TEXT.enterDetail);
-	link.href = `#/dag/${encodeURIComponent(dag.dagRunId)}`;
+	link.href = inspectPathToCanonicalHref(
+		`/dag/${encodeURIComponent(dag.dagRunId)}`,
+	);
 	link.addEventListener("click", (e) => {
 		e.preventDefault();
 		navigate(`/dag/${encodeURIComponent(dag.dagRunId)}`);

package/dist/worker/observe/static/dag-node-purpose.js

@@ -39,20 +39,25 @@ const NODE_PURPOSE_BY_ID = {
 	"closeout-summary-pi": "把验证与交付事实写成简短交接摘要。",
 
 	"frontend-contract-pi": "把前端需求整理成可追踪契约：页面、状态、验收与边界。",
+	"frontend-contract-import-shell": "导入并固化前端实现契约，供后续设计、写入与验证节点使用。",
 	"frontend-scout-pi": "只读侦察前端结构、组件与接口用法，不改文件。",
 	"frontend-plan-pi": "选定实现与 Mock/API 策略，输出可执行的前端实现契约补丁。",
+	"frontend-design-policy-shell": "确定前端设计与 Mock/API 策略，冻结后续实现必须遵守的规则。",
 	"frontend-design-review-pi": "审查前端计划是否可写：通过则沿用原计划，否则要求修订。",
 	"frontend-plan-revision-pi": "按设计审查意见修订前端契约，不扩大范围。",
 	"frontend-final-design-review-pi": "复核修订后的前端计划，只有通过才能授权写入。",
 	"frontend-prewrite-gate-shell": "写入前门禁：核对契约、覆盖与 Mock 策略，通过才允许改前端。",
+	"frontend-writer-admission-shell": "核对契约、设计策略与 writeSet，满足准入条件后才允许 writer 写入。",
 	"frontend-lint-baseline-shell": "记录写入前的 lint 基线，供实现后对比，不阻断写入。",
 	"frontend-implement-pi": "按已批准契约改前端代码、状态与交互，留在 writeSet 内。",
 	"frontend-verify-assess-shell": "跑静态/行为/Mock 验证并评估能否有界修复。",
+	"frontend-verify-shell": "执行冻结的前端验证命令，产出可复查的通过或失败证据。",
 	"frontend-repair-pi": "只修评估为可修复的前端失败，不重开需求。",
 	"frontend-reverify-shell": "修复后用同一套冻结命令复验。",
 	"frontend-review-context-shell": "打包真实 diff 与有效验证证据，供审查节点使用。",
 	"frontend-review-pi": "对照契约审查前端实现与证据，给出通过或需修订。",
 	"frontend-review-gate-shell": "前端审查门禁：结论为通过才进入收口。",
+	"frontend-closeout-shell": "汇总实现、验证与遗留事项，形成确定性的前端收口事实。",
 	"frontend-closeout-pi": "汇总前端交付状态（含真实联调是否仍待完成）。",
 	"frontend-mock-assess-pi": "评估项目是否具备授权的 Mock 验证能力。",
 	"frontend-mock-contract-gate-shell": "Mock 契约门禁：策略与验证命令不一致则阻断。",

package/dist/worker/observe/static/inspect-workspace.js

@@ -10,6 +10,7 @@ import {
 	parseRoute,
 	setNavigateHandler,
 	inspectPathToCanonicalHref,
+	workspaceIdFromLocation,
 } from "./router.js";
 import {
 	isPageVisible,
@@ -93,6 +94,25 @@ function onInspectRootClick(event) {
 	navigateInspectPath(href);
 }
 
+/** Static Inspect markup still contains a few compatibility anchors. Normalize
+ * them on mount/route change so opening a link in a new tab preserves the
+ * workspace as reliably as an ordinary in-app click. Chat remains deliberately
+ * bare: its selected workspace is client state, not a hash contract. */
+function scopeInspectShellLinks(root, workspaceId) {
+	if (!root?.querySelectorAll) return;
+	for (const anchor of root.querySelectorAll("a[href]")) {
+		const href = anchor.getAttribute("href");
+		if (!href || href.startsWith("/#/chat") || href.startsWith("#/chat")) {
+			continue;
+		}
+		if (!isInspectShellHref(href)) continue;
+		anchor.setAttribute(
+			"href",
+			inspectPathToCanonicalHref(href, workspaceId),
+		);
+	}
+}
+
 function resumeInspectPolling() {
 	if (!isPageVisible() || !isWorkspaceActive()) return;
 	const r = lastInspectHash
@@ -187,6 +207,7 @@ export function startStandaloneInspect() {
 	if (typeof window === "undefined") return;
 	// Multi-workspace (AC-003): sync scope from the URL query before any fetch.
 	syncWorkspaceScopeFromLocation();
+	scopeInspectShellLinks(document, workspaceIdFromLocation());
 	window.addEventListener("hashchange", syncWorkspaceScopeFromLocation);
 	const chromeHost = document.getElementById("operator-chrome");
 	if (chromeHost) {
@@ -242,6 +263,7 @@ export function mountInspectWorkspace(root, options = {}) {
 
 	setNavigateHandler(onNavigate);
 	lastInspectHash = options.hash || (typeof location !== "undefined" ? location.hash : "");
+	scopeInspectShellLinks(root, workspaceIdFromHash(lastInspectHash));
 	setWorkspaceActive(options.active !== false);
 
 	const listenerAbort =
@@ -266,6 +288,7 @@ export function mountInspectWorkspace(root, options = {}) {
 		updateRoute(hashValue) {
 			if (host.destroyed) return;
 			lastInspectHash = hashValue || lastInspectHash;
+			scopeInspectShellLinks(root, workspaceIdFromHash(lastInspectHash));
 			if (!uiState.workspaceActive) return;
 			// AC-006: a hosted route update that carries a DIFFERENT workspaceId
 			// must not route under the old scope. Swap atomically:

package/dist/worker/observe/static/kpi.js

@@ -1,13 +1,13 @@
 /** KPI cards, projection fault, artifact/inbox links. */
 import { UI_TEXT } from "./constants.js";
 import { el } from "./dom.js";
-import { navigate } from "./router.js";
+import { inspectPathToCanonicalHref, navigate } from "./router.js";
 
 export function failuresInboxLink(count) {
 	const wrap = el("span", "kpi-value-with-link");
 	wrap.appendChild(el("span", "kpi-value-num", String(count)));
 	const a = el("a", "inbox-link", `${UI_TEXT.failureInbox} →`);
-	a.href = "#/failures";
+	a.href = inspectPathToCanonicalHref("/failures");
 	a.addEventListener("click", (e) => {
 		e.preventDefault();
 		navigate("/failures");

package/dist/worker/observe/static/operator-chrome.d.ts

@@ -62,10 +62,18 @@ export function parseInspectObjectView(
 export function activeInspectTabHref(hashValue: string): string | null;
 export function parseInspectContext(hashValue: string): InspectContext | null;
 export function resolveOperateHrefFromInspectHash(hashValue: string): string;
-export function buildOperateInterruptHref(dagRunId: string): string;
+export function buildOperateInterruptHref(
+	dagRunId: string,
+	options?: { workspaceId?: string | null },
+): string;
 export function buildInspectDagHref(
 	dagRunId: string,
-	options?: { from?: string },
+	options?: { from?: string; workspaceId?: string | null },
+): string;
+export function parseInspectWorkspaceId(hashValue: string): string | null;
+export function withWorkspaceQuery(
+	href: string,
+	workspaceId?: string | null,
 ): string;
 export function clearInspectContextSource(hashValue: string): string;
 export function repoBaseName(repoRoot: string): string;

package/dist/worker/observe/static/operator-chrome.js

@@ -11,6 +11,8 @@
  * mountOperatorChrome 仅在浏览器环境调用。
  */
 
+import { withWorkspaceQuery } from "./router.js";
+
 export const OPERATE_TABS = Object.freeze([
 	{ id: "tasks", label: "任务", href: "/#/operate/tasks" },
 	{ id: "recovery", label: "恢复", href: "/#/operate/recovery" },
@@ -52,16 +54,7 @@ export function parseInspectWorkspaceId(hashValue) {
 	return id || null;
 }
 
-export function withWorkspaceQuery(href, workspaceId) {
-	const raw = String(href ?? "");
-	if (!workspaceId) return raw;
-	const qIndex = raw.indexOf("?");
-	if (qIndex < 0) return `${raw}?workspaceId=${encodeURIComponent(workspaceId)}`;
-	const params = new URLSearchParams(raw.slice(qIndex + 1));
-	if (params.get("workspaceId") === workspaceId) return raw;
-	params.set("workspaceId", workspaceId);
-	return `${raw.slice(0, qIndex)}?${params.toString()}`;
-}
+export { withWorkspaceQuery };
 
 function splitHash(hashValue) {
 	const raw = String(hashValue ?? "").replace(/^#/, "");
@@ -129,13 +122,17 @@ export function parseInspectContext(hashValue) {
 	if (from !== "recovery") return null;
 	const returnParams = new URLSearchParams();
 	if (objectView.view === "dag") returnParams.set("dagRunId", objectView.id);
+	const workspaceId = parseInspectWorkspaceId(hashValue);
 	const suffix = returnParams.toString();
 	return {
 		view: objectView.view,
 		id: objectView.id,
 		from,
 		kindLabel: CONTEXT_KIND_LABELS[objectView.view] ?? objectView.view,
-		returnHref: `/#/operate/recovery${suffix ? `?${suffix}` : ""}`,
+		returnHref: withWorkspaceQuery(
+			`/#/operate/recovery${suffix ? `?${suffix}` : ""}`,
+			workspaceId,
+		),
 		returnLabel: "返回 恢复",
 	};
 }
@@ -143,21 +140,31 @@ export function parseInspectContext(hashValue) {
 /** 从 Inspect 切回操作侧：持有 DAG 选中时不丢对象（换动作不换对象）。 */
 export function resolveOperateHrefFromInspectHash(hashValue) {
 	const objectView = parseInspectObjectView(hashValue);
+	const workspaceId = parseInspectWorkspaceId(hashValue);
 	if (objectView?.view === "dag") {
-		return `/#/operate/recovery?dagRunId=${encodeURIComponent(objectView.id)}`;
+		return withWorkspaceQuery(
+			`/#/operate/recovery?dagRunId=${encodeURIComponent(objectView.id)}`,
+			workspaceId,
+		);
 	}
-	return "/#/operate/tasks";
+	return withWorkspaceQuery("/#/operate/tasks", workspaceId);
 }
 
 /** Inspect DAG 详情 → Operate Recovery 协作中止深链（只改导航，不发 mutation）。 */
-export function buildOperateInterruptHref(dagRunId) {
-	return `/#/operate/recovery?dagRunId=${encodeURIComponent(dagRunId)}&intent=interrupt`;
+export function buildOperateInterruptHref(dagRunId, options = {}) {
+	return withWorkspaceQuery(
+		`/#/operate/recovery?dagRunId=${encodeURIComponent(dagRunId)}&intent=interrupt`,
+		options.workspaceId,
+	);
 }
 
 /** 操作侧 → Inspect 的 canonical 深链（可携带 from 以激活上下文 chip）。 */
 export function buildInspectDagHref(dagRunId, options = {}) {
 	const base = `/#/inspect/dag/${encodeURIComponent(dagRunId)}`;
-	return options.from === "recovery" ? `${base}?from=recovery` : base;
+	return withWorkspaceQuery(
+		options.from === "recovery" ? `${base}?from=recovery` : base,
+		options.workspaceId,
+	);
 }
 
 /** 清除跨模式来源标记，但保留对象页上的其它查询参数与当前历史位置。 */
@@ -218,14 +225,19 @@ export function buildOperatorChromeModel(config) {
 				: []
 	).map((tab) => ({
 		...tab,
+		href: withWorkspaceQuery(
+			tab.href,
+			config.workspaceSwitcher?.activeId ?? config.workspaceId,
+		),
 		active:
-			tab.href ===
+			tab.href.split("?")[0] ===
 			(String(config.activeTabHref ?? "").split("?")[0] || null),
 	}));
 	const state = config.readinessState ?? "unknown";
 	const operateHref = config.operateHref ?? "/#/operate/tasks";
 	const inspectHref = config.inspectHref ?? "/#/inspect";
-	const activeWorkspaceId = config.workspaceSwitcher?.activeId ?? null;
+	const activeWorkspaceId =
+		config.workspaceSwitcher?.activeId ?? config.workspaceId ?? null;
 	return {
 		mode,
 		homeHref: withWorkspaceQuery(
@@ -245,13 +257,13 @@ export function buildOperatorChromeModel(config) {
 			{
 				id: "operate",
 				label: "操作",
-				href: operateHref,
+				href: withWorkspaceQuery(operateHref, activeWorkspaceId),
 				active: mode === "operate",
 			},
 			{
 				id: "inspect",
 				label: "观测",
-				href: inspectHref,
+				href: withWorkspaceQuery(inspectHref, activeWorkspaceId),
 				active: mode === "inspect",
 			},
 		],
@@ -261,9 +273,10 @@ export function buildOperatorChromeModel(config) {
 		pi: {
 			state,
 			label: READINESS_LABELS[state] ?? state,
-			href:
-				config.readinessHref ??
-				(mode === "inspect" ? "/#/operate/models" : "/#/operate/models"),
+			href: withWorkspaceQuery(
+				config.readinessHref ?? "/#/operate/models",
+				activeWorkspaceId,
+			),
 			title: config.readinessTitle ?? "",
 		},
 		workspaceTabsVisible: tabs.length > 0,
@@ -424,6 +437,7 @@ export function mountOperatorChrome(root, config = {}) {
 		const base = { ...currentConfig };
 		if (base.liveLocation) {
 			const hash = window.location.hash;
+			base.workspaceId = parseInspectWorkspaceId(hash);
 			base.activeTabHref = activeInspectTabHref(hash);
 			base.operateHref = resolveOperateHrefFromInspectHash(hash);
 			base.context = parseInspectContext(hash);

package/dist/worker/observe/static/relations.js

@@ -1,6 +1,6 @@
 /** Object relation navigation (Observe UI R5). */
 import { el } from "./dom.js";
-import { navigate } from "./router.js";
+import { inspectPathToCanonicalHref, navigate } from "./router.js";
 
 export function objectExistsInSnapshot(kind, id, snapshot, featureId) {
 	if (!id) return false;
@@ -48,7 +48,7 @@ export function objectRouteLink(kind, id, snapshot, featureId) {
 	if (!exists) return el("span", "muted", id);
 	const path = objectRoutePath(kind, id, featureId);
 	const a = el("a", "object-link", id);
-	a.href = `#${path}`;
+	a.href = inspectPathToCanonicalHref(path);
 	a.addEventListener("click", (e) => {
 		e.preventDefault();
 		e.stopPropagation();

package/dist/worker/observe/static/router.d.ts

@@ -18,7 +18,18 @@ export function parseRoute(): InspectHashRoute;
 export function setNavigateHandler(
 	handler: ((href: string) => void) | null,
 ): void;
-export function inspectPathToCanonicalHref(path: string): string;
+export function workspaceIdFromLocation(locationLike?: {
+	hash?: string;
+	search?: string;
+} | null): string | null;
+export function withWorkspaceQuery(
+	href: string,
+	workspaceId?: string | null,
+): string;
+export function inspectPathToCanonicalHref(
+	path: string,
+	workspaceId?: string | null,
+): string;
 export function navigate(path: string): void;
 
 export const DAG_HISTORY_DEFAULT_PAGE: number;

package/dist/worker/observe/static/router.js

@@ -70,15 +70,57 @@ export function setNavigateHandler(handler) {
 	navigateHandler = typeof handler === "function" ? handler : null;
 }
 
-export function inspectPathToCanonicalHref(path) {
+/** Read the selected workspace from either Console's canonical hash or the
+ * standalone Inspect document query. The latter remains a compatibility
+ * entrypoint, so it must not manufacture a scope when none was supplied. */
+export function workspaceIdFromLocation(locationLike = typeof location !== "undefined" ? location : null) {
+	if (!locationLike) return null;
+	const hash = String(locationLike.hash ?? "").replace(/^#/, "");
+	const hashQuery = hash.includes("?") ? hash.slice(hash.indexOf("?") + 1) : "";
+	const fromHash = new URLSearchParams(hashQuery).get("workspaceId")?.trim();
+	if (fromHash) return fromHash;
+	return new URLSearchParams(String(locationLike.search ?? ""))
+		.get("workspaceId")
+		?.trim() || null;
+}
+
+/** Add the current workspace to a Console hash href without changing the
+ * destination's own query. This is deliberately usable for Inspect, Operate,
+ * and Chat; Console canonicalization still strips scope from Chat itself. */
+export function withWorkspaceQuery(href, workspaceId = workspaceIdFromLocation()) {
+	const raw = String(href ?? "").trim();
+	const id = workspaceId?.trim();
+	if (!raw || !id) return raw;
+	const normalized = raw.startsWith("#") ? `/${raw}` : raw;
+	const qIndex = normalized.indexOf("?");
+	const base = qIndex >= 0 ? normalized.slice(0, qIndex) : normalized;
+	const query = new URLSearchParams(qIndex >= 0 ? normalized.slice(qIndex + 1) : "");
+	query.set("workspaceId", id);
+	return `${base}?${query.toString()}`;
+}
+
+export function inspectPathToCanonicalHref(path, workspaceId = workspaceIdFromLocation()) {
 	const raw = String(path ?? "");
-	if (raw.startsWith("/#/inspect")) return raw;
-	if (raw.startsWith("#/inspect")) return `/${raw}`;
+	if (raw.startsWith("/#/inspect")) return withWorkspaceQuery(raw, workspaceId);
+	if (raw.startsWith("#/inspect")) return withWorkspaceQuery(`/${raw}`, workspaceId);
+	// Inspect owns only its own paths.  Passing an Operate/Chat deep link through
+	// the old converter produced /#/inspect/#/operate/... and was the direct
+	// cause of the live-DAG interrupt link landing on the wrong page.
+	if (raw.startsWith("/#/operate") || raw.startsWith("/#/chat")) {
+		return withWorkspaceQuery(raw, workspaceId);
+	}
+	if (raw.startsWith("#/operate") || raw.startsWith("#/chat")) {
+		return withWorkspaceQuery(`/${raw}`, workspaceId);
+	}
 	const stripped = raw.replace(/^#/, "");
 	const withSlash = stripped.startsWith("/") ? stripped : `/${stripped}`;
-	if (withSlash === "/inspect" || withSlash === "/") return "/#/inspect";
-	if (withSlash.startsWith("/inspect/")) return `/#${withSlash}`;
-	return `/#/inspect${withSlash}`;
+	if (withSlash === "/inspect" || withSlash === "/") {
+		return withWorkspaceQuery("/#/inspect", workspaceId);
+	}
+	if (withSlash.startsWith("/inspect/")) {
+		return withWorkspaceQuery(`/#${withSlash}`, workspaceId);
+	}
+	return withWorkspaceQuery(`/#/inspect${withSlash}`, workspaceId);
 }
 
 export function navigate(path) {

package/dist/worker/observe/static/run-processing.js

@@ -6,7 +6,7 @@ import {
 	ARTIFACT_KEYS,
 } from "./constants.js";
 import { badge } from "./format.js";
-import { navigate } from "./router.js";
+import { inspectPathToCanonicalHref, navigate } from "./router.js";
 
 export function stepDisplayLabel(label) {
 	return STEP_LABELS[label] ?? label;
@@ -127,7 +127,9 @@ export function taskRunHistoryRow(run) {
 	let runLink = run.workerRunId;
 	if (run.workerRunId) {
 		const a = document.createElement("a");
-		a.href = `#/run/${encodeURIComponent(run.workerRunId)}`;
+		a.href = inspectPathToCanonicalHref(
+			`/run/${encodeURIComponent(run.workerRunId)}`,
+		);
 		a.textContent = run.workerRunId;
 		a.addEventListener("click", (e) => {
 			e.preventDefault();