@ferris1225/pi-subagents 4.1.16 → 4.1.18

package/README.md

@@ -71,7 +71,7 @@ the main agent automatically; there is no polling loop.
 
 ## Quick start
 
-Requires **pi >= 0.83.0** and **Node.js >= 22.19.0**.
+Requires **pi >= 0.84.4** and **Node.js >= 22.19.0**.
 
 ```bash
 pi install npm:@ferris1225/pi-subagents
@@ -197,7 +197,7 @@ Every dispatch returns a stable `#id` — the handle for all control tools:
 | `subagent_control` | `resume` a parked/settled thread with its full retained context, optionally with a new `objective` appended. Only interrupted (parked) threads survive a reload. |
 | `subagent_status`  | List active and recent runs, or return one run's full result and failed-tool diagnostics.                                                                        |
 | `subagent_wait`    | Non-blocking in-turn lookup; `timeoutMs` only when you must wait.                                                                                                |
-| `subagent_stop`    | Destructively cancel, deliver the partial output, retire the thread.                                                                                             |
+| `subagent_stop`    | Destructively cancel, deliver the partial output, retire the thread. Stopping also drops any steering/follow-up messages still queued in the child so a stopped or later resumed thread cannot be revived by stale queue entries.      |
 
 ```ts
 subagent_control({ action: "resume", id: 7, objective: "Finish the tests." });
@@ -205,8 +205,10 @@ subagent_control({ action: "resume", id: 7, objective: "Finish the tests." });
 
 Threads are durable while work is unfinished: parked sessions, worktree
 checkpoints, and result excerpts live under
-`~/.pi/agent/ferris-pi-subagents/<project>/` (grouped per project; not the OS
-temp directory) and are restored when pi reloads or restarts — a reload
+`~/.pi/agent/ferris-pi-subagents/<project>/` (grouped per project; nothing is
+written to the OS temp directory — transient per-run scratch lives in the
+project's `tmp/` and is swept for dead owners on the next load) and are
+restored when pi reloads or restarts — a reload
 interrupts a live run into a restorable checkpoint instead of losing it. A
 thread that completes or fails cleanly drops its durable record, so the
 threads manifest exists only
@@ -292,6 +294,8 @@ config-file only, stored at
 Invalid values fall back safely; stale keys (including the former
 `maxConcurrency`/`maxFixRounds` knobs) are dropped automatically. At session
 start, model overrides Pi no longer reports are removed with a one-time notice.
+When pi's own session compaction fails mid-thread, a notice surfaces the error
+(and the automatic retry) instead of failing silently.
 
 ## Custom agents
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferris1225/pi-subagents",
-  "version": "4.1.16",
+  "version": "4.1.18",
   "description": "A managed sub-agent team for pi: specialized roles, pre-commit documentation sync, retained threads, auto-fix chains, model fallback, and Git worktree isolation.",
   "type": "module",
   "license": "MIT",
@@ -33,17 +33,17 @@
     "prepack": "npm run check && npm test"
   },
   "peerDependencies": {
-    "@earendil-works/pi-agent-core": ">=0.83.0",
-    "@earendil-works/pi-ai": ">=0.83.0",
-    "@earendil-works/pi-coding-agent": ">=0.83.0",
-    "@earendil-works/pi-tui": ">=0.83.0",
+    "@earendil-works/pi-agent-core": ">=0.84.4",
+    "@earendil-works/pi-ai": ">=0.84.4",
+    "@earendil-works/pi-coding-agent": ">=0.84.4",
+    "@earendil-works/pi-tui": ">=0.84.4",
     "typebox": "*"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "^0.83.0",
-    "@earendil-works/pi-ai": "^0.83.0",
-    "@earendil-works/pi-coding-agent": "^0.83.0",
-    "@earendil-works/pi-tui": "^0.83.0",
+    "@earendil-works/pi-agent-core": "^0.84.4",
+    "@earendil-works/pi-ai": "^0.84.4",
+    "@earendil-works/pi-coding-agent": "^0.84.4",
+    "@earendil-works/pi-tui": "^0.84.4",
     "@types/node": "^22.10.0",
     "typebox": "^1.3.9",
     "typescript": "^5.9.0",

package/src/announcements.ts

@@ -56,4 +56,20 @@ export function registerAnnouncements(pi: ExtensionAPI, runtime: SubagentRuntime
 		if (ctx.mode !== "tui") return;
 		installActiveRunsWidget(ctx);
 	});
+
+	// Compaction failures are otherwise silent in long orchestration sessions
+	// where subagent results accumulate; aborted (user-cancelled) compactions
+	// are deliberate and not worth a notice.
+	pi.on("session_compact_failed", async (event, ctx) => {
+		if (event.aborted && !event.errorMessage) return;
+		const detail = event.errorMessage ? `: ${event.errorMessage}` : "";
+		if (event.willRetry) {
+			ctx.ui.notify(`pi-subagents: session compaction failed${detail} — retrying automatically.`, "warning");
+			return;
+		}
+		ctx.ui.notify(
+			`pi-subagents: session compaction failed${detail}. Long threads may hit context limits soon; run /compact to retry or trim old results.`,
+			"error",
+		);
+	});
 }

package/src/dispatch.ts

@@ -251,6 +251,7 @@ export function registerSubagentTool(pi: ExtensionAPI, runtime: SubagentRuntime)
 			...(request.worktreeId ? { worktreeId: request.worktreeId } : {}),
 		});
 		const onLive = makeLiveHandler(runId);
+		const projectRoot = getProjectRoot(runtime.configPath, request.executionCwd);
 		try {
 			const result = await runSingleAgentWithMainFallback(
 				{
@@ -266,7 +267,8 @@ export function registerSubagentTool(pi: ExtensionAPI, runtime: SubagentRuntime)
 					onLive,
 					makeDetails: makeDetails("single", true),
 					idleTimeoutMs: stageConfig.idleTimeoutSec * 1000,
-					sessionRoot: join(getProjectRoot(runtime.configPath, request.executionCwd), "sessions"),
+					sessionRoot: join(projectRoot, "sessions"),
+					scratchRoot: join(projectRoot, "tmp"),
 					...(stage.session
 						? { sessionId: stage.session.sessionId, sessionDir: stage.session.sessionDir, stdinText: task }
 						: {}),
@@ -407,7 +409,7 @@ export function registerSubagentTool(pi: ExtensionAPI, runtime: SubagentRuntime)
 						? { sessionId: gateReview.sessionId, sessionDir: gateReview.sessionDir }
 						: undefined;
 					if (reviewVerdict(getResultOutput(gateReview)) !== "fail" || !gateSession || !canContinue()) break;
-					const fixStage: WorkflowStage = { agent: "reviewer", relation: "fix", status: "pending" };
+					const fixStage: WorkflowStage = { agent: "reviewer", relation: "review fix", status: "pending" };
 					workflowStages.push(fixStage);
 					publishWorkflowStages();
 					const fixResult = await launchStep(