@pi-agents/orchid 0.1.0-beta.0

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

@@ -0,0 +1,292 @@
+import type { AgentToolResult } from "@earendil-works/pi-agent-core";
+import type { Message } from "@earendil-works/pi-ai";
+import type { SubagentParamsLike } from "../runs/foreground/subagent-executor.ts";
+import type { SlashSubagentResponse, SlashSubagentUpdate } from "./slash-bridge.ts";
+import { type Details, type SingleResult, type Usage, SLASH_RESULT_TYPE } from "../shared/types.ts";
+
+export interface SlashMessageDetails {
+	requestId: string;
+	result: AgentToolResult<Details>;
+}
+
+interface SlashSnapshot {
+	result: AgentToolResult<Details>;
+	version: number;
+}
+
+interface SequentialChainStepLike {
+	agent: string;
+	task?: string;
+}
+
+interface ParallelChainStepLike {
+	parallel: Array<{ agent: string; task?: string }>;
+}
+
+type ChainStepLike = SequentialChainStepLike | ParallelChainStepLike;
+
+const liveSnapshots = new Map<string, SlashSnapshot>();
+const finalSnapshots = new Map<string, SlashSnapshot>();
+let versionCounter = 1;
+
+const EMPTY_MESSAGES: Message[] = [];
+const EMPTY_USAGE: Usage = {
+	input: 0,
+	output: 0,
+	cacheRead: 0,
+	cacheWrite: 0,
+	cost: 0,
+	turns: 0,
+};
+
+function nextVersion(): number {
+	return versionCounter++;
+}
+
+function cloneUsage(): Usage {
+	return { ...EMPTY_USAGE };
+}
+
+function createPlaceholderResult(
+	agent: string,
+	task: string,
+	status: "pending" | "running",
+	index?: number,
+): SingleResult {
+	return {
+		agent,
+		task,
+		exitCode: 0,
+		messages: EMPTY_MESSAGES,
+		usage: cloneUsage(),
+		progress: {
+			...(index !== undefined ? { index } : {}),
+			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 isParallelChainStep(step: ChainStepLike): step is ParallelChainStepLike {
+	return "parallel" in step && Array.isArray(step.parallel);
+}
+
+function chainStepLabel(step: ChainStepLike): string {
+	if (isParallelChainStep(step)) {
+		return `[${step.parallel.map((entry) => entry.agent).join("+")}]`;
+	}
+	return step.agent;
+}
+
+function flattenChainResults(chain: ChainStepLike[], fallbackTask: string | undefined): SingleResult[] {
+	const results: SingleResult[] = [];
+	let flatIndex = 0;
+	for (const step of chain) {
+		if (isParallelChainStep(step)) {
+			for (const task of step.parallel) {
+				results.push(createPlaceholderResult(task.agent, task.task ?? fallbackTask ?? "", results.length === 0 ? "running" : "pending", flatIndex));
+				flatIndex++;
+			}
+			continue;
+		}
+		results.push(createPlaceholderResult(step.agent, step.task ?? fallbackTask ?? "", results.length === 0 ? "running" : "pending", flatIndex));
+		flatIndex++;
+	}
+	return results;
+}
+
+function buildChainInitialResult(params: SubagentParamsLike): AgentToolResult<Details> {
+	const chain = (params.chain ?? []) as ChainStepLike[];
+	const results = flattenChainResults(chain, params.task);
+	return {
+		content: [{
+			type: "text",
+			text: results.map((result, index) => `Step ${index + 1}: ${result.agent}\n${result.task}`).join("\n\n"),
+		}],
+		details: {
+			mode: "chain",
+			...(params.context ? { context: params.context } : {}),
+			results,
+			progress: results.map((result, index) => ({
+				index,
+				agent: result.agent,
+				status: index === 0 ? "running" as const : "pending" as const,
+				task: result.task,
+				recentTools: [],
+				recentOutput: [],
+				toolCount: 0,
+				tokens: 0,
+				durationMs: 0,
+			})),
+			chainAgents: chain.map((step) => chainStepLabel(step)),
+			totalSteps: chain.length,
+			currentStepIndex: 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: [{
+				agent,
+				status: "running",
+				task,
+				recentTools: [],
+				recentOutput: [],
+				toolCount: 0,
+				tokens: 0,
+				durationMs: 0,
+			}],
+		},
+	};
+}
+
+export function buildSlashInitialResult(requestId: string, params: SubagentParamsLike): SlashMessageDetails {
+	const result = (params.tasks?.length ?? 0) > 0
+		? buildParallelInitialResult(params)
+		: (params.chain?.length ?? 0) > 0
+			? buildChainInitialResult(params)
+			: buildSingleInitialResult(params);
+	liveSnapshots.set(requestId, { result, version: nextVersion() });
+	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): void {
+	const snapshot = liveSnapshots.get(requestId);
+	if (!snapshot) return;
+	const progress = update.progress;
+	if (!progress || !snapshot.result.details) return;
+	const currentStepIndex = progress.findIndex((entry) => entry.status === "running");
+	const nextDetails: Details = {
+		...snapshot.result.details,
+		progress,
+		results: cloneResultsWithProgress(snapshot.result.details.results, progress),
+		...(snapshot.result.details.mode === "chain" && currentStepIndex >= 0 ? { currentStepIndex } : {}),
+	};
+	liveSnapshots.set(requestId, {
+		result: {
+			...snapshot.result,
+			details: nextDetails,
+		},
+		version: nextVersion(),
+	});
+}
+
+export function finalizeSlashResult(response: SlashSubagentResponse): SlashMessageDetails {
+	const snapshot = {
+		result: response.result,
+		version: nextVersion(),
+	};
+	finalSnapshots.set(response.requestId, snapshot);
+	liveSnapshots.delete(response.requestId);
+	return {
+		requestId: response.requestId,
+		result: response.result,
+	};
+}
+
+export function failSlashResult(requestId: string, params: SubagentParamsLike, message: string): SlashMessageDetails {
+	const initial = buildSlashInitialResult(requestId, params).result;
+	const failedResults = initial.details.results.map((result) => ({
+		...result,
+		exitCode: 1,
+		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() };
+	finalSnapshots.set(requestId, snapshot);
+	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): SlashSnapshot {
+	return finalSnapshots.get(details.requestId)
+		?? liveSnapshots.get(details.requestId)
+		?? { result: details.result, version: 0 };
+}
+
+export function restoreSlashFinalSnapshots(entries: unknown[]): void {
+	liveSnapshots.clear();
+	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;
+		finalSnapshots.set(details.requestId, { result: details.result, version: nextVersion() });
+	}
+}
+
+export function clearSlashSnapshots(): void {
+	liveSnapshots.clear();
+	finalSnapshots.clear();
+}

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

@@ -0,0 +1,80 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+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) + "╯")
+	);
+}