@tea-agent/loop-agent 0.11.0 → 0.12.0

package/dist/worker/observe/static/views/task.js

@@ -0,0 +1,260 @@
+/** Observe UI view module (R5). */
+import {
+	UI_TEXT,
+	LIVENESS_LABELS,
+	ARTIFACT_LABELS,
+	ARTIFACT_KEYS,
+	STEP_LABELS,
+	STEP_ORDER,
+	DAG_INSPECTOR_DEFAULT_WIDTH,
+	DAG_INSPECTOR_MIN_WIDTH,
+	DAG_INSPECTOR_MAX_WIDTH,
+	DAG_INSPECTOR_RIGHT_OFFSET,
+	DAG_INSPECTOR_VIEWPORT_MARGIN,
+	DAG_INSPECTOR_KEYBOARD_STEP,
+	TERMINAL_RUN_STATUSES,
+	DAG_EFFECTIVE_STATUS_LABELS,
+	STATUS_LABELS,
+} from "../constants.js";
+import { clearNode, el, metaGrid, buildTable } from "../dom.js";
+import {
+	badge,
+	badgeClass,
+	statusLabel,
+	formatTs,
+	formatMs,
+	formatDuration,
+	formatAgo,
+	dagStatusBadge,
+	livenessBadge,
+	displayDurationMs,
+	derivedDurationMs,
+	summaryText,
+	truncateText,
+	repoBaseName,
+	parseMarkdownBlocks,
+	markdownLinkHref,
+} from "../format.js";
+import { parseRoute, navigate, buildHashPath } from "../router.js";
+import { fetchJson, artifactUrl, parseArtifactPreviewResponse } from "../api.js";
+import {
+	objectRouteLink,
+	findFeatureInSnapshot,
+	featureLookupState,
+	buildObjectRelations,
+	renderObjectRelationBar,
+} from "../relations.js";
+import { copyText, renderRecommendedCommand } from "../copy.js";
+import {
+	isPageVisible,
+	detailPollDelay,
+	dashboardPollDelay,
+	captureDagGraphViewportState,
+	updateDagGraphViewportState,
+	updateDagTimelineViewportState,
+	renderViewState,
+	mountViewState,
+} from "../state.js";
+import { uiState } from "../state.js";
+import { sortPoolTasks } from "../format-pool.js";
+import {
+	dagMetaVisibility,
+	isDagRunActive,
+	dashboardVisibleFeatures,
+	findDagForRun,
+} from "../dag-model.js";
+import { layoutDag } from "../dag-layout.js";
+import { showView, setBreadcrumb, updateHeaderRefresh, mountRelationBar } from "../shell-chrome.js";
+import { artifactLink } from "../kpi.js";
+import { findBatchRunIdForTask, taskRunHistoryRow } from "../run-processing.js";
+
+export async function renderTaskDetail(taskId) {
+	showView("task");
+	setBreadcrumb([
+		{ label: UI_TEXT.dashboard, href: "#/" },
+		{ label: "资源池", href: "#/pool" },
+		{ label: taskId },
+	]);
+
+	const titleEl = document.getElementById("task-title");
+	const metaEl = document.getElementById("task-meta");
+	const linksEl = document.getElementById("task-links");
+	const evidenceEl = document.getElementById("task-evidence");
+	const runsEl = document.getElementById("task-runs");
+	if (!metaEl || !linksEl || !evidenceEl || !runsEl) return false;
+	if (titleEl) titleEl.textContent = taskId;
+	mountViewState(metaEl, "loading", "加载 Task…");
+
+	const [task, history, snapshot] = await Promise.all([
+		fetchJson(`/api/tasks/${encodeURIComponent(taskId)}`),
+		fetchJson(`/api/tasks/${encodeURIComponent(taskId)}/runs?limit=20`),
+		fetchJson("/api/snapshot"),
+	]);
+	if (snapshot) {
+		uiState.lastSnapshot = snapshot;
+		updateHeaderRefresh(snapshot.generatedAt);
+	}
+
+	clearNode(metaEl);
+	clearNode(linksEl);
+	clearNode(evidenceEl);
+	clearNode(runsEl);
+
+	if (!task) {
+		mountViewState(metaEl, "error", `未找到 Task：${taskId}`);
+		mountRelationBar("task-relations", {}, snapshot);
+		return false;
+	}
+
+	metaEl.appendChild(
+		metaGrid([
+			["Task ID", task.taskId],
+			["状态", badge(task.status)],
+			[
+				"Feature",
+				task.featureId
+					? objectRouteLink("feature", task.featureId, snapshot)
+					: el("span", "muted", "—"),
+			],
+			["更新时间", task.updatedAt ?? task.finishedAt ?? task.startedAt ?? "—"],
+			["最新 worker run", task.workerRunId ?? "—"],
+			["失败分类", task.failureCategory ?? "—"],
+			["建议跟进", task.recommendedFollowUp ?? "—"],
+			[
+				"活性",
+				task.liveness ? (LIVENESS_LABELS[task.liveness] ?? task.liveness) : "—",
+			],
+		]),
+	);
+
+	const batchRunId = findBatchRunIdForTask(snapshot, task);
+	const dag = findDagForRun(snapshot, task.workerRunId, task);
+	mountRelationBar(
+		"task-relations",
+		{
+			featureId: task.featureId,
+			taskId: task.taskId,
+			batchRunId: batchRunId ?? undefined,
+			workerRunId: task.workerRunId,
+			dagRunId: dag?.dagRunId ?? task.dagRunId,
+		},
+		snapshot,
+	);
+	linksEl.appendChild(el("h3", "section-heading", "真实关联"));
+	const linkList = el("div", "artifact-links");
+	linkList.appendChild(objectRouteLink("run", task.workerRunId, snapshot));
+	linkList.appendChild(document.createTextNode(" · "));
+	linkList.appendChild(
+		batchRunId
+			? objectRouteLink("batch", batchRunId, snapshot)
+			: el("span", "muted", "batch 缺失"),
+	);
+	linkList.appendChild(document.createTextNode(" · "));
+	linkList.appendChild(
+		dag
+			? objectRouteLink("dag", dag.dagRunId, snapshot)
+			: task.dagRunId
+				? el("span", "muted", task.dagRunId)
+				: el("span", "muted", "DAG 缺失"),
+	);
+	if (task.featureId) {
+		linkList.appendChild(document.createTextNode(" · "));
+		linkList.appendChild(objectRouteLink("feature", task.featureId, snapshot));
+	}
+	linksEl.appendChild(linkList);
+
+	evidenceEl.appendChild(el("h3", "section-heading", "失败证据"));
+	const r = task.artifactRefs ?? {};
+	const evidenceLinks = el("div", "artifact-links");
+	evidenceLinks.appendChild(artifactLink("报告", r.reportMarkdown));
+	evidenceLinks.appendChild(document.createTextNode(" "));
+	evidenceLinks.appendChild(artifactLink("诊断", r.doctorMarkdown));
+	evidenceLinks.appendChild(document.createTextNode(" "));
+	evidenceLinks.appendChild(artifactLink("收尾方案", r.closeoutDraft));
+	evidenceLinks.appendChild(document.createTextNode(" "));
+	evidenceLinks.appendChild(artifactLink("run 记录", r.runRecordPath));
+	if (
+		!r.reportMarkdown &&
+		!r.doctorMarkdown &&
+		!r.closeoutDraft &&
+		!r.runRecordPath
+	) {
+		evidenceEl.appendChild(el("p", "empty", "暂无 allowlist 内的证据路径。"));
+	} else {
+		evidenceEl.appendChild(evidenceLinks);
+	}
+
+	runsEl.appendChild(el("h3", "section-heading", "运行历史"));
+	const runs = history?.runs ?? [];
+	if (runs.length === 0) {
+		mountViewState(runsEl, "empty", "暂无 ledger 运行记录。");
+	} else {
+		const rows = runs.map(taskRunHistoryRow);
+		runsEl.appendChild(
+			buildTable(
+				["worker run", "状态", "时间", "batch", "retryOf", "失败分类"],
+				rows,
+			),
+		);
+		if (history?.nextBefore) {
+			const more = el("button", "link-button", "加载更早的运行");
+			more.type = "button";
+			more.addEventListener("click", () => {
+				void loadOlderTaskRuns(taskId, history.nextBefore, runsEl);
+			});
+			runsEl.appendChild(more);
+		}
+	}
+
+	const active = ["running", "pending", "blocked", "stale"].includes(
+		(task.status ?? "").toLowerCase(),
+	);
+	return active;
+}
+
+export async function loadOlderTaskRuns(taskId, before, runsEl) {
+	const page = await fetchJson(
+		`/api/tasks/${encodeURIComponent(taskId)}/runs?limit=20&before=${encodeURIComponent(before)}`,
+	);
+	if (!page?.runs?.length) return;
+	const table = runsEl.querySelector("table");
+	if (!table) return;
+	const tbody = table.querySelector("tbody") || table;
+	for (const run of page.runs) {
+		const tr = document.createElement("tr");
+		for (const cell of taskRunHistoryRow(run).cells) {
+			const td = document.createElement("td");
+			if (cell instanceof Node) td.appendChild(cell);
+			else td.textContent = cell;
+			tr.appendChild(td);
+		}
+		tbody.appendChild(tr);
+	}
+	const btn = runsEl.querySelector("button.link-button");
+	if (btn) {
+		if (page.nextBefore) {
+			btn.onclick = () => {
+				void loadOlderTaskRuns(taskId, page.nextBefore, runsEl);
+			};
+		} else {
+			btn.remove();
+		}
+	}
+}
+
+export function startTaskPolling(taskId) {
+	if (uiState.taskPollTimer) clearTimeout(uiState.taskPollTimer);
+	const generation = ++uiState.pollingGeneration;
+	const poll = async () => {
+		const active = await renderTaskDetail(taskId);
+		if (generation !== uiState.pollingGeneration || !active) return;
+		const delay = detailPollDelay("running", isPageVisible());
+		if (delay == null) return;
+		uiState.taskPollTimer = setTimeout(() => {
+			uiState.taskPollTimer = null;
+			void poll();
+		}, delay);
+	};
+	void poll();
+}
+

package/dist/worker/observe/static/views/timeline.js

@@ -0,0 +1,163 @@
+/** Observe UI view module (R5). */
+import {
+	UI_TEXT,
+	LIVENESS_LABELS,
+	ARTIFACT_LABELS,
+	ARTIFACT_KEYS,
+	STEP_LABELS,
+	STEP_ORDER,
+	DAG_INSPECTOR_DEFAULT_WIDTH,
+	DAG_INSPECTOR_MIN_WIDTH,
+	DAG_INSPECTOR_MAX_WIDTH,
+	DAG_INSPECTOR_RIGHT_OFFSET,
+	DAG_INSPECTOR_VIEWPORT_MARGIN,
+	DAG_INSPECTOR_KEYBOARD_STEP,
+	TERMINAL_RUN_STATUSES,
+	DAG_EFFECTIVE_STATUS_LABELS,
+	STATUS_LABELS,
+} from "../constants.js";
+import { clearNode, el, metaGrid, buildTable } from "../dom.js";
+import {
+	badge,
+	badgeClass,
+	statusLabel,
+	formatTs,
+	formatMs,
+	formatDuration,
+	formatAgo,
+	dagStatusBadge,
+	livenessBadge,
+	displayDurationMs,
+	derivedDurationMs,
+	summaryText,
+	truncateText,
+	repoBaseName,
+	parseMarkdownBlocks,
+	markdownLinkHref,
+} from "../format.js";
+import { parseRoute, navigate, buildHashPath } from "../router.js";
+import {
+	fetchJson,
+	artifactUrl,
+	parseArtifactPreviewResponse,
+} from "../api.js";
+import {
+	objectRouteLink,
+	findFeatureInSnapshot,
+	featureLookupState,
+	buildObjectRelations,
+	renderObjectRelationBar,
+} from "../relations.js";
+import { copyText, renderRecommendedCommand } from "../copy.js";
+import {
+	isPageVisible,
+	detailPollDelay,
+	dashboardPollDelay,
+	captureDagGraphViewportState,
+	updateDagGraphViewportState,
+	updateDagTimelineViewportState,
+	renderViewState,
+	mountViewState,
+} from "../state.js";
+import { uiState } from "../state.js";
+import { sortPoolTasks } from "../format-pool.js";
+import {
+	dagMetaVisibility,
+	isDagRunActive,
+	dashboardVisibleFeatures,
+	findDagForRun,
+} from "../dag-model.js";
+import { layoutDag } from "../dag-layout.js";
+
+export async function mountBoundedEventTimeline(container, apiBase, title) {
+	clearNode(container);
+	container.appendChild(el("h3", "section-heading", title));
+	const note = el(
+		"p",
+		"process-timeline-note",
+		"有界历史（默认 50 / 最大 200）；分页使用 cursor，与 SSE 行号 offset 分离。",
+	);
+	container.appendChild(note);
+	const scroll = el("div", "process-timeline-scroll event-history-scroll");
+	const listHost = el("div", "event-history-list");
+	scroll.appendChild(listHost);
+	container.appendChild(scroll);
+	const footer = el("div", "event-history-footer");
+	container.appendChild(footer);
+
+	let nextCursor = null;
+	let loading = false;
+	const accumulated = [];
+
+	const renderList = () => {
+		clearNode(listHost);
+		if (accumulated.length === 0) {
+			mountViewState(listHost, "empty", "暂无事件");
+			return;
+		}
+		const ul = el("ul", "process-timeline");
+		for (let index = 0; index < accumulated.length; index += 1) {
+			const event = accumulated[index];
+			const li = el(
+				"li",
+				`process-timeline-item process-timeline-event has-time${index === 0 ? " is-first" : ""}${index === accumulated.length - 1 ? " is-last" : ""}`,
+			);
+			const rail = el("span", "process-timeline-rail");
+			rail.appendChild(el("span", "process-timeline-dot"));
+			li.appendChild(rail);
+			li.appendChild(
+				el("span", "process-timeline-time", formatTs(event.at) || "—"),
+			);
+			const label = `${event.type ?? "event"}${event.taskId ? ` · ${event.taskId}` : ""}${event.workerRunId ? ` · ${event.workerRunId}` : ""}`;
+			li.appendChild(el("span", "process-timeline-label", label));
+			ul.appendChild(li);
+		}
+		listHost.appendChild(ul);
+	};
+
+	const loadPage = async (cursor) => {
+		if (loading) return;
+		loading = true;
+		if (accumulated.length === 0) {
+			mountViewState(listHost, "loading", "加载事件…");
+		}
+		const qs = new URLSearchParams();
+		qs.set("limit", "50");
+		if (cursor) qs.set("cursor", cursor);
+		const page = await fetchJson(`${apiBase}?${qs.toString()}`);
+		loading = false;
+		if (!page) {
+			mountViewState(listHost, "error", "无法加载事件历史。");
+			return;
+		}
+		const events = page.events ?? [];
+		for (const event of events) accumulated.push(event);
+		nextCursor = page.nextCursor ?? null;
+		renderList();
+		clearNode(footer);
+		if (page.corruptLineCount > 0) {
+			footer.appendChild(
+				renderViewState(
+					"degraded",
+					`跳过损坏行 ${page.corruptLineCount} 条（failure-safe）。`,
+				),
+			);
+		}
+		if (nextCursor) {
+			const btn = el(
+				"button",
+				"btn-secondary event-history-more",
+				"加载更早事件",
+			);
+			btn.type = "button";
+			btn.addEventListener("click", () => {
+				void loadPage(nextCursor);
+			});
+			footer.appendChild(btn);
+		} else if (accumulated.length > 0) {
+			footer.appendChild(el("p", "muted", "已到历史边界"));
+		}
+	};
+
+	await loadPage(null);
+}

package/dist/workflows/dag/controller-identity.js

@@ -0,0 +1,104 @@
+import { createHash } from "node:crypto";
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { writeJsonAtomic } from "../../infrastructure/harness/atomic-write.js";
+import { controllerIdentitiesMatch, resolveRunningControllerIdentity, } from "../../shared/package-metadata.js";
+export const CONTROLLER_IDENTITY_ARTIFACT_NAME = "controller-identity.json";
+function hashArtifact(artifact) {
+    return createHash("sha256")
+        .update(`${JSON.stringify(artifact, null, 2)}\n`)
+        .digest("hex");
+}
+function summaryFields(identity) {
+    if (!identity)
+        return {};
+    return {
+        packageName: identity.packageName,
+        packageVersion: identity.packageVersion,
+        packageFingerprint: identity.packageFingerprint.value,
+        binarySha256: identity.binarySha256,
+    };
+}
+/**
+ * Capture the running controller identity as a run-owned fact and persist it
+ * under `runDir/controller-identity.json`. Returns the ref (with content hash)
+ * to store on DagRunState. When the identity cannot be resolved, records a
+ * `legacy-unpinned` artifact instead of fabricating an identity.
+ */
+export async function captureControllerIdentity(input) {
+    const capturedAt = (input.now ?? new Date()).toISOString();
+    const identity = input.identity !== undefined
+        ? input.identity
+        : (resolveRunningControllerIdentity({
+            ...(input.argv ? { argv: input.argv } : {}),
+            ...(input.now ? { now: input.now } : {}),
+        }) ?? null);
+    const artifact = identity
+        ? { schemaVersion: 1, status: "pinned", capturedAt, identity }
+        : {
+            schemaVersion: 1,
+            status: "legacy-unpinned",
+            capturedAt,
+            identity: null,
+            reason: "running controller identity could not be resolved at run creation",
+        };
+    await writeJsonAtomic(path.join(input.runDir, CONTROLLER_IDENTITY_ARTIFACT_NAME), artifact);
+    return {
+        schemaVersion: 1,
+        path: CONTROLLER_IDENTITY_ARTIFACT_NAME,
+        sha256: hashArtifact(artifact),
+        capturedAt,
+        status: artifact.status,
+        ...summaryFields(identity),
+    };
+}
+export async function readControllerIdentityArtifact(runDir) {
+    try {
+        const raw = await readFile(path.join(runDir, CONTROLLER_IDENTITY_ARTIFACT_NAME), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+function shortIdentity(identity) {
+    return `${identity.packageName}@${identity.packageVersion} (fingerprint ${identity.packageFingerprint.value}, binary ${identity.binarySha256.slice(0, 12)})`;
+}
+/**
+ * Recompute the current controller identity and compare it to the pinned run
+ * fact before resuming. Fails closed on drift; reports (without inventing an
+ * identity). Legacy/unpinned runs remain readable but cannot be resumed.
+ */
+export async function verifyControllerIdentityForResume(input) {
+    const ref = input.state.controllerIdentityRef;
+    if (!ref || ref.status === "legacy-unpinned") {
+        throw new Error(`dag run ${input.state.runId} has no pinned controller identity; legacy/unpinned runs remain readable but cannot be resumed safely`);
+    }
+    const artifact = await readControllerIdentityArtifact(input.runDir);
+    if (!artifact) {
+        throw new Error(`dag run ${input.state.runId} is pinned but ${CONTROLLER_IDENTITY_ARTIFACT_NAME} is missing; refuse to resume`);
+    }
+    const persistedHash = createHash("sha256")
+        .update(`${JSON.stringify(artifact, null, 2)}\n`)
+        .digest("hex");
+    if (persistedHash !== ref.sha256) {
+        throw new Error(`dag run ${input.state.runId} controller identity artifact was tampered with (hash mismatch); refuse to resume`);
+    }
+    const pinned = artifact.identity;
+    if (!pinned) {
+        throw new Error(`dag run ${input.state.runId} is pinned but the identity artifact has no identity payload; refuse to resume`);
+    }
+    const current = input.currentIdentity !== undefined
+        ? input.currentIdentity
+        : (resolveRunningControllerIdentity({
+            ...(input.argv ? { argv: input.argv } : {}),
+            ...(input.now ? { now: input.now } : {}),
+        }) ?? null);
+    if (!current) {
+        throw new Error(`dag run ${input.state.runId} was pinned to ${shortIdentity(pinned)} but the current controller identity could not be resolved; refuse to resume`);
+    }
+    if (!controllerIdentitiesMatch(pinned, current)) {
+        throw new Error(`dag run ${input.state.runId} controller identity drifted; pinned=${shortIdentity(pinned)} current=${shortIdentity(current)}; start a new run instead of resuming`);
+    }
+    return { status: "pinned-match", identity: current };
+}