pi-cohort 7.6.2 → 7.6.3

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [7.6.3] - 2026-10-28
+
+### Added
+- Every child process gets `PI_SUBAGENT_PARENT_SESSION_ID`, the pi session id of the session that launched it, so a session roster can link each child to its parent without parsing the session name. A nested child gets its immediate parent's id. The README now lists `PI_SUBAGENT_CHILD`, `PI_SUBAGENT_CHILD_AGENT`, `PI_SUBAGENT_RUN_ID`, and `PI_SUBAGENT_PARENT_SESSION_ID` as stable inputs for other extensions. (#34)
+
 ## [7.6.2] - 2026-10-28
 
 ### Added

package/README.md

@@ -177,6 +177,15 @@ Each child session is named `<agent> <run id prefix>[/<index>] from <parent>`, s
 
 The run id prefix works as the `id` for `subagent` status, interrupt, and resume; the index is the child `index` for resume. A nested child names its parent child: `worker 7b41d0aa from scout 3f9a2c1e from billing reports`.
 
+Every child process also gets these environment variables, stable inputs for other extensions (for example, a session roster linking each child to its parent):
+
+| Variable | Value | Set |
+|---|---|---|
+| `PI_SUBAGENT_CHILD` | `1` | on every child |
+| `PI_SUBAGENT_CHILD_AGENT` | the child's agent name | when the agent is known |
+| `PI_SUBAGENT_RUN_ID` | the full run id; its prefix appears in the session name | when the run id is known |
+| `PI_SUBAGENT_PARENT_SESSION_ID` | the pi session id of the session that launched the child | on every child; a nested child gets its immediate parent's id, never an inherited ancestor's |
+
 Full reference: agent/chain authoring in [doc/agents-and-chains.md](doc/agents-and-chains.md), exact command syntax in [doc/commands.md](doc/commands.md), the raw tool API in [doc/programmatic-api.md](doc/programmatic-api.md).
 
 ## Key concepts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-cohort",
-  "version": "7.6.2",
+  "version": "7.6.3",
   "description": "Delegate Pi work to focused child agents: code review, scouting, implementation, parallel audits, saved chains, and background jobs.",
   "author": "Jacek Juraszek",
   "license": "MIT",

package/src/runs/background/async-execution.ts

@@ -59,6 +59,8 @@ interface AsyncExecutionContext {
 	parentThinking?: string;
 	/** Parent session display name, or its id when unnamed, captured at dispatch */
 	parentSessionLabel?: string;
+	/** Parent session id, captured at dispatch */
+	parentSessionId?: string;
 	executionBackend?: string;
 }
 
@@ -635,6 +637,7 @@ export function executeAsyncChain(
 				asyncDir,
 				sessionId: ctx.currentSessionId,
 				parentSessionLabel: ctx.parentSessionLabel,
+				parentSessionId: ctx.parentSessionId,
 				runtime: ctx.runtime,
 				forwardedFlags,
 				worktreeSetupHook,
@@ -850,6 +853,7 @@ export function executeAsyncSingle(
 				asyncDir,
 				sessionId: ctx.currentSessionId,
 				parentSessionLabel: ctx.parentSessionLabel,
+				parentSessionId: ctx.parentSessionId,
 				runtime: ctx.runtime,
 				forwardedFlags,
 				worktreeSetupHook,

package/src/runs/background/subagent-runner.ts

@@ -118,6 +118,7 @@ interface SubagentRunConfig {
 	asyncDir: string;
 	sessionId?: string | null;
 	parentSessionLabel?: string;
+	parentSessionId?: string;
 	runtime: PiRuntimeIdentity;
 	forwardedFlags?: string[];
 	worktreeSetupHook?: string;
@@ -627,6 +628,7 @@ export interface SingleStepContext {
 	runtime: PiRuntimeIdentity;
 	forwardedFlags?: string[];
 	parentSessionLabel?: string;
+	parentSessionId?: string;
 	registerInterrupt?: (interrupt: (() => void) | undefined) => void;
 	nestedRoute?: NestedRouteInfo;
 	onAttemptStart?: (attempt: { model?: string; thinking?: string }) => void;
@@ -793,6 +795,7 @@ export async function runSingleStep(
 					childAgentName: step.agent,
 					childIndex: ctx.flatIndex,
 					parentSessionLabel: ctx.parentSessionLabel,
+					parentSessionId: ctx.parentSessionId,
 					parentEventSink: ctx.nestedRoute?.eventSink,
 					parentControlInbox: ctx.nestedRoute?.controlInbox,
 					parentRootRunId: ctx.nestedRoute?.rootRunId,
@@ -940,6 +943,7 @@ export async function runSingleStep(
 			childAgentName: step.agent,
 			childIndex: ctx.flatIndex,
 			parentSessionLabel: ctx.parentSessionLabel,
+			parentSessionId: ctx.parentSessionId,
 			parentEventSink: ctx.nestedRoute?.eventSink,
 			parentControlInbox: ctx.nestedRoute?.controlInbox,
 			parentRootRunId: ctx.nestedRoute?.rootRunId,
@@ -1983,6 +1987,7 @@ async function runSubagent(config: SubagentRunConfig): Promise<void> {
 					controlConfig: config.controlConfig,
 					forwardedFlags: config.forwardedFlags,
 					parentSessionLabel: config.parentSessionLabel,
+					parentSessionId: config.parentSessionId,
 					executionBackendCoordinator,
 					executionBackendConfig,
 					nestedRoute: config.nestedRoute,
@@ -2274,6 +2279,7 @@ async function runSubagent(config: SubagentRunConfig): Promise<void> {
 							controlConfig: config.controlConfig,
 							forwardedFlags: config.forwardedFlags,
 							parentSessionLabel: config.parentSessionLabel,
+							parentSessionId: config.parentSessionId,
 							executionBackendCoordinator,
 							executionBackendConfig,
 							nestedRoute: config.nestedRoute,
@@ -2455,6 +2461,7 @@ async function runSubagent(config: SubagentRunConfig): Promise<void> {
 				controlConfig: config.controlConfig,
 				forwardedFlags: config.forwardedFlags,
 				parentSessionLabel: config.parentSessionLabel,
+				parentSessionId: config.parentSessionId,
 				executionBackendCoordinator,
 				executionBackendConfig,
 				nestedRoute: config.nestedRoute,

package/src/runs/foreground/chain-execution.ts

@@ -320,6 +320,7 @@ async function runParallelChainTasks(input: ParallelChainRunInput): Promise<Sing
 				parentModel: parentModelFullId(input.ctx.model),
 				parentThinking: input.ctx.thinkingLevel,
 				parentSessionLabel: resolveSessionLabel(input.ctx.sessionManager),
+				parentSessionId: input.ctx.sessionManager.getSessionId(),
 				skills: behavior.skills === false ? [] : behavior.skills,
 				structuredOutput: structuredRuntime,
 				acceptance: task.acceptance,
@@ -1164,6 +1165,7 @@ export async function executeChain(params: ChainExecutionParams): Promise<ChainE
 					parentModel: parentModelFullId(ctx.model),
 					parentThinking: ctx.thinkingLevel,
 					parentSessionLabel: resolveSessionLabel(ctx.sessionManager),
+					parentSessionId: ctx.sessionManager.getSessionId(),
 					skills: behavior.skills === false ? [] : behavior.skills,
 					structuredOutput: structuredRuntime,
 					acceptance: seqStep.acceptance,

package/src/runs/foreground/execution.ts

@@ -159,6 +159,7 @@ async function runSingleAttempt(
 		childAgentName: agent.name,
 		childIndex: options.index ?? 0,
 		parentSessionLabel: options.parentSessionLabel,
+		parentSessionId: options.parentSessionId,
 		parentEventSink: options.nestedRoute?.eventSink,
 		parentControlInbox: options.nestedRoute?.controlInbox,
 		parentRootRunId: options.nestedRoute?.rootRunId,

package/src/runs/foreground/external-single-attempt.ts

@@ -93,6 +93,7 @@ export async function runExternalSingleAttempt(input: RunExternalSingleAttemptIn
 		childAgentName: agent.name,
 		childIndex: options.index ?? 0,
 		parentSessionLabel: options.parentSessionLabel,
+		parentSessionId: options.parentSessionId,
 		parentEventSink: options.nestedRoute?.eventSink,
 		parentControlInbox: options.nestedRoute?.controlInbox,
 		parentRootRunId: options.nestedRoute?.rootRunId,

package/src/runs/foreground/subagent-executor.ts

@@ -226,6 +226,7 @@ function buildAsyncContext(ctx: ExtensionContext, deps: CallExecutorDeps, cwd: s
 		parentModel: parentModelFullId(ctx.model),
 		parentThinking: ctx.thinkingLevel,
 		parentSessionLabel: resolveSessionLabel(ctx.sessionManager),
+		parentSessionId: ctx.sessionManager.getSessionId(),
 		executionBackend: deps.config.executionBackend,
 	};
 }
@@ -1505,6 +1506,7 @@ async function runForegroundParallelTasks(input: ForegroundParallelRunInput): Pr
 			parentModel: parentModelFullId(input.ctx.model),
 			parentThinking: input.ctx.thinkingLevel,
 			parentSessionLabel: resolveSessionLabel(input.ctx.sessionManager),
+			parentSessionId: input.ctx.sessionManager.getSessionId(),
 			skills: effectiveSkills === false ? [] : effectiveSkills,
 			acceptance: task.acceptance,
 			acceptanceContext: { mode: "parallel" },
@@ -2067,6 +2069,7 @@ async function runSinglePath(data: ExecutionContextData, deps: CallExecutorDeps)
 		parentModel: parentModelFullId(ctx.model),
 		parentThinking: ctx.thinkingLevel,
 		parentSessionLabel: resolveSessionLabel(ctx.sessionManager),
+		parentSessionId: ctx.sessionManager.getSessionId(),
 		skills: effectiveSkills,
 		acceptance: params.acceptance,
 		acceptanceContext: { mode: "single" },

package/src/runs/shared/pi-args.ts

@@ -24,6 +24,7 @@ export const SUBAGENT_PARENT_CHILD_INDEX_ENV = "PI_SUBAGENT_PARENT_CHILD_INDEX";
 export const SUBAGENT_PARENT_DEPTH_ENV = "PI_SUBAGENT_PARENT_DEPTH";
 export const SUBAGENT_PARENT_PATH_ENV = "PI_SUBAGENT_PARENT_PATH";
 export const SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV = "PI_SUBAGENT_PARENT_CAPABILITY_TOKEN";
+export const SUBAGENT_PARENT_SESSION_ID_ENV = "PI_SUBAGENT_PARENT_SESSION_ID";
 
 interface BuildPiArgsInput {
 	baseArgs: string[];
@@ -47,6 +48,7 @@ interface BuildPiArgsInput {
 	childIndex?: number;
 	/** Parent session display name, or its id when unnamed; names the child session. */
 	parentSessionLabel?: string;
+	parentSessionId?: string;
 	parentEventSink?: string;
 	parentControlInbox?: string;
 	parentRootRunId?: string;
@@ -218,6 +220,8 @@ export function buildPiArgs(input: BuildPiArgsInput, fileSystem: BuildPiArgsFile
 	env[SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV] = fanoutAuthorized
 		? input.parentCapabilityToken ?? process.env[SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV] ?? ""
 		: "";
+	// Always set, so a grandchild sees its immediate parent rather than an inherited ancestor.
+	env[SUBAGENT_PARENT_SESSION_ID_ENV] = input.parentSessionId ?? "";
 	env.PI_SUBAGENT_INHERIT_PROJECT_CONTEXT = input.inheritProjectContext ? "1" : "0";
 	env.PI_SUBAGENT_INHERIT_SKILLS = input.inheritSkills ? "1" : "0";
 	if (input.runId) {

package/src/shared/types.ts

@@ -832,6 +832,8 @@ export interface RunSyncOptions {
 	parentThinking?: string;
 	/** Parent session display name, or its id when unnamed; names the child session */
 	parentSessionLabel?: string;
+	/** Parent session id; exported to the child as PI_SUBAGENT_PARENT_SESSION_ID */
+	parentSessionId?: string;
 	/** Skills to inject (overrides agent default if provided) */
 	skills?: string[];
 	structuredOutput?: {