@ferris1225/pi-subagents 2.0.2 → 2.1.0

package/README.md

@@ -338,9 +338,13 @@ parent does not `abort_retry` them — and only a settled model-level failure
 hands off to current main. This uses supported extension/RPC surfaces in Node
 and standalone/Bun builds, never rewrites global or project settings, and does
 not alter descendant tool environments. Tool/test failures stay on the same
-model because they are task failures, not model availability failures. Only a truly
-zero-activity process startup race can retry; an accepted prompt or any
-agent/turn/stream/tool activity forbids replay.
+model because they are task failures, not model availability failures. A child is
+probed with RPC `get_state` before the first prompt so the 30s command ACK clock
+does not include process boot. Only a zero-activity startup miss can retry — a
+silent fast exit, a `get_state` handshake timeout, or an initial prompt ACK
+timeout before any agent/turn/stream/tool activity. Those transport misses are
+not model-level failures and do not hand the task to the main window. An accepted
+prompt or any activity forbids replay.
 
 Auto thinking starts from the Agent's declared preference (`low` for `explore`,
 `high` for the other built-ins) and uses Pi's capability map to clamp it to the
@@ -425,12 +429,13 @@ npm run check
 npm test
 ```
 
-The source is modular: `dispatch.ts` (dispatch, controls, isolation, auto-fix),
+The source is modular: `dispatch.ts` (public dispatch contract + auto-fix),
+`thread-lifecycle.ts` (queued generations, resume/fork, and isolation settlement),
 `rpc-run.ts` / `spawn.ts` (persistent child transport + selected→main handoff),
 `worktree.ts` / `session-fork.ts` (filesystem/session branching), `tools.ts`
 (wait/status/control/stop), `widget.ts` (active-only TUI status), `announcements.ts`
-(recovery and feature notices), and `runtime.ts` (session-scoped ownership). No runtime dependencies beyond pi peer
-dependencies.
+(recovery and feature notices), and `runtime.ts` (session-scoped ownership). No runtime
+dependencies beyond pi peer dependencies.
 
 ## License
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferris1225/pi-subagents",
-  "version": "2.0.2",
+  "version": "2.1.0",
   "description": "Controllable background sub-agent threads for pi: specialized roles, capability-aware thinking, direct main-model fallback, auto-fix chains, and Git worktree isolation.",
   "type": "module",
   "license": "MIT",

package/src/announcements.ts

@@ -1,70 +1,70 @@
-/** Session-start recovery and one-time feature announcements. */
-
-import { stat } from "node:fs/promises";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
-import { loadConfig, saveConfig } from "./config.ts";
-import { announceRecoveryRecords } from "./recovery.ts";
-import type { SubagentRuntime } from "./runtime.ts";
-import { pruneResultArtifacts } from "./spawn.ts";
-import { installActiveRunsWidget } from "./widget.ts";
-
-const ANNOUNCEMENTS: Array<{
-	key: string;
-	condition: (config: Awaited<ReturnType<typeof loadConfig>>) => boolean;
-	message: string;
-}> = [
-	{
-		key: "visionModel",
-		condition: (config) => config.visionModel === undefined,
-		message:
-			"pi-subagents: new — a vision-capable model can now handle image tasks (screenshots, mockups, designs). Run /subagents-setup to configure it; until set, vision tasks use the main session's current model.",
-	},
-	{
-		key: "cleanerAgent",
-		condition: (config) => !config.enabledAgents.includes("cleaner"),
-		message:
-			"pi-subagents: new built-in cleaner agent is available for evidence-first code cleanup. Run /subagents-setup to enable it; your existing enabledAgents selection was left unchanged.",
-	},
-];
-
-async function announceNewFeatures(
-	ctx: { ui: { notify: (message: string, kind: "info" | "warning" | "error") => void } },
-	runtime: SubagentRuntime,
-): Promise<void> {
-	try {
-		let configExists = true;
-		try {
-			await stat(runtime.configPath);
-		} catch {
-			configExists = false;
-		}
-		if (!configExists) return;
-
-		const config = await loadConfig(runtime.configPath);
-		const pending = ANNOUNCEMENTS.filter(
-			(announcement) =>
-				announcement.condition(config) && !config.announcedFeatures.includes(announcement.key),
-		);
-		if (pending.length === 0) return;
-		await saveConfig(
-			{
-				...config,
-				announcedFeatures: [...config.announcedFeatures, ...pending.map((announcement) => announcement.key)],
-			},
-			runtime.configPath,
-		);
-		for (const announcement of pending) ctx.ui.notify(announcement.message, "info");
-	} catch {
-		/* announcement failures are non-fatal */
-	}
-}
-
-export function registerAnnouncements(pi: ExtensionAPI, runtime: SubagentRuntime): void {
-	pi.on("session_start", async (_event, ctx) => {
-		pruneResultArtifacts();
-		await announceRecoveryRecords(runtime.configPath, ctx);
-		if (ctx.mode !== "tui") return;
-		installActiveRunsWidget(ctx);
-		await announceNewFeatures(ctx, runtime);
-	});
-}
+/** Session-start recovery and one-time feature announcements. */
+
+import { stat } from "node:fs/promises";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { loadConfig, saveConfig } from "./config.ts";
+import { announceRecoveryRecords } from "./recovery.ts";
+import type { SubagentRuntime } from "./runtime.ts";
+import { pruneResultArtifacts } from "./spawn.ts";
+import { installActiveRunsWidget } from "./widget.ts";
+
+const ANNOUNCEMENTS: Array<{
+	key: string;
+	condition: (config: Awaited<ReturnType<typeof loadConfig>>) => boolean;
+	message: string;
+}> = [
+	{
+		key: "visionModel",
+		condition: (config) => config.visionModel === undefined,
+		message:
+			"pi-subagents: new — a vision-capable model can now handle image tasks (screenshots, mockups, designs). Run /subagents-setup to configure it; until set, vision tasks use the main session's current model.",
+	},
+	{
+		key: "cleanerAgent",
+		condition: (config) => !config.enabledAgents.includes("cleaner"),
+		message:
+			"pi-subagents: new built-in cleaner agent is available for evidence-first code cleanup. Run /subagents-setup to enable it; your existing enabledAgents selection was left unchanged.",
+	},
+];
+
+async function announceNewFeatures(
+	ctx: { ui: { notify: (message: string, kind: "info" | "warning" | "error") => void } },
+	runtime: SubagentRuntime,
+): Promise<void> {
+	try {
+		let configExists = true;
+		try {
+			await stat(runtime.configPath);
+		} catch {
+			configExists = false;
+		}
+		if (!configExists) return;
+
+		const config = await loadConfig(runtime.configPath);
+		const pending = ANNOUNCEMENTS.filter(
+			(announcement) =>
+				announcement.condition(config) && !config.announcedFeatures.includes(announcement.key),
+		);
+		if (pending.length === 0) return;
+		await saveConfig(
+			{
+				...config,
+				announcedFeatures: [...config.announcedFeatures, ...pending.map((announcement) => announcement.key)],
+			},
+			runtime.configPath,
+		);
+		for (const announcement of pending) ctx.ui.notify(announcement.message, "info");
+	} catch {
+		/* announcement failures are non-fatal */
+	}
+}
+
+export function registerAnnouncements(pi: ExtensionAPI, runtime: SubagentRuntime): void {
+	pi.on("session_start", async (_event, ctx) => {
+		pruneResultArtifacts();
+		await announceRecoveryRecords(runtime.configPath, ctx);
+		if (ctx.mode !== "tui") return;
+		installActiveRunsWidget(ctx);
+		await announceNewFeatures(ctx, runtime);
+	});
+}