pi-subagents 0.69.0 → 0.70.0

package/src/runs/shared/pi-spawn.js

@@ -0,0 +1,156 @@
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+import { PI_CODING_AGENT_PACKAGE_ROOT_ENV } from "../../shared/utils.js";
+export const PI_CODING_AGENT_PACKAGE = "@earendil-works/pi-coding-agent";
+export const PI_SUBAGENT_PI_BINARY_ENV = "PI_SUBAGENT_PI_BINARY";
+export function findPiPackageRootFromEntry(entryPoint) {
+    let dir = path.dirname(entryPoint);
+    while (dir !== path.dirname(dir)) {
+        const packageJsonPath = path.join(dir, "package.json");
+        if (fs.existsSync(packageJsonPath)) {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, "utf-8"));
+            if (pkg.name === PI_CODING_AGENT_PACKAGE)
+                return dir;
+        }
+        dir = path.dirname(dir);
+    }
+    return undefined;
+}
+export function resolveInstalledPiPackageRoot() {
+    try {
+        return findPiPackageRootFromEntry(fileURLToPath(import.meta.resolve(PI_CODING_AGENT_PACKAGE)));
+    }
+    catch {
+        return undefined;
+    }
+}
+export function resolvePiPackageRoot() {
+    try {
+        const entry = process.argv[1];
+        return entry
+            ? findPiPackageRootFromEntry(fs.realpathSync(entry))
+            : undefined;
+    }
+    catch {
+        // process.argv[1] probing is best-effort; callers can fall back to PATH/package resolution.
+        return undefined;
+    }
+}
+/** Compiled Pi's entrypoint is virtual; execPath is the real (possibly renamed) image. */
+export function resolveBunPiExecutable(deps = {}) {
+    const bunVersion = deps.bunVersion ?? process.versions.bun;
+    const entry = deps.argv1 ?? process.argv[1];
+    if (!bunVersion || !entry || !/^(?:\/\$bunfs\/|B:[\\/]~BUN[\\/])/.test(entry))
+        return undefined;
+    const env = deps.env ?? process.env;
+    return env[PI_SUBAGENT_PI_BINARY_ENV]?.trim() || (deps.execPath ?? process.execPath);
+}
+function isNodeScriptPath(filePath) {
+    return /\.(?:mjs|cjs|js)$/i.test(filePath);
+}
+function isRunnableNodeScript(filePath, existsSync) {
+    if (!existsSync(filePath))
+        return false;
+    return isNodeScriptPath(filePath);
+}
+function normalizePath(filePath) {
+    return path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+}
+function isStandalonePiExecutable(execPath) {
+    const executableName = execPath.split(/[\\/]/).pop();
+    return /^pi(?:\.exe)?$/i.test(executableName ?? "");
+}
+function resolvePiCliScriptFromPackageJson(packageJsonPath, readFileSync, existsSync) {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+    if (packageJson.name !== PI_CODING_AGENT_PACKAGE)
+        return undefined;
+    const binField = packageJson.bin;
+    const binPath = typeof binField === "string"
+        ? binField
+        : (binField?.pi ?? Object.values(binField ?? {})[0]);
+    if (!binPath)
+        return undefined;
+    const candidate = path.resolve(path.dirname(packageJsonPath), binPath);
+    return isRunnableNodeScript(candidate, existsSync) ? candidate : undefined;
+}
+export function resolvePiCliScript(deps = {}) {
+    const existsSync = deps.existsSync ?? fs.existsSync;
+    const realpathSync = deps.realpathSync ?? fs.realpathSync;
+    const readFileSync = deps.readFileSync ??
+        ((filePath, encoding) => fs.readFileSync(filePath, encoding));
+    const argv1 = deps.argv1 ?? process.argv[1];
+    const env = deps.env ?? process.env;
+    if (argv1) {
+        const argvPath = normalizePath(argv1);
+        if (isRunnableNodeScript(argvPath, existsSync)) {
+            try {
+                const canonicalArgvPath = realpathSync(argvPath);
+                if (isRunnableNodeScript(canonicalArgvPath, existsSync) && findPiPackageRootFromEntry(canonicalArgvPath)) {
+                    return canonicalArgvPath;
+                }
+            }
+            catch {
+                // Host package metadata is untrusted here; keep resolving the installed Pi CLI.
+            }
+        }
+    }
+    const packageJsonCandidates = [];
+    if (deps.resolvePackageJson)
+        packageJsonCandidates.push(deps.resolvePackageJson);
+    for (const root of [deps.piPackageRoot, env[PI_CODING_AGENT_PACKAGE_ROOT_ENV], resolvePiPackageRoot()]) {
+        const trimmed = root?.trim();
+        if (trimmed)
+            packageJsonCandidates.push(() => path.join(trimmed, "package.json"));
+    }
+    packageJsonCandidates.push(() => {
+        const packageRoot = deps.resolvePackageEntry
+            ? findPiPackageRootFromEntry(deps.resolvePackageEntry())
+            : resolveInstalledPiPackageRoot();
+        return packageRoot ? path.join(packageRoot, "package.json") : undefined;
+    });
+    for (const candidatePackageJson of packageJsonCandidates) {
+        try {
+            const packageJsonPath = candidatePackageJson();
+            if (!packageJsonPath)
+                continue;
+            const candidate = resolvePiCliScriptFromPackageJson(packageJsonPath, readFileSync, existsSync);
+            if (candidate)
+                return candidate;
+        }
+        catch {
+            // Keep resolving; callers decide whether a PATH fallback is safe.
+        }
+    }
+    return undefined;
+}
+export function getPiSpawnCommand(args, deps = {}) {
+    const platform = deps.platform ?? process.platform;
+    const env = deps.env ?? process.env;
+    const piBinary = env[PI_SUBAGENT_PI_BINARY_ENV]?.trim();
+    if (piBinary) {
+        if (platform === "win32" && isNodeScriptPath(piBinary)) {
+            return {
+                command: deps.execPath ?? process.execPath,
+                args: [piBinary, ...args],
+            };
+        }
+        return { command: piBinary, args };
+    }
+    const execPath = deps.execPath ?? process.execPath;
+    if (isStandalonePiExecutable(execPath)) {
+        return { command: execPath, args };
+    }
+    const piCliPath = resolvePiCliScript(deps);
+    if (piCliPath) {
+        return {
+            command: execPath,
+            args: [piCliPath, ...args],
+        };
+    }
+    if (platform === "win32") {
+        throw new Error(`Could not resolve the Pi CLI on Windows. Set ${PI_SUBAGENT_PI_BINARY_ENV} or ensure ${PI_CODING_AGENT_PACKAGE} is installed.`);
+    }
+    return { command: "pi", args };
+}
+//# sourceMappingURL=pi-spawn.js.map

package/src/runs/shared/pi-spawn.js.map

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

package/src/runs/shared/process-signal.d.ts

@@ -0,0 +1,16 @@
+export declare function formatProcessSignalError(signal: string): string;
+export declare function formatMidToolExitError(input: {
+    toolName: string;
+    exitCode?: number | null;
+    processSignal?: string | null;
+}): string;
+export declare function isOrdinaryToolForMidToolExit(toolName: string): boolean;
+export declare function isUnexplainedProcessSignal(input: {
+    processSignal?: string | null;
+    interrupted?: boolean;
+    timedOut?: boolean;
+    stopped?: boolean;
+    turnBudgetExceeded?: boolean;
+    forcedDrainAfterFinalSuccess?: boolean;
+}): boolean;
+//# sourceMappingURL=process-signal.d.ts.map

package/src/runs/shared/process-signal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-signal.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/process-signal.ts"],"names":[],"mappings":"AAAA,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,GAAG,MAAM,CAMT;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtE;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IACjD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACvC,GAAG,OAAO,CAOV"}

package/src/runs/shared/process-signal.js

@@ -0,0 +1,22 @@
+export function formatProcessSignalError(signal) {
+    return `Subagent process terminated by signal ${signal}.`;
+}
+export function formatMidToolExitError(input) {
+    if (input.exitCode === undefined && !input.processSignal) {
+        return `Subagent session ended during '${input.toolName}' tool execution before the tool completed. Earlier assistant output is not a terminal result.`;
+    }
+    const terminal = [`exit ${input.exitCode ?? "unknown"}`, ...(input.processSignal ? [`signal ${input.processSignal}`] : [])].join(", ");
+    return `Subagent process exited during '${input.toolName}' tool execution (${terminal}) before the tool completed. Earlier assistant output is not a terminal result.`;
+}
+export function isOrdinaryToolForMidToolExit(toolName) {
+    return toolName !== "intercom" && toolName !== "contact_supervisor";
+}
+export function isUnexplainedProcessSignal(input) {
+    return Boolean(input.processSignal)
+        && input.interrupted !== true
+        && input.timedOut !== true
+        && input.stopped !== true
+        && input.turnBudgetExceeded !== true
+        && input.forcedDrainAfterFinalSuccess !== true;
+}
+//# sourceMappingURL=process-signal.js.map

package/src/runs/shared/process-signal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-signal.js","sourceRoot":"","sources":["../../../../src/runs/shared/process-signal.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,wBAAwB,CAAC,MAAc;IACtD,OAAO,yCAAyC,MAAM,GAAG,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAItC;IACA,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC;QAC1D,OAAO,kCAAkC,KAAK,CAAC,QAAQ,gGAAgG,CAAC;IACzJ,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,QAAQ,KAAK,CAAC,QAAQ,IAAI,SAAS,EAAE,EAAE,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvI,OAAO,mCAAmC,KAAK,CAAC,QAAQ,qBAAqB,QAAQ,iFAAiF,CAAC;AACxK,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAAgB;IAC5D,OAAO,QAAQ,KAAK,UAAU,IAAI,QAAQ,KAAK,oBAAoB,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,KAO1C;IACA,OAAO,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;WAC/B,KAAK,CAAC,WAAW,KAAK,IAAI;WAC1B,KAAK,CAAC,QAAQ,KAAK,IAAI;WACvB,KAAK,CAAC,OAAO,KAAK,IAAI;WACtB,KAAK,CAAC,kBAAkB,KAAK,IAAI;WACjC,KAAK,CAAC,4BAA4B,KAAK,IAAI,CAAC;AACjD,CAAC"}

package/src/runs/shared/readonly-drain-observation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Private, installation-owned evidence. Never changes drain/query behavior or retains statuses.
+ * Observes the ordinary indexed drain, not historical ownership or outside work appearing later.
+ */
+export declare class ReadonlyDrainObservation {
+    private state;
+    private started;
+    private first;
+    private readonly file;
+    private readonly guard;
+    constructor(file: string, guard: () => boolean);
+    deny(): void;
+    check(): boolean;
+    begin(file: string | null, native: boolean): void;
+    /** Called at the existing initial read, before reconciliation or filtering. */
+    readonly status: RawDrainStatusObserver;
+    predicate(hasWork: boolean): void;
+    complete(): void;
+    settled(): boolean;
+}
+/** Internal synchronous sink; null means an existing query encountered uncertainty. */
+export type RawDrainStatusObserver = (status: {
+    sessionId?: unknown;
+    state?: unknown;
+} | null) => void;
+//# sourceMappingURL=readonly-drain-observation.d.ts.map

package/src/runs/shared/readonly-drain-observation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-drain-observation.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/readonly-drain-observation.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,wBAAwB;IACpC,OAAO,CAAC,KAAK,CAA6C;IAC1D,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgB;gBAC1B,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO;IAC9C,IAAI,IAAI,IAAI;IACZ,KAAK,IAAI,OAAO;IAIhB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI;IAKjD,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAIrC;IACF,SAAS,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAKjC,QAAQ,IAAI,IAAI;IAGhB,OAAO,IAAI,OAAO;CAClB;AAED,uFAAuF;AACvF,MAAM,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,KAAK,IAAI,CAAC"}

package/src/runs/shared/readonly-drain-observation.js

@@ -0,0 +1,51 @@
+const knownStates = new Set(["queued", "running", "complete", "failed", "partial", "paused", "stopped", "rejected"]);
+/**
+ * Private, installation-owned evidence. Never changes drain/query behavior or retains statuses.
+ * Observes the ordinary indexed drain, not historical ownership or outside work appearing later.
+ */
+export class ReadonlyDrainObservation {
+    state = "pending";
+    started = false;
+    first = false;
+    file;
+    guard;
+    constructor(file, guard) { this.file = file; this.guard = guard; }
+    deny() { this.state = "denied"; }
+    check() {
+        try {
+            if (!this.guard())
+                this.deny();
+        }
+        catch {
+            this.deny();
+        }
+        return this.state !== "denied";
+    }
+    begin(file, native) {
+        if (this.started || file !== this.file || !native)
+            this.deny();
+        this.started = true;
+        this.check();
+    }
+    /** Called at the existing initial read, before reconciliation or filtering. */
+    status = (status) => {
+        if (!status || typeof status.sessionId !== "string" || !status.sessionId
+            || !knownStates.has(status.state))
+            this.deny();
+        else if (status.sessionId === this.file && (status.state === "queued" || status.state === "running"))
+            this.deny();
+    };
+    predicate(hasWork) {
+        if (this.first)
+            return;
+        this.first = true;
+        if (hasWork)
+            this.deny();
+    }
+    complete() {
+        if (this.started && this.first && this.check())
+            this.state = "empty";
+    }
+    settled() { return this.check() && this.state === "empty"; }
+}
+//# sourceMappingURL=readonly-drain-observation.js.map

package/src/runs/shared/readonly-drain-observation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readonly-drain-observation.js","sourceRoot":"","sources":["../../../../src/runs/shared/readonly-drain-observation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;AAErH;;;GAGG;AACH,MAAM,OAAO,wBAAwB;IAC5B,KAAK,GAAmC,SAAS,CAAC;IAClD,OAAO,GAAG,KAAK,CAAC;IAChB,KAAK,GAAG,KAAK,CAAC;IACL,IAAI,CAAS;IACb,KAAK,CAAgB;IACtC,YAAY,IAAY,EAAE,KAAoB,IAAI,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC;IACzF,IAAI,KAAW,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC;IACvC,KAAK;QACJ,IAAI,CAAC;YAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE;gBAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAAC,CAAC;QAC9D,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC;IAChC,CAAC;IACD,KAAK,CAAC,IAAmB,EAAE,MAAe;QACzC,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,KAAK,EAAE,CAAC;IACd,CAAC;IACD,+EAA+E;IACtE,MAAM,GAA2B,CAAC,MAAM,EAAE,EAAE;QACpD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS;eACpE,CAAC,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,KAAe,CAAC;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;aACrD,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,CAAC;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IACnH,CAAC,CAAC;IACF,SAAS,CAAC,OAAgB;QACzB,IAAI,IAAI,CAAC,KAAK;YAAE,OAAO;QACvB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,OAAO;YAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;IACD,QAAQ;QACP,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;YAAE,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC;IACtE,CAAC;IACD,OAAO,KAAc,OAAO,IAAI,CAAC,KAAK,EAAE,IAAI,IAAI,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC;CACrE"}

package/src/runs/shared/run-fanout-budget.d.ts

@@ -0,0 +1,15 @@
+import { type RunFanoutBudgetDescriptor, type RunFanoutBudgetSnapshot, type RunFanoutRejection } from "../../shared/types.ts";
+export declare class RunFanoutLimitError extends Error {
+    readonly rejection: RunFanoutRejection;
+    readonly snapshot: RunFanoutBudgetSnapshot;
+    constructor(rejection: RunFanoutRejection);
+}
+export declare function createRunFanoutBudget(rootRunId: string, limit: number): RunFanoutBudgetDescriptor;
+export declare function validateRunFanoutBudgetDescriptor(value: unknown): RunFanoutBudgetDescriptor;
+export declare function writeRunFanoutBudgetDescriptor(asyncDir: string, descriptor: RunFanoutBudgetDescriptor): void;
+export declare function readRunFanoutBudgetDescriptor(asyncDir: string | undefined): RunFanoutBudgetDescriptor | undefined;
+export declare function getRunFanoutBudgetSnapshot(descriptor: RunFanoutBudgetDescriptor): RunFanoutBudgetSnapshot;
+export declare function claimRunFanoutBatch(descriptor: RunFanoutBudgetDescriptor, paths: string[]): RunFanoutBudgetSnapshot;
+export declare function claimRunFanoutBatchWithCommit<T>(descriptor: RunFanoutBudgetDescriptor, paths: string[], commit: () => T): T;
+export declare function formatRunFanoutBudget(snapshot: RunFanoutBudgetSnapshot): string;
+//# sourceMappingURL=run-fanout-budget.d.ts.map

package/src/runs/shared/run-fanout-budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-fanout-budget.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/run-fanout-budget.ts"],"names":[],"mappings":"AAIA,OAAO,EAEN,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,kBAAkB,EACvB,MAAM,uBAAuB,CAAC;AAkB/B,qBAAa,mBAAoB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,uBAAuB,CAAC;gBAE/B,SAAS,EAAE,kBAAkB;CAMzC;AA0CD,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,yBAAyB,CAUjG;AAED,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,OAAO,GAAG,yBAAyB,CAe3F;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,yBAAyB,GAAG,IAAI,CAI5G;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,yBAAyB,GAAG,SAAS,CASjH;AAgFD,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,yBAAyB,GAAG,uBAAuB,CAIzG;AA6CD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,uBAAuB,CAEnH;AAED,wBAAgB,6BAA6B,CAAC,CAAC,EAAE,UAAU,EAAE,yBAAyB,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAE3H;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,uBAAuB,GAAG,MAAM,CAE/E"}

package/src/runs/shared/run-fanout-budget.js

@@ -0,0 +1,259 @@
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS, waitForFileSystemRetry } from "../../shared/file-system-retry.js";
+import { TEMP_ROOT_DIR, } from "../../shared/types.js";
+const RUN_FANOUT_ROOT = path.join(TEMP_ROOT_DIR, "run-fanout-budgets");
+export class RunFanoutLimitError extends Error {
+    rejection;
+    snapshot;
+    constructor(rejection) {
+        super(formatRunFanoutRejection(rejection));
+        this.name = "RunFanoutLimitError";
+        this.rejection = rejection;
+        this.snapshot = { used: rejection.used, limit: rejection.limit, remaining: rejection.remaining };
+    }
+}
+function safeRootRunId(rootRunId) {
+    return rootRunId.replace(/[^A-Za-z0-9._-]/g, "_").slice(0, 120) || randomUUID();
+}
+function parseManifest(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const manifest = value;
+    if (manifest.version !== 1 || typeof manifest.rootRunId !== "string" || !manifest.rootRunId
+        || !Number.isInteger(manifest.limit) || (manifest.limit ?? 0) <= 0
+        || typeof manifest.createdAt !== "number" || !Number.isFinite(manifest.createdAt))
+        return undefined;
+    return manifest;
+}
+function readManifest(directory) {
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(path.join(directory, "manifest.json"), "utf-8"));
+    }
+    catch (error) {
+        throw new Error(`Run fan-out budget manifest is unreadable at '${directory}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+    const manifest = parseManifest(parsed);
+    if (!manifest)
+        throw new Error(`Run fan-out budget manifest is invalid at '${directory}'.`);
+    return manifest;
+}
+function validateDirectory(directory) {
+    let realDirectory;
+    let realRoot;
+    try {
+        realDirectory = fs.realpathSync(path.resolve(directory));
+        realRoot = fs.realpathSync(path.resolve(RUN_FANOUT_ROOT));
+    }
+    catch (error) {
+        throw new Error(`Run fan-out budget directory is unavailable: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (realDirectory !== realRoot && !realDirectory.startsWith(`${realRoot}${path.sep}`)) {
+        throw new Error("Run fan-out budget directory resolves outside the managed budget root.");
+    }
+    return realDirectory;
+}
+export function createRunFanoutBudget(rootRunId, limit) {
+    if (!Number.isInteger(limit) || limit <= 0)
+        throw new Error("Run fan-out limit must be a positive integer.");
+    fs.mkdirSync(RUN_FANOUT_ROOT, { recursive: true, mode: 0o700 });
+    let directory;
+    do
+        directory = path.join(RUN_FANOUT_ROOT, `${safeRootRunId(rootRunId)}-${randomUUID()}`);
+    while (fs.existsSync(directory));
+    fs.mkdirSync(path.join(directory, "claims"), { recursive: true, mode: 0o700 });
+    const manifest = { version: 1, rootRunId, limit, createdAt: Date.now() };
+    fs.writeFileSync(path.join(directory, "manifest.json"), `${JSON.stringify(manifest)}\n`, { mode: 0o600, flag: "wx" });
+    return { version: 1, rootRunId, directory, limit };
+}
+export function validateRunFanoutBudgetDescriptor(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error("Run fan-out budget descriptor is missing or invalid.");
+    const descriptor = value;
+    if (descriptor.version !== 1 || typeof descriptor.rootRunId !== "string" || !descriptor.rootRunId
+        || typeof descriptor.directory !== "string" || !descriptor.directory
+        || !Number.isInteger(descriptor.limit) || (descriptor.limit ?? 0) <= 0
+        || (descriptor.parentPath !== undefined && typeof descriptor.parentPath !== "string")) {
+        throw new Error("Run fan-out budget descriptor is invalid.");
+    }
+    const directory = validateDirectory(descriptor.directory);
+    const manifest = readManifest(directory);
+    if (manifest.rootRunId !== descriptor.rootRunId || manifest.limit !== descriptor.limit) {
+        throw new Error("Run fan-out budget descriptor does not match its manifest.");
+    }
+    return { version: 1, rootRunId: descriptor.rootRunId, directory, limit: descriptor.limit, ...(descriptor.parentPath ? { parentPath: descriptor.parentPath } : {}) };
+}
+export function writeRunFanoutBudgetDescriptor(asyncDir, descriptor) {
+    const valid = validateRunFanoutBudgetDescriptor(descriptor);
+    fs.mkdirSync(asyncDir, { recursive: true });
+    fs.writeFileSync(path.join(asyncDir, "run-fanout-budget.json"), `${JSON.stringify(valid)}\n`, { mode: 0o600 });
+}
+export function readRunFanoutBudgetDescriptor(asyncDir) {
+    if (!asyncDir)
+        return undefined;
+    const descriptorPath = path.join(asyncDir, "run-fanout-budget.json");
+    if (!fs.existsSync(descriptorPath))
+        return undefined;
+    try {
+        return validateRunFanoutBudgetDescriptor(JSON.parse(fs.readFileSync(descriptorPath, "utf-8")));
+    }
+    catch (error) {
+        throw new Error(`Invalid persisted run fan-out budget '${descriptorPath}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+const ADMISSION_LOCK_STALE_MS = 60_000;
+function readAdmissionLockOwner(lockPath) {
+    try {
+        const owner = JSON.parse(fs.readFileSync(path.join(lockPath, "owner.json"), "utf-8"));
+        if (Number.isSafeInteger(owner.pid) && (owner.pid ?? 0) > 0 && typeof owner.token === "string" && owner.token)
+            return owner;
+    }
+    catch { }
+    return undefined;
+}
+function admissionLockIsStale(lockPath) {
+    const owner = readAdmissionLockOwner(lockPath);
+    if (owner) {
+        try {
+            process.kill(owner.pid, 0);
+            return false;
+        }
+        catch (error) {
+            return error.code !== "EPERM";
+        }
+    }
+    try {
+        return Date.now() - fs.statSync(lockPath).mtimeMs > ADMISSION_LOCK_STALE_MS;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+function withAdmissionLock(directory, operation) {
+    const lockPath = path.join(directory, "admission.lock");
+    const owner = { pid: process.pid, token: randomUUID() };
+    for (let attempt = 0;; attempt++) {
+        try {
+            fs.mkdirSync(lockPath, { mode: 0o700 });
+            try {
+                fs.writeFileSync(path.join(lockPath, "owner.json"), JSON.stringify(owner), { mode: 0o600 });
+            }
+            catch (error) {
+                fs.rmSync(lockPath, { recursive: true, force: true });
+                throw error;
+            }
+            break;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST")
+                throw error;
+            if (admissionLockIsStale(lockPath)) {
+                const stalePath = path.join(directory, `admission.stale-${randomUUID()}`);
+                try {
+                    fs.renameSync(lockPath, stalePath);
+                    fs.rmSync(stalePath, { recursive: true, force: true });
+                    continue;
+                }
+                catch (reclaimError) {
+                    if (reclaimError.code !== "ENOENT")
+                        throw reclaimError;
+                }
+            }
+            const delay = DEFAULT_FILE_SYSTEM_RETRY_DELAYS_MS[attempt];
+            if (delay === undefined)
+                throw new Error(`Timed out acquiring run fan-out admission lock at '${directory}'.`);
+            waitForFileSystemRetry(delay);
+        }
+    }
+    try {
+        return operation();
+    }
+    finally {
+        if (readAdmissionLockOwner(lockPath)?.token === owner.token)
+            fs.rmSync(lockPath, { recursive: true, force: true });
+    }
+}
+function claimCount(directory) {
+    const claimsDir = path.join(directory, "claims");
+    let entries;
+    try {
+        entries = fs.readdirSync(claimsDir, { withFileTypes: true });
+    }
+    catch (error) {
+        throw new Error(`Run fan-out claims directory is unreadable at '${claimsDir}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return entries.filter((entry) => /^\d{6}\.json$/.test(entry.name)).length;
+}
+export function getRunFanoutBudgetSnapshot(descriptor) {
+    const valid = validateRunFanoutBudgetDescriptor(descriptor);
+    const used = claimCount(valid.directory);
+    return { used, limit: valid.limit, remaining: Math.max(0, valid.limit - used) };
+}
+function qualifyRunFanoutPaths(descriptor, paths) {
+    const prefix = descriptor.parentPath?.trim();
+    return paths.map((item) => prefix ? `${prefix}/${item}` : item);
+}
+function commitRunFanoutBatch(descriptor, paths, commit) {
+    const valid = validateRunFanoutBudgetDescriptor(descriptor);
+    if (paths.length === 0)
+        return commit(getRunFanoutBudgetSnapshot(valid));
+    const qualified = qualifyRunFanoutPaths(valid, paths);
+    return withAdmissionLock(valid.directory, () => {
+        const before = getRunFanoutBudgetSnapshot(valid);
+        if (qualified.length > before.remaining) {
+            throw new RunFanoutLimitError({ code: "RUN_FANOUT_LIMIT", path: qualified[before.remaining] ?? qualified[0], requested: qualified.length, ...before });
+        }
+        const created = [];
+        try {
+            for (const claimPath of qualified) {
+                for (let slot = 0; slot < valid.limit; slot++) {
+                    const slotPath = path.join(valid.directory, "claims", `${String(slot).padStart(6, "0")}.json`);
+                    try {
+                        const fd = fs.openSync(slotPath, "wx", 0o600);
+                        created.push(slotPath);
+                        try {
+                            const claim = { version: 1, claimId: randomUUID(), path: claimPath, claimedAt: Date.now() };
+                            fs.writeFileSync(fd, `${JSON.stringify(claim)}\n`, "utf-8");
+                        }
+                        finally {
+                            fs.closeSync(fd);
+                        }
+                        break;
+                    }
+                    catch (error) {
+                        if (error.code === "EEXIST")
+                            continue;
+                        throw error;
+                    }
+                }
+            }
+            return commit(getRunFanoutBudgetSnapshot(valid));
+        }
+        catch (error) {
+            for (const slotPath of created) {
+                try {
+                    fs.unlinkSync(slotPath);
+                }
+                catch { }
+            }
+            throw error;
+        }
+    });
+}
+export function claimRunFanoutBatch(descriptor, paths) {
+    return commitRunFanoutBatch(descriptor, paths, (snapshot) => snapshot);
+}
+export function claimRunFanoutBatchWithCommit(descriptor, paths, commit) {
+    return commitRunFanoutBatch(descriptor, paths, commit);
+}
+export function formatRunFanoutBudget(snapshot) {
+    return `Run fan-out: ${snapshot.used}/${snapshot.limit} used, ${snapshot.remaining} remaining`;
+}
+function formatRunFanoutRejection(rejection) {
+    return `Run fan-out limit reached at ${rejection.path} (${rejection.used}/${rejection.limit} used; ${rejection.requested} requested, ${rejection.remaining} remaining). No children from this admission group were started. Start a new top-level run or raise config.maxSubagentSpawnsPerRun.`;
+}
+//# sourceMappingURL=run-fanout-budget.js.map

package/src/runs/shared/run-fanout-budget.js.map

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

package/src/runs/shared/run-history.d.ts

@@ -0,0 +1,20 @@
+export type RunOutcome = "completed" | "failed" | "timed_out" | "stopped" | "interrupted";
+export interface RunEntry {
+    agent: string;
+    task: string;
+    taskHash?: string;
+    ts: number;
+    status: "ok" | "error";
+    outcome?: RunOutcome;
+    duration: number;
+    exit?: number;
+}
+export declare function recordRun(agent: string, task: string, exitCode: number, durationMs: number, terminal?: {
+    interrupted?: boolean;
+    processSignal?: string | null;
+    stopped?: boolean;
+    timedOut?: boolean;
+    turnBudgetExceeded?: boolean;
+}): void;
+export declare function loadRunsForAgent(agent: string): RunEntry[];
+//# sourceMappingURL=run-history.d.ts.map

package/src/runs/shared/run-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-history.d.ts","sourceRoot":"","sources":["../../../../src/runs/shared/run-history.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,CAAC;AAE1F,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AAsHD,wBAAgB,SAAS,CACxB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE;IAAE,WAAW,CAAC,EAAE,OAAO,CAAC;IAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAO,GAC1I,IAAI,CA+BN;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CA0B1D"}