co-mono/packages/coding-agent/examples/hooks/confirm-destructive.ts

/**
 * Confirm Destructive Actions Hook
 *
 * Prompts for confirmation before destructive session actions (clear, switch, branch).
 * Demonstrates how to cancel session events using the before_* events.
 */

import type { SessionMessageEntry } from "@mariozechner/pi-coding-agent";
import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";

export default function (pi: HookAPI) {
	pi.on("session_before_new", async (_event, ctx) => {
		if (!ctx.hasUI) return;

		const confirmed = await ctx.ui.confirm("Clear session?", "This will delete all messages in the current session.");

		if (!confirmed) {
			ctx.ui.notify("Clear cancelled", "info");
			return { cancel: true };
		}
	});

	pi.on("session_before_switch", async (_event, ctx) => {
		if (!ctx.hasUI) return;

		// Check if there are unsaved changes (messages since last assistant response)
		const entries = ctx.sessionManager.getEntries();
		const hasUnsavedWork = entries.some(
			(e): e is SessionMessageEntry => e.type === "message" && e.message.role === "user",
		);

		if (hasUnsavedWork) {
			const confirmed = await ctx.ui.confirm(
				"Switch session?",
				"You have messages in the current session. Switch anyway?",
			);

			if (!confirmed) {
				ctx.ui.notify("Switch cancelled", "info");
				return { cancel: true };
			}
		}
	});

	pi.on("session_before_branch", async (event, ctx) => {
		if (!ctx.hasUI) return;

		const choice = await ctx.ui.select(`Branch from entry ${event.entryId.slice(0, 8)}?`, [
			"Yes, create branch",
			"No, stay in current session",
		]);

		if (choice !== "Yes, create branch") {
			ctx.ui.notify("Branch cancelled", "info");
			return { cancel: true };
		}
	});
}