@diegopetrucci/pi-extensions 0.1.15 → 0.1.16

package/README.md

@@ -4,7 +4,8 @@ A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions
 
 - [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch/repo on the first line, context/model on the second, optional `DUMB ZONE`, plus OpenAI Codex 5-hour and 7-day usage when available.
 - [`oracle`](./extensions/oracle): Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, covers pi’s built-in providers with hardcoded rankings, sets reasoning to xhigh by default, and shows live status while running.
-- [`context-cap`](./extensions/context-cap): Caps effective model context windows at 200k tokens by default so pi auto-compacts earlier; toggle temporarily with `/context-cap`.
+- [`context-cap`](./extensions/context-cap): Caps effective model context windows at 200k tokens by default so pi avoids the `dumb zone`; toggle temporarily with `/context-cap`.
+- [`compact-bash`](./extensions/compact-bash): Renders collapsed assistant `bash` tool output as a one-line preview; toggle temporarily with `/compact-bash`.
 - [`permission-gate`](./extensions/permission-gate): Prompts for confirmation before dangerous bash commands like `rm -rf`, `sudo`, and `chmod 777`.
 - [`confirm-destructive`](./extensions/confirm-destructive): Confirms before destructive session actions like clear, switch, and fork.
 - [`notify`](./extensions/notify): Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.
@@ -22,15 +23,13 @@ pi install npm:@diegopetrucci/pi-extensions
 Or pin the GitHub package to this release:
 
 ```bash
-pi install git:github.com/diegopetrucci/pi-extensions@v0.1.15
+pi install git:github.com/diegopetrucci/pi-extensions@v0.1.16
 ```
 
 Or a specific extension:
 
 ```bash
 pi install npm:@diegopetrucci/pi-oracle
-# or
-pi install npm:@diegopetrucci/pi-context-cap
 ```
 
 Then reload pi:

package/extensions/compact-bash/README.md

@@ -0,0 +1,49 @@
+# compact-bash
+
+A pi extension that makes collapsed assistant `bash` tool output much quieter.
+
+When enabled, collapsed bash output renders as one output line plus an inline hidden-line count and `Ctrl+O` expand hint. Expanding with `Ctrl+O` still shows the full rendered output.
+
+## Commands
+
+```text
+/compact-bash status
+/compact-bash off
+/compact-bash on
+/compact-bash toggle
+```
+
+The extension starts enabled by default. Disabling is temporary for the current extension runtime/session; after `/reload`, `/new`, `/resume`, or `/fork`, it starts enabled again.
+
+## Install
+
+### Standalone npm package
+
+```bash
+pi install npm:@diegopetrucci/pi-compact-bash
+```
+
+### Collection package
+
+```bash
+pi install npm:@diegopetrucci/pi-extensions
+```
+
+### GitHub package
+
+```bash
+pi install git:github.com/diegopetrucci/pi-extensions
+```
+
+Then reload pi:
+
+```text
+/reload
+```
+
+## Notes
+
+- This extension overrides pi's built-in `bash` tool so it can customize only the TUI renderer.
+- It reuses pi's built-in bash implementation and preserves `shellPath`/`shellCommandPrefix` settings when they are available from settings files.
+- It does not truncate or rewrite the actual tool result sent to the model.
+- It affects assistant-invoked `bash` tool rows. User `!`/`!!` bash commands are rendered by a separate pi component and keep pi's default preview behavior.

package/extensions/compact-bash/index.ts

@@ -0,0 +1,241 @@
+import {
+	createBashToolDefinition,
+	DEFAULT_MAX_BYTES,
+	formatSize,
+	keyHint,
+	SettingsManager,
+	type ExtensionAPI,
+} from "@earendil-works/pi-coding-agent";
+import { Container, Text, truncateToWidth } from "@earendil-works/pi-tui";
+
+const COLLAPSED_PREVIEW_LINES = 1;
+
+type BashToolDefinition = ReturnType<typeof createBashToolDefinition>;
+type BashRenderResult = NonNullable<BashToolDefinition["renderResult"]>;
+type BashRenderResultParams = Parameters<BashRenderResult>;
+type BashRenderState = {
+	endedAt?: number;
+	interval?: ReturnType<typeof setInterval>;
+};
+
+function getTextOutput(result: BashRenderResultParams[0]): string {
+	return result.content
+		.filter((content) => content.type === "text")
+		.map((content) => content.text ?? "")
+		.join("\n")
+		.trim();
+}
+
+function formatDuration(ms: number): string {
+	return `${(ms / 1000).toFixed(1)}s`;
+}
+
+function visibleLength(text: string): number {
+	return text.replace(/\x1b\[[0-?]*[ -/]*[@-~]/g, "").length;
+}
+
+function renderCollapsedLine(
+	line: string,
+	hiddenLines: number,
+	theme: BashRenderResultParams[2],
+	width: number,
+): string {
+	if (width <= 0) return "";
+
+	const styledLine = theme.fg("toolOutput", line);
+	if (hiddenLines <= 0) {
+		return truncateToWidth(styledLine, width, "...");
+	}
+
+	const hint = theme.fg(
+		"muted",
+		`  ... ${hiddenLines} more line${hiddenLines === 1 ? "" : "s"} (${keyHint("app.tools.expand", "to expand")})`,
+	);
+	const hintWidth = visibleLength(hint);
+	if (hintWidth + 8 > width) {
+		return truncateToWidth(`${styledLine}${hint}`, width, "...");
+	}
+
+	return `${truncateToWidth(styledLine, width - hintWidth, "...")}${hint}`;
+}
+
+function getTruncationWarnings(result: BashRenderResultParams[0]): string[] {
+	const details = result.details as
+		| {
+				truncation?: {
+					truncated?: boolean;
+					truncatedBy?: "lines" | "bytes";
+					outputLines?: number;
+					totalLines?: number;
+					maxBytes?: number;
+				};
+				fullOutputPath?: string;
+		  }
+		| undefined;
+	const truncation = details?.truncation;
+	const warnings: string[] = [];
+
+	if (details?.fullOutputPath) {
+		warnings.push(`Full output: ${details.fullOutputPath}`);
+	}
+
+	if (truncation?.truncated) {
+		if (truncation.truncatedBy === "lines") {
+			warnings.push(`Truncated: showing ${truncation.outputLines} of ${truncation.totalLines} lines`);
+		} else {
+			warnings.push(
+				`Truncated: ${truncation.outputLines} lines shown (${formatSize(truncation.maxBytes ?? DEFAULT_MAX_BYTES)} limit)`,
+			);
+		}
+	}
+
+	return warnings;
+}
+
+function syncElapsedTimer(options: BashRenderResultParams[1], context: BashRenderResultParams[3]): BashRenderState {
+	const state = context.state as BashRenderState & { startedAt?: number };
+
+	if (state.startedAt !== undefined && options.isPartial && !state.interval) {
+		state.interval = setInterval(() => context.invalidate(), 1000);
+	}
+
+	if (!options.isPartial || context.isError) {
+		state.endedAt ??= Date.now();
+		if (state.interval) {
+			clearInterval(state.interval);
+			state.interval = undefined;
+		}
+	}
+
+	return state;
+}
+
+const renderCompactBashResult: BashRenderResult = (result, options, theme, context) => {
+	const state = syncElapsedTimer(options, context);
+	const component = (context.lastComponent as Container | undefined) ?? new Container();
+	component.clear();
+
+	const output = getTextOutput(result);
+	const outputLines = output ? output.split("\n") : [];
+
+	if (outputLines.length > 0) {
+		if (options.expanded) {
+			const displayText = outputLines.map((line) => theme.fg("toolOutput", line)).join("\n");
+			component.addChild(new Text(displayText, 0, 0));
+		} else {
+			const firstLine = outputLines[0] ?? "";
+			const hiddenLines = Math.max(0, outputLines.length - COLLAPSED_PREVIEW_LINES);
+			component.addChild({
+				render: (width) => [renderCollapsedLine(firstLine, hiddenLines, theme, width)],
+				invalidate: () => undefined,
+			});
+		}
+	} else if (options.isPartial) {
+		component.addChild(new Text(theme.fg("muted", "Running..."), 0, 0));
+	}
+
+	const warnings = getTruncationWarnings(result);
+	if (warnings.length > 0) {
+		component.addChild(new Text(theme.fg("warning", `[${warnings.join(". ")}]`), 0, 0));
+	}
+
+	if (options.expanded) {
+		const statusParts: string[] = [];
+		if (outputLines.length > COLLAPSED_PREVIEW_LINES) {
+			statusParts.push(`(${keyHint("app.tools.expand", "to collapse")})`);
+		}
+		if (state.startedAt !== undefined) {
+			const endTime = state.endedAt ?? Date.now();
+			statusParts.push(theme.fg("muted", `${options.isPartial ? "Elapsed" : "Took"} ${formatDuration(endTime - state.startedAt)}`));
+		}
+		if (statusParts.length > 0) {
+			component.addChild(new Text(statusParts.join("\n"), 0, 0));
+		}
+	}
+
+	component.invalidate();
+	return component;
+};
+
+function createBaseBashToolDefinition(cwd: string): BashToolDefinition {
+	try {
+		const settings = SettingsManager.create(cwd);
+		return createBashToolDefinition(cwd, {
+			commandPrefix: settings.getShellCommandPrefix(),
+			shellPath: settings.getShellPath(),
+		});
+	} catch {
+		return createBashToolDefinition(cwd);
+	}
+}
+
+function createCompactBashToolDefinition(cwd: string, enabled: boolean): BashToolDefinition {
+	const base = createBaseBashToolDefinition(cwd);
+	if (!enabled) return base;
+
+	return {
+		...base,
+		renderResult: renderCompactBashResult,
+	};
+}
+
+export default function compactBashExtension(pi: ExtensionAPI) {
+	let enabled = true;
+
+	function registerBashTool(cwd: string): void {
+		pi.registerTool(createCompactBashToolDefinition(cwd, enabled));
+	}
+
+	pi.on("session_start", async (_event, ctx) => {
+		registerBashTool(ctx.cwd);
+	});
+
+	pi.registerCommand("compact-bash", {
+		description: "Toggle one-line collapsed previews for bash tool output",
+		getArgumentCompletions: (prefix) => {
+			const commands = ["on", "off", "toggle", "status"];
+			const query = prefix.trim().toLowerCase();
+			const matches = commands.filter((command) => command.startsWith(query));
+			return matches.length > 0 ? matches.map((value) => ({ value, label: value })) : null;
+		},
+		handler: async (args, ctx) => {
+			const action = args.trim().toLowerCase() || "toggle";
+
+			if (action === "on" || action === "enable") {
+				enabled = true;
+				registerBashTool(ctx.cwd);
+				ctx.ui.notify("Compact bash previews enabled: collapsed bash output shows one line.", "info");
+				return;
+			}
+
+			if (action === "off" || action === "disable") {
+				enabled = false;
+				registerBashTool(ctx.cwd);
+				ctx.ui.notify("Compact bash previews disabled: restored pi's standard bash renderer.", "info");
+				return;
+			}
+
+			if (action === "toggle") {
+				enabled = !enabled;
+				registerBashTool(ctx.cwd);
+				ctx.ui.notify(
+					enabled
+						? "Compact bash previews enabled: collapsed bash output shows one line."
+						: "Compact bash previews disabled: restored pi's standard bash renderer.",
+					"info",
+				);
+				return;
+			}
+
+			if (action === "status") {
+				ctx.ui.notify(
+					`Compact bash previews are ${enabled ? "enabled" : "disabled"}. Collapsed preview lines: ${enabled ? COLLAPSED_PREVIEW_LINES : "pi default"}.`,
+					"info",
+				);
+				return;
+			}
+
+			ctx.ui.notify("Usage: /compact-bash on | off | toggle | status", "warning");
+		},
+	});
+}

package/extensions/compact-bash/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@diegopetrucci/pi-compact-bash",
+  "version": "0.1.0",
+  "description": "A pi extension that renders collapsed bash tool output as a one-line preview.",
+  "keywords": ["pi-package", "pi", "bash", "terminal"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diegopetrucci/pi-extensions.git",
+    "directory": "extensions/compact-bash"
+  },
+  "files": [
+    "index.ts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ]
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  }
+}

package/extensions/context-cap/README.md

@@ -1,6 +1,6 @@
 # context-cap
 
-A pi extension that treats large-context models as having an effective 200k-token context window, so pi's built-in auto-compaction starts earlier.
+A pi extension that treats large-context models as having an effective 200k-token context window, so pi's built-in auto-compaction starts earlier, and avoids the dumb zone.
 
 By default, pi auto-compacts when:
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.15",
-  "description": "A collection of pi extensions, including a minimal custom footer, an Amp-style oracle, a 200k context cap for auto-compaction, a permission gate for dangerous bash commands, confirm-before-destructive session actions, and terminal notifications when pi is ready for input.",
+  "version": "0.1.16",
+  "description": "A collection of pi extensions, including a minimal custom footer, an Amp-style oracle, a 200k context cap for auto-compaction, one-line collapsed bash previews, a permission gate for dangerous bash commands, confirm-before-destructive session actions, and terminal notifications when pi is ready for input.",
   "keywords": ["pi-package", "pi", "terminal", "agent"],
   "license": "MIT",
   "repository": {
@@ -31,6 +31,7 @@
       "./extensions/minimal-footer/index.ts",
       "./extensions/oracle/index.ts",
       "./extensions/context-cap/index.ts",
+      "./extensions/compact-bash/index.ts",
       "./extensions/permission-gate/index.ts",
       "./extensions/confirm-destructive/index.ts",
       "./extensions/notify/index.ts"