@tea-agent/loop-agent 0.42.0-next.9 → 0.42.1

package/dist/worker/observe/static/inspect-workspace.js

@@ -1,3 +1,4 @@
+import { inspectRouteStates } from "./state.js";
 /**
  * Hosted Inspect workspace adapter.
  *
@@ -44,6 +45,9 @@ import {
 
 let instance = null;
 let lastInspectHash = "";
+let renderedHash = "";
+let renderedScope = null;
+let routeToken = 0;
 let listenersBound = false;
 
 export function getInspectWorkspaceInstance() {
@@ -129,7 +133,7 @@ function startView(routeValue) {
 	if (routeValue.view === "dashboard") {
 		startDashboardPolling(routeValue.scrollTo);
 	} else if (routeValue.view === "dags") {
-		void startDagsView();
+		return startDagsView();
 	} else if (routeValue.view === "batch") {
 		void renderBatch(routeValue.batchRunId);
 	} else if (routeValue.view === "run") {
@@ -137,9 +141,9 @@ function startView(routeValue) {
 	} else if (routeValue.view === "dag") {
 		startDagPolling(routeValue.dagRunId);
 	} else if (routeValue.view === "failures") {
-		void renderFailures();
+		return renderFailures();
 	} else if (routeValue.view === "pool") {
-		startPoolView();
+		return startPoolView();
 	} else if (routeValue.view === "night") {
 		void renderNightJobs(routeValue.scheduleId);
 	} else if (routeValue.view === "task") {
@@ -150,11 +154,34 @@ function startView(routeValue) {
 }
 
 export function route(hashValue) {
+	const scope = workspaceScope();
+	const scrollRoot = instance?.root ?? document.scrollingElement;
+	const destination = hashValue || (typeof location !== "undefined" ? location.hash : "#/inspect");
+	if (renderedHash && renderedScope === scope) {
+		const previous = parseHashRouteWithFilters(renderedHash);
+		if (["pool", "dags", "failures"].includes(previous.view)) {
+			inspectRouteStates.set(`list:${renderedHash}`, { top: scrollRoot?.scrollTop ?? 0, left: scrollRoot?.scrollLeft ?? 0 });
+			inspectRouteStates.set("return-list", renderedHash);
+		}
+		if (previous.view === "dag" && uiState.currentDagRunId) inspectRouteStates.set(`dag:${uiState.currentDagRunId}`, {
+			nodeId: uiState.selectedDagNodeId, tab: uiState.dagInspectorTab,
+			executionKey: uiState.dagInspectorAttempt?.key ?? null, open: uiState.dagInspectorOpen,
+		});
+	}
+	renderedHash = destination;
+	renderedScope = scope;
+	const token = ++routeToken;
 	stopTimers();
-	const parsed = hashValue
-		? parseHashRouteWithFilters(hashValue)
-		: parseRoute();
-	startView(parsed);
+	const parsed = parseHashRouteWithFilters(destination);
+	const saved = inspectRouteStates.get(`list:${destination}`);
+	Promise.resolve(startView(parsed)).then(() => {
+		if (!saved || token !== routeToken || scope !== workspaceScope()) return;
+		requestAnimationFrame(() => {
+			if (token !== routeToken || scope !== workspaceScope() || !scrollRoot) return;
+			scrollRoot.scrollTop = saved.top;
+			scrollRoot.scrollLeft = saved.left;
+		});
+	});
 }
 
 function resumeView(hashValue) {

package/dist/worker/observe/static/inspector-submission.js

@@ -0,0 +1,32 @@
+/** A retry always replays the exact reviewed payload and idempotency key. */
+export function createInspectorSubmission(action, payload) {
+	return {
+		action,
+		payload: JSON.parse(JSON.stringify(payload)),
+		requestId: `inspect-${action}-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`,
+		inFlight: false,
+		operationId: null,
+		rejected: false,
+	};
+}
+
+export async function sendInspectorSubmission(submission, send) {
+	if (submission.pending) return submission.pending;
+	if (submission.operationId) return submission.response;
+	submission.inFlight = true;
+	submission.pending = (async () => {
+		const response = await send(submission.action, submission.payload, submission.requestId);
+		submission.response = response;
+		submission.operationId = response.ok ? response.body?.operationId ?? null : null;
+		// Only a definitive client rejection permits a different payload. Transport
+		// failure and server failure can follow acceptance, so they require replay.
+		submission.rejected = !response.ok && response.status >= 400 && response.status < 500;
+		return response;
+	})();
+	try { return await submission.pending; }
+	finally { submission.inFlight = false; submission.pending = null; }
+}
+
+export function hasUnresolvedSubmission(submission) {
+	return Boolean(submission?.payload && !submission.operationId && !submission.rejected);
+}

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

@@ -21,6 +21,7 @@ export function artifactLink(label, refPath) {
 	const a = el("a", "artifact-link", label);
 	a.href = `/api/artifacts?path=${encodeURIComponent(refPath)}&tail=200`;
 	a.target = "_blank";
+	a.addEventListener("click", (event) => event.stopPropagation());
 	return a;
 }
 

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

@@ -1,3 +1,5 @@
+import { attemptFailureLabel } from "./dag-history-labels.js";
+
 export function buildPromptRestartCandidateOptions(
 	frozenPrompt,
 	failedCandidates,
@@ -5,7 +7,7 @@ export function buildPromptRestartCandidateOptions(
 	const options = [
 		{
 			key: "frozen",
-			label: "冻结原始提示词",
+			label: "运行开始时的提示词",
 			prompt: String(frozenPrompt ?? ""),
 			truncated: false,
 		},
@@ -27,7 +29,7 @@ export function buildPromptRestartCandidateOptions(
 				: "unknown";
 		options.push({
 			key: `attempt-${attempt}`,
-			label: `第 ${attempt} 次失败 · ${failureCategory}`,
+			label: `第 ${attempt} 次失败 · ${attemptFailureLabel(failureCategory)}`,
 			prompt: candidate.prompt,
 			truncated: candidate.truncated === true,
 		});

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

@@ -1,3 +1,4 @@
+import { isPlainNavigationClick, isRowNavigationClick } from "./router.js";
 /** Object relation navigation (Observe UI R5). */
 import { el } from "./dom.js";
 import { inspectPathToCanonicalHref, navigate } from "./router.js";
@@ -50,6 +51,7 @@ export function objectRouteLink(kind, id, snapshot, featureId) {
 	const a = el("a", "object-link", id);
 	a.href = inspectPathToCanonicalHref(path);
 	a.addEventListener("click", (e) => {
+		if (!isPlainNavigationClick(e)) return;
 		e.preventDefault();
 		e.stopPropagation();
 		navigate(path);
@@ -70,11 +72,11 @@ export function featureLookupState(snapshot, featureId) {
 
 export const RELATION_KIND_ORDER = ["feature", "task", "batch", "run", "dag"];
 export const RELATION_LABELS = {
-	feature: "Feature",
-	task: "Task",
-	batch: "Batch",
-	run: "Run",
-	dag: "DAG",
+	feature: "需求",
+	task: "任务",
+	batch: "任务批次",
+	run: "执行实例",
+	dag: "运行流程",
 };
 
 /**

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

@@ -201,6 +201,11 @@ export function parseHashRouteWithFilters(hashValue) {
 	const raw = String(hashValue ?? "");
 	const withoutQuery = raw.replace(/^#/, "").split("?")[0];
 	const base = parseHashRoute("#" + (withoutQuery || "/"));
+	if (base.view === "dag") {
+		const params = new URLSearchParams(raw.includes("?") ? raw.slice(raw.indexOf("?") + 1) : "");
+		const nodeId = params.get("node");
+		if (nodeId) return { ...base, inspector: { nodeId, tab: params.get("tab") || null, executionKey: /^(attempt|pass)-[1-9]\d*$/.test(params.get("attempt") || "") ? params.get("attempt") : null } };
+	}
 	if (base.view === "dags") {
 		const history = parseDagHistoryQuery(raw);
 		return { ...base, page: history.page, pageSize: history.pageSize };
@@ -220,3 +225,11 @@ export function buildHashPath(path, filters = {}) {
 	const qs = params.toString();
 	return qs ? `${base}?${qs}` : base;
 }
+
+/** Leave browser-native modified clicks and text selection intact. */
+export function isPlainNavigationClick(event) {
+	return !event.defaultPrevented && (event.button == null || event.button === 0) && !event.metaKey && !event.ctrlKey && !event.shiftKey && !event.altKey;
+}
+export function isRowNavigationClick(event) {
+	return isPlainNavigationClick(event) && !event.target?.closest?.("a, button, input, select, textarea, summary, [role='button']") && !String(globalThis.getSelection?.() ?? "").trim();
+}

package/dist/worker/observe/static/run-processing.js

@@ -1,3 +1,4 @@
+import { isPlainNavigationClick, isRowNavigationClick } from "./router.js";
 /** Run step/command/artifact processing and task history rows. */
 import {
 	STEP_LABELS,
@@ -132,6 +133,7 @@ export function taskRunHistoryRow(run) {
 		);
 		a.textContent = run.workerRunId;
 		a.addEventListener("click", (e) => {
+			if (!isPlainNavigationClick(e)) return;
 			e.preventDefault();
 			navigate(`#/run/${encodeURIComponent(run.workerRunId)}`);
 		});

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

@@ -1,6 +1,7 @@
+import { isPlainNavigationClick, isRowNavigationClick } from "./router.js";
 /** Shell chrome: view switching, breadcrumb, header refresh, relation bar. */
 import { UI_TEXT } from "./constants.js";
-import { clearNode, el } from "./dom.js";
+import { clearNode, el, iconButton } from "./dom.js";
 import { formatAgo } from "./format.js";
 import { inspectPathToCanonicalHref, navigate } from "./router.js";
 import { buildObjectRelations, renderObjectRelationBar } from "./relations.js";
@@ -26,12 +27,15 @@ export function setBreadcrumb(parts) {
 			a.href = inspectPathToCanonicalHref(part.href);
 			a.textContent = part.label;
 			a.addEventListener("click", (e) => {
+				if (!isPlainNavigationClick(e)) return;
 				e.preventDefault();
 				navigate(part.href);
 			});
 			nav.appendChild(a);
 		} else {
-			nav.appendChild(document.createTextNode(part.label));
+			// 当前位置包一层 span：窄屏可对末级做 ellipsis 截断。
+			const current = el("span", "breadcrumb-current", part.label);
+			nav.appendChild(current);
 		}
 	});
 }
@@ -43,7 +47,7 @@ export function updateHeaderRefresh(generatedAt, options = {}) {
 		elRefresh.textContent = "";
 		return;
 	}
-	const modeLabel =
+	const modeLabel = options.mode === "ended" ? "已结束 · 按需刷新" : options.mode === "paused" ? "刷新已暂停" :
 		options.mode === "manual"
 			? UI_TEXT.manualRefresh
 			: options.mode === "auto"
@@ -63,3 +67,32 @@ export function mountRelationBar(containerId, ids, snapshot) {
 		elBar.appendChild(el("p", "empty", "关联投影暂时不可用。"));
 	}
 }
+
+export function bindManualViewRefresh(view, refresh) {
+	const heading = document.querySelector(`#view-${view} .view-heading`);
+	if (!heading) return;
+	let button = heading.querySelector(".view-manual-refresh");
+	if (!button) { button = iconButton("刷新本页", "ri-refresh-line", "view-manual-refresh"); button.type = "button"; heading.appendChild(button); }
+	button.onclick = async () => { button.disabled = true; try { await refresh(); } finally { button.disabled = false; } };
+}
+
+export function mountTaskRelationPicker(containerId, ids, tasks, snapshot) {
+	const host = document.getElementById(containerId);
+	if (!host) return;
+	const previous = host.dataset.selectedTask;
+	const taskKey = (task) => JSON.stringify([task.featureId ?? ids.featureId ?? "", task.taskId]);
+	clearNode(host);
+	const select = el("select", "relation-task-picker");
+	select.setAttribute("aria-label", `选择关联任务，共 ${tasks.length} 个`);
+	for (const task of tasks) { const option = el("option", null, `${task.title || task.taskId} · ${task.status ?? "未记录"}`); option.value = taskKey(task); select.appendChild(option); }
+	select.value = tasks.some((task) => taskKey(task) === previous) ? previous : (tasks[0] ? taskKey(tasks[0]) : "");
+	const relations = el("div");
+	const render = () => {
+		host.dataset.selectedTask = select.value;
+		const task = tasks.find((task) => taskKey(task) === select.value) ?? tasks[0];
+		clearNode(relations);
+		relations.appendChild(renderObjectRelationBar(buildObjectRelations({ ...ids, taskId: task?.taskId, featureId: task?.featureId ?? ids.featureId, workerRunId: task?.workerRunId, dagRunId: task?.dagRunId, batchRunId: ids.batchRunId ?? task?.batchRunId }, snapshot), snapshot));
+	};
+	if (tasks.length > 1) { host.appendChild(el("span", "muted", `${tasks.length} 个关联任务 `)); host.appendChild(select); }
+	host.appendChild(relations); select.addEventListener("change", render); render();
+}

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

@@ -173,8 +173,25 @@ export function updateDagTrajectoryViewportState(
 export const dagInspectorViewportStates = new Map();
 
 /** Build a stable inspector scroll region key (AC-005 context isolation). */
-export function inspectorViewportRegionKey(dagRunId, nodeId, tab) {
-	return `dag:${dagRunId ?? ""}:${nodeId ?? ""}:${tab ?? "output"}`;
+export function inspectorViewportRegionKey(dagRunId, nodeId, tab, executionKey = "") {
+	return `dag:${dagRunId ?? ""}:${nodeId ?? ""}:${tab ?? "output"}${executionKey ? `:${executionKey}` : ""}`;
+}
+
+/** Session-only reading/draft state. Never persists prompt text to disk. */
+export const inspectorReadingStates = new Map();
+export const inspectorNodeSelections = new Map();
+export const inspectorDrafts = new Map();
+export const inspectorOperations = new Map();
+export const inspectRouteStates = new Map();
+export const taskHistoryStates = new Map();
+export function inspectorReadingState(dagRunId, nodeId, tab, executionKey, followLatest = false) {
+	const key = inspectorViewportRegionKey(dagRunId, nodeId, tab, executionKey || "latest");
+	if (!inspectorReadingStates.has(key)) inspectorReadingStates.set(key, {
+		key, scrollTop: 0, scrollLeft: 0, followLatest,
+		filter: "all", query: "", errorsOnly: false, showProtocol: false,
+		openDetails: new Set(), seenCount: 0, eventCount: 0,
+	});
+	return inspectorReadingStates.get(key);
 }
 
 export function updateDagInspectorViewportState(
@@ -403,6 +420,7 @@ export function applyWorkspaceScopeSwitch(
 	trace.push("abort-old");
 	// 2. clear old
 	uiState.lastSnapshot = null;
+	for (const cache of [dagInspectorViewportStates, inspectorReadingStates, inspectorNodeSelections, inspectorDrafts, inspectorOperations, inspectRouteStates, taskHistoryStates]) cache.clear();
 	uiState.specEvidenceDetail = null;
 	uiState.specEvidenceListEvidence = null;
 	clearDagNodeExecutionOutputCache();
@@ -531,6 +549,21 @@ export function computeFollowLatest(
 	return height - top - client < Math.max(0, Number(threshold) || 0);
 }
 
+// Chat-style jump-to-bottom visibility: the floating control is only useful
+// when the region can scroll and the viewport is away from the bottom. It
+// applies to every execution-record viewport, running or ended alike.
+export function isScrollRegionAboveBottom(content, overflowPx = 4) {
+	const scrollHeight = Number(content?.scrollHeight ?? 0);
+	const clientHeight = Number(content?.clientHeight ?? 0);
+	if (!Number.isFinite(scrollHeight) || !Number.isFinite(clientHeight)) {
+		return false;
+	}
+	if (scrollHeight - clientHeight <= Math.max(0, Number(overflowPx) || 0)) {
+		return false;
+	}
+	return !computeFollowLatest(content?.scrollTop ?? 0, scrollHeight, clientHeight);
+}
+
 // Generalised viewport-state record keyed by `regionKey`, so the same helper
 // serves the DAG node inspector output ("dag:<runId>:<nodeId>:output") and the
 // Worker run output ("run:<runId>:output").