@tea-agent/loop-agent 0.41.1-beta.0 → 0.42.0-next.2

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-node-purpose.js

@@ -39,25 +39,20 @@ 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/state.js

@@ -82,7 +82,9 @@ export const uiState = {
 	dagNodeExecutionOutputLoading: false,
 	dagNodeExecutionOutputError: null,
 	dagNodeExecutionOutputKey: null,
-	/** When true,「执行过程」展开 message_start/end 原始协议事件。默认隐藏，用户可点选展开。 */
+	/** Unified execution-record filter: all model/tool/process facts by default. */
+	executionRecordFilter: "all",
+	/** When true,「执行记录」展开 message_start/end 原始协议事件。默认隐藏，避免重复淹没语义记录。 */
 	sessionTimelineShowProtocol: false,
 	/** Open <details> keys restored across timeline re-renders. */
 	sessionTimelineOpenDetails: null,