@masons/runtime-broker 0.2.6 → 0.2.8

package/dist/broker/broker-daemon.d.ts

@@ -4,6 +4,7 @@ import type { ClosedEndpointLookup } from "./closed-endpoint-lookup.js";
 import type { ConnectorWS } from "./connector-ws.js";
 import { type ControlEventDispatcher } from "./control-event-dispatcher.js";
 import type { ControlAck } from "./control-event-types.js";
+import { type DiscoveryRecord } from "./discovery-file.js";
 import { type EndpointState } from "./endpoint-state-machine.js";
 import type { BrokerLogger } from "./logger.js";
 import { type NetworkPresence } from "./network-presence.js";
@@ -74,6 +75,10 @@ export interface RunningBroker {
     networkPresenceChangedQueueSize(): number;
     runtimeInboundRoutedQueueSize(): number;
 }
+export declare class BrokerAlreadyRunningError extends Error {
+    readonly discovery: DiscoveryRecord;
+    constructor(discovery: DiscoveryRecord);
+}
 export declare function startBrokerDaemon(opts: BrokerDaemonOptions): Promise<RunningBroker>;
 export declare function readPluginPidHeader(req: IncomingMessage): number | null;
 export type { BufferedMessage };

package/dist/broker/broker-daemon.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broker-daemon.d.ts","sourceRoot":"","sources":["../../src/broker/broker-daemon.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"broker-daemon.d.ts","sourceRoot":"","sources":["../../src/broker/broker-daemon.ts"],"names":[],"mappings":"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"}

package/dist/broker/broker-daemon.js

@@ -4,8 +4,8 @@ import { basename } from "node:path";
 import { ConnectorClientUnavailableError, ConnectorSendAckTimeoutError, } from "../connector-client.js";
 import { createControlEventDispatcher, } from "./control-event-dispatcher.js";
 import { readDeliveryCursorFile, writeDeliveryCursorFile, } from "./delivery-cursor-file.js";
-import { deleteDiscoveryFile, mintBearerToken, writeDiscoveryFile, } from "./discovery-file.js";
-import { EndpointRegistry } from "./endpoint-registry.js";
+import { deleteDiscoveryFileIfOwned, mintBearerToken, readDiscoveryFile, writeDiscoveryFile, } from "./discovery-file.js";
+import { EndpointRegistry, } from "./endpoint-registry.js";
 import { DEFAULT_GRACE_MS, transition, } from "./endpoint-state-machine.js";
 import { createGraceTimerManager } from "./grace-timer.js";
 import { BrokerHttpError, pushToPlugin, startIPCServer, } from "./ipc-server.js";
@@ -59,6 +59,41 @@ function derivePublicDisplayLabel(body) {
         ? parts.join(" · ")
         : `${body.kind}-${String(body.plugin_pid).slice(-4)}`;
 }
+export class BrokerAlreadyRunningError extends Error {
+    discovery;
+    constructor(discovery) {
+        super(`another healthy runtime broker already owns discovery at ${discovery.ipcUrl}`);
+        this.name = "BrokerAlreadyRunningError";
+        this.discovery = discovery;
+    }
+}
+async function findHealthyDiscoveryOwner(discoveryFile) {
+    const existing = readDiscoveryFile(discoveryFile);
+    if (!existing)
+        return null;
+    if (existing.pid === process.pid)
+        return null;
+    if (!(await probeDiscoveryHealth(existing)))
+        return null;
+    return existing;
+}
+async function probeDiscoveryHealth(record) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 2_000);
+    try {
+        const res = await fetch(`${record.ipcUrl}/health`, {
+            headers: { Authorization: `Bearer ${record.bearerToken}` },
+            signal: ctrl.signal,
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
 export async function startBrokerDaemon(opts) {
     const { paths, asNodeId: _asNodeIdReservedForA3, connector, apiPort, logger, closedEndpointLookup, livenessProbe = defaultIsPluginAlive, spawnDriverRegistry, spawnFn = spawnChild, servicesEventClientFactory, } = opts;
     const graceMs = opts.graceMs ?? DEFAULT_GRACE_MS;
@@ -69,6 +104,14 @@ export async function startBrokerDaemon(opts) {
         (async () => {
         });
     void _asNodeIdReservedForA3;
+    const existingOwner = await findHealthyDiscoveryOwner(paths.discoveryFile);
+    if (existingOwner) {
+        logger.info("broker_already_running", {
+            pid: existingOwner.pid,
+            ipcUrl: existingOwner.ipcUrl,
+        });
+        throw new BrokerAlreadyRunningError(existingOwner);
+    }
     const persistedDeliveryCursor = readDeliveryCursorFile(paths.deliveryCursorFile) ?? 0;
     connector.setDeliveryCursor(persistedDeliveryCursor);
     logger.info("delivery_cursor_loaded", {
@@ -170,6 +213,9 @@ export async function startBrokerDaemon(opts) {
     const endpointCorrelationKey = (endpointId, correlationId) => `${endpointId}\u0000${correlationId}`;
     const isBackgroundExchangeTarget = (entry) => Boolean(entry.runtime_capabilities?.includes("background_exchange_v1") &&
         isBackgroundExchangeMode(entry.background_exchange_mode));
+    const requiresForegroundChannel = (entry) => entry.execution_surface !== "headless";
+    const canAcceptRuntimeMailboxDispatch = (entry) => !requiresForegroundChannel(entry) ||
+        Boolean(entry.runtime_capabilities?.includes("foreground_channel_v1"));
     const rememberRuntimeAssignmentCorrelation = (endpointId, correlationId, assignmentKey) => {
         if (typeof correlationId !== "string" || correlationId.length === 0) {
             return;
@@ -772,6 +818,13 @@ export async function startBrokerDaemon(opts) {
                 detail: `target endpoint not found: ${targetEndpointId}`,
             };
         }
+        if (!canAcceptRuntimeMailboxDispatch(target)) {
+            undispatchedInbox.tryAdd(taken);
+            return {
+                ok: false,
+                detail: `target endpoint is not foreground-channel capable: ${targetEndpointId}`,
+            };
+        }
         let targetRef = event.target_ref;
         if (!targetRef) {
             if (target.background_exchange_mode === "resident_endpoint") {
@@ -1559,6 +1612,24 @@ export async function startBrokerDaemon(opts) {
             }
         },
     });
+    const ownerAfterBind = await findHealthyDiscoveryOwner(paths.discoveryFile);
+    if (ownerAfterBind) {
+        logger.info("broker_already_running_after_ipc_bind", {
+            pid: ownerAfterBind.pid,
+            ipcUrl: ownerAfterBind.ipcUrl,
+        });
+        try {
+            await ipc.close();
+        }
+        catch {
+        }
+        try {
+            connector.disconnect();
+        }
+        catch {
+        }
+        throw new BrokerAlreadyRunningError(ownerAfterBind);
+    }
     const inboundProcessing = new Set();
     const blockedInboundSeqs = new Set();
     const asyncAcceptedInboundSeqs = new Set();
@@ -1847,13 +1918,14 @@ export async function startBrokerDaemon(opts) {
         deferredDeliveryPendingUpTo = undefined;
         connector.ackDelivery(payload.upTo);
     });
-    writeDiscoveryFile(paths.discoveryFile, {
+    const ownDiscovery = {
         version: 1,
         pid: process.pid,
         startedAt: new Date().toISOString(),
         ipcUrl: ipc.ipcUrl,
         bearerToken,
-    });
+    };
+    writeDiscoveryFile(paths.discoveryFile, ownDiscovery);
     logger.info("discovery_written", { path: paths.discoveryFile });
     let servicesEventClient;
     if (servicesEventClientFactory) {
@@ -1927,7 +1999,13 @@ export async function startBrokerDaemon(opts) {
             catch {
             }
         }));
-        deleteDiscoveryFile(paths.discoveryFile);
+        const discoveryDeleted = deleteDiscoveryFileIfOwned(paths.discoveryFile, ownDiscovery);
+        if (!discoveryDeleted) {
+            logger.warn("discovery_delete_skipped_not_owner", {
+                path: paths.discoveryFile,
+                pid: process.pid,
+            });
+        }
         try {
             await ipc.close();
         }

package/dist/broker/discovery-file.d.ts

@@ -5,8 +5,11 @@ export interface DiscoveryRecord {
     ipcUrl: string;
     bearerToken: string;
 }
+export type DiscoveryOwner = Pick<DiscoveryRecord, "pid" | "ipcUrl" | "bearerToken">;
 export declare function mintBearerToken(): string;
 export declare function writeDiscoveryFile(path: string, record: DiscoveryRecord): void;
 export declare function readDiscoveryFile(path: string): DiscoveryRecord | null;
 export declare function deleteDiscoveryFile(path: string): void;
+export declare function deleteDiscoveryFileIfOwned(path: string, owner: DiscoveryOwner): boolean;
+export declare function isDiscoveryOwner(record: DiscoveryRecord, owner: DiscoveryOwner): boolean;
 //# sourceMappingURL=discovery-file.d.ts.map

package/dist/broker/discovery-file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"discovery-file.d.ts","sourceRoot":"","sources":["../../src/broker/discovery-file.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAGD,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,IAAI,CA4BN;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAetE;AAGD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOtD"}
+{"version":3,"file":"discovery-file.d.ts","sourceRoot":"","sources":["../../src/broker/discovery-file.ts"],"names":[],"mappings":"AA6BA,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,CAAC,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,cAAc,GAAG,IAAI,CAC/B,eAAe,EACf,KAAK,GAAG,QAAQ,GAAG,aAAa,CACjC,CAAC;AAGF,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAMD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,eAAe,GACtB,IAAI,CA4BN;AAMD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAetE;AAGD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOtD;AAOD,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,cAAc,GACpB,OAAO,CAMT;AAED,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,cAAc,GACpB,OAAO,CAMT"}

package/dist/broker/discovery-file.js

@@ -59,6 +59,20 @@ export function deleteDiscoveryFile(path) {
         throw err;
     }
 }
+export function deleteDiscoveryFileIfOwned(path, owner) {
+    const current = readDiscoveryFile(path);
+    if (!current)
+        return false;
+    if (!isDiscoveryOwner(current, owner))
+        return false;
+    deleteDiscoveryFile(path);
+    return true;
+}
+export function isDiscoveryOwner(record, owner) {
+    return (record.pid === owner.pid &&
+        record.ipcUrl === owner.ipcUrl &&
+        record.bearerToken === owner.bearerToken);
+}
 function isDiscoveryRecord(value) {
     if (typeof value !== "object" || value === null)
         return false;

package/dist/broker/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/broker/entry.ts"],"names":[],"mappings":"AAmFA,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAMtE,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA8F9B;AA2DD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,OAAO,UAAU,CAAC,KAAwB,GACpD,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAaD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,mBAAmB,CAqIrB;AAYD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgG1C"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/broker/entry.ts"],"names":[],"mappings":"AAsFA,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,aAAa,CAAC;AAEpE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAMtE,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,gBAAgB;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAUD,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA8F9B;AA2DD,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,OAAO,UAAU,CAAC,KAAwB,GACpD,OAAO,CAAC,gBAAgB,CAAC,CA4B3B;AAaD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,mBAAmB,CAqIrB;AAYD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgG1C"}

package/dist/broker/entry.js

@@ -3,7 +3,7 @@ import { pathToFileURL } from "node:url";
 import { readConfig } from "../config-fs.js";
 import { DEFAULT_API_HOST } from "../platform-client.js";
 import { claimRuntimeInboundRoute, emitRuntimeInboundRouted, emitRuntimeNetworkPresenceChanged, emitRuntimeProcessingState, emitRuntimeUndispatchedChanged, heartbeatRuntimeEndpoint, registerRuntimeEndpoint, transitionRuntimeEndpointState, unregisterRuntimeEndpoint, updateRuntimeEndpointDisplayMetadata, } from "../runtime-endpoint-client.js";
-import { startBrokerDaemon } from "./broker-daemon.js";
+import { BrokerAlreadyRunningError, startBrokerDaemon, } from "./broker-daemon.js";
 import { ClaudeCodeSpawnDriver } from "./claude-code-spawn-driver.js";
 import { CodexSpawnDriverStub } from "./codex-spawn-driver-stub.js";
 import { ConnectorWS } from "./connector-ws.js";
@@ -273,6 +273,9 @@ export async function main() {
 const argvUrl = process.argv[1] ? pathToFileURL(process.argv[1]).href : "";
 if (import.meta.url === argvUrl) {
     main().catch((err) => {
+        if (err instanceof BrokerAlreadyRunningError) {
+            process.exit(0);
+        }
         console.error("broker_entry_fatal", err);
         process.exit(1);
     });

package/dist/broker-client/lazy-spawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lazy-spawn.d.ts","sourceRoot":"","sources":["../../src/broker-client/lazy-spawn.ts"],"names":[],"mappings":"AA0CA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAE/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IAEvD,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAsB,cAAc,CAClC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CAgC1B"}
+{"version":3,"file":"lazy-spawn.d.ts","sourceRoot":"","sources":["../../src/broker-client/lazy-spawn.ts"],"names":[],"mappings":"AA6BA,OAAO,EACL,KAAK,eAAe,EAErB,MAAM,6BAA6B,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAE/B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD,MAAM,WAAW,eAAgB,SAAQ,gBAAgB;IAEvD,aAAa,EAAE,MAAM,CAAC;IAEtB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,eAAe,CAAC;IAExB,OAAO,EAAE,OAAO,CAAC;CAClB;AAsBD,wBAAsB,cAAc,CAClC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,eAAe,CAAC,CAsD1B"}

package/dist/broker-client/lazy-spawn.js

@@ -1,9 +1,12 @@
 import { spawn } from "node:child_process";
+import { chmodSync, closeSync, mkdirSync, openSync, readFileSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
 import { fileURLToPath } from "node:url";
 import { readDiscoveryFile, } from "../broker/discovery-file.js";
 const DEFAULT_POLL_INTERVAL_MS = 100;
 const DEFAULT_DISCOVER_TIMEOUT_MS = 5_000;
 const DEFAULT_HEALTH_TIMEOUT_MS = 2_000;
+const SPAWN_LOCK_VERSION = 1;
 export async function discoverBroker(opts) {
     const deadline = Date.now() + (opts.timeoutMs ?? DEFAULT_DISCOVER_TIMEOUT_MS);
     const poll = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
@@ -14,17 +17,138 @@ export async function discoverBroker(opts) {
             return { record: existing, spawned: false };
         }
     }
-    spawnDaemon(opts);
-    while (Date.now() < deadline) {
-        const rec = readDiscoveryFile(opts.discoveryFile);
-        if (rec && (await probeHealth(rec.ipcUrl, rec.bearerToken))) {
-            return { record: rec, spawned: true };
+    const acquired = await acquireSpawnLock({
+        discoveryFile: opts.discoveryFile,
+        deadline,
+        pollIntervalMs: poll,
+    });
+    if (acquired.kind === "existing") {
+        return { record: acquired.record, spawned: false };
+    }
+    const { lock } = acquired;
+    try {
+        const recovered = readDiscoveryFile(opts.discoveryFile);
+        if (recovered &&
+            (await probeHealth(recovered.ipcUrl, recovered.bearerToken))) {
+            return { record: recovered, spawned: false };
+        }
+        spawnDaemon(opts);
+        while (Date.now() < deadline) {
+            const rec = readDiscoveryFile(opts.discoveryFile);
+            if (rec && (await probeHealth(rec.ipcUrl, rec.bearerToken))) {
+                return { record: rec, spawned: true };
+            }
+            await sleep(poll);
         }
-        await sleep(poll);
+    }
+    finally {
+        lock.release();
     }
     throw new Error(`broker did not become healthy within ${opts.timeoutMs ?? DEFAULT_DISCOVER_TIMEOUT_MS}ms; ` +
         `check ${opts.discoveryFile} and the daemon log`);
 }
+async function acquireSpawnLock(opts) {
+    const lockPath = `${opts.discoveryFile}.lock`;
+    mkdirSync(dirname(lockPath), { recursive: true, mode: 0o700 });
+    while (Date.now() < opts.deadline) {
+        try {
+            const fd = openSync(lockPath, "wx", 0o600);
+            const record = {
+                version: SPAWN_LOCK_VERSION,
+                pid: process.pid,
+                startedAt: new Date().toISOString(),
+            };
+            writeFileSync(fd, JSON.stringify(record, null, 2), {
+                encoding: "utf8",
+            });
+            try {
+                chmodSync(lockPath, 0o600);
+            }
+            catch {
+            }
+            return {
+                kind: "lock",
+                lock: {
+                    path: lockPath,
+                    fd,
+                    release() {
+                        releaseSpawnLock(lockPath, fd);
+                    },
+                },
+            };
+        }
+        catch (err) {
+            if (!isNodeErr(err, "EEXIST"))
+                throw err;
+            const existing = readDiscoveryFile(opts.discoveryFile);
+            if (existing &&
+                (await probeHealth(existing.ipcUrl, existing.bearerToken))) {
+                return { kind: "existing", record: existing };
+            }
+            if (isStaleSpawnLock(lockPath)) {
+                try {
+                    unlinkSync(lockPath);
+                    continue;
+                }
+                catch (unlinkErr) {
+                    if (!isNodeErr(unlinkErr, "ENOENT")) {
+                        throw unlinkErr;
+                    }
+                }
+            }
+            await sleep(opts.pollIntervalMs);
+        }
+    }
+    throw new Error(`broker spawn lock was not acquired before discover timeout; ` +
+        `check ${lockPath}`);
+}
+function releaseSpawnLock(path, fd) {
+    try {
+        closeSync(fd);
+    }
+    catch {
+    }
+    try {
+        unlinkSync(path);
+    }
+    catch {
+    }
+}
+function isStaleSpawnLock(path) {
+    let parsed;
+    try {
+        const raw = readFileSync(path, "utf8");
+        const value = JSON.parse(raw);
+        if (!isSpawnLockRecord(value))
+            return false;
+        parsed = value;
+    }
+    catch (err) {
+        if (isNodeErr(err, "ENOENT"))
+            return false;
+        return false;
+    }
+    return !isProcessAlive(parsed.pid);
+}
+function isSpawnLockRecord(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (v.version === SPAWN_LOCK_VERSION &&
+        typeof v.pid === "number" &&
+        Number.isInteger(v.pid) &&
+        v.pid > 0 &&
+        typeof v.startedAt === "string");
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return isNodeErr(err, "EPERM");
+    }
+}
 function spawnDaemon(opts) {
     const entry = opts.brokerEntry ?? resolveDefaultBrokerEntry();
     const child = spawn(opts.nodeBinary ?? process.execPath, [entry], {
@@ -59,3 +183,9 @@ async function probeHealth(ipcUrl, bearerToken) {
 function sleep(ms) {
     return new Promise((resolve) => setTimeout(resolve, ms));
 }
+function isNodeErr(err, code) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === code);
+}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "0.2.6";
+export declare const PLUGIN_VERSION = "0.2.8";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.2.6";
+export const PLUGIN_VERSION = "0.2.8";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/runtime-broker",
-  "version": "0.2.6",
+  "version": "0.2.8",
   "description": "MASONS Runtime Broker — local daemon and BrokerClient SDK for multi-session agent runtime coordination.",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",

package/dist/broker/background-assignment-ledger.d.ts

@@ -1,27 +0,0 @@
-import type { UndispatchedMessage } from "./undispatched-inbox.js";
-export type DurableBackgroundAssignmentState = "assigned" | "committing" | "committed";
-export type DurableBackgroundAssignmentKind = "mailbox_dispatch" | "broker_route";
-export interface DurableBackgroundAssignment {
-    kind: DurableBackgroundAssignmentKind;
-    state: DurableBackgroundAssignmentState;
-    assignmentId: string;
-    sourceMessageId: string;
-    endpointId: string;
-    message: UndispatchedMessage;
-    assignedAt: number;
-    acceptedAt?: number;
-    committedAt?: number;
-    deliverySeq?: number;
-    routeKind?: "active_endpoint" | "reconnecting_endpoint";
-}
-export interface BackgroundAssignmentLedger {
-    get(sourceMessageId: string): DurableBackgroundAssignment | undefined;
-    upsert(record: DurableBackgroundAssignment): boolean;
-    delete(sourceMessageId: string): boolean;
-    list(): DurableBackgroundAssignment[];
-}
-export interface BackgroundAssignmentLedgerOptions {
-    persistFile?: string;
-}
-export declare function createBackgroundAssignmentLedger(opts?: BackgroundAssignmentLedgerOptions): BackgroundAssignmentLedger;
-//# sourceMappingURL=background-assignment-ledger.d.ts.map

package/dist/broker/background-assignment-ledger.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"background-assignment-ledger.d.ts","sourceRoot":"","sources":["../../src/broker/background-assignment-ledger.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE,MAAM,MAAM,gCAAgC,GACxC,UAAU,GACV,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,MAAM,+BAA+B,GACvC,kBAAkB,GAClB,cAAc,CAAC;AAEnB,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,+BAA+B,CAAC;IACtC,KAAK,EAAE,gCAAgC,CAAC;IACxC,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;CACzD;AAED,MAAM,WAAW,0BAA0B;IACzC,GAAG,CAAC,eAAe,EAAE,MAAM,GAAG,2BAA2B,GAAG,SAAS,CAAC;IACtE,MAAM,CAAC,MAAM,EAAE,2BAA2B,GAAG,OAAO,CAAC;IACrD,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;IACzC,IAAI,IAAI,2BAA2B,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,iCAAiC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,GAAE,iCAAsC,GAC3C,0BAA0B,CAkF5B"}

package/dist/broker/background-assignment-ledger.js

@@ -1,125 +0,0 @@
-import { closeSync, fdatasyncSync, mkdirSync, openSync, readFileSync, renameSync, writeSync, } from "node:fs";
-import { dirname } from "node:path";
-export function createBackgroundAssignmentLedger(opts = {}) {
-    const persistFile = opts.persistFile;
-    const bySourceMessageId = new Map();
-    const snapshot = () => [
-        ...bySourceMessageId.values(),
-    ];
-    const persist = () => {
-        if (!persistFile)
-            return;
-        mkdirSync(dirname(persistFile), { recursive: true, mode: 0o700 });
-        const tmp = `${persistFile}.tmp`;
-        const fd = openSync(tmp, "w", 0o600);
-        try {
-            writeSync(fd, `${JSON.stringify({ version: 1, assignments: snapshot() })}\n`);
-            fdatasyncSync(fd);
-        }
-        finally {
-            closeSync(fd);
-        }
-        renameSync(tmp, persistFile);
-    };
-    if (persistFile) {
-        try {
-            const raw = readFileSync(persistFile, "utf8").trim();
-            if (raw.length > 0) {
-                const parsed = JSON.parse(raw);
-                if (parsed.version !== 1 || !Array.isArray(parsed.assignments)) {
-                    throw new Error("invalid persisted background assignment ledger");
-                }
-                for (const assignment of parsed.assignments) {
-                    if (!isDurableBackgroundAssignment(assignment)) {
-                        throw new Error("invalid persisted background assignment ledger record");
-                    }
-                    bySourceMessageId.set(assignment.sourceMessageId, assignment);
-                }
-            }
-        }
-        catch (err) {
-            if (!isNodeErr(err, "ENOENT"))
-                throw err;
-        }
-    }
-    return {
-        get(sourceMessageId) {
-            return bySourceMessageId.get(sourceMessageId);
-        },
-        upsert(record) {
-            const prior = bySourceMessageId.get(record.sourceMessageId);
-            bySourceMessageId.set(record.sourceMessageId, record);
-            try {
-                persist();
-                return true;
-            }
-            catch {
-                if (prior)
-                    bySourceMessageId.set(record.sourceMessageId, prior);
-                else
-                    bySourceMessageId.delete(record.sourceMessageId);
-                return false;
-            }
-        },
-        delete(sourceMessageId) {
-            const prior = bySourceMessageId.get(sourceMessageId);
-            if (!prior)
-                return true;
-            bySourceMessageId.delete(sourceMessageId);
-            try {
-                persist();
-                return true;
-            }
-            catch {
-                bySourceMessageId.set(sourceMessageId, prior);
-                return false;
-            }
-        },
-        list() {
-            return snapshot();
-        },
-    };
-}
-function isDurableBackgroundAssignment(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const record = value;
-    return ((record.kind === "mailbox_dispatch" || record.kind === "broker_route") &&
-        (record.state === "assigned" ||
-            record.state === "committing" ||
-            record.state === "committed") &&
-        typeof record.assignmentId === "string" &&
-        typeof record.sourceMessageId === "string" &&
-        typeof record.endpointId === "string" &&
-        typeof record.assignedAt === "number" &&
-        isUndispatchedMessageShape(record.message) &&
-        (record.acceptedAt === undefined ||
-            typeof record.acceptedAt === "number") &&
-        (record.committedAt === undefined ||
-            typeof record.committedAt === "number") &&
-        (record.deliverySeq === undefined ||
-            typeof record.deliverySeq === "number") &&
-        (record.routeKind === undefined ||
-            record.routeKind === "active_endpoint" ||
-            record.routeKind === "reconnecting_endpoint"));
-}
-function isUndispatchedMessageShape(value) {
-    if (!value || typeof value !== "object")
-        return false;
-    const record = value;
-    return (typeof record.id === "string" &&
-        typeof record.arrived_at === "string" &&
-        typeof record.sender_address === "string" &&
-        typeof record.content === "string" &&
-        typeof record.content_type === "string" &&
-        !!record.metadata &&
-        typeof record.metadata === "object" &&
-        (record.reason === "unaddressed" ||
-            record.reason === "closed_session_continuation"));
-}
-function isNodeErr(err, code) {
-    return (typeof err === "object" &&
-        err !== null &&
-        "code" in err &&
-        err.code === code);
-}