@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/model-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-scope.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/model-scope.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\n/**\n * Optional model-scope enforcement for subagent model resolution.\n *\n * When `subagents.modelScope.enforce` is enabled in settings, a resolved model\n * that does not match any `allow` pattern is rejected. The severity depends on\n * where the model came from: an explicit caller-supplied model (`--model`,\n * tool-call `model`, or a TUI clarify pick) is a hard error, while a model\n * inherited from agent frontmatter / `defaultModel` / the parent session only\n * emits a warning so existing configurations keep working.\n *\n * The decision logic ({@link checkModelScope}) is a pure function of its\n * inputs so it can be unit-tested without touching the filesystem or config.\n */\n\nimport { splitKnownThinkingSuffix } from \"../../shared/model-info.ts\";\n\nexport interface ModelScopeConfig {\n\tenforce?: boolean;\n\t/** Glob-style allow patterns (only `*` is special), matched against `provider/id`. */\n\tallow?: string[];\n}\n\n/** Where a resolved model originated, deciding enforcement severity. */\nexport type ModelSource = \"explicit\" | \"inherited\";\n\nexport interface ModelScopeViolation {\n\t/** Resolved model id (without thinking suffix) that fell outside the scope. */\n\tmodel: string;\n\tseverity: \"warn\" | \"error\";\n\tmessage: string;\n\tallowedPatterns: string[];\n}\n\nfunction stripThinkingSuffix(model: string): string {\n\treturn splitKnownThinkingSuffix(model).baseModel;\n}\n\n/** Escape RegExp specials except `*`, then turn `*` into `.*`. */\nfunction globToRegExp(pattern: string): RegExp {\n\tconst escaped = pattern.replace(/[.+^${}()|[\\]\\\\]/g, \"\\\\$&\").replace(/\\*/g, \".*\");\n\treturn new RegExp(`^${escaped}$`, \"i\");\n}\n\n/**\n * Test whether a resolved model matches a single allow pattern. Both sides are\n * compared case-insensitively against the full `provider/id` (thinking suffix\n * stripped from the model).\n */\nexport function matchesScopePattern(model: string, pattern: string): boolean {\n\treturn globToRegExp(pattern).test(stripThinkingSuffix(model));\n}\n\n/**\n * Pure scope decision. Returns a {@link ModelScopeViolation} when the model is\n * out of scope and enforcement is on, otherwise `undefined`. Enforcement with\n * no `allow` list is a no-op (the settings parser rejects that combination, but\n * this stays defensive for callers that build configs programmatically).\n */\nexport function checkModelScope(\n\tmodel: string | undefined,\n\tscope: ModelScopeConfig | undefined,\n\tsource: ModelSource,\n): ModelScopeViolation | undefined {\n\tif (!model || !scope?.enforce) return undefined;\n\tconst allow = scope.allow;\n\tif (!allow || allow.length === 0) return undefined;\n\tif (allow.some((pattern) => matchesScopePattern(model, pattern))) return undefined;\n\n\tconst baseModel = stripThinkingSuffix(model);\n\tconst severity: ModelScopeViolation[\"severity\"] = source === \"explicit\" ? \"error\" : \"warn\";\n\treturn {\n\t\tmodel: baseModel,\n\t\tseverity,\n\t\tallowedPatterns: allow,\n\t\tmessage:\n\t\t\t`Model '${baseModel}' is outside the configured subagent model scope. ` +\n\t\t\t`Allowed patterns: ${allow.join(\", \")}.`,\n\t};\n}\n\n/**\n * Validate and normalize a raw `subagents.modelScope` value from settings.\n * Throws a descriptive error for malformed configs (matching the surrounding\n * settings-parsing style). Returns `undefined` when the field is absent.\n */\nexport function parseModelScopeConfig(\n\tvalue: unknown,\n\tmeta: { filePath: string },\n): ModelScopeConfig | undefined {\n\tif (value === undefined) return undefined;\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) {\n\t\tthrow new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope'; expected an object.`);\n\t}\n\n\tconst input = value as Record<string, unknown>;\n\tconst config: ModelScopeConfig = {};\n\n\tif (\"enforce\" in input) {\n\t\tif (typeof input.enforce !== \"boolean\") {\n\t\t\tthrow new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope.enforce'; expected a boolean.`);\n\t\t}\n\t\tconfig.enforce = input.enforce;\n\t}\n\n\tif (\"allow\" in input) {\n\t\tif (!Array.isArray(input.allow)) {\n\t\t\tthrow new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope.allow'; expected an array of strings.`);\n\t\t}\n\t\tconst allow: string[] = [];\n\t\tfor (const entry of input.allow) {\n\t\t\tif (typeof entry !== \"string\") {\n\t\t\t\tthrow new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope.allow'; expected an array of strings.`);\n\t\t\t}\n\t\t\tconst trimmed = entry.trim();\n\t\t\tif (trimmed) allow.push(trimmed);\n\t\t}\n\t\tif (allow.length === 0) {\n\t\t\tthrow new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope.allow'; expected a non-empty array of patterns.`);\n\t\t}\n\t\tconfig.allow = allow;\n\t}\n\n\tif (config.enforce === true && (!config.allow || config.allow.length === 0)) {\n\t\tthrow new Error(`Subagent settings in '${meta.filePath}' set modelScope.enforce without a non-empty 'allow' list; supply allowed model patterns or disable enforcement.`);\n\t}\n\n\treturn Object.keys(config).length > 0 ? config : undefined;\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/nested-events.d.ts

@@ -0,0 +1,121 @@
+import { type AsyncJobState, type AsyncStatus, type NestedRouteInfo, type NestedRunSummary, type SubagentRunMode, type SubagentState } from "../../shared/types.ts";
+import { type NestedPathEntry } from "./nested-path.ts";
+export declare const NESTED_EVENTS_DIR: string;
+type NestedStatusEventType = "subagent.nested.started" | "subagent.nested.updated" | "subagent.nested.completed";
+type NestedControlResultEventType = "subagent.nested.control-result";
+export type NestedRoute = NestedRouteInfo;
+export interface NestedEventRecord {
+    type: NestedStatusEventType;
+    ts: number;
+    rootRunId: string;
+    parentRunId: string;
+    parentStepIndex?: number;
+    capabilityToken: string;
+    child: NestedRunSummary;
+}
+export interface NestedControlResultRecord {
+    type: NestedControlResultEventType;
+    ts: number;
+    rootRunId: string;
+    capabilityToken: string;
+    requestId: string;
+    targetRunId: string;
+    ok: boolean;
+    message: string;
+}
+export interface NestedControlRequestRecord {
+    type: "subagent.nested.control-request";
+    ts: number;
+    rootRunId: string;
+    capabilityToken: string;
+    requestId: string;
+    targetRunId: string;
+    action: "interrupt" | "resume";
+    message?: string;
+}
+export interface NestedRegistry {
+    rootRunId: string;
+    updatedAt: number;
+    children: NestedRunSummary[];
+    processedEvents: string[];
+}
+export declare function isSafeNestedId(value: unknown): value is string;
+export declare function assertSafeNestedId(label: string, value: string): void;
+export declare function createNestedRoute(rootRunId: string): NestedRoute;
+export declare function resolveNestedRouteFromEnv(env?: NodeJS.ProcessEnv): NestedRoute | undefined;
+export declare function resolveInheritedNestedRouteFromEnv(env?: NodeJS.ProcessEnv): NestedRoute | undefined;
+export declare function resolveNestedParentAddressFromEnv(env?: NodeJS.ProcessEnv): {
+    parentRunId: string;
+    parentStepIndex?: number;
+    depth: number;
+    path: NestedPathEntry[];
+} | undefined;
+export declare function resolveNestedAsyncDir(rootRunId: string, run: NestedRunSummary): string | undefined;
+export declare function sanitizeSummary(input: unknown, depth?: number): NestedRunSummary | undefined;
+export declare function parseNestedEventRecords(content: string, route: NestedRoute): NestedEventRecord[];
+export declare function applyNestedEvent(registry: NestedRegistry, event: NestedEventRecord): NestedRegistry;
+export declare function findNestedRouteForRootId(rootRunId: string): NestedRoute | undefined;
+/**
+ * Scan the nested-events directory once and index every route by its root run
+ * id. Use this when resolving routes for many runs (e.g. listAsyncRuns) so the
+ * cost is O(routes) total instead of O(runs * routes) from calling
+ * findNestedRouteForRootId per run.
+ */
+export declare function buildNestedRouteIndex(): Map<string, NestedRoute>;
+export declare function projectNestedRegistryForRoot(rootRunId: string): NestedRegistry | undefined;
+export declare function findNestedRun(children: NestedRunSummary[] | undefined, id: string): NestedRunSummary | undefined;
+export interface NestedRunMatch {
+    rootRunId: string;
+    route: NestedRoute;
+    run: NestedRunSummary;
+}
+export interface NestedRunResolutionScope {
+    routes: NestedRoute[];
+    descendantOf?: {
+        parentRunId: string;
+        parentStepIndex?: number;
+    };
+}
+export declare function findNestedRunMatchesById(id: string, options?: {
+    prefix?: boolean;
+    scope?: NestedRunResolutionScope;
+}): NestedRunMatch[];
+export declare function findNestedRunById(id: string): {
+    rootRunId: string;
+    run: NestedRunSummary;
+} | undefined;
+export declare function readNestedRegistry(route: NestedRoute): NestedRegistry;
+export declare function projectNestedEvents(route: NestedRoute): NestedRegistry;
+export declare function writeNestedEvent(route: NestedRoute, event: Omit<NestedEventRecord, "rootRunId" | "capabilityToken">): void;
+export declare function writeNestedControlRequest(route: NestedRoute, request: Omit<NestedControlRequestRecord, "type" | "rootRunId" | "capabilityToken">): string;
+export declare function readNestedControlRequests(route: NestedRoute): Array<NestedControlRequestRecord & {
+    filePath: string;
+}>;
+export declare function writeNestedControlResult(route: NestedRoute, result: Omit<NestedControlResultRecord, "type" | "rootRunId" | "capabilityToken">): void;
+export declare function readNestedControlResults(route: NestedRoute): NestedControlResultRecord[];
+export declare function nestedRouteEnv(route: NestedRoute): Record<string, string>;
+export declare function attachRootChildrenToSteps<T extends {
+    children?: NestedRunSummary[];
+    index?: number;
+}>(rootRunId: string, steps: T[] | undefined, children: NestedRunSummary[] | undefined): void;
+export declare function updateAsyncJobNestedProjection(job: AsyncJobState): void;
+export declare function updateForegroundNestedProjection(control: SubagentState["foregroundControls"] extends Map<string, infer T> ? T : never): void;
+export declare function hasLiveNestedDescendants(children: NestedRunSummary[] | undefined): boolean;
+export declare function nestedSummaryFromAsyncStatus(status: AsyncStatus, asyncDir: string, fallback: {
+    id: string;
+    parentRunId: string;
+    parentStepIndex?: number;
+    depth: number;
+    path?: Array<{
+        runId: string;
+        stepIndex?: number;
+        agent?: string;
+    }>;
+    mode?: SubagentRunMode;
+    ts: number;
+}): NestedRunSummary;
+export declare function nestedArtifactEnv(rootRunId: string, parentRunId: string): Record<string, string>;
+export declare function isTopLevelAsyncDir(asyncDir: string): boolean;
+export declare function nestedResultsPath(rootRunId: string, id: string): string;
+export {};
+//# sourceMappingURL=nested-events.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/nested-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-events.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/nested-events.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport {\n\tASYNC_DIR,\n\tRESULTS_DIR,\n\tTEMP_ROOT_DIR,\n\ttype AsyncJobState,\n\ttype AsyncStatus,\n\ttype NestedRouteInfo,\n\ttype TurnBudgetState,\n\ttype NestedRunSummary,\n\ttype NestedRunState,\n\ttype NestedStepSummary,\n\ttype SubagentRunMode,\n\ttype SubagentState,\n} from \"../../shared/types.ts\";\nimport { isSafeNestedPathId, parseNestedPathEnv, sanitizeNestedPath, type NestedPathEntry } from \"./nested-path.ts\";\nimport {\n\tSUBAGENT_PARENT_CAPABILITY_TOKEN_ENV,\n\tSUBAGENT_PARENT_CHILD_INDEX_ENV,\n\tSUBAGENT_PARENT_CONTROL_INBOX_ENV,\n\tSUBAGENT_PARENT_DEPTH_ENV,\n\tSUBAGENT_PARENT_EVENT_SINK_ENV,\n\tSUBAGENT_PARENT_PATH_ENV,\n\tSUBAGENT_PARENT_ROOT_RUN_ID_ENV,\n\tSUBAGENT_PARENT_RUN_ID_ENV,\n} from \"./pi-args.ts\";\nimport { writeAtomicJson } from \"../../shared/atomic-json.ts\";\n\nexport const NESTED_EVENTS_DIR = path.join(TEMP_ROOT_DIR, \"nested-subagent-events\");\nconst ROUTE_FILE = \"route.json\";\nconst REGISTRY_FILE = \"registry.json\";\nconst MAX_EVENT_BYTES = 64 * 1024;\nconst MAX_STEPS = 12;\nconst MAX_CHILDREN = 16;\nconst MAX_DEPTH = 3;\n\ntype NestedStatusEventType = \"subagent.nested.started\" | \"subagent.nested.updated\" | \"subagent.nested.completed\";\ntype NestedControlResultEventType = \"subagent.nested.control-result\";\n\nexport type NestedRoute = NestedRouteInfo;\n\nexport interface NestedEventRecord {\n\ttype: NestedStatusEventType;\n\tts: number;\n\trootRunId: string;\n\tparentRunId: string;\n\tparentStepIndex?: number;\n\tcapabilityToken: string;\n\tchild: NestedRunSummary;\n}\n\nexport interface NestedControlResultRecord {\n\ttype: NestedControlResultEventType;\n\tts: number;\n\trootRunId: string;\n\tcapabilityToken: string;\n\trequestId: string;\n\ttargetRunId: string;\n\tok: boolean;\n\tmessage: string;\n}\n\nexport interface NestedControlRequestRecord {\n\ttype: \"subagent.nested.control-request\";\n\tts: number;\n\trootRunId: string;\n\tcapabilityToken: string;\n\trequestId: string;\n\ttargetRunId: string;\n\taction: \"interrupt\" | \"resume\";\n\tmessage?: string;\n}\n\nexport interface NestedRegistry {\n\trootRunId: string;\n\tupdatedAt: number;\n\tchildren: NestedRunSummary[];\n\tprocessedEvents: string[];\n}\n\nexport function isSafeNestedId(value: unknown): value is string {\n\treturn isSafeNestedPathId(value);\n}\n\nexport function assertSafeNestedId(label: string, value: string): void {\n\tif (!isSafeNestedId(value)) throw new Error(`${label} must be a non-empty safe id token.`);\n}\n\nfunction assertSafeId(label: string, value: string): void {\n\tassertSafeNestedId(label, value);\n}\n\nfunction containedPath(base: string, candidate: string): boolean {\n\tconst resolvedBase = path.resolve(base);\n\tconst resolvedCandidate = path.resolve(candidate);\n\treturn resolvedCandidate === resolvedBase || resolvedCandidate.startsWith(`${resolvedBase}${path.sep}`);\n}\n\nfunction commonRouteRoot(route: Pick<NestedRoute, \"eventSink\" | \"controlInbox\">): string {\n\treturn path.dirname(path.resolve(route.eventSink));\n}\n\nfunction validateRouteShape(route: NestedRoute): void {\n\tassertSafeId(\"rootRunId\", route.rootRunId);\n\tassertSafeId(\"capabilityToken\", route.capabilityToken);\n\tif (!containedPath(NESTED_EVENTS_DIR, route.eventSink)) throw new Error(\"Nested event sink is outside the subagent nested event root.\");\n\tif (!containedPath(NESTED_EVENTS_DIR, route.controlInbox)) throw new Error(\"Nested control inbox is outside the subagent nested event root.\");\n\tif (commonRouteRoot(route) !== path.dirname(path.resolve(route.controlInbox))) throw new Error(\"Nested event sink and control inbox must share one route root.\");\n}\n\nexport function createNestedRoute(rootRunId: string): NestedRoute {\n\tassertSafeId(\"rootRunId\", rootRunId);\n\tconst capabilityToken = randomUUID();\n\tconst routeRoot = path.join(NESTED_EVENTS_DIR, `${rootRunId}-${capabilityToken}`);\n\tconst eventSink = path.join(routeRoot, \"events\");\n\tconst controlInbox = path.join(routeRoot, \"controls\");\n\tfs.mkdirSync(eventSink, { recursive: true, mode: 0o700 });\n\tfs.mkdirSync(controlInbox, { recursive: true, mode: 0o700 });\n\tfs.writeFileSync(path.join(routeRoot, ROUTE_FILE), `${JSON.stringify({ rootRunId, capabilityToken, createdAt: Date.now() })}\\n`, { mode: 0o600 });\n\treturn { rootRunId, eventSink, controlInbox, capabilityToken };\n}\n\nexport function resolveNestedRouteFromEnv(env: NodeJS.ProcessEnv = process.env): NestedRoute | undefined {\n\tconst rootRunId = env[SUBAGENT_PARENT_ROOT_RUN_ID_ENV];\n\tconst eventSink = env[SUBAGENT_PARENT_EVENT_SINK_ENV];\n\tconst controlInbox = env[SUBAGENT_PARENT_CONTROL_INBOX_ENV];\n\tconst capabilityToken = env[SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV];\n\tif (!rootRunId || !eventSink || !controlInbox || !capabilityToken) return undefined;\n\tconst route = { rootRunId, eventSink, controlInbox, capabilityToken };\n\tvalidateRouteShape(route);\n\tconst routeFile = path.join(commonRouteRoot(route), ROUTE_FILE);\n\tconst metadata = JSON.parse(fs.readFileSync(routeFile, \"utf-8\")) as { rootRunId?: unknown; capabilityToken?: unknown };\n\tif (metadata.rootRunId !== rootRunId || metadata.capabilityToken !== capabilityToken) {\n\t\tthrow new Error(\"Nested event route metadata does not match the provided root id and capability token.\");\n\t}\n\treturn route;\n}\n\nexport function resolveInheritedNestedRouteFromEnv(env: NodeJS.ProcessEnv = process.env): NestedRoute | undefined {\n\ttry {\n\t\treturn resolveNestedRouteFromEnv(env);\n\t} catch (error) {\n\t\tconsole.error(\"Ignoring invalid nested subagent event route:\", error);\n\t\treturn undefined;\n\t}\n}\n\nexport function resolveNestedParentAddressFromEnv(env: NodeJS.ProcessEnv = process.env): { parentRunId: string; parentStepIndex?: number; depth: number; path: NestedPathEntry[] } | undefined {\n\tconst parentRunId = env[SUBAGENT_PARENT_RUN_ID_ENV];\n\tif (!isSafeNestedId(parentRunId)) return undefined;\n\tconst rawIndex = env[SUBAGENT_PARENT_CHILD_INDEX_ENV];\n\tconst parentStepIndex = rawIndex && /^\\d+$/.test(rawIndex) ? Number(rawIndex) : undefined;\n\tconst depth = Math.min(Math.max(1, clampNumber(Number(env[SUBAGENT_PARENT_DEPTH_ENV])) ?? 1), MAX_DEPTH);\n\tconst parsedPath = parseNestedPathEnv(env[SUBAGENT_PARENT_PATH_ENV]);\n\tconst nestedPath = parsedPath.length ? parsedPath : [{ runId: parentRunId, ...(parentStepIndex !== undefined ? { stepIndex: parentStepIndex } : {}) }];\n\treturn { parentRunId, ...(parentStepIndex !== undefined ? { parentStepIndex } : {}), depth, path: nestedPath };\n}\n\nexport function resolveNestedAsyncDir(rootRunId: string, run: NestedRunSummary): string | undefined {\n\tif (!run.asyncDir) return undefined;\n\tconst resolved = path.resolve(run.asyncDir);\n\tconst nestedRoot = path.resolve(TEMP_ROOT_DIR, \"nested-subagent-runs\", rootRunId, run.id);\n\tconst relative = path.relative(nestedRoot, resolved);\n\treturn resolved === nestedRoot || (!relative.startsWith(\"..\") && !path.isAbsolute(relative)) ? resolved : undefined;\n}\n\nfunction clampNumber(value: unknown): number | undefined {\n\treturn typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\nfunction stringValue(value: unknown, max = 512): string | undefined {\n\treturn typeof value === \"string\" && value.length > 0 ? value.slice(0, max) : undefined;\n}\n\nfunction sanitizeTokenUsage(value: unknown): NestedRunSummary[\"totalTokens\"] | undefined {\n\tif (!value || typeof value !== \"object\") return undefined;\n\tconst raw = value as Record<string, unknown>;\n\tconst input = clampNumber(raw.input);\n\tconst output = clampNumber(raw.output);\n\tconst total = clampNumber(raw.total);\n\treturn input !== undefined && output !== undefined && total !== undefined\n\t\t? { input, output, total }\n\t\t: undefined;\n}\n\nfunction sanitizeCost(value: unknown): NestedRunSummary[\"totalCost\"] | undefined {\n\tif (!value || typeof value !== \"object\") return undefined;\n\tconst raw = value as Record<string, unknown>;\n\tconst inputTokens = clampNumber(raw.inputTokens);\n\tconst outputTokens = clampNumber(raw.outputTokens);\n\tconst costUsd = clampNumber(raw.costUsd);\n\treturn inputTokens !== undefined && outputTokens !== undefined && costUsd !== undefined\n\t\t? { inputTokens, outputTokens, costUsd }\n\t\t: undefined;\n}\n\nfunction sanitizeTurnBudget(value: unknown): TurnBudgetState | undefined {\n\tif (!value || typeof value !== \"object\") return undefined;\n\tconst raw = value as Record<string, unknown>;\n\tconst maxTurns = clampNumber(raw.maxTurns);\n\tconst graceTurns = clampNumber(raw.graceTurns);\n\tconst turnCount = clampNumber(raw.turnCount);\n\tconst outcome = raw.outcome === \"within-budget\" || raw.outcome === \"wrap-up-requested\" || raw.outcome === \"exceeded\" ? raw.outcome : undefined;\n\tif (maxTurns === undefined || graceTurns === undefined || turnCount === undefined || !outcome) return undefined;\n\treturn {\n\t\tmaxTurns,\n\t\tgraceTurns,\n\t\tturnCount,\n\t\toutcome,\n\t\t...(clampNumber(raw.wrapUpRequestedAtTurn) !== undefined ? { wrapUpRequestedAtTurn: clampNumber(raw.wrapUpRequestedAtTurn) } : {}),\n\t\t...(clampNumber(raw.exceededAtTurn) !== undefined ? { exceededAtTurn: clampNumber(raw.exceededAtTurn) } : {}),\n\t};\n}\n\nfunction sanitizeState(value: unknown, fallback: NestedRunState): NestedRunState {\n\treturn value === \"queued\" || value === \"running\" || value === \"complete\" || value === \"failed\" || value === \"paused\" || value === \"stopped\"\n\t\t? value\n\t\t: fallback;\n}\n\nfunction sanitizeStep(input: unknown, depth: number): NestedStepSummary | undefined {\n\tif (!input || typeof input !== \"object\") return undefined;\n\tconst raw = input as Record<string, unknown>;\n\tconst agent = stringValue(raw.agent, 128);\n\tif (!agent) return undefined;\n\tconst status = raw.status === \"pending\" || raw.status === \"running\" || raw.status === \"complete\" || raw.status === \"completed\" || raw.status === \"failed\" || raw.status === \"paused\" || raw.status === \"stopped\"\n\t\t? raw.status\n\t\t: \"pending\";\n\treturn {\n\t\tagent,\n\t\tstatus,\n\t\t...(stringValue(raw.sessionFile, 2048) ? { sessionFile: stringValue(raw.sessionFile, 2048) } : {}),\n\t\t...(raw.activityState === \"active_long_running\" || raw.activityState === \"needs_attention\" ? { activityState: raw.activityState } : {}),\n\t\t...(clampNumber(raw.lastActivityAt) !== undefined ? { lastActivityAt: clampNumber(raw.lastActivityAt) } : {}),\n\t\t...(stringValue(raw.currentTool, 128) ? { currentTool: stringValue(raw.currentTool, 128) } : {}),\n\t\t...(clampNumber(raw.currentToolStartedAt) !== undefined ? { currentToolStartedAt: clampNumber(raw.currentToolStartedAt) } : {}),\n\t\t...(stringValue(raw.currentPath, 2048) ? { currentPath: stringValue(raw.currentPath, 2048) } : {}),\n\t\t...(clampNumber(raw.turnCount) !== undefined ? { turnCount: clampNumber(raw.turnCount) } : {}),\n\t\t...(clampNumber(raw.toolCount) !== undefined ? { toolCount: clampNumber(raw.toolCount) } : {}),\n\t\t...(clampNumber(raw.startedAt) !== undefined ? { startedAt: clampNumber(raw.startedAt) } : {}),\n\t\t...(clampNumber(raw.endedAt) !== undefined ? { endedAt: clampNumber(raw.endedAt) } : {}),\n\t\t...(stringValue(raw.error, 1024) ? { error: stringValue(raw.error, 1024) } : {}),\n\t\t...(raw.timedOut === true ? { timedOut: true } : {}),\n\t\t...(raw.stopped === true ? { stopped: true } : {}),\n\t\t...(sanitizeTurnBudget(raw.turnBudget) ? { turnBudget: sanitizeTurnBudget(raw.turnBudget) } : {}),\n\t\t...(raw.turnBudgetExceeded === true ? { turnBudgetExceeded: true } : {}),\n\t\t...(raw.wrapUpRequested === true ? { wrapUpRequested: true } : {}),\n\t\t...(depth < MAX_DEPTH && Array.isArray(raw.children) ? { children: raw.children.map((child) => sanitizeSummary(child, depth + 1)).filter((child): child is NestedRunSummary => Boolean(child)).slice(0, MAX_CHILDREN) } : {}),\n\t};\n}\n\nexport function sanitizeSummary(input: unknown, depth = 0): NestedRunSummary | undefined {\n\tif (!input || typeof input !== \"object\") return undefined;\n\tconst raw = input as Record<string, unknown>;\n\tif (!isSafeNestedId(raw.id) || !isSafeNestedId(raw.parentRunId)) return undefined;\n\tconst pathParts = sanitizeNestedPath(raw.path);\n\tconst steps = Array.isArray(raw.steps)\n\t\t? raw.steps.map((step) => sanitizeStep(step, depth + 1)).filter((step): step is NestedStepSummary => Boolean(step)).slice(0, MAX_STEPS)\n\t\t: undefined;\n\tconst totalTokens = sanitizeTokenUsage(raw.totalTokens);\n\tconst totalCost = sanitizeCost(raw.totalCost);\n\treturn {\n\t\tid: raw.id,\n\t\tparentRunId: raw.parentRunId,\n\t\t...(clampNumber(raw.parentStepIndex) !== undefined ? { parentStepIndex: clampNumber(raw.parentStepIndex) } : {}),\n\t\t...(stringValue(raw.parentAgent, 128) ? { parentAgent: stringValue(raw.parentAgent, 128) } : {}),\n\t\tdepth: Math.min(Math.max(0, clampNumber(raw.depth) ?? 0), MAX_DEPTH),\n\t\tpath: pathParts,\n\t\tstate: sanitizeState(raw.state, \"running\"),\n\t\t...(stringValue(raw.asyncDir, 2048) ? { asyncDir: stringValue(raw.asyncDir, 2048) } : {}),\n\t\t...(clampNumber(raw.pid) !== undefined && clampNumber(raw.pid)! > 0 && Number.isInteger(clampNumber(raw.pid)) ? { pid: clampNumber(raw.pid) } : {}),\n\t\t...(stringValue(raw.sessionId, 256) ? { sessionId: stringValue(raw.sessionId, 256) } : {}),\n\t\t...(stringValue(raw.sessionFile, 2048) ? { sessionFile: stringValue(raw.sessionFile, 2048) } : {}),\n\t\t...(stringValue(raw.intercomTarget, 256) ? { intercomTarget: stringValue(raw.intercomTarget, 256) } : {}),\n\t\t...(stringValue(raw.ownerIntercomTarget, 256) ? { ownerIntercomTarget: stringValue(raw.ownerIntercomTarget, 256) } : {}),\n\t\t...(stringValue(raw.leafIntercomTarget, 256) ? { leafIntercomTarget: stringValue(raw.leafIntercomTarget, 256) } : {}),\n\t\t...(raw.ownerState === \"live\" || raw.ownerState === \"gone\" || raw.ownerState === \"unknown\" ? { ownerState: raw.ownerState } : {}),\n\t\t...(stringValue(raw.controlInbox, 2048) ? { controlInbox: stringValue(raw.controlInbox, 2048) } : {}),\n\t\t...(stringValue(raw.capabilityToken, 128) ? { capabilityToken: stringValue(raw.capabilityToken, 128) } : {}),\n\t\t...(raw.mode === \"single\" || raw.mode === \"parallel\" || raw.mode === \"chain\" ? { mode: raw.mode } : {}),\n\t\t...(stringValue(raw.agent, 128) ? { agent: stringValue(raw.agent, 128) } : {}),\n\t\t...(Array.isArray(raw.agents) ? { agents: raw.agents.map((agent) => stringValue(agent, 128)).filter((agent): agent is string => Boolean(agent)).slice(0, MAX_STEPS) } : {}),\n\t\t...(clampNumber(raw.currentStep) !== undefined ? { currentStep: clampNumber(raw.currentStep) } : {}),\n\t\t...(clampNumber(raw.chainStepCount) !== undefined ? { chainStepCount: clampNumber(raw.chainStepCount) } : {}),\n\t\t...(raw.activityState === \"active_long_running\" || raw.activityState === \"needs_attention\" ? { activityState: raw.activityState } : {}),\n\t\t...(clampNumber(raw.lastActivityAt) !== undefined ? { lastActivityAt: clampNumber(raw.lastActivityAt) } : {}),\n\t\t...(stringValue(raw.currentTool, 128) ? { currentTool: stringValue(raw.currentTool, 128) } : {}),\n\t\t...(clampNumber(raw.currentToolStartedAt) !== undefined ? { currentToolStartedAt: clampNumber(raw.currentToolStartedAt) } : {}),\n\t\t...(stringValue(raw.currentPath, 2048) ? { currentPath: stringValue(raw.currentPath, 2048) } : {}),\n\t\t...(clampNumber(raw.turnCount) !== undefined ? { turnCount: clampNumber(raw.turnCount) } : {}),\n\t\t...(clampNumber(raw.toolCount) !== undefined ? { toolCount: clampNumber(raw.toolCount) } : {}),\n\t\t...(totalTokens ? { totalTokens } : {}),\n\t\t...(totalCost ? { totalCost } : {}),\n\t\t...(clampNumber(raw.startedAt) !== undefined ? { startedAt: clampNumber(raw.startedAt) } : {}),\n\t\t...(clampNumber(raw.endedAt) !== undefined ? { endedAt: clampNumber(raw.endedAt) } : {}),\n\t\t...(clampNumber(raw.lastUpdate) !== undefined ? { lastUpdate: clampNumber(raw.lastUpdate) } : {}),\n\t\t...(clampNumber(raw.timeoutMs) !== undefined ? { timeoutMs: clampNumber(raw.timeoutMs) } : {}),\n\t\t...(clampNumber(raw.deadlineAt) !== undefined ? { deadlineAt: clampNumber(raw.deadlineAt) } : {}),\n\t\t...(raw.timedOut === true ? { timedOut: true } : {}),\n\t\t...(raw.stopped === true ? { stopped: true } : {}),\n\t\t...(sanitizeTurnBudget(raw.turnBudget) ? { turnBudget: sanitizeTurnBudget(raw.turnBudget) } : {}),\n\t\t...(raw.turnBudgetExceeded === true ? { turnBudgetExceeded: true } : {}),\n\t\t...(raw.wrapUpRequested === true ? { wrapUpRequested: true } : {}),\n\t\t...(stringValue(raw.error, 1024) ? { error: stringValue(raw.error, 1024) } : {}),\n\t\t...(steps && steps.length > 0 ? { steps } : {}),\n\t\t...(depth < MAX_DEPTH && Array.isArray(raw.children) ? { children: raw.children.map((child) => sanitizeSummary(child, depth + 1)).filter((child): child is NestedRunSummary => Boolean(child)).slice(0, MAX_CHILDREN) } : {}),\n\t};\n}\n\nfunction parseRecord(content: string, route: NestedRoute): NestedEventRecord | undefined {\n\tif (Buffer.byteLength(content, \"utf-8\") > MAX_EVENT_BYTES) return undefined;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(content);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!parsed || typeof parsed !== \"object\") return undefined;\n\tconst raw = parsed as Record<string, unknown>;\n\tif (raw.type !== \"subagent.nested.started\" && raw.type !== \"subagent.nested.updated\" && raw.type !== \"subagent.nested.completed\") return undefined;\n\tif (raw.rootRunId !== route.rootRunId || raw.capabilityToken !== route.capabilityToken) return undefined;\n\tif (!isSafeNestedId(raw.parentRunId)) return undefined;\n\tconst ts = clampNumber(raw.ts);\n\tif (ts === undefined) return undefined;\n\tconst child = sanitizeSummary(raw.child);\n\tif (!child || child.id === route.rootRunId) return undefined;\n\tconst routedChild: NestedRunSummary = {\n\t\t...child,\n\t\tcontrolInbox: route.controlInbox,\n\t\tcapabilityToken: route.capabilityToken,\n\t\townerState: child.ownerState ?? \"unknown\",\n\t};\n\treturn {\n\t\ttype: raw.type,\n\t\tts,\n\t\trootRunId: route.rootRunId,\n\t\tparentRunId: raw.parentRunId,\n\t\t...(clampNumber(raw.parentStepIndex) !== undefined ? { parentStepIndex: clampNumber(raw.parentStepIndex) } : {}),\n\t\tcapabilityToken: route.capabilityToken,\n\t\tchild: routedChild,\n\t};\n}\n\nexport function parseNestedEventRecords(content: string, route: NestedRoute): NestedEventRecord[] {\n\tif (!content.includes(\"\\n\")) {\n\t\tconst record = parseRecord(content.trim(), route);\n\t\treturn record ? [record] : [];\n\t}\n\treturn content.split(\"\\n\")\n\t\t.slice(0, content.endsWith(\"\\n\") ? undefined : -1)\n\t\t.map((line) => line.trim() ? parseRecord(line, route) : undefined)\n\t\t.filter((event): event is NestedEventRecord => Boolean(event));\n}\n\nfunction terminal(state: NestedRunState): boolean {\n\treturn state === \"complete\" || state === \"failed\" || state === \"paused\" || state === \"stopped\";\n}\n\nfunction mergeSummary(existing: NestedRunSummary | undefined, event: NestedEventRecord): NestedRunSummary {\n\tconst incomingState = event.type === \"subagent.nested.completed\" && event.child.state === \"running\" ? \"complete\" : event.child.state;\n\tconst incoming = { ...event.child, state: incomingState, lastUpdate: event.child.lastUpdate ?? event.ts };\n\tif (!existing) return incoming;\n\tconst existingUpdate = existing.lastUpdate ?? 0;\n\tconst incomingUpdate = incoming.lastUpdate ?? event.ts;\n\tif (incomingUpdate < existingUpdate) return existing;\n\tif (terminal(existing.state) && !terminal(incoming.state)) return existing;\n\tif (terminal(existing.state) && terminal(incoming.state) && incomingUpdate === existingUpdate) return existing;\n\treturn { ...existing, ...incoming, state: incoming.state, lastUpdate: Math.max(existingUpdate, incomingUpdate) };\n}\n\nfunction attachChild(children: NestedRunSummary[], event: NestedEventRecord): NestedRunSummary[] {\n\tlet updated = false;\n\tconst walk = (items: NestedRunSummary[]): NestedRunSummary[] => items.map((item) => {\n\t\tif (item.id === event.parentRunId) {\n\t\t\tconst existingChildren = item.children ?? [];\n\t\t\tconst childIndex = existingChildren.findIndex((child) => child.id === event.child.id);\n\t\t\tconst nextChild = mergeSummary(childIndex >= 0 ? existingChildren[childIndex] : undefined, event);\n\t\t\tconst nextChildren = childIndex >= 0\n\t\t\t\t? existingChildren.map((child, index) => index === childIndex ? nextChild : child)\n\t\t\t\t: [...existingChildren, nextChild];\n\t\t\tupdated = true;\n\t\t\treturn { ...item, children: nextChildren.slice(0, MAX_CHILDREN), lastUpdate: Math.max(item.lastUpdate ?? 0, event.ts) };\n\t\t}\n\t\tif (!item.children?.length) return item;\n\t\tconst nextChildren = walk(item.children);\n\t\treturn nextChildren === item.children ? item : { ...item, children: nextChildren };\n\t});\n\tconst next = walk(children);\n\tif (updated) return next;\n\tconst childIndex = next.findIndex((child) => child.id === event.child.id);\n\tconst nextChild = mergeSummary(childIndex >= 0 ? next[childIndex] : undefined, event);\n\treturn childIndex >= 0\n\t\t? next.map((child, index) => index === childIndex ? nextChild : child)\n\t\t: [...next, nextChild].slice(0, MAX_CHILDREN);\n}\n\nexport function applyNestedEvent(registry: NestedRegistry, event: NestedEventRecord): NestedRegistry {\n\treturn {\n\t\t...registry,\n\t\tupdatedAt: Math.max(registry.updatedAt, event.ts),\n\t\tchildren: attachChild(registry.children, event),\n\t};\n}\n\nfunction registryPath(route: NestedRoute): string {\n\treturn path.join(commonRouteRoot(route), REGISTRY_FILE);\n}\n\nexport function findNestedRouteForRootId(rootRunId: string): NestedRoute | undefined {\n\tassertSafeId(\"rootRunId\", rootRunId);\n\tlet entries: string[];\n\ttry {\n\t\tentries = fs.readdirSync(NESTED_EVENTS_DIR);\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n\t\tthrow error;\n\t}\n\tfor (const entry of entries) {\n\t\tif (!entry.startsWith(`${rootRunId}-`)) continue;\n\t\tconst routeRoot = path.join(NESTED_EVENTS_DIR, entry);\n\t\ttry {\n\t\t\tconst metadata = JSON.parse(fs.readFileSync(path.join(routeRoot, ROUTE_FILE), \"utf-8\")) as { rootRunId?: unknown; capabilityToken?: unknown };\n\t\t\tif (metadata.rootRunId !== rootRunId || typeof metadata.capabilityToken !== \"string\") continue;\n\t\t\tconst route = {\n\t\t\t\trootRunId,\n\t\t\t\teventSink: path.join(routeRoot, \"events\"),\n\t\t\t\tcontrolInbox: path.join(routeRoot, \"controls\"),\n\t\t\t\tcapabilityToken: metadata.capabilityToken,\n\t\t\t};\n\t\t\tvalidateRouteShape(route);\n\t\t\treturn route;\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\treturn undefined;\n}\n\n/**\n * Scan the nested-events directory once and index every route by its root run\n * id. Use this when resolving routes for many runs (e.g. listAsyncRuns) so the\n * cost is O(routes) total instead of O(runs * routes) from calling\n * findNestedRouteForRootId per run.\n */\nexport function buildNestedRouteIndex(): Map<string, NestedRoute> {\n\tlet entries: string[];\n\ttry {\n\t\tentries = fs.readdirSync(NESTED_EVENTS_DIR);\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return new Map();\n\t\tthrow error;\n\t}\n\tconst index = new Map<string, NestedRoute>();\n\tfor (const entry of entries) {\n\t\tconst routeRoot = path.join(NESTED_EVENTS_DIR, entry);\n\t\ttry {\n\t\t\tconst metadata = JSON.parse(fs.readFileSync(path.join(routeRoot, ROUTE_FILE), \"utf-8\")) as { rootRunId?: unknown; capabilityToken?: unknown };\n\t\t\tif (typeof metadata.rootRunId !== \"string\" || typeof metadata.capabilityToken !== \"string\") continue;\n\t\t\tif (index.has(metadata.rootRunId)) continue;\n\t\t\tconst route: NestedRoute = {\n\t\t\t\trootRunId: metadata.rootRunId,\n\t\t\t\teventSink: path.join(routeRoot, \"events\"),\n\t\t\t\tcontrolInbox: path.join(routeRoot, \"controls\"),\n\t\t\t\tcapabilityToken: metadata.capabilityToken,\n\t\t\t};\n\t\t\tvalidateRouteShape(route);\n\t\t\tindex.set(metadata.rootRunId, route);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\treturn index;\n}\n\nexport function projectNestedRegistryForRoot(rootRunId: string): NestedRegistry | undefined {\n\tconst route = findNestedRouteForRootId(rootRunId);\n\treturn route ? projectNestedEvents(route) : undefined;\n}\n\nexport function findNestedRun(children: NestedRunSummary[] | undefined, id: string): NestedRunSummary | undefined {\n\tif (!children?.length) return undefined;\n\tfor (const child of children) {\n\t\tif (child.id === id) return child;\n\t\tconst nested = findNestedRun(child.children, id) ?? findNestedRun(child.steps?.flatMap((step) => step.children ?? []), id);\n\t\tif (nested) return nested;\n\t}\n\treturn undefined;\n}\n\nexport interface NestedRunMatch {\n\trootRunId: string;\n\troute: NestedRoute;\n\trun: NestedRunSummary;\n}\n\nexport interface NestedRunResolutionScope {\n\troutes: NestedRoute[];\n\tdescendantOf?: { parentRunId: string; parentStepIndex?: number };\n}\n\nfunction collectNestedRuns(children: NestedRunSummary[] | undefined, output: NestedRunSummary[] = []): NestedRunSummary[] {\n\tfor (const child of children ?? []) {\n\t\toutput.push(child);\n\t\tcollectNestedRuns(child.children, output);\n\t\tcollectNestedRuns(child.steps?.flatMap((step) => step.children ?? []), output);\n\t}\n\treturn output;\n}\n\nfunction collectScopedNestedRuns(children: NestedRunSummary[] | undefined, scope: NestedRunResolutionScope[\"descendantOf\"], output: NestedRunSummary[] = []): NestedRunSummary[] {\n\tif (!scope) return collectNestedRuns(children, output);\n\tfor (const child of children ?? []) {\n\t\tif (child.parentRunId === scope.parentRunId && (scope.parentStepIndex === undefined || child.parentStepIndex === scope.parentStepIndex)) {\n\t\t\tcollectNestedRuns([child], output);\n\t\t\tcontinue;\n\t\t}\n\t\tcollectScopedNestedRuns(child.children, scope, output);\n\t\tcollectScopedNestedRuns(child.steps?.flatMap((step) => step.children ?? []), scope, output);\n\t}\n\treturn output;\n}\n\nfunction listNestedRoutes(): NestedRoute[] {\n\tlet entries: string[];\n\ttry {\n\t\tentries = fs.readdirSync(NESTED_EVENTS_DIR);\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code === \"ENOENT\") return [];\n\t\tthrow error;\n\t}\n\tconst routes: NestedRoute[] = [];\n\tfor (const entry of entries) {\n\t\tconst routeRoot = path.join(NESTED_EVENTS_DIR, entry);\n\t\ttry {\n\t\t\tconst metadata = JSON.parse(fs.readFileSync(path.join(routeRoot, ROUTE_FILE), \"utf-8\")) as { rootRunId?: unknown; capabilityToken?: unknown };\n\t\t\tif (typeof metadata.rootRunId !== \"string\" || typeof metadata.capabilityToken !== \"string\") continue;\n\t\t\tconst route = {\n\t\t\t\trootRunId: metadata.rootRunId,\n\t\t\t\teventSink: path.join(routeRoot, \"events\"),\n\t\t\t\tcontrolInbox: path.join(routeRoot, \"controls\"),\n\t\t\t\tcapabilityToken: metadata.capabilityToken,\n\t\t\t};\n\t\t\tvalidateRouteShape(route);\n\t\t\troutes.push(route);\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\treturn routes;\n}\n\nexport function findNestedRunMatchesById(id: string, options: { prefix?: boolean; scope?: NestedRunResolutionScope } = {}): NestedRunMatch[] {\n\tassertSafeId(\"id\", id);\n\tconst matches: NestedRunMatch[] = [];\n\tfor (const route of options.scope?.routes ?? listNestedRoutes()) {\n\t\ttry {\n\t\t\tconst registry = projectNestedEvents(route);\n\t\t\tfor (const run of collectScopedNestedRuns(registry.children, options.scope?.descendantOf)) {\n\t\t\t\tif (options.prefix ? run.id.startsWith(id) : run.id === id) matches.push({ rootRunId: route.rootRunId, route, run });\n\t\t\t}\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\treturn matches;\n}\n\nexport function findNestedRunById(id: string): { rootRunId: string; run: NestedRunSummary } | undefined {\n\tconst match = findNestedRunMatchesById(id)[0];\n\treturn match ? { rootRunId: match.rootRunId, run: match.run } : undefined;\n}\n\nexport function readNestedRegistry(route: NestedRoute): NestedRegistry {\n\tvalidateRouteShape(route);\n\ttry {\n\t\tconst parsed = JSON.parse(fs.readFileSync(registryPath(route), \"utf-8\")) as NestedRegistry;\n\t\treturn {\n\t\t\trootRunId: route.rootRunId,\n\t\t\tupdatedAt: typeof parsed.updatedAt === \"number\" ? parsed.updatedAt : 0,\n\t\t\tchildren: Array.isArray(parsed.children) ? parsed.children.map((child) => sanitizeSummary(child)).filter((child): child is NestedRunSummary => Boolean(child)) : [],\n\t\t\tprocessedEvents: Array.isArray(parsed.processedEvents) ? parsed.processedEvents.filter((item): item is string => typeof item === \"string\") : [],\n\t\t};\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t\treturn { rootRunId: route.rootRunId, updatedAt: 0, children: [], processedEvents: [] };\n\t}\n}\n\nexport function projectNestedEvents(route: NestedRoute): NestedRegistry {\n\tvalidateRouteShape(route);\n\tlet registry = readNestedRegistry(route);\n\tconst seen = new Set(registry.processedEvents);\n\tlet changed = false;\n\tlet entries: string[] = [];\n\ttry {\n\t\tentries = fs.readdirSync(route.eventSink).filter((entry) => entry.endsWith(\".json\") || entry.endsWith(\".jsonl\")).sort();\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t}\n\tfor (const entry of entries) {\n\t\tif (seen.has(entry)) continue;\n\t\tconst eventPath = path.join(route.eventSink, entry);\n\t\tif (!containedPath(route.eventSink, eventPath)) continue;\n\t\tlet content: string;\n\t\ttry {\n\t\t\tconst stat = fs.statSync(eventPath);\n\t\t\tif (!stat.isFile() || stat.size > MAX_EVENT_BYTES) continue;\n\t\t\tcontent = fs.readFileSync(eventPath, \"utf-8\");\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t\tfor (const event of parseNestedEventRecords(content, route)) {\n\t\t\tregistry = applyNestedEvent(registry, event);\n\t\t\tchanged = true;\n\t\t}\n\t\tseen.add(entry);\n\t\tchanged = true;\n\t}\n\tif (changed) {\n\t\tregistry = { ...registry, processedEvents: [...seen].slice(-1000) };\n\t\t// Parent projection is the only writer to this sidecar registry. Child and\n\t\t// runner processes only create immutable event files, so parent status.json\n\t\t// remains owned by the existing runner writer and is never rewritten here.\n\t\twriteAtomicJson(registryPath(route), registry);\n\t}\n\treturn registry;\n}\n\nfunction writeRouteRecord(dir: string, ts: number, payload: object): string {\n\tconst content = `${JSON.stringify(payload)}\\n`;\n\tif (Buffer.byteLength(content, \"utf-8\") > MAX_EVENT_BYTES) throw new Error(\"Nested route record exceeds the maximum size.\");\n\tfs.mkdirSync(dir, { recursive: true, mode: 0o700 });\n\tconst name = `${String(ts).padStart(13, \"0\")}-${randomUUID()}.json`;\n\tconst tmp = path.join(dir, `.${name}.tmp`);\n\tconst finalPath = path.join(dir, name);\n\tfs.writeFileSync(tmp, content, { mode: 0o600 });\n\tfs.renameSync(tmp, finalPath);\n\treturn finalPath;\n}\n\nexport function writeNestedEvent(route: NestedRoute, event: Omit<NestedEventRecord, \"rootRunId\" | \"capabilityToken\">): void {\n\tvalidateRouteShape(route);\n\tconst record: NestedEventRecord = {\n\t\t...event,\n\t\trootRunId: route.rootRunId,\n\t\tcapabilityToken: route.capabilityToken,\n\t};\n\tconst sanitized = parseRecord(JSON.stringify(record), route);\n\tif (!sanitized) throw new Error(\"Nested event record failed validation.\");\n\twriteRouteRecord(route.eventSink, sanitized.ts, sanitized);\n}\n\nfunction parseControlRequest(content: string, route: NestedRoute): NestedControlRequestRecord | undefined {\n\tif (Buffer.byteLength(content, \"utf-8\") > MAX_EVENT_BYTES) return undefined;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(content);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!parsed || typeof parsed !== \"object\") return undefined;\n\tconst raw = parsed as Record<string, unknown>;\n\tif (raw.type !== \"subagent.nested.control-request\") return undefined;\n\tif (raw.rootRunId !== route.rootRunId || raw.capabilityToken !== route.capabilityToken) return undefined;\n\tif (!isSafeNestedId(raw.requestId) || !isSafeNestedId(raw.targetRunId)) return undefined;\n\tif (raw.action !== \"interrupt\" && raw.action !== \"resume\") return undefined;\n\tconst ts = clampNumber(raw.ts);\n\tif (ts === undefined) return undefined;\n\treturn {\n\t\ttype: \"subagent.nested.control-request\",\n\t\tts,\n\t\trootRunId: route.rootRunId,\n\t\tcapabilityToken: route.capabilityToken,\n\t\trequestId: raw.requestId,\n\t\ttargetRunId: raw.targetRunId,\n\t\taction: raw.action,\n\t\t...(stringValue(raw.message, 16_000) ? { message: stringValue(raw.message, 16_000) } : {}),\n\t};\n}\n\nfunction parseControlResult(content: string, route: NestedRoute): NestedControlResultRecord | undefined {\n\tif (Buffer.byteLength(content, \"utf-8\") > MAX_EVENT_BYTES) return undefined;\n\tlet parsed: unknown;\n\ttry {\n\t\tparsed = JSON.parse(content);\n\t} catch {\n\t\treturn undefined;\n\t}\n\tif (!parsed || typeof parsed !== \"object\") return undefined;\n\tconst raw = parsed as Record<string, unknown>;\n\tif (raw.type !== \"subagent.nested.control-result\") return undefined;\n\tif (raw.rootRunId !== route.rootRunId || raw.capabilityToken !== route.capabilityToken) return undefined;\n\tif (!isSafeNestedId(raw.requestId) || !isSafeNestedId(raw.targetRunId)) return undefined;\n\tconst ts = clampNumber(raw.ts);\n\tif (ts === undefined || typeof raw.ok !== \"boolean\") return undefined;\n\treturn {\n\t\ttype: \"subagent.nested.control-result\",\n\t\tts,\n\t\trootRunId: route.rootRunId,\n\t\tcapabilityToken: route.capabilityToken,\n\t\trequestId: raw.requestId,\n\t\ttargetRunId: raw.targetRunId,\n\t\tok: raw.ok,\n\t\tmessage: stringValue(raw.message, 16_000) ?? (raw.ok ? \"Control request completed.\" : \"Control request failed.\"),\n\t};\n}\n\nexport function writeNestedControlRequest(route: NestedRoute, request: Omit<NestedControlRequestRecord, \"type\" | \"rootRunId\" | \"capabilityToken\">): string {\n\tvalidateRouteShape(route);\n\tassertSafeId(\"requestId\", request.requestId);\n\tassertSafeId(\"targetRunId\", request.targetRunId);\n\tconst record: NestedControlRequestRecord = {\n\t\ttype: \"subagent.nested.control-request\",\n\t\t...request,\n\t\trootRunId: route.rootRunId,\n\t\tcapabilityToken: route.capabilityToken,\n\t};\n\tconst sanitized = parseControlRequest(JSON.stringify(record), route);\n\tif (!sanitized) throw new Error(\"Nested control request failed validation.\");\n\treturn writeRouteRecord(route.controlInbox, sanitized.ts, sanitized);\n}\n\nexport function readNestedControlRequests(route: NestedRoute): Array<NestedControlRequestRecord & { filePath: string }> {\n\tvalidateRouteShape(route);\n\tlet entries: string[] = [];\n\ttry {\n\t\tentries = fs.readdirSync(route.controlInbox).filter((entry) => entry.endsWith(\".json\")).sort();\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t}\n\tconst requests: Array<NestedControlRequestRecord & { filePath: string }> = [];\n\tfor (const entry of entries) {\n\t\tconst filePath = path.join(route.controlInbox, entry);\n\t\tif (!containedPath(route.controlInbox, filePath)) continue;\n\t\ttry {\n\t\t\tconst stat = fs.statSync(filePath);\n\t\t\tif (!stat.isFile() || stat.size > MAX_EVENT_BYTES) continue;\n\t\t\tconst request = parseControlRequest(fs.readFileSync(filePath, \"utf-8\"), route);\n\t\t\tif (request) requests.push({ ...request, filePath });\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\treturn requests;\n}\n\nexport function writeNestedControlResult(route: NestedRoute, result: Omit<NestedControlResultRecord, \"type\" | \"rootRunId\" | \"capabilityToken\">): void {\n\tvalidateRouteShape(route);\n\tassertSafeId(\"requestId\", result.requestId);\n\tassertSafeId(\"targetRunId\", result.targetRunId);\n\tconst record: NestedControlResultRecord = {\n\t\ttype: \"subagent.nested.control-result\",\n\t\t...result,\n\t\trootRunId: route.rootRunId,\n\t\tcapabilityToken: route.capabilityToken,\n\t};\n\tconst sanitized = parseControlResult(JSON.stringify(record), route);\n\tif (!sanitized) throw new Error(\"Nested control result failed validation.\");\n\twriteRouteRecord(route.eventSink, sanitized.ts, sanitized);\n}\n\nexport function readNestedControlResults(route: NestedRoute): NestedControlResultRecord[] {\n\tvalidateRouteShape(route);\n\tlet entries: string[] = [];\n\ttry {\n\t\tentries = fs.readdirSync(route.eventSink).filter((entry) => entry.endsWith(\".json\") || entry.endsWith(\".jsonl\")).sort();\n\t} catch (error) {\n\t\tif ((error as NodeJS.ErrnoException).code !== \"ENOENT\") throw error;\n\t}\n\tconst results: NestedControlResultRecord[] = [];\n\tfor (const entry of entries) {\n\t\tconst eventPath = path.join(route.eventSink, entry);\n\t\tif (!containedPath(route.eventSink, eventPath)) continue;\n\t\ttry {\n\t\t\tconst stat = fs.statSync(eventPath);\n\t\t\tif (!stat.isFile() || stat.size > MAX_EVENT_BYTES) continue;\n\t\t\tconst content = fs.readFileSync(eventPath, \"utf-8\");\n\t\t\tconst lines = content.includes(\"\\n\") ? content.split(\"\\n\").filter((line) => line.trim()) : [content];\n\t\t\tfor (const line of lines) {\n\t\t\t\tconst result = parseControlResult(line, route);\n\t\t\t\tif (result) results.push(result);\n\t\t\t}\n\t\t} catch {\n\t\t\tcontinue;\n\t\t}\n\t}\n\treturn results;\n}\n\nexport function nestedRouteEnv(route: NestedRoute): Record<string, string> {\n\treturn {\n\t\t[SUBAGENT_PARENT_EVENT_SINK_ENV]: route.eventSink,\n\t\t[SUBAGENT_PARENT_CONTROL_INBOX_ENV]: route.controlInbox,\n\t\t[SUBAGENT_PARENT_ROOT_RUN_ID_ENV]: route.rootRunId,\n\t\t[SUBAGENT_PARENT_CAPABILITY_TOKEN_ENV]: route.capabilityToken,\n\t};\n}\n\nexport function attachRootChildrenToSteps<T extends { children?: NestedRunSummary[]; index?: number }>(rootRunId: string, steps: T[] | undefined, children: NestedRunSummary[] | undefined): void {\n\tif (!steps?.length) return;\n\tfor (const step of steps) {\n\t\tstep.children = undefined;\n\t}\n\tif (!children?.length) return;\n\tfor (const child of children) {\n\t\tif (child.parentRunId !== rootRunId || child.parentStepIndex === undefined) continue;\n\t\tconst step = steps.find((candidate, index) => (candidate.index ?? index) === child.parentStepIndex);\n\t\tif (!step) continue;\n\t\tstep.children ??= [];\n\t\tstep.children = [...step.children.filter((existing) => existing.id !== child.id), child].slice(0, MAX_CHILDREN);\n\t}\n}\n\nexport function updateAsyncJobNestedProjection(job: AsyncJobState): void {\n\tif (!job.nestedRoute) return;\n\tconst registry = projectNestedEvents(job.nestedRoute);\n\tjob.nestedChildren = registry.children;\n\tattachRootChildrenToSteps(job.asyncId, job.steps, registry.children);\n}\n\nexport function updateForegroundNestedProjection(control: SubagentState[\"foregroundControls\"] extends Map<string, infer T> ? T : never): void {\n\tif (!control.nestedRoute) return;\n\tconst registry = projectNestedEvents(control.nestedRoute);\n\tcontrol.nestedChildren = registry.children;\n}\n\nexport function hasLiveNestedDescendants(children: NestedRunSummary[] | undefined): boolean {\n\tif (!children?.length) return false;\n\tfor (const child of children) {\n\t\tif (!terminal(child.state)) return true;\n\t\tif (hasLiveNestedDescendants(child.children)) return true;\n\t\tif (hasLiveNestedDescendants(child.steps?.flatMap((step) => step.children ?? []))) return true;\n\t}\n\treturn false;\n}\n\nexport function nestedSummaryFromAsyncStatus(status: AsyncStatus, asyncDir: string, fallback: { id: string; parentRunId: string; parentStepIndex?: number; depth: number; path?: Array<{ runId: string; stepIndex?: number; agent?: string }>; mode?: SubagentRunMode; ts: number }): NestedRunSummary {\n\treturn {\n\t\tid: status.runId || fallback.id,\n\t\tparentRunId: fallback.parentRunId,\n\t\t...(fallback.parentStepIndex !== undefined ? { parentStepIndex: fallback.parentStepIndex } : {}),\n\t\tdepth: fallback.depth,\n\t\tpath: fallback.path ?? [{ runId: fallback.parentRunId, ...(fallback.parentStepIndex !== undefined ? { stepIndex: fallback.parentStepIndex } : {}) }],\n\t\tasyncDir,\n\t\t...(status.pid ? { pid: status.pid } : {}),\n\t\t...(status.sessionId ? { sessionId: status.sessionId } : {}),\n\t\tmode: status.mode ?? fallback.mode,\n\t\tstate: status.state,\n\t\t...(status.currentStep !== undefined ? { currentStep: status.currentStep } : {}),\n\t\t...(status.chainStepCount !== undefined ? { chainStepCount: status.chainStepCount } : {}),\n\t\t...(status.activityState ? { activityState: status.activityState } : {}),\n\t\t...(status.lastActivityAt !== undefined ? { lastActivityAt: status.lastActivityAt } : {}),\n\t\t...(status.currentTool ? { currentTool: status.currentTool } : {}),\n\t\t...(status.currentToolStartedAt !== undefined ? { currentToolStartedAt: status.currentToolStartedAt } : {}),\n\t\t...(status.currentPath ? { currentPath: status.currentPath } : {}),\n\t\t...(status.turnCount !== undefined ? { turnCount: status.turnCount } : {}),\n\t\t...(status.toolCount !== undefined ? { toolCount: status.toolCount } : {}),\n\t\t...(status.totalTokens ? { totalTokens: status.totalTokens } : {}),\n\t\t...(status.timeoutMs !== undefined ? { timeoutMs: status.timeoutMs } : {}),\n\t\t...(status.deadlineAt !== undefined ? { deadlineAt: status.deadlineAt } : {}),\n\t\t...(status.timedOut !== undefined ? { timedOut: status.timedOut } : {}),\n\t\t...(status.stopped !== undefined ? { stopped: status.stopped } : {}),\n\t\t...(status.turnBudget ? { turnBudget: status.turnBudget } : {}),\n\t\t...(status.turnBudgetExceeded !== undefined ? { turnBudgetExceeded: status.turnBudgetExceeded } : {}),\n\t\t...(status.wrapUpRequested !== undefined ? { wrapUpRequested: status.wrapUpRequested } : {}),\n\t\t...(status.error ? { error: status.error } : {}),\n\t\t...(status.startedAt !== undefined ? { startedAt: status.startedAt } : { startedAt: fallback.ts }),\n\t\t...(status.endedAt !== undefined ? { endedAt: status.endedAt } : {}),\n\t\tlastUpdate: status.lastUpdate ?? fallback.ts,\n\t\t...(status.sessionFile ? { sessionFile: status.sessionFile } : {}),\n\t\t...(status.steps?.length ? { steps: status.steps.map((step) => ({\n\t\t\tagent: step.agent,\n\t\t\tstatus: step.status,\n\t\t\t...(step.sessionFile ? { sessionFile: step.sessionFile } : {}),\n\t\t\t...(step.activityState ? { activityState: step.activityState } : {}),\n\t\t\t...(step.lastActivityAt !== undefined ? { lastActivityAt: step.lastActivityAt } : {}),\n\t\t\t...(step.currentTool ? { currentTool: step.currentTool } : {}),\n\t\t\t...(step.currentToolStartedAt !== undefined ? { currentToolStartedAt: step.currentToolStartedAt } : {}),\n\t\t\t...(step.currentPath ? { currentPath: step.currentPath } : {}),\n\t\t\t...(step.turnCount !== undefined ? { turnCount: step.turnCount } : {}),\n\t\t\t...(step.toolCount !== undefined ? { toolCount: step.toolCount } : {}),\n\t\t\t...(step.startedAt !== undefined ? { startedAt: step.startedAt } : {}),\n\t\t\t...(step.endedAt !== undefined ? { endedAt: step.endedAt } : {}),\n\t\t\t...(step.error ? { error: step.error } : {}),\n\t\t\t...(step.timedOut !== undefined ? { timedOut: step.timedOut } : {}),\n\t\t\t...(step.stopped !== undefined ? { stopped: step.stopped } : {}),\n\t\t\t...(step.turnBudget ? { turnBudget: step.turnBudget } : {}),\n\t\t\t...(step.turnBudgetExceeded !== undefined ? { turnBudgetExceeded: step.turnBudgetExceeded } : {}),\n\t\t\t...(step.wrapUpRequested !== undefined ? { wrapUpRequested: step.wrapUpRequested } : {}),\n\t\t})).slice(0, MAX_STEPS) } : {}),\n\t};\n}\n\nexport function nestedArtifactEnv(rootRunId: string, parentRunId: string): Record<string, string> {\n\treturn {\n\t\tPI_SUBAGENT_NESTED_ROOT_RUN_ID: rootRunId,\n\t\tPI_SUBAGENT_NESTED_PARENT_RUN_ID: parentRunId,\n\t};\n}\n\nexport function isTopLevelAsyncDir(asyncDir: string): boolean {\n\tconst resolved = path.resolve(asyncDir);\n\treturn containedPath(ASYNC_DIR, resolved) && !containedPath(path.join(TEMP_ROOT_DIR, \"nested-subagent-runs\"), resolved);\n}\n\nexport function nestedResultsPath(rootRunId: string, id: string): string {\n\tassertSafeId(\"rootRunId\", rootRunId);\n\tassertSafeId(\"id\", id);\n\treturn path.join(RESULTS_DIR, \"nested\", rootRunId, `${id}.json`);\n}\n"]}