@mariozechner/pi-coding-agent 0.28.0 → 0.29.0

package/docs/custom-tools.md

@@ -186,7 +186,7 @@ interface ToolSessionEvent {
   entries: SessionEntry[];      // All session entries
   sessionFile: string | null;   // Current session file
   previousSessionFile: string | null;  // Previous session file
-  reason: "start" | "switch" | "branch" | "clear";
+  reason: "start" | "switch" | "branch" | "new";
 }
 ```
 
@@ -194,7 +194,7 @@ interface ToolSessionEvent {
 - `start`: Initial session load on startup
 - `switch`: User switched to a different session (`/resume`)
 - `branch`: User branched from a previous message (`/branch`)
-- `clear`: User cleared the session (`/clear`)
+- `new`: User started a new session (`/new`)
 
 ### State Management Pattern
 
@@ -250,7 +250,7 @@ const factory: CustomToolFactory = (pi) => {
 This pattern ensures:
 - When user branches, state is correct for that point in history
 - When user switches sessions, state matches that session
-- When user clears, state resets
+- When user starts a new session, state resets
 
 ## Custom Rendering
 

package/docs/hooks.md

@@ -125,10 +125,10 @@ user switches session (/resume)
   ├─► session (reason: "before_switch", can cancel)
   └─► session (reason: "switch", AFTER switch)
 
-user clears session (/clear)
+user starts new session (/new)
   │
-  ├─► session (reason: "before_clear", can cancel)
-  └─► session (reason: "clear", AFTER clear)
+  ├─► session (reason: "before_new", can cancel)
+  └─► session (reason: "new", AFTER new session starts)
 
 context compaction (auto or /compact)
   │
@@ -151,12 +151,12 @@ pi.on("session", async (event, ctx) => {
   // event.entries: SessionEntry[] - all session entries
   // event.sessionFile: string | null - current session file (null with --no-session)
   // event.previousSessionFile: string | null - previous session file
-  // event.reason: "start" | "before_switch" | "switch" | "before_clear" | "clear" |
+  // event.reason: "start" | "before_switch" | "switch" | "before_new" | "new" |
   //               "before_branch" | "branch" | "before_compact" | "compact" | "shutdown"
   // event.targetTurnIndex: number - only for "before_branch" and "branch"
 
   // Cancel a before_* action:
-  if (event.reason === "before_clear") {
+  if (event.reason === "before_new") {
     return { cancel: true };
   }
 
@@ -171,7 +171,7 @@ pi.on("session", async (event, ctx) => {
 **Reasons:**
 - `start`: Initial session load on startup
 - `before_switch` / `switch`: User switched sessions (`/resume`)
-- `before_clear` / `clear`: User cleared the session (`/clear`)
+- `before_new` / `new`: User started a new session (`/new`)
 - `before_branch` / `branch`: User branched the session (`/branch`)
 - `before_compact` / `compact`: Context compaction (auto or `/compact`)
 - `shutdown`: Process is exiting (double Ctrl+C, Ctrl+D, or SIGTERM)
@@ -848,9 +848,9 @@ Session switch:
 
 Clear:
   -> AgentSession.reset()
-     -> hookRunner.emit({ type: "session", reason: "before_clear", ... })  # can cancel
-     -> [if not cancelled: clear happens]
-     -> hookRunner.emit({ type: "session", reason: "clear", ... })
+     -> hookRunner.emit({ type: "session", reason: "before_new", ... })  # can cancel
+     -> [if not cancelled: new session starts]
+     -> hookRunner.emit({ type: "session", reason: "new", ... })
 
 Shutdown (interactive mode):
   -> handleCtrlC() or handleCtrlD()

package/examples/hooks/confirm-destructive.ts

@@ -10,7 +10,7 @@ import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
 export default function (pi: HookAPI) {
 	pi.on("session", async (event, ctx) => {
 		// Only handle before_* events (the ones that can be cancelled)
-		if (event.reason === "before_clear") {
+		if (event.reason === "before_new") {
 			if (!ctx.hasUI) return;
 
 			const confirmed = await ctx.ui.confirm(

package/examples/hooks/dirty-repo-guard.ts

@@ -10,7 +10,7 @@ import type { HookAPI } from "@mariozechner/pi-coding-agent/hooks";
 export default function (pi: HookAPI) {
 	pi.on("session", async (event, ctx) => {
 		// Only guard destructive actions
-		if (event.reason !== "before_clear" && event.reason !== "before_switch" && event.reason !== "before_branch") {
+		if (event.reason !== "before_new" && event.reason !== "before_switch" && event.reason !== "before_branch") {
 			return;
 		}
 
@@ -36,11 +36,7 @@ export default function (pi: HookAPI) {
 		const changedFiles = stdout.trim().split("\n").filter(Boolean).length;
 
 		const action =
-			event.reason === "before_clear"
-				? "clear session"
-				: event.reason === "before_switch"
-					? "switch session"
-					: "branch";
+			event.reason === "before_new" ? "new session" : event.reason === "before_switch" ? "switch session" : "branch";
 
 		const choice = await ctx.ui.select(`You have ${changedFiles} uncommitted file(s). ${action} anyway?`, [
 			"Yes, proceed anyway",

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@mariozechner/pi-coding-agent",
-	"version": "0.28.0",
+	"version": "0.29.0",
 	"description": "Coding agent CLI with read, bash, edit, write tools and session management",
 	"type": "module",
 	"piConfig": {
@@ -38,9 +38,9 @@
 		"prepublishOnly": "npm run clean && npm run build"
 	},
 	"dependencies": {
-		"@mariozechner/pi-agent-core": "^0.28.0",
-		"@mariozechner/pi-ai": "^0.28.0",
-		"@mariozechner/pi-tui": "^0.28.0",
+		"@mariozechner/pi-agent-core": "^0.29.0",
+		"@mariozechner/pi-ai": "^0.29.0",
+		"@mariozechner/pi-tui": "^0.29.0",
 		"chalk": "^5.5.0",
 		"cli-highlight": "^2.1.11",
 		"diff": "^8.0.2",