@gotgenes/pi-subagents 13.2.2 → 14.0.0

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [14.0.0](https://github.com/gotgenes/pi-packages/compare/pi-subagents-v13.2.2...pi-subagents-v14.0.0) (2026-06-01)
+
+
+### ⚠ BREAKING CHANGES
+
+* **pi-subagents:** the subagents:child:session-created payload no longer includes sessionDir or agentName; it now carries sessionId (string) and parentSessionId (optional string). The subagents:child:disposed payload no longer includes sessionDir; it now carries sessionId (string). External subscribers reading sessionDir or agentName from these two events must update to use sessionId instead.
+
+### Bug Fixes
+
+* **pi-subagents:** carry child session id on session-created/disposed lifecycle events ([af94672](https://github.com/gotgenes/pi-packages/commit/af946723df7a4c7b2e65aa2e732085abb0019c7e))
+
 ## [13.2.2](https://github.com/gotgenes/pi-packages/compare/pi-subagents-v13.2.1...pi-subagents-v13.2.2) (2026-06-01)
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gotgenes/pi-subagents",
-  "version": "13.2.2",
+  "version": "14.0.0",
   "type": "module",
   "exports": {
     ".": {

package/src/lifecycle/child-lifecycle.ts

@@ -15,10 +15,10 @@ export const SUBAGENT_CHILD_SPAWNING = "subagents:child:spawning";
 
 /**
  * Emitted after the child session is created, immediately before
- * `bindExtensions()`. Carries the child identity consumers need to register
- * the session. Subscribers must register synchronously so the entry lands
- * before binding proceeds (see ADR 0002 / the event-bus synchronous-dispatch
- * guarantee).
+ * `bindExtensions()`. Carries the child session id consumers need to register
+ * the session in `SubagentSessionRegistry`. Subscribers must register
+ * synchronously so the entry lands before binding proceeds (see ADR 0002 /
+ * the event-bus synchronous-dispatch guarantee).
  */
 export const SUBAGENT_CHILD_SESSION_CREATED = "subagents:child:session-created";
 
@@ -36,9 +36,9 @@ export interface ChildSpawningEvent {
 
 /** Payload for `subagents:child:session-created`. */
 export interface ChildSessionCreatedEvent {
-  /** Child session directory — the registry key. */
-  sessionDir: string;
-  agentName: string;
+  /** Child session id — the registry key. Unique per child; concurrent
+   * siblings of the same parent occupy distinct keys. */
+  sessionId: string;
   parentSessionId?: string;
 }
 
@@ -54,7 +54,8 @@ export interface ChildCompletedEvent {
 
 /** Payload for `subagents:child:disposed`. */
 export interface ChildDisposedEvent {
-  sessionDir: string;
+  /** Child session id — the registry key. Must match `session-created`. */
+  sessionId: string;
 }
 
 /** Narrow emit seam — injected, never imports the Pi SDK. */

package/src/lifecycle/create-subagent-session.ts

@@ -51,6 +51,7 @@ export interface ResourceLoaderLike {
 export interface SessionManagerLike {
   newSession(opts: { parentSession?: string }): void;
   getSessionFile(): string | undefined;
+  getSessionId(): string;
 }
 
 /** Options passed to EnvironmentIO/SessionFactoryIO methods. */
@@ -196,6 +197,7 @@ export async function createSubagentSession(
   const sessionDir = deps.io.deriveSessionDir(params.parentSession?.parentSessionFile, cfg.effectiveCwd);
   const sessionManager = deps.io.createSessionManager(cfg.effectiveCwd, sessionDir);
   sessionManager.newSession({ parentSession: params.parentSession?.parentSessionId });
+  const sessionId = sessionManager.getSessionId();
 
   const { session } = await deps.io.createSession({
     cwd: cfg.effectiveCwd,
@@ -211,6 +213,7 @@ export async function createSubagentSession(
 
   const subagentSession = new SubagentSession(session, {
     outputFile: sessionManager.getSessionFile(),
+    sessionId,
     sessionDir,
     agentName: type,
     agentMaxTurns: cfg.agentMaxTurns,
@@ -223,7 +226,7 @@ export async function createSubagentSession(
   // entry in place for the first permission check during child extension
   // initialization. The event bus dispatches synchronously, so a synchronous
   // subscriber completes before this returns.
-  deps.lifecycle.sessionCreated({ sessionDir, agentName: type, parentSessionId });
+  deps.lifecycle.sessionCreated({ sessionId, parentSessionId });
 
   try {
     // Bind extensions so that session_start fires and extensions can initialize.

package/src/lifecycle/subagent-session.ts

@@ -44,7 +44,9 @@ export interface TurnLoopOptions {
 export interface SubagentSessionMeta {
   /** Path to the persisted session JSONL file, if the session was persisted. */
   outputFile: string | undefined;
-  /** Child session directory — the registry key carried on lifecycle events. */
+  /** Child session id — the registry key carried on session-created/disposed events. */
+  sessionId: string;
+  /** Child session directory — carried on the completed event as transcript location. */
   sessionDir: string;
   agentName: string;
   /** Per-agent max-turns from the resolved agent config — middle precedence. */
@@ -180,7 +182,7 @@ export class SubagentSession {
   dispose(): void {
     // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- dispose may not exist on all session implementations
     this._session.dispose?.();
-    this.meta.lifecycle.disposed({ sessionDir: this.meta.sessionDir });
+    this.meta.lifecycle.disposed({ sessionId: this.meta.sessionId });
   }
 }