@masons/runtime-broker 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MASONS.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,35 @@
+# @masons/runtime-broker
+
+Local Runtime Broker daemon and BrokerClient SDK for MASONS multi-session
+agent runtime coordination.
+
+## Install
+
+```bash
+npm install @masons/runtime-broker
+```
+
+## Public API
+
+The stable SDK surface is the BrokerClient:
+
+```ts
+import { BrokerClient } from "@masons/runtime-broker";
+```
+
+The `@masons/runtime-broker/client` subpath exports the same SDK surface for
+call sites that prefer an explicit client import.
+
+Broker daemon internals, spawn drivers, and duplicated protocol substrate ship
+inside the package for lazy-spawn/runtime ownership, but they are not a stable
+public API in this release.
+
+## Package Split
+
+`@masons/agent-network` is the OpenClaw channel package. Broker-only runtime
+code lives here so OpenClaw installs can remain scanner-clean while Claude Code,
+Codex, and future runtime hosts depend directly on the broker package.
+
+## License
+
+MIT

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

@@ -0,0 +1,71 @@
+import { spawn as spawnChild } from "node:child_process";
+import type { IncomingMessage } from "node:http";
+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 EndpointState } from "./endpoint-state-machine.js";
+import type { BrokerLogger } from "./logger.js";
+import { type NetworkPresence } from "./network-presence.js";
+import type { NetworkPresenceChangedEvent } from "./network-presence-changed-event-types.js";
+import type { BrokerPaths } from "./paths.js";
+import { type BufferedMessage } from "./reconnecting-buffer.js";
+import type { RuntimeEndpointPort } from "./runtime-endpoint-port.js";
+import type { ServicesEventClient } from "./services-event-client.js";
+import type { SpawnDriverRegistry } from "./spawn-driver.js";
+import { type UndispatchedChangedEvent } from "./undispatched-changed-event-types.js";
+import { type UndispatchedInbox } from "./undispatched-inbox.js";
+export interface BrokerDaemonOptions {
+    paths: BrokerPaths;
+    asNodeId: string;
+    connector: ConnectorWS;
+    apiPort: RuntimeEndpointPort;
+    logger: BrokerLogger;
+    closedEndpointLookup?: ClosedEndpointLookup;
+    inboxCapacity?: number;
+    graceMs?: number;
+    livenessProbe?: (plugin_pid: number) => boolean;
+    spawnDriverRegistry?: SpawnDriverRegistry;
+    spawnFn?: typeof spawnChild;
+    spawnRateLimitMaxInWindow?: number;
+    spawnRateLimitWindowMs?: number;
+    spawnCorrelationTimeoutMs?: number;
+    presenceGraceMs?: number;
+    retryQueueCapacity?: number;
+    servicesEventClientFactory?: (deps: {
+        dispatcher: ControlEventDispatcher;
+        logger: BrokerLogger;
+    }) => ServicesEventClient;
+    postControlAck?: (ack: ControlAck) => Promise<void>;
+    replyCorrelationTtlMs?: number;
+    replyCorrelationCapPerEndpoint?: number;
+    undispatchedChangedPost?: (event: UndispatchedChangedEvent) => Promise<import("./runtime-endpoint-port.js").EmitOutcome>;
+    undispatchedChangedCapacity?: number;
+    undispatchedChangedBackoffInitialMs?: number;
+    undispatchedChangedBackoffMaxMs?: number;
+    undispatchedChangedMaxRetries?: number;
+    networkPresenceChangedPost?: (event: NetworkPresenceChangedEvent) => Promise<import("./runtime-endpoint-port.js").EmitOutcome>;
+    networkPresenceChangedCapacity?: number;
+    networkPresenceChangedBackoffInitialMs?: number;
+    networkPresenceChangedBackoffMaxMs?: number;
+    networkPresenceChangedMaxRetries?: number;
+}
+export interface RunningBroker {
+    bearerToken: string;
+    ipcUrl: string;
+    shutdown(reason: string): Promise<void>;
+    registrySize(): number;
+    state(endpoint_id: string): EndpointState | undefined;
+    undispatchedInbox: UndispatchedInbox;
+    controlEventDispatcher: ControlEventDispatcher;
+    networkPresence(): NetworkPresence;
+    pendingSpawnCount(): number;
+    retryQueueSize(): number;
+    replyCorrelationCacheSize(endpoint_id: string): number;
+    undispatchedChangedQueueSize(): number;
+    networkPresenceChangedQueueSize(): number;
+}
+export declare function startBrokerDaemon(opts: BrokerDaemonOptions): Promise<RunningBroker>;
+export declare function readPluginPidHeader(req: IncomingMessage): number | null;
+export type { BufferedMessage };
+//# sourceMappingURL=broker-daemon.d.ts.map

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

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