pi-quiet 0.1.0

package/README.md

@@ -0,0 +1,53 @@
+# pi-quiet
+
+Calm tool rendering for the [pi](https://pi.dev) coding agent.
+
+pi renders every bash call with the full command text, a multi-line output
+preview, and timing — useful when you're debugging a command, noisy when the
+agent is doing routine work. `pi-quiet` collapses each bash call to two lines:
+
+```
+$ ls -la /tmp | head -20
+  → ok · 15 lines · … -rw-r--r--  1 user  staff  5742 Aug 26 22:17 README.md
+```
+
+Multi-line commands show `(+N lines)`. Failures show a red `error`. Streaming
+shows `… running`.
+
+Press **ctrl+o** (pi's `app.tools.expand` binding) and the stock built-in
+rendering returns in full — complete commands, full output, truncation
+warnings. Press it again to re-collapse. It's a live toggle over the whole
+transcript: work collapsed, expand when something looks off.
+
+## Display-only, by construction
+
+The extension re-registers the built-in `bash` tool via pi's own
+`createBashToolDefinition` and overrides only the two render slots. Execution
+*is* the built-in tool:
+
+- the model receives the full, untruncated-by-us output;
+- permission systems, reviewers, and sandboxes that hook execution are
+  unaffected;
+- session logs store the full result.
+
+## Install
+
+```bash
+pi install npm:pi-quiet
+```
+
+Or try it for one session:
+
+```bash
+pi -e npm:pi-quiet
+```
+
+pi shows a one-time notice that the built-in `bash` tool was overridden —
+that's this extension, and it's expected.
+
+## Caveats
+
+- Covers `bash` only (the dominant chatter source). `read`/`grep`/`find`/`ls`
+  may follow.
+- The expanded path delegates to pi's built-in renderer, so a pi upgrade that
+  reshapes renderer internals can require a patch release here.

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "pi-quiet",
+  "version": "0.1.0",
+  "description": "Calm tool rendering for the pi coding agent: each bash call collapses to one line; ctrl+o brings back full built-in rendering. Display-only — execution, permissions, and model context are untouched.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/schuettc/pi-extensions.git",
+    "directory": "packages/pi-quiet"
+  },
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi-coding-agent",
+    "tui",
+    "tool-output",
+    "quiet"
+  ],
+  "files": [
+    "src",
+    "README.md"
+  ],
+  "pi": {
+    "extensions": [
+      "./src/index.ts"
+    ]
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-coding-agent": "^0.84.3",
+    "@earendil-works/pi-tui": "^0.84.3",
+    "typescript": "^5.6.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,76 @@
+/**
+ * quiet-tools: collapse bash tool chatter to one line per call.
+ *
+ * Re-registers the built-in bash tool (execution untouched — it IS the
+ * built-in, via createBashToolDefinition) and overrides only the two render
+ * slots. Collapsed (the default): the call renders as a single truncated
+ * `$ command` line and the result as a single muted summary line. Expanded
+ * (ctrl+o / app.tools.expand): both slots defer to the built-in renderer,
+ * so the full command, streamed output, truncation warnings, and duration
+ * come back exactly as stock pi shows them.
+ *
+ * Display-only by design: permission gating, auto-review, and the sandbox
+ * all hook execution, which this file never touches.
+ */
+
+import {
+  createBashToolDefinition,
+  type ExtensionAPI,
+} from "@earendil-works/pi-coding-agent";
+import { Text } from "@earendil-works/pi-tui";
+
+function firstLine(command: string): { line: string; more: number } {
+  const lines = command.split("\n");
+  return { line: lines[0] ?? "", more: lines.length - 1 };
+}
+
+function resultText(result: { content?: { type: string; text?: string }[] }): string {
+  return (result.content ?? [])
+    .filter((c) => c.type === "text")
+    .map((c) => c.text ?? "")
+    .join("\n");
+}
+
+export default function quietTools(pi: ExtensionAPI) {
+  const builtin = createBashToolDefinition(process.cwd());
+
+  pi.registerTool({
+    ...builtin,
+
+    renderCall(args: any, theme: any, context: any) {
+      if (context.expanded && builtin.renderCall) {
+        return builtin.renderCall(args, theme, context);
+      }
+      const command = typeof args?.command === "string" ? args.command : "...";
+      const { line, more } = firstLine(command.trim());
+      const suffix = more > 0 ? theme.fg("muted", ` (+${more} lines)`) : "";
+      // Text handles width truncation; keep the line itself short anyway so
+      // narrow panes stay one visual row.
+      const shown = line.length > 200 ? `${line.slice(0, 200)}…` : line;
+      return new Text(
+        theme.fg("toolTitle", theme.bold(`$ ${shown}`)) + suffix,
+        0,
+        0,
+      );
+    },
+
+    renderResult(result: any, options: any, theme: any, context: any) {
+      if (options.expanded && builtin.renderResult) {
+        return builtin.renderResult(result, options, theme, context);
+      }
+      if (options.isPartial) {
+        return new Text(theme.fg("muted", "  … running"), 0, 0);
+      }
+      const text = resultText(result).trim();
+      const lineCount = text ? text.split("\n").length : 0;
+      const status = result.isError ? theme.fg("error", "error") : "ok";
+      const tail = text ? text.split("\n").at(-1) ?? "" : "";
+      const tailShown = tail.length > 120 ? `${tail.slice(0, 120)}…` : tail;
+      const summary =
+        lineCount <= 1
+          ? `  → ${status}${tailShown ? theme.fg("toolOutput", ` · ${tailShown}`) : ""}`
+          : `  → ${status} · ${lineCount} lines${tailShown ? theme.fg("toolOutput", ` · … ${tailShown}`) : ""}`;
+      return new Text(theme.fg("muted", summary), 0, 0);
+    },
+  });
+}