@tea-agent/loop-agent 0.39.2 → 0.40.0-beta.1

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

@@ -1,8 +1,12 @@
 /** Fetch and artifact helpers (Observe UI R5). */
+import {
+	fetchWithWorkspaceScope,
+	workspaceScope,
+} from "./state.js";
 
 export async function fetchJson(url) {
 	try {
-		const res = await fetch(url);
+		const res = await fetchWithWorkspaceScope(url);
 		if (!res.ok) return null;
 		return await res.json();
 	} catch {
@@ -18,7 +22,10 @@ export async function fetchJson(url) {
 export async function fetchJsonResult(url, options = {}) {
 	const signal = options?.signal;
 	try {
-		const res = await fetch(url, signal ? { signal } : undefined);
+		const res = await fetchWithWorkspaceScope(
+			url,
+			signal ? { signal } : undefined,
+		);
 		let body = null;
 		try {
 			body = await res.json();
@@ -77,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));
@@ -92,7 +122,7 @@ export async function fetchDagNodeProcess(runId, nodeId, key) {
  */
 export async function fetchSpecEvidenceFile(runId, nodeId, source, relPath) {
 	const url = `/api/dag-runs/${encodeURIComponent(runId)}/nodes/${encodeURIComponent(nodeId)}/spec-evidence/file?source=${encodeURIComponent(source)}&path=${encodeURIComponent(relPath)}`;
-	const res = await fetch(url);
+	const res = await fetchWithWorkspaceScope(url);
 	let body = null;
 	try {
 		body = await res.json();
@@ -116,29 +146,57 @@ 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();
+	if (!workspaceId) {
+		return {
+			ok: false,
+			status: 400,
+			body: {
+				error: {
+					code: "WORKSPACE_REQUIRED",
+					message: "workspaceId is required",
+				},
+			},
 		};
 	}
 	try {
-		const res = await fetch("/api/operator/v1/operations", {
+		const res = await fetchWithWorkspaceScope("/api/operator/v1/operations", {
 			method: "POST",
 			credentials: "same-origin",
 			headers: {
 				"Content-Type": "application/json",
 				"x-loop-console-confirmation": token,
 			},
-			body: JSON.stringify({ action, actionParams }),
+			body: JSON.stringify({
+				workspaceId,
+				action,
+				actionParams,
+				clientRequestId,
+			}),
 		});
 		let body = null;
 		try {
@@ -152,10 +210,36 @@ 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 {
-		const res = await fetch(
+		const res = await fetchWithWorkspaceScope(
 			`/api/operator/v1/operations/${encodeURIComponent(operationId)}`,
 			{ credentials: "same-origin" },
 		);

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

@@ -1,9 +1,8 @@
-/** Observe UI bootstrap: route wiring, listeners, compatibility re-exports. */
+/** Observe UI bootstrap: standalone compatibility entry + re-exports. */
 import {
 	parseHashRoute,
 	parseHashRouteWithFilters,
 	buildHashPath,
-	parseRoute,
 } from "./router.js";
 import { parseArtifactPreviewResponse } from "./api.js";
 import {
@@ -15,7 +14,6 @@ import {
 } from "./relations.js";
 import { copyText, renderRecommendedCommand } from "./copy.js";
 import {
-	isPageVisible,
 	detailPollDelay,
 	updateDagGraphViewportState,
 	captureDagGraphViewportState,
@@ -25,11 +23,9 @@ import {
 	shouldReuseDagDetailShell,
 	shouldPreserveDiagnosticsOpen,
 	isInteractiveGestureActive,
-	stopTimers,
 	renderViewState,
 	mountViewState,
 	viewStateDescriptor,
-	uiState,
 } from "./state.js";
 import { sortPoolTasks, poolStatusCounts } from "./format-pool.js";
 import {
@@ -45,34 +41,22 @@ import {
 	dashboardVisibleFeatures,
 	findDagForRun,
 } from "./dag-model.js";
-
-import { renderFailures } from "./views/failures.js";
-import { startPoolView } from "./views/pool.js";
-import { startDashboardPolling } from "./views/dashboard.js";
-import { startDagsView } from "./views/dags.js";
-import { renderFeatureDetail } from "./views/feature.js";
-import { renderBatch } from "./views/batch.js";
-import { startTaskPolling } from "./views/task.js";
-import { startRunPolling } from "./views/run.js";
-import { startDagPolling } from "./views/dag.js";
 import { renderDagGraph } from "./views/dag-graph.js";
-import { renderNightJobs } from "./views/night.js";
 import {
 	selectDagNode,
 	closeDagInspector,
-	closeDagInspectorOnOutsideClick,
 	renderDagInspector,
 } from "./views/dag-inspector.js";
 import {
 	mergeSessionEvents,
 	renderSessionTimeline,
 } from "./views/session-timeline.js";
-import { mountOperatorChrome } from "./operator-chrome.js";
+import {
+	route,
+	startStandaloneInspect,
+	tryCanonicalizeStandaloneInspect,
+} from "./inspect-workspace.js";
 
-// Compatibility re-exports for poll-stable UI helpers (owned by state.js / views):
-// reuse-dag-detail-shell, reuse-dag-graph-wrap, existingGraphWrap?.parentNode === ranksEl,
-// existingDetails?.parentNode === metaEl, let pre = existingPre, computeFollowLatest,
-// updateDagOutputViewportState, isInteractiveGestureActive.
 export {
 	detailPollDelay,
 	parseMarkdownBlocks,
@@ -114,56 +98,20 @@ export {
 	renderDagInspector,
 	renderSessionTimeline,
 	mergeSessionEvents,
+	route,
+	tryCanonicalizeStandaloneInspect,
 };
 
-function route() {
-	stopTimers();
-	const r = parseRoute();
-	if (r.view === "dashboard") {
-		startDashboardPolling(r.scrollTo);
-	} else if (r.view === "dags") {
-		void startDagsView();
-	} else if (r.view === "batch") {
-		void renderBatch(r.batchRunId);
-	} else if (r.view === "run") {
-		startRunPolling(r.workerRunId);
-	} else if (r.view === "dag") {
-		startDagPolling(r.dagRunId);
-	} else if (r.view === "failures") {
-		void renderFailures();
-	} else if (r.view === "pool") {
-		startPoolView();
-	} else if (r.view === "night") {
-		void renderNightJobs(r.scheduleId);
-	} else if (r.view === "task") {
-		startTaskPolling(r.featureId, r.taskId);
-	} else if (r.view === "feature") {
-		void renderFeatureDetail(r.featureId);
-	}
-}
-
 if (typeof window !== "undefined") {
-	// 先同步挂载共享壳，再启动路由；首个 snapshot 的新鲜度不会因异步挂载丢失。
-	const chromeHost = document.getElementById("operator-chrome");
-	if (chromeHost) {
-		mountOperatorChrome(chromeHost, {
-			mode: "inspect",
-			liveLocation: true,
-			healthUrl: "/api/health",
-			readinessTitle: "Pi 状态（只读展示）。模型与认证管理在操作侧，点击进入。",
-		});
+	// Compatibility listeners remain owned by inspect-workspace.js:
+	// window.addEventListener("hashchange", route)
+	// window.addEventListener("load", route)
+	// document.addEventListener("pointerdown", closeDagInspectorOnOutsideClick)
+	// document.addEventListener("visibilitychange", ...)
+	// reuse-dag-detail-shell, reuse-dag-graph-wrap, existingGraphWrap?.parentNode === ranksEl,
+	// existingDetails?.parentNode === metaEl, let pre = existingPre, computeFollowLatest,
+	// updateDagOutputViewportState, isInteractiveGestureActive.
+	if (!tryCanonicalizeStandaloneInspect(window.location)) {
+		startStandaloneInspect();
 	}
-	window.addEventListener("hashchange", route);
-	window.addEventListener("load", route);
-	document.addEventListener("pointerdown", closeDagInspectorOnOutsideClick);
-	document.addEventListener("visibilitychange", () => {
-		if (!isPageVisible()) return;
-		const r = parseRoute();
-		if (r.view === "dashboard") startDashboardPolling();
-		// History page is manual-refresh only (no 5s dashboard polling).
-		if (r.view === "run") startRunPolling(r.workerRunId, false);
-		if (r.view === "dag") startDagPolling(r.dagRunId, false);
-		if (r.view === "pool" && uiState.poolAutoRefresh) startPoolView();
-		if (r.view === "task") startTaskPolling(r.featureId, r.taskId);
-	});
 }

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/index.html

@@ -210,7 +210,7 @@
               >
                 刷新
               </button>
-              <a class="page-action-btn" href="/#/night">在操作台管理 →</a>
+              <a class="page-action-btn" href="/#/operate/night">在操作台管理 →</a>
             </div>
           </header>
           <section