gentle-pi 2.4.0 → 2.6.0

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-transcript.ts

@@ -0,0 +1,87 @@
+import { sanitizeTerminalText } from "./terminal-theme.ts";
+
+// Gentle Agents transcript: a child's session JSONL rendered as markdown a
+// human can read in an editor. Thinking is left out; tool output keeps a tail.
+
+export interface TranscriptOptions {
+	title: string;
+	maxOutputLines: number;
+}
+
+interface Part {
+	type?: string;
+	text?: string;
+	name?: string;
+	arguments?: Record<string, unknown>;
+}
+
+interface Entry {
+	type?: string;
+	message?: { role?: string; content?: Part[] | string; toolName?: string; isError?: boolean };
+}
+
+const DEFAULT_OPTIONS: TranscriptOptions = { title: "Subagent transcript", maxOutputLines: 40 };
+
+function clean(value: unknown): string {
+	return typeof value === "string" ? sanitizeTerminalText(value) : "";
+}
+
+function parts(content: Part[] | string | undefined): Part[] {
+	if (typeof content === "string") return [{ type: "text", text: content }];
+	return Array.isArray(content) ? content : [];
+}
+
+function argsSummary(args: Record<string, unknown> | undefined): string {
+	if (!args) return "";
+	const first = Object.values(args).find((value) => typeof value === "string") as string | undefined;
+	return first ? clean(first).replace(/\s+/g, " ").trim() : JSON.stringify(args);
+}
+
+function tail(text: string, max: number): string {
+	const lines = text.split("\n");
+	if (lines.length <= max) return text;
+	return [`… ${lines.length - max} earlier lines omitted`, ...lines.slice(-max)].join("\n");
+}
+
+function fence(text: string): string {
+	const ticks = /`{3,}/.test(text) ? "````" : "```";
+	return `${ticks}\n${text}\n${ticks}`;
+}
+
+export function sessionToMarkdown(jsonl: string, options: Partial<TranscriptOptions> = {}): string {
+	const { title, maxOutputLines } = { ...DEFAULT_OPTIONS, ...options };
+	const out: string[] = [`# ${title}`, ""];
+	for (const raw of jsonl.split("\n")) {
+		if (raw.trim().length === 0) continue;
+		let entry: Entry;
+		try {
+			entry = JSON.parse(raw) as Entry;
+		} catch {
+			continue;
+		}
+		if (entry.type !== "message" || !entry.message) continue;
+		const { role, content, toolName, isError } = entry.message;
+		if (role === "user") {
+			const text = parts(content).map((part) => clean(part.text)).filter((text) => text.length > 0).join("\n");
+			if (text) out.push("## User", "", text, "");
+		} else if (role === "assistant") {
+			let opened = false;
+			for (const part of parts(content)) {
+				if (part.type === "text" && clean(part.text).trim().length > 0) {
+					if (!opened) {
+						out.push("## Assistant", "");
+						opened = true;
+					}
+					out.push(clean(part.text).trim(), "");
+				} else if (part.type === "toolCall") {
+					out.push(`### ▸ ${clean(part.name) || "tool"} ${argsSummary(part.arguments)}`.trimEnd(), "");
+				}
+			}
+		} else if (role === "toolResult") {
+			const text = parts(content).map((part) => clean(part.text)).filter((text) => text.length > 0).join("\n");
+			const label = isError ? `${clean(toolName) || "tool"} error` : (clean(toolName) || "tool");
+			out.push(`<!-- ${label} -->`, fence(tail(text.length > 0 ? text : "(no output)", maxOutputLines)), "");
+		}
+	}
+	return `${out.join("\n").trimEnd()}\n`;
+}

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 };
+}