@agnishc/edb-compact-tools 0.10.6 → 0.10.9

package/src/tool-meta.ts

@@ -0,0 +1,160 @@
+import { ANSI_PURPLE, ANSI_RESET } from "./constants.js";
+import { clip, lineCount, oneLine, outputWasTruncated, textContent } from "./text.js";
+
+// ── Skill path detection ─────────────────────────────────────────
+
+export function isSkillPath(path: unknown): boolean {
+	if (typeof path !== "string") return false;
+	return path.includes(".agents/skills/") || path.includes(".pi/agent/skills/");
+}
+
+export function purple(text: string): string {
+	return `${ANSI_PURPLE}${text}${ANSI_RESET}`;
+}
+
+// ── Tool metadata registry ───────────────────────────────────────
+
+type ToolMeta = {
+	color: string | ((args?: any) => string);
+	icon: string;
+	label: (args: any) => string;
+	summary: (result: any) => string;
+};
+
+const TOOL_REGISTRY: Record<string, ToolMeta> = {
+	bash: {
+		color: "bashMode",
+		icon: "⚙️",
+		label: (args) => clip(oneLine(args?.command), 140),
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			const exitMatch = text.match(/Exit code:\s*(-?\d+)/i) ?? text.match(/exit(?:ed)?(?: code)?\s*(-?\d+)/i);
+			const exit = exitMatch?.[1] ?? (result?.isError ? "1" : "0");
+			return `exit ${exit} · ${lines} line${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+	read: {
+		color: (args) => (isSkillPath(args?.path) ? "purple" : "toolTitle"),
+		icon: "📖",
+		label: (args) => clip(oneLine(args?.path), 140),
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			return `${lines} line${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+	grep: {
+		color: "success",
+		icon: "🔎",
+		label: (args) => {
+			const pattern = oneLine(args?.pattern);
+			const path = oneLine(args?.path ?? args?.glob ?? ".");
+			return clip(`${pattern}${path ? ` in ${path}` : ""}`, 140);
+		},
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			return `${lines} result${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+	find: {
+		color: "accent",
+		icon: "🧭",
+		label: (args) => clip(oneLine(args?.path ?? args?.pattern ?? "."), 140),
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			return `${lines} result${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+	ls: {
+		color: "warning",
+		icon: "📁",
+		label: (args) => clip(oneLine(args?.path), 140),
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			return `${lines} item${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+	edit: {
+		color: "toolDiffAdded",
+		icon: "✏️",
+		label: (args) => {
+			const count = Array.isArray(args?.edits) ? args.edits.length : args?.oldText && args?.newText ? 1 : 0;
+			return clip(
+				`${oneLine(args?.path ?? args?.file_path)}${count ? ` · ${count} replacement${count === 1 ? "" : "s"}` : ""}`,
+				140,
+			);
+		},
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			const diff = typeof result?.details?.diff === "string" ? result.details.diff : "";
+			const added = diff
+				.split(/\r?\n/)
+				.filter((line: string) => line.startsWith("+") && !line.startsWith("+++")).length;
+			const removed = diff
+				.split(/\r?\n/)
+				.filter((line: string) => line.startsWith("-") && !line.startsWith("---")).length;
+			return diff ? `+${added} -${removed}` : `${lines} line${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+	write: {
+		color: "accent",
+		icon: "📝",
+		label: (args) => {
+			const bytes = typeof args?.content === "string" ? Buffer.byteLength(args.content, "utf8") : 0;
+			return clip(`${oneLine(args?.path ?? args?.file_path)}${bytes ? ` · ${bytes} bytes` : ""}`, 140);
+		},
+		summary: (result) => {
+			const text = textContent(result);
+			const lines = lineCount(text);
+			const truncated = outputWasTruncated(text) ? " · truncated" : "";
+			return `${lines} line${lines === 1 ? "" : "s"}${truncated}`;
+		},
+	},
+};
+
+const DEFAULT_META: ToolMeta = {
+	color: "accent",
+	icon: "🧩",
+	label: (args) => {
+		const compactArgs = oneLine(JSON.stringify(args ?? {}));
+		return clip(compactArgs === "{}" ? "" : compactArgs, 140);
+	},
+	summary: (result) => {
+		const text = textContent(result);
+		const lines = lineCount(text);
+		const truncated = outputWasTruncated(text) ? " · truncated" : "";
+		return `${lines} result${lines === 1 ? "" : "s"}${truncated}`;
+	},
+};
+
+function getMeta(toolName: string): ToolMeta {
+	return TOOL_REGISTRY[toolName] ?? DEFAULT_META;
+}
+
+export function toolColor(toolName: string, args?: any): string {
+	const color = getMeta(toolName).color;
+	return typeof color === "function" ? color(args) : color;
+}
+
+export function toolIcon(toolName: string): string {
+	return getMeta(toolName).icon;
+}
+
+export function callLabel(toolName: string, args: any): string {
+	return getMeta(toolName).label(args);
+}
+
+export function summaryFor(toolName: string, result: any): string {
+	return getMeta(toolName).summary(result);
+}

package/src/tool-renderer.ts

@@ -0,0 +1,103 @@
+import { keyHint } from "@earendil-works/pi-coding-agent";
+import { MAX_EXPANDED_LINES } from "./constants.js";
+import { lineCount, previewLines, textContent } from "./text.js";
+import { EmptyBlock, ToolBlock } from "./tool-block.js";
+import { callLabel, purple, summaryFor, toolColor, toolIcon } from "./tool-meta.js";
+import type { CompactTheme, ToolBlockKind } from "./types.js";
+
+// ── Color resolution ─────────────────────────────────────────────
+
+function resolveColor(toolName: string, args?: any, override?: string): string {
+	if (override) return override;
+	return toolColor(toolName, args);
+}
+
+function makeColorFn(color: string, theme: CompactTheme): (text: string) => string {
+	return color === "purple" ? purple : (text: string) => theme.fg(color, text);
+}
+
+// ── Line builders ────────────────────────────────────────────────
+
+function topLine(toolName: string, theme: CompactTheme, label: string, args?: any): string {
+	const color = toolColor(toolName, args);
+	const title = `${toolIcon(toolName)} ${toolName}`;
+	const coloredTitle = color === "purple" ? purple(theme.bold(title)) : theme.fg(color, theme.bold(title));
+	return `${coloredTitle} ${theme.fg("toolOutput", label)}`;
+}
+
+function midLine(_toolName: string, theme: CompactTheme, text: string): string {
+	return theme.fg("toolOutput", text);
+}
+
+function bottomLine(_toolName: string, _theme: CompactTheme, text = ""): string {
+	return text.trimEnd();
+}
+
+// ── Block builders ───────────────────────────────────────────────
+
+function toolText(
+	kind: ToolBlockKind,
+	toolName: string,
+	lines: string[],
+	theme: CompactTheme,
+	borderColor: string,
+	args?: any,
+): ToolBlock {
+	const color = resolveColor(toolName, args, borderColor);
+	return new ToolBlock(kind, lines, theme, makeColorFn(color, theme));
+}
+
+// ── Renderers ────────────────────────────────────────────────────
+
+export function renderCall(_toolName: string, _args: any, _theme: CompactTheme, _context: any) {
+	return new EmptyBlock();
+}
+
+export function renderResult(toolName: string, result: any, options: any, theme: CompactTheme, context: any) {
+	const args = context?.args;
+
+	if (options?.isPartial) {
+		return toolText(
+			"full",
+			toolName,
+			[
+				topLine(toolName, theme, callLabel(toolName, args), args),
+				bottomLine(toolName, theme, theme.fg("muted", "running…")),
+			],
+			theme,
+			"warning",
+			args,
+		);
+	}
+
+	const summary = summaryFor(toolName, result);
+	const text = textContent(result);
+	const failed = Boolean(context?.isError || result?.isError);
+	const statusColor = failed ? "error" : "success";
+	const statusIcon = failed ? "✗" : "✓";
+	const expandHint = options?.expanded ? "" : ` ${theme.fg("dim", keyHint("app.tools.expand", "expand"))}`;
+
+	const top = topLine(toolName, theme, callLabel(toolName, args), args);
+	const bottom = bottomLine(
+		toolName,
+		theme,
+		`${theme.fg(statusColor, statusIcon)} ${theme.fg("toolOutput", summary)}${expandHint}`,
+	);
+	const borderColor = failed ? "error" : toolColor(toolName, args) === "purple" ? "purple" : "success";
+
+	if (!options?.expanded || !text.trim()) {
+		return toolText("full", toolName, [top, bottom], theme, borderColor, args);
+	}
+
+	const diff = toolName === "edit" && typeof result?.details?.diff === "string" ? result.details.diff : "";
+	const previewText = diff || text;
+	const mode = toolName === "bash" ? "tail" : "head";
+	const lines = previewLines(previewText, mode).map((line) => midLine(toolName, theme, line));
+	if (lineCount(previewText) > MAX_EXPANDED_LINES) {
+		const omitted = lineCount(previewText) - MAX_EXPANDED_LINES;
+		lines.push(midLine(toolName, theme, theme.fg("dim", `… ${omitted} more line(s)`)));
+	}
+	lines.unshift(top);
+	lines.push(bottomLine(toolName, theme, `${theme.fg(statusColor, statusIcon)} ${theme.fg("toolOutput", summary)}`));
+	return toolText("full", toolName, lines, theme, borderColor, args);
+}

package/src/types.ts

@@ -0,0 +1,15 @@
+export type CompactTheme = {
+	fg: (color: any, text: string) => string;
+	bg?: (color: any, text: string) => string;
+	bold: (text: string) => string;
+};
+
+export type BuiltinToolName = "read" | "bash" | "grep" | "find" | "ls" | "edit" | "write";
+
+export type BuiltinTool = {
+	description: string;
+	parameters: unknown;
+	execute: (id: string, params: unknown, signal?: AbortSignal, onUpdate?: unknown, ctx?: unknown) => Promise<unknown>;
+};
+
+export type ToolBlockKind = "call" | "result" | "full";