@masons/agent-network 0.5.32 → 0.5.322

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

@@ -7,11 +7,13 @@ 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;
@@ -35,6 +37,18 @@ export interface BrokerDaemonOptions {
         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;
@@ -47,6 +61,9 @@ export interface RunningBroker {
     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;

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

@@ -7,12 +7,16 @@ import { DEFAULT_GRACE_MS, transition, } from "./endpoint-state-machine.js";
 import { createGraceTimerManager } from "./grace-timer.js";
 import { BrokerHttpError, pushToPlugin, startIPCServer, } from "./ipc-server.js";
 import { transitionPresence, } from "./network-presence.js";
+import { createNetworkPresenceEmitter, postNetworkPresenceChangedViaPort, } from "./network-presence-emitter.js";
 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 { 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";
 export async function startBrokerDaemon(opts) {
     const { paths, asNodeId: _asNodeIdReservedForA3, connector, apiPort, logger, closedEndpointLookup, livenessProbe = defaultIsPluginAlive, spawnDriverRegistry, spawnFn = spawnChild, servicesEventClientFactory, } = opts;
@@ -55,6 +59,46 @@ export async function startBrokerDaemon(opts) {
             });
         },
     });
+    const replyCorrelationCache = createReceivedMessageCorrelationCache({
+        ttlMs: opts.replyCorrelationTtlMs,
+        capPerEndpoint: opts.replyCorrelationCapPerEndpoint,
+    });
+    const replyCorrelationTtl = opts.replyCorrelationTtlMs ?? DEFAULT_REPLY_CORRELATION_TTL_MS;
+    const replyCorrelationSweepInterval = Math.max(Math.floor(replyCorrelationTtl / 4), 60_000);
+    const replyCorrelationSweepTimer = setInterval(() => {
+        const evicted = replyCorrelationCache.sweep();
+        if (evicted > 0) {
+            logger.info("reply_correlation_cache_sweep", { evicted });
+        }
+    }, replyCorrelationSweepInterval);
+    replyCorrelationSweepTimer.unref?.();
+    const undispatchedEmitter = createUndispatchedChangedEmitter(opts.undispatchedChangedPost ?? postUndispatchedChangedViaPort(apiPort), logger, {
+        capacity: opts.undispatchedChangedCapacity,
+        backoffInitialMs: opts.undispatchedChangedBackoffInitialMs,
+        backoffMaxMs: opts.undispatchedChangedBackoffMaxMs,
+        maxRetries: opts.undispatchedChangedMaxRetries,
+    });
+    const emitUndispatched = (event) => {
+        undispatchedEmitter.enqueue(event);
+    };
+    const networkPresenceEmitter = createNetworkPresenceEmitter(opts.networkPresenceChangedPost ??
+        postNetworkPresenceChangedViaPort(apiPort), logger, {
+        capacity: opts.networkPresenceChangedCapacity,
+        backoffInitialMs: opts.networkPresenceChangedBackoffInitialMs,
+        backoffMaxMs: opts.networkPresenceChangedBackoffMaxMs,
+        maxRetries: opts.networkPresenceChangedMaxRetries,
+    });
+    const emitNetworkPresence = (event) => {
+        networkPresenceEmitter.enqueue(event);
+    };
+    const recordInboundCorrelation = (endpoint_id, metadata) => {
+        const c = metadata && typeof metadata.correlation_id === "string"
+            ? metadata.correlation_id
+            : undefined;
+        if (!c)
+            return;
+        replyCorrelationCache.record(endpoint_id, c);
+    };
     let networkPresence = "offline";
     let presenceGraceTimer;
     const applyPresenceTransition = (event) => {
@@ -85,6 +129,13 @@ export async function startBrokerDaemon(opts) {
                         presence: effect.presence,
                         reason: effect.reason,
                     });
+                    emitNetworkPresence({
+                        type: "network_presence_changed",
+                        version: 1,
+                        state: effect.presence,
+                        ts: Date.now(),
+                        reason: effect.reason,
+                    });
                     if (effect.presence === "online") {
                         void retryQueue.flush(async (entry) => {
                             await apiPort.transitionState(entry.endpoint_id, entry.params);
@@ -175,6 +226,7 @@ export async function startBrokerDaemon(opts) {
                     break;
                 case "remove_from_registry":
                     registry.unregister(endpoint_id);
+                    replyCorrelationCache.forgetEndpoint(endpoint_id);
                     void apiPort.unregister(endpoint_id).catch(() => {
                     });
                     break;
@@ -199,6 +251,13 @@ export async function startBrokerDaemon(opts) {
                     inbox_size: undispatchedInbox.size(),
                     inbox_capacity: undispatchedInbox.capacity(),
                 });
+                emitUndispatched({
+                    type: "undispatched_changed",
+                    version: 1,
+                    action: "remove",
+                    undispatched_id: event.undispatched_id,
+                    remove_reason: "lost_at_capacity_during_redispatch_bounce",
+                });
             }
             return {
                 ok: false,
@@ -216,6 +275,7 @@ export async function startBrokerDaemon(opts) {
                 dispatched_by: "passport",
             },
         };
+        recordInboundCorrelation(target.endpoint_id, stamped.metadata);
         if (target.state === "active") {
             pushToPlugin(target.ipc_ws, stamped);
         }
@@ -237,6 +297,13 @@ export async function startBrokerDaemon(opts) {
             target_endpoint_id: event.target_endpoint_id,
             target_state: target.state,
         });
+        emitUndispatched({
+            type: "undispatched_changed",
+            version: 1,
+            action: "dispatch",
+            undispatched_id: event.undispatched_id,
+            dispatched_to_endpoint_id: event.target_endpoint_id,
+        });
         return { ok: true };
     });
     controlEventDispatcher.on("spawn_request", async (event) => {
@@ -413,7 +480,27 @@ export async function startBrokerDaemon(opts) {
                 incoming.source_endpoint_id !== body.endpoint_id) {
                 throw new BrokerHttpError(403, "source_endpoint_id_mismatch", "metadata.source_endpoint_id must equal body.endpoint_id");
             }
-            const correlationId = randomUUID();
+            const inReplyTo = typeof incoming.in_reply_to === "string"
+                ? incoming.in_reply_to
+                : undefined;
+            let correlationId;
+            if (inReplyTo) {
+                const resolved = replyCorrelationCache.resolve(body.endpoint_id, inReplyTo);
+                if (resolved.ok) {
+                    correlationId = inReplyTo;
+                }
+                else {
+                    logger.warn("reply_aware_fallback", {
+                        endpoint_id: body.endpoint_id,
+                        in_reply_to: inReplyTo,
+                        reason: resolved.reason,
+                    });
+                    correlationId = randomUUID();
+                }
+            }
+            else {
+                correlationId = randomUUID();
+            }
             entry.correlation_ring.add(correlationId);
             const metadata = {
                 ...incoming,
@@ -547,6 +634,7 @@ 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") {
+            recordInboundCorrelation(decision.entry.endpoint_id, meta);
             if (decision.entry.state === "active") {
                 pushToPlugin(decision.entry.ipc_ws, {
                     event: "message_received",
@@ -613,6 +701,25 @@ export async function startBrokerDaemon(opts) {
         }
         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),
+            });
         }
     });
     connector.on("delivery_pending", ({ payload }) => {
@@ -660,12 +767,27 @@ export async function startBrokerDaemon(opts) {
             clearTimeout(presenceGraceTimer);
             presenceGraceTimer = undefined;
         }
+        clearInterval(replyCorrelationSweepTimer);
         if (retryQueue.size() > 0) {
             logger.warn("retry_queue_dropped_on_shutdown", {
                 size: retryQueue.size(),
                 reason,
             });
         }
+        if (undispatchedEmitter.size() > 0) {
+            logger.warn("undispatched_changed_queue_dropped_on_shutdown", {
+                size: undispatchedEmitter.size(),
+                reason,
+            });
+        }
+        await undispatchedEmitter.shutdown();
+        if (networkPresenceEmitter.size() > 0) {
+            logger.warn("network_presence_changed_queue_dropped_on_shutdown", {
+                size: networkPresenceEmitter.size(),
+                reason,
+            });
+        }
+        await networkPresenceEmitter.shutdown();
         const endpoints = registry.list();
         await Promise.all(endpoints.map(async (entry) => {
             try {
@@ -700,6 +822,9 @@ export async function startBrokerDaemon(opts) {
         networkPresence: () => networkPresence,
         pendingSpawnCount: () => spawnCorrelation.size(),
         retryQueueSize: () => retryQueue.size(),
+        undispatchedChangedQueueSize: () => undispatchedEmitter.size(),
+        networkPresenceChangedQueueSize: () => networkPresenceEmitter.size(),
+        replyCorrelationCacheSize: (endpoint_id) => replyCorrelationCache.sizeForEndpoint(endpoint_id),
     };
 }
 export function readPluginPidHeader(req) {

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

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/broker/entry.ts"],"names":[],"mappings":"AA6EA,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;AAUD,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA8F9B;AAyDD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,mBAAmB,CAkErB;AAYD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA8F1C"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../../src/broker/entry.ts"],"names":[],"mappings":"AA+EA,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;AAUD,wBAAsB,0BAA0B,CAC9C,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,GAAG,SAAS,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CA8F9B;AAyDD,wBAAgB,YAAY,CAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,YAAY,GACnB,mBAAmB,CAwGrB;AAYD,wBAAsB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CA8F1C"}

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 { heartbeatRuntimeEndpoint, registerRuntimeEndpoint, transitionRuntimeEndpointState, unregisterRuntimeEndpoint, } from "../runtime-endpoint-client.js";
+import { emitRuntimeNetworkPresenceChanged, emitRuntimeUndispatchedChanged, heartbeatRuntimeEndpoint, registerRuntimeEndpoint, transitionRuntimeEndpointState, unregisterRuntimeEndpoint, } 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";
@@ -132,6 +132,12 @@ export function buildApiPort(apiHost, runtimeKey, logger) {
                 }
             }
         },
+        async emitUndispatchedChanged(event) {
+            return emitRuntimeUndispatchedChanged({ apiHost }, runtimeKey, event);
+        },
+        async emitNetworkPresenceChanged(event) {
+            return emitRuntimeNetworkPresenceChanged({ apiHost }, runtimeKey, event);
+        },
     };
 }
 function errorStatus(err) {

package/dist/broker/network-presence-changed-event-types.d.ts

@@ -0,0 +1,8 @@
+export interface NetworkPresenceChangedEvent {
+    type: "network_presence_changed";
+    version: 1;
+    state: "online" | "reconnecting" | "offline";
+    ts: number;
+    reason?: string;
+}
+//# sourceMappingURL=network-presence-changed-event-types.d.ts.map

package/dist/broker/network-presence-changed-event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-presence-changed-event-types.d.ts","sourceRoot":"","sources":["../../src/broker/network-presence-changed-event-types.ts"],"names":[],"mappings":"AAqCA,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,0BAA0B,CAAC;IAGjC,OAAO,EAAE,CAAC,CAAC;IAEX,KAAK,EAAE,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;IAG7C,EAAE,EAAE,MAAM,CAAC;IAMX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/broker/network-presence-changed-event-types.js

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

package/dist/broker/network-presence-emitter.d.ts

@@ -0,0 +1,22 @@
+import type { BrokerLogger } from "./logger.js";
+import type { NetworkPresenceChangedEvent } from "./network-presence-changed-event-types.js";
+import type { EmitOutcome, RuntimeEndpointPort } from "./runtime-endpoint-port.js";
+export declare const DEFAULT_PRESENCE_EMITTER_CAPACITY = 128;
+export declare const DEFAULT_PRESENCE_EMITTER_BACKOFF_INITIAL_MS = 500;
+export declare const DEFAULT_PRESENCE_EMITTER_BACKOFF_MAX_MS = 30000;
+export declare const DEFAULT_PRESENCE_EMITTER_MAX_RETRIES = 5;
+export interface NetworkPresenceEmitterOptions {
+    capacity?: number;
+    backoffInitialMs?: number;
+    backoffMaxMs?: number;
+    maxRetries?: number;
+}
+export interface NetworkPresenceEmitter {
+    enqueue(event: NetworkPresenceChangedEvent): boolean;
+    size(): number;
+    capacity(): number;
+    shutdown(): Promise<void>;
+}
+export declare function createNetworkPresenceEmitter(post: (event: NetworkPresenceChangedEvent) => Promise<EmitOutcome>, logger: BrokerLogger, opts?: NetworkPresenceEmitterOptions): NetworkPresenceEmitter;
+export declare function postNetworkPresenceChangedViaPort(apiPort: RuntimeEndpointPort): (event: NetworkPresenceChangedEvent) => Promise<EmitOutcome>;
+//# sourceMappingURL=network-presence-emitter.d.ts.map

package/dist/broker/network-presence-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"network-presence-emitter.d.ts","sourceRoot":"","sources":["../../src/broker/network-presence-emitter.ts"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AAEpC,eAAO,MAAM,iCAAiC,MAAM,CAAC;AACrD,eAAO,MAAM,2CAA2C,MAAM,CAAC;AAC/D,eAAO,MAAM,uCAAuC,QAAS,CAAC;AAC9D,eAAO,MAAM,oCAAoC,IAAI,CAAC;AAEtD,MAAM,WAAW,6BAA6B;IAE5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IAIrC,OAAO,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC;IAErD,IAAI,IAAI,MAAM,CAAC;IAEf,QAAQ,IAAI,MAAM,CAAC;IAGnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,CAAC,KAAK,EAAE,2BAA2B,KAAK,OAAO,CAAC,WAAW,CAAC,EAClE,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,6BAAkC,GACvC,sBAAsB,CAyIxB;AAcD,wBAAgB,iCAAiC,CAC/C,OAAO,EAAE,mBAAmB,GAC3B,CAAC,KAAK,EAAE,2BAA2B,KAAK,OAAO,CAAC,WAAW,CAAC,CAW9D"}

package/dist/broker/network-presence-emitter.js

@@ -0,0 +1,150 @@
+export const DEFAULT_PRESENCE_EMITTER_CAPACITY = 128;
+export const DEFAULT_PRESENCE_EMITTER_BACKOFF_INITIAL_MS = 500;
+export const DEFAULT_PRESENCE_EMITTER_BACKOFF_MAX_MS = 30_000;
+export const DEFAULT_PRESENCE_EMITTER_MAX_RETRIES = 5;
+export function createNetworkPresenceEmitter(post, logger, opts = {}) {
+    const cap = opts.capacity ?? DEFAULT_PRESENCE_EMITTER_CAPACITY;
+    const initialBackoff = opts.backoffInitialMs ?? DEFAULT_PRESENCE_EMITTER_BACKOFF_INITIAL_MS;
+    const maxBackoff = opts.backoffMaxMs ?? DEFAULT_PRESENCE_EMITTER_BACKOFF_MAX_MS;
+    const maxRetries = opts.maxRetries ?? DEFAULT_PRESENCE_EMITTER_MAX_RETRIES;
+    if (cap <= 0)
+        throw new Error(`capacity must be positive: ${cap}`);
+    if (initialBackoff <= 0)
+        throw new Error(`backoffInitialMs must be positive: ${initialBackoff}`);
+    if (maxBackoff < initialBackoff)
+        throw new Error(`backoffMaxMs must be >= backoffInitialMs`);
+    if (maxRetries < 0)
+        throw new Error(`maxRetries must be non-negative: ${maxRetries}`);
+    const queue = [];
+    let draining = false;
+    let stopped = false;
+    let activeDrain = null;
+    let wakeSleep = null;
+    const sleep = (ms) => new Promise((resolve) => {
+        const t = setTimeout(() => {
+            wakeSleep = null;
+            resolve();
+        }, ms);
+        t.unref?.();
+        wakeSleep = () => {
+            clearTimeout(t);
+            wakeSleep = null;
+            resolve();
+        };
+    });
+    const drain = async () => {
+        while (!stopped && queue.length > 0) {
+            const event = queue[0];
+            if (!event)
+                break;
+            let attempts = 0;
+            while (true) {
+                if (stopped)
+                    return;
+                let outcome;
+                try {
+                    outcome = await post(event);
+                }
+                catch (err) {
+                    outcome = {
+                        ok: false,
+                        terminal: false,
+                        detail: err instanceof Error ? err.message : String(err),
+                    };
+                }
+                if (outcome.ok)
+                    break;
+                if (outcome.terminal) {
+                    logger.warn("network_presence_changed_drop_terminal", {
+                        state: event.state,
+                        ts: event.ts,
+                        reason: event.reason,
+                        status: outcome.status,
+                        detail: outcome.detail,
+                    });
+                    break;
+                }
+                attempts++;
+                if (attempts > maxRetries) {
+                    logger.warn("network_presence_changed_drop_max_retries", {
+                        state: event.state,
+                        ts: event.ts,
+                        attempts,
+                        status: outcome.status,
+                        detail: outcome.detail,
+                    });
+                    break;
+                }
+                const backoff = Math.min(initialBackoff * 2 ** (attempts - 1), maxBackoff);
+                logger.info("network_presence_changed_retry", {
+                    state: event.state,
+                    ts: event.ts,
+                    attempt: attempts,
+                    backoff_ms: backoff,
+                    status: outcome.status,
+                });
+                await sleep(backoff);
+            }
+            queue.shift();
+        }
+        draining = false;
+    };
+    const kick = () => {
+        if (draining || stopped)
+            return;
+        draining = true;
+        activeDrain = drain().catch((err) => {
+            logger.error("network_presence_changed_drain_unexpected_error", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+            draining = false;
+        });
+    };
+    return {
+        enqueue(event) {
+            if (stopped)
+                return true;
+            let evicted = false;
+            if (queue.length >= cap) {
+                const old = queue.shift();
+                if (old) {
+                    logger.warn("network_presence_changed_queue_overflow", {
+                        dropped_state: old.state,
+                        dropped_ts: old.ts,
+                        size: queue.length,
+                        capacity: cap,
+                    });
+                    evicted = true;
+                }
+            }
+            queue.push(event);
+            kick();
+            return !evicted;
+        },
+        size() {
+            return queue.length;
+        },
+        capacity() {
+            return cap;
+        },
+        async shutdown() {
+            stopped = true;
+            wakeSleep?.();
+            if (activeDrain) {
+                await activeDrain.catch(() => { });
+            }
+        },
+    };
+}
+export function postNetworkPresenceChangedViaPort(apiPort) {
+    return async (event) => {
+        if (!apiPort.emitNetworkPresenceChanged) {
+            return {
+                ok: false,
+                terminal: true,
+                detail: "emitNetworkPresenceChanged not implemented on this apiPort",
+            };
+        }
+        return apiPort.emitNetworkPresenceChanged(event);
+    };
+}

package/dist/broker/network-presence.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"network-presence.d.ts","sourceRoot":"","sources":["../../src/broker/network-presence.ts"],"names":[],"mappings":"AA8BA,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,yBAA8B,GACnC,wBAAwB,CAgH1B"}
+{"version":3,"file":"network-presence.d.ts","sourceRoot":"","sources":["../../src/broker/network-presence.ts"],"names":[],"mappings":"AAmCA,eAAO,MAAM,yBAAyB,QAAiB,CAAC;AAExD,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,cAAc,GAAG,SAAS,CAAC;AAEpE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,qBAAqB,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,wBAAwB,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,CAAC;AAEzB,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,oBAAoB,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAOD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,eAAe,EACxB,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,yBAA8B,GACnC,wBAAwB,CAgH1B"}

package/dist/broker/received-message-correlation-cache.d.ts

@@ -0,0 +1,23 @@
+export declare const DEFAULT_TTL_MS = 86400000;
+export declare const DEFAULT_CAP_PER_ENDPOINT = 1000;
+export interface ReceivedMessageCorrelationCacheOptions {
+    ttlMs?: number;
+    capPerEndpoint?: number;
+    now?: () => number;
+}
+export type ReplyAwareResolve = {
+    ok: true;
+} | {
+    ok: false;
+    reason: "unknown_correlation_id" | "wrong_endpoint" | "ttl_expired";
+};
+export interface ReceivedMessageCorrelationCache {
+    record(endpoint_id: string, correlation_id: string): void;
+    resolve(endpoint_id: string, correlation_id: string): ReplyAwareResolve;
+    size(): number;
+    sizeForEndpoint(endpoint_id: string): number;
+    sweep(now?: number): number;
+    forgetEndpoint(endpoint_id: string): void;
+}
+export declare function createReceivedMessageCorrelationCache(opts?: ReceivedMessageCorrelationCacheOptions): ReceivedMessageCorrelationCache;
+//# sourceMappingURL=received-message-correlation-cache.d.ts.map

package/dist/broker/received-message-correlation-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"received-message-correlation-cache.d.ts","sourceRoot":"","sources":["../../src/broker/received-message-correlation-cache.ts"],"names":[],"mappings":"AA8DA,eAAO,MAAM,cAAc,WAAa,CAAC;AAGzC,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C,MAAM,WAAW,sCAAsC;IAErD,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IACE,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,wBAAwB,GAAG,gBAAgB,GAAG,aAAa,CAAC;CACrE,CAAC;AAMN,MAAM,WAAW,+BAA+B;IAa9C,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAQ1D,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAGxE,IAAI,IAAI,MAAM,CAAC;IAGf,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAAC;IAQ7C,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAM5B,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3C;AAED,wBAAgB,qCAAqC,CACnD,IAAI,GAAE,sCAA2C,GAChD,+BAA+B,CAgIjC"}

package/dist/broker/received-message-correlation-cache.js

@@ -0,0 +1,114 @@
+export const DEFAULT_TTL_MS = 86_400_000;
+export const DEFAULT_CAP_PER_ENDPOINT = 1000;
+export function createReceivedMessageCorrelationCache(opts = {}) {
+    const ttlMs = opts.ttlMs ?? DEFAULT_TTL_MS;
+    const cap = opts.capPerEndpoint ?? DEFAULT_CAP_PER_ENDPOINT;
+    const clock = opts.now ?? Date.now;
+    if (ttlMs <= 0)
+        throw new Error(`ttlMs must be positive: ${ttlMs}`);
+    if (cap <= 0)
+        throw new Error(`capPerEndpoint must be positive: ${cap}`);
+    const perEndpoint = new Map();
+    const correlationOwner = new Map();
+    const evict = (endpoint_id, correlation_id) => {
+        const inner = perEndpoint.get(endpoint_id);
+        if (!inner)
+            return;
+        inner.delete(correlation_id);
+        if (inner.size === 0)
+            perEndpoint.delete(endpoint_id);
+        if (correlationOwner.get(correlation_id) === endpoint_id) {
+            correlationOwner.delete(correlation_id);
+        }
+    };
+    return {
+        record(endpoint_id, correlation_id) {
+            const priorOwner = correlationOwner.get(correlation_id);
+            if (priorOwner && priorOwner !== endpoint_id) {
+                const priorInner = perEndpoint.get(priorOwner);
+                priorInner?.delete(correlation_id);
+                if (priorInner && priorInner.size === 0) {
+                    perEndpoint.delete(priorOwner);
+                }
+            }
+            let inner = perEndpoint.get(endpoint_id);
+            if (!inner) {
+                inner = new Map();
+                perEndpoint.set(endpoint_id, inner);
+            }
+            inner.delete(correlation_id);
+            inner.set(correlation_id, { received_at: clock() });
+            correlationOwner.set(correlation_id, endpoint_id);
+            while (inner.size > cap) {
+                const oldestKey = inner.keys().next().value;
+                if (oldestKey === undefined)
+                    break;
+                inner.delete(oldestKey);
+                if (correlationOwner.get(oldestKey) === endpoint_id) {
+                    correlationOwner.delete(oldestKey);
+                }
+            }
+        },
+        resolve(endpoint_id, correlation_id) {
+            const owner = correlationOwner.get(correlation_id);
+            if (!owner) {
+                return { ok: false, reason: "unknown_correlation_id" };
+            }
+            if (owner !== endpoint_id) {
+                return { ok: false, reason: "wrong_endpoint" };
+            }
+            const inner = perEndpoint.get(endpoint_id);
+            const entry = inner?.get(correlation_id);
+            if (!entry) {
+                correlationOwner.delete(correlation_id);
+                return { ok: false, reason: "unknown_correlation_id" };
+            }
+            if (clock() - entry.received_at >= ttlMs) {
+                evict(endpoint_id, correlation_id);
+                return { ok: false, reason: "ttl_expired" };
+            }
+            return { ok: true };
+        },
+        size() {
+            let total = 0;
+            for (const inner of perEndpoint.values())
+                total += inner.size;
+            return total;
+        },
+        sizeForEndpoint(endpoint_id) {
+            return perEndpoint.get(endpoint_id)?.size ?? 0;
+        },
+        sweep(now = clock()) {
+            let evicted = 0;
+            for (const [endpoint_id, inner] of perEndpoint) {
+                const expired = [];
+                for (const [correlation_id, entry] of inner) {
+                    if (now - entry.received_at >= ttlMs) {
+                        expired.push(correlation_id);
+                    }
+                }
+                for (const correlation_id of expired) {
+                    inner.delete(correlation_id);
+                    if (correlationOwner.get(correlation_id) === endpoint_id) {
+                        correlationOwner.delete(correlation_id);
+                    }
+                    evicted++;
+                }
+                if (inner.size === 0)
+                    perEndpoint.delete(endpoint_id);
+            }
+            return evicted;
+        },
+        forgetEndpoint(endpoint_id) {
+            const inner = perEndpoint.get(endpoint_id);
+            if (!inner)
+                return;
+            for (const correlation_id of inner.keys()) {
+                if (correlationOwner.get(correlation_id) === endpoint_id) {
+                    correlationOwner.delete(correlation_id);
+                }
+            }
+            perEndpoint.delete(endpoint_id);
+        },
+    };
+}

package/dist/broker/runtime-endpoint-port.d.ts

@@ -1,8 +1,20 @@
 import type { RegisterRuntimeEndpointParams, RegisterRuntimeEndpointResponse, TransitionRuntimeEndpointStateParams } from "../runtime-endpoint-client.js";
+import type { NetworkPresenceChangedEvent } from "./network-presence-changed-event-types.js";
+import type { UndispatchedChangedEvent } from "./undispatched-changed-event-types.js";
+export type EmitOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    terminal: boolean;
+    status?: number;
+    detail?: string;
+};
 export interface RuntimeEndpointPort {
     register(params: RegisterRuntimeEndpointParams): Promise<RegisterRuntimeEndpointResponse>;
     heartbeat(endpointId: string): Promise<void>;
     unregister(endpointId: string, asNodeId?: string): Promise<void>;
     transitionState(endpointId: string, params: TransitionRuntimeEndpointStateParams): Promise<void>;
+    emitUndispatchedChanged?(event: UndispatchedChangedEvent): Promise<EmitOutcome>;
+    emitNetworkPresenceChanged?(event: NetworkPresenceChangedEvent): Promise<EmitOutcome>;
 }
 //# sourceMappingURL=runtime-endpoint-port.d.ts.map

package/dist/broker/runtime-endpoint-port.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-endpoint-port.d.ts","sourceRoot":"","sources":["../../src/broker/runtime-endpoint-port.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,6BAA6B,EAC7B,+BAA+B,EAC/B,oCAAoC,EACrC,MAAM,+BAA+B,CAAC;AAEvC,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CACN,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC5C,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAO7C,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAQjE,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oCAAoC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB"}
+{"version":3,"file":"runtime-endpoint-port.d.ts","sourceRoot":"","sources":["../../src/broker/runtime-endpoint-port.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EACV,6BAA6B,EAC7B,+BAA+B,EAC/B,oCAAoC,EACrC,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,2CAA2C,CAAC;AAC7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAWtF,MAAM,MAAM,WAAW,GACnB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CACN,MAAM,EAAE,6BAA6B,GACpC,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC5C,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAO7C,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAQjE,eAAe,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,oCAAoC,GAC3C,OAAO,CAAC,IAAI,CAAC,CAAC;IAqBjB,uBAAuB,CAAC,CACtB,KAAK,EAAE,wBAAwB,GAC9B,OAAO,CAAC,WAAW,CAAC,CAAC;IAYxB,0BAA0B,CAAC,CACzB,KAAK,EAAE,2BAA2B,GACjC,OAAO,CAAC,WAAW,CAAC,CAAC;CACzB"}

package/dist/broker/undispatched-changed-event-types.d.ts

@@ -0,0 +1,29 @@
+export declare const CONTENT_PREVIEW_MAX_CODEPOINTS = 80;
+export type UndispatchedReason = "no_target_endpoint" | "closed_session_continuation";
+export type UndispatchedRemoveReason = "lost_at_capacity_during_redispatch_bounce";
+interface UndispatchedChangedEventBase {
+    type: "undispatched_changed";
+    version: 1;
+    undispatched_id: string;
+}
+export interface UndispatchedAddEvent extends UndispatchedChangedEventBase {
+    action: "add";
+    sender_address: string;
+    content_preview: string;
+    reason: UndispatchedReason;
+    target_endpoint_id_hint?: string;
+    in_reply_to?: string;
+    arrived_at: number;
+}
+export interface UndispatchedDispatchEvent extends UndispatchedChangedEventBase {
+    action: "dispatch";
+    dispatched_to_endpoint_id: string;
+}
+export interface UndispatchedRemoveEvent extends UndispatchedChangedEventBase {
+    action: "remove";
+    remove_reason: UndispatchedRemoveReason;
+}
+export type UndispatchedChangedEvent = UndispatchedAddEvent | UndispatchedDispatchEvent | UndispatchedRemoveEvent;
+export declare function truncateContentPreview(raw: string, n?: number): string;
+export {};
+//# sourceMappingURL=undispatched-changed-event-types.d.ts.map

package/dist/broker/undispatched-changed-event-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undispatched-changed-event-types.d.ts","sourceRoot":"","sources":["../../src/broker/undispatched-changed-event-types.ts"],"names":[],"mappings":"AA6BA,eAAO,MAAM,8BAA8B,KAAK,CAAC;AAMjD,MAAM,MAAM,kBAAkB,GAC1B,oBAAoB,GACpB,6BAA6B,CAAC;AAOlC,MAAM,MAAM,wBAAwB,GAWlC,2CAA2C,CAAC;AAG9C,UAAU,4BAA4B;IACpC,IAAI,EAAE,sBAAsB,CAAC;IAG7B,OAAO,EAAE,CAAC,CAAC;IAEX,eAAe,EAAE,MAAM,CAAC;CACzB;AAGD,MAAM,WAAW,oBAAqB,SAAQ,4BAA4B;IACxE,MAAM,EAAE,KAAK,CAAC;IAEd,cAAc,EAAE,MAAM,CAAC;IASvB,eAAe,EAAE,MAAM,CAAC;IAExB,MAAM,EAAE,kBAAkB,CAAC;IAO3B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAMjC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,yBACf,SAAQ,4BAA4B;IACpC,MAAM,EAAE,UAAU,CAAC;IAQnB,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAID,MAAM,WAAW,uBAAwB,SAAQ,4BAA4B;IAC3E,MAAM,EAAE,QAAQ,CAAC;IACjB,aAAa,EAAE,wBAAwB,CAAC;CACzC;AAED,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,yBAAyB,GACzB,uBAAuB,CAAC;AAqB5B,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,CAAC,GAAE,MAAuC,GACzC,MAAM,CAYR"}

package/dist/broker/undispatched-changed-event-types.js

@@ -0,0 +1,14 @@
+export const CONTENT_PREVIEW_MAX_CODEPOINTS = 80;
+export function truncateContentPreview(raw, n = CONTENT_PREVIEW_MAX_CODEPOINTS) {
+    if (raw.length <= n)
+        return raw;
+    let out = "";
+    let count = 0;
+    for (const cp of raw) {
+        if (count >= n)
+            break;
+        out += cp;
+        count++;
+    }
+    return out;
+}

package/dist/broker/undispatched-emitter.d.ts

@@ -0,0 +1,22 @@
+import type { BrokerLogger } from "./logger.js";
+import type { EmitOutcome, RuntimeEndpointPort } from "./runtime-endpoint-port.js";
+import type { UndispatchedChangedEvent } from "./undispatched-changed-event-types.js";
+export declare const DEFAULT_EMITTER_CAPACITY = 1024;
+export declare const DEFAULT_EMITTER_BACKOFF_INITIAL_MS = 500;
+export declare const DEFAULT_EMITTER_BACKOFF_MAX_MS = 30000;
+export declare const DEFAULT_EMITTER_MAX_RETRIES = 5;
+export interface UndispatchedChangedEmitterOptions {
+    capacity?: number;
+    backoffInitialMs?: number;
+    backoffMaxMs?: number;
+    maxRetries?: number;
+}
+export interface UndispatchedChangedEmitter {
+    enqueue(event: UndispatchedChangedEvent): boolean;
+    size(): number;
+    capacity(): number;
+    shutdown(): Promise<void>;
+}
+export declare function createUndispatchedChangedEmitter(post: (event: UndispatchedChangedEvent) => Promise<EmitOutcome>, logger: BrokerLogger, opts?: UndispatchedChangedEmitterOptions): UndispatchedChangedEmitter;
+export declare function postUndispatchedChangedViaPort(apiPort: RuntimeEndpointPort): (event: UndispatchedChangedEvent) => Promise<EmitOutcome>;
+//# sourceMappingURL=undispatched-emitter.d.ts.map

package/dist/broker/undispatched-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"undispatched-emitter.d.ts","sourceRoot":"","sources":["../../src/broker/undispatched-emitter.ts"],"names":[],"mappings":"AAwCA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACpB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AAEtF,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAC7C,eAAO,MAAM,kCAAkC,MAAM,CAAC;AACtD,eAAO,MAAM,8BAA8B,QAAS,CAAC;AACrD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,MAAM,WAAW,iCAAiC;IAEhD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA0B;IAIzC,OAAO,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC;IAElD,IAAI,IAAI,MAAM,CAAC;IAEf,QAAQ,IAAI,MAAM,CAAC;IAGnB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED,wBAAgB,gCAAgC,CAC9C,IAAI,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,WAAW,CAAC,EAC/D,MAAM,EAAE,YAAY,EACpB,IAAI,GAAE,iCAAsC,GAC3C,0BAA0B,CA8J5B;AAaD,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,CAAC,KAAK,EAAE,wBAAwB,KAAK,OAAO,CAAC,WAAW,CAAC,CAW3D"}

package/dist/broker/undispatched-emitter.js

@@ -0,0 +1,149 @@
+export const DEFAULT_EMITTER_CAPACITY = 1024;
+export const DEFAULT_EMITTER_BACKOFF_INITIAL_MS = 500;
+export const DEFAULT_EMITTER_BACKOFF_MAX_MS = 30_000;
+export const DEFAULT_EMITTER_MAX_RETRIES = 5;
+export function createUndispatchedChangedEmitter(post, logger, opts = {}) {
+    const cap = opts.capacity ?? DEFAULT_EMITTER_CAPACITY;
+    const initialBackoff = opts.backoffInitialMs ?? DEFAULT_EMITTER_BACKOFF_INITIAL_MS;
+    const maxBackoff = opts.backoffMaxMs ?? DEFAULT_EMITTER_BACKOFF_MAX_MS;
+    const maxRetries = opts.maxRetries ?? DEFAULT_EMITTER_MAX_RETRIES;
+    if (cap <= 0)
+        throw new Error(`capacity must be positive: ${cap}`);
+    if (initialBackoff <= 0)
+        throw new Error(`backoffInitialMs must be positive: ${initialBackoff}`);
+    if (maxBackoff < initialBackoff)
+        throw new Error(`backoffMaxMs must be >= backoffInitialMs`);
+    if (maxRetries < 0)
+        throw new Error(`maxRetries must be non-negative: ${maxRetries}`);
+    const queue = [];
+    let draining = false;
+    let stopped = false;
+    let activeDrain = null;
+    let wakeSleep = null;
+    const sleep = (ms) => new Promise((resolve) => {
+        const t = setTimeout(() => {
+            wakeSleep = null;
+            resolve();
+        }, ms);
+        t.unref?.();
+        wakeSleep = () => {
+            clearTimeout(t);
+            wakeSleep = null;
+            resolve();
+        };
+    });
+    const drain = async () => {
+        while (!stopped && queue.length > 0) {
+            const event = queue[0];
+            if (!event)
+                break;
+            let attempts = 0;
+            while (true) {
+                if (stopped)
+                    return;
+                let outcome;
+                try {
+                    outcome = await post(event);
+                }
+                catch (err) {
+                    outcome = {
+                        ok: false,
+                        terminal: false,
+                        detail: err instanceof Error ? err.message : String(err),
+                    };
+                }
+                if (outcome.ok)
+                    break;
+                if (outcome.terminal) {
+                    logger.warn("undispatched_changed_drop_terminal", {
+                        action: event.action,
+                        undispatched_id: event.undispatched_id,
+                        status: outcome.status,
+                        detail: outcome.detail,
+                    });
+                    break;
+                }
+                attempts++;
+                if (attempts > maxRetries) {
+                    logger.warn("undispatched_changed_drop_max_retries", {
+                        action: event.action,
+                        undispatched_id: event.undispatched_id,
+                        attempts,
+                        status: outcome.status,
+                        detail: outcome.detail,
+                    });
+                    break;
+                }
+                const backoff = Math.min(initialBackoff * 2 ** (attempts - 1), maxBackoff);
+                logger.info("undispatched_changed_retry", {
+                    action: event.action,
+                    undispatched_id: event.undispatched_id,
+                    attempt: attempts,
+                    backoff_ms: backoff,
+                    status: outcome.status,
+                });
+                await sleep(backoff);
+            }
+            queue.shift();
+        }
+        draining = false;
+    };
+    const kick = () => {
+        if (draining || stopped)
+            return;
+        draining = true;
+        activeDrain = drain().catch((err) => {
+            logger.error("undispatched_changed_drain_unexpected_error", {
+                err: err instanceof Error ? err.message : String(err),
+            });
+            draining = false;
+        });
+    };
+    return {
+        enqueue(event) {
+            if (stopped)
+                return true;
+            let evicted = false;
+            if (queue.length >= cap) {
+                const old = queue.shift();
+                if (old) {
+                    logger.warn("undispatched_changed_queue_overflow", {
+                        dropped_action: old.action,
+                        dropped_undispatched_id: old.undispatched_id,
+                        size: queue.length,
+                        capacity: cap,
+                    });
+                    evicted = true;
+                }
+            }
+            queue.push(event);
+            kick();
+            return !evicted;
+        },
+        size() {
+            return queue.length;
+        },
+        capacity() {
+            return cap;
+        },
+        async shutdown() {
+            stopped = true;
+            wakeSleep?.();
+            if (activeDrain) {
+                await activeDrain.catch(() => { });
+            }
+        },
+    };
+}
+export function postUndispatchedChangedViaPort(apiPort) {
+    return async (event) => {
+        if (!apiPort.emitUndispatchedChanged) {
+            return {
+                ok: false,
+                terminal: true,
+                detail: "emitUndispatchedChanged not implemented on this apiPort",
+            };
+        }
+        return apiPort.emitUndispatchedChanged(event);
+    };
+}

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

@@ -61,4 +61,14 @@ export declare function transitionRuntimeEndpointState(cfg: PlatformClientConfig
 export declare function unregisterRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId?: string): Promise<UnregisterRuntimeEndpointResponse>;
 export declare function listOwnedRuntimeEndpoints(cfg: PlatformClientConfig, runtimeKey: string, asNodeId: string): Promise<ListOwnedRuntimeEndpointsResponse>;
 export declare function getOwnedRuntimeEndpoint(cfg: PlatformClientConfig, runtimeKey: string, endpointId: string, asNodeId: string): Promise<OwnedRuntimeEndpointView>;
+export declare function emitRuntimeUndispatchedChanged(cfg: PlatformClientConfig, runtimeKey: string, event: Readonly<Record<string, unknown>>): Promise<EmitUndispatchedChangedOutcome>;
+export type EmitUndispatchedChangedOutcome = {
+    ok: true;
+} | {
+    ok: false;
+    terminal: boolean;
+    status?: number;
+    detail?: string;
+};
+export declare function emitRuntimeNetworkPresenceChanged(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

@@ -82,3 +82,82 @@ export async function getOwnedRuntimeEndpoint(cfg, runtimeKey, endpointId, asNod
         return handleError(res);
     return (await res.json());
 }
+export async function emitRuntimeUndispatchedChanged(cfg, runtimeKey, event) {
+    let res;
+    try {
+        res = await fetch(`${baseUrl(cfg)}/runtime/undispatched-changed`, {
+            method: "POST",
+            headers: jsonHeaders(runtimeKey),
+            body: JSON.stringify(event),
+        });
+    }
+    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 === 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 emitRuntimeNetworkPresenceChanged(cfg, runtimeKey, event) {
+    let res;
+    try {
+        res = await fetch(`${baseUrl(cfg)}/runtime/network-presence-changed`, {
+            method: "POST",
+            headers: jsonHeaders(runtimeKey),
+            body: JSON.stringify(event),
+        });
+    }
+    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 === 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),
+    };
+}
+async function readErrorDetail(res) {
+    try {
+        const body = (await res.json().catch(() => null));
+        if (!body)
+            return undefined;
+        const code = typeof body.error === "string" ? body.error : undefined;
+        const message = typeof body.message === "string" ? body.message : undefined;
+        return [code, message].filter(Boolean).join(": ") || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const PLUGIN_VERSION = "0.5.32";
+export declare const PLUGIN_VERSION = "0.5.322";
 //# 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,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,cAAc,YAAY,CAAC"}

package/dist/version.js

@@ -1 +1 @@
-export const PLUGIN_VERSION = "0.5.32";
+export const PLUGIN_VERSION = "0.5.322";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masons/agent-network",
-  "version": "0.5.32",
+  "version": "0.5.322",
   "description": "MASONS Agent Network — connects agent runtimes to the Agent Network over MSTP. Ships an OpenClaw channel plugin (root export) and subpath exports consumed by the Claude Code plugin today (planned: Codex and future hosts).",
   "license": "MIT",
   "author": "MASONS.ai <hello@masons.ai> (https://masons.ai)",