@zenodinh/pi-render 0.0.0-stage → 0.1.2

package/src/renderers/tool/specs/write.ts

@@ -0,0 +1,142 @@
+// ported from pi-pretty-tui/src/features/edit-write-collapse/render.ts — survives because: the
+// collapsed write summary is derived from the CALL args (path + content size), the only place the
+// data exists — the host write result carries just a one-line confirmation. The tool-run wrapper,
+// metrics, model-facing text and the monkey-patched highlight token do not port.
+
+/**
+ * specs/write.ts — the `write` tool row: collapsed path + size, expanded written content.
+ *
+ * shape: none — a data bundle (name, spec, descriptor) over straight-line spec functions; the only
+ * branch is the two-value written/error model, below the ≥3-branch dispatch-object trigger.
+ */
+
+import type {
+	CallModel,
+	ModuleDescriptor,
+	RenderContext,
+	RowPaint,
+	RowSpec,
+	RowView,
+	ToolResult,
+} from "../../../core/types.ts";
+
+const ICON = "✎";
+const ERROR_MARK = "✗";
+const MAX_ERROR_SUMMARY = 80;
+const MAX_PREVIEW_LINES = 20;
+
+/** Two-value model: a failed write carries only its error text; a written row carries args-derived counts. */
+type WriteModel =
+	| { kind: "error"; display: string; error: string }
+	| { kind: "written"; display: string; content: string | undefined; lines: number; bytes: number };
+
+/** The error flag reaches the result renderer on ctx, not on the {content, details} wrapper (host DP3). */
+function isError(result: ToolResult, ctx: RenderContext): boolean {
+	return ctx.isError === true || result.isError === true;
+}
+
+// boundary: host args are unknown-typed; every field is read through a typeof guard, never a cast.
+function readPath(args: Record<string, unknown> | undefined): string {
+	const direct = args?.file_path;
+	if (typeof direct === "string" && direct !== "") return direct;
+	const alt = args?.path;
+	return typeof alt === "string" ? alt : "";
+}
+
+function readContent(args: Record<string, unknown> | undefined): string | undefined {
+	const content = args?.content;
+	return typeof content === "string" ? content : undefined;
+}
+
+/** Shortens a path under cwd; anything else stays as given. */
+function displayPath(raw: string, cwd: string | undefined): string {
+	if (raw === "") return "";
+	if (cwd && raw.startsWith(`${cwd}/`)) return raw.slice(cwd.length + 1);
+	return raw;
+}
+
+function textOf(result: ToolResult): string {
+	return (result.content ?? [])
+		.filter((block) => block.type === "text")
+		.map((block) => block.text ?? "")
+		.join("\n")
+		.trim();
+}
+
+/** Lines are logical (trailing blanks trimmed) so "" is 0 lines; bytes are the raw UTF-8 length. */
+function writeCounts(content: string): { lines: number; bytes: number } {
+	const lines = content.replace(/\r\n/g, "\n").split("\n");
+	while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+	return { lines: lines.length, bytes: Buffer.byteLength(content, "utf8") };
+}
+
+function firstLine(text: string): string {
+	const line = (text.split("\n")[0] ?? "").trim();
+	return line.length > MAX_ERROR_SUMMARY ? `${line.slice(0, MAX_ERROR_SUMMARY - 1)}…` : line;
+}
+
+/** shape: none — a two-value expansion branch with one string body each. */
+function writtenLine(m: Extract<WriteModel, { kind: "written" }>, paint: RowPaint): string {
+	const head = m.display ? `${ICON} ${paint.title(m.display)}` : ICON;
+	// No content yet (args still streaming) is the pinned special case: no fabricated counts.
+	if (m.content === undefined) return `${head} ${paint.muted("· writing…")}`;
+	return `${head} ${paint.muted(`(${m.lines} lines · ${m.bytes} bytes)`)}`;
+}
+
+/** shape: none — one preview slice plus an optional hidden-lines hint; no discriminator. */
+function writtenBody(m: Extract<WriteModel, { kind: "written" }>, paint: RowPaint): string {
+	if (m.content === undefined) return "";
+	const lines = m.content.replace(/\r\n/g, "\n").split("\n");
+	const shown = lines.slice(0, MAX_PREVIEW_LINES).map((line) => paint.output(line));
+	const hidden = lines.length - shown.length;
+	if (hidden > 0) shown.push(paint.muted(`… ${hidden} more lines (${lines.length} total)`));
+	return shown.join("\n");
+}
+
+/** shape: none — a single collapsed line; error text is truncated, never re-wrapped. */
+function errorLine(m: Extract<WriteModel, { kind: "error" }>, paint: RowPaint): string {
+	const head = m.display ? `${ICON} ${paint.title(m.display)} ` : "";
+	return `${head}${paint.error(`${ERROR_MARK} ${firstLine(m.error)}`)}`;
+}
+
+/** shape: none — one map over the error's lines; no branch. */
+function errorBody(m: Extract<WriteModel, { kind: "error" }>, paint: RowPaint): string {
+	return m.error
+		.split("\n")
+		.map((line) => paint.error(line))
+		.join("\n");
+}
+
+/** shape: none — a single collapsed-line builder; the args gate is one boolean check. */
+function buildCall(args: Record<string, unknown>, ctx: RenderContext): CallModel {
+	const display = displayPath(readPath(args), ctx.cwd);
+	if (ctx.argsComplete === false || display === "") return { title: "write" };
+	return { title: `write: ${display}` };
+}
+
+/** shape: none — the written/error model is discriminated on one boolean; no dispatch object. */
+function build(result: ToolResult, ctx: RenderContext): WriteModel | "unknown" {
+	const display = displayPath(readPath(ctx.args), ctx.cwd);
+	if (isError(result, ctx)) return { kind: "error", display, error: textOf(result) || "Error" };
+	const content = readContent(ctx.args);
+	// Neither a path nor content: nothing recognizable, so the runtime degrades to the raw result.
+	if (display === "" && content === undefined) return "unknown";
+	const { lines, bytes } = writeCounts(content ?? "");
+	return { kind: "written", display, content, lines, bytes };
+}
+
+/** shape: none — two straight-line branches (state, then model kind); no dispatch object. */
+function project(m: WriteModel, view: RowView, paint: RowPaint): string {
+	if (m.kind === "error") return view.expanded ? errorBody(m, paint) : errorLine(m, paint);
+	return view.expanded ? writtenBody(m, paint) : writtenLine(m, paint);
+}
+
+export const writeRow: {
+	name: string;
+	spec: RowSpec<WriteModel>;
+	descriptor: ModuleDescriptor;
+} = {
+	name: "write",
+	spec: { buildCall, build, project },
+	descriptor: { key: "row.write", name: "Write row", defaultEnabled: true, settings: [] },
+};

package/src/renderers/tool/types.ts

@@ -0,0 +1,45 @@
+/**
+ * renderers/tool/types.ts — the tool-lane contracts (what a row spec is, and what it produces).
+ *
+ * Boundary: lane-local. A tool spec and the tool runtime import these; no other lane does. The
+ * host shapes they build on live in core (types/host.ts, types/paint.ts) — a row contract is the
+ * spec's own vocabulary, not the host's.
+ *
+ * shape: none — declaration-only module (no runtime unit), so no DSG-1 shape trigger applies.
+ */
+
+import type { RenderContext, ToolResult } from "../../core/types/host.ts";
+import type { RowPaint } from "../../core/types/paint.ts";
+
+/** Collapsed call-line model: the args gate keeps it name-only until argsComplete. */
+export interface CallModel {
+	/** The one-line call title, e.g. "bash: npm test". Required; never a guessed argument value. */
+	title: string;
+}
+
+/** Per-frame projection inputs, derived from the result plus the host's options. */
+export interface RowView {
+	/** True while the row is drawn expanded. Required. */
+	expanded: boolean;
+	/** True when the call failed. Required. */
+	isError: boolean;
+	/** True while the result is still streaming. Required. */
+	isPartial: boolean;
+}
+
+/**
+ * One tool row's three-stage contract: cheap call build, parse-once result build, per-frame project.
+ *
+ * @typeParam M — the parsed result model this spec derives; `unknown` is the erased default, so a
+ * `Record<string, RowSpec>` accepts every concrete spec without a cast.
+ */
+export interface RowSpec<M = unknown> {
+	/** Builds the collapsed call line; runs on every argument change. Required. */
+	buildCall(args: Record<string, unknown>, ctx: RenderContext): CallModel;
+	/** Parses the result once per result, memoized in ctx.state. Required; returns "unknown" when unrecognized. */
+	build(result: ToolResult, ctx: RenderContext): M | "unknown";
+	/** Draws the collapsed-line body; re-runs on every frame, so it stays allocation-light. Required. */
+	project(m: M, view: RowView, paint: RowPaint): string;
+	/** Enriches M, e.g. with a resolved link target, then asks the host to redraw. Optional. */
+	decorate?(m: M, ctx: RenderContext): Promise<Partial<M>>;
+}

package/themes/dracula-soft.json

@@ -0,0 +1,81 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "dracula-soft",
+	"appearance": "dark",
+	"vars": {
+		"text": "#f6f6f4",
+		"muted": "#7b7f8b",
+		"purple": "#bf9eee",
+		"pink": "#f286c4",
+		"cyan": "#97e1f1",
+		"green": "#62e884",
+		"red": "#ee6666",
+		"orange": "#ffb86c",
+		"yellow": "#e7ee98",
+		"selection": "#44475a",
+		"surface": "#343746"
+	},
+	"colors": {
+		"accent": "purple",
+		"border": "muted",
+		"borderAccent": "pink",
+		"borderMuted": "selection",
+		"success": "green",
+		"error": "red",
+		"warning": "orange",
+		"muted": "muted",
+		"dim": "#646773",
+		"text": "text",
+		"thinkingText": "muted",
+		"selectedBg": "selection",
+		"scrollbarTrack": "surface",
+		"scrollbarThumb": "muted",
+		"searchMatchBg": "#52554c",
+		"searchMatchText": "muted",
+		"userMessageBg": "surface",
+		"userMessageText": "text",
+		"customMessageBg": "#403d53",
+		"customMessageText": "muted",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "#2e313e",
+		"toolSuccessBg": "#324c44",
+		"toolErrorBg": "#4c353f",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "purple",
+		"mdLink": "cyan",
+		"mdLinkUrl": "muted",
+		"mdCode": "green",
+		"mdCodeBlock": "yellow",
+		"mdCodeBlockBorder": "muted",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "muted",
+		"mdHr": "muted",
+		"mdListBullet": "cyan",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "muted",
+		"syntaxComment": "muted",
+		"syntaxKeyword": "pink",
+		"syntaxFunction": "green",
+		"syntaxVariable": "orange",
+		"syntaxString": "yellow",
+		"syntaxNumber": "purple",
+		"syntaxType": "cyan",
+		"syntaxOperator": "muted",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "#53516c",
+		"thinkingMinimal": "#776b97",
+		"thinkingLow": "#9b84c3",
+		"thinkingMedium": "#bf9eee",
+		"thinkingHigh": "#d4a7c3",
+		"thinkingXhigh": "#eaaf97",
+		"thinkingMax": "#ffb86c",
+		"bashMode": "cyan"
+	},
+	"export": {
+		"pageBg": "#282a36",
+		"cardBg": "surface",
+		"infoBg": "#52554c"
+	}
+}

package/themes/one-dark.json

@@ -0,0 +1,80 @@
+{
+	"$schema": "https://raw.githubusercontent.com/earendil-works/pi/main/packages/coding-agent/src/modes/interactive/theme/theme-schema.json",
+	"name": "one-dark",
+	"appearance": "dark",
+	"vars": {
+		"text": "#abb2bf",
+		"muted": "#7f848e",
+		"blue": "#61afef",
+		"purple": "#c678dd",
+		"green": "#98c379",
+		"red": "#e06c75",
+		"orange": "#d19a66",
+		"yellow": "#e5c07b",
+		"selection": "#4e5666",
+		"surface": "#2c313c"
+	},
+	"colors": {
+		"accent": "blue",
+		"border": "muted",
+		"borderAccent": "blue",
+		"borderMuted": "#3e4452",
+		"success": "green",
+		"error": "red",
+		"warning": "yellow",
+		"muted": "muted",
+		"dim": "#636b78",
+		"text": "text",
+		"thinkingText": "muted",
+		"selectedBg": "selection",
+		"scrollbarTrack": "surface",
+		"scrollbarThumb": "selection",
+		"searchMatchBg": "#524d44",
+		"searchMatchText": "muted",
+		"userMessageBg": "surface",
+		"userMessageText": "text",
+		"customMessageBg": "#41384f",
+		"customMessageText": "muted",
+		"customMessageLabel": "purple",
+		"toolPendingBg": "#323842",
+		"toolSuccessBg": "#3c4740",
+		"toolErrorBg": "#493840",
+		"toolTitle": "text",
+		"toolOutput": "muted",
+		"mdHeading": "red",
+		"mdLink": "blue",
+		"mdLinkUrl": "muted",
+		"mdCode": "green",
+		"mdCodeBlock": "orange",
+		"mdCodeBlockBorder": "muted",
+		"mdQuote": "muted",
+		"mdQuoteBorder": "muted",
+		"mdHr": "muted",
+		"mdListBullet": "yellow",
+		"toolDiffAdded": "green",
+		"toolDiffRemoved": "red",
+		"toolDiffContext": "muted",
+		"syntaxComment": "muted",
+		"syntaxKeyword": "purple",
+		"syntaxFunction": "blue",
+		"syntaxVariable": "red",
+		"syntaxString": "green",
+		"syntaxNumber": "orange",
+		"syntaxType": "yellow",
+		"syntaxOperator": "#56b6c2",
+		"syntaxPunctuation": "muted",
+		"thinkingOff": "#5c5a74",
+		"thinkingMinimal": "#5e769d",
+		"thinkingLow": "#5f93c6",
+		"thinkingMedium": "#61afef",
+		"thinkingHigh": "#8db5c8",
+		"thinkingXhigh": "#b9baa2",
+		"thinkingMax": "#e5c07b",
+		"bashMode": "green"
+	},
+	"export": {
+		"pageBg": "#282c34",
+		"cardBg": "surface",
+		"infoBg": "#524d44"
+	}
+}