@masons/runtime-broker 0.1.0

package/dist/broker/claude-code-spawn-driver.d.ts

@@ -0,0 +1,14 @@
+import type { DriverAvailability, SpawnCommand, SpawnContext, SpawnDriver } from "./spawn-driver.js";
+export interface ClaudeCodeSpawnDriverOptions {
+    binary?: string;
+    isOnPath?: (binary: string) => boolean;
+}
+export declare class ClaudeCodeSpawnDriver implements SpawnDriver {
+    readonly runtime_kind = "claude-code";
+    private readonly binary;
+    private readonly isOnPath;
+    constructor(opts?: ClaudeCodeSpawnDriverOptions);
+    buildSpawnCommand(ctx: SpawnContext): SpawnCommand;
+    isAvailable(): Promise<DriverAvailability>;
+}
+//# sourceMappingURL=claude-code-spawn-driver.d.ts.map

package/dist/broker/claude-code-spawn-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code-spawn-driver.d.ts","sourceRoot":"","sources":["../../src/broker/claude-code-spawn-driver.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAG3B,MAAM,WAAW,4BAA4B;IAE3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAMhB,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED,qBAAa,qBAAsB,YAAW,WAAW;IACvD,QAAQ,CAAC,YAAY,iBAAiB;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;gBAE3C,IAAI,GAAE,4BAAiC;IAKnD,iBAAiB,CAAC,GAAG,EAAE,YAAY,GAAG,YAAY;IAS5C,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;CASjD"}

package/dist/broker/claude-code-spawn-driver.js

@@ -0,0 +1,39 @@
+import { execFileSync } from "node:child_process";
+export class ClaudeCodeSpawnDriver {
+    runtime_kind = "claude-code";
+    binary;
+    isOnPath;
+    constructor(opts = {}) {
+        this.binary = opts.binary ?? "claude";
+        this.isOnPath = opts.isOnPath ?? defaultIsOnPath;
+    }
+    buildSpawnCommand(ctx) {
+        return {
+            binary: this.binary,
+            args: ["--bg", ctx.prompt],
+            env: { MASONS_SPAWN_TOKEN: ctx.spawn_token },
+            cwd: ctx.cwd,
+        };
+    }
+    async isAvailable() {
+        if (this.isOnPath(this.binary)) {
+            return { available: true };
+        }
+        return {
+            available: false,
+            reason: `\`${this.binary}\` CLI not found in PATH. Install Claude Code or check $PATH.`,
+        };
+    }
+}
+function defaultIsOnPath(binary) {
+    if (!/^[a-zA-Z0-9._-]+$/.test(binary))
+        return false;
+    const probe = process.platform === "win32" ? "where" : "which";
+    try {
+        execFileSync(probe, [binary], { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/broker/closed-endpoint-lookup.d.ts

@@ -0,0 +1,25 @@
+import type { PlatformClientConfig } from "../platform-client.js";
+import { type OwnedRuntimeEndpointView } from "../runtime-endpoint-client.js";
+export interface ClosedEndpointInfo {
+    exists: true;
+    closed: boolean;
+    view: OwnedRuntimeEndpointView;
+}
+export interface UnknownEndpoint {
+    exists: false;
+}
+export type LookupResult = ClosedEndpointInfo | UnknownEndpoint;
+export interface ClosedEndpointLookup {
+    lookup(endpoint_id: string, asNodeId: string): Promise<LookupResult>;
+    invalidate(endpoint_id: string): void;
+    size(): number;
+}
+export interface ClosedEndpointLookupOptions {
+    cfg: PlatformClientConfig;
+    runtimeKey: string;
+    cacheSize?: number;
+    cacheTtlMs?: number;
+    fetcher?: (cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId: string) => Promise<OwnedRuntimeEndpointView>;
+}
+export declare function createClosedEndpointLookup(opts: ClosedEndpointLookupOptions): ClosedEndpointLookup;
+//# sourceMappingURL=closed-endpoint-lookup.d.ts.map

package/dist/broker/closed-endpoint-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"closed-endpoint-lookup.d.ts","sourceRoot":"","sources":["../../src/broker/closed-endpoint-lookup.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClE,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,kBAAkB;IAEjC,MAAM,EAAE,IAAI,CAAC;IAEb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,wBAAwB,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,eAAe,CAAC;AAEhE,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAIrE,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAEtC,IAAI,IAAI,MAAM,CAAC;CAChB;AAaD,MAAM,WAAW,2BAA2B;IAC1C,GAAG,EAAE,oBAAoB,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB,OAAO,CAAC,EAAE,CACR,GAAG,EAAE,oBAAoB,EACzB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,wBAAwB,CAAC,CAAC;CACxC;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,2BAA2B,GAChC,oBAAoB,CA6DtB"}

package/dist/broker/closed-endpoint-lookup.js

@@ -0,0 +1,59 @@
+import { getOwnedRuntimeEndpoint, } from "../runtime-endpoint-client.js";
+const DEFAULT_CACHE_SIZE = 64;
+const DEFAULT_CACHE_TTL_MS = 5_000;
+export function createClosedEndpointLookup(opts) {
+    const cacheSize = opts.cacheSize ?? DEFAULT_CACHE_SIZE;
+    const ttl = opts.cacheTtlMs ?? DEFAULT_CACHE_TTL_MS;
+    const fetcher = opts.fetcher ?? getOwnedRuntimeEndpoint;
+    const cache = new Map();
+    const evict = () => {
+        if (cache.size <= cacheSize)
+            return;
+        const oldest = cache.keys().next();
+        if (!oldest.done)
+            cache.delete(oldest.value);
+    };
+    return {
+        async lookup(endpoint_id, asNodeId) {
+            const now = Date.now();
+            const hit = cache.get(endpoint_id);
+            if (hit && hit.expires_at > now) {
+                cache.delete(endpoint_id);
+                cache.set(endpoint_id, hit);
+                return hit.result;
+            }
+            let result;
+            try {
+                const view = await fetcher(opts.cfg, opts.runtimeKey, endpoint_id, asNodeId);
+                result = {
+                    exists: true,
+                    closed: typeof view.retired_at === "string" && view.retired_at.length > 0,
+                    view,
+                };
+            }
+            catch (err) {
+                if (isPlatformApi404(err)) {
+                    result = { exists: false };
+                }
+                else {
+                    return { exists: false };
+                }
+            }
+            cache.set(endpoint_id, { result, expires_at: now + ttl });
+            evict();
+            return result;
+        },
+        invalidate(endpoint_id) {
+            cache.delete(endpoint_id);
+        },
+        size() {
+            return cache.size;
+        },
+    };
+}
+function isPlatformApi404(err) {
+    if (typeof err !== "object" || err === null)
+        return false;
+    const status = err.status;
+    return status === 404;
+}

package/dist/broker/codex-spawn-driver-stub.d.ts

@@ -0,0 +1,7 @@
+import type { DriverAvailability, SpawnCommand, SpawnContext, SpawnDriver } from "./spawn-driver.js";
+export declare class CodexSpawnDriverStub implements SpawnDriver {
+    readonly runtime_kind = "codex";
+    buildSpawnCommand(_ctx: SpawnContext): SpawnCommand;
+    isAvailable(): Promise<DriverAvailability>;
+}
+//# sourceMappingURL=codex-spawn-driver-stub.d.ts.map

package/dist/broker/codex-spawn-driver-stub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codex-spawn-driver-stub.d.ts","sourceRoot":"","sources":["../../src/broker/codex-spawn-driver-stub.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,kBAAkB,EAClB,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,mBAAmB,CAAC;AAE3B,qBAAa,oBAAqB,YAAW,WAAW;IACtD,QAAQ,CAAC,YAAY,WAAW;IAEhC,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,YAAY;IAW7C,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAYjD"}

package/dist/broker/codex-spawn-driver-stub.js

@@ -0,0 +1,13 @@
+export class CodexSpawnDriverStub {
+    runtime_kind = "codex";
+    buildSpawnCommand(_ctx) {
+        throw new Error("CodexSpawnDriverStub.buildSpawnCommand called — broker logic bug; " +
+            "isAvailable() should have short-circuited the spawn before this point");
+    }
+    async isAvailable() {
+        return {
+            available: false,
+            reason: "codex driver not registered on this broker — Codex distribution will ship a SpawnDriver in a future release (broker restart required after install)",
+        };
+    }
+}

package/dist/broker/connector-ws.d.ts

@@ -0,0 +1,47 @@
+import { ConnectorError } from "../connector-client.js";
+import type { AddressedMessageEvent, DeliveryPendingEvent, DeliveryStatusEvent, SendAckEvent, StructuredErrorEvent } from "../types.js";
+export type ConnectorWSEvent = {
+    event: "message_received";
+    payload: AddressedMessageEvent;
+} | {
+    event: "send_ack";
+    payload: SendAckEvent;
+} | {
+    event: "delivery_pending";
+    payload: DeliveryPendingEvent;
+} | {
+    event: "delivery_status";
+    payload: DeliveryStatusEvent;
+} | {
+    event: "structured_error";
+    payload: StructuredErrorEvent;
+} | {
+    event: "connected";
+} | {
+    event: "disconnected";
+} | {
+    event: "error";
+    payload: Error;
+};
+type ListenerFor<E extends ConnectorWSEvent["event"]> = (e: Extract<ConnectorWSEvent, {
+    event: E;
+}>) => void;
+export interface ConnectorWSOptions {
+    url: string;
+    token: string;
+}
+export declare class ConnectorWS {
+    private readonly client;
+    private readonly bus;
+    constructor(opts: ConnectorWSOptions);
+    connect(): Promise<void>;
+    disconnect(): void;
+    send(to: string, content: string, contentType?: string, metadata?: Record<string, unknown>): Promise<SendAckEvent>;
+    ackDelivery(upTo: string): boolean;
+    on<E extends ConnectorWSEvent["event"]>(event: E, listener: ListenerFor<E>): this;
+    off<E extends ConnectorWSEvent["event"]>(event: E, listener: ListenerFor<E>): this;
+    _emitForTesting(e: ConnectorWSEvent): void;
+    private wireForwarders;
+}
+export { ConnectorError };
+//# sourceMappingURL=connector-ws.d.ts.map

package/dist/broker/connector-ws.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connector-ws.d.ts","sourceRoot":"","sources":["../../src/broker/connector-ws.ts"],"names":[],"mappings":"AAaA,OAAO,EAAmB,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GACxB;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,qBAAqB,CAAA;CAAE,GAC7D;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,YAAY,CAAA;CAAE,GAC5C;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GAC5D;IAAE,KAAK,EAAE,iBAAiB,CAAC;IAAC,OAAO,EAAE,mBAAmB,CAAA;CAAE,GAC1D;IAAE,KAAK,EAAE,kBAAkB,CAAC;IAAC,OAAO,EAAE,oBAAoB,CAAA;CAAE,GAC5D;IAAE,KAAK,EAAE,WAAW,CAAA;CAAE,GACtB;IAAE,KAAK,EAAE,cAAc,CAAA;CAAE,GACzB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAEvC,KAAK,WAAW,CAAC,CAAC,SAAS,gBAAgB,CAAC,OAAO,CAAC,IAAI,CACtD,CAAC,EAAE,OAAO,CAAC,gBAAgB,EAAE;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC,KACvC,IAAI,CAAC;AAEV,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAsB;gBAE9B,IAAI,EAAE,kBAAkB;IAMpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAKxB,UAAU,IAAI,IAAI;IASlB,IAAI,CACF,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,MAAM,EACf,WAAW,SAAS,EACpB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,YAAY,CAAC;IAKxB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIlC,EAAE,CAAC,CAAC,SAAS,gBAAgB,CAAC,OAAO,CAAC,EACpC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,IAAI;IAKP,GAAG,CAAC,CAAC,SAAS,gBAAgB,CAAC,OAAO,CAAC,EACrC,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,GACvB,IAAI;IAMS,eAAe,CAAC,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAI1D,OAAO,CAAC,cAAc;CA0BvB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/broker/connector-ws.js

@@ -0,0 +1,60 @@
+import { EventEmitter } from "node:events";
+import { ConnectorClient, ConnectorError } from "../connector-client.js";
+export class ConnectorWS {
+    client;
+    bus = new EventEmitter();
+    constructor(opts) {
+        this.client = new ConnectorClient(opts.url, opts.token);
+        this.wireForwarders();
+    }
+    connect() {
+        return this.client.connect();
+    }
+    disconnect() {
+        this.client.disconnect();
+    }
+    send(to, content, contentType = "text", metadata) {
+        return this.client.send(to, content, contentType, metadata);
+    }
+    ackDelivery(upTo) {
+        return this.client.ackDelivery(upTo);
+    }
+    on(event, listener) {
+        this.bus.on(event, listener);
+        return this;
+    }
+    off(event, listener) {
+        this.bus.off(event, listener);
+        return this;
+    }
+    _emitForTesting(e) {
+        this.bus.emit(e.event, e);
+    }
+    wireForwarders() {
+        this.client.on("message_received", (payload) => {
+            this.bus.emit("message_received", { event: "message_received", payload });
+        });
+        this.client.on("send_ack", (payload) => {
+            this.bus.emit("send_ack", { event: "send_ack", payload });
+        });
+        this.client.on("delivery_pending", (payload) => {
+            this.bus.emit("delivery_pending", { event: "delivery_pending", payload });
+        });
+        this.client.on("delivery_status", (payload) => {
+            this.bus.emit("delivery_status", { event: "delivery_status", payload });
+        });
+        this.client.on("structured_error", (payload) => {
+            this.bus.emit("structured_error", { event: "structured_error", payload });
+        });
+        this.client.on("connected", () => {
+            this.bus.emit("connected", { event: "connected" });
+        });
+        this.client.on("disconnected", () => {
+            this.bus.emit("disconnected", { event: "disconnected" });
+        });
+        this.client.on("error", (err) => {
+            this.bus.emit("error", { event: "error", payload: err });
+        });
+    }
+}
+export { ConnectorError };

package/dist/broker/control-event-dispatcher.d.ts

@@ -0,0 +1,21 @@
+import type { ControlEvent } from "./control-event-types.js";
+export declare const DEFAULT_IDEMPOTENCY_RING_SIZE = 1024;
+export type ControlEventOutcome = {
+    ok: true;
+    ack_hint?: "received";
+} | {
+    ok: false;
+    detail: string;
+};
+export type ControlEventHandler<E extends ControlEvent = ControlEvent> = (event: E) => Promise<ControlEventOutcome>;
+export interface ControlEventDispatcher {
+    on<E extends ControlEvent>(type: E["type"], handler: ControlEventHandler<E>): void;
+    dispatch(event: ControlEvent): Promise<ControlEventOutcome>;
+    ringSize(): number;
+    hasSeen(idempotency_key: string): boolean;
+}
+export interface ControlEventDispatcherOptions {
+    ringSize?: number;
+}
+export declare function createControlEventDispatcher(opts?: ControlEventDispatcherOptions): ControlEventDispatcher;
+//# sourceMappingURL=control-event-dispatcher.d.ts.map

package/dist/broker/control-event-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-event-dispatcher.d.ts","sourceRoot":"","sources":["../../src/broker/control-event-dispatcher.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAYlD,MAAM,MAAM,mBAAmB,GAC3B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,EAAE,UAAU,CAAA;CAAE,GACnC;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,IAAI,CACvE,KAAK,EAAE,CAAC,KACL,OAAO,CAAC,mBAAmB,CAAC,CAAC;AAElC,MAAM,WAAW,sBAAsB;IAErC,EAAE,CAAC,CAAC,SAAS,YAAY,EACvB,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EACf,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC9B,IAAI,CAAC;IAKR,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;IAE5D,QAAQ,IAAI,MAAM,CAAC;IAEnB,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3C;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,GAAE,6BAAkC,GACvC,sBAAsB,CAqDxB"}

package/dist/broker/control-event-dispatcher.js

@@ -0,0 +1,45 @@
+export const DEFAULT_IDEMPOTENCY_RING_SIZE = 1024;
+export function createControlEventDispatcher(opts = {}) {
+    const cap = opts.ringSize ?? DEFAULT_IDEMPOTENCY_RING_SIZE;
+    if (cap <= 0)
+        throw new Error(`ringSize must be positive: ${cap}`);
+    const seen = new Set();
+    const order = [];
+    const handlers = new Map();
+    return {
+        on(type, handler) {
+            handlers.set(type, handler);
+        },
+        async dispatch(event) {
+            if (seen.has(event.idempotency_key)) {
+                return { ok: true };
+            }
+            seen.add(event.idempotency_key);
+            order.push(event.idempotency_key);
+            if (order.length > cap) {
+                const oldest = order.shift();
+                if (oldest !== undefined)
+                    seen.delete(oldest);
+            }
+            const handler = handlers.get(event.type);
+            if (!handler) {
+                return { ok: false, detail: `no_handler:${event.type}` };
+            }
+            try {
+                return await handler(event);
+            }
+            catch (err) {
+                return {
+                    ok: false,
+                    detail: err instanceof Error ? err.message : String(err),
+                };
+            }
+        },
+        ringSize() {
+            return seen.size;
+        },
+        hasSeen(idempotency_key) {
+            return seen.has(idempotency_key);
+        },
+    };
+}

package/dist/broker/control-event-types.d.ts

@@ -0,0 +1,28 @@
+export interface ControlEventBase {
+    version: 1;
+    idempotency_key: string;
+    emitted_at: number;
+}
+export type ControlEvent = DispatchUndispatchedEvent | SpawnRequestEvent | ForceUnregisterEvent;
+export interface DispatchUndispatchedEvent extends ControlEventBase {
+    type: "dispatch_undispatched";
+    undispatched_id: string;
+    target_endpoint_id: string;
+}
+export interface SpawnRequestEvent extends ControlEventBase {
+    type: "spawn_request";
+    prompt: string;
+    runtime_kind: "claude-code" | "openclaw" | "codex" | "custom";
+    origin: "passport-spawn";
+}
+export interface ForceUnregisterEvent extends ControlEventBase {
+    type: "force_unregister";
+    endpoint_id: string;
+    reason: string;
+}
+export interface ControlAck {
+    idempotency_key: string;
+    status: "received" | "applied" | "failed";
+    detail?: string;
+}
+//# sourceMappingURL=control-event-types.d.ts.map

package/dist/broker/control-event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"control-event-types.d.ts","sourceRoot":"","sources":["../../src/broker/control-event-types.ts"],"names":[],"mappings":"AAwCA,MAAM,WAAW,gBAAgB;IAI/B,OAAO,EAAE,CAAC,CAAC;IAWX,eAAe,EAAE,MAAM,CAAC;IAKxB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,MAAM,YAAY,GACpB,yBAAyB,GACzB,iBAAiB,GACjB,oBAAoB,CAAC;AAGzB,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,IAAI,EAAE,uBAAuB,CAAC;IAE9B,eAAe,EAAE,MAAM,CAAC;IAExB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAGD,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,IAAI,EAAE,eAAe,CAAC;IAEtB,MAAM,EAAE,MAAM,CAAC;IAMf,YAAY,EAAE,aAAa,GAAG,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IAG9D,MAAM,EAAE,gBAAgB,CAAC;CAC1B;AAGD,MAAM,WAAW,oBAAqB,SAAQ,gBAAgB;IAC5D,IAAI,EAAE,kBAAkB,CAAC;IAEzB,WAAW,EAAE,MAAM,CAAC;IAEpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAwBD,MAAM,WAAW,UAAU;IAEzB,eAAe,EAAE,MAAM,CAAC;IAExB,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,QAAQ,CAAC;IAE1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/broker/control-event-types.js

@@ -0,0 +1 @@
+export {};

package/dist/broker/correlation-ring.d.ts

@@ -0,0 +1,10 @@
+export declare class CorrelationRingBuffer {
+    private readonly capacity;
+    private readonly set;
+    private readonly order;
+    constructor(capacity?: number);
+    add(correlation_id: string): void;
+    has(correlation_id: string): boolean;
+    size(): number;
+}
+//# sourceMappingURL=correlation-ring.d.ts.map

package/dist/broker/correlation-ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"correlation-ring.d.ts","sourceRoot":"","sources":["../../src/broker/correlation-ring.ts"],"names":[],"mappings":"AAaA,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAW;gBAErB,QAAQ,GAAE,MAAoB;IAU1C,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI;IAYjC,GAAG,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIpC,IAAI,IAAI,MAAM;CAGf"}

package/dist/broker/correlation-ring.js

@@ -0,0 +1,32 @@
+const DEFAULT_CAP = 1024;
+export class CorrelationRingBuffer {
+    capacity;
+    set;
+    order;
+    constructor(capacity = DEFAULT_CAP) {
+        if (capacity <= 0) {
+            throw new Error(`capacity must be positive: ${capacity}`);
+        }
+        this.capacity = capacity;
+        this.set = new Set();
+        this.order = [];
+    }
+    add(correlation_id) {
+        if (this.set.has(correlation_id)) {
+            return;
+        }
+        if (this.order.length >= this.capacity) {
+            const oldest = this.order.shift();
+            if (oldest !== undefined)
+                this.set.delete(oldest);
+        }
+        this.set.add(correlation_id);
+        this.order.push(correlation_id);
+    }
+    has(correlation_id) {
+        return this.set.has(correlation_id);
+    }
+    size() {
+        return this.set.size;
+    }
+}

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

@@ -0,0 +1,12 @@
+export interface DiscoveryRecord {
+    version: 1;
+    pid: number;
+    startedAt: string;
+    ipcUrl: string;
+    bearerToken: string;
+}
+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;
+//# sourceMappingURL=discovery-file.d.ts.map

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

@@ -0,0 +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"}

package/dist/broker/discovery-file.js

@@ -0,0 +1,77 @@
+import { randomBytes } from "node:crypto";
+import { chmodSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
+export function mintBearerToken() {
+    return randomBytes(32).toString("base64url");
+}
+export function writeDiscoveryFile(path, record) {
+    if (record.version !== 1) {
+        throw new Error(`unsupported discovery record version: ${record.version}`);
+    }
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const tmp = `${path}.tmp.${process.pid}.${randomBytes(4).toString("hex")}`;
+    const payload = JSON.stringify(record, null, 2);
+    writeFileSync(tmp, payload, { mode: 0o600, encoding: "utf8" });
+    try {
+        chmodSync(tmp, 0o600);
+    }
+    catch {
+    }
+    try {
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+        }
+        throw err;
+    }
+}
+export function readDiscoveryFile(path) {
+    let raw;
+    try {
+        raw = readFileSync(path, "utf8");
+    }
+    catch (err) {
+        if (isNodeErr(err, "ENOENT"))
+            return null;
+        throw err;
+    }
+    try {
+        const parsed = JSON.parse(raw);
+        if (!isDiscoveryRecord(parsed))
+            return null;
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}
+export function deleteDiscoveryFile(path) {
+    try {
+        unlinkSync(path);
+    }
+    catch (err) {
+        if (isNodeErr(err, "ENOENT"))
+            return;
+        throw err;
+    }
+}
+function isDiscoveryRecord(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (v.version === 1 &&
+        typeof v.pid === "number" &&
+        typeof v.startedAt === "string" &&
+        typeof v.ipcUrl === "string" &&
+        typeof v.bearerToken === "string");
+}
+function isNodeErr(err, code) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === code);
+}

package/dist/broker/endpoint-registry.d.ts

@@ -0,0 +1,53 @@
+import type WebSocket from "ws";
+import { CorrelationRingBuffer } from "./correlation-ring.js";
+export interface DisplayMetadata {
+    session_name?: string;
+    kind: string;
+    started_at: string;
+    workspace?: string;
+    tracking_ref?: string;
+    task_hint?: string;
+}
+export interface BrokerEndpointEntry {
+    endpoint_id: string;
+    agent_id: string;
+    plugin_pid: number;
+    ipc_ws: WebSocket;
+    state: "active" | "reconnecting";
+    state_since: Date;
+    grace_deadline?: Date;
+    display_metadata: DisplayMetadata;
+    correlation_ring: CorrelationRingBuffer;
+}
+export interface RegisterArgs {
+    endpoint_id: string;
+    agent_id: string;
+    plugin_pid: number;
+    ipc_ws: WebSocket;
+    display_metadata: DisplayMetadata;
+}
+export declare class EndpointRegistry {
+    private readonly byId;
+    register(args: RegisterArgs): BrokerEndpointEntry;
+    get(endpoint_id: string): BrokerEndpointEntry | undefined;
+    unregister(endpoint_id: string): BrokerEndpointEntry | undefined;
+    markReconnecting(endpoint_id: string, grace_deadline: Date): BrokerEndpointEntry;
+    markActive(endpoint_id: string, new_ws: WebSocket): BrokerEndpointEntry;
+    preconditionForReattach(endpoint_id: string, plugin_pid: number): BrokerEndpointEntry | undefined;
+    getReattachStatus(endpoint_id: string, plugin_pid: number): {
+        ok: true;
+        entry: BrokerEndpointEntry;
+    } | {
+        ok: false;
+        reason: "endpoint_unknown";
+    } | {
+        ok: false;
+        reason: "reattach_pid_mismatch";
+    } | {
+        ok: false;
+        reason: "endpoint_not_reconnecting";
+    };
+    list(): BrokerEndpointEntry[];
+    size(): number;
+}
+//# sourceMappingURL=endpoint-registry.d.ts.map

package/dist/broker/endpoint-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-registry.d.ts","sourceRoot":"","sources":["../../src/broker/endpoint-registry.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAG9D,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,QAAQ,GAAG,cAAc,CAAC;IACjC,WAAW,EAAE,IAAI,CAAC;IAElB,cAAc,CAAC,EAAE,IAAI,CAAC;IACtB,gBAAgB,EAAE,eAAe,CAAC;IAClC,gBAAgB,EAAE,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,gBAAgB,EAAE,eAAe,CAAC;CACnC;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA0C;IAG/D,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,mBAAmB;IAkBjD,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAKzD,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAWhE,gBAAgB,CACd,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,IAAI,GACnB,mBAAmB;IAoBtB,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,mBAAmB;IA8BvE,uBAAuB,CACrB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,mBAAmB,GAAG,SAAS;IAYlC,iBAAiB,CACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GAEhB;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,mBAAmB,CAAA;KAAE,GACxC;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,kBAAkB,CAAA;KAAE,GACzC;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,uBAAuB,CAAA;KAAE,GAC9C;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,MAAM,EAAE,2BAA2B,CAAA;KAAE;IAWtD,IAAI,IAAI,mBAAmB,EAAE;IAK7B,IAAI,IAAI,MAAM;CAGf"}