@masons/runtime-broker 0.2.8 → 0.2.10

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

@@ -30,12 +30,18 @@ function safeJsonParse(text) {
 export class BrokerClient extends EventEmitter {
     handle;
     ws = null;
+    heartbeatInterval = null;
+    heartbeatTimeout = null;
+    heartbeatMisses = 0;
+    heartbeatTimeoutMs = 5_000;
+    heartbeatMissesBeforeDisconnect = 2;
     pluginPid = null;
     _sessionId = null;
     _networkPresence = null;
     _serverCapabilities = {};
     _clientKind = null;
     _clientVersion = null;
+    endpointOwnerTokens = new Map();
     constructor(handle) {
         super();
         this.handle = handle;
@@ -81,11 +87,22 @@ export class BrokerClient extends EventEmitter {
         this.pluginPid = opts.pluginPid;
         this._clientKind = opts.clientKind;
         this._clientVersion = opts.clientVersion;
+        this.heartbeatTimeoutMs = opts.heartbeatTimeoutMs ?? 5_000;
+        this.heartbeatMissesBeforeDisconnect =
+            opts.heartbeatMissesBeforeDisconnect ?? 2;
+        const clientCapabilities = {
+            endpoint_metadata_v1: true,
+            push_receipt_ack_v1: true,
+        };
+        const clientCapabilityHeader = Object.entries(clientCapabilities)
+            .filter(([, enabled]) => enabled === true)
+            .map(([name]) => name)
+            .join(",");
         const initRes = await this.httpJson("POST", "/v1/initialize", {
             client_protocol_version: IPC_PROTOCOL_VERSION,
             client_kind: opts.clientKind,
             client_version: opts.clientVersion,
-            capabilities: { endpoint_metadata_v1: true },
+            capabilities: clientCapabilities,
         });
         this._sessionId = initRes.session_id;
         this._serverCapabilities = initRes.server_capabilities;
@@ -95,6 +112,7 @@ export class BrokerClient extends EventEmitter {
             headers: {
                 Authorization: `Bearer ${this.handle.record.bearerToken}`,
                 "x-plugin-pid": String(opts.pluginPid),
+                "x-masons-ipc-capabilities": clientCapabilityHeader,
             },
         });
         this.ws = ws;
@@ -111,18 +129,21 @@ export class BrokerClient extends EventEmitter {
             ws.once("error", onError);
         });
         ws.on("message", (data) => this.handleFrame(data.toString()));
+        ws.on("pong", () => this.markHeartbeatAlive());
         ws.on("close", () => {
+            this.clearHeartbeat();
             this.ws = null;
             this.emit("disconnected");
         });
         ws.on("error", (err) => this.emit("error", err));
+        this.startHeartbeat(opts.heartbeatIntervalMs ?? 30_000);
         return initRes;
     }
     async registerEndpoint(args) {
         if (this.pluginPid === null) {
             throw new Error("BrokerClient.connect must be called before registerEndpoint");
         }
-        return this.httpJson("POST", "/v1/endpoint/register", {
+        const outcome = await this.httpJson("POST", "/v1/endpoint/register", {
             agent_id: args.agentId,
             plugin_pid: this.pluginPid,
             kind: args.kind,
@@ -138,6 +159,10 @@ export class BrokerClient extends EventEmitter {
             background_exchange_mode: args.backgroundExchangeMode,
             spawn_token: args.spawnToken,
         });
+        if (typeof outcome.endpoint_owner_token === "string") {
+            this.endpointOwnerTokens.set(outcome.endpoint_id, outcome.endpoint_owner_token);
+        }
+        return outcome;
     }
     async send(endpointId, to, content, contentType = "text", metadata) {
         return this.httpJson("POST", "/v1/send", {
@@ -155,6 +180,7 @@ export class BrokerClient extends EventEmitter {
         return this.httpJson("POST", "/v1/runtime/assignment-reply", {
             endpoint_id: args.endpointId,
             plugin_pid: this.pluginPid,
+            endpoint_owner_token: this.requireEndpointOwnerToken(args.endpointId),
             source_message_id: args.sourceMessageId,
             assignment_id: args.assignmentId,
             reply_request_id: args.replyRequestId,
@@ -162,6 +188,18 @@ export class BrokerClient extends EventEmitter {
             contentType: args.contentType,
         });
     }
+    async claimRuntimeAssignment(args) {
+        if (this.pluginPid === null) {
+            throw new Error("BrokerClient.connect must be called before claimRuntimeAssignment");
+        }
+        return this.httpJson("POST", "/v1/runtime/assignment-claim", {
+            endpoint_id: args.endpointId,
+            plugin_pid: this.pluginPid,
+            endpoint_owner_token: this.requireEndpointOwnerToken(args.endpointId),
+            undispatched_id: args.undispatchedId,
+            ...(args.recoverExisting === true && { recover_existing: true }),
+        });
+    }
     async reportRuntimeProcessingState(args) {
         if (this.pluginPid === null) {
             throw new Error("BrokerClient.connect must be called before reportRuntimeProcessingState");
@@ -169,6 +207,7 @@ export class BrokerClient extends EventEmitter {
         await this.httpJson("POST", "/v1/runtime/processing-state", {
             endpoint_id: args.endpointId,
             plugin_pid: this.pluginPid,
+            endpoint_owner_token: this.requireEndpointOwnerToken(args.endpointId),
             source_message_id: args.sourceMessageId,
             assignment_id: args.assignmentId,
             state_event_id: args.stateEventId,
@@ -196,6 +235,7 @@ export class BrokerClient extends EventEmitter {
                 this.ws.readyState === WebSocket.CONNECTING)) {
             this.ws.close(1000, "client_close");
         }
+        this.clearHeartbeat();
         this.ws = null;
     }
     on(event, listener) {
@@ -215,6 +255,9 @@ export class BrokerClient extends EventEmitter {
             method,
             headers: {
                 Authorization: `Bearer ${this.handle.record.bearerToken}`,
+                ...(this.pluginPid !== null
+                    ? { "x-plugin-pid": String(this.pluginPid) }
+                    : {}),
                 ...(body ? { "Content-Type": "application/json" } : {}),
             },
             body: body ? JSON.stringify(body) : undefined,
@@ -247,6 +290,13 @@ export class BrokerClient extends EventEmitter {
         }
         return (await res.json());
     }
+    requireEndpointOwnerToken(endpointId) {
+        const token = this.endpointOwnerTokens.get(endpointId);
+        if (!token) {
+            throw new Error("endpoint_owner_token missing; endpoint must be registered through this BrokerClient before endpoint-scoped operations");
+        }
+        return token;
+    }
     handleFrame(raw) {
         let parsed;
         try {
@@ -258,6 +308,11 @@ export class BrokerClient extends EventEmitter {
         }
         if (!parsed || typeof parsed !== "object" || !("event" in parsed))
             return;
+        const pushId = parsed.push_id;
+        if (typeof pushId === "string" &&
+            this._serverCapabilities.push_receipt_ack_v1 === true) {
+            this.sendPushAck(pushId);
+        }
         const event = parsed.event;
         if (event === "message_received") {
             const msg = parsed;
@@ -291,4 +346,69 @@ export class BrokerClient extends EventEmitter {
             return;
         }
     }
+    sendPushAck(pushId) {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        try {
+            ws.send(JSON.stringify({ event: "push_ack", push_id: pushId }));
+        }
+        catch (err) {
+            this.emit("error", err instanceof Error ? err : new Error(String(err)));
+        }
+    }
+    startHeartbeat(intervalMs) {
+        this.clearHeartbeat();
+        if (!Number.isFinite(intervalMs) || intervalMs <= 0)
+            return;
+        const timer = setInterval(() => this.sendHeartbeatProbe(), intervalMs);
+        const maybeUnref = timer;
+        if (typeof maybeUnref.unref === "function")
+            maybeUnref.unref();
+        this.heartbeatInterval = timer;
+    }
+    sendHeartbeatProbe() {
+        const ws = this.ws;
+        if (!ws || ws.readyState !== WebSocket.OPEN)
+            return;
+        if (this.heartbeatTimeout)
+            return;
+        try {
+            ws.ping();
+        }
+        catch (err) {
+            this.emit("error", err instanceof Error ? err : new Error(String(err)));
+            ws.terminate();
+            return;
+        }
+        const timeout = setTimeout(() => {
+            this.heartbeatTimeout = null;
+            this.heartbeatMisses += 1;
+            if (this.heartbeatMisses >= this.heartbeatMissesBeforeDisconnect) {
+                ws.terminate();
+            }
+        }, this.heartbeatTimeoutMs);
+        const maybeUnref = timeout;
+        if (typeof maybeUnref.unref === "function")
+            maybeUnref.unref();
+        this.heartbeatTimeout = timeout;
+    }
+    markHeartbeatAlive() {
+        this.heartbeatMisses = 0;
+        if (this.heartbeatTimeout) {
+            clearTimeout(this.heartbeatTimeout);
+            this.heartbeatTimeout = null;
+        }
+    }
+    clearHeartbeat() {
+        if (this.heartbeatInterval) {
+            clearInterval(this.heartbeatInterval);
+            this.heartbeatInterval = null;
+        }
+        if (this.heartbeatTimeout) {
+            clearTimeout(this.heartbeatTimeout);
+            this.heartbeatTimeout = null;
+        }
+        this.heartbeatMisses = 0;
+    }
 }

package/dist/runtime-endpoint-client.d.ts

@@ -1,4 +1,7 @@
 import { PlatformApiError, type PlatformClientConfig } from "./platform-client.js";
+type PartialRuntimeSelfClaimResponse = Omit<Partial<RuntimeSelfClaimResponse>, "target_ref"> & {
+    target_ref?: RuntimeWorkTargetRef;
+};
 export { PlatformApiError, type PlatformClientConfig };
 export type RuntimeKind = "claude-code" | "openclaw" | "codex" | "passport" | "custom" | (string & {});
 export type RuntimeEndpointCapability = "remote_spawn_v1" | "background_exchange_v1" | "foreground_channel_v1" | (string & {});
@@ -84,6 +87,36 @@ export interface UpdateRuntimeEndpointDisplayMetadataParams {
     session_name?: string;
     task_hint?: string;
 }
+export interface RuntimeSelfClaimParams {
+    undispatched_id: string;
+    target_endpoint_id: string;
+    endpoint_nonce: string;
+    recover_existing?: boolean;
+}
+export interface RuntimeSelfClaimResponse {
+    assignment_id: string;
+    undispatched_id: string;
+    source_message_id: string;
+    target_ref: RuntimeWorkTargetRef;
+    broker_projection_token: string;
+    assigned_at: number;
+    claimed: boolean;
+    message: {
+        from: string;
+        content: string;
+        contentType: string;
+        metadata?: Record<string, unknown>;
+        sourceMessageId: string;
+    };
+}
+export interface RuntimeSelfClaimReleaseParams {
+    undispatched_id: string;
+    source_message_id: string;
+    assignment_id: string;
+    target_ref: RuntimeWorkTargetRef;
+    endpoint_nonce: string;
+    broker_projection_token: string;
+}
 export declare function registerRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, params: RegisterRuntimeEndpointParams): Promise<RegisterRuntimeEndpointResponse>;
 export declare function heartbeatRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string): Promise<HeartbeatRuntimeEndpointResponse>;
 export declare function transitionRuntimeEndpointState(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, params: TransitionRuntimeEndpointStateParams): Promise<TransitionRuntimeEndpointStateResponse>;
@@ -109,8 +142,20 @@ export type RuntimeInboundRouteClaimOutcome = {
     status?: number;
     detail?: string;
 };
+export type RuntimeSelfClaimOutcome = {
+    ok: true;
+    claim: RuntimeSelfClaimResponse;
+} | {
+    ok: false;
+    terminal: boolean;
+    status?: number;
+    detail?: string;
+    postCasInvalidClaim?: PartialRuntimeSelfClaimResponse;
+};
 export declare function emitRuntimeNetworkPresenceChanged(cfg: PlatformClientConfig, runtimeKey: string, event: Readonly<Record<string, unknown>>): Promise<EmitUndispatchedChangedOutcome>;
 export declare function claimRuntimeInboundRoute(cfg: PlatformClientConfig, runtimeKey: string, event: Readonly<Record<string, unknown>>): Promise<RuntimeInboundRouteClaimOutcome>;
+export declare function claimRuntimeSelfAssignment(cfg: PlatformClientConfig, runtimeKey: string, params: RuntimeSelfClaimParams): Promise<RuntimeSelfClaimOutcome>;
+export declare function releaseRuntimeSelfAssignment(cfg: PlatformClientConfig, runtimeKey: string, params: RuntimeSelfClaimReleaseParams): Promise<EmitUndispatchedChangedOutcome>;
 export declare function emitRuntimeInboundRouted(cfg: PlatformClientConfig, runtimeKey: string, event: Readonly<Record<string, unknown>>): Promise<EmitUndispatchedChangedOutcome>;
 export declare function emitRuntimeProcessingState(cfg: PlatformClientConfig, runtimeKey: string, event: Readonly<Record<string, unknown>>): Promise<EmitUndispatchedChangedOutcome>;
 //# sourceMappingURL=runtime-endpoint-client.d.ts.map

package/dist/runtime-endpoint-client.d.ts.map

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

package/dist/runtime-endpoint-client.js

@@ -20,6 +20,35 @@ function jsonHeaders(runtimeKey) {
         "Content-Type": "application/json",
     };
 }
+function readRuntimeWorkTargetRef(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const raw = value;
+    if (raw.kind !== "projection_endpoint" ||
+        typeof raw.projection_endpoint_id !== "string") {
+        return null;
+    }
+    if (raw.background_exchange_mode === "resident_endpoint") {
+        if (raw.runtime_session_id !== undefined)
+            return null;
+        return {
+            kind: "projection_endpoint",
+            projection_endpoint_id: raw.projection_endpoint_id,
+            background_exchange_mode: "resident_endpoint",
+        };
+    }
+    if (raw.background_exchange_mode === "adapter_managed_turn" &&
+        typeof raw.runtime_session_id === "string" &&
+        raw.runtime_session_id.trim().length > 0) {
+        return {
+            kind: "projection_endpoint",
+            projection_endpoint_id: raw.projection_endpoint_id,
+            runtime_session_id: raw.runtime_session_id,
+            background_exchange_mode: "adapter_managed_turn",
+        };
+    }
+    return null;
+}
 export async function registerRuntimeEndpoint(cfg, runtimeKey, params) {
     const res = await fetch(`${baseUrl(cfg)}/runtime-endpoints`, {
         method: "POST",
@@ -200,6 +229,147 @@ export async function claimRuntimeInboundRoute(cfg, runtimeKey, event) {
         detail: await readErrorDetail(res),
     };
 }
+export async function claimRuntimeSelfAssignment(cfg, runtimeKey, params) {
+    let res;
+    try {
+        res = await fetch(`${baseUrl(cfg)}/runtime/self-claim`, {
+            method: "POST",
+            headers: jsonHeaders(runtimeKey),
+            body: JSON.stringify(params),
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            terminal: false,
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    if (res.status === 200 || res.status === 201) {
+        const rawBody = (await res.json().catch(() => null));
+        const body = rawBody !== null && typeof rawBody === "object" && !Array.isArray(rawBody)
+            ? rawBody
+            : null;
+        const targetRef = readRuntimeWorkTargetRef(body?.target_ref);
+        const assignmentId = body?.assignment_id;
+        const undispatchedId = body?.undispatched_id;
+        const sourceMessageId = body?.source_message_id;
+        const brokerProjectionToken = body?.broker_projection_token;
+        const assignedAt = body?.assigned_at;
+        const claimed = body?.claimed;
+        const message = body?.message;
+        if (targetRef !== null &&
+            typeof assignmentId === "string" &&
+            typeof undispatchedId === "string" &&
+            typeof sourceMessageId === "string" &&
+            typeof brokerProjectionToken === "string" &&
+            typeof assignedAt === "number" &&
+            typeof claimed === "boolean" &&
+            typeof message === "object" &&
+            message !== null &&
+            typeof message.from === "string" &&
+            typeof message.content === "string" &&
+            typeof message.contentType === "string" &&
+            typeof message.sourceMessageId === "string" &&
+            message.sourceMessageId === sourceMessageId &&
+            undispatchedId === params.undispatched_id &&
+            (message.metadata === undefined ||
+                (typeof message.metadata === "object" &&
+                    message.metadata !== null &&
+                    !Array.isArray(message.metadata)))) {
+            const claim = {
+                assignment_id: assignmentId,
+                undispatched_id: undispatchedId,
+                source_message_id: sourceMessageId,
+                target_ref: targetRef,
+                broker_projection_token: brokerProjectionToken,
+                assigned_at: assignedAt,
+                claimed,
+                message: {
+                    from: message.from,
+                    content: message.content,
+                    contentType: message.contentType,
+                    ...(message.metadata !== undefined && {
+                        metadata: message.metadata,
+                    }),
+                    sourceMessageId: message.sourceMessageId,
+                },
+            };
+            return {
+                ok: true,
+                claim,
+            };
+        }
+        const postCasInvalidClaim = body
+            ? {
+                ...body,
+                ...(targetRef !== null && { target_ref: targetRef }),
+            }
+            : undefined;
+        return {
+            ok: false,
+            terminal: true,
+            status: res.status,
+            detail: "invalid self-claim response",
+            ...(postCasInvalidClaim !== undefined && { postCasInvalidClaim }),
+        };
+    }
+    if (res.status === 401 ||
+        res.status === 403 ||
+        res.status === 404 ||
+        res.status === 409 ||
+        res.status === 422) {
+        return {
+            ok: false,
+            terminal: true,
+            status: res.status,
+            detail: await readErrorDetail(res),
+        };
+    }
+    return {
+        ok: false,
+        terminal: false,
+        status: res.status,
+        detail: await readErrorDetail(res),
+    };
+}
+export async function releaseRuntimeSelfAssignment(cfg, runtimeKey, params) {
+    let res;
+    try {
+        res = await fetch(`${baseUrl(cfg)}/runtime/self-claim/release`, {
+            method: "POST",
+            headers: jsonHeaders(runtimeKey),
+            body: JSON.stringify(params),
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            terminal: false,
+            detail: err instanceof Error ? err.message : String(err),
+        };
+    }
+    if (res.status === 204)
+        return { ok: true };
+    if (res.status === 401 ||
+        res.status === 403 ||
+        res.status === 404 ||
+        res.status === 409 ||
+        res.status === 422) {
+        return {
+            ok: false,
+            terminal: true,
+            status: res.status,
+            detail: await readErrorDetail(res),
+        };
+    }
+    return {
+        ok: false,
+        terminal: false,
+        status: res.status,
+        detail: await readErrorDetail(res),
+    };
+}
 export async function emitRuntimeInboundRouted(cfg, runtimeKey, event) {
     let res;
     try {

package/dist/version.d.ts

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

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,WAAW,CAAC"}

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/runtime-broker",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "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)",