@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/backend/node/node-raw-mesh-backend.js

@@ -4,6 +4,7 @@ exports.ZLinkNodeRawMeshBackend = void 0;
 exports.genericOperationFailure = genericOperationFailure;
 const node_crypto_1 = require("node:crypto");
 const promises_1 = require("node:timers/promises");
+const stream_wire_1 = require("@zlink-systems/stream-wire");
 const node_socket_backend_adapter_1 = require("./node-socket-backend-adapter");
 const contracts_1 = require("../../../contracts");
 const framework_errors_internal_1 = require("../../framework-errors-internal");
@@ -80,6 +81,7 @@ class ZLinkNodeRawMeshBackend {
     mailboxRecordDropped;
     protocolError;
     messageFollowHandler;
+    dispatchErrors;
     peerDisconnectedHandlers = new Set();
     constructor(meshName, routingId, bindingPort, applicationJobQueue, applicationJobReceiveFlowFailureSink, peerAdmissionSealed) {
         this.meshName = meshName;
@@ -108,6 +110,10 @@ class ZLinkNodeRawMeshBackend {
         this.mailboxRecordDropped = handler;
         this.stateful?.setMailboxDropHandler(handler);
     }
+    setDispatchErrorReporter(reporter) {
+        this.dispatchErrors = reporter;
+        this.stateful?.setDispatchErrorReporter(reporter, this.meshName);
+    }
     setProtocolErrorHandler(handler) {
         this.protocolError = handler;
     }
@@ -117,12 +123,12 @@ class ZLinkNodeRawMeshBackend {
     selectObjectPlacement(stableType) {
         const runtime = this.requireRuntime();
         const localNodeRid = runtime.topology.localDescriptor().nodeRoutingId;
-        const status = runtime.topology.objectPlacementStatus(stableType, candidate => candidate.nodeRoutingId === localNodeRid
-            || runtime.isPeerRouteReady(candidate.nodeRoutingId));
+        const status = runtime.topology.objectPlacementStatus(stableType, (candidate) => candidate.nodeRoutingId === localNodeRid ||
+            runtime.isPeerRouteReady(candidate.nodeRoutingId));
         if (status !== 'available')
             return { kind: status };
-        const descriptor = runtime.topology.selectObjectPlacement(stableType, candidate => candidate.nodeRoutingId === localNodeRid
-            || runtime.isPeerRouteReady(candidate.nodeRoutingId));
+        const descriptor = runtime.topology.selectObjectPlacement(stableType, (candidate) => candidate.nodeRoutingId === localNodeRid ||
+            runtime.isPeerRouteReady(candidate.nodeRoutingId));
         return descriptor === undefined
             ? { kind: 'unavailable' }
             : {
@@ -171,7 +177,7 @@ class ZLinkNodeRawMeshBackend {
         const descriptor = this.createDescriptor();
         const runtime = new raw_service_mesh_runtime_1.RawServiceMeshRuntime({
             descriptor,
-            resolveAdvertisedEndpoint: boundEndpoint => this.resolveAdvertisedEndpoint(boundEndpoint),
+            resolveAdvertisedEndpoint: (boundEndpoint) => this.resolveAdvertisedEndpoint(boundEndpoint),
             bindingPort: this.bindingPort,
             applicationJobQueue: this.requireApplicationJobQueue(),
             peerAdmissionSealed: this.peerAdmissionSealed,
@@ -185,17 +191,16 @@ class ZLinkNodeRawMeshBackend {
             }),
             onPeerNotRequired: (nodeRoutingId, endpoint) => {
                 for (const [intent, peer] of this.peerIntents) {
-                    if ((peer.nodeRoutingId === undefined
-                        || peer.nodeRoutingId === nodeRoutingId)
-                        && peer.endpoint === endpoint) {
+                    if ((peer.nodeRoutingId === undefined || peer.nodeRoutingId === nodeRoutingId) &&
+                        peer.endpoint === endpoint) {
                         this.peerIntents.delete(intent);
                     }
                 }
             },
             onPeerDisconnected: (nodeRoutingId, endpoint) => {
                 for (const [intentId, peer] of this.peerIntents) {
-                    if (peer.endpoint === endpoint
-                        && (peer.nodeRoutingId === undefined || peer.nodeRoutingId === nodeRoutingId)) {
+                    if (peer.endpoint === endpoint &&
+                        (peer.nodeRoutingId === undefined || peer.nodeRoutingId === nodeRoutingId)) {
                         this.peerIntents.delete(intentId);
                     }
                 }
@@ -205,6 +210,9 @@ class ZLinkNodeRawMeshBackend {
         });
         runtime.start();
         this.stateful = new service_stateful_runtime_1.ServiceStatefulRuntime(runtime, descriptor.nodeRoutingId, descriptor.lifecycleGeneration);
+        if (this.dispatchErrors !== undefined) {
+            this.stateful.setDispatchErrorReporter(this.dispatchErrors, this.meshName);
+        }
         if (this.mailboxRecordDropped !== undefined) {
             this.stateful.setMailboxDropHandler(this.mailboxRecordDropped);
         }
@@ -278,23 +286,22 @@ class ZLinkNodeRawMeshBackend {
     }
     async connectPeer(options) {
         const runtime = this.requireRuntime();
-        const nodeRoutingId = options.expectedRid === undefined
-            ? undefined
-            : String(options.expectedRid);
+        const nodeRoutingId = options.expectedRid === undefined ? undefined : String(options.expectedRid);
         if (nodeRoutingId === undefined) {
             runtime.connectPeerEndpoint(options.endpoint);
         }
         else {
-            runtime.connectPeerByRoutingId(options.endpoint, nodeRoutingId, options.expectedSecurityIdentity
-                ?? runtime.topology.localDescriptor().securityIdentity, options.expectedLifecycleGeneration);
+            runtime.connectPeerByRoutingId(options.endpoint, nodeRoutingId, options.expectedSecurityIdentity ?? runtime.topology.localDescriptor().securityIdentity, options.expectedLifecycleGeneration);
         }
         const intent = this.nextPeerIntent++;
         this.peerIntents.set(intent, {
             endpoint: options.endpoint,
-            ...(nodeRoutingId === undefined ? {} : {
-                nodeRoutingId,
-                lifecycleGeneration: options.expectedLifecycleGeneration
-            })
+            ...(nodeRoutingId === undefined
+                ? {}
+                : {
+                    nodeRoutingId,
+                    lifecycleGeneration: options.expectedLifecycleGeneration
+                })
         });
         if (nodeRoutingId !== undefined)
             await runtime.announcePeer(nodeRoutingId);
@@ -318,18 +325,16 @@ class ZLinkNodeRawMeshBackend {
     disconnectPeer(peerRid, lifecycleGeneration) {
         const nodeRoutingId = String(peerRid);
         const admitted = this.runtime?.topology.peer(nodeRoutingId);
-        if (admitted !== undefined
-            && admitted.descriptor.lifecycleGeneration !== lifecycleGeneration) {
+        if (admitted !== undefined && admitted.descriptor.lifecycleGeneration !== lifecycleGeneration) {
             return;
         }
         const admittedEndpoint = admitted?.descriptor.advertisedEndpoint;
-        const found = [...this.peerIntents.entries()]
-            .find(([, intent]) => (intent.nodeRoutingId === nodeRoutingId
-            && (intent.lifecycleGeneration === undefined
-                || intent.lifecycleGeneration === lifecycleGeneration))
-            || (intent.nodeRoutingId === undefined
-                && admittedEndpoint !== undefined
-                && intent.endpoint === admittedEndpoint));
+        const found = [...this.peerIntents.entries()].find(([, intent]) => (intent.nodeRoutingId === nodeRoutingId &&
+            (intent.lifecycleGeneration === undefined ||
+                intent.lifecycleGeneration === lifecycleGeneration)) ||
+            (intent.nodeRoutingId === undefined &&
+                admittedEndpoint !== undefined &&
+                intent.endpoint === admittedEndpoint));
         if (found === undefined) {
             if (admitted !== undefined) {
                 this.runtime?.disconnectPeer(admitted.descriptor.advertisedEndpoint, nodeRoutingId, lifecycleGeneration);
@@ -340,7 +345,7 @@ class ZLinkNodeRawMeshBackend {
     }
     replaceDiscoveredNotRequiredPeers(peers) {
         const local = this.requireRuntime().topology.localDescriptor();
-        this.requireRuntime().replaceDiscoveredNotRequired(peers.map(peer => ({
+        this.requireRuntime().replaceDiscoveredNotRequired(peers.map((peer) => ({
             ...local,
             nodeRoutingId: peer.nodeRoutingId,
             lifecycleGeneration: peer.lifecycleGeneration,
@@ -357,29 +362,32 @@ class ZLinkNodeRawMeshBackend {
         return this.requireRuntime().isPeerRouteReady(String(targetRid), lifecycleGeneration);
     }
     async sendToNode(targetRid, parts) {
-        return await this.requireRuntime().sendToNode(String(targetRid), encodeMultipartApplicationFrame(parts)) ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.NotConnected;
+        return (await this.requireRuntime().sendToNode(String(targetRid), encodeMultipartApplicationFrame(parts)))
+            ? zlink_1.SubmitResult.Ok
+            : zlink_1.SubmitResult.NotConnected;
     }
     async sendInfrastructureControl(targetRid, record) {
-        return await this.requireRuntime().sendService(String(targetRid), (Array.isArray(record) ? record : [record]).map(value => Buffer.from(value))) ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.NotConnected;
+        return (await this.requireRuntime().sendService(String(targetRid), (Array.isArray(record) ? record : [record]).map((value) => Buffer.from(value))))
+            ? zlink_1.SubmitResult.Ok
+            : zlink_1.SubmitResult.NotConnected;
     }
     async sendInfrastructureControlFrames(targetRid, frames) {
-        return await this.requireRuntime().sendService(String(targetRid), frames.map(frame => Buffer.from(frame))) ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.NotConnected;
+        return (await this.requireRuntime().sendService(String(targetRid), frames.map((frame) => Buffer.from(frame))))
+            ? zlink_1.SubmitResult.Ok
+            : zlink_1.SubmitResult.NotConnected;
     }
     async requestInfrastructureControlFrames(targetRid, frames, options) {
-        return await this.requireRuntime().requestService(String(targetRid), frames.map(frame => Buffer.from(frame)), options?.timeoutMs ?? 30_000);
+        return await this.requireRuntime().requestService(String(targetRid), frames.map((frame) => Buffer.from(frame)), options?.timeoutMs ?? 30_000);
     }
     requestToNode(targetRid, parts, options) {
         const pending = this.requireRuntime().requestToNode(String(targetRid), encodeMultipartApplicationFrame(parts), options?.timeoutMs ?? 30_000);
         return this.observeCompletion(pending.id, service_runtime_contracts_1.OperationKind.NodeRequest, pending.promise);
     }
     async sendToChannel(channelName, parts) {
-        return await this.requireRuntime().sendToChannel(channelName, encodeMultipartApplicationFrame(parts)) ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.NotConnected;
+        return this.requireRuntime().sendToChannel(channelName, encodeMultipartApplicationFrame(parts));
     }
     requestToChannel(channelName, parts, options) {
         const pending = this.requireRuntime().requestToChannel(channelName, encodeMultipartApplicationFrame(parts), options?.timeoutMs ?? 30_000);
-        if (pending === undefined) {
-            return this.enqueueImmediateFailure(service_runtime_contracts_1.OperationKind.ChannelRequest, zlink_1.RequestResult.NotFound);
-        }
         return this.observeCompletion(pending.id, service_runtime_contracts_1.OperationKind.ChannelRequest, pending.promise);
     }
     status() {
@@ -395,11 +403,11 @@ class ZLinkNodeRawMeshBackend {
             channelCount: descriptor.channels.length,
             configuredPeerCount: this.peerIntents.size,
             admittedPeerCount: peers.length,
-            drainingPeerCount: peers.filter(peer => peer.descriptor.state === 'draining').length,
+            drainingPeerCount: peers.filter((peer) => peer.descriptor.state === 'draining').length,
             pendingApplicationMessages: BigInt(this.runtime?.mailbox.pendingMessages('application') ?? 0),
             pendingInfrastructureMessages: BigInt((this.runtime?.mailbox.pendingMessages('infrastructure') ?? 0) + this.completionCount),
-            pendingBytes: BigInt((this.runtime?.mailbox.pendingBytes('application') ?? 0)
-                + (this.runtime?.mailbox.pendingBytes('infrastructure') ?? 0)),
+            pendingBytes: BigInt((this.runtime?.mailbox.pendingBytes('application') ?? 0) +
+                (this.runtime?.mailbox.pendingBytes('infrastructure') ?? 0)),
             lastError: 0,
             lastChangedMs: BigInt(Math.trunc(performance.now()))
         };
@@ -409,10 +417,9 @@ class ZLinkNodeRawMeshBackend {
             id,
             ...intent
         }));
-        const findIntent = (nodeRoutingId, endpoint) => intents.find(intent => intent.nodeRoutingId === nodeRoutingId
-            || (intent.nodeRoutingId === undefined
-                && intent.endpoint === endpoint));
-        const admitted = (this.runtime?.topology.peers() ?? []).map(peer => ({
+        const findIntent = (nodeRoutingId, endpoint) => intents.find((intent) => intent.nodeRoutingId === nodeRoutingId ||
+            (intent.nodeRoutingId === undefined && intent.endpoint === endpoint));
+        const admitted = (this.runtime?.topology.peers() ?? []).map((peer) => ({
             connectionIntentId: findIntent(peer.descriptor.nodeRoutingId, peer.descriptor.advertisedEndpoint)?.id ?? 0n,
             source: 1,
             state: this.runtime?.isPeerRouteReady(peer.descriptor.nodeRoutingId) === false
@@ -426,7 +433,7 @@ class ZLinkNodeRawMeshBackend {
             lastError: 0,
             lastChangedMs: BigInt(Math.trunc(performance.now()))
         }));
-        const notRequired = (this.runtime?.topology.notRequiredPeers() ?? []).map(descriptor => ({
+        const notRequired = (this.runtime?.topology.notRequiredPeers() ?? []).map((descriptor) => ({
             connectionIntentId: findIntent(descriptor.nodeRoutingId, descriptor.advertisedEndpoint)?.id ?? 0n,
             source: 1,
             state: 6,
@@ -439,13 +446,12 @@ class ZLinkNodeRawMeshBackend {
             lastChangedMs: BigInt(Math.trunc(performance.now()))
         }));
         const projected = new Set([
-            ...admitted.map(peer => peer.connectionIntentId),
-            ...notRequired.map(peer => peer.connectionIntentId)
+            ...admitted.map((peer) => peer.connectionIntentId),
+            ...notRequired.map((peer) => peer.connectionIntentId)
         ]);
         const disconnected = intents
-            .filter(intent => intent.nodeRoutingId !== undefined
-            && !projected.has(intent.id))
-            .map(intent => {
+            .filter((intent) => intent.nodeRoutingId !== undefined && !projected.has(intent.id))
+            .map((intent) => {
             const descriptor = this.runtime?.topology.knownDescriptor(intent.nodeRoutingId);
             return {
                 connectionIntentId: intent.id,
@@ -462,8 +468,7 @@ class ZLinkNodeRawMeshBackend {
                 lastChangedMs: BigInt(Math.trunc(performance.now()))
             };
         });
-        return [...admitted, ...notRequired, ...disconnected]
-            .sort((left, right) => String(left.routingId).localeCompare(String(right.routingId)));
+        return [...admitted, ...notRequired, ...disconnected].sort((left, right) => String(left.routingId).localeCompare(String(right.routingId)));
     }
     peerChannels(peerRid, lifecycleGeneration) {
         const descriptor = this.runtime?.topology.knownDescriptor(String(peerRid));
@@ -471,8 +476,8 @@ class ZLinkNodeRawMeshBackend {
             return { names: [], weights: [] };
         }
         return {
-            names: descriptor.channels.map(channel => channel.name),
-            weights: descriptor.channels.map(channel => channel.weight)
+            names: descriptor.channels.map((channel) => channel.name),
+            weights: descriptor.channels.map((channel) => channel.weight)
         };
     }
     createPublisher() {
@@ -513,11 +518,10 @@ class ZLinkNodeRawMeshBackend {
             this.drainMailbox('application', target);
         }
         const runtime = this.runtime;
-        const infrastructureResidue = (domains & service_runtime_contracts_1.ReadyDomain.Infrastructure) !== 0
-            && (this.completionCount > 0
-                || (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0);
-        const applicationResidue = (domains & service_runtime_contracts_1.ReadyDomain.Application) !== 0
-            && (runtime?.mailbox.pendingMessages('application') ?? 0) > 0;
+        const infrastructureResidue = (domains & service_runtime_contracts_1.ReadyDomain.Infrastructure) !== 0 &&
+            (this.completionCount > 0 || (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0);
+        const applicationResidue = (domains & service_runtime_contracts_1.ReadyDomain.Application) !== 0 &&
+            (runtime?.mailbox.pendingMessages('application') ?? 0) > 0;
         return {
             ok: true,
             // Residue is scoped to the requested lane. The pump drains lanes in
@@ -676,13 +680,13 @@ class ZLinkNodeRawMeshBackend {
         return this.observeStateful(service_runtime_contracts_1.OperationKind.ActorRequest, this.requireStateful().requestToActor(actor, this.peerGeneration(String(actor.nodeRid)), actor.generation, encodeMultipart(parts), options?.timeoutMs ?? 30_000));
     }
     async actorSendToActor(source, target, parts) {
-        return await this.requireStateful().sendToActor(target, this.peerGeneration(String(target.nodeRid)), target.generation, encodeMultipart(parts), source);
+        return (await this.requireStateful().sendToActor(target, this.peerGeneration(String(target.nodeRid)), target.generation, encodeMultipart(parts), source));
     }
     actorRequestToActor(source, target, parts, options) {
         return this.observeStateful(service_runtime_contracts_1.OperationKind.ActorRequest, this.requireStateful().requestToActor(target, this.peerGeneration(String(target.nodeRid)), target.generation, encodeMultipart(parts), options?.timeoutMs ?? 30_000, source));
     }
     async sendActorBoundSession(actor, expectedBindingGeneration, parts, _flags, actorFence) {
-        return await this.requireStateful().sendBoundSession(actor, expectedBindingGeneration, encodeMultipart(parts), actorFence);
+        return (await this.requireStateful().sendBoundSession(actor, expectedBindingGeneration, encodeMultipart(parts), actorFence));
     }
     closeActorBoundSession(actor, expectedBindingGeneration, timeoutMs = 30_000) {
         const binding = this.requireStateful().registry.binding(actor);
@@ -698,7 +702,7 @@ class ZLinkNodeRawMeshBackend {
         return new RawStreamSessionService(this.requireStateful(), stream, (kind, pending) => this.observeStateful(kind, pending));
     }
     async sendFromSpot(source, target, parts) {
-        return await this.requireStateful().sendToSpot(source.ref.spotId, target, encodeMultipart(parts));
+        return (await this.requireStateful().sendToSpot(source.ref.spotId, target, encodeMultipart(parts)));
     }
     requestFromSpot(source, target, parts, timeoutMs) {
         return this.observeStateful(service_runtime_contracts_1.OperationKind.SpotRequest, this.requireStateful().requestToSpot(source.ref.spotId, target, encodeMultipart(parts), timeoutMs));
@@ -734,10 +738,7 @@ class ZLinkNodeRawMeshBackend {
             securityIdentity: 'default',
             applicationVersion: 0n,
             ...(this.maintenanceWave === undefined ? {} : { maintenanceWave: this.maintenanceWave }),
-            protocolCapabilities: [
-                service_wire_constants_generated_1.SERVICE_WIRE_REQUIRED_CAPABILITY,
-                ...this.objectCapabilities
-            ].sort(),
+            protocolCapabilities: [service_wire_constants_generated_1.SERVICE_WIRE_REQUIRED_CAPABILITY, ...this.objectCapabilities].sort(),
             objectRole: this.objectRole,
             placementWeight: this.placementWeight,
             activeCapacityLimit: this.activeCapacityLimit,
@@ -800,12 +801,12 @@ class ZLinkNodeRawMeshBackend {
     }
     observeCompletion(low, operationKind, promise) {
         const id = { high: 1n, low };
-        void promise.then(result => this.enqueueCompletion(id, operationKind, result), error => this.enqueueCompletion(id, operationKind, genericOperationFailure(error)));
+        void promise.then((result) => this.enqueueCompletion(id, operationKind, result), (error) => this.enqueueCompletion(id, operationKind, genericOperationFailure(error)));
         return id;
     }
     observeStateful(operationKind, pending) {
         const id = { high: 2n, low: pending.id };
-        void pending.promise.then(result => this.enqueueCompletion(id, operationKind, result), error => this.enqueueCompletion(id, operationKind, statefulOperationFailure(error)));
+        void pending.promise.then((result) => this.enqueueCompletion(id, operationKind, result), (error) => this.enqueueCompletion(id, operationKind, statefulOperationFailure(error)));
         return id;
     }
     enqueueImmediateFailure(operationKind, terminalResult) {
@@ -845,8 +846,7 @@ class ZLinkNodeRawMeshBackend {
         if (this.completionCount === 0) {
             this.clearCompletions();
         }
-        else if (this.completionHead >= 1024
-            && this.completionHead * 2 >= this.completions.length) {
+        else if (this.completionHead >= 1024 && this.completionHead * 2 >= this.completions.length) {
             this.completions.splice(0, this.completionHead);
             this.completionHead = 0;
         }
@@ -982,10 +982,10 @@ function requireDirectSpotRouteFence(route, targetNodeRid, targetSpotId, targetS
     if (route === undefined && entryRoute !== undefined) {
         return entryRoute;
     }
-    if (route === undefined
-        || route.targetNodeRid !== targetNodeRid
-        || route.spot.spotId !== targetSpotId
-        || route.spot.generation !== targetSpotGeneration) {
+    if (route === undefined ||
+        route.targetNodeRid !== targetNodeRid ||
+        route.spot.spotId !== targetSpotId ||
+        route.spot.generation !== targetSpotGeneration) {
         throw new TypeError('Direct Spot submission requires the exact resolved authority fence.');
     }
     return route;
@@ -1026,7 +1026,7 @@ class RawStreamSessionService {
         return {
             state: this.state,
             lifecycleGeneration: 1n,
-            sessionCount: BigInt(new Set(bindings.map(value => value.sessionRid)).size),
+            sessionCount: BigInt(new Set(bindings.map((value) => value.sessionRid)).size),
             bindingCount: BigInt(bindings.length),
             pendingMessageCount: 0n,
             pendingByteCount: 0n,
@@ -1041,7 +1041,7 @@ class RawStreamSessionService {
         this.requireStarted();
         const sessionKey = String(sessionRid);
         this.sessionTargets.set(sessionKey, sessionRid);
-        return this.observe(service_runtime_contracts_1.OperationKind.StreamBind, this.stateful.bindSession(sessionKey, actor, timeoutMs, (targetSessionRid, payloadFrame) => this.deliver(targetSessionRid, payloadFrame), onBindingReplaced, (0, service_session_binding_ingress_port_1.serviceSessionBindingIngressPortIfRegistered)(this), actorAuthority));
+        return this.observe(service_runtime_contracts_1.OperationKind.StreamBind, this.stateful.bindSession(sessionKey, actor, timeoutMs, (targetSessionRid, payloadFrame) => this.deliver(targetSessionRid, actor.actorId, payloadFrame), onBindingReplaced, (0, service_session_binding_ingress_port_1.serviceSessionBindingIngressPortIfRegistered)(this), actorAuthority));
     }
     unbindActor(sessionRid, actor, expectedBindingGeneration, timeoutMs = 30_000) {
         this.requireStarted();
@@ -1052,9 +1052,9 @@ class RawStreamSessionService {
     }
     async sendToActor(sessionRid, actor, parts) {
         this.requireStarted();
-        return await this.stateful.sendSessionToActor(String(sessionRid), actor, encodeMultipart(parts));
+        return (await this.stateful.sendSessionToActor(String(sessionRid), actor, encodeMultipart(parts)));
     }
-    async deliver(sessionRid, payload) {
+    async deliver(sessionRid, actorId, payload) {
         const target = this.sessionTargets.get(sessionRid);
         if (target === undefined)
             return false;
@@ -1062,6 +1062,10 @@ class RawStreamSessionService {
         const parts = decodeMultipartBuffers((0, service_wire_m6a_codec_1.decodeApplicationPayloadView)(payload).payload);
         if (parts.length === 0)
             return false;
+        const actorSlot = await (0, service_session_binding_ingress_port_1.serviceSessionBindingIngressPortIfRegistered)(this)?.actorSlot(actorId, sessionRid);
+        if (actorSlot === undefined)
+            return false;
+        parts[0] = Buffer.from(streamFrameWithActorSlot(parts[0], actorSlot));
         let submit = operation.message(parts[0]);
         for (let index = 1; index < parts.length; index++) {
             submit = submit.message(parts[index]);
@@ -1080,10 +1084,14 @@ class RawStreamSessionService {
                     // Let the socket monitor drive the existing STREAM close/unbind
                     // lifecycle instead of maintaining a second session-close state.
                     (0, node_socket_backend_adapter_1.disconnectStreamPeer)(this.stream, target);
-                    throw new runtime_values_1.ZLinkBackendResultError('submit', error.result, error.nativeErrno, { cause: error });
+                    throw new runtime_values_1.ZLinkBackendResultError('submit', error.result, error.nativeErrno, {
+                        cause: error
+                    });
                 case zlink_1.SubmitResult.Backpressured:
                 case zlink_1.SubmitResult.NotAdmitted:
-                    throw new runtime_values_1.ZLinkBackendResultError('submit', error.result, error.nativeErrno, { cause: error });
+                    throw new runtime_values_1.ZLinkBackendResultError('submit', error.result, error.nativeErrno, {
+                        cause: error
+                    });
                 default:
                     throw error;
             }
@@ -1095,6 +1103,11 @@ class RawStreamSessionService {
         }
     }
 }
+function streamFrameWithActorSlot(frame, actorSlot) {
+    const decodedFrame = (0, stream_wire_1.decodeStreamWireFrame)(frame);
+    const decodedHeader = (0, stream_wire_1.decodeStreamWireHeader)(decodedFrame.header);
+    return (0, stream_wire_1.encodeStreamWireFrame)((0, stream_wire_1.encodeStreamWireHeader)({ ...decodedHeader, actorSlot }), decodedFrame.payload);
+}
 class RawReadyBatch {
     capacity;
     records = [];
@@ -1134,7 +1147,7 @@ class RawReceiveBatch {
     constructor(capacity, partCapacity) {
         this.capacity = capacity;
         this.partCapacity = partCapacity;
-        if ([capacity, partCapacity].some(value => !Number.isInteger(value) || value < 1)) {
+        if ([capacity, partCapacity].some((value) => !Number.isInteger(value) || value < 1)) {
             throw new RangeError('Receive batch capacities must be positive.');
         }
         this.receiveCapacity = capacity;
@@ -1143,7 +1156,9 @@ class RawReceiveBatch {
         return this.receiveCapacity;
     }
     reset(messageCapacity = this.capacity) {
-        if (!Number.isInteger(messageCapacity) || messageCapacity < 1 || messageCapacity > this.capacity) {
+        if (!Number.isInteger(messageCapacity) ||
+            messageCapacity < 1 ||
+            messageCapacity > this.capacity) {
             throw new RangeError('Receive limit must be within the batch capacity.');
         }
         this.receiveCapacity = messageCapacity;
@@ -1191,8 +1206,7 @@ class MailboxClaim {
                 throw error;
             }
             const nextParts = decoded.parts.length;
-            if (records.length >= capacity.messageCapacity
-                || parts + nextParts > capacity.partCapacity) {
+            if (records.length >= capacity.messageCapacity || parts + nextParts > capacity.partCapacity) {
                 for (const part of decoded.parts)
                     part.close();
                 this.remaining = this.claim.records.slice(index);
@@ -1224,7 +1238,8 @@ class CompletionClaim {
         const payload = this.completion.result.payload;
         return {
             ok: true,
-            records: [{
+            records: [
+                {
                     kind: service_runtime_contracts_1.ReceiveKind.Completion,
                     domain: service_runtime_contracts_1.ReadyDomain.Infrastructure,
                     sourceNodeRid: null,
@@ -1236,9 +1251,7 @@ class CompletionClaim {
                     channelName: null,
                     topic: null,
                     applicationMetadata: null,
-                    kindData: 'kindData' in this.completion.result
-                        ? this.completion.result.kindData ?? null
-                        : null,
+                    kindData: 'kindData' in this.completion.result ? (this.completion.result.kindData ?? null) : null,
                     terminalResult: this.completion.result.terminalResult,
                     failureErrno: this.completion.result.failureCode,
                     parts: payload === undefined
@@ -1248,7 +1261,8 @@ class CompletionClaim {
                             : [zlink_1.Message.from(payload.payload)],
                     reply: () => zlink_1.SubmitResult.InvalidState,
                     replyActorJoin: () => zlink_1.SubmitResult.NotSupported
-                }]
+                }
+            ]
         };
     }
     release() { }
@@ -1271,8 +1285,7 @@ function decodeMultipartRecord(runtime, record) {
     // multi-frame infrastructure control (Prepare + sideband) from being
     // misread as a 2-frame application envelope and dropped as invalid_frame.
     if (record.parts.length === 1 || record.domain === 'infrastructure') {
-        const request = record.requestSequence !== undefined
-            && record.sourceRoutingId !== undefined;
+        const request = record.requestSequence !== undefined && record.sourceRoutingId !== undefined;
         return {
             kind: request ? service_runtime_contracts_1.ReceiveKind.NodeRequest : service_runtime_contracts_1.ReceiveKind.NodeSend,
             domain: readyDomain(record.domain),
@@ -1291,7 +1304,7 @@ function decodeMultipartRecord(runtime, record) {
             terminalResult: 0,
             failureErrno: 0,
             ...receiveIngressLifecycle(record),
-            parts: record.parts.map(part => zlink_1.Message.from(part)),
+            parts: record.parts.map((part) => zlink_1.Message.from(part)),
             reply(parts) {
                 if (!request)
                     return zlink_1.SubmitResult.InvalidState;
@@ -1303,7 +1316,7 @@ function decodeMultipartRecord(runtime, record) {
                     ...(record.sourceRoute === undefined ? {} : { sourceRoute: record.sourceRoute }),
                     requestSequence: record.requestSequence,
                     ...(record.reply === undefined ? {} : { reply: record.reply })
-                }, values.map(value => Buffer.from(messageBytesView(value))));
+                }, values.map((value) => Buffer.from(messageBytesView(value))));
                 return zlink_1.SubmitResult.Ok;
             },
             replyActorJoin: () => zlink_1.SubmitResult.NotSupported
@@ -1313,7 +1326,9 @@ function decodeMultipartRecord(runtime, record) {
     const command = header[3];
     const payloadFrame = record.parts[1];
     const application = decodeApplicationEnvelope(payloadFrame);
-    const channelName = record.owner.startsWith('channel:') ? record.owner.slice('channel:'.length) : null;
+    const channelName = record.owner.startsWith('channel:')
+        ? record.owner.slice('channel:'.length)
+        : null;
     const operationId = record.correlation === undefined
         ? { high: 0n, low: 0n }
         : { high: 1n, low: record.correlation };
@@ -1360,13 +1375,15 @@ function decodeMultipartRecord(runtime, record) {
 }
 function decodeStatefulRecord(record, stateful) {
     const payloadFrame = record.parts.length < 2 ? undefined : record.parts[1];
-    const canonicalActorJoin = stateful.kindData?.kind === 'actorControl'
-        && stateful.kindData.canonicalActorJoin !== undefined;
-    const canonicalActorJoinPayload = stateful.operationKind === service_runtime_contracts_1.OperationKind.ActorJoin
-        && stateful.canonicalApplicationPayload !== undefined;
+    const canonicalActorJoin = stateful.kindData?.kind === 'actorControl' &&
+        stateful.kindData.canonicalActorJoin !== undefined;
+    const canonicalActorJoinPayload = stateful.operationKind === service_runtime_contracts_1.OperationKind.ActorJoin &&
+        stateful.canonicalApplicationPayload !== undefined;
     const application = canonicalActorJoinPayload
         ? stateful.canonicalApplicationPayload
-        : (payloadFrame === undefined ? undefined : decodeApplicationEnvelope(payloadFrame));
+        : payloadFrame === undefined
+            ? undefined
+            : decodeApplicationEnvelope(payloadFrame);
     const operationId = record.correlation === undefined
         ? { high: 0n, low: 0n }
         : { high: 2n, low: record.correlation };
@@ -1409,7 +1426,9 @@ function decodeStatefulRecord(record, stateful) {
         reply(parts) {
             if (stateful.reply === undefined)
                 return zlink_1.SubmitResult.InvalidState;
-            return stateful.reply(zlink_1.RequestResult.Ok, 0, encodeMultipart(parts)) ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.InvalidState;
+            return stateful.reply(zlink_1.RequestResult.Ok, 0, encodeMultipart(parts))
+                ? zlink_1.SubmitResult.Ok
+                : zlink_1.SubmitResult.InvalidState;
         },
         replyActorJoin(joinResult, parts, _flags, _replyContentType) {
             if (stateful.reply === undefined || stateful.targetSpot === undefined) {
@@ -1425,9 +1444,7 @@ function decodeStatefulRecord(record, stateful) {
             if (canonicalActorJoin && replyParts.length > 1) {
                 return zlink_1.SubmitResult.InvalidState;
             }
-            const replyPayload = replyParts.length === 0
-                ? undefined
-                : encodeMultipart(replyParts);
+            const replyPayload = replyParts.length === 0 ? undefined : encodeMultipart(replyParts);
             const accepted = stateful.reply(zlink_1.RequestResult.Ok, 0, replyPayload, {
                 kind: 'actorJoin',
                 joinResult: joinResult === 0 ? 0 : 1,
@@ -1472,9 +1489,7 @@ function readyOwner(owner, nodeRid, stateful, domain) {
     }
     if (owner.startsWith('actor:')) {
         const separator = owner.indexOf('\0', 'actor:'.length);
-        const actorId = separator < 0
-            ? owner.slice('actor:'.length)
-            : owner.slice('actor:'.length, separator);
+        const actorId = separator < 0 ? owner.slice('actor:'.length) : owner.slice('actor:'.length, separator);
         const generation = separator < 0 ? 0n : BigInt(owner.slice(separator + 1));
         const current = stateful?.actor(actorId);
         return {
@@ -1498,9 +1513,7 @@ function readyOwner(owner, nodeRid, stateful, domain) {
     };
 }
 function readyDomain(domain) {
-    return domain === 'infrastructure'
-        ? service_runtime_contracts_1.ReadyDomain.Infrastructure
-        : service_runtime_contracts_1.ReadyDomain.Application;
+    return domain === 'infrastructure' ? service_runtime_contracts_1.ReadyDomain.Infrastructure : service_runtime_contracts_1.ReadyDomain.Application;
 }
 /**
  * Classifies a generic node/channel request rejection into a completion
@@ -1602,9 +1615,9 @@ function decodeApplicationEnvelope(frame) {
     offset += contentLength;
     const payloadLength = bytes.readUInt32BE(offset);
     offset += 4;
-    if (packetName !== MULTIPART_PACKET_NAME
-        || contentType !== MULTIPART_CONTENT_TYPE
-        || payloadLength !== bytes.length - offset) {
+    if (packetName !== MULTIPART_PACKET_NAME ||
+        contentType !== MULTIPART_CONTENT_TYPE ||
+        payloadLength !== bytes.length - offset) {
         throw new service_wire_m6a_codec_1.ServiceWireProtocolError('Unexpected M6A application payload.');
     }
     return { packetName, contentType, payload: bytes.subarray(offset) };
@@ -1670,20 +1683,23 @@ function stateCode(state) {
 }
 function peerStateCode(state) {
     switch (state) {
-        case 'preparing': return 2;
+        case 'preparing':
+            return 2;
         case 'serving':
-        case 'retiring': return 3;
-        case 'draining': return 4;
+        case 'retiring':
+            return 3;
+        case 'draining':
+            return 4;
         case 'stopped':
-        case 'error': return 5;
+        case 'error':
+            return 5;
     }
 }
 function createLifecycleGeneration() {
     // Node's public Spot context exposes this lifecycle token as a number. Keep
     // the opaque equality token within the exact range that surface can carry;
     // lifecycle ordering is never inferred from its numeric value.
-    const generation = (0, node_crypto_1.randomBytes)(8).readBigUInt64BE()
-        & BigInt(Number.MAX_SAFE_INTEGER);
+    const generation = (0, node_crypto_1.randomBytes)(8).readBigUInt64BE() & BigInt(Number.MAX_SAFE_INTEGER);
     return generation === 0n ? 1n : generation;
 }
 function requirePositivePlacementValue(value, name) {