@mariozechner/pi-coding-agent 0.31.1 → 0.32.0

package/examples/hooks/file-trigger.ts

@@ -25,7 +25,7 @@ export default function (pi: HookAPI) {
 							content: `External trigger: ${content}`,
 							display: true,
 						},
-						true, // triggerTurn - get LLM to respond
+						{ triggerTurn: true }, // triggerTurn - get LLM to respond
 					);
 					fs.writeFileSync(triggerFile, ""); // Clear after reading
 				}

package/examples/hooks/todo/index.ts

@@ -0,0 +1,134 @@
+/**
+ * Todo Hook - Companion to the todo custom tool
+ *
+ * Registers a /todos command that displays all todos on the current branch
+ * with a nice custom UI.
+ */
+
+import type { HookAPI, Theme } from "@mariozechner/pi-coding-agent";
+import { isCtrlC, isEscape, truncateToWidth } from "@mariozechner/pi-tui";
+
+interface Todo {
+	id: number;
+	text: string;
+	done: boolean;
+}
+
+interface TodoDetails {
+	action: "list" | "add" | "toggle" | "clear";
+	todos: Todo[];
+	nextId: number;
+	error?: string;
+}
+
+class TodoListComponent {
+	private todos: Todo[];
+	private theme: Theme;
+	private onClose: () => void;
+	private cachedWidth?: number;
+	private cachedLines?: string[];
+
+	constructor(todos: Todo[], theme: Theme, onClose: () => void) {
+		this.todos = todos;
+		this.theme = theme;
+		this.onClose = onClose;
+	}
+
+	handleInput(data: string): void {
+		if (isEscape(data) || isCtrlC(data)) {
+			this.onClose();
+		}
+	}
+
+	render(width: number): string[] {
+		if (this.cachedLines && this.cachedWidth === width) {
+			return this.cachedLines;
+		}
+
+		const lines: string[] = [];
+		const th = this.theme;
+
+		// Header
+		lines.push("");
+		const title = th.fg("accent", " Todos ");
+		const headerLine =
+			th.fg("borderMuted", "─".repeat(3)) + title + th.fg("borderMuted", "─".repeat(Math.max(0, width - 10)));
+		lines.push(truncateToWidth(headerLine, width));
+		lines.push("");
+
+		if (this.todos.length === 0) {
+			lines.push(truncateToWidth(`  ${th.fg("dim", "No todos yet. Ask the agent to add some!")}`, width));
+		} else {
+			// Stats
+			const done = this.todos.filter((t) => t.done).length;
+			const total = this.todos.length;
+			const statsText = `  ${th.fg("muted", `${done}/${total} completed`)}`;
+			lines.push(truncateToWidth(statsText, width));
+			lines.push("");
+
+			// Todo items
+			for (const todo of this.todos) {
+				const check = todo.done ? th.fg("success", "✓") : th.fg("dim", "○");
+				const id = th.fg("accent", `#${todo.id}`);
+				const text = todo.done ? th.fg("dim", todo.text) : th.fg("text", todo.text);
+				const line = `  ${check} ${id} ${text}`;
+				lines.push(truncateToWidth(line, width));
+			}
+		}
+
+		lines.push("");
+		lines.push(truncateToWidth(`  ${th.fg("dim", "Press Escape to close")}`, width));
+		lines.push("");
+
+		this.cachedWidth = width;
+		this.cachedLines = lines;
+		return lines;
+	}
+
+	invalidate(): void {
+		this.cachedWidth = undefined;
+		this.cachedLines = undefined;
+	}
+}
+
+export default function (pi: HookAPI) {
+	/**
+	 * Reconstruct todos from session entries on the current branch.
+	 */
+	function getTodos(ctx: {
+		sessionManager: {
+			getBranch: () => Array<{ type: string; message?: { role?: string; toolName?: string; details?: unknown } }>;
+		};
+	}): Todo[] {
+		let todos: Todo[] = [];
+
+		for (const entry of ctx.sessionManager.getBranch()) {
+			if (entry.type !== "message") continue;
+			const msg = entry.message;
+			if (!msg || msg.role !== "toolResult" || msg.toolName !== "todo") continue;
+
+			const details = msg.details as TodoDetails | undefined;
+			if (details) {
+				todos = details.todos;
+			}
+		}
+
+		return todos;
+	}
+
+	pi.registerCommand("todos", {
+		description: "Show all todos on the current branch",
+		handler: async (_args, ctx) => {
+			if (!ctx.hasUI) {
+				ctx.ui.notify("/todos requires interactive mode", "error");
+				return;
+			}
+
+			const todos = getTodos(ctx);
+
+			await ctx.ui.custom<void>((_tui, theme, done) => {
+				return new TodoListComponent(todos, theme, () => done());
+			});
+		},
+	});
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-coding-agent",
-	"version": "0.31.1",
+	"version": "0.32.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -38,16 +38,17 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@mariozechner/pi-agent-core": "^0.31.1",
-		"@mariozechner/pi-ai": "^0.31.1",
-		"@mariozechner/pi-tui": "^0.31.1",
+		"@mariozechner/pi-agent-core": "^0.32.0",
+		"@mariozechner/pi-ai": "^0.32.0",
+		"@mariozechner/pi-tui": "^0.32.0",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",
 		"diff": "^8.0.2",
 		"file-type": "^21.1.1",
 		"glob": "^11.0.3",
 		"jiti": "^2.6.1",
-		"marked": "^15.0.12"
+		"marked": "^15.0.12",
+		"sharp": "^0.34.2"
 	},
 	"devDependencies": {
 		"@types/diff": "^7.0.2",

package/dist/modes/interactive/components/queue-mode-selector.d.ts

@@ -1,10 +0,0 @@
-import { Container, SelectList } from "@mariozechner/pi-tui";
-/**
- * Component that renders a queue mode selector with borders
- */
-export declare class QueueModeSelectorComponent extends Container {
-    private selectList;
-    constructor(currentMode: "all" | "one-at-a-time", onSelect: (mode: "all" | "one-at-a-time") => void, onCancel: () => void);
-    getSelectList(): SelectList;
-}
-//# sourceMappingURL=queue-mode-selector.d.ts.map

package/dist/modes/interactive/components/queue-mode-selector.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-mode-selector.d.ts","sourceRoot":"","sources":["../../../../src/modes/interactive/components/queue-mode-selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAI9E;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,SAAS;IACxD,OAAO,CAAC,UAAU,CAAa;IAE/B,YACC,WAAW,EAAE,KAAK,GAAG,eAAe,EACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,KAAK,GAAG,eAAe,KAAK,IAAI,EACjD,QAAQ,EAAE,MAAM,IAAI,EAqCpB;IAED,aAAa,IAAI,UAAU,CAE1B;CACD","sourcesContent":["import { Container, type SelectItem, SelectList } from \"@mariozechner/pi-tui\";\nimport { getSelectListTheme } from \"../theme/theme.js\";\nimport { DynamicBorder } from \"./dynamic-border.js\";\n\n/**\n * Component that renders a queue mode selector with borders\n */\nexport class QueueModeSelectorComponent extends Container {\n\tprivate selectList: SelectList;\n\n\tconstructor(\n\t\tcurrentMode: \"all\" | \"one-at-a-time\",\n\t\tonSelect: (mode: \"all\" | \"one-at-a-time\") => void,\n\t\tonCancel: () => void,\n\t) {\n\t\tsuper();\n\n\t\tconst queueModes: SelectItem[] = [\n\t\t\t{\n\t\t\t\tvalue: \"one-at-a-time\",\n\t\t\t\tlabel: \"one-at-a-time\",\n\t\t\t\tdescription: \"Process queued messages one by one (recommended)\",\n\t\t\t},\n\t\t\t{ value: \"all\", label: \"all\", description: \"Process all queued messages at once\" },\n\t\t];\n\n\t\t// Add top border\n\t\tthis.addChild(new DynamicBorder());\n\n\t\t// Create selector\n\t\tthis.selectList = new SelectList(queueModes, 2, getSelectListTheme());\n\n\t\t// Preselect current mode\n\t\tconst currentIndex = queueModes.findIndex((item) => item.value === currentMode);\n\t\tif (currentIndex !== -1) {\n\t\t\tthis.selectList.setSelectedIndex(currentIndex);\n\t\t}\n\n\t\tthis.selectList.onSelect = (item) => {\n\t\t\tonSelect(item.value as \"all\" | \"one-at-a-time\");\n\t\t};\n\n\t\tthis.selectList.onCancel = () => {\n\t\t\tonCancel();\n\t\t};\n\n\t\tthis.addChild(this.selectList);\n\n\t\t// Add bottom border\n\t\tthis.addChild(new DynamicBorder());\n\t}\n\n\tgetSelectList(): SelectList {\n\t\treturn this.selectList;\n\t}\n}\n"]}

package/dist/modes/interactive/components/queue-mode-selector.js

@@ -1,42 +0,0 @@
-import { Container, SelectList } from "@mariozechner/pi-tui";
-import { getSelectListTheme } from "../theme/theme.js";
-import { DynamicBorder } from "./dynamic-border.js";
-/**
- * Component that renders a queue mode selector with borders
- */
-export class QueueModeSelectorComponent extends Container {
-    selectList;
-    constructor(currentMode, onSelect, onCancel) {
-        super();
-        const queueModes = [
-            {
-                value: "one-at-a-time",
-                label: "one-at-a-time",
-                description: "Process queued messages one by one (recommended)",
-            },
-            { value: "all", label: "all", description: "Process all queued messages at once" },
-        ];
-        // Add top border
-        this.addChild(new DynamicBorder());
-        // Create selector
-        this.selectList = new SelectList(queueModes, 2, getSelectListTheme());
-        // Preselect current mode
-        const currentIndex = queueModes.findIndex((item) => item.value === currentMode);
-        if (currentIndex !== -1) {
-            this.selectList.setSelectedIndex(currentIndex);
-        }
-        this.selectList.onSelect = (item) => {
-            onSelect(item.value);
-        };
-        this.selectList.onCancel = () => {
-            onCancel();
-        };
-        this.addChild(this.selectList);
-        // Add bottom border
-        this.addChild(new DynamicBorder());
-    }
-    getSelectList() {
-        return this.selectList;
-    }
-}
-//# sourceMappingURL=queue-mode-selector.js.map

package/dist/modes/interactive/components/queue-mode-selector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue-mode-selector.js","sourceRoot":"","sources":["../../../../src/modes/interactive/components/queue-mode-selector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAmB,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,SAAS;IAChD,UAAU,CAAa;IAE/B,YACC,WAAoC,EACpC,QAAiD,EACjD,QAAoB,EACnB;QACD,KAAK,EAAE,CAAC;QAER,MAAM,UAAU,GAAiB;YAChC;gBACC,KAAK,EAAE,eAAe;gBACtB,KAAK,EAAE,eAAe;gBACtB,WAAW,EAAE,kDAAkD;aAC/D;YACD,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,qCAAqC,EAAE;SAClF,CAAC;QAEF,iBAAiB;QACjB,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;QAEnC,kBAAkB;QAClB,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAEtE,yBAAyB;QACzB,MAAM,YAAY,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,CAAC;QAChF,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC,KAAgC,CAAC,CAAC;QAAA,CAChD,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC;YAChC,QAAQ,EAAE,CAAC;QAAA,CACX,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAE/B,oBAAoB;QACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,aAAa,EAAE,CAAC,CAAC;IAAA,CACnC;IAED,aAAa,GAAe;QAC3B,OAAO,IAAI,CAAC,UAAU,CAAC;IAAA,CACvB;CACD","sourcesContent":["import { Container, type SelectItem, SelectList } from \"@mariozechner/pi-tui\";\nimport { getSelectListTheme } from \"../theme/theme.js\";\nimport { DynamicBorder } from \"./dynamic-border.js\";\n\n/**\n * Component that renders a queue mode selector with borders\n */\nexport class QueueModeSelectorComponent extends Container {\n\tprivate selectList: SelectList;\n\n\tconstructor(\n\t\tcurrentMode: \"all\" | \"one-at-a-time\",\n\t\tonSelect: (mode: \"all\" | \"one-at-a-time\") => void,\n\t\tonCancel: () => void,\n\t) {\n\t\tsuper();\n\n\t\tconst queueModes: SelectItem[] = [\n\t\t\t{\n\t\t\t\tvalue: \"one-at-a-time\",\n\t\t\t\tlabel: \"one-at-a-time\",\n\t\t\t\tdescription: \"Process queued messages one by one (recommended)\",\n\t\t\t},\n\t\t\t{ value: \"all\", label: \"all\", description: \"Process all queued messages at once\" },\n\t\t];\n\n\t\t// Add top border\n\t\tthis.addChild(new DynamicBorder());\n\n\t\t// Create selector\n\t\tthis.selectList = new SelectList(queueModes, 2, getSelectListTheme());\n\n\t\t// Preselect current mode\n\t\tconst currentIndex = queueModes.findIndex((item) => item.value === currentMode);\n\t\tif (currentIndex !== -1) {\n\t\t\tthis.selectList.setSelectedIndex(currentIndex);\n\t\t}\n\n\t\tthis.selectList.onSelect = (item) => {\n\t\t\tonSelect(item.value as \"all\" | \"one-at-a-time\");\n\t\t};\n\n\t\tthis.selectList.onCancel = () => {\n\t\t\tonCancel();\n\t\t};\n\n\t\tthis.addChild(this.selectList);\n\n\t\t// Add bottom border\n\t\tthis.addChild(new DynamicBorder());\n\t}\n\n\tgetSelectList(): SelectList {\n\t\treturn this.selectList;\n\t}\n}\n"]}