pi-subagents 0.69.0 → 0.70.0

package/src/runs/shared/model-scope.js

@@ -0,0 +1,156 @@
+/**
+ * Optional model-scope enforcement for subagent model resolution.
+ *
+ * When `subagents.modelScope.enforce` is enabled in settings, a resolved model
+ * that does not match any `allow` pattern is rejected. The severity depends on
+ * where the model came from: an explicit caller-supplied model (`--model`,
+ * tool-call `model`, or a TUI clarify pick) is a hard error, while a model
+ * inherited from agent frontmatter / `defaultModel` / the parent session only
+ * emits a warning so existing configurations keep working. Optional strict
+ * enforcement makes inherited models hard errors too.
+ *
+ * The decision logic ({@link checkModelScope}) is a pure function of its
+ * inputs so it can be unit-tested without touching the filesystem or config.
+ */
+import { splitKnownThinkingSuffix } from "../../shared/model-info.js";
+function stripThinkingSuffix(model) {
+    return splitKnownThinkingSuffix(model).baseModel;
+}
+/** Escape RegExp specials except `*`, then turn `*` into `.*`. */
+function globToRegExp(pattern) {
+    const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, ".*");
+    return new RegExp(`^${escaped}$`, "i");
+}
+/**
+ * Test whether a resolved model matches a single allow pattern. Both sides are
+ * compared case-insensitively against the full `provider/id` (thinking suffix
+ * stripped from the model).
+ */
+export function matchesScopePattern(model, pattern) {
+    return globToRegExp(pattern).test(stripThinkingSuffix(model));
+}
+/**
+ * Pure scope decision. Returns a {@link ModelScopeViolation} when the model is
+ * out of scope and enforcement is on, otherwise `undefined`. Enforcement with
+ * no `allow` list is a no-op (the settings parser rejects that combination, but
+ * this stays defensive for callers that build configs programmatically).
+ */
+export function checkModelScope(model, scope, source) {
+    if (!model || !scope?.enforce)
+        return undefined;
+    const allow = scope.allow;
+    if (!allow || allow.length === 0)
+        return undefined;
+    if (allow.some((pattern) => matchesScopePattern(model, pattern)))
+        return undefined;
+    const baseModel = stripThinkingSuffix(model);
+    const severity = source === "explicit" || scope.strict === true ? "error" : "warn";
+    const origin = scope.origin ?? "modelScope";
+    return {
+        model: baseModel,
+        severity,
+        allowedPatterns: allow,
+        origin,
+        message: `Model '${baseModel}' is outside the configured subagent model scope (${origin}). ` +
+            `Allowed patterns: ${allow.join(", ")}.`,
+    };
+}
+function expandInheritPattern(pattern, parentModel) {
+    return pattern === "inherit" && parentModel ? `${parentModel.provider}/${parentModel.id}` : pattern;
+}
+function assertRecord(value, field, meta, expected = "an object") {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected ${expected}.`);
+    }
+    return value;
+}
+function parseAllowList(value, field, meta) {
+    if (!Array.isArray(value)) {
+        throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected an array of strings.`);
+    }
+    const allow = [];
+    for (const entry of value) {
+        if (typeof entry !== "string") {
+            throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected an array of strings.`);
+        }
+        const trimmed = entry.trim();
+        if (trimmed)
+            allow.push(trimmed);
+    }
+    if (allow.length === 0) {
+        throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}'; expected a non-empty array of patterns.`);
+    }
+    return allow;
+}
+function parseScopeRule(input, field, meta) {
+    const rule = {};
+    if ("enforce" in input) {
+        if (typeof input.enforce !== "boolean")
+            throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}.enforce'; expected a boolean.`);
+        rule.enforce = input.enforce;
+    }
+    if ("strict" in input) {
+        if (typeof input.strict !== "boolean")
+            throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}.strict'; expected a boolean.`);
+        rule.strict = input.strict;
+    }
+    if ("allow" in input)
+        rule.allow = parseAllowList(input.allow, `${field}.allow`, meta);
+    return rule;
+}
+/** Resolve the global and matching agent policies into independent launch-time checks. */
+export function resolveModelScopesForAgent(config, agentName, parentModel) {
+    if (!config)
+        return [];
+    const scopes = [];
+    if (config.allow) {
+        scopes.push({
+            ...(config.enforce !== undefined ? { enforce: config.enforce } : {}),
+            ...(config.strict !== undefined ? { strict: config.strict } : {}),
+            allow: config.allow.map((pattern) => expandInheritPattern(pattern, parentModel)),
+            origin: "modelScope",
+        });
+    }
+    const agentScope = config.agents?.[agentName];
+    if (agentScope?.allow) {
+        scopes.push({
+            enforce: agentScope.enforce ?? config.enforce,
+            strict: agentScope.strict ?? config.strict,
+            allow: agentScope.allow.map((pattern) => expandInheritPattern(pattern, parentModel)),
+            origin: `modelScope.agents.${agentName}`,
+        });
+    }
+    return scopes;
+}
+/**
+ * Validate and normalize a raw `subagents.modelScope` value from settings.
+ * Throws a descriptive error for malformed configs (matching the surrounding
+ * settings-parsing style). Returns `undefined` when the field is absent.
+ */
+export function parseModelScopeConfig(value, meta) {
+    if (value === undefined)
+        return undefined;
+    const input = assertRecord(value, "modelScope", meta);
+    const config = parseScopeRule(input, "modelScope", meta);
+    if ("agents" in input) {
+        const agents = {};
+        for (const [rawName, rawScope] of Object.entries(assertRecord(input.agents, "modelScope.agents", meta, "an object keyed by agent name"))) {
+            const name = rawName.trim();
+            const field = `modelScope.agents.${name}`;
+            if (!name)
+                throw new Error(`Subagent settings in '${meta.filePath}' have invalid 'modelScope.agents' key; expected a non-empty agent name.`);
+            const agentInput = assertRecord(rawScope, field, meta);
+            if ("agents" in agentInput) {
+                throw new Error(`Subagent settings in '${meta.filePath}' have invalid '${field}.agents'; nested agent scopes are not supported.`);
+            }
+            agents[name] = parseScopeRule(agentInput, field, meta);
+        }
+        config.agents = agents;
+    }
+    const hasAnyAllow = Boolean(config.allow?.length) || Object.values(config.agents ?? {}).some((scope) => Boolean(scope.allow?.length));
+    if (config.enforce === true && !hasAnyAllow) {
+        throw new Error(`Subagent settings in '${meta.filePath}' set modelScope.enforce without a non-empty 'allow' list; supply allowed model patterns or disable enforcement.`);
+    }
+    return Object.keys(config).length > 0 ? config : undefined;
+}
+//# sourceMappingURL=model-scope.js.map

package/src/runs/shared/model-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-scope.js","sourceRoot":"","sources":["../../../../src/runs/shared/model-scope.ts"],"names":[],"mappings":"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"}

package/src/runs/shared/mutation-evidence.d.ts

@@ -0,0 +1,19 @@
+import type { ArtifactPaths, TimeoutRecoveryProjection, TimeoutRecoverySummary, TrackedMutationEvidence, TrackedMutationSnapshot } from "../../shared/types.ts";
+export declare function snapshotTrackedMutations(cwd: string): TrackedMutationSnapshot;
+export declare function collectTrackedMutationEvidence(snapshot: TrackedMutationSnapshot, cwd?: string): TrackedMutationEvidence;
+/** Keep status and completion details to bounded routing evidence, not raw output or effects. */
+export declare function projectTimeoutRecovery(value: unknown): TimeoutRecoveryProjection | undefined;
+/** Render only the bounded recovery route needed by a parent/operator. */
+export declare function formatTimeoutRecoveryLines(value: unknown, indent?: string): string[];
+export declare function buildTimeoutRecoverySummary(input: {
+    termination: "timed-out" | "stopped";
+    evidence: TrackedMutationEvidence;
+    requiredOutputMissing?: boolean;
+    currentTool?: string;
+    currentToolArgs?: string;
+    currentPath?: string;
+    sessionFile?: string;
+    transcriptPath?: string;
+    artifactPaths?: ArtifactPaths;
+}): TimeoutRecoverySummary;
+//# sourceMappingURL=mutation-evidence.d.ts.map

package/src/runs/shared/mutation-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-evidence.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/mutation-evidence.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,yBAAyB,EAAE,sBAAsB,EAAE,uBAAuB,EAA8B,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AA6D5L,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,uBAAuB,CAS7E;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,uBAAuB,EAAE,GAAG,SAAe,GAAG,uBAAuB,CA2B7H;AAQD,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,GAAG,SAAS,CAqB5F;AAED,0EAA0E;AAC1E,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,SAAK,GAAG,MAAM,EAAE,CAWhF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IAClD,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;IACrC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC9B,GAAG,sBAAsB,CAsCzB"}

package/src/runs/shared/mutation-evidence.js

@@ -0,0 +1,199 @@
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+const MAX_TRACKED_PATHS = 500;
+const MAX_HASH_BYTES = 1024 * 1024;
+const MAX_TIMEOUT_FILES = 20;
+function gitArguments(args) {
+    // Mutation evidence must not block child startup on a stale fsmonitor daemon.
+    return ["-c", "core.fsmonitor=false", ...args];
+}
+function gitOutput(cwd, args, maxBuffer = MAX_HASH_BYTES) {
+    return execFileSync("git", gitArguments(args), { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"], maxBuffer, windowsHide: true });
+}
+function splitNul(output) {
+    return output.split("\0").filter((part) => part.length > 0);
+}
+function hashLargeDiff(cwd, relativePath) {
+    const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), "pi-subagents-tracked-diff-"));
+    const diffPath = path.join(tempDir, "diff.patch");
+    try {
+        execFileSync("git", gitArguments(["diff", "--no-ext-diff", "--binary", `--output=${diffPath}`, "HEAD", "--", relativePath]), { cwd, stdio: "ignore", windowsHide: true });
+        const hash = createHash("sha256");
+        const buffer = Buffer.allocUnsafe(64 * 1024);
+        const fd = fs.openSync(diffPath, "r");
+        try {
+            for (;;) {
+                const bytesRead = fs.readSync(fd, buffer, 0, buffer.length, null);
+                if (bytesRead === 0)
+                    break;
+                hash.update(buffer.subarray(0, bytesRead));
+            }
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        return hash.digest("hex");
+    }
+    finally {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+function listChangedTrackedFiles(cwd) {
+    const paths = splitNul(gitOutput(cwd, ["diff", "--no-ext-diff", "--name-only", "-z", "HEAD", "--"], MAX_HASH_BYTES));
+    return { paths: paths.slice(0, MAX_TRACKED_PATHS), truncated: paths.length > MAX_TRACKED_PATHS };
+}
+function fingerprintPath(cwd, relativePath) {
+    try {
+        const diff = gitOutput(cwd, ["diff", "--no-ext-diff", "--binary", "HEAD", "--", relativePath], MAX_HASH_BYTES);
+        return { kind: "diff", digest: createHash("sha256").update(diff).digest("hex") };
+    }
+    catch {
+        return { kind: "diff", digest: hashLargeDiff(cwd, relativePath) };
+    }
+}
+function sameFingerprint(left, right) {
+    if (!left || left.kind !== "diff" || right.kind !== "diff")
+        return false;
+    return left.digest === right.digest;
+}
+export function snapshotTrackedMutations(cwd) {
+    try {
+        const changed = listChangedTrackedFiles(cwd);
+        const fingerprints = {};
+        for (const file of changed.paths)
+            fingerprints[file] = fingerprintPath(cwd, file);
+        return { source: "tracked-files", trackedOnly: true, cwd, dirtyFiles: changed.paths, fingerprints, truncated: changed.truncated };
+    }
+    catch (error) {
+        return { source: "tracked-files", trackedOnly: true, cwd, dirtyFiles: [], fingerprints: {}, unavailable: error instanceof Error ? error.message : String(error) };
+    }
+}
+export function collectTrackedMutationEvidence(snapshot, cwd = snapshot.cwd) {
+    if (snapshot.unavailable) {
+        return { source: "tracked-files", trackedOnly: true, changedFiles: [], attemptedMutation: false, unavailable: snapshot.unavailable };
+    }
+    try {
+        const current = listChangedTrackedFiles(cwd);
+        const startDirty = new Set(snapshot.dirtyFiles);
+        const candidates = new Set([...snapshot.dirtyFiles, ...current.paths]);
+        const changedFiles = [];
+        for (const file of candidates) {
+            if (!startDirty.has(file)) {
+                if (!snapshot.truncated)
+                    changedFiles.push(file);
+                continue;
+            }
+            if (!sameFingerprint(snapshot.fingerprints[file], fingerprintPath(cwd, file)))
+                changedFiles.push(file);
+        }
+        changedFiles.sort();
+        return {
+            source: "tracked-files",
+            trackedOnly: true,
+            changedFiles,
+            attemptedMutation: changedFiles.length > 0,
+            truncated: snapshot.truncated || current.truncated || undefined,
+        };
+    }
+    catch (error) {
+        return { source: "tracked-files", trackedOnly: true, changedFiles: [], attemptedMutation: false, unavailable: error instanceof Error ? error.message : String(error) };
+    }
+}
+function formatPathList(paths) {
+    if (paths.length === 0)
+        return "none";
+    const shown = paths.slice(0, MAX_TIMEOUT_FILES).join(", ");
+    return paths.length > MAX_TIMEOUT_FILES ? `${shown}, ... (${paths.length - MAX_TIMEOUT_FILES} more)` : shown;
+}
+/** Keep status and completion details to bounded routing evidence, not raw output or effects. */
+export function projectTimeoutRecovery(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const source = value;
+    const termination = source.termination === "timed-out" || source.termination === "stopped" ? source.termination : undefined;
+    if (!termination || !Array.isArray(source.changedFiles))
+        return undefined;
+    const allChangedFiles = source.changedFiles.filter((file) => typeof file === "string");
+    const changedFiles = allChangedFiles.slice(0, MAX_TIMEOUT_FILES);
+    const reportStatus = source.reportStatus === "missing"
+        || source.reportStatus === "written"
+        || source.reportStatus === "not-requested"
+        || source.reportStatus === "unknown"
+        ? source.reportStatus
+        : undefined;
+    return {
+        termination,
+        changedFiles,
+        ...(source.truncated === true || allChangedFiles.length > changedFiles.length ? { truncated: true } : {}),
+        ...(source.recoveryNeeded === true ? { recoveryNeeded: true } : {}),
+        ...(source.reason === "timed-out-with-dirty-worktree" ? { reason: source.reason } : {}),
+        ...(reportStatus ? { reportStatus } : {}),
+    };
+}
+/** Render only the bounded recovery route needed by a parent/operator. */
+export function formatTimeoutRecoveryLines(value, indent = "") {
+    const recovery = projectTimeoutRecovery(value);
+    if (!recovery?.recoveryNeeded)
+        return [];
+    const changedFiles = recovery.changedFiles.length > 0
+        ? `${recovery.changedFiles.join(", ")}${recovery.truncated ? ", …" : ""}`
+        : "none";
+    const changedFileCount = recovery.changedFiles.length > 0 ? `${recovery.changedFiles.length}${recovery.truncated ? "+" : ""}` : "0";
+    return [
+        `${indent}Recovery needed: review the diff and artifacts before resuming or launching dependent stages.`,
+        `${indent}Recovery evidence: requested report: ${recovery.reportStatus ?? "unknown"}; changed tracked files: ${changedFiles} (${changedFileCount}); classification: ${recovery.reason ?? recovery.termination}`,
+    ];
+}
+export function buildTimeoutRecoverySummary(input) {
+    const warning = "Inspect partial changes before retrying or resuming the child.";
+    const changedFiles = input.evidence.changedFiles.slice(0, MAX_TIMEOUT_FILES);
+    let reportStatus = "not-requested";
+    if (input.requiredOutputMissing === true)
+        reportStatus = "missing";
+    else if (input.requiredOutputMissing === false)
+        reportStatus = "written";
+    const recoveryNeeded = input.termination === "timed-out"
+        && reportStatus === "missing"
+        && input.evidence.changedFiles.length > 0;
+    const lines = [
+        "Recovery summary:",
+        `- termination: ${input.termination}`,
+        `- changed tracked files: ${input.evidence.unavailable ? `unavailable (${input.evidence.unavailable})` : formatPathList(input.evidence.changedFiles)}`,
+    ];
+    if (input.requiredOutputMissing !== undefined)
+        lines.push(`- requested report: ${reportStatus}`);
+    if (recoveryNeeded)
+        lines.push("- Recovery needed: review the diff and artifacts before resuming or launching dependent stages.");
+    if (input.currentTool)
+        lines.push(`- active tool: ${input.currentTool}${input.currentToolArgs ? ` — ${input.currentToolArgs}` : ""}`);
+    if (input.currentPath)
+        lines.push(`- active path: ${input.currentPath}`);
+    if (input.sessionFile)
+        lines.push(`- session file: ${input.sessionFile}`);
+    if (input.transcriptPath)
+        lines.push(`- transcript: ${input.transcriptPath}`);
+    if (input.artifactPaths?.outputPath)
+        lines.push(`- output artifact: ${input.artifactPaths.outputPath}`);
+    if (input.artifactPaths?.metadataPath)
+        lines.push(`- metadata artifact: ${input.artifactPaths.metadataPath}`);
+    lines.push(`Warning: ${warning}`);
+    return {
+        termination: input.termination,
+        changedFiles,
+        truncated: input.evidence.changedFiles.length > changedFiles.length || input.evidence.truncated || undefined,
+        ...(recoveryNeeded ? { recoveryNeeded: true, reason: "timed-out-with-dirty-worktree" } : {}),
+        reportStatus,
+        currentTool: input.currentTool,
+        currentToolArgs: input.currentToolArgs,
+        currentPath: input.currentPath,
+        sessionFile: input.sessionFile,
+        transcriptPath: input.transcriptPath,
+        artifactPaths: input.artifactPaths,
+        warning,
+        message: lines.join("\n"),
+    };
+}
+//# sourceMappingURL=mutation-evidence.js.map

package/src/runs/shared/mutation-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mutation-evidence.js","sourceRoot":"","sources":["../../../../src/runs/shared/mutation-evidence.ts"],"names":[],"mappings":"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"}

package/src/runs/shared/nested-events.d.ts

@@ -0,0 +1,134 @@
+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;
+/** Validate a route handed to an in-process child against its on-disk metadata. */
+export declare function resolveNestedRoute(route: NestedRoute): NestedRoute;
+export declare function resolveInheritedNestedRoute(route: NestedRoute): NestedRoute | undefined;
+export interface NestedParentAddress {
+    parentRunId: string;
+    parentStepIndex?: number;
+    depth: number;
+    path: NestedPathEntry[];
+}
+/** The nested route an executor inherited from its own child runtime, validated against disk. */
+export declare function inheritedNestedRouteOf(runtime: {
+    nestedRoute?: NestedRoute;
+} | undefined): NestedRoute | undefined;
+/** The executor's own position in the nested run tree, from its child runtime. */
+export declare function inheritedNestedParentAddressOf(runtime: {
+    nestedParent?: {
+        parentRunId: string;
+        parentChildIndex?: number;
+        depth: number;
+        path: NestedPathEntry[];
+    };
+} | undefined): NestedParentAddress | 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;
+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 declare function retainNestedLookupRoute(state: Pick<SubagentState, "currentSessionId" | "retainedNestedLookupRoutes">, route: NestedRouteInfo | undefined, sessionId: string | undefined): void;
+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 snapshotNestedEventFiles(route: NestedRoute): Set<string>;
+export declare function findNestedControlResult(route: NestedRoute, requestId: string, targetRunId: string, ignoredFiles: ReadonlySet<string>): NestedControlResultRecord | undefined;
+export declare function readNestedControlResults(route: NestedRoute): NestedControlResultRecord[];
+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 isTopLevelAsyncDir(asyncDir: string): boolean;
+export declare function nestedRunScope(rootRunId: string): {
+    asyncDirRoot: string;
+    resultsDir: string;
+};
+export declare function nestedResultsPath(rootRunId: string, id: string): string;
+export {};
+//# sourceMappingURL=nested-events.d.ts.map

package/src/runs/shared/nested-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nested-events.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/nested-events.ts"],"names":[],"mappings":"AAGA,OAAO,EAGN,KAAK,aAAa,EAClB,KAAK,WAAW,EAGhB,KAAK,eAAe,EAEpB,KAAK,gBAAgB,EAGrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAA0C,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAKhG,eAAO,MAAM,iBAAiB,QAAqD,CAAC;AASpF,KAAK,qBAAqB,GAAG,yBAAyB,GAAG,yBAAyB,GAAG,2BAA2B,CAAC;AACjH,KAAK,4BAA4B,GAAG,gCAAgC,CAAC;AAErE,MAAM,MAAM,WAAW,GAAG,eAAe,CAAC;AAE1C,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,gBAAgB,CAAC;CACxB;AAED,MAAM,WAAW,yBAAyB;IACzC,IAAI,EAAE,4BAA4B,CAAC;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IAC1C,IAAI,EAAE,iCAAiC,CAAC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,gBAAgB,EAAE,CAAC;IAC7B,eAAe,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAErE;AAoCD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAahE;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CASlE;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,GAAG,SAAS,CAOvF;AAED,MAAM,WAAW,mBAAmB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,eAAe,EAAE,CAAC;CACxB;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAElH;AAED,kFAAkF;AAClF,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IAAE,YAAY,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,eAAe,EAAE,CAAA;KAAE,CAAA;CAAE,GAAG,SAAS,GAAG,mBAAmB,GAAG,SAAS,CAUlN;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,SAAS,CAMlG;AAoJD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,gBAAgB,GAAG,SAAS,CA6DvF;AAoCD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,GAAG,iBAAiB,EAAE,CAShG;AAwFD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,iBAAiB,GAAG,cAAc,CAMnG;AAqCD,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAcnF;AAED,wBAAgB,qBAAqB,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAMhE;AAED,wBAAgB,4BAA4B,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAG1F;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAQhH;AAED,MAAM,WAAW,cAAc;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,GAAG,EAAE,gBAAgB,CAAC;CACtB;AAED,wBAAgB,uBAAuB,CACtC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,kBAAkB,GAAG,4BAA4B,CAAC,EAC7E,KAAK,EAAE,eAAe,GAAG,SAAS,EAClC,SAAS,EAAE,MAAM,GAAG,SAAS,GAC3B,IAAI,CAMN;AAED,MAAM,WAAW,wBAAwB;IACxC,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACjE;AAoDD,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,wBAAwB,CAAA;CAAO,GAAG,cAAc,EAAE,CAc3I;AAED,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,gBAAgB,CAAA;CAAE,GAAG,SAAS,CAGtG;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CAcrE;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,WAAW,GAAG,cAAc,CA+DtE;AAcD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,iBAAiB,CAAC,GAAG,IAAI,CAU1H;AAyDD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,0BAA0B,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC,GAAG,MAAM,CAazJ;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,WAAW,GAAG,KAAK,CAAC,0BAA0B,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAsBtH;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,yBAAyB,EAAE,MAAM,GAAG,WAAW,GAAG,iBAAiB,CAAC,GAAG,IAAI,CAapJ;AAyBD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,CAExE;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,yBAAyB,GAAG,SAAS,CAW5K;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,WAAW,GAAG,yBAAyB,EAAE,CAIxF;AAED,wBAAgB,yBAAyB,CAAC,CAAC,SAAS;IAAE,QAAQ,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GAAG,IAAI,CAahM;AAED,wBAAgB,8BAA8B,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAKvE;AAED,wBAAgB,gCAAgC,CAAC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,CAI5I;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,gBAAgB,EAAE,GAAG,SAAS,GAAG,OAAO,CAQ1F;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,eAAe,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,gBAAgB,CAuErS;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAG5D;AAED,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM;;;EAM/C;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGvE"}