Change branch() to use entryId instead of entryIndex

- AgentSession.branch(entryId: string) now takes entry ID
- SessionBeforeBranchEvent.entryId replaces entryIndex
- getUserMessagesForBranching() returns entryId
- Update RPC types and client
- Update UserMessageSelectorComponent
- Update hook examples and tests
- Update docs (hooks.md, sdk.md)

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

@@ -45,7 +45,7 @@ export default function (pi: HookAPI) {
 	pi.on("session_before_branch", async (event, ctx) => {
 		if (!ctx.hasUI) return;
 
-		const choice = await ctx.ui.select(`Branch from turn ${event.entryIndex}?`, [
+		const choice = await ctx.ui.select(`Branch from entry ${event.entryId.slice(0, 8)}?`, [
 			"Yes, create branch",
 			"No, stay in current session",
 		]);

packages/coding-agent/examples/hooks/git-checkpoint.ts

@@ -8,19 +8,26 @@
 import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
 
 export default function (pi: HookAPI) {
-	const checkpoints = new Map<number, string>();
+	const checkpoints = new Map<string, string>();
+	let currentEntryId: string | undefined;
 
-	pi.on("turn_start", async (event) => {
+	// Track the current entry ID when user messages are saved
+	pi.on("tool_result", async (_event, ctx) => {
+		const leaf = ctx.sessionManager.getLeafEntry();
+		if (leaf) currentEntryId = leaf.id;
+	});
+
+	pi.on("turn_start", async () => {
 		// Create a git stash entry before LLM makes changes
 		const { stdout } = await pi.exec("git", ["stash", "create"]);
 		const ref = stdout.trim();
-		if (ref) {
-			checkpoints.set(event.turnIndex, ref);
+		if (ref && currentEntryId) {
+			checkpoints.set(currentEntryId, ref);
 		}
 	});
 
 	pi.on("session_before_branch", async (event, ctx) => {
-		const ref = checkpoints.get(event.entryIndex);
+		const ref = checkpoints.get(event.entryId);
 		if (!ref) return;
 
 		if (!ctx.hasUI) {