pi-crew 0.2.3 → 0.2.5

package/src/ui/heartbeat-aggregator.ts

@@ -1,63 +1,63 @@
-import type { TeamTaskState } from "../state/types.ts";
-import { classifyHeartbeat, heartbeatAgeMs } from "../runtime/heartbeat-gradient.ts";
-import type { MetricRegistry } from "../observability/metric-registry.ts";
-import type { RunUiSnapshot } from "./snapshot-types.ts";
-
-export interface HeartbeatSummary {
-	runId: string;
-	totalTasks: number;
-	healthy: number;
-	stale: number;
-	dead: number;
-	missing: number;
-	worstStaleMs: number;
-	gradient: { healthy: number; warn: number; stale: number; dead: number };
-}
-
-export interface HeartbeatSummaryOptions {
-	staleMs?: number;
-	deadMs?: number;
-	now?: number | Date;
-	registry?: MetricRegistry;
-}
-
-function nowMs(now: number | Date | undefined): number {
-	if (typeof now === "number") return now;
-	if (now instanceof Date) return now.getTime();
-	return Date.now();
-}
-
-function isActiveTask(task: TeamTaskState): boolean {
-	return task.status === "running";
-}
-
-export function summarizeHeartbeats(snapshot: RunUiSnapshot, opts: HeartbeatSummaryOptions = {}): HeartbeatSummary {
-	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 } };
-	for (const task of snapshot.tasks) {
-		if (!isActiveTask(task)) continue;
-		const heartbeat = task.heartbeat;
-		if (!heartbeat) {
-			summary.missing += 1;
-			summary.gradient.dead += 1;
-			continue;
-		}
-		const age = heartbeatAgeMs(heartbeat, current);
-		if (!Number.isFinite(age)) {
-			summary.missing += 1;
-			summary.gradient.dead += 1;
-			continue;
-		}
-		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?.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;
-		else summary.healthy += 1;
-	}
-	return summary;
-}
+import type { TeamTaskState } from "../state/types.ts";
+import { classifyHeartbeat, heartbeatAgeMs } from "../runtime/heartbeat-gradient.ts";
+import type { MetricRegistry } from "../observability/metric-registry.ts";
+import type { RunUiSnapshot } from "./snapshot-types.ts";
+
+export interface HeartbeatSummary {
+	runId: string;
+	totalTasks: number;
+	healthy: number;
+	stale: number;
+	dead: number;
+	missing: number;
+	worstStaleMs: number;
+	gradient: { healthy: number; warn: number; stale: number; dead: number };
+}
+
+export interface HeartbeatSummaryOptions {
+	staleMs?: number;
+	deadMs?: number;
+	now?: number | Date;
+	registry?: MetricRegistry;
+}
+
+function nowMs(now: number | Date | undefined): number {
+	if (typeof now === "number") return now;
+	if (now instanceof Date) return now.getTime();
+	return Date.now();
+}
+
+function isActiveTask(task: TeamTaskState): boolean {
+	return task.status === "running";
+}
+
+export function summarizeHeartbeats(snapshot: RunUiSnapshot, opts: HeartbeatSummaryOptions = {}): HeartbeatSummary {
+	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 } };
+	for (const task of snapshot.tasks) {
+		if (!isActiveTask(task)) continue;
+		const heartbeat = task.heartbeat;
+		if (!heartbeat) {
+			summary.missing += 1;
+			summary.gradient.dead += 1;
+			continue;
+		}
+		const age = heartbeatAgeMs(heartbeat, current);
+		if (!Number.isFinite(age)) {
+			summary.missing += 1;
+			summary.gradient.dead += 1;
+			continue;
+		}
+		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?.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;
+		else summary.healthy += 1;
+	}
+	return summary;
+}

package/src/ui/keybinding-map.ts

@@ -1,94 +1,97 @@
-export const DASHBOARD_KEYS = {
-	close: ["q", "\u001b"],
-	select: ["\r", "\n", "s"],
-	root: {
-		summary: ["u"],
-		artifacts: ["a"],
-		api: ["i"],
-		agents: ["d"],
-		mailbox: ["m"],
-		events: ["e"],
-		output: ["o"],
-		transcript: ["v"],
-		reload: ["r"],
-		progressToggle: ["p"],
-	},
-	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"] },
-	health: { recovery: ["R"], killStale: ["K"], diagnosticExport: ["D"] },
-	notification: { dismissAll: ["H"] },
-} as const;
-
-export const KEY_RESERVED = new Set<string>([
-	...DASHBOARD_KEYS.close,
-	...DASHBOARD_KEYS.select,
-	...Object.values(DASHBOARD_KEYS.root).flat(),
-	...Object.values(DASHBOARD_KEYS.pane).flat(),
-	...Object.values(DASHBOARD_KEYS.navigation).flat(),
-	...Object.values(DASHBOARD_KEYS.mailbox).flat(),
-	...Object.values(DASHBOARD_KEYS.health).flat(),
-	...Object.values(DASHBOARD_KEYS.notification).flat(),
-]);
-
-function includes(values: readonly string[], data: string): boolean {
-	return values.includes(data);
-}
-
-export type DashboardKeyAction =
-	| "close"
-	| "select"
-	| "summary"
-	| "artifacts"
-	| "api"
-	| "agents"
-	| "mailbox"
-	| "events"
-	| "output"
-	| "transcript"
-	| "reload"
-	| "progressToggle"
-	| "pane-agents"
-	| "pane-progress"
-	| "pane-mailbox"
-	| "pane-output"
-	| "pane-health"
-	| "pane-metrics"
-	| "up"
-	| "down"
-	| "mailbox-detail"
-	| "health-recovery"
-	| "health-kill-stale"
-	| "health-diagnostic-export"
-	| "notifications-dismiss";
-
-export function dashboardActionForKey(data: string, activePane?: "agents" | "progress" | "mailbox" | "output" | "health" | "metrics"): DashboardKeyAction | undefined {
-	if (includes(DASHBOARD_KEYS.close, data)) return "close";
-	if (activePane === "mailbox" && includes(DASHBOARD_KEYS.mailbox.openDetail, data)) return "mailbox-detail";
-	if (activePane === "health") {
-		if (includes(DASHBOARD_KEYS.health.recovery, data)) return "health-recovery";
-		if (includes(DASHBOARD_KEYS.health.killStale, data)) return "health-kill-stale";
-		if (includes(DASHBOARD_KEYS.health.diagnosticExport, data)) return "health-diagnostic-export";
-	}
-	if (includes(DASHBOARD_KEYS.notification.dismissAll, data)) return "notifications-dismiss";
-	if (includes(DASHBOARD_KEYS.select, data)) return "select";
-	if (includes(DASHBOARD_KEYS.root.summary, data)) return "summary";
-	if (includes(DASHBOARD_KEYS.root.artifacts, data)) return "artifacts";
-	if (includes(DASHBOARD_KEYS.root.api, data)) return "api";
-	if (includes(DASHBOARD_KEYS.root.agents, data)) return "agents";
-	if (includes(DASHBOARD_KEYS.root.mailbox, data)) return "mailbox";
-	if (includes(DASHBOARD_KEYS.root.events, data)) return "events";
-	if (includes(DASHBOARD_KEYS.root.output, data)) return "output";
-	if (includes(DASHBOARD_KEYS.root.transcript, data)) return "transcript";
-	if (includes(DASHBOARD_KEYS.root.reload, data)) return "reload";
-	if (includes(DASHBOARD_KEYS.root.progressToggle, data)) return "progressToggle";
-	if (includes(DASHBOARD_KEYS.pane.agents, data)) return "pane-agents";
-	if (includes(DASHBOARD_KEYS.pane.progress, data)) return "pane-progress";
-	if (includes(DASHBOARD_KEYS.pane.mailbox, data)) return "pane-mailbox";
-	if (includes(DASHBOARD_KEYS.pane.output, data)) return "pane-output";
-	if (includes(DASHBOARD_KEYS.pane.health, data)) return "pane-health";
-	if (includes(DASHBOARD_KEYS.pane.metrics, data)) return "pane-metrics";
-	if (includes(DASHBOARD_KEYS.navigation.up, data)) return "up";
-	if (includes(DASHBOARD_KEYS.navigation.down, data)) return "down";
-	return undefined;
-}
+export const DASHBOARD_KEYS = {
+	close: ["q", "\u001b"],
+	select: ["\r", "\n", "s"],
+	root: {
+		summary: ["u"],
+		artifacts: ["a"],
+		api: ["i"],
+		agents: ["d"],
+		mailbox: ["m"],
+		events: ["e"],
+		output: ["o"],
+		transcript: ["v"],
+		liveConversation: ["V"],
+		reload: ["r"],
+		progressToggle: ["p"],
+	},
+	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"] },
+	health: { recovery: ["R"], killStale: ["K"], diagnosticExport: ["D"] },
+	notification: { dismissAll: ["H"] },
+} as const;
+
+export const KEY_RESERVED = new Set<string>([
+	...DASHBOARD_KEYS.close,
+	...DASHBOARD_KEYS.select,
+	...Object.values(DASHBOARD_KEYS.root).flat(),
+	...Object.values(DASHBOARD_KEYS.pane).flat(),
+	...Object.values(DASHBOARD_KEYS.navigation).flat(),
+	...Object.values(DASHBOARD_KEYS.mailbox).flat(),
+	...Object.values(DASHBOARD_KEYS.health).flat(),
+	...Object.values(DASHBOARD_KEYS.notification).flat(),
+]);
+
+function includes(values: readonly string[], data: string): boolean {
+	return values.includes(data);
+}
+
+export type DashboardKeyAction =
+	| "close"
+	| "select"
+	| "summary"
+	| "artifacts"
+	| "api"
+	| "agents"
+	| "mailbox"
+	| "events"
+	| "output"
+	| "transcript"
+	| "live-conversation"
+	| "reload"
+	| "progressToggle"
+	| "pane-agents"
+	| "pane-progress"
+	| "pane-mailbox"
+	| "pane-output"
+	| "pane-health"
+	| "pane-metrics"
+	| "up"
+	| "down"
+	| "mailbox-detail"
+	| "health-recovery"
+	| "health-kill-stale"
+	| "health-diagnostic-export"
+	| "notifications-dismiss";
+
+export function dashboardActionForKey(data: string, activePane?: "agents" | "progress" | "mailbox" | "output" | "health" | "metrics"): DashboardKeyAction | undefined {
+	if (includes(DASHBOARD_KEYS.close, data)) return "close";
+	if (activePane === "mailbox" && includes(DASHBOARD_KEYS.mailbox.openDetail, data)) return "mailbox-detail";
+	if (activePane === "health") {
+		if (includes(DASHBOARD_KEYS.health.recovery, data)) return "health-recovery";
+		if (includes(DASHBOARD_KEYS.health.killStale, data)) return "health-kill-stale";
+		if (includes(DASHBOARD_KEYS.health.diagnosticExport, data)) return "health-diagnostic-export";
+	}
+	if (includes(DASHBOARD_KEYS.notification.dismissAll, data)) return "notifications-dismiss";
+	if (includes(DASHBOARD_KEYS.select, data)) return "select";
+	if (includes(DASHBOARD_KEYS.root.summary, data)) return "summary";
+	if (includes(DASHBOARD_KEYS.root.artifacts, data)) return "artifacts";
+	if (includes(DASHBOARD_KEYS.root.api, data)) return "api";
+	if (includes(DASHBOARD_KEYS.root.agents, data)) return "agents";
+	if (includes(DASHBOARD_KEYS.root.mailbox, data)) return "mailbox";
+	if (includes(DASHBOARD_KEYS.root.events, data)) return "events";
+	if (includes(DASHBOARD_KEYS.root.output, data)) return "output";
+	if (includes(DASHBOARD_KEYS.root.transcript, data)) return "transcript";
+	if (includes(DASHBOARD_KEYS.root.liveConversation, data)) return "live-conversation";
+	if (includes(DASHBOARD_KEYS.root.reload, data)) return "reload";
+	if (includes(DASHBOARD_KEYS.root.progressToggle, data)) return "progressToggle";
+	if (includes(DASHBOARD_KEYS.pane.agents, data)) return "pane-agents";
+	if (includes(DASHBOARD_KEYS.pane.progress, data)) return "pane-progress";
+	if (includes(DASHBOARD_KEYS.pane.mailbox, data)) return "pane-mailbox";
+	if (includes(DASHBOARD_KEYS.pane.output, data)) return "pane-output";
+	if (includes(DASHBOARD_KEYS.pane.health, data)) return "pane-health";
+	if (includes(DASHBOARD_KEYS.pane.metrics, data)) return "pane-metrics";
+	if (includes(DASHBOARD_KEYS.navigation.up, data)) return "up";
+	if (includes(DASHBOARD_KEYS.navigation.down, data)) return "down";
+	return undefined;
+}

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

@@ -0,0 +1,152 @@
+/**
+ * live-conversation-overlay.ts — Live conversation overlay for viewing live-session agent output.
+ *
+ * R8: Subscribes to session events for real-time streaming updates.
+ * 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 { spinnerFrame } from "./spinner.ts";
+import type { CrewTheme } from "./theme-adapter.ts";
+
+const CHROME_LINES = 6;
+const MIN_VIEWPORT = 3;
+
+export class LiveConversationOverlay {
+	private scrollOffset = 0;
+	private autoScroll = true;
+	private closed = false;
+	private frame = 0;
+	private pollTimer: ReturnType<typeof setInterval> | undefined;
+	cachedLines: string[] = [];
+	private columns: number;
+	private rows: number;
+	private unsubscribe: (() => void) | undefined;
+
+	private handle: LiveAgentHandle;
+	private theme: CrewTheme;
+
+	constructor(
+		handle: LiveAgentHandle,
+		theme: CrewTheme,
+		columns = 80,
+		rows = 24,
+	) {
+		this.handle = handle;
+		this.theme = theme;
+		this.columns = columns;
+		this.rows = rows;
+		// R8: Subscribe to real session events if available
+		const session = handle.session as Record<string, unknown>;
+		if (typeof session.subscribe === "function") {
+			try {
+				this.unsubscribe = (session.subscribe as (cb: (event: unknown) => void) => () => void)((event) => {
+					if (this.closed) return;
+					const obj = event as Record<string, unknown>;
+					const text = typeof obj.text === "string" ? obj.text : typeof obj.content === "string" ? obj.content : "";
+					if (text.trim()) {
+						this.cachedLines.push(text);
+						if (this.autoScroll) this.scrollOffset = Math.max(0, this.cachedLines.length - this.viewportHeight());
+					}
+				});
+			} catch { /* ignore */ }
+		}
+		// Also poll for summary updates
+		this.pollTimer = setInterval(() => {
+			if (this.closed) return;
+			this.frame++;
+			try { this.refreshSummary(); } catch { /* ignore */ }
+		}, 200);
+		this.pollTimer.unref();
+		try { this.refreshSummary(); } catch { /* ignore */ }
+	}
+
+	private static readonly SUMMARY_PREFIX = "\u200B"; // zero-width space as summary sentinel
+
+	private refreshSummary(): void {
+		const act = this.handle.activity;
+		const summary = `${LiveConversationOverlay.SUMMARY_PREFIX}[${act.turnCount} turns · ${act.toolUses} tools · ${((act.completedAtMs ?? Date.now()) - act.startedAtMs) / 1000}s]`;
+		const lastLine = this.cachedLines[this.cachedLines.length - 1];
+		if (lastLine?.startsWith(LiveConversationOverlay.SUMMARY_PREFIX)) {
+			this.cachedLines[this.cachedLines.length - 1] = summary;
+		} else {
+			this.cachedLines.push(summary);
+		}
+		if (this.autoScroll) this.scrollOffset = Math.max(0, this.cachedLines.length - this.viewportHeight());
+	}
+
+	private viewportHeight(): number {
+		return Math.max(MIN_VIEWPORT, this.rows - CHROME_LINES);
+	}
+
+	render(width?: number): string[] {
+		const w = width ?? this.columns;
+		if (w < 6) return [];
+		const th = this.theme;
+		const innerW = w - 4;
+		const pad = (s: string, len: number) => s + " ".repeat(Math.max(0, len - s.length));
+		const row = (content: string) =>
+			th.fg("border", "│") + " " + pad(content.slice(0, 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)));
+
+		const lines: string[] = [];
+		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 name = this.handle.agent ?? this.handle.taskId;
+		const act = this.handle.activity;
+		const elapsed = `${((act.completedAtMs ?? Date.now()) - act.startedAtMs) / 1000}s`;
+		const headerParts: string[] = [];
+		if (act.maxTurns != null) headerParts.push(`turn ${act.turnCount}/${act.maxTurns}`);
+		else if (act.turnCount > 0) headerParts.push(`turn ${act.turnCount}`);
+		if (act.toolUses > 0) headerParts.push(`${act.toolUses} tools`);
+		headerParts.push(elapsed);
+
+		// Context % + compaction
+		try {
+			const ctxPct = this.handle.session.getSessionStats?.()?.contextUsage?.percent;
+			if (ctxPct != null) {
+				const color = ctxPct >= 85 ? "error" : ctxPct >= 70 ? "warning" : "dim";
+				headerParts.push(th.fg(color, `${Math.round(ctxPct)}% ctx`));
+			}
+		} 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(hrMid);
+
+		// Content
+		const vh = this.viewportHeight();
+		const visible = this.cachedLines.slice(this.scrollOffset, this.scrollOffset + vh);
+		for (const line of visible) {
+			lines.push(row(th.fg("dim", line)));
+		}
+
+		// 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`;
+		lines.push(row(th.fg("dim", footerText)));
+		lines.push(hrBot);
+		return lines;
+	}
+
+	close(): void {
+		if (this.closed) return;
+		this.closed = true;
+		this.unsubscribe?.();
+		this.unsubscribe = undefined;
+		if (this.pollTimer) { clearInterval(this.pollTimer); this.pollTimer = undefined; }
+	}
+
+	dispose(): void {
+		this.close();
+	}
+}