@mono-agent/agent-app 0.8.0 → 0.9.0

package/dist/background-worker-lease.js

@@ -0,0 +1,356 @@
+import { createHash, randomUUID } from "node:crypto";
+import { constants as fsConstants } from "node:fs";
+import { chmod, lstat, mkdir, open, realpath, rename, rm, } from "node:fs/promises";
+import { userInfo } from "node:os";
+import { basename, dirname, join, resolve } from "node:path";
+import process from "node:process";
+import { currentProcessIncarnation, isSameProcessIncarnation as matchesProcessIncarnation, processIncarnationFromJson, } from "./process-incarnation.js";
+const LEASE_SCHEMA = "mono-agent.background-worker-lease.v2";
+const DEFAULT_OWNERLESS_GRACE_MS = 5 * 60_000;
+const MAX_ACQUIRE_ATTEMPTS = 4;
+/**
+ * Stable owner-private lifetime-lease path for one exact resolved config.
+ * The full path digest avoids relying on the shorter human-facing launchd hash.
+ */
+export function backgroundWorkerLeasePath(configPath, homeDir = effectiveUserHome()) {
+    const resolvedConfig = resolve(configPath);
+    const digest = createHash("sha256").update(resolvedConfig).digest("hex");
+    return join(resolve(homeDir), ".mono-agent", "worker-leases", `${digest}.lease`);
+}
+/**
+ * Acquire the process-lifetime singleton for a config.
+ *
+ * `undefined` means either a live owner or a fresh ownerless directory (the
+ * atomic mkdir -> owner.json initialization window) already holds the lease.
+ * Dead owners and old ownerless crash debris are atomically quarantined before
+ * one bounded retry. The returned lease must be held until worker shutdown.
+ */
+export async function acquireBackgroundWorkerLease(configPath, options = {}) {
+    const resolvedConfig = await canonicalLeaseConfigPath(configPath);
+    // The singleton location belongs to the effective OS account, not an
+    // ambient HOME override. Tests and explicit embeddings retain a narrow
+    // homeDir seam, while normal workers always converge on one lease root.
+    const home = resolve(options.homeDir ?? effectiveUserHome());
+    const pid = options.pid ?? process.pid;
+    if (!Number.isSafeInteger(pid) || pid <= 0) {
+        throw new Error(`Background worker lease pid must be a positive safe integer; received ${String(pid)}.`);
+    }
+    const now = options.now ?? (() => Date.now());
+    const incarnation = options.processIncarnation ?? await currentProcessIncarnation();
+    const isSameProcess = options.isSameProcessIncarnation ?? matchesProcessIncarnation;
+    const randomToken = options.randomToken ?? randomUUID;
+    const ownerlessGraceMs = options.ownerlessGraceMs ?? DEFAULT_OWNERLESS_GRACE_MS;
+    if (!Number.isFinite(ownerlessGraceMs) || ownerlessGraceMs < 0) {
+        throw new Error("Background worker lease ownerless grace must be a non-negative finite duration.");
+    }
+    const leasesRoot = await ensurePrivateLeaseRoot(home);
+    const leasePath = backgroundWorkerLeasePath(resolvedConfig, home);
+    const leaseId = basename(leasePath, ".lease");
+    const ownerPath = join(leasePath, "owner.json");
+    for (let attempt = 0; attempt < MAX_ACQUIRE_ATTEMPTS; attempt += 1) {
+        let createdIdentity;
+        try {
+            await mkdir(leasePath, { mode: 0o700 });
+            const created = await assertPrivateDirectory(leasePath, "Background worker lease");
+            createdIdentity = identityOf(created);
+            await options.hooks?.afterLeaseDirectoryCreated?.();
+            await assertSamePrivateDirectory(leasePath, createdIdentity, "Background worker lease");
+            const token = safeToken(randomToken());
+            const owner = {
+                schema: LEASE_SCHEMA,
+                configPath: resolvedConfig,
+                pid,
+                token,
+                createdAt: new Date(now()).toISOString(),
+                incarnation,
+            };
+            await writeOwnerRecord(ownerPath, owner);
+            await assertSamePrivateDirectory(leasePath, createdIdentity, "Background worker lease");
+            return createLease({
+                configPath: resolvedConfig,
+                leasePath,
+                leasesRoot,
+                owner,
+                identity: createdIdentity,
+                leaseId,
+                randomToken,
+            });
+        }
+        catch (error) {
+            if (createdIdentity !== undefined) {
+                await removeIfSameDirectory(leasePath, createdIdentity).catch(() => undefined);
+            }
+            if (!isErrno(error, "EEXIST"))
+                throw error;
+        }
+        const existing = await inspectExistingLease(leasePath, ownerPath, resolvedConfig);
+        if (existing === undefined)
+            continue;
+        if (existing.kind === "owned") {
+            let sameOwner = true;
+            try {
+                sameOwner = await isSameProcess(existing.owner.pid, existing.owner.incarnation);
+            }
+            catch {
+                // A failed incarnation probe cannot authorize stealing another process's lease.
+                sameOwner = true;
+            }
+            if (sameOwner)
+                return undefined;
+        }
+        else if (now() - existing.mtimeMs < ownerlessGraceMs) {
+            // Never steal the normal mkdir -> owner.json initialization window.
+            return undefined;
+        }
+        await options.hooks?.beforeStaleLeaseRename?.();
+        if (!(await samePrivateDirectory(leasePath, existing.identity)))
+            continue;
+        const quarantine = join(leasesRoot, `.${leaseId}-${now()}-${pid}-${safeToken(randomToken())}.stale`);
+        try {
+            await rename(leasePath, quarantine);
+        }
+        catch (error) {
+            if (isErrno(error, "ENOENT") || isErrno(error, "EEXIST"))
+                continue;
+            return undefined;
+        }
+        const moved = await lstat(quarantine);
+        if (!sameIdentity(moved, existing.identity)) {
+            // A same-user path swap crossed the final rename boundary. Restore when
+            // possible and fail closed rather than claiming a potentially live lease.
+            await rename(quarantine, leasePath).catch(() => undefined);
+            return undefined;
+        }
+        await rm(quarantine, { recursive: true, force: true });
+    }
+    return undefined;
+}
+async function canonicalLeaseConfigPath(configPath) {
+    const lexical = resolve(configPath);
+    try {
+        const candidate = join(await realpath(dirname(lexical)), basename(lexical));
+        try {
+            const details = await lstat(candidate);
+            return details.isSymbolicLink() ? candidate : await realpath(candidate);
+        }
+        catch (error) {
+            if (isErrno(error, "ENOENT") || isErrno(error, "ENOTDIR"))
+                return candidate;
+            throw error;
+        }
+    }
+    catch (error) {
+        // The lease helper is also useful for fail-closed diagnostics/tests before
+        // a config exists. Normal foreground startup has already required the
+        // config and therefore always takes the canonical-parent branch.
+        if (isErrno(error, "ENOENT") || isErrno(error, "ENOTDIR"))
+            return lexical;
+        throw error;
+    }
+}
+function effectiveUserHome() {
+    const home = userInfo().homedir;
+    if (home.length === 0) {
+        throw new Error("Cannot determine the effective OS user's home for the background worker lease.");
+    }
+    return home;
+}
+function createLease(input) {
+    let released = false;
+    return {
+        configPath: input.configPath,
+        path: input.leasePath,
+        ownerPid: input.owner.pid,
+        async release() {
+            if (released)
+                return;
+            await assertSamePrivateDirectory(input.leasePath, input.identity, "Background worker lease");
+            const current = await readOwnerRecord(join(input.leasePath, "owner.json"), input.configPath);
+            if (current === undefined
+                || current.pid !== input.owner.pid
+                || current.token !== input.owner.token) {
+                throw new Error(`Background worker lease ${input.leasePath} is no longer owned by this worker.`);
+            }
+            const releasedPath = join(input.leasesRoot, `.${input.leaseId}-${input.owner.pid}-${safeToken(input.randomToken())}.released`);
+            await rename(input.leasePath, releasedPath);
+            const moved = await assertPrivateDirectory(releasedPath, "Released background worker lease");
+            if (!sameIdentity(moved, input.identity)) {
+                await rename(releasedPath, input.leasePath).catch(() => undefined);
+                throw new Error(`Background worker lease ${input.leasePath} changed during release.`);
+            }
+            released = true;
+            await rm(releasedPath, { recursive: true, force: true });
+        },
+    };
+}
+async function ensurePrivateLeaseRoot(home) {
+    const homeDetails = await lstat(home);
+    if (!homeDetails.isDirectory() || homeDetails.isSymbolicLink()) {
+        throw new Error(`Background worker lease home ${home} must be a real directory.`);
+    }
+    assertOwned(homeDetails, home, "Background worker lease home");
+    const managedRoot = join(home, ".mono-agent");
+    const leasesRoot = join(managedRoot, "worker-leases");
+    for (const path of [managedRoot, leasesRoot]) {
+        try {
+            await mkdir(path, { mode: 0o700 });
+        }
+        catch (error) {
+            if (!isErrno(error, "EEXIST"))
+                throw error;
+        }
+        const before = await lstat(path);
+        if (!before.isDirectory() || before.isSymbolicLink()) {
+            throw new Error(`Background worker lease parent ${path} must be a real directory.`);
+        }
+        assertOwned(before, path, "Background worker lease parent");
+        await chmod(path, 0o700);
+        const secured = await lstat(path);
+        if (!sameIdentity(secured, identityOf(before))) {
+            throw new Error(`Background worker lease parent ${path} changed while it was secured.`);
+        }
+        assertPrivateDirectoryDetails(secured, path, "Background worker lease parent");
+    }
+    return leasesRoot;
+}
+async function inspectExistingLease(leasePath, ownerPath, configPath) {
+    let details;
+    try {
+        details = await assertPrivateDirectory(leasePath, "Existing background worker lease");
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT"))
+            return undefined;
+        throw error;
+    }
+    const identity = identityOf(details);
+    const owner = await readOwnerRecord(ownerPath, configPath);
+    return owner === undefined
+        ? { kind: "ownerless", mtimeMs: details.mtimeMs, identity }
+        : { kind: "owned", owner, identity };
+}
+async function writeOwnerRecord(path, owner) {
+    const flags = fsConstants.O_WRONLY
+        | fsConstants.O_CREAT
+        | fsConstants.O_EXCL
+        | (fsConstants.O_NOFOLLOW ?? 0);
+    const handle = await open(path, flags, 0o600);
+    try {
+        await handle.writeFile(`${JSON.stringify(owner)}\n`, "utf8");
+        await handle.sync();
+        assertPrivateOwnerFile(await handle.stat(), path);
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function readOwnerRecord(path, configPath) {
+    const flags = fsConstants.O_RDONLY | (fsConstants.O_NOFOLLOW ?? 0);
+    let handle;
+    try {
+        handle = await open(path, flags);
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT"))
+            return undefined;
+        throw error;
+    }
+    try {
+        assertPrivateOwnerFile(await handle.stat(), path);
+        let parsed;
+        try {
+            parsed = JSON.parse(await handle.readFile("utf8"));
+        }
+        catch {
+            return undefined;
+        }
+        const incarnation = processIncarnationFromJson(parsed.incarnation);
+        return parsed.schema === LEASE_SCHEMA
+            && parsed.configPath === configPath
+            && typeof parsed.pid === "number"
+            && Number.isSafeInteger(parsed.pid)
+            && parsed.pid > 0
+            && typeof parsed.token === "string"
+            && parsed.token.length > 0
+            && typeof parsed.createdAt === "string"
+            && incarnation !== undefined
+            ? {
+                schema: LEASE_SCHEMA,
+                configPath,
+                pid: parsed.pid,
+                token: parsed.token,
+                createdAt: parsed.createdAt,
+                incarnation,
+            }
+            : undefined;
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function assertPrivateDirectory(path, label) {
+    const details = await lstat(path);
+    assertPrivateDirectoryDetails(details, path, label);
+    return details;
+}
+function assertPrivateDirectoryDetails(details, path, label) {
+    if (!details.isDirectory() || details.isSymbolicLink()) {
+        throw new Error(`${label} ${path} must be a real directory.`);
+    }
+    assertOwned(details, path, label);
+    if ((details.mode & 0o077) !== 0) {
+        throw new Error(`${label} ${path} must be owner-only (mode 0700).`);
+    }
+}
+function assertPrivateOwnerFile(details, path) {
+    if (!details.isFile()
+        || details.isSymbolicLink()
+        || details.nlink !== 1
+        || (details.mode & 0o077) !== 0) {
+        throw new Error(`Background worker lease owner ${path} must be an owner-only single-link regular file.`);
+    }
+    assertOwned(details, path, "Background worker lease owner");
+}
+function assertOwned(details, path, label) {
+    if (typeof process.getuid === "function" && details.uid !== process.getuid()) {
+        throw new Error(`${label} ${path} is not owned by the current user.`);
+    }
+}
+async function assertSamePrivateDirectory(path, identity, label) {
+    const details = await assertPrivateDirectory(path, label);
+    if (!sameIdentity(details, identity)) {
+        throw new Error(`${label} ${path} changed while the lease was active.`);
+    }
+}
+async function samePrivateDirectory(path, identity) {
+    try {
+        const details = await assertPrivateDirectory(path, "Background worker lease");
+        return sameIdentity(details, identity);
+    }
+    catch (error) {
+        if (isErrno(error, "ENOENT"))
+            return false;
+        throw error;
+    }
+}
+async function removeIfSameDirectory(path, identity) {
+    if (await samePrivateDirectory(path, identity)) {
+        await rm(path, { recursive: true, force: true });
+    }
+}
+function identityOf(details) {
+    return { dev: details.dev, ino: details.ino };
+}
+function sameIdentity(details, identity) {
+    return details.dev === identity.dev && details.ino === identity.ino;
+}
+function safeToken(value) {
+    if (!/^[0-9A-Za-z._-]+$/u.test(value) || value.length === 0) {
+        throw new Error("Background worker lease token contains unsupported characters.");
+    }
+    return value;
+}
+function isErrno(error, code) {
+    return typeof error === "object" && error !== null && error.code === code;
+}
+//# sourceMappingURL=background-worker-lease.js.map

package/dist/background-worker-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-worker-lease.js","sourceRoot":"","sources":["../src/background-worker-lease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,SAAS,IAAI,WAAW,EAAc,MAAM,SAAS,CAAC;AAC/D,OAAO,EACL,KAAK,EACL,KAAK,EACL,KAAK,EACL,IAAI,EACJ,QAAQ,EACR,MAAM,EACN,EAAE,GACH,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7D,OAAO,OAAO,MAAM,cAAc,CAAC;AAEnC,OAAO,EACL,yBAAyB,EACzB,wBAAwB,IAAI,yBAAyB,EACrD,0BAA0B,GAC3B,MAAM,0BAA0B,CAAC;AAGlC,MAAM,YAAY,GAAG,uCAAuC,CAAC;AAC7D,MAAM,0BAA0B,GAAG,CAAC,GAAG,MAAM,CAAC;AAC9C,MAAM,oBAAoB,GAAG,CAAC,CAAC;AA6C/B;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CACvC,UAAkB,EAClB,UAAkB,iBAAiB,EAAE;IAErC,MAAM,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACzE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,MAAM,QAAQ,CAAC,CAAC;AACnF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,UAAkB,EAClB,UAAwC,EAAE;IAE1C,MAAM,cAAc,GAAG,MAAM,wBAAwB,CAAC,UAAU,CAAC,CAAC;IAClE,qEAAqE;IACrE,uEAAuE;IACvE,wEAAwE;IACxE,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,iBAAiB,EAAE,CAAC,CAAC;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,yEAAyE,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3G,CAAC;IACD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC9C,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,IAAI,MAAM,yBAAyB,EAAE,CAAC;IACpF,MAAM,aAAa,GAAG,OAAO,CAAC,wBAAwB,IAAI,yBAAyB,CAAC;IACpF,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,UAAU,CAAC;IACtD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,0BAA0B,CAAC;IAChF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,gBAAgB,GAAG,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iFAAiF,CAAC,CAAC;IACrG,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,yBAAyB,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAClE,MAAM,OAAO,GAAG,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IAEhD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,oBAAoB,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;QACnE,IAAI,eAAmD,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACxC,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,yBAAyB,CAAC,CAAC;YACnF,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,OAAO,CAAC,KAAK,EAAE,0BAA0B,EAAE,EAAE,CAAC;YACpD,MAAM,0BAA0B,CAAC,SAAS,EAAE,eAAe,EAAE,yBAAyB,CAAC,CAAC;YAExF,MAAM,KAAK,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YACvC,MAAM,KAAK,GAAqB;gBAC9B,MAAM,EAAE,YAAY;gBACpB,UAAU,EAAE,cAAc;gBAC1B,GAAG;gBACH,KAAK;gBACL,SAAS,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;gBACxC,WAAW;aACZ,CAAC;YACF,MAAM,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YACzC,MAAM,0BAA0B,CAAC,SAAS,EAAE,eAAe,EAAE,yBAAyB,CAAC,CAAC;YACxF,OAAO,WAAW,CAAC;gBACjB,UAAU,EAAE,cAAc;gBAC1B,SAAS;gBACT,UAAU;gBACV,KAAK;gBACL,QAAQ,EAAE,eAAe;gBACzB,OAAO;gBACP,WAAW;aACZ,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBAClC,MAAM,qBAAqB,CAAC,SAAS,EAAE,eAAe,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YACjF,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,MAAM,KAAK,CAAC;QAC7C,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;QAClF,IAAI,QAAQ,KAAK,SAAS;YAAE,SAAS;QACrC,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC9B,IAAI,SAAS,GAAG,IAAI,CAAC;YACrB,IAAI,CAAC;gBACH,SAAS,GAAG,MAAM,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAClF,CAAC;YAAC,MAAM,CAAC;gBACP,gFAAgF;gBAChF,SAAS,GAAG,IAAI,CAAC;YACnB,CAAC;YACD,IAAI,SAAS;gBAAE,OAAO,SAAS,CAAC;QAClC,CAAC;aAAM,IAAI,GAAG,EAAE,GAAG,QAAQ,CAAC,OAAO,GAAG,gBAAgB,EAAE,CAAC;YACvD,oEAAoE;YACpE,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,OAAO,CAAC,KAAK,EAAE,sBAAsB,EAAE,EAAE,CAAC;QAChD,IAAI,CAAC,CAAC,MAAM,oBAAoB,CAAC,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAAE,SAAS;QAC1E,MAAM,UAAU,GAAG,IAAI,CACrB,UAAU,EACV,IAAI,OAAO,IAAI,GAAG,EAAE,IAAI,GAAG,IAAI,SAAS,CAAC,WAAW,EAAE,CAAC,QAAQ,CAChE,CAAC;QACF,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;QACtC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,SAAS;YACnE,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,wEAAwE;YACxE,0EAA0E;YAC1E,MAAM,MAAM,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC3D,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,EAAE,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,wBAAwB,CAAC,UAAkB;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5E,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;YACvC,OAAO,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC1E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;YAC5E,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,2EAA2E;QAC3E,sEAAsE;QACtE,iEAAiE;QACjE,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,SAAS,CAAC;YAAE,OAAO,OAAO,CAAC;QAC1E,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB;IACxB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAC,OAAO,CAAC;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gFAAgF,CAAC,CAAC;IACpG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAQpB;IACC,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO;QACL,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,IAAI,EAAE,KAAK,CAAC,SAAS;QACrB,QAAQ,EAAE,KAAK,CAAC,KAAK,CAAC,GAAG;QACzB,KAAK,CAAC,OAAO;YACX,IAAI,QAAQ;gBAAE,OAAO;YACrB,MAAM,0BAA0B,CAAC,KAAK,CAAC,SAAS,EAAE,KAAK,CAAC,QAAQ,EAAE,yBAAyB,CAAC,CAAC;YAC7F,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;YAC7F,IAAI,OAAO,KAAK,SAAS;mBACpB,OAAO,CAAC,GAAG,KAAK,KAAK,CAAC,KAAK,CAAC,GAAG;mBAC/B,OAAO,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBACzC,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,SAAS,qCAAqC,CAAC,CAAC;YACnG,CAAC;YACD,MAAM,YAAY,GAAG,IAAI,CACvB,KAAK,CAAC,UAAU,EAChB,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,WAAW,CAClF,CAAC;YACF,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YAC5C,MAAM,KAAK,GAAG,MAAM,sBAAsB,CAAC,YAAY,EAAE,kCAAkC,CAAC,CAAC;YAC7F,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzC,MAAM,MAAM,CAAC,YAAY,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACnE,MAAM,IAAI,KAAK,CAAC,2BAA2B,KAAK,CAAC,SAAS,0BAA0B,CAAC,CAAC;YACxF,CAAC;YACD,QAAQ,GAAG,IAAI,CAAC;YAChB,MAAM,EAAE,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,IAAY;IAChD,MAAM,WAAW,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,IAAI,WAAW,CAAC,cAAc,EAAE,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,gCAAgC,IAAI,4BAA4B,CAAC,CAAC;IACpF,CAAC;IACD,WAAW,CAAC,WAAW,EAAE,IAAI,EAAE,8BAA8B,CAAC,CAAC;IAE/D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC;IACtD,KAAK,MAAM,IAAI,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC;QAC7C,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;gBAAE,MAAM,KAAK,CAAC;QAC7C,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YACrD,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,4BAA4B,CAAC,CAAC;QACtF,CAAC;QACD,WAAW,CAAC,MAAM,EAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;QAC5D,MAAM,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,gCAAgC,CAAC,CAAC;QAC1F,CAAC;QACD,6BAA6B,CAAC,OAAO,EAAE,IAAI,EAAE,gCAAgC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,KAAK,UAAU,oBAAoB,CACjC,SAAiB,EACjB,SAAiB,EACjB,UAAkB;IAElB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,sBAAsB,CAAC,SAAS,EAAE,kCAAkC,CAAC,CAAC;IACxF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3D,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE;QAC3D,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,IAAY,EAAE,KAAuB;IACnE,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ;UAC9B,WAAW,CAAC,OAAO;UACnB,WAAW,CAAC,MAAM;UAClB,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7D,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,sBAAsB,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB;IAC7D,MAAM,KAAK,GAAG,WAAW,CAAC,QAAQ,GAAG,CAAC,WAAW,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC;IACnE,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/C,MAAM,KAAK,CAAC;IACd,CAAC;IACD,IAAI,CAAC;QACH,sBAAsB,CAAC,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QAClD,IAAI,MAAiC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAA8B,CAAC;QAClF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,WAAW,GAAG,0BAA0B,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,MAAM,KAAK,YAAY;eAChC,MAAM,CAAC,UAAU,KAAK,UAAU;eAChC,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ;eAC9B,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC;eAChC,MAAM,CAAC,GAAG,GAAG,CAAC;eACd,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ;eAChC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;eACvB,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;eACpC,WAAW,KAAK,SAAS;YAC5B,CAAC,CAAC;gBACA,MAAM,EAAE,YAAY;gBACpB,UAAU;gBACV,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,WAAW;aACZ;YACD,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CAAC,IAAY,EAAE,KAAa;IAC/D,MAAM,OAAO,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;IAClC,6BAA6B,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IACpD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,6BAA6B,CACpC,OAAc,EACd,IAAY,EACZ,KAAa;IAEb,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,IAAI,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,4BAA4B,CAAC,CAAC;IAChE,CAAC;IACD,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAClC,IAAI,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,kCAAkC,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAC7B,OAAc,EACd,IAAY;IAEZ,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;WAChB,OAAO,CAAC,cAAc,EAAE;WACxB,OAAO,CAAC,KAAK,KAAK,CAAC;WACnB,CAAC,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,kDAAkD,CAAC,CAAC;IAC3G,CAAC;IACD,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,+BAA+B,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,WAAW,CAClB,OAAiC,EACjC,IAAY,EACZ,KAAa;IAEb,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QAC7E,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,oCAAoC,CAAC,CAAC;IACxE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,0BAA0B,CACvC,IAAY,EACZ,QAAgC,EAChC,KAAa;IAEb,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAC1D,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,IAAI,IAAI,sCAAsC,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,KAAK,UAAU,oBAAoB,CAAC,IAAY,EAAE,QAAgC;IAChF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,yBAAyB,CAAC,CAAC;QAC9E,OAAO,YAAY,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,qBAAqB,CAAC,IAAY,EAAE,QAAgC;IACjF,IAAI,MAAM,oBAAoB,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC/C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,OAAyE;IAC3F,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;AAChD,CAAC;AAED,SAAS,YAAY,CACnB,OAAyE,EACzE,QAAgC;IAEhC,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,KAAK,QAAQ,CAAC,GAAG,CAAC;AACtE,CAAC;AAED,SAAS,SAAS,CAAC,KAAa;IAC9B,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5D,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,OAAO,CAAC,KAAc,EAAE,IAAY;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA4B,CAAC,IAAI,KAAK,IAAI,CAAC;AACpG,CAAC"}

package/dist/background.d.ts

@@ -1,6 +1,11 @@
 import { listRecordedRuns, listTraceSources } from "@mono-agent/observability";
 import type { TraceSourceListItem } from "@mono-agent/observability";
 import type { LaunchctlRunner, LaunchdPaths } from "./launchd.js";
+import type { ManagedBackgroundRuntime, ManagedBackgroundRuntimeInput, ManagedRuntimeAdditionalPackage } from "./background-runtime.js";
+import type { BackgroundSnapshot } from "./background-snapshot.js";
+import type { ProcessIncarnation, SameProcessIncarnation } from "./process-incarnation.js";
+export { acquireBackgroundWorkerLease, backgroundWorkerLeasePath, } from "./background-worker-lease.js";
+export type { BackgroundWorkerLease, BackgroundWorkerLeaseOptions, } from "./background-worker-lease.js";
 /**
  * Background-service orchestration for the mono-agent CLI. The interactive
  * control commands never talk to the worker directly: they derive a stable
@@ -22,7 +27,16 @@ export interface InstanceTarget {
     readonly nodePath: string;
     readonly cliPath: string;
     readonly envFile?: string;
-    readonly pathEnv: string;
+    /**
+     * Transient effective config environment reconstructed by the controller.
+     * It may contain secrets: never serialize, log, or materialize it in launchd.
+     */
+    readonly configurationEnvironment: Readonly<Record<string, string | undefined>>;
+    readonly environment: Readonly<Record<string, string>>;
+    /** Exact wizard/approval snapshot this launch is allowed to claim ready. */
+    readonly expectedSnapshot?: BackgroundSnapshot;
+    /** Guided/configuration handoffs additionally require a usable TUI endpoint. */
+    readonly requireTui?: boolean;
 }
 export interface ResolveInstanceTargetInput {
     readonly args: BackgroundCliArgs;
@@ -30,13 +44,24 @@ export interface ResolveInstanceTargetInput {
     readonly cwd: string;
     /** Absolute path to the running cli.js, baked into the plist. */
     readonly cliPath: string;
+    readonly requireTui?: boolean;
 }
+/** Exact non-secret environment materialised into a managed LaunchAgent. */
+export declare function managedBackgroundEnvironment(env: Readonly<Record<string, string | undefined>>): Readonly<Record<string, string>>;
 /**
  * Resolve everything the control commands need from CLI args. The registry dir
  * and config path are resolved exactly as the worker will resolve them, so the
  * detached launcher can find the worker's manifest without any IPC.
  */
 export declare function resolveInstanceTarget(input: ResolveInstanceTargetInput): Promise<InstanceTarget>;
+/**
+ * Collapse symlinked parent aliases without following the config's final path
+ * component. The final component is separately required to be a regular,
+ * non-symlink file before start; keeping it unresolved preserves that check.
+ * Missing parents remain addressable so stop/status/logs can still operate on
+ * a previously installed label after an agent folder is damaged or removed.
+ */
+export declare function canonicalBackgroundConfigPath(cwd: string, configuredPath?: string): Promise<string>;
 export interface BackgroundDeps {
     readonly runner: LaunchctlRunner;
     readonly getuid: () => number;
@@ -53,6 +78,15 @@ export interface BackgroundDeps {
     readonly rename: (oldPath: string, newPath: string) => Promise<void>;
     /** True when a pid is still alive (or alive but owned by another user). */
     readonly isAlive: (pid: number) => boolean;
+    /** Install/verify an immutable CLI outside npm/npx's disposable cache. */
+    readonly ensureManagedRuntime: (input: ManagedBackgroundRuntimeInput) => Promise<ManagedBackgroundRuntime>;
+    /** Resolve config-selected plugin-tier packages before the disposable source can disappear. */
+    readonly resolveManagedRuntimePackages?: (target: InstanceTarget) => Promise<readonly ManagedRuntimeAdditionalPackage[]>;
+    /** Fail closed when another lifecycle command owns this config label. */
+    readonly acquireLifecycleLock: (target: InstanceTarget) => Promise<(() => Promise<void>) | undefined>;
+    /** Prove a metadata-advertised TUI endpoint is actually reachable. */
+    readonly probeTui: (source: TraceSourceListItem) => Promise<boolean>;
+    readonly captureSnapshot?: (target: InstanceTarget) => Promise<BackgroundSnapshot>;
     readonly stdout: (text: string) => void;
     readonly stderr: (text: string) => void;
     /** Run `tail` with inherited stdio; resolves with its exit code. */
@@ -66,13 +100,38 @@ export interface PollOptions {
 export interface ReadyPollOptions extends PollOptions {
     /** Only accept a worker that started at or after this time (restart safety). */
     readonly sinceMs: number;
+    readonly requireTui?: boolean;
 }
 export declare const LAUNCHD_LOG_MAX_BYTES: number;
 export declare const LAUNCHD_LOG_ROTATION_COUNT = 3;
+export type BackgroundLaunchAction = "started" | "restarted";
+export type BackgroundLaunchResult = {
+    readonly ok: true;
+    readonly action: BackgroundLaunchAction;
+    /** The fresh, authoritative worker trace that proved startup complete. */
+    readonly source: TraceSourceListItem;
+} | {
+    readonly ok: false;
+    readonly action: "start" | "restart";
+    readonly reason: "runtime" | "snapshot" | "preparation" | "ownership" | "launchctl" | "readiness" | "timeout";
+};
 export declare function startBackground(target: InstanceTarget, deps: BackgroundDeps, poll?: PollOptions): Promise<number>;
 /** Restart is behaviourally identical: ensure a single fresh running instance. */
 export declare function restartBackground(target: InstanceTarget, deps: BackgroundDeps, poll?: PollOptions): Promise<number>;
-export declare function stopBackground(target: InstanceTarget, deps: BackgroundDeps): Promise<number>;
+/**
+ * Stop, perform the caller's stopped-worker mutation, and start again while
+ * retaining one lifecycle lock. This closes the force-restart gap in which a
+ * concurrent start could previously enter while the session store was purged.
+ */
+export declare function forceRestartBackground(target: InstanceTarget, deps: BackgroundDeps, whileStopped: () => Promise<void>, poll?: PollOptions): Promise<number>;
+/**
+ * Ensure the canonical per-config LaunchAgent is running and return the fresh
+ * trace source that proved it reached `startup-complete`. This is the shared
+ * lifecycle boundary for CLI start/restart and remote configuration handoffs;
+ * callers must not open a console when the result is not ok.
+ */
+export declare function ensureBackgroundReady(target: InstanceTarget, deps: BackgroundDeps, poll?: PollOptions): Promise<BackgroundLaunchResult>;
+export declare function stopBackground(target: InstanceTarget, deps: BackgroundDeps, poll?: PollOptions): Promise<number>;
 export declare function statusBackground(target: InstanceTarget, deps: BackgroundDeps): Promise<number>;
 export interface LogOptions {
     readonly follow: boolean;
@@ -81,6 +140,19 @@ export interface LogOptions {
 export declare function tailLogs(target: InstanceTarget, deps: BackgroundDeps, options: LogOptions): Promise<number>;
 export declare function pollInstanceReady(target: InstanceTarget, deps: BackgroundDeps, options: ReadyPollOptions): Promise<TraceSourceListItem | undefined>;
 export declare function printInstanceInfo(source: TraceSourceListItem, target: InstanceTarget, deps: BackgroundDeps, verb: string): void;
+export interface FilesystemLifecycleLockOptions {
+    readonly pid?: number;
+    readonly now?: () => number;
+    /** Legacy owner-record compatibility only; new records use incarnation identity. */
+    readonly isProcessAlive?: (pid: number) => boolean;
+    readonly processIncarnation?: ProcessIncarnation;
+    readonly isSameProcessIncarnation?: SameProcessIncarnation;
+    readonly ownerlessGraceMs?: number;
+    readonly randomToken?: () => string;
+    /** Deterministic seam immediately after the final identity check. */
+    readonly beforeStaleLockRename?: () => Promise<void>;
+}
+export declare function acquireFilesystemLifecycleLock(target: InstanceTarget, options?: FilesystemLifecycleLockOptions): Promise<(() => Promise<void>) | undefined>;
 export declare function describeChannel(value: unknown): {
     kind: string;
     text: string;

package/dist/background.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../src/background.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../src/background.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAoBrE,OAAO,KAAK,EAAmB,eAAe,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAMnF,OAAO,KAAK,EACV,wBAAwB,EACxB,6BAA6B,EAC7B,+BAA+B,EAChC,MAAM,yBAAyB,CAAC;AAOjC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAOnE,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAI3F,OAAO,EACL,4BAA4B,EAC5B,yBAAyB,GAC1B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EACV,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AAEtC;;;;;;GAMG;AAEH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAChF,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,kBAAkB,CAAC;IAC/C,gFAAgF;IAChF,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACjD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,4EAA4E;AAC5E,wBAAgB,4BAA4B,CAC1C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAQlC;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,cAAc,CAAC,CA4BtG;AAED;;;;;;GAMG;AACH,wBAAsB,6BAA6B,CACjD,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IACnD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,gBAAgB,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,QAAQ,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,QAAQ,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,QAAQ,CAAC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IAC3C,0EAA0E;IAC1E,QAAQ,CAAC,oBAAoB,EAAE,CAAC,KAAK,EAAE,6BAA6B,KAAK,OAAO,CAAC,wBAAwB,CAAC,CAAC;IAC3G,+FAA+F;IAC/F,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CACvC,MAAM,EAAE,cAAc,KACnB,OAAO,CAAC,SAAS,+BAA+B,EAAE,CAAC,CAAC;IACzD,yEAAyE;IACzE,QAAQ,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IACtG,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACrE,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACnF,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAClE;AAED,wBAAgB,qBAAqB,IAAI,cAAc,CAuCtD;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAiB,SAAQ,WAAW;IACnD,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAGD,eAAO,MAAM,qBAAqB,QAAkB,CAAC;AACrD,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAC9B;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;CAC/G,CAAC;AAEN,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,WAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED,kFAAkF;AAClF,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,WAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAEjB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,EACjC,IAAI,GAAE,WAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAmBjB;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,WAA0B,GAC/B,OAAO,CAAC,sBAAsB,CAAC,CAgBjC;AAwaD,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,IAAI,GAAE,WAA0B,GAC/B,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAyDD,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CA6BpG;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,wBAAsB,QAAQ,CAAC,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CASjH;AAED,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAqB1C;AAoCD,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,mBAAmB,EAC3B,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GACX,IAAI,CAKN;AAqXD,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IAC5B,oFAAoF;IACpF,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnD,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,sBAAsB,CAAC;IAC3D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACtD;AAED,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,8BAAmC,GAC3C,OAAO,CAAC,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,CAAC,CA4H5C;AAuHD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAmB9E"}