@ashx-j/lunr 0.1.0

package/dist/builtin-extensions/pi-subagents/src/runs/shared/pi-spawn.js

@@ -0,0 +1,111 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+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() {
+    return findPiPackageRootFromEntry(fileURLToPath(import.meta.resolve(PI_CODING_AGENT_PACKAGE)));
+}
+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;
+    }
+}
+function isRunnableNodeScript(filePath, existsSync) {
+    if (!existsSync(filePath))
+        return false;
+    return /\.(?:mjs|cjs|js)$/i.test(filePath);
+}
+function normalizePath(filePath) {
+    return path.isAbsolute(filePath) ? filePath : path.resolve(filePath);
+}
+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];
+    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.
+            }
+        }
+    }
+    try {
+        const resolvePackageJson = deps.resolvePackageJson ??
+            (() => {
+                const root = deps.piPackageRoot ?? resolvePiPackageRoot();
+                if (root)
+                    return path.join(root, "package.json");
+                const packageRoot = deps.resolvePackageEntry
+                    ? findPiPackageRootFromEntry(deps.resolvePackageEntry())
+                    : resolveInstalledPiPackageRoot();
+                if (!packageRoot)
+                    throw new Error(`Could not resolve ${PI_CODING_AGENT_PACKAGE} package root`);
+                return path.join(packageRoot, "package.json");
+            });
+        const packageJsonPath = resolvePackageJson();
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
+        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);
+        if (isRunnableNodeScript(candidate, existsSync)) {
+            return candidate;
+        }
+    }
+    catch {
+        // Verified CLI resolution is optional; falling back to `lunr` lets PATH handle execution.
+        return undefined;
+    }
+    return undefined;
+}
+export function getPiSpawnCommand(args, deps = {}) {
+    const env = deps.env ?? process.env;
+    const piBinary = env[PI_SUBAGENT_PI_BINARY_ENV]?.trim();
+    if (piBinary) {
+        return { command: piBinary, args };
+    }
+    const piCliPath = resolvePiCliScript(deps);
+    if (piCliPath) {
+        return {
+            command: deps.execPath ?? process.execPath,
+            args: [piCliPath, ...args],
+        };
+    }
+    // lunr: last-resort PATH lookup spawns the lunr binary, not a real pi install.
+    return { command: "lunr", args };
+}
+//# sourceMappingURL=pi-spawn.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pi-spawn.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/pi-spawn.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nexport const PI_CODING_AGENT_PACKAGE = \"@earendil-works/pi-coding-agent\";\nexport const PI_SUBAGENT_PI_BINARY_ENV = \"PI_SUBAGENT_PI_BINARY\";\n\nexport function findPiPackageRootFromEntry(\n\tentryPoint: string,\n): string | undefined {\n\tlet dir = path.dirname(entryPoint);\n\twhile (dir !== path.dirname(dir)) {\n\t\tconst packageJsonPath = path.join(dir, \"package.json\");\n\t\tif (fs.existsSync(packageJsonPath)) {\n\t\t\tconst pkg = JSON.parse(fs.readFileSync(packageJsonPath, \"utf-8\")) as {\n\t\t\t\tname?: unknown;\n\t\t\t};\n\t\t\tif (pkg.name === PI_CODING_AGENT_PACKAGE) return dir;\n\t\t}\n\t\tdir = path.dirname(dir);\n\t}\n\treturn undefined;\n}\n\nexport function resolveInstalledPiPackageRoot(): string | undefined {\n\treturn findPiPackageRootFromEntry(\n\t\tfileURLToPath(import.meta.resolve(PI_CODING_AGENT_PACKAGE)),\n\t);\n}\n\nexport function resolvePiPackageRoot(): string | undefined {\n\ttry {\n\t\tconst entry = process.argv[1];\n\t\treturn entry\n\t\t\t? findPiPackageRootFromEntry(fs.realpathSync(entry))\n\t\t\t: undefined;\n\t} catch {\n\t\t// process.argv[1] probing is best-effort; callers can fall back to PATH/package resolution.\n\t\treturn undefined;\n\t}\n}\n\nexport interface PiSpawnDeps {\n\tplatform?: NodeJS.Platform;\n\texecPath?: string;\n\targv1?: string;\n\texistsSync?: (filePath: string) => boolean;\n\trealpathSync?: (filePath: string) => string;\n\treadFileSync?: (filePath: string, encoding: \"utf-8\") => string;\n\tresolvePackageJson?: () => string;\n\tresolvePackageEntry?: () => string;\n\tpiPackageRoot?: string;\n\tenv?: NodeJS.ProcessEnv;\n}\n\ninterface PiSpawnCommand {\n\tcommand: string;\n\targs: string[];\n}\n\nfunction isRunnableNodeScript(\n\tfilePath: string,\n\texistsSync: (filePath: string) => boolean,\n): boolean {\n\tif (!existsSync(filePath)) return false;\n\treturn /\\.(?:mjs|cjs|js)$/i.test(filePath);\n}\n\nfunction normalizePath(filePath: string): string {\n\treturn path.isAbsolute(filePath) ? filePath : path.resolve(filePath);\n}\n\nexport function resolvePiCliScript(\n\tdeps: PiSpawnDeps = {},\n): string | undefined {\n\tconst existsSync = deps.existsSync ?? fs.existsSync;\n\tconst realpathSync = deps.realpathSync ?? fs.realpathSync;\n\tconst readFileSync =\n\t\tdeps.readFileSync ??\n\t\t((filePath, encoding) => fs.readFileSync(filePath, encoding));\n\tconst argv1 = deps.argv1 ?? process.argv[1];\n\n\tif (argv1) {\n\t\tconst argvPath = normalizePath(argv1);\n\t\tif (isRunnableNodeScript(argvPath, existsSync)) {\n\t\t\ttry {\n\t\t\t\tconst canonicalArgvPath = realpathSync(argvPath);\n\t\t\t\tif (isRunnableNodeScript(canonicalArgvPath, existsSync) && findPiPackageRootFromEntry(canonicalArgvPath)) {\n\t\t\t\t\treturn canonicalArgvPath;\n\t\t\t\t}\n\t\t\t} catch {\n\t\t\t\t// Host package metadata is untrusted here; keep resolving the installed Pi CLI.\n\t\t\t}\n\t\t}\n\t}\n\n\ttry {\n\t\tconst resolvePackageJson =\n\t\t\tdeps.resolvePackageJson ??\n\t\t\t(() => {\n\t\t\t\tconst root = deps.piPackageRoot ?? resolvePiPackageRoot();\n\t\t\t\tif (root) return path.join(root, \"package.json\");\n\t\t\t\tconst packageRoot = deps.resolvePackageEntry\n\t\t\t\t\t? findPiPackageRootFromEntry(deps.resolvePackageEntry())\n\t\t\t\t\t: resolveInstalledPiPackageRoot();\n\t\t\t\tif (!packageRoot)\n\t\t\t\t\tthrow new Error(\n\t\t\t\t\t\t`Could not resolve ${PI_CODING_AGENT_PACKAGE} package root`,\n\t\t\t\t\t);\n\t\t\t\treturn path.join(packageRoot, \"package.json\");\n\t\t\t});\n\t\tconst packageJsonPath = resolvePackageJson();\n\t\tconst packageJson = JSON.parse(readFileSync(packageJsonPath, \"utf-8\")) as {\n\t\t\tbin?: string | Record<string, string>;\n\t\t};\n\t\tconst binField = packageJson.bin;\n\t\tconst binPath =\n\t\t\ttypeof binField === \"string\"\n\t\t\t\t? binField\n\t\t\t\t: (binField?.pi ?? Object.values(binField ?? {})[0]);\n\t\tif (!binPath) return undefined;\n\t\tconst candidate = path.resolve(path.dirname(packageJsonPath), binPath);\n\t\tif (isRunnableNodeScript(candidate, existsSync)) {\n\t\t\treturn candidate;\n\t\t}\n\t} catch {\n\t\t// Verified CLI resolution is optional; falling back to `lunr` lets PATH handle execution.\n\t\treturn undefined;\n\t}\n\n\treturn undefined;\n}\n\nexport function getPiSpawnCommand(\n\targs: string[],\n\tdeps: PiSpawnDeps = {},\n): PiSpawnCommand {\n\tconst env = deps.env ?? process.env;\n\tconst piBinary = env[PI_SUBAGENT_PI_BINARY_ENV]?.trim();\n\tif (piBinary) {\n\t\treturn { command: piBinary, args };\n\t}\n\n\tconst piCliPath = resolvePiCliScript(deps);\n\tif (piCliPath) {\n\t\treturn {\n\t\t\tcommand: deps.execPath ?? process.execPath,\n\t\t\targs: [piCliPath, ...args],\n\t\t};\n\t}\n\n\t// lunr: last-resort PATH lookup spawns the lunr binary, not a real pi install.\n\treturn { command: \"lunr\", args };\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/run-history.d.ts

@@ -0,0 +1,11 @@
+export interface RunEntry {
+    agent: string;
+    task: string;
+    ts: number;
+    status: "ok" | "error";
+    duration: number;
+    exit?: number;
+}
+export declare function recordRun(agent: string, task: string, exitCode: number, durationMs: number): void;
+export declare function loadRunsForAgent(agent: string): RunEntry[];
+//# sourceMappingURL=run-history.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/run-history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-history.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/run-history.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACd;AASD,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAgBjG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,EAAE,CAqB1D","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { getAgentDir } from \"../../shared/utils.ts\";\n\nexport interface RunEntry {\n\tagent: string;\n\ttask: string;\n\tts: number;\n\tstatus: \"ok\" | \"error\";\n\tduration: number;\n\texit?: number;\n}\n\nconst ROTATE_READ_THRESHOLD = 1200;\nconst ROTATE_KEEP = 1000;\n\nfunction getHistoryPath(): string {\n\treturn path.join(getAgentDir(), \"run-history.jsonl\");\n}\n\nexport function recordRun(agent: string, task: string, exitCode: number, durationMs: number): void {\n\ttry {\n\t\tconst entry: RunEntry = {\n\t\t\tagent,\n\t\t\ttask: task.slice(0, 200),\n\t\t\tts: Math.floor(Date.now() / 1000),\n\t\t\tstatus: exitCode === 0 ? \"ok\" : \"error\",\n\t\t\tduration: durationMs,\n\t\t\t...(exitCode !== 0 ? { exit: exitCode } : {}),\n\t\t};\n\t\tconst historyPath = getHistoryPath();\n\t\tfs.mkdirSync(path.dirname(historyPath), { recursive: true });\n\t\tfs.appendFileSync(historyPath, `${JSON.stringify(entry)}\\n`);\n\t} catch {\n\t\t// Best-effort — never crash the execution flow for history recording\n\t}\n}\n\nexport function loadRunsForAgent(agent: string): RunEntry[] {\n\tconst historyPath = getHistoryPath();\n\tif (!fs.existsSync(historyPath)) return [];\n\tlet raw: string;\n\ttry {\n\t\traw = fs.readFileSync(historyPath, \"utf-8\");\n\t} catch {\n\t\treturn [];\n\t}\n\n\tlet lines = raw.split(\"\\n\").map((line) => line.trim()).filter((line) => line.length > 0);\n\n\tif (lines.length > ROTATE_READ_THRESHOLD) {\n\t\tlines = lines.slice(-ROTATE_KEEP);\n\t\ttry { fs.writeFileSync(historyPath, `${lines.join(\"\\n\")}\\n`, \"utf-8\"); } catch {}\n\t}\n\n\treturn lines\n\t\t.map((line) => { try { return JSON.parse(line) as RunEntry; } catch { return undefined; } })\n\t\t.filter((entry): entry is RunEntry => Boolean(entry) && entry.agent === agent)\n\t\t.reverse();\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/run-history.js

@@ -0,0 +1,57 @@
+// @ts-nocheck
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { getAgentDir } from "../../shared/utils.js";
+const ROTATE_READ_THRESHOLD = 1200;
+const ROTATE_KEEP = 1000;
+function getHistoryPath() {
+    return path.join(getAgentDir(), "run-history.jsonl");
+}
+export function recordRun(agent, task, exitCode, durationMs) {
+    try {
+        const entry = {
+            agent,
+            task: task.slice(0, 200),
+            ts: Math.floor(Date.now() / 1000),
+            status: exitCode === 0 ? "ok" : "error",
+            duration: durationMs,
+            ...(exitCode !== 0 ? { exit: exitCode } : {}),
+        };
+        const historyPath = getHistoryPath();
+        fs.mkdirSync(path.dirname(historyPath), { recursive: true });
+        fs.appendFileSync(historyPath, `${JSON.stringify(entry)}\n`);
+    }
+    catch {
+        // Best-effort — never crash the execution flow for history recording
+    }
+}
+export function loadRunsForAgent(agent) {
+    const historyPath = getHistoryPath();
+    if (!fs.existsSync(historyPath))
+        return [];
+    let raw;
+    try {
+        raw = fs.readFileSync(historyPath, "utf-8");
+    }
+    catch {
+        return [];
+    }
+    let lines = raw.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+    if (lines.length > ROTATE_READ_THRESHOLD) {
+        lines = lines.slice(-ROTATE_KEEP);
+        try {
+            fs.writeFileSync(historyPath, `${lines.join("\n")}\n`, "utf-8");
+        }
+        catch { }
+    }
+    return lines
+        .map((line) => { try {
+        return JSON.parse(line);
+    }
+    catch {
+        return undefined;
+    } })
+        .filter((entry) => Boolean(entry) && entry.agent === agent)
+        .reverse();
+}
+//# sourceMappingURL=run-history.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/run-history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-history.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/run-history.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport * as fs from \"node:fs\";\nimport * as path from \"node:path\";\nimport { getAgentDir } from \"../../shared/utils.ts\";\n\nexport interface RunEntry {\n\tagent: string;\n\ttask: string;\n\tts: number;\n\tstatus: \"ok\" | \"error\";\n\tduration: number;\n\texit?: number;\n}\n\nconst ROTATE_READ_THRESHOLD = 1200;\nconst ROTATE_KEEP = 1000;\n\nfunction getHistoryPath(): string {\n\treturn path.join(getAgentDir(), \"run-history.jsonl\");\n}\n\nexport function recordRun(agent: string, task: string, exitCode: number, durationMs: number): void {\n\ttry {\n\t\tconst entry: RunEntry = {\n\t\t\tagent,\n\t\t\ttask: task.slice(0, 200),\n\t\t\tts: Math.floor(Date.now() / 1000),\n\t\t\tstatus: exitCode === 0 ? \"ok\" : \"error\",\n\t\t\tduration: durationMs,\n\t\t\t...(exitCode !== 0 ? { exit: exitCode } : {}),\n\t\t};\n\t\tconst historyPath = getHistoryPath();\n\t\tfs.mkdirSync(path.dirname(historyPath), { recursive: true });\n\t\tfs.appendFileSync(historyPath, `${JSON.stringify(entry)}\\n`);\n\t} catch {\n\t\t// Best-effort — never crash the execution flow for history recording\n\t}\n}\n\nexport function loadRunsForAgent(agent: string): RunEntry[] {\n\tconst historyPath = getHistoryPath();\n\tif (!fs.existsSync(historyPath)) return [];\n\tlet raw: string;\n\ttry {\n\t\traw = fs.readFileSync(historyPath, \"utf-8\");\n\t} catch {\n\t\treturn [];\n\t}\n\n\tlet lines = raw.split(\"\\n\").map((line) => line.trim()).filter((line) => line.length > 0);\n\n\tif (lines.length > ROTATE_READ_THRESHOLD) {\n\t\tlines = lines.slice(-ROTATE_KEEP);\n\t\ttry { fs.writeFileSync(historyPath, `${lines.join(\"\\n\")}\\n`, \"utf-8\"); } catch {}\n\t}\n\n\treturn lines\n\t\t.map((line) => { try { return JSON.parse(line) as RunEntry; } catch { return undefined; } })\n\t\t.filter((entry): entry is RunEntry => Boolean(entry) && entry.agent === agent)\n\t\t.reverse();\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/session-lease.d.ts

@@ -0,0 +1,54 @@
+export declare const SESSION_LEASES_DIR: string;
+export interface SessionLeaseRequest {
+    sessionFile: string;
+    runId: string;
+    sourceRunId: string;
+    parentSessionId?: string;
+}
+export interface SessionLeaseOwner {
+    version: 1;
+    token: string;
+    canonicalSessionFile: string;
+    runId: string;
+    sourceRunId: string;
+    parentSessionId?: string;
+    pid: number;
+    hostname: string;
+    processStartIdentity?: string;
+    writerState: "none" | "spawning" | "running";
+    writerPid?: number;
+    writerProcessStartIdentity?: string;
+    acquiredAt: string;
+    acquiredAtMs: number;
+    updatedAtMs: number;
+}
+export interface SessionLeaseHandle {
+    leaseDir: string;
+    owner: SessionLeaseOwner;
+    updateWriter(writer: {
+        state: "none" | "spawning";
+    } | {
+        state: "running";
+        pid: number;
+    }): void;
+    release(): void;
+}
+interface SessionLeaseOptions {
+    rootDir?: string;
+    now?: () => number;
+    token?: () => string;
+    pid?: number;
+    hostname?: string;
+    processStartIdentity?: string;
+    isProcessAlive?: (pid: number) => boolean | undefined;
+    getProcessStartIdentity?: (pid: number) => string | undefined;
+}
+export declare class SessionLeaseConflictError extends Error {
+    readonly owner?: SessionLeaseOwner;
+    constructor(message: string, owner?: SessionLeaseOwner);
+}
+export declare function canonicalSessionFilePath(sessionFile: string): string;
+export declare function sessionLeaseDir(sessionFile: string, rootDir?: string): string;
+export declare function acquireSessionLease(request: SessionLeaseRequest, options?: SessionLeaseOptions): SessionLeaseHandle;
+export {};
+//# sourceMappingURL=session-lease.d.ts.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/session-lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lease.d.ts","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/session-lease.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,kBAAkB,QAA6C,CAAC;AAE7E,MAAM,WAAW,mBAAmB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,oBAAoB,EAAE,MAAM,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC7C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,iBAAiB,CAAC;IACzB,YAAY,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,UAAU,CAAA;KAAE,GAAG;QAAE,KAAK,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/F,OAAO,IAAI,IAAI,CAAC;CAChB;AAED,UAAU,mBAAmB;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,CAAC;IACtD,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9D;AAED,qBAAa,yBAA0B,SAAQ,KAAK;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAEnC,YAAY,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,iBAAiB,EAIrD;CACD;AAmCD,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEpE;AAED,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,SAAqB,GAAG,MAAM,CAKzF;AAmFD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,mBAAmB,EAAE,OAAO,GAAE,mBAAwB,GAAG,kBAAkB,CA0FvH","sourcesContent":["// @ts-nocheck\nimport { spawnSync } from \"node:child_process\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { createAtomicJsonWriter } from \"../../shared/atomic-json.ts\";\nimport { TEMP_ROOT_DIR } from \"../../shared/types.ts\";\n\nexport const SESSION_LEASES_DIR = path.join(TEMP_ROOT_DIR, \"session-leases\");\n\nexport interface SessionLeaseRequest {\n\tsessionFile: string;\n\trunId: string;\n\tsourceRunId: string;\n\tparentSessionId?: string;\n}\n\nexport interface SessionLeaseOwner {\n\tversion: 1;\n\ttoken: string;\n\tcanonicalSessionFile: string;\n\trunId: string;\n\tsourceRunId: string;\n\tparentSessionId?: string;\n\tpid: number;\n\thostname: string;\n\tprocessStartIdentity?: string;\n\twriterState: \"none\" | \"spawning\" | \"running\";\n\twriterPid?: number;\n\twriterProcessStartIdentity?: string;\n\tacquiredAt: string;\n\tacquiredAtMs: number;\n\tupdatedAtMs: number;\n}\n\nexport interface SessionLeaseHandle {\n\tleaseDir: string;\n\towner: SessionLeaseOwner;\n\tupdateWriter(writer: { state: \"none\" | \"spawning\" } | { state: \"running\"; pid: number }): void;\n\trelease(): void;\n}\n\ninterface SessionLeaseOptions {\n\trootDir?: string;\n\tnow?: () => number;\n\ttoken?: () => string;\n\tpid?: number;\n\thostname?: string;\n\tprocessStartIdentity?: string;\n\tisProcessAlive?: (pid: number) => boolean | undefined;\n\tgetProcessStartIdentity?: (pid: number) => string | undefined;\n}\n\nexport class SessionLeaseConflictError extends Error {\n\treadonly owner?: SessionLeaseOwner;\n\n\tconstructor(message: string, owner?: SessionLeaseOwner) {\n\t\tsuper(message);\n\t\tthis.name = \"SessionLeaseConflictError\";\n\t\tthis.owner = owner;\n\t}\n}\n\nfunction getProcessStartIdentity(pid: number): string | undefined {\n\tif (process.platform === \"linux\") {\n\t\ttry {\n\t\t\tconst stat = fs.readFileSync(`/proc/${pid}/stat`, \"utf-8\");\n\t\t\tconst commandEnd = stat.lastIndexOf(\")\");\n\t\t\tif (commandEnd === -1) return undefined;\n\t\t\tconst fields = stat.slice(commandEnd + 1).trim().split(/\\s+/);\n\t\t\tconst startTicks = fields[19];\n\t\t\treturn startTicks ? `linux:${startTicks}` : undefined;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"darwin\" || process.platform === \"freebsd\") {\n\t\tconst result = spawnSync(\"/bin/ps\", [\"-o\", \"lstart=\", \"-p\", String(pid)], { encoding: \"utf-8\" });\n\t\tconst started = result.status === 0 ? result.stdout.trim() : \"\";\n\t\treturn started ? `${process.platform}:${started}` : undefined;\n\t}\n\treturn undefined;\n}\n\nfunction processIsAlive(pid: number): boolean | undefined {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch (error) {\n\t\tconst code = (error as NodeJS.ErrnoException).code;\n\t\tif (code === \"ESRCH\") return false;\n\t\tif (code === \"EPERM\") return true;\n\t\treturn undefined;\n\t}\n}\n\nexport function canonicalSessionFilePath(sessionFile: string): string {\n\treturn fs.realpathSync.native(path.resolve(sessionFile));\n}\n\nexport function sessionLeaseDir(sessionFile: string, rootDir = SESSION_LEASES_DIR): string {\n\tconst canonical = canonicalSessionFilePath(sessionFile);\n\tconst key = process.platform === \"win32\" ? canonical.toLowerCase() : canonical;\n\tconst digest = createHash(\"sha256\").update(key).digest(\"hex\");\n\treturn path.join(rootDir, digest);\n}\n\nfunction parseOwner(value: unknown): SessionLeaseOwner | undefined {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst owner = value as Partial<SessionLeaseOwner>;\n\tif (owner.version !== 1\n\t\t|| typeof owner.token !== \"string\"\n\t\t|| typeof owner.canonicalSessionFile !== \"string\"\n\t\t|| typeof owner.runId !== \"string\"\n\t\t|| typeof owner.sourceRunId !== \"string\"\n\t\t|| typeof owner.pid !== \"number\"\n\t\t|| !Number.isInteger(owner.pid)\n\t\t|| owner.pid <= 0\n\t\t|| typeof owner.hostname !== \"string\"\n\t\t|| (owner.writerState !== \"none\" && owner.writerState !== \"spawning\" && owner.writerState !== \"running\")\n\t\t|| typeof owner.acquiredAt !== \"string\"\n\t\t|| typeof owner.acquiredAtMs !== \"number\"\n\t\t|| typeof owner.updatedAtMs !== \"number\") return undefined;\n\tif (owner.parentSessionId !== undefined && typeof owner.parentSessionId !== \"string\") return undefined;\n\tif (owner.processStartIdentity !== undefined && typeof owner.processStartIdentity !== \"string\") return undefined;\n\tif (owner.writerPid !== undefined && (typeof owner.writerPid !== \"number\" || !Number.isInteger(owner.writerPid) || owner.writerPid <= 0)) return undefined;\n\tif (owner.writerProcessStartIdentity !== undefined && typeof owner.writerProcessStartIdentity !== \"string\") return undefined;\n\tif (owner.writerState === \"running\" && owner.writerPid === undefined) return undefined;\n\tif (owner.writerState !== \"running\" && (owner.writerPid !== undefined || owner.writerProcessStartIdentity !== undefined)) return undefined;\n\treturn owner as SessionLeaseOwner;\n}\n\nfunction readLeaseOwner(leaseDir: string): SessionLeaseOwner | undefined {\n\ttry {\n\t\treturn parseOwner(JSON.parse(fs.readFileSync(path.join(leaseDir, \"owner.json\"), \"utf-8\")));\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction conflictMessage(canonicalSessionFile: string, owner: SessionLeaseOwner | undefined): string {\n\tif (!owner) {\n\t\treturn `Direct revival of session '${canonicalSessionFile}' is blocked by an existing lease with unreadable owner metadata. Refusing to reclaim it without proof that the owner is stale.`;\n\t}\n\tconst parent = owner.parentSessionId ? `, parent session '${owner.parentSessionId}'` : \"\";\n\treturn `Direct revival of session '${canonicalSessionFile}' is already owned by run '${owner.runId}' (source run '${owner.sourceRunId}'${parent}, pid ${owner.pid} on ${owner.hostname}). Wait for that revival to finish or start a separate continuation without reusing this session file.`;\n}\n\nfunction processDemonstrablyGone(\n\tpid: number,\n\tstartIdentity: string | undefined,\n\toptions: Required<Pick<SessionLeaseOptions, \"isProcessAlive\" | \"getProcessStartIdentity\">>,\n): boolean {\n\tconst alive = options.isProcessAlive(pid);\n\tif (alive === false) return true;\n\tif (alive !== true || !startIdentity) return false;\n\tconst currentIdentity = options.getProcessStartIdentity(pid);\n\treturn currentIdentity !== undefined && currentIdentity !== startIdentity;\n}\n\nfunction demonstrablyStale(owner: SessionLeaseOwner, options: Required<Pick<SessionLeaseOptions, \"hostname\" | \"isProcessAlive\" | \"getProcessStartIdentity\">>): boolean {\n\tif (owner.hostname !== options.hostname) return false;\n\tif (!processDemonstrablyGone(owner.pid, owner.processStartIdentity, options)) return false;\n\tif (owner.writerState === \"spawning\") return false;\n\tif (owner.writerState === \"none\") return true;\n\treturn owner.writerPid !== undefined\n\t\t&& processDemonstrablyGone(owner.writerPid, owner.writerProcessStartIdentity, options);\n}\n\nfunction createLeaseDirectory(leaseDir: string, owner: SessionLeaseOwner): boolean {\n\tconst tempDir = `${leaseDir}.candidate-${owner.token}`;\n\tfs.mkdirSync(path.dirname(leaseDir), { recursive: true, mode: 0o700 });\n\tfs.rmSync(tempDir, { recursive: true, force: true });\n\tfs.mkdirSync(tempDir, { mode: 0o700 });\n\ttry {\n\t\tfs.writeFileSync(path.join(tempDir, \"owner.json\"), JSON.stringify(owner, null, 2), { encoding: \"utf-8\", mode: 0o600 });\n\t\ttry {\n\t\t\tfs.renameSync(tempDir, leaseDir);\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tif (fs.existsSync(leaseDir)) return false;\n\t\t\tthrow error;\n\t\t}\n\t} finally {\n\t\tfs.rmSync(tempDir, { recursive: true, force: true });\n\t}\n}\n\nexport function acquireSessionLease(request: SessionLeaseRequest, options: SessionLeaseOptions = {}): SessionLeaseHandle {\n\tconst canonicalSessionFile = canonicalSessionFilePath(request.sessionFile);\n\tconst rootDir = options.rootDir ?? SESSION_LEASES_DIR;\n\tconst leaseDir = sessionLeaseDir(canonicalSessionFile, rootDir);\n\tconst now = options.now ?? Date.now;\n\tconst pid = options.pid ?? process.pid;\n\tconst hostname = options.hostname ?? os.hostname();\n\tconst getIdentity = options.getProcessStartIdentity ?? getProcessStartIdentity;\n\tconst processStartIdentity = options.processStartIdentity\n\t\t?? getIdentity(pid)\n\t\t?? (pid === process.pid ? `runtime:${Math.round(Date.now() - process.uptime() * 1000)}` : undefined);\n\tconst acquiredAtMs = now();\n\tconst owner: SessionLeaseOwner = {\n\t\tversion: 1,\n\t\ttoken: options.token?.() ?? randomUUID(),\n\t\tcanonicalSessionFile,\n\t\trunId: request.runId,\n\t\tsourceRunId: request.sourceRunId,\n\t\t...(request.parentSessionId ? { parentSessionId: request.parentSessionId } : {}),\n\t\tpid,\n\t\thostname,\n\t\t...(processStartIdentity ? { processStartIdentity } : {}),\n\t\twriterState: \"none\",\n\t\tacquiredAt: new Date(acquiredAtMs).toISOString(),\n\t\tacquiredAtMs,\n\t\tupdatedAtMs: acquiredAtMs,\n\t};\n\tconst staleOptions = {\n\t\thostname,\n\t\tisProcessAlive: options.isProcessAlive ?? processIsAlive,\n\t\tgetProcessStartIdentity: getIdentity,\n\t};\n\n\tfor (let attempt = 0; attempt < 4; attempt++) {\n\t\tif (createLeaseDirectory(leaseDir, owner)) {\n\t\t\tconst writeOwner = createAtomicJsonWriter();\n\t\t\treturn {\n\t\t\t\tleaseDir,\n\t\t\t\towner,\n\t\t\t\tupdateWriter(writer) {\n\t\t\t\t\tconst currentOwner = readLeaseOwner(leaseDir);\n\t\t\t\t\tif (!currentOwner || currentOwner.token !== owner.token) {\n\t\t\t\t\t\tthrow new Error(`Session revival lease ownership changed for run '${owner.runId}'.`);\n\t\t\t\t\t}\n\t\t\t\t\tconst writerProcessStartIdentity = writer.state === \"running\" ? getIdentity(writer.pid) : undefined;\n\t\t\t\t\tconst nextOwner: SessionLeaseOwner = {\n\t\t\t\t\t\t...owner,\n\t\t\t\t\t\twriterState: writer.state,\n\t\t\t\t\t\t...(writer.state === \"running\" ? { writerPid: writer.pid } : {}),\n\t\t\t\t\t\t...(writerProcessStartIdentity ? { writerProcessStartIdentity } : {}),\n\t\t\t\t\t\tupdatedAtMs: now(),\n\t\t\t\t\t};\n\t\t\t\t\tdelete nextOwner.writerPid;\n\t\t\t\t\tdelete nextOwner.writerProcessStartIdentity;\n\t\t\t\t\tif (writer.state === \"running\") {\n\t\t\t\t\t\tnextOwner.writerPid = writer.pid;\n\t\t\t\t\t\tif (writerProcessStartIdentity) nextOwner.writerProcessStartIdentity = writerProcessStartIdentity;\n\t\t\t\t\t}\n\t\t\t\t\twriteOwner(path.join(leaseDir, \"owner.json\"), nextOwner);\n\t\t\t\t\tdelete owner.writerPid;\n\t\t\t\t\tdelete owner.writerProcessStartIdentity;\n\t\t\t\t\tObject.assign(owner, nextOwner);\n\t\t\t\t},\n\t\t\t\trelease() {\n\t\t\t\t\tconst currentOwner = readLeaseOwner(leaseDir);\n\t\t\t\t\tif (!currentOwner || currentOwner.token !== owner.token) return;\n\t\t\t\t\tfs.rmSync(leaseDir, { recursive: true, force: true });\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\tconst existingOwner = readLeaseOwner(leaseDir);\n\t\tif (!existingOwner || !demonstrablyStale(existingOwner, staleOptions)) {\n\t\t\tthrow new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);\n\t\t}\n\t\t// The per-owner tombstone is retained. Every contender that observed this\n\t\t// stale token targets the same occupied destination, so only the first can\n\t\t// rename it and later contenders cannot move a successor lease by mistake.\n\t\tconst tombstone = `${leaseDir}.stale-${existingOwner.token.replace(/[^A-Za-z0-9._-]/g, \"-\")}`;\n\t\ttry {\n\t\t\tfs.renameSync(leaseDir, tombstone);\n\t\t} catch (error) {\n\t\t\tconst code = (error as NodeJS.ErrnoException).code;\n\t\t\tif (code === \"ENOENT\" || fs.existsSync(tombstone)) continue;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tconst existingOwner = readLeaseOwner(leaseDir);\n\tthrow new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);\n}\n"]}

package/dist/builtin-extensions/pi-subagents/src/runs/shared/session-lease.js

@@ -0,0 +1,244 @@
+// @ts-nocheck
+import { spawnSync } from "node:child_process";
+import { createHash, randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as os from "node:os";
+import * as path from "node:path";
+import { createAtomicJsonWriter } from "../../shared/atomic-json.js";
+import { TEMP_ROOT_DIR } from "../../shared/types.js";
+export const SESSION_LEASES_DIR = path.join(TEMP_ROOT_DIR, "session-leases");
+export class SessionLeaseConflictError extends Error {
+    owner;
+    constructor(message, owner) {
+        super(message);
+        this.name = "SessionLeaseConflictError";
+        this.owner = owner;
+    }
+}
+function getProcessStartIdentity(pid) {
+    if (process.platform === "linux") {
+        try {
+            const stat = fs.readFileSync(`/proc/${pid}/stat`, "utf-8");
+            const commandEnd = stat.lastIndexOf(")");
+            if (commandEnd === -1)
+                return undefined;
+            const fields = stat.slice(commandEnd + 1).trim().split(/\s+/);
+            const startTicks = fields[19];
+            return startTicks ? `linux:${startTicks}` : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    if (process.platform === "darwin" || process.platform === "freebsd") {
+        const result = spawnSync("/bin/ps", ["-o", "lstart=", "-p", String(pid)], { encoding: "utf-8" });
+        const started = result.status === 0 ? result.stdout.trim() : "";
+        return started ? `${process.platform}:${started}` : undefined;
+    }
+    return undefined;
+}
+function processIsAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ESRCH")
+            return false;
+        if (code === "EPERM")
+            return true;
+        return undefined;
+    }
+}
+export function canonicalSessionFilePath(sessionFile) {
+    return fs.realpathSync.native(path.resolve(sessionFile));
+}
+export function sessionLeaseDir(sessionFile, rootDir = SESSION_LEASES_DIR) {
+    const canonical = canonicalSessionFilePath(sessionFile);
+    const key = process.platform === "win32" ? canonical.toLowerCase() : canonical;
+    const digest = createHash("sha256").update(key).digest("hex");
+    return path.join(rootDir, digest);
+}
+function parseOwner(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const owner = value;
+    if (owner.version !== 1
+        || typeof owner.token !== "string"
+        || typeof owner.canonicalSessionFile !== "string"
+        || typeof owner.runId !== "string"
+        || typeof owner.sourceRunId !== "string"
+        || typeof owner.pid !== "number"
+        || !Number.isInteger(owner.pid)
+        || owner.pid <= 0
+        || typeof owner.hostname !== "string"
+        || (owner.writerState !== "none" && owner.writerState !== "spawning" && owner.writerState !== "running")
+        || typeof owner.acquiredAt !== "string"
+        || typeof owner.acquiredAtMs !== "number"
+        || typeof owner.updatedAtMs !== "number")
+        return undefined;
+    if (owner.parentSessionId !== undefined && typeof owner.parentSessionId !== "string")
+        return undefined;
+    if (owner.processStartIdentity !== undefined && typeof owner.processStartIdentity !== "string")
+        return undefined;
+    if (owner.writerPid !== undefined && (typeof owner.writerPid !== "number" || !Number.isInteger(owner.writerPid) || owner.writerPid <= 0))
+        return undefined;
+    if (owner.writerProcessStartIdentity !== undefined && typeof owner.writerProcessStartIdentity !== "string")
+        return undefined;
+    if (owner.writerState === "running" && owner.writerPid === undefined)
+        return undefined;
+    if (owner.writerState !== "running" && (owner.writerPid !== undefined || owner.writerProcessStartIdentity !== undefined))
+        return undefined;
+    return owner;
+}
+function readLeaseOwner(leaseDir) {
+    try {
+        return parseOwner(JSON.parse(fs.readFileSync(path.join(leaseDir, "owner.json"), "utf-8")));
+    }
+    catch {
+        return undefined;
+    }
+}
+function conflictMessage(canonicalSessionFile, owner) {
+    if (!owner) {
+        return `Direct revival of session '${canonicalSessionFile}' is blocked by an existing lease with unreadable owner metadata. Refusing to reclaim it without proof that the owner is stale.`;
+    }
+    const parent = owner.parentSessionId ? `, parent session '${owner.parentSessionId}'` : "";
+    return `Direct revival of session '${canonicalSessionFile}' is already owned by run '${owner.runId}' (source run '${owner.sourceRunId}'${parent}, pid ${owner.pid} on ${owner.hostname}). Wait for that revival to finish or start a separate continuation without reusing this session file.`;
+}
+function processDemonstrablyGone(pid, startIdentity, options) {
+    const alive = options.isProcessAlive(pid);
+    if (alive === false)
+        return true;
+    if (alive !== true || !startIdentity)
+        return false;
+    const currentIdentity = options.getProcessStartIdentity(pid);
+    return currentIdentity !== undefined && currentIdentity !== startIdentity;
+}
+function demonstrablyStale(owner, options) {
+    if (owner.hostname !== options.hostname)
+        return false;
+    if (!processDemonstrablyGone(owner.pid, owner.processStartIdentity, options))
+        return false;
+    if (owner.writerState === "spawning")
+        return false;
+    if (owner.writerState === "none")
+        return true;
+    return owner.writerPid !== undefined
+        && processDemonstrablyGone(owner.writerPid, owner.writerProcessStartIdentity, options);
+}
+function createLeaseDirectory(leaseDir, owner) {
+    const tempDir = `${leaseDir}.candidate-${owner.token}`;
+    fs.mkdirSync(path.dirname(leaseDir), { recursive: true, mode: 0o700 });
+    fs.rmSync(tempDir, { recursive: true, force: true });
+    fs.mkdirSync(tempDir, { mode: 0o700 });
+    try {
+        fs.writeFileSync(path.join(tempDir, "owner.json"), JSON.stringify(owner, null, 2), { encoding: "utf-8", mode: 0o600 });
+        try {
+            fs.renameSync(tempDir, leaseDir);
+            return true;
+        }
+        catch (error) {
+            if (fs.existsSync(leaseDir))
+                return false;
+            throw error;
+        }
+    }
+    finally {
+        fs.rmSync(tempDir, { recursive: true, force: true });
+    }
+}
+export function acquireSessionLease(request, options = {}) {
+    const canonicalSessionFile = canonicalSessionFilePath(request.sessionFile);
+    const rootDir = options.rootDir ?? SESSION_LEASES_DIR;
+    const leaseDir = sessionLeaseDir(canonicalSessionFile, rootDir);
+    const now = options.now ?? Date.now;
+    const pid = options.pid ?? process.pid;
+    const hostname = options.hostname ?? os.hostname();
+    const getIdentity = options.getProcessStartIdentity ?? getProcessStartIdentity;
+    const processStartIdentity = options.processStartIdentity
+        ?? getIdentity(pid)
+        ?? (pid === process.pid ? `runtime:${Math.round(Date.now() - process.uptime() * 1000)}` : undefined);
+    const acquiredAtMs = now();
+    const owner = {
+        version: 1,
+        token: options.token?.() ?? randomUUID(),
+        canonicalSessionFile,
+        runId: request.runId,
+        sourceRunId: request.sourceRunId,
+        ...(request.parentSessionId ? { parentSessionId: request.parentSessionId } : {}),
+        pid,
+        hostname,
+        ...(processStartIdentity ? { processStartIdentity } : {}),
+        writerState: "none",
+        acquiredAt: new Date(acquiredAtMs).toISOString(),
+        acquiredAtMs,
+        updatedAtMs: acquiredAtMs,
+    };
+    const staleOptions = {
+        hostname,
+        isProcessAlive: options.isProcessAlive ?? processIsAlive,
+        getProcessStartIdentity: getIdentity,
+    };
+    for (let attempt = 0; attempt < 4; attempt++) {
+        if (createLeaseDirectory(leaseDir, owner)) {
+            const writeOwner = createAtomicJsonWriter();
+            return {
+                leaseDir,
+                owner,
+                updateWriter(writer) {
+                    const currentOwner = readLeaseOwner(leaseDir);
+                    if (!currentOwner || currentOwner.token !== owner.token) {
+                        throw new Error(`Session revival lease ownership changed for run '${owner.runId}'.`);
+                    }
+                    const writerProcessStartIdentity = writer.state === "running" ? getIdentity(writer.pid) : undefined;
+                    const nextOwner = {
+                        ...owner,
+                        writerState: writer.state,
+                        ...(writer.state === "running" ? { writerPid: writer.pid } : {}),
+                        ...(writerProcessStartIdentity ? { writerProcessStartIdentity } : {}),
+                        updatedAtMs: now(),
+                    };
+                    delete nextOwner.writerPid;
+                    delete nextOwner.writerProcessStartIdentity;
+                    if (writer.state === "running") {
+                        nextOwner.writerPid = writer.pid;
+                        if (writerProcessStartIdentity)
+                            nextOwner.writerProcessStartIdentity = writerProcessStartIdentity;
+                    }
+                    writeOwner(path.join(leaseDir, "owner.json"), nextOwner);
+                    delete owner.writerPid;
+                    delete owner.writerProcessStartIdentity;
+                    Object.assign(owner, nextOwner);
+                },
+                release() {
+                    const currentOwner = readLeaseOwner(leaseDir);
+                    if (!currentOwner || currentOwner.token !== owner.token)
+                        return;
+                    fs.rmSync(leaseDir, { recursive: true, force: true });
+                },
+            };
+        }
+        const existingOwner = readLeaseOwner(leaseDir);
+        if (!existingOwner || !demonstrablyStale(existingOwner, staleOptions)) {
+            throw new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);
+        }
+        // The per-owner tombstone is retained. Every contender that observed this
+        // stale token targets the same occupied destination, so only the first can
+        // rename it and later contenders cannot move a successor lease by mistake.
+        const tombstone = `${leaseDir}.stale-${existingOwner.token.replace(/[^A-Za-z0-9._-]/g, "-")}`;
+        try {
+            fs.renameSync(leaseDir, tombstone);
+        }
+        catch (error) {
+            const code = error.code;
+            if (code === "ENOENT" || fs.existsSync(tombstone))
+                continue;
+            throw error;
+        }
+    }
+    const existingOwner = readLeaseOwner(leaseDir);
+    throw new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);
+}
+//# sourceMappingURL=session-lease.js.map

package/dist/builtin-extensions/pi-subagents/src/runs/shared/session-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-lease.js","sourceRoot":"","sources":["../../../../../../src/builtin-extensions/pi-subagents/src/runs/shared/session-lease.ts"],"names":[],"mappings":"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","sourcesContent":["// @ts-nocheck\nimport { spawnSync } from \"node:child_process\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport * as fs from \"node:fs\";\nimport * as os from \"node:os\";\nimport * as path from \"node:path\";\nimport { createAtomicJsonWriter } from \"../../shared/atomic-json.ts\";\nimport { TEMP_ROOT_DIR } from \"../../shared/types.ts\";\n\nexport const SESSION_LEASES_DIR = path.join(TEMP_ROOT_DIR, \"session-leases\");\n\nexport interface SessionLeaseRequest {\n\tsessionFile: string;\n\trunId: string;\n\tsourceRunId: string;\n\tparentSessionId?: string;\n}\n\nexport interface SessionLeaseOwner {\n\tversion: 1;\n\ttoken: string;\n\tcanonicalSessionFile: string;\n\trunId: string;\n\tsourceRunId: string;\n\tparentSessionId?: string;\n\tpid: number;\n\thostname: string;\n\tprocessStartIdentity?: string;\n\twriterState: \"none\" | \"spawning\" | \"running\";\n\twriterPid?: number;\n\twriterProcessStartIdentity?: string;\n\tacquiredAt: string;\n\tacquiredAtMs: number;\n\tupdatedAtMs: number;\n}\n\nexport interface SessionLeaseHandle {\n\tleaseDir: string;\n\towner: SessionLeaseOwner;\n\tupdateWriter(writer: { state: \"none\" | \"spawning\" } | { state: \"running\"; pid: number }): void;\n\trelease(): void;\n}\n\ninterface SessionLeaseOptions {\n\trootDir?: string;\n\tnow?: () => number;\n\ttoken?: () => string;\n\tpid?: number;\n\thostname?: string;\n\tprocessStartIdentity?: string;\n\tisProcessAlive?: (pid: number) => boolean | undefined;\n\tgetProcessStartIdentity?: (pid: number) => string | undefined;\n}\n\nexport class SessionLeaseConflictError extends Error {\n\treadonly owner?: SessionLeaseOwner;\n\n\tconstructor(message: string, owner?: SessionLeaseOwner) {\n\t\tsuper(message);\n\t\tthis.name = \"SessionLeaseConflictError\";\n\t\tthis.owner = owner;\n\t}\n}\n\nfunction getProcessStartIdentity(pid: number): string | undefined {\n\tif (process.platform === \"linux\") {\n\t\ttry {\n\t\t\tconst stat = fs.readFileSync(`/proc/${pid}/stat`, \"utf-8\");\n\t\t\tconst commandEnd = stat.lastIndexOf(\")\");\n\t\t\tif (commandEnd === -1) return undefined;\n\t\t\tconst fields = stat.slice(commandEnd + 1).trim().split(/\\s+/);\n\t\t\tconst startTicks = fields[19];\n\t\t\treturn startTicks ? `linux:${startTicks}` : undefined;\n\t\t} catch {\n\t\t\treturn undefined;\n\t\t}\n\t}\n\tif (process.platform === \"darwin\" || process.platform === \"freebsd\") {\n\t\tconst result = spawnSync(\"/bin/ps\", [\"-o\", \"lstart=\", \"-p\", String(pid)], { encoding: \"utf-8\" });\n\t\tconst started = result.status === 0 ? result.stdout.trim() : \"\";\n\t\treturn started ? `${process.platform}:${started}` : undefined;\n\t}\n\treturn undefined;\n}\n\nfunction processIsAlive(pid: number): boolean | undefined {\n\ttry {\n\t\tprocess.kill(pid, 0);\n\t\treturn true;\n\t} catch (error) {\n\t\tconst code = (error as NodeJS.ErrnoException).code;\n\t\tif (code === \"ESRCH\") return false;\n\t\tif (code === \"EPERM\") return true;\n\t\treturn undefined;\n\t}\n}\n\nexport function canonicalSessionFilePath(sessionFile: string): string {\n\treturn fs.realpathSync.native(path.resolve(sessionFile));\n}\n\nexport function sessionLeaseDir(sessionFile: string, rootDir = SESSION_LEASES_DIR): string {\n\tconst canonical = canonicalSessionFilePath(sessionFile);\n\tconst key = process.platform === \"win32\" ? canonical.toLowerCase() : canonical;\n\tconst digest = createHash(\"sha256\").update(key).digest(\"hex\");\n\treturn path.join(rootDir, digest);\n}\n\nfunction parseOwner(value: unknown): SessionLeaseOwner | undefined {\n\tif (!value || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n\tconst owner = value as Partial<SessionLeaseOwner>;\n\tif (owner.version !== 1\n\t\t|| typeof owner.token !== \"string\"\n\t\t|| typeof owner.canonicalSessionFile !== \"string\"\n\t\t|| typeof owner.runId !== \"string\"\n\t\t|| typeof owner.sourceRunId !== \"string\"\n\t\t|| typeof owner.pid !== \"number\"\n\t\t|| !Number.isInteger(owner.pid)\n\t\t|| owner.pid <= 0\n\t\t|| typeof owner.hostname !== \"string\"\n\t\t|| (owner.writerState !== \"none\" && owner.writerState !== \"spawning\" && owner.writerState !== \"running\")\n\t\t|| typeof owner.acquiredAt !== \"string\"\n\t\t|| typeof owner.acquiredAtMs !== \"number\"\n\t\t|| typeof owner.updatedAtMs !== \"number\") return undefined;\n\tif (owner.parentSessionId !== undefined && typeof owner.parentSessionId !== \"string\") return undefined;\n\tif (owner.processStartIdentity !== undefined && typeof owner.processStartIdentity !== \"string\") return undefined;\n\tif (owner.writerPid !== undefined && (typeof owner.writerPid !== \"number\" || !Number.isInteger(owner.writerPid) || owner.writerPid <= 0)) return undefined;\n\tif (owner.writerProcessStartIdentity !== undefined && typeof owner.writerProcessStartIdentity !== \"string\") return undefined;\n\tif (owner.writerState === \"running\" && owner.writerPid === undefined) return undefined;\n\tif (owner.writerState !== \"running\" && (owner.writerPid !== undefined || owner.writerProcessStartIdentity !== undefined)) return undefined;\n\treturn owner as SessionLeaseOwner;\n}\n\nfunction readLeaseOwner(leaseDir: string): SessionLeaseOwner | undefined {\n\ttry {\n\t\treturn parseOwner(JSON.parse(fs.readFileSync(path.join(leaseDir, \"owner.json\"), \"utf-8\")));\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\nfunction conflictMessage(canonicalSessionFile: string, owner: SessionLeaseOwner | undefined): string {\n\tif (!owner) {\n\t\treturn `Direct revival of session '${canonicalSessionFile}' is blocked by an existing lease with unreadable owner metadata. Refusing to reclaim it without proof that the owner is stale.`;\n\t}\n\tconst parent = owner.parentSessionId ? `, parent session '${owner.parentSessionId}'` : \"\";\n\treturn `Direct revival of session '${canonicalSessionFile}' is already owned by run '${owner.runId}' (source run '${owner.sourceRunId}'${parent}, pid ${owner.pid} on ${owner.hostname}). Wait for that revival to finish or start a separate continuation without reusing this session file.`;\n}\n\nfunction processDemonstrablyGone(\n\tpid: number,\n\tstartIdentity: string | undefined,\n\toptions: Required<Pick<SessionLeaseOptions, \"isProcessAlive\" | \"getProcessStartIdentity\">>,\n): boolean {\n\tconst alive = options.isProcessAlive(pid);\n\tif (alive === false) return true;\n\tif (alive !== true || !startIdentity) return false;\n\tconst currentIdentity = options.getProcessStartIdentity(pid);\n\treturn currentIdentity !== undefined && currentIdentity !== startIdentity;\n}\n\nfunction demonstrablyStale(owner: SessionLeaseOwner, options: Required<Pick<SessionLeaseOptions, \"hostname\" | \"isProcessAlive\" | \"getProcessStartIdentity\">>): boolean {\n\tif (owner.hostname !== options.hostname) return false;\n\tif (!processDemonstrablyGone(owner.pid, owner.processStartIdentity, options)) return false;\n\tif (owner.writerState === \"spawning\") return false;\n\tif (owner.writerState === \"none\") return true;\n\treturn owner.writerPid !== undefined\n\t\t&& processDemonstrablyGone(owner.writerPid, owner.writerProcessStartIdentity, options);\n}\n\nfunction createLeaseDirectory(leaseDir: string, owner: SessionLeaseOwner): boolean {\n\tconst tempDir = `${leaseDir}.candidate-${owner.token}`;\n\tfs.mkdirSync(path.dirname(leaseDir), { recursive: true, mode: 0o700 });\n\tfs.rmSync(tempDir, { recursive: true, force: true });\n\tfs.mkdirSync(tempDir, { mode: 0o700 });\n\ttry {\n\t\tfs.writeFileSync(path.join(tempDir, \"owner.json\"), JSON.stringify(owner, null, 2), { encoding: \"utf-8\", mode: 0o600 });\n\t\ttry {\n\t\t\tfs.renameSync(tempDir, leaseDir);\n\t\t\treturn true;\n\t\t} catch (error) {\n\t\t\tif (fs.existsSync(leaseDir)) return false;\n\t\t\tthrow error;\n\t\t}\n\t} finally {\n\t\tfs.rmSync(tempDir, { recursive: true, force: true });\n\t}\n}\n\nexport function acquireSessionLease(request: SessionLeaseRequest, options: SessionLeaseOptions = {}): SessionLeaseHandle {\n\tconst canonicalSessionFile = canonicalSessionFilePath(request.sessionFile);\n\tconst rootDir = options.rootDir ?? SESSION_LEASES_DIR;\n\tconst leaseDir = sessionLeaseDir(canonicalSessionFile, rootDir);\n\tconst now = options.now ?? Date.now;\n\tconst pid = options.pid ?? process.pid;\n\tconst hostname = options.hostname ?? os.hostname();\n\tconst getIdentity = options.getProcessStartIdentity ?? getProcessStartIdentity;\n\tconst processStartIdentity = options.processStartIdentity\n\t\t?? getIdentity(pid)\n\t\t?? (pid === process.pid ? `runtime:${Math.round(Date.now() - process.uptime() * 1000)}` : undefined);\n\tconst acquiredAtMs = now();\n\tconst owner: SessionLeaseOwner = {\n\t\tversion: 1,\n\t\ttoken: options.token?.() ?? randomUUID(),\n\t\tcanonicalSessionFile,\n\t\trunId: request.runId,\n\t\tsourceRunId: request.sourceRunId,\n\t\t...(request.parentSessionId ? { parentSessionId: request.parentSessionId } : {}),\n\t\tpid,\n\t\thostname,\n\t\t...(processStartIdentity ? { processStartIdentity } : {}),\n\t\twriterState: \"none\",\n\t\tacquiredAt: new Date(acquiredAtMs).toISOString(),\n\t\tacquiredAtMs,\n\t\tupdatedAtMs: acquiredAtMs,\n\t};\n\tconst staleOptions = {\n\t\thostname,\n\t\tisProcessAlive: options.isProcessAlive ?? processIsAlive,\n\t\tgetProcessStartIdentity: getIdentity,\n\t};\n\n\tfor (let attempt = 0; attempt < 4; attempt++) {\n\t\tif (createLeaseDirectory(leaseDir, owner)) {\n\t\t\tconst writeOwner = createAtomicJsonWriter();\n\t\t\treturn {\n\t\t\t\tleaseDir,\n\t\t\t\towner,\n\t\t\t\tupdateWriter(writer) {\n\t\t\t\t\tconst currentOwner = readLeaseOwner(leaseDir);\n\t\t\t\t\tif (!currentOwner || currentOwner.token !== owner.token) {\n\t\t\t\t\t\tthrow new Error(`Session revival lease ownership changed for run '${owner.runId}'.`);\n\t\t\t\t\t}\n\t\t\t\t\tconst writerProcessStartIdentity = writer.state === \"running\" ? getIdentity(writer.pid) : undefined;\n\t\t\t\t\tconst nextOwner: SessionLeaseOwner = {\n\t\t\t\t\t\t...owner,\n\t\t\t\t\t\twriterState: writer.state,\n\t\t\t\t\t\t...(writer.state === \"running\" ? { writerPid: writer.pid } : {}),\n\t\t\t\t\t\t...(writerProcessStartIdentity ? { writerProcessStartIdentity } : {}),\n\t\t\t\t\t\tupdatedAtMs: now(),\n\t\t\t\t\t};\n\t\t\t\t\tdelete nextOwner.writerPid;\n\t\t\t\t\tdelete nextOwner.writerProcessStartIdentity;\n\t\t\t\t\tif (writer.state === \"running\") {\n\t\t\t\t\t\tnextOwner.writerPid = writer.pid;\n\t\t\t\t\t\tif (writerProcessStartIdentity) nextOwner.writerProcessStartIdentity = writerProcessStartIdentity;\n\t\t\t\t\t}\n\t\t\t\t\twriteOwner(path.join(leaseDir, \"owner.json\"), nextOwner);\n\t\t\t\t\tdelete owner.writerPid;\n\t\t\t\t\tdelete owner.writerProcessStartIdentity;\n\t\t\t\t\tObject.assign(owner, nextOwner);\n\t\t\t\t},\n\t\t\t\trelease() {\n\t\t\t\t\tconst currentOwner = readLeaseOwner(leaseDir);\n\t\t\t\t\tif (!currentOwner || currentOwner.token !== owner.token) return;\n\t\t\t\t\tfs.rmSync(leaseDir, { recursive: true, force: true });\n\t\t\t\t},\n\t\t\t};\n\t\t}\n\n\t\tconst existingOwner = readLeaseOwner(leaseDir);\n\t\tif (!existingOwner || !demonstrablyStale(existingOwner, staleOptions)) {\n\t\t\tthrow new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);\n\t\t}\n\t\t// The per-owner tombstone is retained. Every contender that observed this\n\t\t// stale token targets the same occupied destination, so only the first can\n\t\t// rename it and later contenders cannot move a successor lease by mistake.\n\t\tconst tombstone = `${leaseDir}.stale-${existingOwner.token.replace(/[^A-Za-z0-9._-]/g, \"-\")}`;\n\t\ttry {\n\t\t\tfs.renameSync(leaseDir, tombstone);\n\t\t} catch (error) {\n\t\t\tconst code = (error as NodeJS.ErrnoException).code;\n\t\t\tif (code === \"ENOENT\" || fs.existsSync(tombstone)) continue;\n\t\t\tthrow error;\n\t\t}\n\t}\n\n\tconst existingOwner = readLeaseOwner(leaseDir);\n\tthrow new SessionLeaseConflictError(conflictMessage(canonicalSessionFile, existingOwner), existingOwner);\n}\n"]}