@mariozechner/pi-coding-agent 0.18.0 → 0.18.2

package/docs/hooks.md

@@ -11,6 +11,14 @@ Hooks are automatically discovered from two locations:
 
 All `.ts` files in these directories are loaded automatically. Project hooks let you define project-specific behavior (similar to `.pi/AGENTS.md`).
 
+You can also load a specific hook file directly using the `--hook` flag:
+
+```bash
+pi --hook ./my-hook.ts
+```
+
+This is useful for testing hooks without placing them in the standard directories.
+
 ### Additional Configuration
 
 You can also add explicit hook paths in `~/.pi/agent/settings.json`:
@@ -114,8 +122,8 @@ Fired when session changes (`/branch` or session switch).
 
 ```typescript
 pi.on("session_switch", async (event, ctx) => {
-  // event.newSessionFile: string
-  // event.previousSessionFile: string
+  // event.newSessionFile: string | null (null in --no-session mode)
+  // event.previousSessionFile: string | null (null in --no-session mode)
   // event.reason: "branch" | "switch"
 });
 ```

package/docs/rpc.md

@@ -303,6 +303,34 @@ Response:
 {"type": "response", "command": "set_auto_compaction", "success": true}
 ```
 
+### Retry
+
+#### set_auto_retry
+
+Enable or disable automatic retry on transient errors (overloaded, rate limit, 5xx).
+
+```json
+{"type": "set_auto_retry", "enabled": true}
+```
+
+Response:
+```json
+{"type": "response", "command": "set_auto_retry", "success": true}
+```
+
+#### abort_retry
+
+Abort an in-progress retry (cancel the delay and stop retrying).
+
+```json
+{"type": "abort_retry"}
+```
+
+Response:
+```json
+{"type": "response", "command": "abort_retry", "success": true}
+```
+
 ### Bash
 
 #### bash
@@ -528,6 +556,8 @@ Events are streamed to stdout as JSON lines during agent operation. Events do NO
 | `tool_execution_end` | Tool completes |
 | `auto_compaction_start` | Auto-compaction begins |
 | `auto_compaction_end` | Auto-compaction completes |
+| `auto_retry_start` | Auto-retry begins (after transient error) |
+| `auto_retry_end` | Auto-retry completes (success or final failure) |
 
 ### agent_start
 
@@ -664,6 +694,38 @@ Emitted when automatic compaction runs (when context is nearly full).
 
 If compaction was aborted, `result` is `null` and `aborted` is `true`.
 
+### auto_retry_start / auto_retry_end
+
+Emitted when automatic retry is triggered after a transient error (overloaded, rate limit, 5xx).
+
+```json
+{
+  "type": "auto_retry_start",
+  "attempt": 1,
+  "maxAttempts": 3,
+  "delayMs": 2000,
+  "errorMessage": "529 {\"type\":\"error\",\"error\":{\"type\":\"overloaded_error\",\"message\":\"Overloaded\"}}"
+}
+```
+
+```json
+{
+  "type": "auto_retry_end",
+  "success": true,
+  "attempt": 2
+}
+```
+
+On final failure (max retries exceeded):
+```json
+{
+  "type": "auto_retry_end",
+  "success": false,
+  "attempt": 3,
+  "finalError": "529 overloaded_error: Overloaded"
+}
+```
+
 ## Error Handling
 
 Failed commands return a response with `success: false`:

package/package.json

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