@mariozechner/pi-coding-agent 0.34.1 → 0.35.0

package/examples/hooks/todo/index.ts

@@ -1,134 +0,0 @@
-/**
- * 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 { matchesKey, 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 (matchesKey(data, "escape") || matchesKey(data, "ctrl+c")) {
-			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/examples/sdk/06-hooks.ts

@@ -1,61 +0,0 @@
-/**
- * Hooks Configuration
- *
- * Hooks intercept agent events for logging, blocking, or modification.
- */
-
-import { createAgentSession, type HookFactory, SessionManager } from "@mariozechner/pi-coding-agent";
-
-// Logging hook
-const loggingHook: HookFactory = (api) => {
-	api.on("agent_start", async () => {
-		console.log("[Hook] Agent starting");
-	});
-
-	api.on("tool_call", async (event) => {
-		console.log(`[Hook] Tool: ${event.toolName}`);
-		return undefined; // Don't block
-	});
-
-	api.on("agent_end", async (event) => {
-		console.log(`[Hook] Done, ${event.messages.length} messages`);
-	});
-};
-
-// Blocking hook (returns { block: true, reason: "..." })
-const safetyHook: HookFactory = (api) => {
-	api.on("tool_call", async (event) => {
-		if (event.toolName === "bash") {
-			const cmd = (event.input as { command?: string }).command ?? "";
-			if (cmd.includes("rm -rf")) {
-				return { block: true, reason: "Dangerous command blocked" };
-			}
-		}
-		return undefined;
-	});
-};
-
-// Use inline hooks
-const { session } = await createAgentSession({
-	hooks: [{ factory: loggingHook }, { factory: safetyHook }],
-	sessionManager: SessionManager.inMemory(),
-});
-
-session.subscribe((event) => {
-	if (event.type === "message_update" && event.assistantMessageEvent.type === "text_delta") {
-		process.stdout.write(event.assistantMessageEvent.delta);
-	}
-});
-
-await session.prompt("List files in the current directory.");
-console.log();
-
-// Disable all hooks:
-// hooks: []
-
-// Merge with discovered hooks:
-// const discovered = await discoverHooks();
-// hooks: [...discovered, { factory: myHook }]
-
-// Add paths without replacing discovery:
-// additionalHookPaths: ["/extra/hooks"]

package/examples/sdk/08-slash-commands.ts

@@ -1,42 +0,0 @@
-/**
- * Slash Commands
- *
- * File-based commands that inject content when invoked with /commandname.
- */
-
-import {
-	createAgentSession,
-	discoverSlashCommands,
-	type FileSlashCommand,
-	SessionManager,
-} from "@mariozechner/pi-coding-agent";
-
-// Discover commands from cwd/.pi/commands/ and ~/.pi/agent/commands/
-const discovered = discoverSlashCommands();
-console.log("Discovered slash commands:");
-for (const cmd of discovered) {
-	console.log(`  /${cmd.name}: ${cmd.description}`);
-}
-
-// Define custom commands
-const deployCommand: FileSlashCommand = {
-	name: "deploy",
-	description: "Deploy the application",
-	source: "(custom)",
-	content: `# Deploy Instructions
-
-1. Build: npm run build
-2. Test: npm test
-3. Deploy: npm run deploy`,
-};
-
-// Use discovered + custom commands
-await createAgentSession({
-	slashCommands: [...discovered, deployCommand],
-	sessionManager: SessionManager.inMemory(),
-});
-
-console.log(`Session created with ${discovered.length + 1} slash commands`);
-
-// Disable slash commands:
-// slashCommands: []