@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/streams/stream-session-runtime.js

@@ -2,11 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkStreamSessionNodeRuntime = exports.ZLinkStreamSessionRuntime = void 0;
 const framework_errors_internal_1 = require("../framework-errors-internal");
-const contracts_1 = require("../../contracts");
 const internal_event_contracts_1 = require("../diagnostics/internal-event-contracts");
 const ZLinkDispatchOptions_1 = require("../../contracts/Dispatch/ZLinkDispatchOptions");
 const abort_1 = require("../abort");
 const channels_1 = require("../channels");
+const bound_session_response_target_1 = require("./bound-session-response-target");
 const diagnostics_1 = require("../diagnostics");
 const payload_codec_1 = require("../messaging/payload-codec");
 const protocol_1 = require("./protocol");
@@ -122,12 +122,14 @@ class ZLinkStreamSessionRuntime {
             terminalOwner?.close();
         };
         if (decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Control) {
-            if ((0, protocol_1.messageToBytes)(payload).length === 0
-                && (decodedHeader.name === protocol_1.ZLINK_STREAM_HEARTBEAT_PONG
-                    || decodedHeader.name === protocol_1.ZLINK_STREAM_HEARTBEAT_PING)) {
-                void this.handleControl(decodedHeader, payload).catch(error => {
+            if ((0, protocol_1.messageToBytes)(payload).length === 0 &&
+                (decodedHeader.name === protocol_1.ZLINK_STREAM_HEARTBEAT_PONG ||
+                    decodedHeader.name === protocol_1.ZLINK_STREAM_HEARTBEAT_PING)) {
+                void this.handleControl(decodedHeader, payload)
+                    .catch((error) => {
                     this.options.onError?.(error);
-                }).finally(() => {
+                })
+                    .finally(() => {
                     applicationJobPermit?.releaseAfterInternalProcessing();
                     payload.close();
                     releaseTerminal();
@@ -152,8 +154,8 @@ class ZLinkStreamSessionRuntime {
             }, () => this.traceShutdownDrop(decodedHeader));
             return;
         }
-        if (decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Response
-            || decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Error) {
+        if (decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Response ||
+            decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Error) {
             this.enqueueInfrastructure(async () => {
                 try {
                     await this.dispatchPacket(payload, decodedHeader);
@@ -211,12 +213,12 @@ class ZLinkStreamSessionRuntime {
                 if (forcedClose)
                     return;
                 this.livenessClock.setTimer(() => {
-                    if (this.disposed
-                        || this.disconnected
-                        || !this.context.isExactRetiredActorBinding(actor, retiredSession)) {
+                    if (this.disposed ||
+                        this.disconnected ||
+                        !this.context.isExactRetiredActorBinding(actor, retiredSession)) {
                         return;
                     }
-                    void this.close().catch(error => this.options.onError?.(error));
+                    void this.close().catch((error) => this.options.onError?.(error));
                 }, ZLINK_STREAM_ACTOR_BINDING_REPLACEMENT_CLOSE_DELAY_MS);
             };
             const completeCallback = () => {
@@ -239,15 +241,14 @@ class ZLinkStreamSessionRuntime {
                 completeCallback();
             };
             callbackDeadlineTimer = this.livenessClock.setTimer(() => {
-                if (this.disposed
-                    || this.disconnected
-                    || !this.context.isExactRetiredActorBinding(actor, retiredSession)) {
+                if (this.disposed ||
+                    this.disconnected ||
+                    !this.context.isExactRetiredActorBinding(actor, retiredSession)) {
                     return;
                 }
                 forcedClose = true;
-                void this.close().catch(error => this.options.onError?.(error));
-            }, this.options.replacementCallbackTimeoutMs
-                ?? ZLINK_STREAM_ACTOR_BINDING_REPLACEMENT_CALLBACK_TIMEOUT_MS);
+                void this.close().catch((error) => this.options.onError?.(error));
+            }, this.options.replacementCallbackTimeoutMs ?? ZLINK_STREAM_ACTOR_BINDING_REPLACEMENT_CALLBACK_TIMEOUT_MS);
             const callback = session.onActorBindingReplaced;
             if (callback === undefined) {
                 completeCallback();
@@ -328,6 +329,40 @@ class ZLinkStreamSessionRuntime {
             if (this.context.tryCompleteResponse(decodedHeader, dispatchPayload)) {
                 return;
             }
+            const dispatchActor = this.context.actorForSlot(decodedHeader.actorSlot);
+            if (decodedHeader.actorSlot !== undefined && dispatchActor === undefined) {
+                const staleFlowEnabled = this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true;
+                await (0, flow_context_1.runWithFlow)((0, flow_context_1.createInboundFlow)(decodedHeader.flowId, decodedHeader.flowOrigin, staleFlowEnabled, staleFlowEnabled ? this.stream.sessionId : undefined), async () => {
+                    if (decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Request) {
+                        const error = (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.InvalidOperation, 'Actor slot is not a current binding.');
+                        this.options.dispatchErrors?.report({
+                            surface: ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.StreamSession,
+                            messageKind: ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Request,
+                            reason: ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.StaleTarget,
+                            action: ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorAction.ReplyError,
+                            packetName: decodedHeader.name,
+                            sourceRid: this.context.routingId === undefined ? undefined : String(this.context.routingId),
+                            correlationId: decodedHeader.correlationId,
+                            flowId: decodedHeader.flowId,
+                            flowOrigin: decodedHeader.flowOrigin,
+                            error
+                        });
+                        await this.replyDispatchError(decodedHeader, error);
+                    }
+                    else {
+                        (0, diagnostics_1.flowIfEnabled)(this.options.dispatchErrors?.flow, ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Dropped)?.trace({
+                            outcome: ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Dropped,
+                            surface: ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.StreamSession,
+                            messageKind: ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send,
+                            packetName: decodedHeader.name,
+                            correlationId: decodedHeader.correlationId,
+                            sourceRid: this.context.routingId === undefined ? undefined : String(this.context.routingId),
+                            errorReason: ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.StaleTarget
+                        });
+                    }
+                });
+                return;
+            }
             this.context.enterDispatch(decodedHeader);
             enteredDispatch = true;
             const session = await this.requireSession();
@@ -336,7 +371,8 @@ class ZLinkStreamSessionRuntime {
                 : ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send;
             const streamCorr = decodedHeader.correlationId;
             const inboundHeader = decodedHeader;
-            await (0, flow_context_1.runWithFlow)((0, flow_context_1.createInboundFlow)(inboundHeader.flowId, inboundHeader.flowOrigin, this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true), async () => {
+            const flowEnabled = this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true;
+            await (0, flow_context_1.runWithFlow)((0, flow_context_1.createInboundFlow)(inboundHeader.flowId, inboundHeader.flowOrigin, flowEnabled, flowEnabled ? this.stream.sessionId : undefined), async () => {
                 (0, diagnostics_1.flowIfEnabled)(this.options.dispatchErrors?.flow, ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Received)?.trace({
                     outcome: ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Received,
                     surface: ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.StreamSession,
@@ -362,7 +398,7 @@ class ZLinkStreamSessionRuntime {
                     correlationId: streamCorr,
                     sourceRid: this.context.routingId === undefined ? undefined : String(this.context.routingId)
                 });
-                await session.onDispatch?.((0, session_context_1.createSessionDispatchContext)(inboundHeader), (0, payload_codec_1.wrapFrameworkPayloadMessage)(dispatchPayload, this.options.messageSerializers, (0, protocol_1.streamCodecContentType)(inboundHeader.codec), inboundHeader.name));
+                await session.onDispatch?.((0, session_context_1.createSessionDispatchContext)(inboundHeader, dispatchActor), (0, payload_codec_1.wrapFrameworkPayloadMessage)(dispatchPayload, this.options.messageSerializers, (0, protocol_1.streamCodecContentType)(inboundHeader.codec), inboundHeader.name));
                 if (streamKind === ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send) {
                     (0, diagnostics_1.flowIfEnabled)(this.options.dispatchErrors?.flow, ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Completed)?.trace({
                         outcome: ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Completed,
@@ -429,7 +465,7 @@ class ZLinkStreamSessionRuntime {
         }
         this.livenessTimer = this.livenessClock.setTimer(() => {
             this.livenessTimer = undefined;
-            this.serial.executeInfrastructure(async () => this.runLivenessCheck(), {}, error => this.options.onError?.(error));
+            this.serial.executeInfrastructure(async () => this.runLivenessCheck(), {}, (error) => this.options.onError?.(error));
         }, ZLINK_STREAM_HEARTBEAT_INTERVAL_MS);
     }
     async runLivenessCheck() {
@@ -441,8 +477,8 @@ class ZLinkStreamSessionRuntime {
             await this.closeForLiveness(protocol_1.ZLinkStreamCloseReasonCode.IdleTimeout, 'idle_timeout', 'Application idle timeout.');
             return;
         }
-        if (this.awaitingPongSince !== undefined
-            && now - this.awaitingPongSince >= ZLINK_STREAM_HEARTBEAT_TIMEOUT_MS) {
+        if (this.awaitingPongSince !== undefined &&
+            now - this.awaitingPongSince >= ZLINK_STREAM_HEARTBEAT_TIMEOUT_MS) {
             await this.closeForLiveness(protocol_1.ZLinkStreamCloseReasonCode.HeartbeatTimeout, 'heartbeat_timeout', 'Heartbeat timeout.');
             return;
         }
@@ -477,14 +513,7 @@ class ZLinkStreamSessionRuntime {
             // record (spec 26 §2.2) and confuse the peer's reply matching.
             return;
         }
-        const message = this.context.createJsonReplyFrameMessage(header, protocol_1.ZLinkStreamMessageKind.Error, new Map(), false, {
-            code: error instanceof contracts_1.ZLinkFrameworkException
-                ? contracts_1.ZLinkFrameworkErrorKind[error.kind]
-                : error instanceof Error
-                    ? error.constructor.name
-                    : 'RemoteError',
-            message: error instanceof Error ? error.message : String(error)
-        });
+        const message = this.context.createJsonReplyFrameMessage(header, protocol_1.ZLinkStreamMessageKind.Error, new Map(), false, (0, bound_session_response_target_1.boundSessionErrorPayload)(error));
         try {
             if (!this.context.stream.writeRaw(message, ZLINK_SEND_DONT_WAIT)) {
                 throw new Error('Client stream error reply send failed.');
@@ -505,8 +534,7 @@ class ZLinkStreamSessionRuntime {
      * languages' write-path trace.
      */
     traceFrameWritten(kind, packetName, correlationId) {
-        const reply = kind === protocol_1.ZLinkStreamMessageKind.Response
-            || kind === protocol_1.ZLinkStreamMessageKind.Error;
+        const reply = kind === protocol_1.ZLinkStreamMessageKind.Response || kind === protocol_1.ZLinkStreamMessageKind.Error;
         const outcome = reply ? ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Replied : ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Sent;
         (0, diagnostics_1.flowIfEnabled)(this.options.dispatchErrors?.flow, outcome)?.trace({
             outcome,
@@ -518,7 +546,8 @@ class ZLinkStreamSessionRuntime {
                     : ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send,
             packetName: packetName.length === 0 ? undefined : packetName,
             correlationId,
-            sourceRid: this.context.routingId === undefined ? undefined : String(this.context.routingId)
+            sourceRid: this.context.routingId === undefined ? undefined : String(this.context.routingId),
+            streamSessionId: this.stream.sessionId
         });
     }
     async complete(error, notifyDisconnected) {
@@ -547,14 +576,16 @@ class ZLinkStreamSessionRuntime {
             return;
         this.disconnectQueued = true;
         this.stopLivenessChecks();
-        void this.serial.executeFinal(async () => {
+        void this.serial
+            .executeFinal(async () => {
             this.disconnectQueued = false;
             if (this.disconnected)
                 return;
             this.stream.markTransportClosed();
             this.disconnected = true;
             await this.complete(error, true);
-        }).catch(() => {
+        })
+            .catch(() => {
             this.disconnectQueued = false;
         });
     }
@@ -625,6 +656,7 @@ class ZLinkStreamSessionRuntime {
             packetName: header.name === '' ? undefined : header.name,
             correlationId: header.correlationId,
             sourceRid: this.context.routingId === undefined ? undefined : String(this.context.routingId),
+            streamSessionId: this.stream.sessionId,
             flowId: flowEnabled ? header.flowId : undefined,
             flowOrigin: flowEnabled ? header.flowOrigin : undefined,
             errorReason: ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.Shutdown
@@ -634,11 +666,16 @@ class ZLinkStreamSessionRuntime {
 exports.ZLinkStreamSessionRuntime = ZLinkStreamSessionRuntime;
 function streamShutdownDropMessageKind(kind) {
     switch (kind) {
-        case protocol_1.ZLinkStreamMessageKind.Request: return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Request;
-        case protocol_1.ZLinkStreamMessageKind.Response: return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Response;
-        case protocol_1.ZLinkStreamMessageKind.Error: return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Error;
-        case protocol_1.ZLinkStreamMessageKind.Control: return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Control;
-        default: return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send;
+        case protocol_1.ZLinkStreamMessageKind.Request:
+            return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Request;
+        case protocol_1.ZLinkStreamMessageKind.Response:
+            return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Response;
+        case protocol_1.ZLinkStreamMessageKind.Error:
+            return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Error;
+        case protocol_1.ZLinkStreamMessageKind.Control:
+            return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Control;
+        default:
+            return ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.Send;
     }
 }
 class ZLinkStreamSessionNodeRuntime {
@@ -668,17 +705,15 @@ class ZLinkStreamSessionNodeRuntime {
             return;
         }
         const monitor = this.options.monitor;
-        monitor?.onEvent(event => this.onMonitorEvent(event));
-        const running = this.runReceiveLoop(this.receiveAbortController.signal)
-            .catch((error) => {
+        monitor?.onEvent((event) => this.onMonitorEvent(event));
+        const running = this.runReceiveLoop(this.receiveAbortController.signal).catch((error) => {
             if (!this.stopped) {
                 this.options.onError?.(error);
             }
         });
         this.receiveLoop = running;
         if (monitor !== undefined) {
-            this.monitorLoop = this.runMonitorLoop(monitor, this.receiveAbortController.signal)
-                .catch((error) => {
+            this.monitorLoop = this.runMonitorLoop(monitor, this.receiveAbortController.signal).catch((error) => {
                 if (!this.stopped) {
                     this.options.onError?.(error);
                 }
@@ -809,8 +844,8 @@ class ZLinkStreamSessionNodeRuntime {
                 continue;
             }
             this.receiveWorkSinceYield += 1;
-            if (this.receiveWorkSinceYield >= ZLINK_STREAM_RECEIVE_FRAME_BATCH_LIMIT
-                && !this.isReceiveStopped(signal)) {
+            if (this.receiveWorkSinceYield >= ZLINK_STREAM_RECEIVE_FRAME_BATCH_LIMIT &&
+                !this.isReceiveStopped(signal)) {
                 this.receiveWorkSinceYield = 0;
                 await new Promise((resolve) => setImmediate(resolve));
             }
@@ -835,16 +870,16 @@ class ZLinkStreamSessionNodeRuntime {
             this.applyPendingConnectionMetadata(session);
             const decodedHeader = (0, protocol_1.decodeStreamHeader)(header.data(), this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true);
             payload = (0, stream_message_utils_1.ownedMessage)(body.data());
-            const terminalCompletion = decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Response
-                || decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Error;
+            const terminalCompletion = decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Response ||
+                decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Error;
             const applicationPermit = terminalCompletion ? undefined : permit;
             if (terminalCompletion) {
                 permit.releaseAfterInternalProcessing();
                 releasePermitOnFailure = false;
             }
             else {
-                if (decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Send
-                    || decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Request) {
+                if (decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Send ||
+                    decodedHeader.kind === protocol_1.ZLinkStreamMessageKind.Request) {
                     permit.markApplicationQueued();
                 }
             }
@@ -949,8 +984,7 @@ class ZLinkStreamSessionNodeRuntime {
                         session.enqueueDisconnected(error);
                         return;
                     }
-                    if (event.routingId === undefined
-                        && !streamMonitorHasEndpoint(event)) {
+                    if (event.routingId === undefined && !streamMonitorHasEndpoint(event)) {
                         this.enqueueEndpointlessDisconnect(error);
                     }
                 }
@@ -960,9 +994,9 @@ class ZLinkStreamSessionNodeRuntime {
         }
     }
     applyPendingConnectionMetadata(session) {
-        if (session.stream.localAddr !== undefined
-            || session.stream.remoteAddr !== undefined
-            || this.pendingConnectionMetadataCount === 0) {
+        if (session.stream.localAddr !== undefined ||
+            session.stream.remoteAddr !== undefined ||
+            this.pendingConnectionMetadataCount === 0) {
             return;
         }
         const metadata = this.takePendingConnectionMetadata();
@@ -975,16 +1009,16 @@ class ZLinkStreamSessionNodeRuntime {
     hasPendingConnectionMetadata(endpointKey) {
         for (let index = this.pendingConnectionMetadataHead; index < this.pendingConnectionMetadata.length; index += 1) {
             const metadata = this.pendingConnectionMetadata[index];
-            if (metadata !== undefined
-                && streamMonitorEndpointKey(metadata.localAddr, metadata.remoteAddr) === endpointKey) {
+            if (metadata !== undefined &&
+                streamMonitorEndpointKey(metadata.localAddr, metadata.remoteAddr) === endpointKey) {
                 return true;
             }
         }
         return false;
     }
     takePendingConnectionMetadata() {
-        while (this.pendingConnectionMetadataHead < this.pendingConnectionMetadata.length
-            && this.pendingConnectionMetadata[this.pendingConnectionMetadataHead] === undefined) {
+        while (this.pendingConnectionMetadataHead < this.pendingConnectionMetadata.length &&
+            this.pendingConnectionMetadata[this.pendingConnectionMetadataHead] === undefined) {
             this.pendingConnectionMetadataHead += 1;
         }
         const metadata = this.pendingConnectionMetadata[this.pendingConnectionMetadataHead];
@@ -1001,8 +1035,8 @@ class ZLinkStreamSessionNodeRuntime {
             this.pendingConnectionMetadata.length = 0;
             this.pendingConnectionMetadataHead = 0;
         }
-        else if (this.pendingConnectionMetadataHead >= 1024
-            && this.pendingConnectionMetadataHead * 2 >= this.pendingConnectionMetadata.length) {
+        else if (this.pendingConnectionMetadataHead >= 1024 &&
+            this.pendingConnectionMetadataHead * 2 >= this.pendingConnectionMetadata.length) {
             this.pendingConnectionMetadata.splice(0, this.pendingConnectionMetadataHead);
             this.pendingConnectionMetadataHead = 0;
         }
@@ -1012,8 +1046,8 @@ class ZLinkStreamSessionNodeRuntime {
         this.unaddressedMonitorSessionCount += 1;
     }
     takeUnaddressedMonitorSession() {
-        while (this.unaddressedMonitorSessionHead < this.unaddressedMonitorSessions.length
-            && this.unaddressedMonitorSessions[this.unaddressedMonitorSessionHead] === undefined) {
+        while (this.unaddressedMonitorSessionHead < this.unaddressedMonitorSessions.length &&
+            this.unaddressedMonitorSessions[this.unaddressedMonitorSessionHead] === undefined) {
             this.unaddressedMonitorSessionHead += 1;
         }
         const sessionId = this.unaddressedMonitorSessions[this.unaddressedMonitorSessionHead];
@@ -1026,8 +1060,8 @@ class ZLinkStreamSessionNodeRuntime {
             this.unaddressedMonitorSessions.length = 0;
             this.unaddressedMonitorSessionHead = 0;
         }
-        else if (this.unaddressedMonitorSessionHead >= 1024
-            && this.unaddressedMonitorSessionHead * 2 >= this.unaddressedMonitorSessions.length) {
+        else if (this.unaddressedMonitorSessionHead >= 1024 &&
+            this.unaddressedMonitorSessionHead * 2 >= this.unaddressedMonitorSessions.length) {
             this.unaddressedMonitorSessions.splice(0, this.unaddressedMonitorSessionHead);
             this.unaddressedMonitorSessionHead = 0;
         }
@@ -1035,9 +1069,9 @@ class ZLinkStreamSessionNodeRuntime {
     }
     firstUnaddressedSession() {
         for (const session of this.sessions.values()) {
-            if (!session.isDisconnected
-                && session.stream.localAddr === undefined
-                && session.stream.remoteAddr === undefined) {
+            if (!session.isDisconnected &&
+                session.stream.localAddr === undefined &&
+                session.stream.remoteAddr === undefined) {
                 return session;
             }
         }
@@ -1073,9 +1107,9 @@ class ZLinkStreamSessionNodeRuntime {
             let match;
             let matchCount = 0;
             for (const session of this.sessions.values()) {
-                if (session.isDisconnected
-                    || session.stream.localAddr !== event.localAddr
-                    || session.stream.remoteAddr !== event.remoteAddr) {
+                if (session.isDisconnected ||
+                    session.stream.localAddr !== event.localAddr ||
+                    session.stream.remoteAddr !== event.remoteAddr) {
                     continue;
                 }
                 match = session;
@@ -1120,11 +1154,11 @@ class ZLinkStreamSessionNodeRuntime {
         // queued. Wake the recv loop instead of waiting for its idle backoff.
         this.wakeReceiveLoop();
         setImmediate(() => {
-            if (pending.cancelled
-                || this.stopped
-                || this.pendingEndpointlessDisconnect !== pending
-                || this.activityVersion !== pending.activityVersion
-                || this.sessions.get(pending.session.stream.sessionId) !== pending.session) {
+            if (pending.cancelled ||
+                this.stopped ||
+                this.pendingEndpointlessDisconnect !== pending ||
+                this.activityVersion !== pending.activityVersion ||
+                this.sessions.get(pending.session.stream.sessionId) !== pending.session) {
                 return;
             }
             this.pendingEndpointlessDisconnect = undefined;

package/dist/runtime/workers/index.js

@@ -89,7 +89,8 @@ class ZLinkCpuWorkerPool {
         try {
             this.ensureMinimumSlots();
             while (this.queueCount > 0) {
-                const slot = this.findIdleSlot() ?? (this.slots.size < this.options.maxThreads ? this.createSlot() : undefined);
+                const slot = this.findIdleSlot() ??
+                    (this.slots.size < this.options.maxThreads ? this.createSlot() : undefined);
                 if (slot === undefined)
                     return;
                 const job = this.takeQueuedJob();
@@ -241,7 +242,9 @@ class ZLinkCpuWorkerPool {
             clearTimeout(slot.idleTimer);
         slot.idleTimer = setTimeout(() => {
             slot.idleTimer = undefined;
-            if (slot.job === undefined && !slot.terminating && this.slots.size > this.options.minThreads) {
+            if (slot.job === undefined &&
+                !slot.terminating &&
+                this.slots.size > this.options.minThreads) {
                 this.terminateSlot(slot);
             }
         }, this.options.idleTimeoutMs);
@@ -357,7 +360,9 @@ class ZLinkIoWorkerRuntime {
                 };
                 signal.addEventListener('abort', abortListener, { once: true });
             }
-            Promise.resolve().then(() => work(controller.signal)).then((value) => settle(() => resolve(value)), (error) => settle(() => reject(workerFailed(error))));
+            Promise.resolve()
+                .then(() => work(controller.signal))
+                .then((value) => settle(() => resolve(value)), (error) => settle(() => reject(workerFailed(error))));
         });
     }
 }
@@ -438,7 +443,13 @@ class ZLinkSerialDeliveredPromise {
         return this.then(undefined, onrejected);
     }
     finally(onfinally) {
-        return this.then((value) => this.serial.execute(() => { onfinally?.(); return value; }), (reason) => this.serial.execute(() => { onfinally?.(); throw reason; }));
+        return this.then((value) => this.serial.execute(() => {
+            onfinally?.();
+            return value;
+        }), (reason) => this.serial.execute(() => {
+            onfinally?.();
+            throw reason;
+        }));
     }
 }
 function workerTimedOut(timeoutMs) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlink-systems/framework",
-  "version": "0.21.0",
+  "version": "0.23.0",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
@@ -19,7 +19,7 @@
   "dependencies": {
     "@opentelemetry/api": "^1.9.1",
     "@opentelemetry/api-logs": "^0.221.0",
-    "@zlink-systems/stream-wire": "0.21.0",
-    "@zlink-systems/zlink": "1.2.1"
+    "@zlink-systems/stream-wire": "0.23.0",
+    "@zlink-systems/zlink": "1.4.0"
   }
 }

package/src/contracts/Channels/RouteCalls.ts

@@ -1,5 +1,10 @@
 import type { RoutingId } from '../Common';
-import type { ZLinkChannelRequestCall, ZLinkPublishCall, ZLinkRequestCall, ZLinkSendCall } from './Calls';
+import type {
+  ZLinkChannelRequestCall,
+  ZLinkPublishCall,
+  ZLinkRequestCall,
+  ZLinkSendCall
+} from './Calls';
 
 export interface ZLinkRouteClient {
   sendToNode(meshName: string, targetNodeRid: RoutingId, message: unknown): ZLinkSendCall;

package/src/contracts/Common/ZLinkMessage.ts

@@ -108,11 +108,11 @@ export function readZLinkMessageDeclaredType(message: ZLinkMessage): Type | unde
  */
 export function materializeZLinkMessageValue<T>(value: T, type?: Type<T>): T {
   if (
-    type === undefined
-    || (type as unknown) === Object
-    || value === null
-    || typeof value !== 'object'
-    || Array.isArray(value)
+    type === undefined ||
+    (type as unknown) === Object ||
+    value === null ||
+    typeof value !== 'object' ||
+    Array.isArray(value)
   ) {
     return value;
   }

package/src/contracts/Common/ZLinkMessageMetadata.ts

@@ -26,7 +26,7 @@ class ImmutableMetadataMap implements ReadonlyMap<string, string> {
   constructor(values: ReadonlyMap<string, string> | Readonly<Record<string, string>>) {
     this.#values = new Map(
       typeof (values as ReadonlyMap<string, string>)[Symbol.iterator] === 'function'
-        ? values as ReadonlyMap<string, string>
+        ? (values as ReadonlyMap<string, string>)
         : Object.entries(values)
     );
   }
@@ -67,8 +67,9 @@ class ImmutableMetadataMap implements ReadonlyMap<string, string> {
   }
 }
 
-export const ZLinkMessageMetadataEmpty: ZLinkMessageMetadata =
-  Object.freeze(new ImmutableZLinkMessageMetadata());
+export const ZLinkMessageMetadataEmpty: ZLinkMessageMetadata = Object.freeze(
+  new ImmutableZLinkMessageMetadata()
+);
 
 export function zlinkMessageMetadata(
   values: ReadonlyMap<string, string> | Readonly<Record<string, string>>

package/src/contracts/Configuration/Builders.ts

@@ -1,18 +1,10 @@
 import type { ZLinkActor, ZLinkActorFactory } from '../Actors';
-import type {
-  ZLinkEntrySpot,
-  ZLinkInstanceSpot,
-  ZLinkSpot
-} from '../Spots';
+import type { ZLinkEntrySpot, ZLinkInstanceSpot, ZLinkSpot } from '../Spots';
 import type { ZLinkSession, ZLinkSessionFactory, ZLinkStreamCompressionCodec } from '../Streams';
 import type { ZLinkEndpointConnections } from './Connections';
 import type { ZLinkCodecRegistryBuilder } from '../Codecs';
 import type { ZLinkDispatchOptionsBuilder, ZLinkInboundDispatchOptions } from '../Dispatch';
-import type {
-  ZLinkLocationOptions,
-  ZLinkLocationStore,
-  ZLinkRelocationStore
-} from '../Locations';
+import type { ZLinkLocationOptions, ZLinkLocationStore, ZLinkRelocationStore } from '../Locations';
 import type { RoutingId, Type } from '../Common';
 import type { ZLinkWorkerOptions } from './RegistrationTypes';
 import type { ZLinkSpotPublisherConfig } from './Configs';
@@ -71,7 +63,9 @@ export interface ZLinkClientServerChannelServerBuilder {
   setWeight(weight: number): this;
   addHandlerGroup(groupName: string): this;
   addSendHandler<TMessage>(handlerType: Type<ZLinkSendHandler<TMessage>>): this;
-  addRequestHandler<TRequest, TReply>(handlerType: Type<ZLinkRequestHandler<TRequest, TReply>>): this;
+  addRequestHandler<TRequest, TReply>(
+    handlerType: Type<ZLinkRequestHandler<TRequest, TReply>>
+  ): this;
 }
 
 export interface ZLinkMeshPeerConnection {
@@ -97,7 +91,9 @@ export interface ZLinkMeshChannelServerBuilder {
   setWeight(weight: number): this;
   addHandlerGroup(groupName: string): this;
   addSendHandler<TMessage>(handlerType: Type<ZLinkSendHandler<TMessage>>): this;
-  addRequestHandler<TRequest, TReply>(handlerType: Type<ZLinkRequestHandler<TRequest, TReply>>): this;
+  addRequestHandler<TRequest, TReply>(
+    handlerType: Type<ZLinkRequestHandler<TRequest, TReply>>
+  ): this;
 }
 
 export interface ZLinkMeshNodeSocketConfig {
@@ -130,7 +126,9 @@ export interface ZLinkMeshNodeBuilder {
   setDefaultRequestTimeout(timeoutMs: number): this;
   objects(): ZLinkMeshObjectRoleBuilder;
   addRouteSendHandler<TMessage>(handlerType: Type<ZLinkRouteSendHandler<TMessage>>): this;
-  addRouteRequestHandler<TRequest, TReply>(handlerType: Type<ZLinkRouteRequestHandler<TRequest, TReply>>): this;
+  addRouteRequestHandler<TRequest, TReply>(
+    handlerType: Type<ZLinkRouteRequestHandler<TRequest, TReply>>
+  ): this;
 }
 
 export interface ZLinkNetworkOptions {
@@ -196,5 +194,7 @@ export interface ZLinkStreamNodeBuilder {
   configureSocket(): ZLinkStreamSocketConfig;
   enableActorDispatch(): this;
   setTlsServer(certificatePath: string, keyPath: string, requireClientCertificate?: boolean): this;
-  registerSession<TSession extends ZLinkSession>(sessionType: Type<TSession> | Type<ZLinkSessionFactory<TSession>>): this;
+  registerSession<TSession extends ZLinkSession>(
+    sessionType: Type<TSession> | Type<ZLinkSessionFactory<TSession>>
+  ): this;
 }

package/src/contracts/Configuration/CodecContentType.ts

@@ -1,8 +1,6 @@
 import { ZLinkConfigurationException } from './ConfigurationException';
 
-const mediaTypePunctuation = new Set(
-  [..."!#$%&'*+-.^_`|~"].map((value) => value.charCodeAt(0))
-);
+const mediaTypePunctuation = new Set([..."!#$%&'*+-.^_`|~"].map((value) => value.charCodeAt(0)));
 
 export function normalizeCodecContentType(contentType: string): string {
   if (typeof contentType !== 'string') {
@@ -27,9 +25,7 @@ export function normalizeCodecContentType(contentType: string): string {
       continue;
     }
     if (!isTokenCharacter(code)) throw invalidContentType();
-    normalized += code >= 0x41 && code <= 0x5a
-      ? String.fromCharCode(code + 0x20)
-      : value[index]!;
+    normalized += code >= 0x41 && code <= 0x5a ? String.fromCharCode(code + 0x20) : value[index]!;
   }
   if (slash === -1) throw invalidContentType();
   return normalized;
@@ -55,10 +51,12 @@ function isOuterWhitespace(code: number): boolean {
 }
 
 function isTokenCharacter(code: number): boolean {
-  return (code >= 0x30 && code <= 0x39)
-    || (code >= 0x41 && code <= 0x5a)
-    || (code >= 0x61 && code <= 0x7a)
-    || mediaTypePunctuation.has(code);
+  return (
+    (code >= 0x30 && code <= 0x39) ||
+    (code >= 0x41 && code <= 0x5a) ||
+    (code >= 0x61 && code <= 0x7a) ||
+    mediaTypePunctuation.has(code)
+  );
 }
 
 function invalidContentType(): ZLinkConfigurationException {

package/src/contracts/Configuration/DiagnosticsValidation.ts

@@ -1,12 +1,7 @@
 import type { ZLinkMessageFlowLogMode } from '../Dispatch';
 import { ZLinkConfigurationException } from './ConfigurationException';
 
-const MESSAGE_FLOW_MODES: ReadonlySet<string> = new Set([
-  'off',
-  'errors',
-  'normal',
-  'detailed'
-]);
+const MESSAGE_FLOW_MODES: ReadonlySet<string> = new Set(['off', 'errors', 'normal', 'detailed']);
 
 export function requireMessageFlowLogMode(value: unknown): ZLinkMessageFlowLogMode {
   if (typeof value !== 'string' || !MESSAGE_FLOW_MODES.has(value)) {