pi-subagents-lite 1.4.7 → 1.4.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-subagents-lite",
-  "version": "1.4.7",
+  "version": "1.4.8",
   "description": "Lightweight sub-agents for pi — spawn specialized agents with isolated sessions, tools, and models.",
   "keywords": [
     "pi-package",

package/src/agents/agent-manager.ts

@@ -503,6 +503,10 @@ export class AgentManager {
     for (const [id, record] of this.agents) {
       if (!isTerminalStatus(record.lifecycle.status)) continue;
       if ((record.lifecycle.completedAt ?? 0) >= cutoff) continue;
+      // Keep the record until the LLM has read the result (foreground return or
+      // background nudge). Otherwise a completed background agent can be wiped
+      // before its nudge is emitted.
+      if (!record.lifecycle.resultConsumed) continue;
       this.removeRecord(id, record);
     }
   }

package/src/spawn/spawn-coordinator.ts

@@ -122,6 +122,10 @@ export class SpawnCoordinator {
       // Foreground: await completion
       await record.execution.promise;
 
+      // Foreground tool handler reads the result inline on return — mark it
+      // consumed so the cleanup timer may evict the record once it ages out.
+      record.lifecycle.resultConsumed = true;
+
       // Clean up live view (foreground completion handled inline)
       this.liveViews.delete(agentId);
     }
@@ -244,6 +248,10 @@ export class SpawnCoordinator {
           triggerTurn: true,
         },
       );
+
+      // Full result delivered to the LLM — record is now safe for the cleanup
+      // timer to evict once it ages out.
+      record.lifecycle.resultConsumed = true;
     } catch (error) {
       // sendMessage failed (shared runtime overwritten by subagent bindCore).
       // Fall back to UI notification using the captured spawning-session context.

package/src/types.ts

@@ -107,6 +107,12 @@ export interface AgentLifecycle {
   startedAt: number;
   completedAt?: number;
   stoppedBy?: StopInitiator;
+  /**
+   * Whether the result has been read by the LLM (foreground return or background nudge).
+   * cleanup() preserves terminal records until this is set, so a completed background
+   * agent whose nudge hasn't fired yet isn't evicted before the LLM reads the result.
+   */
+  resultConsumed?: boolean;
 }
 
 /**