pi-crew 0.9.16 → 0.9.17

package/src/ui/dashboard-panes/agents-pane.ts

@@ -1,12 +1,12 @@
-import type { RunDashboardOptions } from "../run-dashboard.ts";
-import { iconForStatus } from "../status-colors.ts";
-import type { RunUiSnapshot } from "../snapshot-types.ts";
-import { spinnerFrame } from "../spinner.ts";
 import type { CrewAgentRecord } from "../../runtime/crew-agent-runtime.ts";
+import { type LiveAgentHandle, listLiveAgents, listLiveAgentsByWorkspace } from "../../runtime/live-agent-manager.ts";
 import { formatCost } from "../../state/usage.ts";
-import { listLiveAgents, listLiveAgentsByWorkspace, type LiveAgentHandle } from "../../runtime/live-agent-manager.ts";
-import { computeLiveDurationMs } from "../live-duration.ts";
 import { visibleWidth } from "../../utils/visual.ts";
+import { computeLiveDurationMs } from "../live-duration.ts";
+import type { RunDashboardOptions } from "../run-dashboard.ts";
+import type { RunUiSnapshot } from "../snapshot-types.ts";
+import { spinnerFrame } from "../spinner.ts";
+import { iconForStatus } from "../status-colors.ts";
 
 /**
  * Fixed visible widths for the per-agent numeric metrics (finding V-1).
@@ -63,11 +63,15 @@ const TOOL_LABELS: Record<string, string> = {
 function describeActivity(handle: LiveAgentHandle): string {
 	const act = handle.activity;
 	if (act.activeTools.size > 0) {
-		const tools = [...new Set([...act.activeTools.values()])].map(t => TOOL_LABELS[t] ?? t);
+		const tools = [...new Set([...act.activeTools.values()])].map((t) => TOOL_LABELS[t] ?? t);
 		return tools.join(", ") + "…";
 	}
 	if (act.responseText?.trim()) {
-		const line = act.responseText.split("\n").find((l) => l.trim())?.trim() ?? "";
+		const line =
+			act.responseText
+				.split("\n")
+				.find((l) => l.trim())
+				?.trim() ?? "";
 		return line.length > 40 ? line.slice(0, 40) + "…" : line;
 	}
 	return "thinking…";
@@ -77,38 +81,50 @@ export function renderAgentsPane(snapshot: RunUiSnapshot | undefined, options: R
 	if (!snapshot) return ["(snapshot unavailable)"];
 	if (!snapshot.agents.length) return ["(no agents)"];
 	// Filter live agents by workspaceId for session isolation
-	const allLive = options.workspaceId
-		? listLiveAgentsByWorkspace(options.workspaceId)
-		: listLiveAgents();
-	const liveForRun = allLive.filter(h => h.runId === snapshot.runId);
+	const allLive = options.workspaceId ? listLiveAgentsByWorkspace(options.workspaceId) : listLiveAgents();
+	const liveForRun = allLive.filter((h) => h.runId === snapshot.runId);
 	const { completed, total } = snapshot.progress;
 
 	const lines: string[] = [];
 
-	const realAgents = snapshot.agents.filter(a => isRealAgent(a, liveForRun.find(h => h.taskId === a.taskId)));
+	const realAgents = snapshot.agents.filter((a) =>
+		isRealAgent(
+			a,
+			liveForRun.find((h) => h.taskId === a.taskId),
+		),
+	);
 	const lineCount = Math.min(realAgents.length, 12);
-	const label = realAgents.length !== snapshot.agents.length
-		? `${realAgents.length} real agents (${snapshot.agents.length} total)`
-		: `${realAgents.length} agents`;
+	const label =
+		realAgents.length !== snapshot.agents.length
+			? `${realAgents.length} real agents (${snapshot.agents.length} total)`
+			: `${realAgents.length} agents`;
 
 	lines.push(`${completed}/${total} tasks · ${label}`);
 
 	for (const agent of realAgents.slice(0, 12)) {
-		const liveHandle = liveForRun.find(h => h.taskId === agent.taskId);
-		const icon = iconForStatus(agent.status, { runningGlyph: spinnerFrame(agent.taskId) });
+		const liveHandle = liveForRun.find((h) => h.taskId === agent.taskId);
+		const icon = iconForStatus(agent.status, {
+			runningGlyph: spinnerFrame(agent.taskId),
+		});
 		const role = `${agent.role}`;
 
 		// Compact activity line
-		const activity = liveHandle ? describeActivity(liveHandle)
-			: agent.progress?.currentTool ? `${TOOL_LABELS[agent.progress.currentTool] ?? agent.progress.currentTool}…`
-			: agent.status === "running" ? "thinking…"
-			: agent.status === "queued" ? "queued"
-			: agent.status === "failed" ? (agent.error ?? "failed")
-			: "done";
+		const activity = liveHandle
+			? describeActivity(liveHandle)
+			: agent.progress?.currentTool
+				? `${TOOL_LABELS[agent.progress.currentTool] ?? agent.progress.currentTool}…`
+				: agent.status === "running"
+					? "thinking…"
+					: agent.status === "queued"
+						? "queued"
+						: agent.status === "failed"
+							? (agent.error ?? "failed")
+							: "done";
 
 		// Stats: tokens + cost + duration
 		const stats: string[] = [];
-		const tokenTotal = (agent.usage?.input ?? 0) + (agent.usage?.output ?? 0) + (agent.usage?.cacheRead ?? 0) + (agent.usage?.cacheWrite ?? 0);
+		const tokenTotal =
+			(agent.usage?.input ?? 0) + (agent.usage?.output ?? 0) + (agent.usage?.cacheRead ?? 0) + (agent.usage?.cacheWrite ?? 0);
 		if (tokenTotal > 0) {
 			const tok = tokenTotal >= 1000 ? `${(tokenTotal / 1000).toFixed(1)}k` : `${tokenTotal}`;
 			stats.push(alignMetric(tok, TOKENS_METRIC_WIDTH));

package/src/ui/dashboard-panes/cancellation-pane.ts

@@ -63,4 +63,4 @@ export function summarizeTerminalReason(
 	if (failed?.error) return failed.error;
 	if (manifest.policyDecisions?.length) return manifest.policyDecisions[0]?.message;
 	return undefined;
-}
+}

package/src/ui/dashboard-panes/capability-pane.ts

@@ -1,6 +1,6 @@
-import { buildCapabilityInventory } from "../../runtime/capability-inventory.ts";
 import type { PiTeamsConfig } from "../../config/config.ts";
 import type { CapabilityItem } from "../../runtime/capability-inventory.ts";
+import { buildCapabilityInventory } from "../../runtime/capability-inventory.ts";
 
 export interface CapabilityPaneOptions {
 	config?: PiTeamsConfig;
@@ -9,30 +9,47 @@ export interface CapabilityPaneOptions {
 
 function kindIcon(kind: string): string {
 	switch (kind) {
-		case "team": return "👥";
-		case "workflow": return "📋";
-		case "agent": return "🤖";
-		case "skill": return "🔧";
-		case "tool": return "🛠";
-		case "runtime": return "⚙";
-		default: return "•";
+		case "team":
+			return "👥";
+		case "workflow":
+			return "📋";
+		case "agent":
+			return "🤖";
+		case "skill":
+			return "🔧";
+		case "tool":
+			return "🛠";
+		case "runtime":
+			return "⚙";
+		default:
+			return "•";
 	}
 }
 
 function stateLabel(state: string): string {
 	switch (state) {
-		case "active": return "";
-		case "disabled": return " [DISABLED]";
-		case "shadowed": return " [SHADOWED]";
-		case "missing": return " [MISSING]";
-		default: return "";
+		case "active":
+			return "";
+		case "disabled":
+			return " [DISABLED]";
+		case "shadowed":
+			return " [SHADOWED]";
+		case "missing":
+			return " [MISSING]";
+		default:
+			return "";
 	}
 }
 
 export function renderCapabilityPane(cwd: string, opts: CapabilityPaneOptions = {}): string[] {
 	const inventory = buildCapabilityInventory(cwd, opts.config);
 	const filtered = opts.filter
-		? inventory.filter((item) => item.kind.includes(opts.filter!.toLowerCase()) || item.name.toLowerCase().includes(opts.filter!.toLowerCase()) || item.id.toLowerCase().includes(opts.filter!.toLowerCase()))
+		? inventory.filter(
+				(item) =>
+					item.kind.includes(opts.filter!.toLowerCase()) ||
+					item.name.toLowerCase().includes(opts.filter!.toLowerCase()) ||
+					item.id.toLowerCase().includes(opts.filter!.toLowerCase()),
+			)
 		: inventory;
 
 	if (filtered.length === 0) return ["Capability pane: no items found"];
@@ -57,4 +74,4 @@ export function renderCapabilityPane(cwd: string, opts: CapabilityPaneOptions =
 	const disabled = filtered.filter((i) => i.state === "disabled").length;
 	if (disabled > 0) lines.push(`  Disabled: ${disabled}`);
 	return lines;
-}
+}

package/src/ui/dashboard-panes/health-pane.ts

@@ -25,6 +25,7 @@ export function renderHealthPane(snapshot: RunUiSnapshot | undefined, opts: Heal
 	if ((summary.dead > 0 || summary.stale > 0) && foreground) hints.push("K kill stale");
 	hints.push("D diagnostic export");
 	lines.push(`Actions: ${hints.join(" · ")}`);
-	if (!foreground && (summary.dead > 0 || summary.missing > 0 || summary.stale > 0)) lines.push("Async run: R/K disabled — inspect process manually or use /team-api.");
+	if (!foreground && (summary.dead > 0 || summary.missing > 0 || summary.stale > 0))
+		lines.push("Async run: R/K disabled — inspect process manually or use /team-api.");
 	return lines;
 }

package/src/ui/dashboard-panes/metrics-pane.ts

@@ -27,7 +27,10 @@ export function renderMetricsPane(_snapshot: RunUiSnapshot | undefined, opts: Me
 			lines.push(`${snapshot.name}: empty`);
 			continue;
 		}
-		if (isHistogramPoint(first)) lines.push(`${snapshot.name}${labelsText(first.labels)} count=${first.count} p95=${Number.isFinite(first.quantiles.p95) ? Math.round(first.quantiles.p95) : "n/a"}`);
+		if (isHistogramPoint(first))
+			lines.push(
+				`${snapshot.name}${labelsText(first.labels)} count=${first.count} p95=${Number.isFinite(first.quantiles.p95) ? Math.round(first.quantiles.p95) : "n/a"}`,
+			);
 		else lines.push(`${snapshot.name}${labelsText(first.labels)} ${first.value}`);
 	}
 	return lines;

package/src/ui/dashboard-panes/progress-pane.ts

@@ -1,21 +1,24 @@
-import type { RunUiSnapshot } from "../snapshot-types.ts";
 import { computePhaseProgress, formatPhaseProgressLine } from "../../runtime/phase-progress.ts";
 import { renderDwfPhaseLines } from "../dwf-phase-display.ts";
+import type { RunUiSnapshot } from "../snapshot-types.ts";
 
 export function renderProgressPane(snapshot: RunUiSnapshot | undefined): string[] {
 	if (!snapshot) return ["Progress pane: snapshot unavailable"];
 	const progress = snapshot.progress;
 	const groupJoins = snapshot.groupJoins ?? [];
-	const groupJoinLines = groupJoins.length ? groupJoins.map((item) => `group join ${item.partial ? "partial" : "completed"}: ${item.requestId} ack=${item.ack}`) : ["group joins: none"];
+	const groupJoinLines = groupJoins.length
+		? groupJoins.map((item) => `group join ${item.partial ? "partial" : "completed"}: ${item.requestId} ack=${item.ack}`)
+		: ["group joins: none"];
 	const cancellationLine = snapshot.cancellationReason ? [`cancelled: reason=${snapshot.cancellationReason}`] : [];
 	const runProgress = computePhaseProgress(snapshot.tasks);
-	const phaseLines = runProgress.phases.length > 0
-		? runProgress.phases.map((p) => {
-			const done = p.completed + p.failed;
-			const status = p.running > 0 ? "running" : p.queued > 0 ? "queued" : done >= p.total ? "done" : "waiting";
-			return `  Phase ${p.index + 1} ${p.phase}: ${p.percentage}% (${done}/${p.total}) [${status}]`;
-		})
-		: [];
+	const phaseLines =
+		runProgress.phases.length > 0
+			? runProgress.phases.map((p) => {
+					const done = p.completed + p.failed;
+					const status = p.running > 0 ? "running" : p.queued > 0 ? "queued" : done >= p.total ? "done" : "waiting";
+					return `  Phase ${p.index + 1} ${p.phase}: ${p.percentage}% (${done}/${p.total}) [${status}]`;
+				})
+			: [];
 	const phaseHeader = phaseLines.length > 0 ? [formatPhaseProgressLine(runProgress), ...phaseLines] : [];
 	// DWF logical phases (round-15 P1-4): derived from dwf.phase_* events.
 	// Null/absent for non-DWF runs → zero visible change.

package/src/ui/heartbeat-aggregator.ts

@@ -1,6 +1,6 @@
-import type { TeamTaskState } from "../state/types.ts";
-import { classifyHeartbeat, heartbeatAgeMs } from "../runtime/heartbeat-gradient.ts";
 import type { MetricRegistry } from "../observability/metric-registry.ts";
+import { classifyHeartbeat, heartbeatAgeMs } from "../runtime/heartbeat-gradient.ts";
+import type { TeamTaskState } from "../state/types.ts";
 import type { RunUiSnapshot } from "./snapshot-types.ts";
 
 export interface HeartbeatSummary {
@@ -35,7 +35,16 @@ export function summarizeHeartbeats(snapshot: RunUiSnapshot, opts: HeartbeatSumm
 	const staleMs = opts.staleMs ?? 60_000;
 	const deadMs = opts.deadMs ?? 5 * 60_000;
 	const current = nowMs(opts.now);
-	const summary: HeartbeatSummary = { runId: snapshot.runId, totalTasks: snapshot.tasks.length, healthy: 0, stale: 0, dead: 0, missing: 0, worstStaleMs: 0, gradient: { healthy: 0, warn: 0, stale: 0, dead: 0 } };
+	const summary: HeartbeatSummary = {
+		runId: snapshot.runId,
+		totalTasks: snapshot.tasks.length,
+		healthy: 0,
+		stale: 0,
+		dead: 0,
+		missing: 0,
+		worstStaleMs: 0,
+		gradient: { healthy: 0, warn: 0, stale: 0, dead: 0 },
+	};
 	for (const task of snapshot.tasks) {
 		if (!isActiveTask(task)) continue;
 		const heartbeat = task.heartbeat;
@@ -53,7 +62,9 @@ export function summarizeHeartbeats(snapshot: RunUiSnapshot, opts: HeartbeatSumm
 		summary.worstStaleMs = Math.max(summary.worstStaleMs, age);
 		const level = classifyHeartbeat(heartbeat, { warnMs: Math.max(1, Math.floor(staleMs / 2)), staleMs, deadMs }, current);
 		summary.gradient[level] += 1;
-		opts.registry?.gauge("crew.heartbeat.staleness_ms", "Heartbeat elapsed since last seen, milliseconds").set({ runId: snapshot.runId, taskId: task.id }, age);
+		opts.registry
+			?.gauge("crew.heartbeat.staleness_ms", "Heartbeat elapsed since last seen, milliseconds")
+			.set({ runId: snapshot.runId, taskId: task.id }, age);
 		opts.registry?.counter("crew.heartbeat.level_total", "Heartbeat classifications by level").inc({ runId: snapshot.runId, level });
 		if (level === "dead") summary.dead += 1;
 		else if (level === "stale") summary.stale += 1;

package/src/ui/keybinding-map.ts

@@ -40,9 +40,23 @@ export const DASHBOARD_KEYS = {
 		reload: ["r"],
 		progressToggle: ["p"],
 	},
-	pane: { agents: ["1"], progress: ["2"], mailbox: ["3"], output: ["4"], health: ["5"], metrics: ["6"] },
+	pane: {
+		agents: ["1"],
+		progress: ["2"],
+		mailbox: ["3"],
+		output: ["4"],
+		health: ["5"],
+		metrics: ["6"],
+	},
 	navigation: { up: ["k", "\u001b[A"], down: ["j", "\u001b[B"] },
-	mailbox: { ack: ["A"], nudge: ["N"], compose: ["C"], preview: ["P"], ackAll: ["X"], openDetail: ["\r", "\n"] },
+	mailbox: {
+		ack: ["A"],
+		nudge: ["N"],
+		compose: ["C"],
+		preview: ["P"],
+		ackAll: ["X"],
+		openDetail: ["\r", "\n"],
+	},
 	health: { recovery: ["R"], killStale: ["K"], diagnosticExport: ["D"] },
 	notification: { dismissAll: ["H"] },
 } as const;
@@ -115,11 +129,30 @@ export type DashboardKeyAction =
 const BINDINGS: readonly KeyBinding[] = [
 	{ keys: DASHBOARD_KEYS.close, action: "close" },
 	{ keys: DASHBOARD_KEYS.help, action: "help" },
-	{ keys: DASHBOARD_KEYS.mailbox.openDetail, action: "mailbox-detail", pane: "mailbox" },
-	{ keys: DASHBOARD_KEYS.health.recovery, action: "health-recovery", pane: "health" },
-	{ keys: DASHBOARD_KEYS.health.killStale, action: "health-kill-stale", pane: "health" },
-	{ keys: DASHBOARD_KEYS.health.diagnosticExport, action: "health-diagnostic-export", pane: "health" },
-	{ keys: DASHBOARD_KEYS.notification.dismissAll, action: "notifications-dismiss" },
+	{
+		keys: DASHBOARD_KEYS.mailbox.openDetail,
+		action: "mailbox-detail",
+		pane: "mailbox",
+	},
+	{
+		keys: DASHBOARD_KEYS.health.recovery,
+		action: "health-recovery",
+		pane: "health",
+	},
+	{
+		keys: DASHBOARD_KEYS.health.killStale,
+		action: "health-kill-stale",
+		pane: "health",
+	},
+	{
+		keys: DASHBOARD_KEYS.health.diagnosticExport,
+		action: "health-diagnostic-export",
+		pane: "health",
+	},
+	{
+		keys: DASHBOARD_KEYS.notification.dismissAll,
+		action: "notifications-dismiss",
+	},
 	{ keys: DASHBOARD_KEYS.select, action: "select" },
 	{ keys: DASHBOARD_KEYS.root.summary, action: "summary" },
 	{ keys: DASHBOARD_KEYS.root.artifacts, action: "artifacts" },

package/src/ui/live-conversation-overlay.ts

@@ -5,10 +5,10 @@
  * Falls back to polling LiveAgentHandle.activity when subscribe is unavailable.
  */
 import type { LiveAgentHandle } from "../runtime/live-agent-manager.ts";
-import { iconForStatus } from "./status-colors.ts";
+import { pad, truncate } from "../utils/visual.ts";
 import { spinnerFrame } from "./spinner.ts";
+import { iconForStatus } from "./status-colors.ts";
 import type { CrewTheme } from "./theme-adapter.ts";
-import { pad, truncate } from "../utils/visual.ts";
 
 const CHROME_LINES = 6;
 const MIN_VIEWPORT = 3;
@@ -31,12 +31,7 @@ export class LiveConversationOverlay {
 	private handle: LiveAgentHandle;
 	private theme: CrewTheme;
 
-	constructor(
-		handle: LiveAgentHandle,
-		theme: CrewTheme,
-		columns = 80,
-		rows = 24,
-	) {
+	constructor(handle: LiveAgentHandle, theme: CrewTheme, columns = 80, rows = 24) {
 		this.handle = handle;
 		this.theme = theme;
 		this.columns = columns;
@@ -54,16 +49,26 @@ export class LiveConversationOverlay {
 						if (this.autoScroll) this.scrollOffset = Math.max(0, this.cachedLines.length - this.viewportHeight());
 					}
 				});
-			} catch { /* ignore */ }
+			} catch {
+				/* ignore */
+			}
 		}
 		// Also poll for summary updates
 		this.pollTimer = setInterval(() => {
 			if (this.closed) return;
 			this.frame++;
-			try { this.refreshSummary(); } catch { /* ignore */ }
+			try {
+				this.refreshSummary();
+			} catch {
+				/* ignore */
+			}
 		}, 200);
 		this.pollTimer.unref();
-		try { this.refreshSummary(); } catch { /* ignore */ }
+		try {
+			this.refreshSummary();
+		} catch {
+			/* ignore */
+		}
 	}
 
 	private pushLine(line: string): void {
@@ -120,8 +125,7 @@ export class LiveConversationOverlay {
 		if (w < 6) return [];
 		const th = this.theme;
 		const innerW = w - 4;
-		const row = (content: string) =>
-			th.fg("border", "│") + " " + pad(truncate(content, innerW), innerW) + " " + th.fg("border", "│");
+		const row = (content: string) => th.fg("border", "│") + " " + pad(truncate(content, innerW), innerW) + " " + th.fg("border", "│");
 		const hrTop = th.fg("border", `╭${"─".repeat(w - 2)}╮`);
 		const hrBot = th.fg("border", `╰${"─".repeat(w - 2)}╯`);
 		const hrMid = row(th.fg("dim", "─".repeat(innerW)));
@@ -130,9 +134,10 @@ export class LiveConversationOverlay {
 		lines.push(hrTop);
 
 		// Header
-		const statusIcon = this.handle.status === "running"
-			? th.fg("accent", spinnerFrame(this.handle.taskId ?? this.handle.agentId))
-			: iconForStatus(this.handle.status);
+		const statusIcon =
+			this.handle.status === "running"
+				? th.fg("accent", spinnerFrame(this.handle.taskId ?? this.handle.agentId))
+				: iconForStatus(this.handle.status);
 		const name = this.handle.agent ?? this.handle.taskId;
 		const act = this.handle.activity;
 		const elapsed = `${(this.safeElapsedMs(act) / 1000).toFixed(1)}s`;
@@ -149,13 +154,19 @@ export class LiveConversationOverlay {
 				const color = ctxPct >= 85 ? "error" : ctxPct >= 70 ? "warning" : "dim";
 				headerParts.push(th.fg(color, `${Math.round(ctxPct)}% ctx`));
 			}
-		} catch { /* ignore */ }
+		} catch {
+			/* ignore */
+		}
 		if (act.compactionCount > 0) headerParts.push(th.fg("dim", `↻${act.compactionCount}`));
 		// Model name
 		if (this.handle.modelName) headerParts.push(th.fg("muted", this.handle.modelName));
 
 		const desc = this.handle.description ?? this.handle.role ?? "";
-		lines.push(row(`${statusIcon} ${th.fg("accent", name)}  ${th.fg("muted", desc)} ${th.fg("dim", "·")} ${th.fg("dim", headerParts.join(" · "))}`));
+		lines.push(
+			row(
+				`${statusIcon} ${th.fg("accent", name)}  ${th.fg("muted", desc)} ${th.fg("dim", "·")} ${th.fg("dim", headerParts.join(" · "))}`,
+			),
+		);
 		lines.push(hrMid);
 
 		// Content
@@ -167,7 +178,9 @@ export class LiveConversationOverlay {
 
 		// Footer
 		lines.push(hrMid);
-		const footerText = this.autoScroll ? "auto-scroll · esc/q close" : `line ${this.scrollOffset + 1}/${this.cachedLines.length} · ↑/k ↓/j G/g · esc/q close`;
+		const footerText = this.autoScroll
+			? "auto-scroll · esc/q close"
+			: `line ${this.scrollOffset + 1}/${this.cachedLines.length} · ↑/k ↓/j G/g · esc/q close`;
 		lines.push(row(th.fg("dim", footerText)));
 		lines.push(hrBot);
 		return lines;
@@ -178,7 +191,10 @@ export class LiveConversationOverlay {
 		this.closed = true;
 		this.unsubscribe?.();
 		this.unsubscribe = undefined;
-		if (this.pollTimer) { clearInterval(this.pollTimer); this.pollTimer = undefined; }
+		if (this.pollTimer) {
+			clearInterval(this.pollTimer);
+			this.pollTimer = undefined;
+		}
 	}
 
 	dispose(): void {

package/src/ui/live-duration.ts

@@ -43,10 +43,7 @@ export function computeLiveDurationMs(activity: LiveActivity, nowMs: number = Da
 	const completedMs = rawCompleted > 0 ? toMs(rawCompleted) : 0;
 	// A valid start is positive, not more than 1 minute in the future, and not
 	// more than ~1000 years in the past (guards against 0 / garbage / clock skew).
-	const isValidStarted =
-		startedMs > 0 &&
-		startedMs < nowMs + 60_000 &&
-		startedMs > nowMs - 31_556_926_000_000;
+	const isValidStarted = startedMs > 0 && startedMs < nowMs + 60_000 && startedMs > nowMs - 31_556_926_000_000;
 	const end = completedMs > 0 && completedMs < nowMs + 60_000 ? completedMs : nowMs;
 	const ms = end - (isValidStarted ? startedMs : nowMs);
 	return Number.isFinite(ms) && ms >= 0 ? ms : 0;