@masons/runtime-broker 0.2.0 → 0.2.1

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

@@ -11,6 +11,7 @@ import type { NetworkPresenceChangedEvent } from "./network-presence-changed-eve
 import type { BrokerPaths } from "./paths.js";
 import { type BufferedMessage } from "./reconnecting-buffer.js";
 import type { RuntimeEndpointPort } from "./runtime-endpoint-port.js";
+import type { RuntimeInboundRoutedEvent } from "./runtime-inbound-routed-event-types.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";
@@ -49,6 +50,11 @@ export interface BrokerDaemonOptions {
     networkPresenceChangedBackoffInitialMs?: number;
     networkPresenceChangedBackoffMaxMs?: number;
     networkPresenceChangedMaxRetries?: number;
+    runtimeInboundRoutedPost?: (event: RuntimeInboundRoutedEvent) => Promise<import("./runtime-endpoint-port.js").EmitOutcome>;
+    runtimeInboundRoutedCapacity?: number;
+    runtimeInboundRoutedBackoffInitialMs?: number;
+    runtimeInboundRoutedBackoffMaxMs?: number;
+    runtimeInboundRoutedMaxRetries?: number;
 }
 export interface RunningBroker {
     bearerToken: string;
@@ -64,6 +70,7 @@ export interface RunningBroker {
     replyCorrelationCacheSize(endpoint_id: string): number;
     undispatchedChangedQueueSize(): number;
     networkPresenceChangedQueueSize(): number;
+    runtimeInboundRoutedQueueSize(): number;
 }
 export declare function startBrokerDaemon(opts: BrokerDaemonOptions): Promise<RunningBroker>;
 export declare function readPluginPidHeader(req: IncomingMessage): number | null;

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

@@ -2,6 +2,7 @@ import { spawn as spawnChild } from "node:child_process";
 import { randomUUID } from "node:crypto";
 import { basename } from "node:path";
 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 { DEFAULT_GRACE_MS, transition, } from "./endpoint-state-machine.js";
@@ -13,12 +14,14 @@ import { isPluginAlive as defaultIsPluginAlive } from "./plugin-liveness.js";
 import { createReceivedMessageCorrelationCache, DEFAULT_TTL_MS as DEFAULT_REPLY_CORRELATION_TTL_MS, } from "./received-message-correlation-cache.js";
 import { createReconnectingBufferManager, } from "./reconnecting-buffer.js";
 import { RoutingTable } from "./routing-table.js";
+import { createRuntimeInboundRoutedEmitter, postRuntimeInboundRoutedViaPort, } from "./runtime-inbound-routed-emitter.js";
 import { createSpawnCorrelationManager, createSpawnRateLimiter, } from "./spawn-correlation.js";
 import { TASK_HINT_MAX_LENGTH, updateTaskHint } from "./task-hint-handler.js";
 import { createTransitionStateRetryQueue } from "./transition-state-retry-queue.js";
 import { CONTENT_PREVIEW_MAX_CODEPOINTS, truncateContentPreview, } from "./undispatched-changed-event-types.js";
 import { createUndispatchedChangedEmitter, postUndispatchedChangedViaPort, } from "./undispatched-emitter.js";
 import { createUndispatchedInbox, } from "./undispatched-inbox.js";
+const REMOTE_SPAWN_CAPABILITY = "remote_spawn_v1";
 function derivePublicDisplayLabel(body) {
     const parts = [
         body.kind,
@@ -40,6 +43,11 @@ export async function startBrokerDaemon(opts) {
         (async () => {
         });
     void _asNodeIdReservedForA3;
+    const persistedDeliveryCursor = readDeliveryCursorFile(paths.deliveryCursorFile) ?? 0;
+    connector.setDeliveryCursor(persistedDeliveryCursor);
+    logger.info("delivery_cursor_loaded", {
+        lastKnownSeq: persistedDeliveryCursor,
+    });
     logger.info("connecting_to_connector");
     await connector.connect();
     logger.info("connector_connected");
@@ -86,7 +94,8 @@ export async function startBrokerDaemon(opts) {
         }
     }, replyCorrelationSweepInterval);
     replyCorrelationSweepTimer.unref?.();
-    const undispatchedEmitter = createUndispatchedChangedEmitter(opts.undispatchedChangedPost ?? postUndispatchedChangedViaPort(apiPort), logger, {
+    const postUndispatchedChanged = opts.undispatchedChangedPost ?? postUndispatchedChangedViaPort(apiPort);
+    const undispatchedEmitter = createUndispatchedChangedEmitter(postUndispatchedChanged, logger, {
         capacity: opts.undispatchedChangedCapacity,
         backoffInitialMs: opts.undispatchedChangedBackoffInitialMs,
         backoffMaxMs: opts.undispatchedChangedBackoffMaxMs,
@@ -105,6 +114,79 @@ export async function startBrokerDaemon(opts) {
     const emitNetworkPresence = (event) => {
         networkPresenceEmitter.enqueue(event);
     };
+    const postRuntimeInboundRouted = opts.runtimeInboundRoutedPost ?? postRuntimeInboundRoutedViaPort(apiPort);
+    const runtimeInboundRoutedEmitter = createRuntimeInboundRoutedEmitter(postRuntimeInboundRouted, logger, {
+        capacity: opts.runtimeInboundRoutedCapacity,
+        backoffInitialMs: opts.runtimeInboundRoutedBackoffInitialMs,
+        backoffMaxMs: opts.runtimeInboundRoutedBackoffMaxMs,
+        maxRetries: opts.runtimeInboundRoutedMaxRetries,
+    });
+    const directPostUndispatched = async (event, opts = {}) => {
+        let outcome;
+        try {
+            outcome = await postUndispatchedChanged(event);
+        }
+        catch (err) {
+            outcome = {
+                ok: false,
+                terminal: false,
+                detail: err instanceof Error ? err.message : String(err),
+            };
+        }
+        if (outcome.ok)
+            return true;
+        logger.warn("undispatched_changed_direct_post_failed", {
+            action: event.action,
+            undispatched_id: event.undispatched_id,
+            terminal: outcome.terminal,
+            status: outcome.status,
+            detail: outcome.detail,
+        });
+        if (!outcome.terminal && opts.queueOnTransientFailure !== false) {
+            undispatchedEmitter.enqueue(event);
+        }
+        return false;
+    };
+    const directPostRuntimeInboundRouted = async (event, opts = {}) => {
+        let outcome;
+        try {
+            outcome = await postRuntimeInboundRouted(event);
+        }
+        catch (err) {
+            outcome = {
+                ok: false,
+                terminal: false,
+                detail: err instanceof Error ? err.message : String(err),
+            };
+        }
+        if (outcome.ok)
+            return true;
+        logger.warn("runtime_inbound_routed_direct_post_failed", {
+            source_message_id: event.source_message_id,
+            routed_to_endpoint_id: event.routed_to_endpoint_id,
+            terminal: outcome.terminal,
+            status: outcome.status,
+            detail: outcome.detail,
+        });
+        if (!outcome.terminal && opts.queueOnTransientFailure !== false) {
+            runtimeInboundRoutedEmitter.enqueue(event);
+        }
+        return false;
+    };
+    const markDeliverySeqAccepted = (seq) => {
+        if (typeof seq !== "number")
+            return true;
+        const before = connector.getDeliveryCursor();
+        const prepared = connector.prepareDeliverySeqAccepted(seq);
+        if (typeof prepared === "number" && prepared !== before) {
+            writeDeliveryCursorFile(paths.deliveryCursorFile, prepared);
+        }
+        const after = connector.markDeliverySeqAccepted(seq);
+        if (after !== prepared) {
+            throw new Error("delivery cursor changed during durable commit");
+        }
+        return true;
+    };
     const recordInboundCorrelation = (endpoint_id, metadata) => {
         const c = metadata && typeof metadata.correlation_id === "string"
             ? metadata.correlation_id
@@ -285,6 +367,9 @@ export async function startBrokerDaemon(opts) {
                                 content: msg.envelope.content,
                                 contentType: msg.envelope.contentType,
                                 metadata: msg.envelope.metadata,
+                                ...(msg.envelope.sourceMessageId !== undefined && {
+                                    sourceMessageId: msg.envelope.sourceMessageId,
+                                }),
                             });
                         }
                     }
@@ -326,6 +411,9 @@ export async function startBrokerDaemon(opts) {
                     version: 1,
                     action: "remove",
                     undispatched_id: event.undispatched_id,
+                    ...(taken.source_message_id !== undefined && {
+                        source_message_id: taken.source_message_id,
+                    }),
                     remove_reason: "lost_at_capacity_during_redispatch_bounce",
                 });
             }
@@ -344,6 +432,9 @@ export async function startBrokerDaemon(opts) {
                 dispatched_from: event.undispatched_id,
                 dispatched_by: "passport",
             },
+            ...(taken.source_message_id !== undefined && {
+                sourceMessageId: taken.source_message_id,
+            }),
         };
         recordInboundCorrelation(target.endpoint_id, stamped.metadata);
         if (target.state === "active") {
@@ -359,6 +450,9 @@ export async function startBrokerDaemon(opts) {
                     content: taken.content,
                     contentType: taken.content_type,
                     metadata: stamped.metadata,
+                    ...(stamped.sourceMessageId !== undefined && {
+                        sourceMessageId: stamped.sourceMessageId,
+                    }),
                 },
             });
         }
@@ -372,6 +466,9 @@ export async function startBrokerDaemon(opts) {
             version: 1,
             action: "dispatch",
             undispatched_id: event.undispatched_id,
+            ...(taken.source_message_id !== undefined && {
+                source_message_id: taken.source_message_id,
+            }),
             dispatched_to_endpoint_id: event.target_endpoint_id,
         });
         return { ok: true };
@@ -461,6 +558,13 @@ export async function startBrokerDaemon(opts) {
                 throw new BrokerHttpError(400, "ipc_channel_missing", `no open IPC channel for plugin_pid=${body.plugin_pid}; ` +
                     "open WS /v1/stream with x-plugin-pid header first");
             }
+            const spawnDriver = spawnDriverRegistry?.lookup(body.kind);
+            const spawnAvailability = spawnDriver
+                ? await spawnDriver.isAvailable().catch(() => ({ available: false }))
+                : null;
+            const runtimeCapabilities = spawnAvailability?.available
+                ? [REMOTE_SPAWN_CAPABILITY]
+                : undefined;
             const apiResp = await apiPort.register({
                 runtime_kind: body.kind,
                 endpoint_nonce: randomUUID(),
@@ -471,6 +575,7 @@ export async function startBrokerDaemon(opts) {
                 tracking_ref: body.tracking_ref,
                 session_name: body.session_name,
                 task_hint: body.task_hint,
+                runtime_capabilities: runtimeCapabilities,
             });
             registry.register({
                 endpoint_id: apiResp.endpoint_id,
@@ -627,6 +732,9 @@ export async function startBrokerDaemon(opts) {
                     content: msg.envelope.content,
                     contentType: msg.envelope.contentType,
                     metadata: msg.envelope.metadata,
+                    ...(msg.envelope.sourceMessageId !== undefined && {
+                        sourceMessageId: msg.envelope.sourceMessageId,
+                    }),
                 });
             }
             emitTransition(endpoint_id, "active", "reattach");
@@ -724,7 +832,10 @@ export async function startBrokerDaemon(opts) {
             }
         },
     });
-    connector.on("message_received", async ({ payload }) => {
+    const inboundProcessing = new Set();
+    const blockedInboundSeqs = new Set();
+    let unsequencedInboundBlocked = false;
+    const handleInboundMessage = async (payload) => {
         const meta = payload.metadata ?? {};
         const target_endpoint_id = typeof meta.target_endpoint_id === "string"
             ? meta.target_endpoint_id
@@ -732,26 +843,48 @@ export async function startBrokerDaemon(opts) {
         const correlation_id = typeof meta.correlation_id === "string" ? meta.correlation_id : undefined;
         const decision = router.route({ target_endpoint_id, correlation_id });
         if (decision.kind === "endpoint") {
+            if (payload.messageId !== undefined) {
+                const posted = await directPostRuntimeInboundRouted({
+                    type: "runtime_inbound_routed",
+                    version: 1,
+                    source_message_id: payload.messageId,
+                    routed_to_endpoint_id: decision.entry.endpoint_id,
+                    route_kind: decision.entry.state === "active"
+                        ? "active_endpoint"
+                        : "reconnecting_endpoint",
+                    routed_at: Date.now(),
+                }, { queueOnTransientFailure: typeof payload.seq !== "number" });
+                if (!posted && typeof payload.seq === "number")
+                    return false;
+            }
             recordInboundCorrelation(decision.entry.endpoint_id, meta);
             if (decision.entry.state === "active") {
-                pushToPlugin(decision.entry.ipc_ws, {
+                const pushed = pushToPlugin(decision.entry.ipc_ws, {
                     event: "message_received",
                     from: payload.from,
                     content: payload.content,
                     contentType: payload.contentType,
                     metadata: meta,
+                    ...(payload.messageId !== undefined && {
+                        sourceMessageId: payload.messageId,
+                    }),
                 });
+                if (!pushed)
+                    return false;
             }
             else {
                 const buf = reconnectingBuffers.forEndpoint(decision.entry.endpoint_id);
                 buf.append({
-                    id: randomUUID(),
+                    id: payload.messageId ?? randomUUID(),
                     arrived_at: new Date().toISOString(),
                     envelope: {
                         from: payload.from,
                         content: payload.content,
                         contentType: payload.contentType,
                         metadata: meta,
+                        ...(payload.messageId !== undefined && {
+                            sourceMessageId: payload.messageId,
+                        }),
                     },
                 });
                 logger.info("buffered_for_reconnecting_endpoint", {
@@ -759,7 +892,7 @@ export async function startBrokerDaemon(opts) {
                     buffer_size: buf.size(),
                 });
             }
-            return;
+            return markDeliverySeqAccepted(payload.seq);
         }
         let reason = "unaddressed";
         let originalTarget;
@@ -779,7 +912,10 @@ export async function startBrokerDaemon(opts) {
             }
         }
         const undispatched = {
-            id: randomUUID(),
+            id: payload.messageId ?? randomUUID(),
+            ...(payload.messageId !== undefined && {
+                source_message_id: payload.messageId,
+            }),
             arrived_at: new Date().toISOString(),
             sender_address: payload.from,
             content: payload.content,
@@ -796,31 +932,82 @@ export async function startBrokerDaemon(opts) {
                 size: undispatchedInbox.size(),
                 capacity: undispatchedInbox.capacity(),
             });
+            return false;
         }
-        else {
-            logger.info("undispatched_added", { id: undispatched.id, reason });
-            const wireReason = undispatched.reason === "unaddressed"
-                ? "no_target_endpoint"
-                : undispatched.reason;
-            emitUndispatched({
-                type: "undispatched_changed",
-                version: 1,
-                action: "add",
-                undispatched_id: undispatched.id,
-                sender_address: undispatched.sender_address,
-                content_preview: truncateContentPreview(undispatched.content, CONTENT_PREVIEW_MAX_CODEPOINTS),
-                reason: wireReason,
-                ...(undispatched.original_target_endpoint_id !== undefined && {
-                    target_endpoint_id_hint: undispatched.original_target_endpoint_id,
-                }),
-                ...(typeof correlation_id === "string" && {
-                    in_reply_to: correlation_id,
-                }),
-                arrived_at: Date.parse(undispatched.arrived_at),
+        logger.info("undispatched_added", { id: undispatched.id, reason });
+        const wireReason = undispatched.reason === "unaddressed"
+            ? "no_target_endpoint"
+            : undispatched.reason;
+        const posted = await directPostUndispatched({
+            type: "undispatched_changed",
+            version: 1,
+            action: "add",
+            undispatched_id: undispatched.id,
+            ...(undispatched.source_message_id !== undefined && {
+                source_message_id: undispatched.source_message_id,
+            }),
+            sender_address: undispatched.sender_address,
+            content_preview: truncateContentPreview(undispatched.content, CONTENT_PREVIEW_MAX_CODEPOINTS),
+            reason: wireReason,
+            ...(undispatched.original_target_endpoint_id !== undefined && {
+                target_endpoint_id_hint: undispatched.original_target_endpoint_id,
+            }),
+            ...(typeof correlation_id === "string" && {
+                in_reply_to: correlation_id,
+            }),
+            arrived_at: Date.parse(undispatched.arrived_at),
+        }, { queueOnTransientFailure: typeof payload.seq !== "number" });
+        if (!posted)
+            return false;
+        return markDeliverySeqAccepted(payload.seq);
+    };
+    connector.on("message_received", ({ payload }) => {
+        let task;
+        task = handleInboundMessage(payload)
+            .then((accepted) => {
+            if (typeof payload.seq === "number") {
+                if (accepted)
+                    blockedInboundSeqs.delete(payload.seq);
+                else
+                    blockedInboundSeqs.add(payload.seq);
+                return;
+            }
+            if (accepted)
+                unsequencedInboundBlocked = false;
+            else
+                unsequencedInboundBlocked = true;
+        })
+            .catch((err) => {
+            if (typeof payload.seq === "number") {
+                blockedInboundSeqs.add(payload.seq);
+            }
+            else {
+                unsequencedInboundBlocked = true;
+            }
+            logger.error("inbound_message_handling_failed", {
+                err: err instanceof Error ? err.message : String(err),
+                messageId: payload.messageId,
+                from: payload.from,
             });
-        }
+        })
+            .finally(() => {
+            inboundProcessing.delete(task);
+        });
+        inboundProcessing.add(task);
     });
-    connector.on("delivery_pending", ({ payload }) => {
+    connector.on("delivery_pending", async ({ payload }) => {
+        if (inboundProcessing.size > 0) {
+            await Promise.allSettled([...inboundProcessing]);
+        }
+        if (unsequencedInboundBlocked || blockedInboundSeqs.size > 0) {
+            logger.warn("delivery_ack_deferred_until_replay", {
+                upTo: payload.upTo,
+                count: payload.count,
+                blockedSeqs: [...blockedInboundSeqs].sort((a, b) => a - b),
+                unsequencedBlocked: unsequencedInboundBlocked,
+            });
+            return;
+        }
         connector.ackDelivery(payload.upTo);
     });
     writeDiscoveryFile(paths.discoveryFile, {
@@ -887,6 +1074,13 @@ export async function startBrokerDaemon(opts) {
             });
         }
         await networkPresenceEmitter.shutdown();
+        if (runtimeInboundRoutedEmitter.size() > 0) {
+            logger.warn("runtime_inbound_routed_queue_dropped_on_shutdown", {
+                size: runtimeInboundRoutedEmitter.size(),
+                reason,
+            });
+        }
+        await runtimeInboundRoutedEmitter.shutdown();
         const endpoints = registry.list();
         await Promise.all(endpoints.map(async (entry) => {
             try {
@@ -923,6 +1117,7 @@ export async function startBrokerDaemon(opts) {
         retryQueueSize: () => retryQueue.size(),
         undispatchedChangedQueueSize: () => undispatchedEmitter.size(),
         networkPresenceChangedQueueSize: () => networkPresenceEmitter.size(),
+        runtimeInboundRoutedQueueSize: () => runtimeInboundRoutedEmitter.size(),
         replyCorrelationCacheSize: (endpoint_id) => replyCorrelationCache.sizeForEndpoint(endpoint_id),
     };
 }

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

@@ -38,6 +38,10 @@ export declare class ConnectorWS {
     disconnect(): void;
     send(to: string, content: string, contentType?: string, metadata?: Record<string, unknown>): Promise<SendAckEvent>;
     ackDelivery(upTo: string): boolean;
+    setDeliveryCursor(seq: number): void;
+    getDeliveryCursor(): number | undefined;
+    prepareDeliverySeqAccepted(seq: number): number | undefined;
+    markDeliverySeqAccepted(seq: number): number | undefined;
     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;

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

@@ -1 +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"}
+{"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;IAKlC,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKpC,iBAAiB,IAAI,MAAM,GAAG,SAAS;IAKvC,0BAA0B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK3D,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIxD,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

@@ -19,6 +19,18 @@ export class ConnectorWS {
     ackDelivery(upTo) {
         return this.client.ackDelivery(upTo);
     }
+    setDeliveryCursor(seq) {
+        this.client.setDeliveryCursor(seq);
+    }
+    getDeliveryCursor() {
+        return this.client.getDeliveryCursor();
+    }
+    prepareDeliverySeqAccepted(seq) {
+        return this.client.prepareDeliverySeqAccepted(seq);
+    }
+    markDeliverySeqAccepted(seq) {
+        return this.client.markDeliverySeqAccepted(seq);
+    }
     on(event, listener) {
         this.bus.on(event, listener);
         return this;

package/dist/broker/delivery-cursor-file.d.ts

@@ -0,0 +1,8 @@
+export interface DeliveryCursorRecord {
+    version: 1;
+    lastKnownSeq: number;
+    updatedAt: string;
+}
+export declare function readDeliveryCursorFile(path: string): number | null;
+export declare function writeDeliveryCursorFile(path: string, seq: number): void;
+//# sourceMappingURL=delivery-cursor-file.d.ts.map

package/dist/broker/delivery-cursor-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-cursor-file.d.ts","sourceRoot":"","sources":["../../src/broker/delivery-cursor-file.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBlE;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAiCvE"}

package/dist/broker/delivery-cursor-file.js

@@ -0,0 +1,71 @@
+import { randomBytes } from "node:crypto";
+import { chmodSync, mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname } from "node:path";
+export function readDeliveryCursorFile(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 (!isDeliveryCursorRecord(parsed))
+            return null;
+        return parsed.lastKnownSeq;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeDeliveryCursorFile(path, seq) {
+    if (!Number.isInteger(seq) || seq < 0) {
+        throw new Error(`delivery cursor must be a non-negative integer: ${seq}`);
+    }
+    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
+    const tmp = `${path}.tmp.${process.pid}.${randomBytes(4).toString("hex")}`;
+    const record = {
+        version: 1,
+        lastKnownSeq: seq,
+        updatedAt: new Date().toISOString(),
+    };
+    writeFileSync(tmp, JSON.stringify(record, null, 2), {
+        mode: 0o600,
+        encoding: "utf8",
+    });
+    try {
+        chmodSync(tmp, 0o600);
+    }
+    catch {
+    }
+    try {
+        renameSync(tmp, path);
+    }
+    catch (err) {
+        try {
+            unlinkSync(tmp);
+        }
+        catch {
+        }
+        throw err;
+    }
+}
+function isDeliveryCursorRecord(value) {
+    if (typeof value !== "object" || value === null)
+        return false;
+    const v = value;
+    return (v.version === 1 &&
+        typeof v.lastKnownSeq === "number" &&
+        Number.isInteger(v.lastKnownSeq) &&
+        v.lastKnownSeq >= 0 &&
+        typeof v.updatedAt === "string");
+}
+function isNodeErr(err, code) {
+    return (typeof err === "object" &&
+        err !== null &&
+        "code" in err &&
+        err.code === code);
+}

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

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/broker/entry.ts"],"names":[],"mappings":"AAgFA,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,CAgHrB;AAYD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgG1C"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/broker/entry.ts"],"names":[],"mappings":"AAiFA,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,CAuHrB;AAYD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAgG1C"}

package/dist/broker/entry.js

@@ -2,7 +2,7 @@ import { readFile } from "node:fs/promises";
 import { pathToFileURL } from "node:url";
 import { readConfig } from "../config-fs.js";
 import { DEFAULT_API_HOST } from "../platform-client.js";
-import { emitRuntimeNetworkPresenceChanged, emitRuntimeUndispatchedChanged, heartbeatRuntimeEndpoint, registerRuntimeEndpoint, transitionRuntimeEndpointState, unregisterRuntimeEndpoint, updateRuntimeEndpointDisplayMetadata, } from "../runtime-endpoint-client.js";
+import { emitRuntimeNetworkPresenceChanged, emitRuntimeInboundRouted, emitRuntimeUndispatchedChanged, heartbeatRuntimeEndpoint, registerRuntimeEndpoint, transitionRuntimeEndpointState, unregisterRuntimeEndpoint, updateRuntimeEndpointDisplayMetadata, } from "../runtime-endpoint-client.js";
 import { startBrokerDaemon } from "./broker-daemon.js";
 import { ClaudeCodeSpawnDriver } from "./claude-code-spawn-driver.js";
 import { CodexSpawnDriverStub } from "./codex-spawn-driver-stub.js";
@@ -171,6 +171,9 @@ export function buildApiPort(apiHost, runtimeKey, logger) {
         async emitNetworkPresenceChanged(event) {
             return emitRuntimeNetworkPresenceChanged({ apiHost }, runtimeKey, event);
         },
+        async emitRuntimeInboundRouted(event) {
+            return emitRuntimeInboundRouted({ apiHost }, runtimeKey, event);
+        },
     };
 }
 function errorStatus(err) {

package/dist/broker/ipc-server.d.ts

@@ -68,13 +68,14 @@ export interface RunningIPCServer {
     close(): Promise<void>;
 }
 export declare function startIPCServer(opts: IPCServerOptions): Promise<RunningIPCServer>;
-export declare function pushToPlugin(ws: WebSocket, event: PushEvent): void;
+export declare function pushToPlugin(ws: WebSocket, event: PushEvent): boolean;
 export type PushEvent = {
     event: "message_received";
     from: string;
     content: string;
     contentType: string;
     metadata?: Record<string, unknown>;
+    sourceMessageId?: string;
 } | {
     event: "ping";
     ts: string;

package/dist/broker/ipc-server.d.ts.map

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

package/dist/broker/ipc-server.js

@@ -274,8 +274,9 @@ async function closeServer(http, wss) {
 }
 export function pushToPlugin(ws, event) {
     if (ws.readyState !== WebSocket.OPEN)
-        return;
+        return false;
     ws.send(JSON.stringify(event));
+    return true;
 }
 export function parsePluginFrame(data) {
     try {