@gotgenes/pi-subagents 10.2.1 → 11.0.0

package/src/observation/record-observer.ts

@@ -6,8 +6,7 @@
  */
 
 import type { Agent } from "#src/lifecycle/agent";
-import type { CompactionInfo } from "#src/lifecycle/agent-manager";
-import type { SubscribableSession } from "#src/types";
+import type { CompactionInfo, SubscribableSession } from "#src/types";
 
 export interface AgentObserverOptions {
   onCompact?: (record: Agent, info: CompactionInfo) => void;

package/src/tools/agent-tool.ts

@@ -4,14 +4,14 @@ import { defineTool } from "@earendil-works/pi-coding-agent";
 import { Text } from "@earendil-works/pi-tui";
 import { Type } from "@sinclair/typebox";
 import { AgentTypeRegistry } from "#src/config/agent-types";
-import type { AgentSpawnConfig, ParentSessionInfo } from "#src/lifecycle/agent-manager";
+import type { AgentSpawnConfig } from "#src/lifecycle/agent-manager";
 import type { ParentSnapshot } from "#src/lifecycle/parent-snapshot";
 import { spawnBackground } from "#src/tools/background-spawner";
 import { runForeground } from "#src/tools/foreground-runner";
 import { buildDetails, buildTypeListText, textResult } from "#src/tools/helpers";
 import { renderAgentResult } from "#src/tools/result-renderer";
 import { type ModelInfo, resolveSpawnConfig } from "#src/tools/spawn-config";
-import type { Agent } from "#src/types";
+import type { Agent, ParentSessionInfo } from "#src/types";
 import { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
 import { type UICtx } from "#src/ui/agent-widget";
 import { type AgentDetails, getDisplayName } from "#src/ui/display";

package/src/tools/background-spawner.ts

@@ -1,9 +1,9 @@
-import type { AgentSpawnConfig, ParentSessionInfo } from "#src/lifecycle/agent-manager";
+import type { AgentSpawnConfig } from "#src/lifecycle/agent-manager";
 import type { ParentSnapshot } from "#src/lifecycle/parent-snapshot";
 import type { AgentActivityAccess } from "#src/tools/agent-tool";
 import { textResult } from "#src/tools/helpers";
 import type { ResolvedSpawnConfig } from "#src/tools/spawn-config";
-import type { Agent } from "#src/types";
+import type { Agent, ParentSessionInfo } from "#src/types";
 import { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
 import { subscribeUIObserver } from "#src/ui/ui-observer";
 
@@ -54,9 +54,11 @@ export function spawnBackground(
       isBackground: true,
       isolation: execution.isolation,
       invocation: execution.agentInvocation,
-      onSessionCreated: (session) => {
-        bgState.setSession(session);
-        subscribeUIObserver(session, bgState);
+      observer: {
+        onSessionCreated: (_agent, session) => {
+          bgState.setSession(session);
+          subscribeUIObserver(session, bgState);
+        },
       },
     });
   } catch (err) {

package/src/tools/foreground-runner.ts

@@ -1,5 +1,5 @@
 import type { AgentToolResult } from "@earendil-works/pi-coding-agent";
-import type { AgentSpawnConfig, ParentSessionInfo } from "#src/lifecycle/agent-manager";
+import type { AgentSpawnConfig } from "#src/lifecycle/agent-manager";
 import type { ParentSnapshot } from "#src/lifecycle/parent-snapshot";
 import type { AgentActivityAccess } from "#src/tools/agent-tool";
 import {
@@ -9,7 +9,7 @@ import {
   textResult,
 } from "#src/tools/helpers";
 import type { ResolvedSpawnConfig } from "#src/tools/spawn-config";
-import type { Agent } from "#src/types";
+import type { Agent, ParentSessionInfo } from "#src/types";
 import { AgentActivityTracker } from "#src/ui/agent-activity-tracker";
 import {
   type AgentDetails,
@@ -109,13 +109,15 @@ export async function runForeground(
         invocation: execution.agentInvocation,
         signal,
         parentSession: params.parentSession,
-        onSessionCreated: (session, record) => {
-          fgState.setSession(session);
-          recordRef = record;
-          unsubUI = subscribeUIObserver(session, fgState, streamUpdate);
-          fgId = record.id;
-          agentActivity.set(record.id, fgState);
-          widget.ensureTimer();
+        observer: {
+          onSessionCreated: (agent, session) => {
+            fgState.setSession(session);
+            recordRef = agent;
+            unsubUI = subscribeUIObserver(session, fgState, streamUpdate);
+            fgId = agent.id;
+            agentActivity.set(agent.id, fgState);
+            widget.ensureTimer();
+          },
         },
       },
     );

package/src/types.ts

@@ -105,3 +105,16 @@ export type ShellExec = (
   args: string[],
   options?: { cwd?: string; timeout?: number },
 ) => Promise<{ stdout: string; stderr: string; code: number }>;
+
+/** Parent session identity — grouped fields that travel together from the tool boundary. */
+export interface ParentSessionInfo {
+	/** Path to the parent session's JSONL file (for deriving the subagent session directory). */
+	parentSessionFile?: string;
+	/** Session ID of the parent agent (stored in the child session's parentSession header). */
+	parentSessionId?: string;
+	/** Tool call ID for background notification wiring. When set, spawn attaches NotificationState. */
+	toolCallId?: string;
+}
+
+/** Compaction event info passed through lifecycle observers. */
+export type CompactionInfo = { reason: "manual" | "threshold" | "overflow"; tokensBefore: number };