@tea-agent/loop-agent 0.11.0 → 0.12.0

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

@@ -0,0 +1,148 @@
+/** Shared constants for Observe UI (R5). */
+
+export const ACTIVE_DETAIL_POLL_MS = 2000;
+export const HIDDEN_POLL_MS = 30000;
+export const DASHBOARD_POLL_MS = 5000;
+export const DAG_INSPECTOR_DEFAULT_WIDTH = 440;
+export const DAG_INSPECTOR_MIN_WIDTH = 360;
+export const DAG_INSPECTOR_MAX_WIDTH = 680;
+export const DAG_INSPECTOR_RIGHT_OFFSET = 24;
+export const DAG_INSPECTOR_VIEWPORT_MARGIN = 48;
+export const DAG_INSPECTOR_KEYBOARD_STEP = 24;
+/** Distance from bottom (px) at which output regions auto-follow latest content. */
+export const OUTPUT_FOLLOW_LATEST_PX = 48;
+
+export const UI_TEXT = {
+	dashboard: "总览",
+	dagRuns: "DAG 运行",
+	failures: "异常 Task",
+	batchDetail: "批次详情",
+	runDetail: "运行详情",
+	dagDetail: "DAG 详情",
+	activeDags: "进行中的 DAG",
+	recentDags: "最近 DAG 运行",
+	batches: "Worker 批次",
+	noActiveDags: "当前没有进行中的 DAG，启动后将出现在这里。",
+	noRecentDags: "暂无 DAG 运行记录。",
+	noBatches: "暂无 Worker 批次，运行后将出现在这里。",
+	noNodes: "暂无节点。",
+	noOutput: "暂无节点输出。",
+	noSessionEvents: "该节点暂无过程日志",
+	noArtifacts: "暂无产物记录。",
+	noActiveCommand: "当前没有正在执行的命令。",
+	noFailures: "当前没有异常 Task。",
+	enterDetail: "查看详情 →",
+	repoRoot: "仓库根目录",
+	generatedAt: "生成时间",
+	refreshStatus: "更新",
+	failureInbox: "异常 Task",
+	nearRealtime: "轮询刷新",
+};
+
+export const STATUS_LABELS = {
+	running: "运行中",
+	started: "已启动",
+	pending: "等待中",
+	queued: "排队中",
+	succeeded: "成功",
+	finished: "已完成",
+	completed: "已完成",
+	done: "完成",
+	failed: "失败",
+	error: "错误",
+	partial_failed: "部分失败",
+	partialfailed: "部分失败",
+	blocked: "阻塞",
+	stale: "心跳失联",
+	reused: "复用",
+	unknown: "未知",
+	cancelled: "已取消",
+	skipped: "已跳过",
+	finished_upper: "已完成",
+	error_upper: "错误",
+	skipped_upper: "已跳过",
+};
+
+export const LIVENESS_LABELS = {
+	active: "执行器正常",
+	"node-quiet": "执行器正常，节点长时间无活动",
+	quiet: "无输出（存活）",
+	stale: "执行器心跳中断",
+	"timeout-risk": "即将超时",
+	orphaned: "执行器已退出",
+	"unknown-host": "无法判断（在其他主机运行）",
+	unknown: "无法判断（无心跳记录）",
+};
+
+export const DAG_EFFECTIVE_STATUS_LABELS = {
+	pending: "等待执行",
+	running: "正在执行",
+	"running-quiet": "运行可疑",
+	paused: "已暂停",
+	interrupted: "执行已中断",
+	"remote-unknown": "远端状态未知",
+	finished: "已完成",
+	failed: "执行失败",
+	superseded: "任务已另行完成",
+	abandoned: "已放弃",
+	unknown: "状态未知",
+};
+
+export const STEP_LABELS = {
+	preflight: "预检",
+	materialize: "准备 Task 文件",
+	"dag-run-task": "生成 DAG",
+	"pi-model-override": "覆盖 Pi 模型",
+	"dag-validate": "校验 DAG",
+	"run-dag": "执行 DAG",
+	"report-decision": "上报决策结果",
+	"dag-doctor": "DAG 诊断",
+	"closeout-draft": "失败收尾草稿",
+	"promote-run": "提升运行",
+	"closeout-task": "Task 收尾",
+};
+
+export const ARTIFACT_LABELS = {
+	stdoutPath: "运行输出",
+	stderrPath: "错误输出",
+	resultPath: "结果",
+	runRecordPath: "运行记录",
+	reportMarkdown: "报告",
+	doctorMarkdown: "诊断",
+	closeoutDraft: "收尾草稿",
+	dagPath: "DAG 路径",
+};
+
+export const STEP_ORDER = [
+	"preflight",
+	"materialize",
+	"dag-run-task",
+	"pi-model-override",
+	"dag-validate",
+	"run-dag",
+	"report-decision",
+	"dag-doctor",
+	"closeout-draft",
+	"promote-run",
+	"closeout-task",
+];
+
+export const TERMINAL_RUN_STATUSES = new Set([
+	"finished",
+	"completed",
+	"succeeded",
+	"failed",
+	"partial_failed",
+	"error",
+	"cancelled",
+]);
+
+export const ARTIFACT_KEYS = [
+	"stdoutPath",
+	"stderrPath",
+	"resultPath",
+	"runRecordPath",
+	"reportMarkdown",
+	"doctorMarkdown",
+	"closeoutDraft",
+];

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

@@ -0,0 +1,67 @@
+/** Copy-only recommended commands (Observe UI R5). */
+import { el } from "./dom.js";
+
+export async function copyText(text) {
+	const value = String(text ?? "");
+	if (!value) return false;
+	try {
+		if (typeof navigator !== "undefined" && navigator.clipboard?.writeText) {
+			await navigator.clipboard.writeText(value);
+			return true;
+		}
+	} catch {
+		// fall through
+	}
+	try {
+		const ta = document.createElement("textarea");
+		ta.value = value;
+		ta.setAttribute("readonly", "");
+		ta.style.position = "fixed";
+		ta.style.left = "-9999px";
+		document.body.appendChild(ta);
+		ta.select();
+		const ok = document.execCommand("copy");
+		document.body.removeChild(ta);
+		return ok;
+	} catch {
+		return false;
+	}
+}
+
+/** Advisory recommended command: copy-only, never executes. */
+export function renderRecommendedCommand(action) {
+	const block = el("div", "recommended-command");
+	if (!action) {
+		block.appendChild(el("span", "muted", "缺失"));
+		return block;
+	}
+	const head = el("div", "recommended-command-head");
+	if (action.kind) {
+		head.appendChild(el("span", "recommended-command-kind", action.kind));
+	}
+	head.appendChild(
+		el("span", "recommended-command-label", action.label ?? "—"),
+	);
+	block.appendChild(head);
+	if (action.command) {
+		const body = el("div", "recommended-command-body");
+		const code = el("code", "recommended-command-text", action.command);
+		body.appendChild(code);
+		const btn = el("button", "copy-command", "复制");
+		btn.type = "button";
+		btn.addEventListener("click", (e) => {
+			e.preventDefault();
+			e.stopPropagation();
+			void copyText(action.command).then((ok) => {
+				btn.textContent = ok ? "已复制" : "复制失败";
+				setTimeout(() => {
+					btn.textContent = "复制";
+				}, 1500);
+			});
+		});
+		body.appendChild(btn);
+		block.appendChild(body);
+	}
+	return block;
+}
+

package/dist/worker/observe/static/dag-helpers.js

@@ -0,0 +1,172 @@
+/** DAG status helpers, progress, active cards, rank lanes. */
+import { UI_TEXT } from "./constants.js";
+import { el } from "./dom.js";
+import {
+	badge,
+	dagStatusBadge,
+	formatDuration,
+	formatAgo,
+	formatMs,
+} from "./format.js";
+import { navigate } from "./router.js";
+
+export function isNodeActive(status) {
+	if (!status) return false;
+	const s = status.toLowerCase();
+	return (
+		s === "running" || s === "started" || s === "pending" || s === "queued"
+	);
+}
+
+export function isNodeFinished(status) {
+	if (!status) return false;
+	const s = status.toLowerCase();
+	return (
+		s === "finished" ||
+		s === "completed" ||
+		s === "succeeded" ||
+		s === "done" ||
+		s === "error" ||
+		s === "failed" ||
+		s === "skipped"
+	);
+}
+
+export function isNodeFailed(status) {
+	if (!status) return false;
+	const s = status.toLowerCase();
+	return s === "error" || s === "failed" || s === "partial_failed";
+}
+
+export function dagProgress(dag) {
+	const nodes = dag.nodes ?? [];
+	const finished = nodes.filter((n) => isNodeFinished(n.status)).length;
+	return { finished, total: nodes.length };
+}
+
+export function getActiveNodes(dag) {
+	return (dag.nodes ?? []).filter((n) => isNodeActive(n.status));
+}
+
+export function dagSortTime(dag) {
+	return dag.startedAt ?? dag.finishedAt ?? "";
+}
+
+export function renderActiveDagCard(dag, nowMs) {
+	const card = el("div", "active-dag-card");
+	if (isNodeActive(dag.status) || getActiveNodes(dag).length > 0) {
+		card.classList.add("active-dag-card-running");
+	}
+	const title = dag.title || dag.dagRunId;
+	const header = el("div", "active-dag-header");
+	header.appendChild(el("span", "active-dag-title", title));
+	header.appendChild(dagStatusBadge(dag.effectiveStatus ?? dag.status));
+	card.appendChild(header);
+
+	const progress = dagProgress(dag);
+	const activeNodes = getActiveNodes(dag);
+	const currentLabel =
+		activeNodes.length > 0
+			? activeNodes
+					.map((n) => {
+						const parts = [n.nodeId];
+						if (n.executor) parts.push(`(${n.executor})`);
+						if (n.model) parts.push(n.model);
+						return parts.join(" ");
+					})
+					.join(", ")
+			: "—";
+
+	const elapsed =
+		dag.durationMs ??
+		(dag.startedAt
+			? Math.max(0, nowMs - Date.parse(dag.startedAt))
+			: undefined);
+	const lastUpdate = dag.finishedAt ?? dag.startedAt;
+
+	const meta = el("div", "active-dag-meta");
+	meta.appendChild(
+		el(
+			"span",
+			null,
+			`进度 ${progress.finished}/${progress.total} · 当前节点：${currentLabel}`,
+		),
+	);
+	meta.appendChild(
+		el(
+			"span",
+			null,
+			`已用时 ${formatDuration(elapsed)} · 最近活动 ${formatAgo(lastUpdate, nowMs)}`,
+		),
+	);
+	card.appendChild(meta);
+
+	const link = el("a", "active-dag-link", UI_TEXT.enterDetail);
+	link.href = `#/dag/${encodeURIComponent(dag.dagRunId)}`;
+	link.addEventListener("click", (e) => {
+		e.preventDefault();
+		navigate(`/dag/${encodeURIComponent(dag.dagRunId)}`);
+	});
+	card.appendChild(link);
+	return card;
+}
+
+export function renderRankLanes(dag) {
+	const container = el("div", "rank-lanes");
+	const nodes = dag.nodes ?? [];
+	const ranks = dag.ranks;
+	const rankGroups = new Map();
+
+	if (ranks && ranks.length > 0) {
+		for (let i = 0; i < ranks.length; i++) {
+			rankGroups.set(String(i), ranks[i]);
+		}
+		for (const node of nodes) {
+			const rank = node.rank ?? "—";
+			if (!rankGroups.has(rank)) {
+				rankGroups.set(rank, [node.nodeId]);
+			} else if (!rankGroups.get(rank).includes(node.nodeId)) {
+				rankGroups.get(rank).push(node.nodeId);
+			}
+		}
+	} else {
+		for (const node of nodes) {
+			const rank = node.rank ?? "—";
+			const list = rankGroups.get(rank) ?? [];
+			list.push(node.nodeId);
+			rankGroups.set(rank, list);
+		}
+	}
+
+	const sortedRanks = [...rankGroups.keys()].sort((a, b) => {
+		const na = Number(a);
+		const nb = Number(b);
+		if (!Number.isNaN(na) && !Number.isNaN(nb)) return na - nb;
+		return a.localeCompare(b);
+	});
+
+	const nodeById = Object.fromEntries(nodes.map((n) => [n.nodeId, n]));
+
+	for (const rank of sortedRanks) {
+		const lane = el("div", "rank-lane");
+		lane.appendChild(el("div", "rank-lane-label", `第 ${rank} 层`));
+		const chips = el("div", "rank-lane-nodes");
+		for (const nodeId of rankGroups.get(rank) ?? []) {
+			const node = nodeById[nodeId] ?? { nodeId };
+			const chip = el("div", "rank-node-chip");
+			if (isNodeActive(node.status)) chip.classList.add("rank-node-active");
+			if (isNodeFailed(node.status)) chip.classList.add("rank-node-error");
+			chip.appendChild(el("span", "rank-node-id", nodeId));
+			if (node.status) chip.appendChild(badge(node.status));
+			if (node.durationMs !== undefined) {
+				chip.appendChild(
+					el("span", "rank-node-dur", formatMs(node.durationMs)),
+				);
+			}
+			chips.appendChild(chip);
+		}
+		lane.appendChild(chips);
+		container.appendChild(lane);
+	}
+	return container;
+}

package/dist/worker/observe/static/dag-model.js

@@ -0,0 +1,72 @@
+/** DAG / dashboard pure model helpers (Observe UI R5). */
+
+const TERMINAL_DAG_EFFECTIVE_STATUSES = new Set([
+	"finished",
+	"failed",
+	"superseded",
+	"abandoned",
+]);
+
+const TERMINAL_RUN_STATUSES = new Set([
+	"finished",
+	"completed",
+	"succeeded",
+	"failed",
+	"partial_failed",
+	"error",
+	"cancelled",
+]);
+
+export function dagMetaVisibility(dag) {
+	const terminal =
+		(dag?.lifecycle ?? "").toLowerCase() === "completed" ||
+		TERMINAL_DAG_EFFECTIVE_STATUSES.has(dag?.effectiveStatus);
+	return {
+		showExecutorStatus: !terminal,
+		showConsistencyWarning: dag?.stateConsistent === false,
+		showResume: dag?.recoveryEligibility?.canResume === true,
+		showReconcile: dag?.recoveryEligibility?.canReconcile === true,
+	};
+}
+
+function isNodeActive(status) {
+	if (!status) return false;
+	const s = status.toLowerCase();
+	return (
+		s === "running" || s === "started" || s === "pending" || s === "queued"
+	);
+}
+
+export function isDagRunActive(dag) {
+	if (
+		["running", "running-quiet", "remote-unknown", "pending"].includes(
+			dag.effectiveStatus,
+		)
+	)
+		return true;
+	if (dag.effectiveStatus && dag.effectiveStatus !== "unknown") return false;
+	const status = (dag.status ?? "").toLowerCase();
+	if ((dag.lifecycle ?? "").toLowerCase() === "paused") return false;
+	if (["orphaned", "stale"].includes((dag.liveness ?? "").toLowerCase()))
+		return false;
+	if (TERMINAL_RUN_STATUSES.has(status)) return false;
+	if (["running", "pending", "started"].includes(status)) return true;
+	return (dag.nodes ?? []).some((n) => isNodeActive(n.status));
+}
+
+const DASHBOARD_FEATURE_STATUSES = new Set(["running", "needs_action"]);
+
+export function dashboardVisibleFeatures(features) {
+	return (features ?? []).filter((feature) =>
+		DASHBOARD_FEATURE_STATUSES.has(feature?.status),
+	);
+}
+
+export function findDagForRun(snapshot, _workerRunId, task) {
+	const dagRuns = snapshot?.dagRuns ?? [];
+	if (task?.dagRunId) {
+		const byTask = dagRuns.find((d) => d.dagRunId === task.dagRunId);
+		if (byTask) return byTask;
+	}
+	return undefined;
+}

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

@@ -0,0 +1,61 @@
+/** DOM helpers (Observe UI R5). */
+
+export function clearNode(node) {
+	while (node.firstChild) node.removeChild(node.firstChild);
+}
+
+export function el(tag, className, text) {
+	const node = document.createElement(tag);
+	if (className) node.className = className;
+	if (text !== undefined) node.textContent = text;
+	return node;
+}
+
+export function metaGrid(entries) {
+	const dl = el("dl", "meta-grid");
+	for (const [label, value] of entries) {
+		const item = document.createElement("div");
+		item.className = "meta-item";
+		const dt = document.createElement("dt");
+		dt.textContent = label;
+		const dd = document.createElement("dd");
+		if (value instanceof Node) dd.appendChild(value);
+		else dd.textContent = value ?? "—";
+		item.appendChild(dt);
+		item.appendChild(dd);
+		dl.appendChild(item);
+	}
+	return dl;
+}
+
+export function buildTable(headers, rows) {
+	const table = document.createElement("table");
+	const thead = document.createElement("thead");
+	const headRow = document.createElement("tr");
+	for (const h of headers) {
+		const th = document.createElement("th");
+		th.textContent = h;
+		headRow.appendChild(th);
+	}
+	thead.appendChild(headRow);
+	table.appendChild(thead);
+
+	const tbody = document.createElement("tbody");
+	for (const row of rows) {
+		const tr = document.createElement("tr");
+		if (row.className) tr.className = row.className;
+		if (row.onClick) {
+			tr.classList.add("clickable");
+			tr.addEventListener("click", row.onClick);
+		}
+		for (const cell of row.cells) {
+			const td = document.createElement("td");
+			if (cell instanceof Node) td.appendChild(cell);
+			else td.textContent = cell ?? "—";
+			tr.appendChild(td);
+		}
+		tbody.appendChild(tr);
+	}
+	table.appendChild(tbody);
+	return table;
+}

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

@@ -0,0 +1,67 @@
+/** Pool task sorting and status filter buckets (Observe UI R5). */
+
+export function sortPoolTasks(tasks) {
+	const list = Array.isArray(tasks) ? [...tasks] : [];
+	const active = new Set(["running", "pending", "blocked", "stale", "unknown"]);
+	const rank = (status) => {
+		const key = (status ?? "unknown").toLowerCase();
+		if (key === "running") return 0;
+		if (key === "pending" || key === "queued") return 1;
+		if (key === "blocked") return 2;
+		if (key === "stale") return 3;
+		if (active.has(key)) return 4;
+		return 10;
+	};
+	const timeKey = (task) =>
+		task.updatedAt || task.finishedAt || task.startedAt || "";
+	list.sort((a, b) => {
+		const ra = rank(a.status);
+		const rb = rank(b.status);
+		if (ra !== rb) return ra - rb;
+		if (ra >= 10) {
+			const tb = timeKey(b).localeCompare(timeKey(a));
+			if (tb !== 0) return tb;
+		}
+		return String(a.taskId ?? "").localeCompare(String(b.taskId ?? ""));
+	});
+	return list;
+}
+
+/**
+ * Match task status against a hash filter token (same buckets as KPI counts).
+ * pending ⊇ queued; succeeded ⊇ reused|done; blocked ⊇ stale.
+ */
+export function matchesPoolStatusFilter(taskStatus, filter) {
+	const st = (taskStatus ?? "").toLowerCase();
+	const f = (filter ?? "").toLowerCase();
+	if (!f) return true;
+	if (f === "pending") return st === "pending" || st === "queued";
+	if (f === "succeeded")
+		return st === "succeeded" || st === "reused" || st === "done";
+	if (f === "blocked") return st === "blocked" || st === "stale";
+	if (f === "failed") return st === "failed" || st === "error";
+	if (f === "running") return st === "running";
+	return st === f;
+}
+
+export function poolStatusCounts(tasks) {
+	const counts = {
+		running: 0,
+		pending: 0,
+		blocked: 0,
+		failed: 0,
+		succeeded: 0,
+		other: 0,
+	};
+	for (const task of tasks) {
+		const key = (task.status ?? "unknown").toLowerCase();
+		if (key === "running") counts.running += 1;
+		else if (key === "pending" || key === "queued") counts.pending += 1;
+		else if (key === "blocked" || key === "stale") counts.blocked += 1;
+		else if (key === "failed" || key === "error") counts.failed += 1;
+		else if (key === "succeeded" || key === "reused" || key === "done")
+			counts.succeeded += 1;
+		else counts.other += 1;
+	}
+	return counts;
+}