@bastani/atomic 0.9.16-alpha.1 → 0.9.16-alpha.3

package/dist/builtin/subagents/src/slash/slash-live-state.ts

@@ -1,259 +0,0 @@
-import type { Message } from "@bastani/pi-ai/compat";
-import type { AgentToolResult } from "@earendil-works/pi-agent-core";
-import type { SubagentParamsLike } from "../runs/foreground/subagent-executor.js";
-import { type Details, type SingleResult, SLASH_RESULT_TYPE, type Usage } from "../shared/types.js";
-import type { SlashSubagentResponse, SlashSubagentUpdate } from "./slash-bridge.js";
-
-export interface SlashMessageDetails {
-	requestId: string;
-	result: AgentToolResult<Details>;
-}
-
-interface SlashSnapshot {
-	result: AgentToolResult<Details>;
-	version: number;
-}
-
-export interface SlashSnapshotStore {
-	liveSnapshots: Map<string, SlashSnapshot>;
-	finalSnapshots: Map<string, SlashSnapshot>;
-	versionCounter: number;
-}
-
-const defaultStoreOwner = {};
-
-function getStoreRegistry(): WeakMap<object, SlashSnapshotStore> {
-	const key = "__piSubagentSlashSnapshotStores";
-	const globalStore = globalThis as Record<string, unknown>;
-	const existing = globalStore[key];
-	if (existing instanceof WeakMap) return existing as WeakMap<object, SlashSnapshotStore>;
-	const registry = new WeakMap<object, SlashSnapshotStore>();
-	globalStore[key] = registry;
-	return registry;
-}
-
-export function getSlashSnapshotStore(owner: object = defaultStoreOwner): SlashSnapshotStore {
-	const registry = getStoreRegistry();
-	const existing = registry.get(owner);
-	if (existing) return existing;
-	const store = { liveSnapshots: new Map(), finalSnapshots: new Map(), versionCounter: 1 };
-	registry.set(owner, store);
-	return store;
-}
-
-const EMPTY_MESSAGES: Message[] = [];
-const EMPTY_USAGE: Usage = {
-	input: 0,
-	output: 0,
-	cacheRead: 0,
-	cacheWrite: 0,
-	cost: 0,
-	turns: 0,
-};
-
-function nextVersion(store: SlashSnapshotStore): number {
-	return store.versionCounter++;
-}
-
-function cloneUsage(): Usage {
-	return { ...EMPTY_USAGE };
-}
-
-function createPlaceholderResult(
-	agent: string,
-	task: string,
-	status: "pending" | "running",
-	index?: number,
-): SingleResult {
-	return {
-		agent,
-		task,
-		status: "continued",
-		messages: EMPTY_MESSAGES,
-		usage: cloneUsage(),
-		progress: {
-			index: index ?? 0,
-			agent,
-			status,
-			task,
-			recentTools: [],
-			recentOutput: [],
-			toolCount: 0,
-			tokens: 0,
-			durationMs: 0,
-		},
-	};
-}
-
-function buildParallelInitialResult(params: SubagentParamsLike): AgentToolResult<Details> {
-	const tasks = params.tasks ?? [];
-	return {
-		content: [{ type: "text", text: tasks.map((task) => `${task.agent}: ${task.task}`).join("\n\n") }],
-		details: {
-			mode: "parallel",
-			...(params.context ? { context: params.context } : {}),
-			results: tasks.map((task, index) => createPlaceholderResult(task.agent, task.task, "running", index)),
-			progress: tasks.map((task, index) => ({
-				index,
-				agent: task.agent,
-				status: "running" as const,
-				task: task.task,
-				recentTools: [],
-				recentOutput: [],
-				toolCount: 0,
-				tokens: 0,
-				durationMs: 0,
-			})),
-		},
-	};
-}
-
-function buildSingleInitialResult(params: SubagentParamsLike): AgentToolResult<Details> {
-	const agent = params.agent ?? "subagent";
-	const task = params.task ?? "";
-	return {
-		content: [{ type: "text", text: task }],
-		details: {
-			mode: "single",
-			...(params.context ? { context: params.context } : {}),
-			results: [createPlaceholderResult(agent, task, "running")],
-			progress: [
-				{
-					index: 0,
-					agent,
-					status: "running",
-					task,
-					recentTools: [],
-					recentOutput: [],
-					toolCount: 0,
-					tokens: 0,
-					durationMs: 0,
-				},
-			],
-		},
-	};
-}
-
-export function buildSlashInitialResult(
-	requestId: string,
-	params: SubagentParamsLike,
-	owner?: object,
-): SlashMessageDetails {
-	const store = getSlashSnapshotStore(owner);
-	const result =
-		(params.tasks?.length ?? 0) > 0 ? buildParallelInitialResult(params) : buildSingleInitialResult(params);
-	store.liveSnapshots.set(requestId, { result, version: nextVersion(store) });
-	store.finalSnapshots.delete(requestId);
-	return { requestId, result };
-}
-
-function cloneResultsWithProgress(
-	results: SingleResult[],
-	progress: NonNullable<Details["progress"]> | undefined,
-): SingleResult[] {
-	return results.map((result, index) => {
-		const nextProgress = progress?.find((entry) => entry.index === index) ?? progress?.[index] ?? result.progress;
-		return nextProgress ? { ...result, progress: nextProgress } : result;
-	});
-}
-
-export function applySlashUpdate(requestId: string, update: SlashSubagentUpdate, owner?: object): void {
-	const store = getSlashSnapshotStore(owner);
-	const snapshot = store.liveSnapshots.get(requestId);
-	if (!snapshot) return;
-	const progress = update.progress;
-	if (!progress || !snapshot.result.details) return;
-	const nextDetails: Details = {
-		...snapshot.result.details,
-		progress,
-		results: cloneResultsWithProgress(snapshot.result.details.results, progress),
-	};
-	store.liveSnapshots.set(requestId, {
-		result: {
-			...snapshot.result,
-			details: nextDetails,
-		},
-		version: nextVersion(store),
-	});
-}
-
-export function finalizeSlashResult(response: SlashSubagentResponse, owner?: object): SlashMessageDetails {
-	const store = getSlashSnapshotStore(owner);
-	const snapshot = {
-		result: response.result,
-		version: nextVersion(store),
-	};
-	store.finalSnapshots.set(response.requestId, snapshot);
-	store.liveSnapshots.delete(response.requestId);
-	return {
-		requestId: response.requestId,
-		result: response.result,
-	};
-}
-
-export function failSlashResult(
-	requestId: string,
-	params: SubagentParamsLike,
-	message: string,
-	owner?: object,
-): SlashMessageDetails {
-	const store = getSlashSnapshotStore(owner);
-	const initial = buildSlashInitialResult(requestId, params, owner).result;
-	const failedResults = initial.details.results.map((result) => ({
-		...result,
-		status: "error" as const,
-		error: message,
-		progress: result.progress ? { ...result.progress, status: "failed" as const } : result.progress,
-	}));
-	const result: AgentToolResult<Details> = {
-		content: [{ type: "text", text: message }],
-		details: {
-			...initial.details,
-			results: failedResults,
-			progress: failedResults.map((entry) => entry.progress!).filter(Boolean),
-		},
-	};
-	const snapshot = { result, version: nextVersion(store) };
-	store.finalSnapshots.set(requestId, snapshot);
-	store.liveSnapshots.delete(requestId);
-	return { requestId, result };
-}
-
-function isSlashMessageDetails(value: unknown): value is SlashMessageDetails {
-	if (!value || typeof value !== "object") return false;
-	const v = value as { requestId?: string; result?: { content?: unknown; details?: { results?: unknown } } };
-	if (typeof v.requestId !== "string" || !v.requestId) return false;
-	if (!v.result || !Array.isArray(v.result.content)) return false;
-	return !!v.result.details && Array.isArray(v.result.details.results);
-}
-
-export function resolveSlashMessageDetails(value: unknown): SlashMessageDetails | undefined {
-	return isSlashMessageDetails(value) ? value : undefined;
-}
-
-export function getSlashRenderableSnapshot(details: SlashMessageDetails, owner?: object): SlashSnapshot {
-	const store = getSlashSnapshotStore(owner);
-	return (
-		store.finalSnapshots.get(details.requestId) ??
-		store.liveSnapshots.get(details.requestId) ?? { result: details.result, version: 0 }
-	);
-}
-
-export function restoreSlashFinalSnapshots(entries: unknown[], owner?: object): void {
-	const store = getSlashSnapshotStore(owner);
-	store.liveSnapshots.clear();
-	store.finalSnapshots.clear();
-	for (const entry of entries) {
-		const e = entry as { type?: string; customType?: string; details?: unknown };
-		if (e?.type !== "custom_message" || e.customType !== SLASH_RESULT_TYPE) continue;
-		const details = resolveSlashMessageDetails(e.details);
-		if (!details) continue;
-		store.finalSnapshots.set(details.requestId, { result: details.result, version: nextVersion(store) });
-	}
-}
-
-export function clearSlashSnapshots(owner?: object): void {
-	const store = getSlashSnapshotStore(owner);
-	store.liveSnapshots.clear();
-	store.finalSnapshots.clear();
-}

package/dist/builtin/subagents/src/tui/render-event-formatting.ts

@@ -1,7 +0,0 @@
-import { formatModelThinking } from "../shared/formatters.js";
-import type { Theme } from "./render-layout.js";
-
-export function modelThinkingBadge(theme: Theme, model?: string, thinking?: string, fastMode?: boolean): string {
-	const label = formatModelThinking(model, thinking, fastMode);
-	return label ? theme.fg("dim", ` (${label})`) : "";
-}

package/dist/builtin/subagents/src/tui/render-helpers.ts

@@ -1,90 +0,0 @@
-import type { Theme } from "@bastani/atomic";
-import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
-
-function fuzzyScore(query: string, text: string): number {
-	const lq = query.toLowerCase();
-	const lt = text.toLowerCase();
-	if (lt.includes(lq)) return 100 + (lq.length / lt.length) * 50;
-	let score = 0;
-	let qi = 0;
-	let consecutive = 0;
-	for (let i = 0; i < lt.length && qi < lq.length; i++) {
-		if (lt[i] === lq[qi]) {
-			score += 10 + consecutive;
-			consecutive += 5;
-			qi++;
-		} else {
-			consecutive = 0;
-		}
-	}
-	return qi === lq.length ? score : 0;
-}
-
-export function fuzzyFilter<T extends { name: string; description: string; model?: string }>(
-	items: T[],
-	query: string,
-): T[] {
-	const q = query.trim();
-	if (!q) return items;
-	return items
-		.map((item) => ({
-			item,
-			score: Math.max(
-				fuzzyScore(q, item.name),
-				fuzzyScore(q, item.description) * 0.8,
-				fuzzyScore(q, item.model ?? "") * 0.6,
-			),
-		}))
-		.filter((x) => x.score > 0)
-		.sort((a, b) => b.score - a.score)
-		.map((x) => x.item);
-}
-
-export function pad(s: string, len: number): string {
-	const vis = visibleWidth(s);
-	return s + " ".repeat(Math.max(0, len - vis));
-}
-
-export function row(content: string, width: number, theme: Theme): string {
-	const innerW = width - 2;
-	const singleLine = content.replace(/[\r\n]+/g, " ").replace(/\t/g, "  ");
-	const clipped = truncateToWidth(singleLine, innerW);
-	return theme.fg("border", "│") + pad(clipped, innerW) + theme.fg("border", "│");
-}
-
-export function renderHeader(text: string, width: number, theme: Theme): string {
-	const innerW = width - 2;
-	const padLen = Math.max(0, innerW - visibleWidth(text));
-	const padLeft = Math.floor(padLen / 2);
-	const padRight = padLen - padLeft;
-	return (
-		theme.fg("border", `╭${"─".repeat(padLeft)}`) +
-		theme.fg("accent", text) +
-		theme.fg("border", `${"─".repeat(padRight)}╮`)
-	);
-}
-
-export function formatPath(filePath: string): string {
-	const home = process.env.HOME;
-	if (home && filePath.startsWith(home)) return `~${filePath.slice(home.length)}`;
-	return filePath;
-}
-
-export function formatScrollInfo(above: number, below: number): string {
-	let info = "";
-	if (above > 0) info += `↑ ${above} more`;
-	if (below > 0) info += `${info ? "  " : ""}↓ ${below} more`;
-	return info;
-}
-
-export function renderFooter(text: string, width: number, theme: Theme): string {
-	const innerW = width - 2;
-	const padLen = Math.max(0, innerW - visibleWidth(text));
-	const padLeft = Math.floor(padLen / 2);
-	const padRight = padLen - padLeft;
-	return (
-		theme.fg("border", `╰${"─".repeat(padLeft)}`) +
-		theme.fg("dim", text) +
-		theme.fg("border", `${"─".repeat(padRight)}╯`)
-	);
-}

package/dist/builtin/subagents/src/tui/render-layout.ts

@@ -1,157 +0,0 @@
-import type { ExtensionContext } from "@bastani/atomic";
-import { visibleWidth } from "@earendil-works/pi-tui";
-import type { AgentProgress } from "../shared/types.js";
-
-export type Theme = ExtensionContext["ui"]["theme"];
-
-export function getTermWidth(): number {
-	return process.stdout.columns || 120;
-}
-
-const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
-
-/**
- * Truncate a line to maxWidth, preserving ANSI styling through the ellipsis.
- *
- * pi-tui's truncateToWidth adds \x1b[0m before ellipsis which resets all styling,
- * causing background color bleed in the TUI. This implementation tracks active
- * ANSI styles and re-applies them before the ellipsis.
- *
- * Uses Intl.Segmenter for proper Unicode/emoji handling (not char-by-char).
- */
-export function truncLine(text: string, maxWidth: number): string {
-	if (visibleWidth(text) <= maxWidth) return text;
-
-	const targetWidth = maxWidth - 1;
-	let result = "";
-	let currentWidth = 0;
-	let activeStyles: string[] = [];
-	let i = 0;
-
-	while (i < text.length) {
-		const ansiMatch = text.slice(i).match(/^\x1b\[[0-9;]*m/);
-		if (ansiMatch) {
-			const code = ansiMatch[0];
-			result += code;
-
-			if (code === "\x1b[0m" || code === "\x1b[m") {
-				activeStyles = [];
-			} else {
-				activeStyles.push(code);
-			}
-			i += code.length;
-			continue;
-		}
-
-		let end = i;
-		while (end < text.length && !text.slice(end).match(/^\x1b\[[0-9;]*m/)) {
-			end++;
-		}
-
-		const textPortion = text.slice(i, end);
-		for (const seg of segmenter.segment(textPortion)) {
-			const grapheme = seg.segment;
-			const graphemeWidth = visibleWidth(grapheme);
-
-			if (currentWidth + graphemeWidth > targetWidth) {
-				return `${result + activeStyles.join("")}…`;
-			}
-
-			result += grapheme;
-			currentWidth += graphemeWidth;
-		}
-		i = end;
-	}
-
-	return `${result + activeStyles.join("")}…`;
-}
-
-export const RUNNING_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-
-/**
- * Spinner cadence (ms per frame). The running glyph is derived from wall-clock
- * time so every active spinner advances smoothly and in lockstep, independent
- * of how often (or how irregularly) progress data updates arrive. The animation
- * timers below only schedule re-renders; the displayed frame always comes from
- * the clock. This fixes the frozen/stuttering spinner from issue #1084.
- *
- * IMPORTANT: a wall-clock spinner only stays flicker-free for widgets pinned to
- * the bottom of the buffer (e.g. a below-editor widget), where every
- * tick stays inside the viewport. Content rendered into chat scrollback (live
- * foreground subagent results) can scroll above the viewport fold; there, even
- * a single-cell spinner diff forces pi-tui into a destructive full-screen +
- * scrollback clear on every tick. Such surfaces must NOT animate on a timer —
- * see pulseGlyph(), which is advanced once per real progress update instead.
- */
-export const RUNNING_ANIMATION_MS = 80;
-
-type ProgressSeedSource = Partial<
-	Pick<
-		AgentProgress,
-		"index" | "toolCount" | "tokens" | "durationMs" | "lastActivityAt" | "currentToolStartedAt" | "turnCount"
-	>
->;
-
-/**
- * Wall-clock-derived animation frame counter. Advances exactly one step every
- * `RUNNING_ANIMATION_MS`. Exposed for tests so they can pin a deterministic now.
- */
-export function currentRunningFrame(now: number = Date.now()): number {
-	return Math.floor(now / RUNNING_ANIMATION_MS);
-}
-
-export function runningSeed(...values: Array<number | undefined>): number | undefined {
-	let seed: number | undefined;
-	for (const value of values) {
-		if (value === undefined || !Number.isFinite(value)) continue;
-		seed = (seed ?? 0) + Math.trunc(value);
-	}
-	return seed;
-}
-
-export function runningGlyph(seed?: number, now?: number): string {
-	// Fold the wall-clock frame into the (optional) progress seed so the glyph
-	// advances over time. Callers that render into chat scrollback can pass a
-	// captured `now` so host re-renders do not mutate already-emitted lines.
-	const animatedSeed = runningSeed(seed, currentRunningFrame(now)) ?? 0;
-	return RUNNING_FRAMES[Math.abs(animatedSeed) % RUNNING_FRAMES.length]!;
-}
-
-export const PULSE_FRAMES = ["·", "•", "●", "•"];
-
-/**
- * Activity "heartbeat" glyph for live foreground subagent results. Unlike
- * runningGlyph(), the frame is NOT derived from wall-clock time: the caller
- * advances `frame` exactly once per real progress update (see
- * renderLiveSubagentResult). With no animation timer, the only line diffs this
- * produces coincide with progress data that genuinely changed, so the pulse can
- * live in chat scrollback (above or below the fold) without ever triggering
- * pi-tui's full-screen/scrollback clear. Returns a steady breathing dot that
- * grows and settles as the subagent reports activity.
- */
-export function pulseGlyph(frame?: number): string {
-	const index = Number.isFinite(frame) ? Math.abs(Math.trunc(frame as number)) : 0;
-	return PULSE_FRAMES[index % PULSE_FRAMES.length]!;
-}
-
-/**
- * Running subagent pulse. It reuses the exact foreground pulse glyph frames
- * while accepting an explicit frame advanced by the renderer on real progress
- * updates, matching foreground result semantics.
- */
-export function runningPulseGlyph(frame?: number): string {
-	return pulseGlyph(frame);
-}
-
-export function progressRunningSeed(progress: ProgressSeedSource | undefined): number | undefined {
-	if (!progress) return undefined;
-	return runningSeed(
-		progress.index,
-		progress.toolCount,
-		progress.tokens,
-		progress.durationMs,
-		progress.lastActivityAt,
-		progress.currentToolStartedAt,
-		progress.turnCount,
-	);
-}

package/dist/builtin/subagents/src/tui/render-progress.ts

@@ -1,89 +0,0 @@
-import { formatAgentRunningLabel } from "../shared/status-format.js";
-import type { Details } from "../shared/types.js";
-
-export function isDoneResult(result: Details["results"][number]): boolean {
-	const status = result.progress?.status;
-	if (status === "completed") return true;
-	if (status === "running" || status === "pending") return false;
-	if (result.interrupted || result.detached || result.status !== "ok") return false;
-	return true;
-}
-
-export interface MultiProgressLabel {
-	headerLabel: string;
-	itemTitle: "Step" | "Agent";
-	totalCount: number;
-	groupStartIndex: number;
-	groupEndIndex: number;
-	showActiveGroupOnly: boolean;
-}
-
-export function buildMultiProgressLabel(
-	details: Pick<Details, "mode" | "results" | "progress" | "totalSteps">,
-	hasRunning: boolean,
-): MultiProgressLabel {
-	const itemTitle: "Step" | "Agent" = details.mode === "parallel" ? "Agent" : "Step";
-	const totalCount = details.totalSteps ?? details.results.length;
-
-	if (details.mode === "parallel") {
-		const statuses = new Array(totalCount).fill("pending") as Array<
-			"pending" | "running" | "completed" | "failed" | "interrupted" | "detached"
-		>;
-		for (const progress of details.progress ?? []) {
-			if (progress.index >= 0 && progress.index < totalCount) statuses[progress.index] = progress.status;
-		}
-		for (let i = 0; i < details.results.length; i++) {
-			const result = details.results[i]!;
-			const progressFromArray =
-				details.progress?.find((progress) => progress.index === i) ||
-				details.progress?.find((progress) => progress.agent === result.agent && progress.status === "running");
-			const index = result.progress?.index ?? progressFromArray?.index ?? i;
-			if (index < 0 || index >= totalCount) continue;
-			const status =
-				result.progress?.status ??
-				(result.interrupted || result.status === "interrupted"
-					? "interrupted"
-					: result.detached || result.status === "continued"
-						? "detached"
-						: result.status === "ok"
-							? "completed"
-							: "failed");
-			statuses[index] = status;
-		}
-		const running = statuses.filter((status) => status === "running").length;
-		const done = statuses.filter((status) => status === "completed").length;
-		const headerLabel = hasRunning
-			? `${formatAgentRunningLabel(running)} · ${done}/${totalCount} done`
-			: `${done}/${totalCount} done`;
-		return {
-			headerLabel,
-			itemTitle,
-			totalCount,
-			groupStartIndex: 0,
-			groupEndIndex: totalCount,
-			showActiveGroupOnly: false,
-		};
-	}
-
-	const done = details.results.filter(isDoneResult).length;
-	const currentStep = Math.min(totalCount, done + (hasRunning ? 1 : 0));
-	const headerLabel = hasRunning ? `step ${currentStep}/${totalCount}` : `step ${done}/${totalCount}`;
-	return {
-		headerLabel,
-		itemTitle,
-		totalCount,
-		groupStartIndex: 0,
-		groupEndIndex: details.results.length,
-		showActiveGroupOnly: false,
-	};
-}
-
-export function resultRowLabel(
-	details: Pick<Details, "mode">,
-	label: MultiProgressLabel,
-	_resultIndex: number,
-	stepNumber: number,
-): string {
-	if (label.itemTitle === "Agent") return `Agent ${stepNumber}/${label.totalCount}`;
-	return details.mode === "parallel" ? `Agent ${stepNumber}` : `Step ${stepNumber}`;
-}

package/dist/builtin/subagents/src/tui/render-result-animation.ts

@@ -1,47 +0,0 @@
-type ResultAnimationTimer = ReturnType<typeof setInterval>;
-
-export interface SubagentResultRenderState {
-	subagentResultAnimationTimer?: ResultAnimationTimer;
-	subagentResultAnimationCleanup?: () => void;
-	subagentResultSnapshotKey?: string;
-	/** Stable semantic/content timestamp used for durations and activity text. */
-	subagentResultSnapshotNow?: number;
-	/** Monotonic pulse frame, advanced once per progress update (no timer). */
-	subagentResultPulseFrame?: number;
-}
-
-export type ResultAnimationContext = {
-	state: SubagentResultRenderState;
-	invalidate: () => void;
-};
-type LegacyResultAnimationContext = {
-	state: {
-		subagentResultAnimationTimer?: ResultAnimationTimer;
-		subagentResultAnimationCleanup?: () => void;
-	};
-};
-
-/**
- * Legacy safety net for render state objects created by earlier timer-driven
- * foreground result rendering. New code never schedules result timers, but
- * clearing the field prevents a stale interval from surviving across upgrades.
- */
-export function clearResultAnimationTimer(context: LegacyResultAnimationContext): void {
-	const timer = context.state.subagentResultAnimationTimer;
-	if (timer) clearInterval(timer);
-	context.state.subagentResultAnimationTimer = undefined;
-	context.state.subagentResultAnimationCleanup = undefined;
-}
-
-export function advanceResultPulseFrame(frame: number | undefined): number {
-	return (frame ?? 0) + 1;
-}
-
-export function clearLegacyResultAnimationTimer(context: LegacyResultAnimationContext): void {
-	clearResultAnimationTimer(context);
-}
-
-export function stopResultAnimations(): void {
-	// Retained for extension teardown compatibility; result rendering no longer
-	// registers global animation timers.
-}