@tea-agent/loop-agent 0.13.0-beta.0 → 0.13.0

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

@@ -1,253 +1,267 @@
-/** Shared mutable UI state singleton (Observe UI R5). */
-import {
-	ACTIVE_DETAIL_POLL_MS,
-	HIDDEN_POLL_MS,
-	DASHBOARD_POLL_MS,
-	TERMINAL_RUN_STATUSES,
-	OUTPUT_FOLLOW_LATEST_PX,
-} from "./constants.js";
-import { clearNode, el } from "./dom.js";
-
-/**
- * Single mutable ownership bag. Import `{ uiState }` and mutate properties.
- * Never assign through `import * as ns` live bindings (Chrome TypeError).
- */
-export const uiState = {
-	dashboardTimer: null,
-	runPollTimer: null,
-	dagPollTimer: null,
-	poolTimer: null,
-	taskPollTimer: null,
-	runEventOffset: 0,
-	runEvents: [],
-	currentRunId: null,
-	currentBatchRunId: null,
-	currentDagRunId: null,
-	selectedDagNodeId: null,
-	sessionEventOffset: 0,
-	sessionEvents: [],
-	lastSnapshot: null,
-	dagInspectorOpen: false,
-	dagInspectorTab: "output",
-	dagInspectorWidth: null,
-	dagGraphViewportState: null,
-	dagTimelineViewportState: null,
-	dagNodeOutputViewportState: null,
-	runOutputViewportState: null,
-	pollingGeneration: 0,
-};
-
-/** Per-dagRunId graph viewport restore map (stable Map instance). */
-export const dagGraphViewportStates = new Map();
-
-export function isPageVisible() {
-	return (
-		typeof document === "undefined" || document.visibilityState !== "hidden"
-	);
-}
-
-export function detailPollDelay(status, isVisible) {
-	const normalizedStatus = (status ?? "").toLowerCase().replace(/-/g, "_");
-	if (TERMINAL_RUN_STATUSES.has(normalizedStatus)) return null;
-	return isVisible ? ACTIVE_DETAIL_POLL_MS : HIDDEN_POLL_MS;
-}
-
-export function dashboardPollDelay() {
-	return isPageVisible() ? DASHBOARD_POLL_MS : HIDDEN_POLL_MS;
-}
-
-export function updateDagGraphViewportState(
-	_previous,
-	dagRunId,
-	scrollLeft,
-	scrollTop,
-) {
-	return {
-		dagRunId,
-		scrollLeft: Math.max(0, Number(scrollLeft) || 0),
-		scrollTop: Math.max(0, Number(scrollTop) || 0),
-	};
-}
-
-export function captureDagGraphViewportState(previous, dagRunId, viewport) {
-	if (!viewport || viewport.dataset?.dagRunId !== dagRunId) return previous;
-	return updateDagGraphViewportState(
-		previous,
-		dagRunId,
-		viewport.scrollLeft,
-		viewport.scrollTop,
-	);
-}
-
-export function updateDagTimelineViewportState(
-	_previous,
-	dagRunId,
-	nodeId,
-	scrollLeft,
-	scrollTop,
-	followLatest,
-) {
-	return {
-		dagRunId,
-		nodeId,
-		scrollLeft: Math.max(0, Number(scrollLeft) || 0),
-		scrollTop: Math.max(0, Number(scrollTop) || 0),
-		followLatest: Boolean(followLatest),
-	};
-}
-
-// Unified follow-latest helper for DAG node output and Worker output scroll
-// regions. Returns true only when the user is parked within `threshold` px of
-// the bottom, mirroring the existing process-timeline behaviour.
-export function computeFollowLatest(
-	scrollTop,
-	scrollHeight,
-	clientHeight,
-	threshold = OUTPUT_FOLLOW_LATEST_PX,
-) {
-	const top = Number(scrollTop);
-	const height = Number(scrollHeight);
-	const client = Number(clientHeight);
-	if (
-		!Number.isFinite(top) ||
-		!Number.isFinite(height) ||
-		!Number.isFinite(client)
-	) {
-		return false;
-	}
-	if (height <= 0 || client <= 0) return false;
-	return height - top - client < Math.max(0, Number(threshold) || 0);
-}
-
-// 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").
-export function updateDagOutputViewportState(
-	_previous,
-	regionKey,
-	scrollLeft,
-	scrollTop,
-	followLatest,
-) {
-	return {
-		regionKey,
-		scrollLeft: Math.max(0, Number(scrollLeft) || 0),
-		scrollTop: Math.max(0, Number(scrollTop) || 0),
-		followLatest: Boolean(followLatest),
-	};
-}
-
-// Poll-render decision helpers. Initial paints always rebuild the shell; a
-// non-initial refresh reuses the existing viewport/inspector DOM identity so
-// active pointer-capture targets (scrollbar / resize handle) survive.
-export function shouldReuseDagDetailShell(initial, hasExistingViewport) {
-	return !initial && Boolean(hasExistingViewport);
-}
-
-export function shouldPreserveDiagnosticsOpen(initial, existingOpen) {
-	if (initial) return false;
-	return Boolean(existingOpen);
-}
-
-// Detects an in-progress resize/scroll gesture so the poll renderer can defer
-// tearing down the interactive shell until the gesture releases.
-export function isInteractiveGestureActive(bodyClassList) {
-	const list = bodyClassList;
-	if (!list || typeof list.contains !== "function") return false;
-	return (
-		list.contains("is-resizing-dag-inspector") ||
-		list.contains("is-resizing-dag-graph")
-	);
-}
-
-export function stopTimers() {
-	uiState.pollingGeneration += 1;
-	if (uiState.dashboardTimer) {
-		clearTimeout(uiState.dashboardTimer);
-		uiState.dashboardTimer = null;
-	}
-	if (uiState.runPollTimer) {
-		clearTimeout(uiState.runPollTimer);
-		uiState.runPollTimer = null;
-	}
-	if (uiState.dagPollTimer) {
-		clearTimeout(uiState.dagPollTimer);
-		uiState.dagPollTimer = null;
-	}
-	if (uiState.poolTimer) {
-		clearTimeout(uiState.poolTimer);
-		uiState.poolTimer = null;
-	}
-	if (uiState.taskPollTimer) {
-		clearTimeout(uiState.taskPollTimer);
-		uiState.taskPollTimer = null;
-	}
-	uiState.currentRunId = null;
-	uiState.currentBatchRunId = null;
-	uiState.currentDagRunId = null;
-	uiState.selectedDagNodeId = null;
-	uiState.sessionEventOffset = 0;
-	uiState.sessionEvents = [];
-	uiState.runEventOffset = 0;
-	uiState.runEvents = [];
-}
-
-/** Pure descriptor for loading / empty / degraded / error (REQ-R5-05). */
-export function viewStateDescriptor(kind, message, options = {}) {
-	const classByKind = {
-		loading: "view-state view-state-loading",
-		empty: "view-state view-state-empty empty",
-		degraded: "view-state view-state-degraded projection-fault",
-		error: "view-state view-state-error",
-	};
-	const role =
-		kind === "error" || kind === "degraded"
-			? "alert"
-			: kind === "loading"
-				? "status"
-				: null;
-	return {
-		kind,
-		className: classByKind[kind] ?? "view-state",
-		role,
-		ariaLive: kind === "loading" ? "polite" : null,
-		message: message ?? "",
-		detail: options.detail ?? null,
-		messageClass:
-			kind === "empty" ? "empty" : kind === "loading" ? "muted" : null,
-	};
-}
-
-/** Distinguishable loading / empty / degraded / error panel states (REQ-R5-05). */
-export function renderViewState(kind, message, options = {}) {
-	const desc = viewStateDescriptor(kind, message, options);
-	const node = el("div", desc.className);
-	if (desc.role) node.setAttribute("role", desc.role);
-	if (desc.ariaLive) node.setAttribute("aria-live", desc.ariaLive);
-	node.appendChild(el("p", desc.messageClass, desc.message));
-	if (desc.detail) {
-		node.appendChild(el("p", "muted", desc.detail));
-	}
-	return node;
-}
-
-export function mountViewState(container, kind, message, options) {
-	if (!container) return null;
-	clearNode(container);
-	const node = renderViewState(kind, message, options);
-	container.appendChild(node);
-	return node;
-}
-
-export function setLastSnapshot(snapshot) {
-	uiState.lastSnapshot = snapshot;
-}
-
-export function setPollingGeneration(value) {
-	uiState.pollingGeneration = value;
-}
-
-export function bumpPollingGeneration() {
-	uiState.pollingGeneration += 1;
-	return uiState.pollingGeneration;
-}
+/** Shared mutable UI state singleton (Observe UI R5). */
+import {
+	ACTIVE_DETAIL_POLL_MS,
+	HIDDEN_POLL_MS,
+	DASHBOARD_POLL_MS,
+	TERMINAL_RUN_STATUSES,
+	OUTPUT_FOLLOW_LATEST_PX,
+} from "./constants.js";
+import { clearNode, el } from "./dom.js";
+
+/**
+ * Single mutable ownership bag. Import `{ uiState }` and mutate properties.
+ * Never assign through `import * as ns` live bindings (Chrome TypeError).
+ */
+export const uiState = {
+	dashboardTimer: null,
+	runPollTimer: null,
+	dagPollTimer: null,
+	poolTimer: null,
+	taskPollTimer: null,
+	runEventOffset: 0,
+	runEvents: [],
+	currentRunId: null,
+	currentBatchRunId: null,
+	currentDagRunId: null,
+	selectedDagNodeId: null,
+	sessionEventOffset: 0,
+	sessionEvents: [],
+	// Identity token ("<dagRunId>:<nodeId>#<seq>") bumped on every node/DAG
+	// switch. In-flight session-event fetches capture this before await and
+	// reject themselves when it no longer matches, so a stale response for a
+	// previous node can never mutate the current node's event cache.
+	sessionEventIdentity: null,
+	sessionEventIdentitySeq: 0,
+	lastSnapshot: null,
+	dagInspectorOpen: false,
+	dagInspectorTab: "output",
+	dagInspectorWidth: null,
+	dagGraphViewportState: null,
+	dagTimelineViewportState: null,
+	dagNodeOutputViewportState: null,
+	runOutputViewportState: null,
+	pollingGeneration: 0,
+};
+
+/** Per-dagRunId graph viewport restore map (stable Map instance). */
+export const dagGraphViewportStates = new Map();
+
+/** Build a fresh session-event identity token and bump the global sequence. */
+export function makeSessionEventIdentity(dagRunId, nodeId) {
+	uiState.sessionEventIdentitySeq += 1;
+	return `${dagRunId}:${nodeId}#${uiState.sessionEventIdentitySeq}`;
+}
+
+export function isPageVisible() {
+	return (
+		typeof document === "undefined" || document.visibilityState !== "hidden"
+	);
+}
+
+export function detailPollDelay(status, isVisible) {
+	const normalizedStatus = (status ?? "").toLowerCase().replace(/-/g, "_");
+	if (TERMINAL_RUN_STATUSES.has(normalizedStatus)) return null;
+	return isVisible ? ACTIVE_DETAIL_POLL_MS : HIDDEN_POLL_MS;
+}
+
+export function dashboardPollDelay() {
+	return isPageVisible() ? DASHBOARD_POLL_MS : HIDDEN_POLL_MS;
+}
+
+export function updateDagGraphViewportState(
+	_previous,
+	dagRunId,
+	scrollLeft,
+	scrollTop,
+) {
+	return {
+		dagRunId,
+		scrollLeft: Math.max(0, Number(scrollLeft) || 0),
+		scrollTop: Math.max(0, Number(scrollTop) || 0),
+	};
+}
+
+export function captureDagGraphViewportState(previous, dagRunId, viewport) {
+	if (!viewport || viewport.dataset?.dagRunId !== dagRunId) return previous;
+	return updateDagGraphViewportState(
+		previous,
+		dagRunId,
+		viewport.scrollLeft,
+		viewport.scrollTop,
+	);
+}
+
+export function updateDagTimelineViewportState(
+	_previous,
+	dagRunId,
+	nodeId,
+	scrollLeft,
+	scrollTop,
+	followLatest,
+) {
+	return {
+		dagRunId,
+		nodeId,
+		scrollLeft: Math.max(0, Number(scrollLeft) || 0),
+		scrollTop: Math.max(0, Number(scrollTop) || 0),
+		followLatest: Boolean(followLatest),
+	};
+}
+
+// Unified follow-latest helper for DAG node output and Worker output scroll
+// regions. Returns true only when the user is parked within `threshold` px of
+// the bottom, mirroring the existing process-timeline behaviour.
+export function computeFollowLatest(
+	scrollTop,
+	scrollHeight,
+	clientHeight,
+	threshold = OUTPUT_FOLLOW_LATEST_PX,
+) {
+	const top = Number(scrollTop);
+	const height = Number(scrollHeight);
+	const client = Number(clientHeight);
+	if (
+		!Number.isFinite(top) ||
+		!Number.isFinite(height) ||
+		!Number.isFinite(client)
+	) {
+		return false;
+	}
+	if (height <= 0 || client <= 0) return false;
+	return height - top - client < Math.max(0, Number(threshold) || 0);
+}
+
+// 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").
+export function updateDagOutputViewportState(
+	_previous,
+	regionKey,
+	scrollLeft,
+	scrollTop,
+	followLatest,
+) {
+	return {
+		regionKey,
+		scrollLeft: Math.max(0, Number(scrollLeft) || 0),
+		scrollTop: Math.max(0, Number(scrollTop) || 0),
+		followLatest: Boolean(followLatest),
+	};
+}
+
+// Poll-render decision helpers. Initial paints always rebuild the shell; a
+// non-initial refresh reuses the existing viewport/inspector DOM identity so
+// active pointer-capture targets (scrollbar / resize handle) survive.
+export function shouldReuseDagDetailShell(initial, hasExistingViewport) {
+	return !initial && Boolean(hasExistingViewport);
+}
+
+export function shouldPreserveDiagnosticsOpen(initial, existingOpen) {
+	if (initial) return false;
+	return Boolean(existingOpen);
+}
+
+// Detects an in-progress resize/scroll gesture so the poll renderer can defer
+// tearing down the interactive shell until the gesture releases.
+export function isInteractiveGestureActive(bodyClassList) {
+	const list = bodyClassList;
+	if (!list || typeof list.contains !== "function") return false;
+	return (
+		list.contains("is-resizing-dag-inspector") ||
+		list.contains("is-resizing-dag-graph")
+	);
+}
+
+export function stopTimers() {
+	uiState.pollingGeneration += 1;
+	if (uiState.dashboardTimer) {
+		clearTimeout(uiState.dashboardTimer);
+		uiState.dashboardTimer = null;
+	}
+	if (uiState.runPollTimer) {
+		clearTimeout(uiState.runPollTimer);
+		uiState.runPollTimer = null;
+	}
+	if (uiState.dagPollTimer) {
+		clearTimeout(uiState.dagPollTimer);
+		uiState.dagPollTimer = null;
+	}
+	if (uiState.poolTimer) {
+		clearTimeout(uiState.poolTimer);
+		uiState.poolTimer = null;
+	}
+	if (uiState.taskPollTimer) {
+		clearTimeout(uiState.taskPollTimer);
+		uiState.taskPollTimer = null;
+	}
+	uiState.currentRunId = null;
+	uiState.currentBatchRunId = null;
+	uiState.currentDagRunId = null;
+	uiState.selectedDagNodeId = null;
+	uiState.sessionEventOffset = 0;
+	uiState.sessionEvents = [];
+	uiState.sessionEventIdentity = null;
+	uiState.sessionEventIdentitySeq += 1;
+	uiState.runEventOffset = 0;
+	uiState.runEvents = [];
+}
+
+/** Pure descriptor for loading / empty / degraded / error (REQ-R5-05). */
+export function viewStateDescriptor(kind, message, options = {}) {
+	const classByKind = {
+		loading: "view-state view-state-loading",
+		empty: "view-state view-state-empty empty",
+		degraded: "view-state view-state-degraded projection-fault",
+		error: "view-state view-state-error",
+	};
+	const role =
+		kind === "error" || kind === "degraded"
+			? "alert"
+			: kind === "loading"
+				? "status"
+				: null;
+	return {
+		kind,
+		className: classByKind[kind] ?? "view-state",
+		role,
+		ariaLive: kind === "loading" ? "polite" : null,
+		message: message ?? "",
+		detail: options.detail ?? null,
+		messageClass:
+			kind === "empty" ? "empty" : kind === "loading" ? "muted" : null,
+	};
+}
+
+/** Distinguishable loading / empty / degraded / error panel states (REQ-R5-05). */
+export function renderViewState(kind, message, options = {}) {
+	const desc = viewStateDescriptor(kind, message, options);
+	const node = el("div", desc.className);
+	if (desc.role) node.setAttribute("role", desc.role);
+	if (desc.ariaLive) node.setAttribute("aria-live", desc.ariaLive);
+	node.appendChild(el("p", desc.messageClass, desc.message));
+	if (desc.detail) {
+		node.appendChild(el("p", "muted", desc.detail));
+	}
+	return node;
+}
+
+export function mountViewState(container, kind, message, options) {
+	if (!container) return null;
+	clearNode(container);
+	const node = renderViewState(kind, message, options);
+	container.appendChild(node);
+	return node;
+}
+
+export function setLastSnapshot(snapshot) {
+	uiState.lastSnapshot = snapshot;
+}
+
+export function setPollingGeneration(value) {
+	uiState.pollingGeneration = value;
+}
+
+export function bumpPollingGeneration() {
+	uiState.pollingGeneration += 1;
+	return uiState.pollingGeneration;
+}