@danypops/papyrus 0.11.4 → 0.12.0

package/extension/src/tool-rendering/artifact-card.ts

@@ -0,0 +1,117 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type Component, truncateToWidth, wrapTextWithAnsi } from "@earendil-works/pi-tui";
+import type { ArtifactToolDetails } from "./render-model.ts";
+
+const KIND_GLYPHS: Readonly<Record<string, string>> = {
+	task: "◇",
+	doc: "▤",
+	rule: "◆",
+	skill: "✦",
+};
+
+const STATUS_GLYPHS: Readonly<Record<string, string>> = {
+	done: "✓",
+	active: "●",
+	"in-progress": "●",
+	review: "◐",
+	rejected: "✗",
+	canceled: "×",
+	todo: "○",
+	draft: "○",
+	archived: "·",
+	deprecated: "·",
+};
+
+type SemanticColor = "success" | "error" | "warning" | "accent" | "muted";
+
+function statusColor(status: string): SemanticColor {
+	if (status === "done" || status === "active") return "success";
+	if (status === "rejected" || status === "canceled") return "error";
+	if (status === "review") return "warning";
+	if (status === "in-progress") return "accent";
+	return "muted";
+}
+
+export function kindGlyph(kind: string): string {
+	return KIND_GLYPHS[kind] ?? "•";
+}
+
+export function statusGlyph(status: string): string {
+	return STATUS_GLYPHS[status] ?? "•";
+}
+
+export function countSummary(returned: number, total: number): string {
+	return returned === total ? String(total) : `${returned} of ${total}`;
+}
+
+export function emptyState(noun: string): string {
+	return `No ${noun}.`;
+}
+
+export function treeConnector(last: boolean): string {
+	return last ? "└─" : "├─";
+}
+
+export function expandHint(): string {
+	return "expand for details";
+}
+
+/** Reusable width-safe artifact card for native tool result rows. */
+export class ArtifactCard implements Component {
+	private details: ArtifactToolDetails;
+	private theme: Theme;
+	private expanded: boolean;
+	private cachedWidth: number | undefined;
+	private cachedLines: string[] | undefined;
+
+	constructor(details: ArtifactToolDetails, theme: Theme, expanded: boolean) {
+		this.details = details;
+		this.theme = theme;
+		this.expanded = expanded;
+	}
+
+	update(details: ArtifactToolDetails, theme: Theme, expanded: boolean): void {
+		this.details = details;
+		this.theme = theme;
+		this.expanded = expanded;
+		this.invalidate();
+	}
+
+	render(width: number): string[] {
+		const safeWidth = Math.max(1, width);
+		if (this.cachedLines && this.cachedWidth === safeWidth) return this.cachedLines;
+
+		const artifact = this.details.artifact;
+		const status = `${statusGlyph(artifact.status)} ${artifact.status}`;
+		const header = [
+			this.theme.fg("toolTitle", this.theme.bold(`${kindGlyph(artifact.kind)} ${artifact.kind.toUpperCase()}`)),
+			this.theme.fg("accent", artifact.id),
+			this.theme.fg(statusColor(artifact.status), status),
+		].join("  ");
+		const lines = [truncateToWidth(header, safeWidth)];
+		lines.push(truncateToWidth(this.theme.fg("text", artifact.title), safeWidth));
+
+		if (this.expanded) {
+			const metadata = [artifact.subtype, ...artifact.labels].filter(Boolean).join(" · ");
+			if (metadata) lines.push(truncateToWidth(this.theme.fg("muted", metadata), safeWidth));
+			if (artifact.body) lines.push(...wrapTextWithAnsi(artifact.body, safeWidth));
+			if (this.details.completeness.truncated) {
+				lines.push(truncateToWidth(
+					this.theme.fg("warning", `[truncated ${this.details.completeness.omitted} characters]`),
+					safeWidth,
+				));
+			}
+		} else if (artifact.body || artifact.labels.length > 0) {
+			lines.push(truncateToWidth(this.theme.fg("dim", expandHint()), safeWidth));
+		}
+
+		this.cachedWidth = safeWidth;
+		this.cachedLines = lines;
+		return lines;
+	}
+
+	invalidate(): void {
+		this.cachedWidth = undefined;
+		this.cachedLines = undefined;
+	}
+}

package/extension/src/tool-rendering/artifact-list.ts

@@ -0,0 +1,179 @@
+import type { Theme } from "@earendil-works/pi-coding-agent";
+import { type Component, truncateToWidth } from "@earendil-works/pi-tui";
+import { TOOL_COLLAPSED_ROW_LIMIT } from "../../../src/constants.ts";
+import { countSummary, expandHint, kindGlyph, statusGlyph, treeConnector } from "./artifact-card.ts";
+import type {
+	ArtifactListToolDetails,
+	GraphToolDetails,
+	ToolArtifactSummary,
+} from "./render-model.ts";
+
+function pluralKind(rows: readonly ToolArtifactSummary[]): string {
+	const kind = rows[0]?.kind ?? "artifact";
+	if (kind === "task") return "tasks";
+	if (kind === "doc") return "documents";
+	if (kind === "skill") return "skills";
+	if (kind === "rule") return "rules";
+	return "artifacts";
+}
+
+function statusSummary(rows: readonly ToolArtifactSummary[]): string {
+	const counts = new Map<string, number>();
+	for (const row of rows) counts.set(row.status, (counts.get(row.status) ?? 0) + 1);
+	return [...counts.entries()].map(([status, count]) => `${status} ${count}`).join(" · ");
+}
+
+function rowLine(row: ToolArtifactSummary, expanded: boolean, theme: Theme): string {
+	const identity = expanded ? `${row.id}  ` : "";
+	return [
+		theme.fg("muted", `${statusGlyph(row.status)} ${row.status}`),
+		theme.fg("accent", identity),
+		theme.fg("text", row.title),
+	].join("  ");
+}
+
+function rowMetadata(row: ToolArtifactSummary): string {
+	return [row.subtype, ...row.labels].filter(Boolean).join(" · ");
+}
+
+/** Bounded collapsed/expanded artifact collection presentation. */
+export class ArtifactListCard implements Component {
+	private details: ArtifactListToolDetails;
+	private theme: Theme;
+	private expanded: boolean;
+	private cachedWidth: number | undefined;
+	private cachedLines: string[] | undefined;
+
+	constructor(details: ArtifactListToolDetails, theme: Theme, expanded: boolean) {
+		this.details = details;
+		this.theme = theme;
+		this.expanded = expanded;
+	}
+
+	update(details: ArtifactListToolDetails, theme: Theme, expanded: boolean): void {
+		this.details = details;
+		this.theme = theme;
+		this.expanded = expanded;
+		this.invalidate();
+	}
+
+	render(width: number): string[] {
+		const safeWidth = Math.max(1, width);
+		if (this.cachedLines && this.cachedWidth === safeWidth) return this.cachedLines;
+		const rows = this.details.rows;
+		const noun = pluralKind(rows);
+		const lines = [truncateToWidth(
+			this.theme.fg("toolTitle", this.theme.bold(`${countSummary(rows.length, this.details.total)} ${noun}`)),
+			safeWidth,
+		)];
+		if (rows.length === 0) {
+			lines.push(truncateToWidth(this.theme.fg("dim", `No ${noun}.`), safeWidth));
+		} else {
+			lines.push(truncateToWidth(this.theme.fg("muted", statusSummary(rows)), safeWidth));
+			const display = this.expanded ? rows : rows.slice(0, TOOL_COLLAPSED_ROW_LIMIT);
+			for (const row of display) {
+				lines.push(truncateToWidth(rowLine(row, this.expanded, this.theme), safeWidth));
+				if (this.expanded) {
+					const metadata = rowMetadata(row);
+					if (metadata) lines.push(truncateToWidth(this.theme.fg("dim", `  ${metadata}`), safeWidth));
+				}
+			}
+			const omitted = Math.max(0, this.details.total - display.length);
+			if (omitted > 0) lines.push(truncateToWidth(this.theme.fg("dim", `${omitted} more · ${expandHint()}`), safeWidth));
+		}
+		this.cachedWidth = safeWidth;
+		this.cachedLines = lines;
+		return lines;
+	}
+
+	invalidate(): void {
+		this.cachedWidth = undefined;
+		this.cachedLines = undefined;
+	}
+}
+
+interface HierarchyRow {
+	node: ToolArtifactSummary;
+	prefix: string;
+	connector: string;
+}
+
+function hierarchyRows(details: GraphToolDetails): HierarchyRow[] {
+	const byId = new Map(details.nodes.map((node) => [node.id, node]));
+	const childIds = new Map<string, string[]>();
+	const contained = new Set<string>();
+	for (const edge of details.edges) {
+		if (edge.relation !== "contains" || !byId.has(edge.from) || !byId.has(edge.to)) continue;
+		const children = childIds.get(edge.from) ?? [];
+		children.push(edge.to);
+		childIds.set(edge.from, children);
+		contained.add(edge.to);
+	}
+	const roots = details.nodes.filter((node) => !contained.has(node.id));
+	const rows: HierarchyRow[] = [];
+	const visited = new Set<string>();
+	const visit = (node: ToolArtifactSummary, prefix: string, connector: string): void => {
+		if (visited.has(node.id)) return;
+		visited.add(node.id);
+		rows.push({ node, prefix, connector });
+		const children = (childIds.get(node.id) ?? []).map((id) => byId.get(id)).filter((child): child is ToolArtifactSummary => child !== undefined);
+		children.forEach((child, index) => {
+			const last = index === children.length - 1;
+			visit(child, `${prefix}${connector ? (connector === "└─" ? "  " : "│ ") : ""}`, treeConnector(last));
+		});
+	};
+	for (const root of roots) visit(root, "", "");
+	for (const node of details.nodes) visit(node, "", "");
+	return rows;
+}
+
+/** Bounded task containment preview; dependency graphs use the dedicated graph renderer. */
+export class TaskHierarchyPreview implements Component {
+	private details: GraphToolDetails;
+	private theme: Theme;
+	private expanded: boolean;
+	private cachedWidth: number | undefined;
+	private cachedLines: string[] | undefined;
+
+	constructor(details: GraphToolDetails, theme: Theme, expanded: boolean) {
+		this.details = details;
+		this.theme = theme;
+		this.expanded = expanded;
+	}
+
+	update(details: GraphToolDetails, theme: Theme, expanded: boolean): void {
+		this.details = details;
+		this.theme = theme;
+		this.expanded = expanded;
+		this.invalidate();
+	}
+
+	render(width: number): string[] {
+		const safeWidth = Math.max(1, width);
+		if (this.cachedLines && this.cachedWidth === safeWidth) return this.cachedLines;
+		const rows = hierarchyRows(this.details);
+		const lines = [truncateToWidth(
+			this.theme.fg("toolTitle", this.theme.bold(`${this.details.nodes.length} tasks · ${this.details.edges.length} edges`)),
+			safeWidth,
+		)];
+		for (const row of rows) {
+			const identity = this.expanded ? `${row.node.id}  ` : "";
+			lines.push(truncateToWidth(
+				`${row.prefix}${row.connector}${row.connector ? " " : ""}${this.theme.fg("accent", kindGlyph(row.node.kind))} ${this.theme.fg("muted", statusGlyph(row.node.status))} ${this.theme.fg("accent", identity)}${this.theme.fg("text", row.node.title)}`,
+				safeWidth,
+			));
+			if (this.expanded) {
+				const metadata = rowMetadata(row.node);
+				if (metadata) lines.push(truncateToWidth(this.theme.fg("dim", `${row.prefix}   ${metadata}`), safeWidth));
+			}
+		}
+		this.cachedWidth = safeWidth;
+		this.cachedLines = lines;
+		return lines;
+	}
+
+	invalidate(): void {
+		this.cachedWidth = undefined;
+		this.cachedLines = undefined;
+	}
+}

package/extension/src/tool-rendering/index.ts

@@ -0,0 +1,107 @@
+import type {
+	AgentToolResult,
+	Theme,
+	ToolRenderResultOptions,
+} from "@earendil-works/pi-coding-agent";
+import { type Component, Text } from "@earendil-works/pi-tui";
+import { ArtifactCard } from "./artifact-card.ts";
+import { ArtifactListCard, TaskHierarchyPreview } from "./artifact-list.ts";
+import { parsePapyrusToolDetails, type PapyrusToolDetails } from "./render-model.ts";
+
+const CALL_VALUE_MAX_CHARACTERS = 80;
+
+export interface PapyrusToolRenderContext {
+	lastComponent: Component | undefined;
+	isError: boolean;
+}
+
+function primaryArgument(args: Record<string, unknown>): string | undefined {
+	for (const key of ["id", "title", "text", "query", "kind", "template_id"]) {
+		const value = args[key];
+		if (typeof value === "string" && value.trim()) return value.slice(0, CALL_VALUE_MAX_CHARACTERS);
+	}
+	return undefined;
+}
+
+/** Compact native call header that never echoes bodies or structured payloads. */
+export function renderPapyrusToolCall(label: string, args: Record<string, unknown>, theme: Theme): Component {
+	const action = typeof args.action === "string" ? args.action : "call";
+	const primary = primaryArgument(args);
+	const text = [
+		theme.fg("toolTitle", theme.bold(label)),
+		theme.fg("muted", action),
+		...(primary ? [theme.fg("accent", primary)] : []),
+	].join("  ");
+	return new Text(text, 0, 0);
+}
+
+function textContent(result: AgentToolResult<unknown>): string {
+	return result.content
+		.filter((entry): entry is { type: "text"; text: string } => entry.type === "text")
+		.map((entry) => entry.text)
+		.join("\n");
+}
+
+function simpleDetailsText(details: Exclude<PapyrusToolDetails, { kind: "artifact" | "artifact-list" | "graph" }>): string {
+	switch (details.kind) {
+		case "transition":
+			return `✓ ${details.artifact.id}  ${details.fromStatus} → ${details.toStatus}\n${details.artifact.title}`;
+		case "gate-run": {
+			const passed = details.gates.filter((gate) => gate.passed).length;
+			return [
+				`${passed}/${details.gates.length} gates passed for ${details.artifactId}`,
+				...details.gates.map((gate) => `${gate.passed ? "✓" : "✗"} ${gate.type}: ${gate.target}${gate.output ? ` — ${gate.output}` : ""}`),
+			].join("\n");
+		}
+		case "invocation":
+			return [
+				`✓ Run ${details.runId}`,
+				`${details.created.tasks.length} tasks · ${details.created.docs.length} docs · ${details.created.rules.length} rules`,
+				...(details.created.roots.length ? [`Roots: ${details.created.roots.join(", ")}`] : []),
+			].join("\n");
+		case "preview":
+			return `${details.title}\n${details.content}${details.completeness.truncated ? `\n[truncated ${details.completeness.omitted} characters]` : ""}`;
+		case "error":
+			return `${details.code}: ${details.message}`;
+	}
+}
+
+/** Render structured details for humans while preserving compact model content as fallback. */
+export function renderPapyrusToolResult(
+	result: AgentToolResult<unknown>,
+	options: ToolRenderResultOptions,
+	theme: Theme,
+	context: PapyrusToolRenderContext,
+): Component {
+	if (options.isPartial) return new Text(theme.fg("warning", "Working…"), 0, 0);
+	const details = parsePapyrusToolDetails(result.details);
+	if (!details) return new Text(theme.fg("toolOutput", textContent(result)), 0, 0);
+
+	if (details.kind === "artifact") {
+		const previous = context.lastComponent instanceof ArtifactCard ? context.lastComponent : undefined;
+		if (previous) {
+			previous.update(details, theme, options.expanded);
+			return previous;
+		}
+		return new ArtifactCard(details, theme, options.expanded);
+	}
+	if (details.kind === "artifact-list") {
+		const previous = context.lastComponent instanceof ArtifactListCard ? context.lastComponent : undefined;
+		if (previous) {
+			previous.update(details, theme, options.expanded);
+			return previous;
+		}
+		return new ArtifactListCard(details, theme, options.expanded);
+	}
+	if (details.kind === "graph") {
+		const previous = context.lastComponent instanceof TaskHierarchyPreview ? context.lastComponent : undefined;
+		if (previous) {
+			previous.update(details, theme, options.expanded);
+			return previous;
+		}
+		return new TaskHierarchyPreview(details, theme, options.expanded);
+	}
+
+	const color = details.kind === "error" || context.isError ? "error" : "toolOutput";
+	return new Text(theme.fg(color, simpleDetailsText(details)), 0, 0);
+}