@mariozechner/pi-coding-agent 0.37.2 → 0.37.4

package/examples/extensions/custom-footer.ts

@@ -0,0 +1,86 @@
+/**
+ * Custom Footer Extension
+ *
+ * Demonstrates ctx.ui.setFooter() for replacing the built-in footer
+ * with a custom component showing session context usage.
+ */
+
+import type { AssistantMessage } from "@mariozechner/pi-ai";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+
+export default function (pi: ExtensionAPI) {
+	let isCustomFooter = false;
+
+	// Toggle custom footer with /footer command
+	pi.registerCommand("footer", {
+		description: "Toggle custom footer showing context usage",
+		handler: async (_args, ctx) => {
+			isCustomFooter = !isCustomFooter;
+
+			if (isCustomFooter) {
+				ctx.ui.setFooter((_tui, theme) => {
+					return {
+						render(width: number): string[] {
+							// Calculate usage from branch entries
+							let totalInput = 0;
+							let totalOutput = 0;
+							let totalCost = 0;
+							let lastAssistant: AssistantMessage | undefined;
+
+							for (const entry of ctx.sessionManager.getBranch()) {
+								if (entry.type === "message" && entry.message.role === "assistant") {
+									const msg = entry.message as AssistantMessage;
+									totalInput += msg.usage.input;
+									totalOutput += msg.usage.output;
+									totalCost += msg.usage.cost.total;
+									lastAssistant = msg;
+								}
+							}
+
+							// Context percentage from last assistant message
+							const contextTokens = lastAssistant
+								? lastAssistant.usage.input +
+									lastAssistant.usage.output +
+									lastAssistant.usage.cacheRead +
+									lastAssistant.usage.cacheWrite
+								: 0;
+							const contextWindow = ctx.model?.contextWindow || 0;
+							const contextPercent = contextWindow > 0 ? (contextTokens / contextWindow) * 100 : 0;
+
+							// Format tokens
+							const fmt = (n: number) => (n < 1000 ? `${n}` : `${(n / 1000).toFixed(1)}k`);
+
+							// Build footer line
+							const left = [
+								theme.fg("dim", `↑${fmt(totalInput)}`),
+								theme.fg("dim", `↓${fmt(totalOutput)}`),
+								theme.fg("dim", `$${totalCost.toFixed(3)}`),
+							].join(" ");
+
+							// Color context percentage based on usage
+							let contextStr = `${contextPercent.toFixed(1)}%`;
+							if (contextPercent > 90) {
+								contextStr = theme.fg("error", contextStr);
+							} else if (contextPercent > 70) {
+								contextStr = theme.fg("warning", contextStr);
+							} else {
+								contextStr = theme.fg("success", contextStr);
+							}
+
+							const right = `${contextStr} ${theme.fg("dim", ctx.model?.id || "no model")}`;
+							const padding = " ".repeat(Math.max(1, width - visibleWidth(left) - visibleWidth(right)));
+
+							return [truncateToWidth(left + padding + right, width)];
+						},
+						invalidate() {},
+					};
+				});
+				ctx.ui.notify("Custom footer enabled", "info");
+			} else {
+				ctx.ui.setFooter(undefined);
+				ctx.ui.notify("Built-in footer restored", "info");
+			}
+		},
+	});
+}

package/examples/extensions/custom-header.ts

@@ -0,0 +1,72 @@
+/**
+ * Custom Header Extension
+ *
+ * Demonstrates ctx.ui.setHeader() for replacing the built-in header
+ * (logo + keybinding hints) with a custom component showing the pi mascot.
+ */
+
+import type { ExtensionAPI, Theme } from "@mariozechner/pi-coding-agent";
+
+// --- PI MASCOT ---
+// Based on pi_mascot.ts - the pi agent character
+function getPiMascot(theme: Theme): string[] {
+	// --- COLORS ---
+	// 3b1b Blue: R=80, G=180, B=230
+	const piBlue = (text: string) => theme.fg("accent", text);
+	const white = (text: string) => text; // Use plain white (or theme.fg("text", text))
+	const black = (text: string) => theme.fg("dim", text); // Use dim for contrast
+
+	// --- GLYPHS ---
+	const BLOCK = "█";
+	const PUPIL = "▌"; // Vertical half-block for the pupil
+
+	// --- CONSTRUCTION ---
+
+	// 1. The Eye Unit: [White Full Block][Black Vertical Sliver]
+	// This creates the "looking sideways" effect
+	const eye = `${white(BLOCK)}${black(PUPIL)}`;
+
+	// 2. Line 1: The Eyes
+	// 5 spaces indent aligns them with the start of the legs
+	const lineEyes = `     ${eye}  ${eye}`;
+
+	// 3. Line 2: The Wide Top Bar (The "Overhang")
+	// 14 blocks wide for that serif-style roof
+	const lineBar = `  ${piBlue(BLOCK.repeat(14))}`;
+
+	// 4. Lines 3-6: The Legs
+	// Indented 5 spaces relative to the very left edge
+	// Leg width: 2 blocks | Gap: 4 blocks
+	const lineLeg = `     ${piBlue(BLOCK.repeat(2))}    ${piBlue(BLOCK.repeat(2))}`;
+
+	// --- ASSEMBLY ---
+	return ["", lineEyes, lineBar, lineLeg, lineLeg, lineLeg, lineLeg, ""];
+}
+
+export default function (pi: ExtensionAPI) {
+	// Set custom header immediately on load (if UI is available)
+	pi.on("session_start", async (_event, ctx) => {
+		if (ctx.hasUI) {
+			ctx.ui.setHeader((_tui, theme) => {
+				return {
+					render(_width: number): string[] {
+						const mascotLines = getPiMascot(theme);
+						// Add a subtitle with hint
+						const subtitle = theme.fg("muted", "   shitty coding agent");
+						return [...mascotLines, subtitle];
+					},
+					invalidate() {},
+				};
+			});
+		}
+	});
+
+	// Command to restore built-in header
+	pi.registerCommand("builtin-header", {
+		description: "Restore built-in header with keybinding hints",
+		handler: async (_args, ctx) => {
+			ctx.ui.setHeader(undefined);
+			ctx.ui.notify("Built-in header restored", "info");
+		},
+	});
+}

package/examples/extensions/send-user-message.ts

@@ -0,0 +1,97 @@
+/**
+ * Send User Message Example
+ *
+ * Demonstrates pi.sendUserMessage() for sending user messages from extensions.
+ * Unlike pi.sendMessage() which sends custom messages, sendUserMessage() sends
+ * actual user messages that appear in the conversation as if typed by the user.
+ *
+ * Usage:
+ *   /ask What is 2+2?     - Sends a user message (always triggers a turn)
+ *   /steer Focus on X     - Sends while streaming with steer delivery
+ *   /followup And then?   - Sends while streaming with followUp delivery
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+
+export default function (pi: ExtensionAPI) {
+	// Simple command that sends a user message
+	pi.registerCommand("ask", {
+		description: "Send a user message to the agent",
+		handler: async (args, ctx) => {
+			if (!args.trim()) {
+				ctx.ui.notify("Usage: /ask <message>", "warning");
+				return;
+			}
+
+			// sendUserMessage always triggers a turn when not streaming
+			// If streaming, it will throw (no deliverAs specified)
+			if (!ctx.isIdle()) {
+				ctx.ui.notify("Agent is busy. Use /steer or /followup instead.", "warning");
+				return;
+			}
+
+			pi.sendUserMessage(args);
+		},
+	});
+
+	// Command that steers the agent mid-conversation
+	pi.registerCommand("steer", {
+		description: "Send a steering message (interrupts current processing)",
+		handler: async (args, ctx) => {
+			if (!args.trim()) {
+				ctx.ui.notify("Usage: /steer <message>", "warning");
+				return;
+			}
+
+			if (ctx.isIdle()) {
+				// Not streaming, just send normally
+				pi.sendUserMessage(args);
+			} else {
+				// Streaming - use steer to interrupt
+				pi.sendUserMessage(args, { deliverAs: "steer" });
+			}
+		},
+	});
+
+	// Command that queues a follow-up message
+	pi.registerCommand("followup", {
+		description: "Queue a follow-up message (waits for current processing)",
+		handler: async (args, ctx) => {
+			if (!args.trim()) {
+				ctx.ui.notify("Usage: /followup <message>", "warning");
+				return;
+			}
+
+			if (ctx.isIdle()) {
+				// Not streaming, just send normally
+				pi.sendUserMessage(args);
+			} else {
+				// Streaming - queue as follow-up
+				pi.sendUserMessage(args, { deliverAs: "followUp" });
+				ctx.ui.notify("Follow-up queued", "info");
+			}
+		},
+	});
+
+	// Example with content array (text + images would go here)
+	pi.registerCommand("askwith", {
+		description: "Send a user message with structured content",
+		handler: async (args, ctx) => {
+			if (!args.trim()) {
+				ctx.ui.notify("Usage: /askwith <message>", "warning");
+				return;
+			}
+
+			if (!ctx.isIdle()) {
+				ctx.ui.notify("Agent is busy", "warning");
+				return;
+			}
+
+			// sendUserMessage accepts string or (TextContent | ImageContent)[]
+			pi.sendUserMessage([
+				{ type: "text", text: `User request: ${args}` },
+				{ type: "text", text: "Please respond concisely." },
+			]);
+		},
+	});
+}

package/examples/extensions/with-deps/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pi-extension-with-deps",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pi-extension-with-deps",
-      "version": "1.1.2",
+      "version": "1.1.4",
       "dependencies": {
         "ms": "^2.1.3"
       },

package/examples/extensions/with-deps/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-extension-with-deps",
   "private": true,
-  "version": "1.1.2",
+  "version": "1.1.4",
   "type": "module",
   "scripts": {
     "clean": "echo 'nothing to clean'",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-coding-agent",
-	"version": "0.37.2",
+	"version": "0.37.4",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -39,9 +39,9 @@
 	},
 	"dependencies": {
 		"@crosscopy/clipboard": "^0.2.8",
-		"@mariozechner/pi-agent-core": "^0.37.2",
-		"@mariozechner/pi-ai": "^0.37.2",
-		"@mariozechner/pi-tui": "^0.37.2",
+		"@mariozechner/pi-agent-core": "^0.37.4",
+		"@mariozechner/pi-ai": "^0.37.4",
+		"@mariozechner/pi-tui": "^0.37.4",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",
 		"diff": "^8.0.2",
@@ -49,6 +49,7 @@
 		"glob": "^11.0.3",
 		"jiti": "^2.6.1",
 		"marked": "^15.0.12",
+		"minimatch": "^10.1.1",
 		"proper-lockfile": "^4.1.2",
 		"sharp": "^0.34.2"
 	},