@tea-agent/loop-agent 0.39.0-next.9 → 0.39.1

package/dist/worker/observe/shell-handler-keys.js

@@ -0,0 +1,34 @@
+/**
+ * Allowlist of in-process shell handlers (preset/gate flags on task.shell).
+ * Observe projects these names; the executor writes process receipts for them.
+ */
+export const SHELL_NAMED_HANDLER_KEYS = [
+    "verdictGate",
+    "projectGovernanceGate",
+    "requirementCoverageGate",
+    "jsonArtifactGate",
+    "frontendPrewriteGate",
+    "frontendLintBaseline",
+    "frontendVerificationBundle",
+    "frontendReviewContext",
+    "frontendTestCaseChecklist",
+    "frontendBrowserToolPreflight",
+    "frontendTestStandardScenarios",
+    "frontendTestEnvironmentProbe",
+    "frontendTestEvidenceValidation",
+    "finalWriteSetApprovalGate",
+    "frontendTestL5Report",
+    "frontendTestHtmlReport",
+    "frontendTestCaseManifest",
+    "frontendTestResultFinalize",
+    "frontendTestReports",
+    "backendTestPipeline",
+    "jacocoCoverage",
+    "verifyEvidence",
+    "repairArtifactGate",
+];
+export function namedShellHandlers(shell) {
+    if (!shell)
+        return [];
+    return SHELL_NAMED_HANDLER_KEYS.filter((key) => shell[key] != null);
+}

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

@@ -77,6 +77,14 @@ export async function fetchDagNodeInput(runId, nodeId) {
 	return fetchJsonResult(url);
 }
 
+export async function fetchDagNodeProcess(runId, nodeId, key) {
+	const params = new URLSearchParams();
+	if (key) params.set("key", String(key));
+	const qs = params.toString();
+	const url = `/api/dag-runs/${encodeURIComponent(runId)}/nodes/${encodeURIComponent(nodeId)}/process${qs ? `?${qs}` : ""}`;
+	return fetchJsonResult(url);
+}
+
 /**
  * Fetch a spec-evidence file preview (binding source or successful read).
  * Resolves to the parsed JSON body, or throws an Error carrying the HTTP
@@ -104,6 +112,65 @@ export function artifactUrl(artifactPath) {
 	return `/api/artifacts?path=${encodeURIComponent(artifactPath)}&tail=200`;
 }
 
+/**
+ * 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
+ * Console mutations.
+ * Absent token → the call is not attempted.
+ */
+export async function postOperatorAction(action, actionParams = {}) {
+	const token = globalThis.__INSPECT_MUTATION_TOKEN__;
+	if (!token) {
+		return {
+			ok: false,
+			status: 0,
+			body: { error: { code: "PROMPT_OVERRIDE_DISABLED", message: "提示词重启未启用（服务端未注入确认 token）" } },
+		};
+	}
+	try {
+		const res = await fetch("/api/operator/v1/operations", {
+			method: "POST",
+			credentials: "same-origin",
+			headers: {
+				"Content-Type": "application/json",
+				"x-loop-console-confirmation": token,
+			},
+			body: JSON.stringify({ action, actionParams }),
+		});
+		let body = null;
+		try {
+			body = await res.json();
+		} catch {
+			body = null;
+		}
+		return { ok: res.ok, status: res.status, body };
+	} catch {
+		return { ok: false, status: 0, body: null };
+	}
+}
+
+/** Poll a Console operation snapshot (read-only GET). */
+export async function fetchOperatorOperation(operationId) {
+	try {
+		const res = await fetch(
+			`/api/operator/v1/operations/${encodeURIComponent(operationId)}`,
+			{ credentials: "same-origin" },
+		);
+		let body = null;
+		try {
+			body = await res.json();
+		} catch {
+			body = null;
+		}
+		return { ok: res.ok, status: res.status, body };
+	} catch {
+		return { ok: false, status: 0, body: null };
+	}
+}
+
 export function parseArtifactPreviewResponse(text) {
 	const parsed = JSON.parse(text);
 	if (!parsed || typeof parsed.content !== "string") {
@@ -114,4 +181,3 @@ export function parseArtifactPreviewResponse(text) {
 		truncated: parsed.truncated === true,
 	};
 }
-

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

@@ -53,7 +53,14 @@ export const UI_TEXT = {
 	inputError: "加载节点输入失败。",
 	inputFrozenLabel: "冻结 DAG 节点定义",
 	inputFingerprintNote: "仅保存 assembled prompt 指纹，全文未持久化",
-	noSessionEvents: "该节点暂无过程日志",
+	noSessionEvents: "该 Pi 节点暂无过程日志（可能尚未执行、走 CLI 路径，或为历史 run）",
+	noShellProcess: "该 shell 节点尚未留下命令回执。",
+	noPresetProcess: "该内部处理器尚未留下过程回执。",
+	staticNoProcess: "静态节点没有逐步执行过程，请查看节点输出。",
+	processLoading: "正在加载执行过程…",
+	processError: "加载执行过程失败。",
+	shellCommandsHeading: "Shell 命令",
+	shellPresetHeading: "内部处理器",
 	noArtifacts: "暂无产物记录。",
 	noActiveCommand: "当前没有正在执行的命令。",
 	noFailures: "当前没有异常 Task。",

package/dist/worker/observe/static/dag-history-labels.js

@@ -14,6 +14,10 @@ const ATTEMPT_FAILURE_LABELS = {
 	timeout: "执行超时",
 	"nonzero-exit": "命令执行失败",
 	"invalid-output": "输出格式无效",
+	"structured-output-truncated": "结构化输出被截断",
+	"output-too-large": "输出超出体积上限",
+	"structured-repair-exhausted": "结构化修复耗尽",
+	"governance-blocked": "治理规则阻断",
 	"empty-output": "输出为空",
 	auth: "认证失败",
 	quota: "额度或限流",

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

@@ -345,3 +345,63 @@ export function formatRepoPathDisplay(repoRoot) {
 		.replace(/^\/Users\/[^/]+/, "~")
 		.replace(/^\/home\/[^/]+/, "~");
 }
+
+/**
+ * If `text` is a complete JSON object or array, return pretty-printed JSON.
+ * Primitives, JSONL, truncated/invalid JSON, and markdown return null so
+ * callers can fall back to Markdown rendering.
+ */
+export function prettyJsonBlock(text) {
+	if (typeof text !== "string") return null;
+	const trimmed = text.trim();
+	if (trimmed.length < 2) return null;
+	const start = trimmed[0];
+	const end = trimmed[trimmed.length - 1];
+	if (!((start === "{" && end === "}") || (start === "[" && end === "]"))) {
+		return null;
+	}
+	try {
+		const value = JSON.parse(trimmed);
+		if (value === null || typeof value !== "object") return null;
+		return JSON.stringify(value, null, 2);
+	} catch {
+		return null;
+	}
+}
+
+/**
+ * Source fidelity ledger 安全摘要渲染（AC-009/AC-010/AC-HARD-004）：计数/状态/
+ * failure code + v2 binding 语义（binding=v2 + ledger sha256/inputDigest，仅真实
+ * DagSourceBindingV2 时展示；inputDigest ≠ 当前 expectedInputDigest 时标记 stale）+
+ * 有界排除理由（fragmentId + 截断 reason），绝不渲染未截断原文。输入即安全摘要对象。
+ */
+export function formatLedgerSummary(summary) {
+	if (!summary || summary.present !== true) {
+		return "无 source fidelity ledger（任务无引用或 ledger 缺失，不伪造计数）";
+	}
+	const lines = [
+		`fragments=${summary.fragmentCount ?? 0}`,
+		`canonical requirements=${summary.canonicalRequirementCount ?? 0}`,
+		`context-only=${summary.contextOnlyCount ?? 0}`,
+		`duplicate=${summary.duplicateCount ?? 0}`,
+		`unresolved=${summary.unresolvedCount ?? 0}`,
+		`conflict=${summary.conflictCount ?? 0}`,
+		`gate=${summary.gateStatus ?? "unknown"}`,
+	];
+	if (summary.bindingSchemaVersion === 2) {
+		lines.push(
+			`binding=v2（受管 ledger 绑定）${summary.stale ? " · STALE（输入漂移）" : ""}`,
+		);
+		if (summary.ledgerSha256) lines.push(`ledgerSha256=${summary.ledgerSha256}`);
+		if (summary.inputDigest) lines.push(`inputDigest=${summary.inputDigest}`);
+	}
+	if (summary.failureCode) lines.push(`failureCode=${summary.failureCode}`);
+	const exclusions = Array.isArray(summary.exclusions) ? summary.exclusions : [];
+	if (exclusions.length > 0) {
+		lines.push("排除理由（有界摘要）：");
+		for (const entry of exclusions.slice(0, 20)) {
+			lines.push(`- ${entry.fragmentId}: ${truncateText(entry.reason ?? "", 120)}`);
+		}
+	}
+	return lines.join("\n");
+}

package/dist/worker/observe/static/index.html

@@ -352,6 +352,11 @@
             class="panel panel-table"
             aria-label="运行历史"
           ></section>
+          <section
+            id="task-ledger"
+            class="panel panel-table"
+            aria-label="Source fidelity ledger"
+          ></section>
         </section>
 
         <section data-view="feature" id="view-feature" class="view" hidden>

package/dist/worker/observe/static/markdown-render.js

@@ -1,6 +1,10 @@
 /** Shared safe Markdown → DOM rendering for Observe UI. */
 import { el } from "./dom.js";
-import { parseMarkdownBlocks, markdownLinkHref } from "./format.js";
+import {
+	parseMarkdownBlocks,
+	markdownLinkHref,
+	prettyJsonBlock,
+} from "./format.js";
 
 export function appendInlineMarkdown(target, text) {
 	const tokenPattern = /(`[^`]*`|\*\*[^*]+\*\*|\*[^*]+\*|\[[^\]]+\]\([^)]+\))/g;
@@ -49,6 +53,21 @@ export function appendParagraphMarkdown(target, text) {
 	}
 }
 
+export function renderInspectorDocument(content) {
+	const pretty = prettyJsonBlock(content);
+	if (pretty != null) {
+		const article = el("article", "markdown-output json-output");
+		const pre = document.createElement("pre");
+		const code = document.createElement("code");
+		code.dataset.language = "json";
+		code.textContent = pretty;
+		pre.appendChild(code);
+		article.appendChild(pre);
+		return article;
+	}
+	return renderMarkdown(content);
+}
+
 export function renderMarkdown(content) {
 	const article = el("article", "markdown-output");
 	for (const block of parseMarkdownBlocks(content)) {

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

@@ -436,6 +436,10 @@ export function mountOperatorChrome(root, config = {}) {
 			const a = el("a", `och-mode-btn${btn.active ? " och-on" : ""}`);
 			a.href = btn.href;
 			a.dataset.mode = btn.id;
+			// 2026-08-22: inline-flex 布局下裸文本节点不参与 name-from-content，
+			// a11y snapshot 序列化为无名 link；显式 aria-label 保证「操作/观测」
+			// 对 find/读屏稳定可断言（frontend-test passed 权威依赖可见 find）。
+			a.setAttribute("aria-label", btn.label);
 			if (btn.active) a.setAttribute("aria-current", "page");
 			a.appendChild(makeIcon(btn.id === "operate" ? "zap" : "eye"));
 			a.appendChild(document.createTextNode(btn.label));

package/dist/worker/observe/static/prompt-restart-candidates.d.ts

@@ -0,0 +1,18 @@
+export type PromptRestartFailedCandidate = {
+	attempt?: number;
+	failureCategory?: string;
+	prompt?: string;
+	truncated?: boolean;
+};
+
+export type PromptRestartCandidateOption = {
+	key: string;
+	label: string;
+	prompt: string;
+	truncated: boolean;
+};
+
+export function buildPromptRestartCandidateOptions(
+	frozenPrompt: string | null | undefined,
+	failedCandidates: PromptRestartFailedCandidate[] | null | undefined,
+): PromptRestartCandidateOption[];

package/dist/worker/observe/static/prompt-restart-candidates.js

@@ -0,0 +1,36 @@
+export function buildPromptRestartCandidateOptions(
+	frozenPrompt,
+	failedCandidates,
+) {
+	const options = [
+		{
+			key: "frozen",
+			label: "冻结原始提示词",
+			prompt: String(frozenPrompt ?? ""),
+			truncated: false,
+		},
+	];
+	const seen = new Set();
+	for (const candidate of [...(failedCandidates ?? [])].sort(
+		(a, b) => Number(a?.attempt ?? 0) - Number(b?.attempt ?? 0),
+	)) {
+		const attempt = Number(candidate?.attempt);
+		if (!Number.isSafeInteger(attempt) || attempt < 1 || seen.has(attempt)) {
+			continue;
+		}
+		if (typeof candidate?.prompt !== "string") continue;
+		seen.add(attempt);
+		const failureCategory =
+			typeof candidate.failureCategory === "string" &&
+			candidate.failureCategory.trim()
+				? candidate.failureCategory.trim()
+				: "unknown";
+		options.push({
+			key: `attempt-${attempt}`,
+			label: `第 ${attempt} 次失败 · ${failureCategory}`,
+			prompt: candidate.prompt,
+			truncated: candidate.truncated === true,
+		});
+	}
+	return options;
+}

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

@@ -61,6 +61,12 @@ export const uiState = {
 	dagNodeInputData: null,
 	dagNodeInputError: null,
 	dagNodeInputLoading: false,
+	/** Node-process request identity ("<dagRunId>:<nodeId>:<key>#<seq>"). */
+	dagNodeProcessIdentity: null,
+	dagNodeProcessRequestSeq: 0,
+	dagNodeProcessData: null,
+	dagNodeProcessError: null,
+	dagNodeProcessLoading: false,
 	/**
 	 * Execution-output request identity ("<dagRunId>:<nodeId>:<key>#<seq>").
 	 * Stale async responses are rejected when this no longer matches.
@@ -76,8 +82,8 @@ export const uiState = {
 	dagNodeExecutionOutputLoading: false,
 	dagNodeExecutionOutputError: null,
 	dagNodeExecutionOutputKey: null,
-	/** When true,「执行过程」展开 message_start/end 原始协议事件。 */
-	sessionTimelineShowProtocol: false,
+	/** When true,「执行过程」展开 message_start/end 原始协议事件。默认展开，用户可点选隐藏。 */
+	sessionTimelineShowProtocol: true,
 	/** Open <details> keys restored across timeline re-renders. */
 	sessionTimelineOpenDetails: null,
 	lastSnapshot: null,
@@ -222,6 +228,11 @@ export function makeDagNodeInputIdentity(dagRunId, nodeId) {
 	return `${dagRunId}:${nodeId}#${uiState.dagNodeInputRequestSeq}`;
 }
 
+export function makeDagNodeProcessIdentity(dagRunId, nodeId, key) {
+	uiState.dagNodeProcessRequestSeq += 1;
+	return `${dagRunId}:${nodeId}:${key ?? "latest"}#${uiState.dagNodeProcessRequestSeq}`;
+}
+
 /** Build a fresh execution-output identity token (includes key). */
 export function makeDagNodeExecutionOutputIdentity(dagRunId, nodeId, key) {
 	uiState.dagNodeExecutionOutputRequestSeq += 1;

package/dist/worker/observe/static/styles.css

@@ -2111,6 +2111,9 @@ body.is-resizing-dag-graph {
 	background: transparent;
 	color: inherit;
 }
+.markdown-output.json-output pre {
+	white-space: pre;
+}
 .markdown-output a {
 	color: var(--orange-active);
 	text-decoration-color: var(--orange);
@@ -3565,3 +3568,85 @@ button.copy-command:focus-visible {
 .custom-select-option.is-selected .custom-select-option-check {
 	opacity: 1;
 }
+
+/* Experimental prompt-override rerun tab (only rendered with the mutation token). */
+.prompt-restart-box {
+	display: flex;
+	flex-direction: column;
+	gap: 0.75rem;
+	padding: 0.5rem 0.25rem;
+}
+.prompt-restart-field {
+	display: flex;
+	flex-direction: column;
+	gap: 0.35rem;
+}
+.prompt-restart-prompt-card {
+	position: relative;
+}
+.prompt-restart-prompt-head {
+	display: flex;
+	align-items: center;
+	justify-content: space-between;
+	gap: 0.5rem;
+}
+.prompt-restart-copy-icon {
+	flex: 0 0 auto;
+}
+.prompt-restart-textarea {
+	width: 100%;
+	min-height: 8rem;
+	resize: vertical;
+	box-sizing: border-box;
+	font-family: var(--mono-font, ui-monospace, SFMono-Regular, Menlo, monospace);
+	font-size: 12.5px;
+	line-height: 1.5;
+	white-space: pre;
+	overflow-wrap: normal;
+	overflow-x: auto;
+}
+.prompt-restart-actions {
+	display: flex;
+	gap: 0.5rem;
+	align-items: center;
+}
+.prompt-restart-submit {
+	padding: 0.35rem 0.9rem;
+	font-size: 13.5px;
+	cursor: pointer;
+}
+.prompt-restart-submit:disabled {
+	opacity: 0.55;
+	cursor: wait;
+}
+.prompt-restart-status {
+	margin: 0;
+	font-size: 13px;
+	min-height: 1.2em;
+	white-space: pre-wrap;
+	word-break: break-word;
+}
+.prompt-restart-status.prompt-restart-error {
+	color: var(--red, #c0392b);
+}
+.prompt-restart-readonly {
+	margin: 0;
+	padding: 0.5rem 0.6rem;
+	font-family: var(--mono-font, ui-monospace, SFMono-Regular, Menlo, monospace);
+	font-size: 12.5px;
+	line-height: 1.5;
+	white-space: pre;
+	overflow: auto;
+	border: 1px solid var(--border-color, rgba(125, 125, 125, 0.35));
+	border-radius: 6px;
+	max-height: 60vh;
+}
+.prompt-restart-mode {
+	display: flex;
+	align-items: center;
+	gap: 0.5rem;
+}
+.prompt-restart-mode-select {
+	max-width: 100%;
+	font-size: 13px;
+}