gentle-pi 2.5.0 → 2.6.1

package/lib/agents-thread-view.ts

@@ -0,0 +1,57 @@
+import { truncateToWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import { THREAD_ITEM, type ThreadItem, type ToolItem } from "./agents-protocol.ts";
+
+export interface AgentsThreadTheme {
+	fg(color: string, text: string): string;
+}
+
+const ROLE = {
+	TEXT: "text",
+	THINKING: "dim",
+	TOOL: "accent",
+	TOOL_ERROR: "error",
+	OUTPUT: "muted",
+	NOTE: "muted",
+	LABEL: "customMessageLabel",
+} as const;
+
+function line(theme: AgentsThreadTheme, role: string, text: string, width: number): string {
+	return theme.fg(role, truncateToWidth(text, Math.max(1, width), "…"));
+}
+
+function contentLines(theme: AgentsThreadTheme, role: string, text: string, width: number, requestedIndent: number): string[] {
+	const indent = Math.min(requestedIndent, Math.max(0, width - 1));
+	const prefix = " ".repeat(indent);
+	const contentWidth = Math.max(1, width - indent);
+	return text.split("\n").flatMap((source) => {
+		if (source.length === 0) return [theme.fg(role, prefix)];
+		const wrapped = wrapTextWithAnsi(source, contentWidth);
+		return (wrapped.length > 0 ? wrapped : [source]).map((part) => theme.fg(role, `${prefix}${part}`));
+	});
+}
+
+function toolStatus(item: ToolItem): "Running" | "Error" | "Complete" {
+	if (item.isError) return "Error";
+	return item.running ? "Running" : "Complete";
+}
+
+/** Render already-sanitized, bounded protocol items without inferring content roles. */
+export function renderThreadItem(item: ThreadItem, theme: AgentsThreadTheme, width: number): string[] {
+	if (width <= 0) return [];
+	switch (item.kind) {
+		case THREAD_ITEM.TEXT:
+			return [line(theme, ROLE.LABEL, "Text", width), ...contentLines(theme, ROLE.TEXT, item.text, width, 2)];
+		case THREAD_ITEM.THINKING:
+			return [line(theme, ROLE.LABEL, "Thinking", width), ...contentLines(theme, ROLE.THINKING, item.text, width, 2)];
+		case THREAD_ITEM.NOTE:
+			return [line(theme, ROLE.NOTE, "Note", width), ...contentLines(theme, ROLE.NOTE, item.text, width, 2)];
+		case THREAD_ITEM.TOOL: {
+			const role = item.isError ? ROLE.TOOL_ERROR : ROLE.TOOL;
+			const header = line(theme, role, `Tool · ${item.name} · ${toolStatus(item)}`, width);
+			if (item.output.length === 0) return [header];
+			return [header, line(theme, ROLE.OUTPUT, "  Output", width), ...contentLines(theme, ROLE.OUTPUT, item.output, width, 4)];
+		}
+		default:
+			return [];
+	}
+}

package/lib/agents-view-layout.ts

@@ -0,0 +1,40 @@
+// Shared Agents overlay geometry. Rendering and pointer routing use one bounded
+// measurement so terminal resizes cannot retain stale cells.
+
+export const AGENTS_FALLBACK_WIDTH = 12;
+export const AGENTS_SPLIT_LIST_MIN_WIDTH = 22;
+export const AGENTS_SPLIT_THREAD_MIN_WIDTH = 32;
+const FRAME_WIDTH = 6;
+const LIST_MAX_WIDTH = 34;
+const LIST_RATIO = 0.32;
+const CHROME_ROWS = 3;
+
+export type AgentsViewMode = "panes" | "narrow" | "fallback";
+
+export interface AgentsViewLayout {
+	mode: AgentsViewMode;
+	width: number;
+	height: number;
+	bodyRows: number;
+	footerY: number | undefined;
+	listX: number;
+	listWidth: number;
+	threadX: number;
+	threadWidth: number;
+}
+
+export function measureAgentsViewLayout(width: number, height: number, fullscreen = false): AgentsViewLayout {
+	const boundedWidth = Math.max(0, Math.floor(width));
+	const boundedHeight = Math.max(0, Math.floor(height));
+	if (boundedWidth < AGENTS_FALLBACK_WIDTH || boundedHeight < CHROME_ROWS) {
+		return { mode: "fallback", width: boundedWidth, height: boundedHeight, bodyRows: 0, footerY: undefined, listX: 0, listWidth: 0, threadX: 0, threadWidth: 0 };
+	}
+	const inner = boundedWidth - 2;
+	if (fullscreen || boundedWidth < AGENTS_SPLIT_LIST_MIN_WIDTH + AGENTS_SPLIT_THREAD_MIN_WIDTH + FRAME_WIDTH) {
+		const viewportWidth = Math.max(0, inner - 2);
+		return { mode: "narrow", width: boundedWidth, height: boundedHeight, bodyRows: boundedHeight - CHROME_ROWS, footerY: boundedHeight - 2, listX: 2, listWidth: viewportWidth, threadX: 2, threadWidth: viewportWidth };
+	}
+	const listWidth = Math.min(LIST_MAX_WIDTH, Math.max(AGENTS_SPLIT_LIST_MIN_WIDTH, Math.floor(inner * LIST_RATIO)));
+	const threadWidth = inner - listWidth - 4;
+	return { mode: "panes", width: boundedWidth, height: boundedHeight, bodyRows: boundedHeight - CHROME_ROWS, footerY: boundedHeight - 2, listX: 2, listWidth, threadX: listWidth + 5, threadWidth };
+}