@tea-agent/loop-agent 0.24.5 → 0.24.7

package/dist/worker/observe/static/views/dag-inspector.js

@@ -10,12 +10,13 @@ import {
 	UI_TEXT,
 } from "../constants.js";
 import { clearNode, el } from "../dom.js";
-import { fetchJson, fetchSpecEvidenceFile } from "../api.js";
+import { fetchJson, fetchSpecEvidenceFile, fetchDagNodeInput } from "../api.js";
 import { badge } from "../format.js";
 import { renderMarkdown } from "../markdown-render.js";
 import {
 	uiState,
 	makeSessionEventIdentity,
+	makeDagNodeInputIdentity,
 	openSpecEvidenceDetail,
 	closeSpecEvidenceDetail,
 	updateDagTimelineViewportState,
@@ -50,9 +51,13 @@ export function selectDagNode(dagRunId, nodeId) {
 		// into node B's spec-evidence panel (AC-007 regression guard).
 		uiState.specEvidenceDetail = null;
 		uiState.specEvidenceListEvidence = null;
+		uiState.dagNodeInputData = null;
+		uiState.dagNodeInputError = null;
+		uiState.dagNodeInputLoading = false;
 		// Bump the session-event identity token so any in-flight response for the
 		// previous node is rejected before it can mutate the current node cache.
 		uiState.sessionEventIdentity = makeSessionEventIdentity(dagRunId, nodeId);
+		uiState.dagNodeInputIdentity = makeDagNodeInputIdentity(dagRunId, nodeId);
 	}
 	void import("./dag.js").then((m) => m.renderDagDetail(dagRunId, false));
 }
@@ -530,16 +535,337 @@ function renderSpecEvidenceDetail(content, dagRunId, nodeId) {
 	content.appendChild(wrapper);
 }
 
+function sourceLabel(source) {
+	if (source === "defaults") return "继承默认值";
+	if (source === "schema-default") return "schema 默认";
+	if (source === "merged") return "合并";
+	return null;
+}
+
+function appendMetaRow(dl, label, value, source) {
+	if (value == null || value === "") return;
+	const dt = el("dt", null, label);
+	const dd = el("dd", null, String(value));
+	const inherited = sourceLabel(source);
+	if (inherited) {
+		dd.appendChild(document.createTextNode(" "));
+		dd.appendChild(el("span", "node-input-inherited", inherited));
+	}
+	dl.appendChild(dt);
+	dl.appendChild(dd);
+}
+
+function appendCodeList(parent, title, values) {
+	if (!values || values.length === 0) return;
+	const section = el("section", "node-input-section");
+	section.appendChild(el("h4", null, title));
+	const list = el("ul", "node-input-code-list");
+	for (const value of values) {
+		const item = document.createElement("li");
+		const code = document.createElement("code");
+		code.textContent = String(value);
+		item.appendChild(code);
+		list.appendChild(item);
+	}
+	section.appendChild(list);
+	parent.appendChild(section);
+}
+
+function renderDagNodeInputDetail(content, data) {
+	const wrap = el("div", "node-input-root");
+	wrap.appendChild(
+		el("p", "node-input-semantics", UI_TEXT.inputFrozenLabel),
+	);
+
+	if (data.summary) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "摘要"));
+		const dl = el("dl", "node-input-summary");
+		appendMetaRow(
+			dl,
+			"executor",
+			data.summary.executor,
+			data.summary.executorSource,
+		);
+		appendMetaRow(dl, "role", data.summary.role, null);
+		appendMetaRow(dl, "complexity", data.summary.complexity, null);
+		appendMetaRow(
+			dl,
+			"writePolicy",
+			data.summary.writePolicy,
+			data.summary.writePolicySource,
+		);
+		appendMetaRow(dl, "toolProfile", data.summary.toolProfile, null);
+		section.appendChild(dl);
+		wrap.appendChild(section);
+	}
+
+	if (data.dependency) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "依赖"));
+		const dl = el("dl", "node-input-summary");
+		appendMetaRow(
+			dl,
+			"depends_on",
+			(data.dependency.dependsOn ?? []).join(", ") || "(none)",
+			null,
+		);
+		if (data.dependency.dependsPolicy) {
+			appendMetaRow(dl, "dependsPolicy", data.dependency.dependsPolicy, null);
+		}
+		if ((data.dependency.failureAwareDependsOn ?? []).length > 0) {
+			appendMetaRow(
+				dl,
+				"failureAwareDependsOn",
+				data.dependency.failureAwareDependsOn.join(", "),
+				null,
+			);
+		}
+		if (data.dependency.runIf) {
+			appendMetaRow(dl, "runIf", data.dependency.runIf, null);
+		}
+		section.appendChild(dl);
+		wrap.appendChild(section);
+	}
+
+	if (data.prompt) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "任务正文"));
+		if (data.prompt.source?.path) {
+			const meta = el("p", "muted");
+			meta.textContent = `source: ${data.prompt.source.path}${
+				data.prompt.source.sha256Prefix
+					? ` (sha256 ${data.prompt.source.sha256Prefix}…)`
+					: ""
+			}`;
+			section.appendChild(meta);
+		}
+		section.appendChild(renderMarkdown(data.prompt.text ?? ""));
+		if (data.prompt.truncated) {
+			section.appendChild(
+				el(
+					"p",
+					"node-input-truncated",
+					`已截断，仅显示前 ${data.prompt.maxBytes ?? 0} 字节（UTF-8）。`,
+				),
+			);
+		}
+		wrap.appendChild(section);
+	}
+
+	if (data.executorInput) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "执行器输入摘要"));
+		const dl = el("dl", "node-input-summary");
+		appendMetaRow(dl, "kind", data.executorInput.kind, null);
+		if (data.executorInput.modelHint) {
+			appendMetaRow(dl, "modelHint", data.executorInput.modelHint, null);
+		}
+		section.appendChild(dl);
+		appendCodeList(section, "skills", data.executorInput.skills);
+		if (data.executorInput.shell) {
+			const shell = data.executorInput.shell;
+			const shellDl = el("dl", "node-input-summary");
+			appendMetaRow(shellDl, "preset", shell.preset, null);
+			appendMetaRow(shellDl, "cwd", shell.cwd, null);
+			appendMetaRow(shellDl, "timeoutMs", shell.timeoutMs, null);
+			appendMetaRow(
+				shellDl,
+				"nonZeroExitPolicy",
+				shell.nonZeroExitPolicy,
+				null,
+			);
+			appendMetaRow(
+				shellDl,
+				"gates",
+				(shell.gates ?? []).join(", ") || "(none)",
+				null,
+			);
+			section.appendChild(shellDl);
+			if ((shell.commands ?? []).length > 0) {
+				const list = el("ol", "node-input-command-list");
+				for (const command of shell.commands) {
+					const item = document.createElement("li");
+					const pre = document.createElement("pre");
+					const code = document.createElement("code");
+					code.textContent = String(command);
+					pre.appendChild(code);
+					item.appendChild(pre);
+					list.appendChild(item);
+				}
+				section.appendChild(list);
+			}
+		}
+		if (data.executorInput.static) {
+			const staticBlock = data.executorInput.static;
+			const staticDl = el("dl", "node-input-summary");
+			appendMetaRow(staticDl, "status", staticBlock.status, null);
+			section.appendChild(staticDl);
+			section.appendChild(renderMarkdown(staticBlock.resultPreview ?? ""));
+			if (staticBlock.truncated) {
+				section.appendChild(
+					el(
+						"p",
+						"node-input-truncated",
+						`已截断，仅显示前 ${staticBlock.maxBytes ?? 0} 字节（UTF-8）。`,
+					),
+				);
+			}
+		}
+		wrap.appendChild(section);
+	}
+
+	if (data.boundaries) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "边界与输出契约"));
+		const dl = el("dl", "node-input-summary");
+		appendMetaRow(dl, "outputMode", data.boundaries.outputMode, null);
+		appendMetaRow(
+			dl,
+			"firstProtocolLine",
+			data.boundaries.firstProtocolLine,
+			null,
+		);
+		section.appendChild(dl);
+		if (data.boundaries.outputContract) {
+			section.appendChild(el("h5", null, "outputContract"));
+			section.appendChild(renderMarkdown(data.boundaries.outputContract));
+		}
+		appendCodeList(section, "allowedPaths", data.boundaries.allowedPaths);
+		appendCodeList(section, "forbiddenPaths", data.boundaries.forbiddenPaths);
+		appendCodeList(section, "writeSet", data.boundaries.writeSet);
+		wrap.appendChild(section);
+	}
+
+	if (data.promptFingerprint?.exists) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "Assembled prompt 指纹"));
+		const dl = el("dl", "node-input-summary");
+		appendMetaRow(
+			dl,
+			"sha256",
+			data.promptFingerprint.sha256Prefix ?? "(parse failed)",
+			null,
+		);
+		appendMetaRow(
+			dl,
+			"lengthChars",
+			data.promptFingerprint.lengthChars,
+			null,
+		);
+		appendMetaRow(dl, "artifact", data.promptFingerprint.artifact, null);
+		section.appendChild(dl);
+		section.appendChild(
+			el("p", "muted", UI_TEXT.inputFingerprintNote),
+		);
+		wrap.appendChild(section);
+	}
+
+	if ((data.warnings ?? []).length > 0) {
+		const section = el("section", "node-input-section");
+		section.appendChild(el("h4", null, "警告"));
+		for (const warning of data.warnings) {
+			section.appendChild(el("p", "node-input-warning", String(warning)));
+		}
+		wrap.appendChild(section);
+	}
+
+	content.appendChild(wrap);
+}
+
+function unavailableMessage(reason) {
+	if (reason === "unsupported-dynamic-node") {
+		return UI_TEXT.inputDynamicUnsupported;
+	}
+	if (reason === "run-spec-unavailable") {
+		return UI_TEXT.inputRunSpecUnavailable;
+	}
+	if (reason === "task-not-found") {
+		return UI_TEXT.inputUnavailable;
+	}
+	return UI_TEXT.noInput;
+}
+
+async function renderDagNodeInput(content, dagRunId, node) {
+	const nodeId = node.nodeId;
+	const identity = makeDagNodeInputIdentity(dagRunId, nodeId);
+	uiState.dagNodeInputIdentity = identity;
+	uiState.dagNodeInputLoading = true;
+	uiState.dagNodeInputError = null;
+
+	clearNode(content);
+	const loading = el("p", "muted", UI_TEXT.inputLoading);
+	loading.setAttribute("role", "status");
+	loading.setAttribute("aria-live", "polite");
+	content.appendChild(loading);
+
+	const result = await fetchDagNodeInput(dagRunId, nodeId);
+	if (
+		uiState.dagNodeInputIdentity !== identity ||
+		uiState.selectedDagNodeId !== nodeId ||
+		uiState.currentDagRunId !== dagRunId ||
+		uiState.dagInspectorTab !== "input" ||
+		!content.isConnected ||
+		content.dataset.dagNodeId !== String(nodeId) ||
+		content.dataset.dagRunId !== String(dagRunId)
+	) {
+		return;
+	}
+
+	uiState.dagNodeInputLoading = false;
+	clearNode(content);
+
+	if (!result.ok) {
+		const message =
+			result.body?.error ||
+			(result.status === 0
+				? UI_TEXT.inputError
+				: `${UI_TEXT.inputError}（HTTP ${result.status}）`);
+		uiState.dagNodeInputError = message;
+		uiState.dagNodeInputData = null;
+		const error = el("p", "node-input-error", message);
+		error.setAttribute("role", "alert");
+		content.appendChild(error);
+		return;
+	}
+
+	const data = result.body;
+	uiState.dagNodeInputData = data;
+	uiState.dagNodeInputError = null;
+	if (!data?.available) {
+		const empty = el(
+			"p",
+			"empty",
+			unavailableMessage(data?.availabilityReason),
+		);
+		empty.setAttribute("role", "status");
+		content.appendChild(empty);
+		if ((data?.warnings ?? []).length > 0) {
+			for (const warning of data.warnings) {
+				content.appendChild(el("p", "node-input-warning", String(warning)));
+			}
+		}
+		return;
+	}
+
+	renderDagNodeInputDetail(content, data);
+}
+
 	function fillDagInspectorContent(content, dagRunId, node) {
 		const previousRenderedNode = content.dataset.dagNodeId ?? "";
-		const nodeChanged = previousRenderedNode !== String(node.nodeId ?? "");
+		const previousRenderedRun = content.dataset.dagRunId ?? "";
+		const nodeChanged =
+			previousRenderedNode !== String(node.nodeId ?? "") ||
+			previousRenderedRun !== String(dagRunId ?? "");
 		if (nodeChanged) {
 			// Drop any open spec-evidence preview + cached list so a stale A detail
 			// cannot survive into node B (AC-007 regression guard).
 			uiState.specEvidenceDetail = null;
 			uiState.specEvidenceListEvidence = null;
+			uiState.dagNodeInputData = null;
+			uiState.dagNodeInputError = null;
 		}
-		const activeTab = ["timeline", "spec-evidence"].includes(
+		const activeTab = ["input", "timeline", "spec-evidence"].includes(
 			uiState.dagInspectorTab,
 		)
 			? uiState.dagInspectorTab
@@ -548,12 +874,15 @@ function renderSpecEvidenceDetail(content, dagRunId, nodeId) {
 		content.setAttribute("role", "tabpanel");
 		content.setAttribute("aria-labelledby", `dag-inspector-tab-${activeTab}`);
 		content.dataset.dagNodeId = String(node.nodeId ?? "");
+		content.dataset.dagRunId = String(dagRunId ?? "");
 		// Drop timeline-only classes when switching tabs so output layout stays clean.
 		content.className = "dag-inspector-content";
 		if (activeTab === "spec-evidence") {
 			void renderSpecEvidence(content, dagRunId, node.nodeId);
 		} else if (activeTab === "timeline") {
 			renderSessionTimeline(content, node.nodeId);
+		} else if (activeTab === "input") {
+			void renderDagNodeInput(content, dagRunId, node);
 		} else if (!node.outputPreview && !node.errorPreview) {
 			content.appendChild(el("p", "empty", UI_TEXT.noOutput));
 		} else {
@@ -592,6 +921,7 @@ function buildDagInspectorHeader(dagRunId, node) {
 	header.appendChild(controls);
 
 	const tabDefs = [
+		["input", "节点输入", "ri-login-box-line"],
 		["output", "节点输出", "ri-file-text-line"],
 		["timeline", "执行过程", "ri-route-line"],
 		["spec-evidence", "规范证据", "ri-book-open-line"],
@@ -660,6 +990,17 @@ function syncDagInspectorHeader(panel, dagRunId, node) {
 }
 
 function dagInspectorSignature(dagRunId, node) {
+	const inputRevision =
+		uiState.dagInspectorTab === "input"
+			? [
+					uiState.dagNodeInputIdentity,
+					uiState.dagNodeInputLoading,
+					uiState.dagNodeInputError ?? "",
+					uiState.dagNodeInputData?.availabilityReason ?? "",
+					uiState.dagNodeInputData?.promptFingerprint?.sha256Prefix ?? "",
+					node.status ?? "",
+				]
+			: null;
 	return JSON.stringify([
 		dagRunId,
 		node.nodeId,
@@ -667,6 +1008,7 @@ function dagInspectorSignature(dagRunId, node) {
 		node.outputPreview ?? "",
 		node.errorPreview ?? "",
 		uiState.dagInspectorTab === "timeline" ? uiState.sessionEventOffset : null,
+		inputRevision,
 	]);
 }
 
@@ -702,17 +1044,30 @@ export function renderDagInspector(dagRunId, node, initial = true) {
 		syncDagInspectorHeader(panel, dagRunId, node);
 		if (panel.dataset.contentSignature === nextContentSignature) return;
 		const previousNode = existingContent.dataset.dagNodeId ?? "";
-		const nodeChanged = previousNode !== String(node.nodeId ?? "");
-		const followLatest =
-			nodeChanged ||
-			computeFollowLatest(
-				existingContent.scrollTop,
-				existingContent.scrollHeight,
-				existingContent.clientHeight,
-			);
-		const regionKey = `dag:${dagRunId}:${node.nodeId}:output`;
-		uiState.dagNodeOutputViewportState = updateDagOutputViewportState(
-			uiState.dagNodeOutputViewportState,
+		const previousRun = existingContent.dataset.dagRunId ?? "";
+		const nodeChanged =
+			previousNode !== String(node.nodeId ?? "") ||
+			previousRun !== String(dagRunId ?? "");
+		const activeTab = ["input", "timeline", "spec-evidence"].includes(
+			uiState.dagInspectorTab,
+		)
+			? uiState.dagInspectorTab
+			: "output";
+		const isInputTab = activeTab === "input";
+		const followLatest = isInputTab
+			? false
+			: nodeChanged ||
+				computeFollowLatest(
+					existingContent.scrollTop,
+					existingContent.scrollHeight,
+					existingContent.clientHeight,
+				);
+		const regionKey = `dag:${dagRunId}:${node.nodeId}:${isInputTab ? "input" : "output"}`;
+		const viewportUpdater = isInputTab
+			? "dagNodeInputViewportState"
+			: "dagNodeOutputViewportState";
+		uiState[viewportUpdater] = updateDagOutputViewportState(
+			uiState[viewportUpdater],
 			regionKey,
 			existingContent.scrollLeft,
 			existingContent.scrollTop,
@@ -729,7 +1084,8 @@ export function renderDagInspector(dagRunId, node, initial = true) {
 		if (followLatest) {
 			existingContent.scrollTop = existingContent.scrollHeight;
 		} else {
-			existingContent.scrollTop = uiState.dagNodeOutputViewportState.scrollTop;
+			const saved = uiState[viewportUpdater];
+			existingContent.scrollTop = nodeChanged ? 0 : (saved?.scrollTop ?? 0);
 		}
 		for (const [index, pre] of [
 			...existingContent.querySelectorAll("pre"),

package/dist/worker/outcomes/projector.js

@@ -111,8 +111,12 @@ export async function projectOutcome(input) {
         if (artifact.sha256 && artifact.sha256 !== recomputed) {
             return contractError(`artifact sha256 mismatch for ${artifact.path}: declared=${artifact.sha256} actual=${recomputed}`);
         }
+        // Persist portable repo-relative paths only (Delivery verifyArtifactRefs rejects abs paths).
+        const relativePath = path
+            .relative(path.resolve(input.repoRoot), resolved)
+            .replace(/\\/g, "/");
         validatedArtifacts.push({
-            path: artifact.path.replace(/\\/g, "/"),
+            path: relativePath,
             sha256: recomputed,
             ...(artifact.kind ? { kind: artifact.kind } : {}),
             ...(artifact.schemaId ? { schemaId: artifact.schemaId } : {}),

package/dist/workflows/dag/backend-test-result-contract.js

@@ -773,6 +773,109 @@ async function readPytestExitCode(runDir, fromNodeId, exitRelativePath = "report
     }
     throw new Error("missing valid pytest exit evidence");
 }
+/**
+ * Materialize Result v1 from a pytest-html 4.x self-contained report (Markdown-first
+ * 8-node pipeline). `junit.relativePath` records the HTML path for integrity hashing
+ * (same field used historically for JUnit XML path).
+ */
+export async function materializeBackendTestResultFromPytestHtml(input) {
+    const htmlRelativePath = input.htmlRelativePath ?? "reports/backend-test.html";
+    const artifactName = input.artifactName ?? "backend-test-result.json";
+    const outputDir = input.outputDir ?? "contracts";
+    if (!/^[a-z0-9][a-z0-9._-]*\.json$/.test(artifactName) ||
+        !/^[a-z0-9][a-z0-9._-]*$/.test(outputDir)) {
+        throw new Error("unsafe structured artifact path");
+    }
+    let html = input.htmlContent;
+    if (html === undefined) {
+        const htmlAbs = path.join(input.runDir, ...htmlRelativePath.split("/"));
+        try {
+            html = await readFile(htmlAbs, "utf8");
+        }
+        catch {
+            throw new Error(`missing pytest-html report at ${htmlRelativePath} (fail-closed for Result v1)`);
+        }
+    }
+    if (!html.trim()) {
+        throw new Error("invalid pytest-html report: empty report");
+    }
+    let parsed;
+    try {
+        parsed = parsePytestHtmlReport(html);
+    }
+    catch (error) {
+        throw new Error(`invalid pytest-html report: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const sha256 = createHash("sha256").update(html).digest("hex");
+    const exit = input.pytestExitCode;
+    let executionStatus = "completed";
+    let collectionStatus = "ok";
+    let outcome = "passed";
+    const looksLikeCollection = exit === 2 ||
+        (parsed.errors > 0 && parsed.passed + parsed.failed === 0) ||
+        parsed.failures.some((f) => f.kind === "error" &&
+            /collect|import|syntax/i.test(`${f.name} ${f.message}`));
+    if (looksLikeCollection && (parsed.errors > 0 || exit >= 2)) {
+        executionStatus = "collection-error";
+        collectionStatus = "error";
+        outcome = "collection-error";
+    }
+    else if (exit >= 2 && parsed.failed === 0 && parsed.errors === 0) {
+        executionStatus = "command-error";
+        collectionStatus = "unknown";
+        outcome = "command-error";
+    }
+    else if (parsed.failed > 0 || parsed.errors > 0 || exit === 1) {
+        executionStatus = "completed";
+        collectionStatus = "ok";
+        outcome = "completed-with-failures";
+    }
+    else if (exit === 0 && parsed.failed === 0 && parsed.errors === 0) {
+        executionStatus = "completed";
+        collectionStatus = "ok";
+        outcome = "passed";
+    }
+    else {
+        executionStatus = "command-error";
+        collectionStatus = "unknown";
+        outcome = "command-error";
+    }
+    const commandSummary = input.commandSummary ??
+        `PYTHONUTF8=1 PYTHONIOENCODING=utf-8 PYTHONDONTWRITEBYTECODE=1 python -m pytest -v -p no:cacheprovider --html=${htmlRelativePath} --self-contained-html`;
+    assertNoSecrets("commandSummary", commandSummary);
+    const result = backendTestResultContractSchema.parse({
+        schemaVersion: 1,
+        executionStatus,
+        pytestExitCode: exit,
+        collectionStatus,
+        tests: parsed.tests,
+        passed: parsed.passed,
+        failed: parsed.failed,
+        error: parsed.errors,
+        skipped: parsed.skipped,
+        durationMs: parsed.durationMs,
+        junit: {
+            relativePath: htmlRelativePath,
+            sha256,
+        },
+        commandSummary,
+        failures: parsed.failures.map((f) => ({
+            classname: f.classname || "unknown",
+            name: f.name || "unknown",
+            message: truncate(f.message || "failure"),
+            kind: f.kind,
+        })),
+        outcome,
+    });
+    const relativePath = path.posix.join(outputDir, artifactName);
+    const artifactPath = await writeDagRunJsonArtifact(input.runDir, relativePath, result);
+    const serialized = `${JSON.stringify(result, null, 2)}\n`;
+    return {
+        path: artifactPath,
+        sha256: createHash("sha256").update(serialized).digest("hex"),
+        schemaId: BACKEND_TEST_RESULT_SCHEMA_ID,
+    };
+}
 export async function materializeBackendTestResultFromRunDir(input) {
     if (!/^[a-z0-9][a-z0-9._-]*\.json$/.test(input.artifactName) ||
         !/^[a-z0-9][a-z0-9._-]*$/.test(input.outputDir)) {