@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/spots/spot-activation-registry.js

@@ -37,26 +37,25 @@ class ZLinkSpotActivationRegistry {
             : this.activations.get(key);
     }
     resolveUnique(spotId) {
-        const matches = [...this.activations.values()]
-            .filter((activation) => String(activation.spotId) === String(spotId)
-            && !this.staged.has(spotActivationKey(activation.meshName, activation.spotId))
-            && !this.closing.has(spotActivationKey(activation.meshName, activation.spotId))
-            && !this.failedClose.has(spotActivationKey(activation.meshName, activation.spotId)));
+        const matches = [...this.activations.values()].filter((activation) => String(activation.spotId) === String(spotId) &&
+            !this.staged.has(spotActivationKey(activation.meshName, activation.spotId)) &&
+            !this.closing.has(spotActivationKey(activation.meshName, activation.spotId)) &&
+            !this.failedClose.has(spotActivationKey(activation.meshName, activation.spotId)));
         return matches.length === 1 ? matches[0] : undefined;
     }
     has(meshName, spotId) {
         const key = spotActivationKey(meshName, spotId);
-        return !this.staged.has(key)
-            && !this.closing.has(key)
-            && !this.failedClose.has(key)
-            && this.activations.has(key);
+        return (!this.staged.has(key) &&
+            !this.closing.has(key) &&
+            !this.failedClose.has(key) &&
+            this.activations.has(key));
     }
     canClose(meshName, spotId) {
         const key = spotActivationKey(meshName, spotId);
-        return !this.staged.has(key)
-            && !this.closing.has(key)
-            && !this.failedClose.has(key)
-            && this.activations.get(key)?.canClose() === true;
+        return (!this.staged.has(key) &&
+            !this.closing.has(key) &&
+            !this.failedClose.has(key) &&
+            this.activations.get(key)?.canClose() === true);
     }
     list(meshName) {
         return [...this.activations.values()]
@@ -169,7 +168,9 @@ class ZLinkSpotActivationRegistry {
         let occupiedAfterQuiescence = false;
         const ready = Promise.resolve()
             .then(() => close(activation))
-            .then(() => { completed = true; })
+            .then(() => {
+            completed = true;
+        })
             .catch((error) => {
             // The seal's post-quiescence recheck (spot-activation.ts
             // closeAfterSeal) found a new join and released the seal instead of

package/dist/runtime/spots/spot-activation-state.js

@@ -52,7 +52,9 @@ class ZLinkSpotActivation {
         this.spotType = options.spotType;
         this.spot = options.spot;
         this.serial = options.serial;
-        this.serialExecutor = options.serialExecutor ?? new spot_serial_executor_1.ZLinkSpotSerialExecutor(this.serial, this.executionMode, options.spotId);
+        this.serialExecutor =
+            options.serialExecutor ??
+                new spot_serial_executor_1.ZLinkSpotSerialExecutor(this.serial, this.executionMode, options.spotId);
         this.executionBarrier = options.executionBarrier ?? new execution_1.ZLinkExecutionBarrier();
         this.serialExecutor.setExecutionBarrier(this.executionBarrier);
         if (typeof options.timers.setExecutionBarrier === 'function') {
@@ -66,9 +68,7 @@ class ZLinkSpotActivation {
         this.actorDispatch = options.actorDispatch;
     }
     get objectGeneration() {
-        return this.domain.kind === 'instance'
-            ? this.domain.objectGeneration
-            : undefined;
+        return this.domain.kind === 'instance' ? this.domain.objectGeneration : undefined;
     }
     get executionMode() {
         return this.domain.kind === 'user'
@@ -83,15 +83,15 @@ class ZLinkSpotActivation {
     relocationReadyCall() {
         return {
             defer: () => {
-                if (this.relocationCoordinationMode !== contracts_1.ZLinkSpotRelocationCoordinationMode.ApplicationSignaled) {
+                if (this.relocationCoordinationMode !==
+                    contracts_1.ZLinkSpotRelocationCoordinationMode.ApplicationSignaled) {
                     throw new configuration_1.ZLinkConfigurationException('relocationReady().defer() requires ApplicationSignaled relocation readiness.');
                 }
                 if (!this.serial.isCurrentTurn) {
                     throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.InvalidOperation, 'relocationReady().defer() requires the current Spot handler turn.');
                 }
                 const turnId = this.serial.activeTurnId;
-                if (this.relocationReadyDeferredTurnId === turnId
-                    || this.relocationBoundaryConsumed) {
+                if (this.relocationReadyDeferredTurnId === turnId || this.relocationBoundaryConsumed) {
                     throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.InvalidOperation, 'relocationReady().defer() was already called for this boundary.');
                 }
                 this.relocationReadyDeferredTurnId = turnId;
@@ -106,7 +106,8 @@ class ZLinkSpotActivation {
                     return;
                 }
                 const seal = this.executionBarrier.seal();
-                void this.serial.postBarrierTurn(async () => {
+                void this.serial
+                    .postBarrierTurn(async () => {
                     try {
                         await this.notifyRelocationReadyCompleted(contracts_1.ZLinkSpotRelocationReadyOutcome.Continued);
                     }
@@ -114,7 +115,8 @@ class ZLinkSpotActivation {
                         this.relocationReadyDeferredTurnId = undefined;
                         this.executionBarrier.abort(seal);
                     }
-                }).catch(() => undefined);
+                })
+                    .catch(() => undefined);
             }
         };
     }
@@ -274,12 +276,12 @@ class ZLinkSpotActivation {
         return this.idleEvictionRequested;
     }
     isIdleFor(nowMs, timeoutMs) {
-        return !this.idleEvictionRequested
-            && !this.closeRequested
-            && !this.serial.isExecuting
-            && !this.serial.hasPendingWork
-            && !this.timers.hasActiveTimers
-            && nowMs - this.serial.lastActivityAt >= timeoutMs;
+        return (!this.idleEvictionRequested &&
+            !this.closeRequested &&
+            !this.serial.isExecuting &&
+            !this.serial.hasPendingWork &&
+            !this.timers.hasActiveTimers &&
+            nowMs - this.serial.lastActivityAt >= timeoutMs);
     }
     async notifyRelocationReadyCompleted(outcome) {
         await this.spot.onRelocationReadyCompleted?.({ outcome });

package/dist/runtime/spots/spot-activation.js

@@ -27,7 +27,7 @@ class ZLinkSpotActivationLifecycle {
     }
     async materializeRelocation(meshName, objectKind, stableType, implementation, spotId, objectGeneration, authorityOwnerGeneration, signal) {
         const executionMode = objectKind === 'user_spot'
-            ? this.options.userSpotExecutionMode?.(meshName, implementation) ?? contracts_1.ZLinkUserSpotExecutionMode.SpotWide
+            ? (this.options.userSpotExecutionMode?.(meshName, implementation) ?? contracts_1.ZLinkUserSpotExecutionMode.SpotWide)
             : contracts_1.ZLinkUserSpotExecutionMode.SpotWide;
         const serial = new spot_serial_turn_executor_1.ZLinkSpotSerialTurnExecutor(executionMode === contracts_1.ZLinkUserSpotExecutionMode.SpotWide, spotId);
         const serialExecutor = new spot_serial_executor_1.ZLinkSpotSerialExecutor(serial, executionMode, spotId);
@@ -190,7 +190,7 @@ class ZLinkSpotActivationLifecycle {
             timers,
             actorHandlers,
             handlers,
-            externalActorCount: () => this.options.actorCountProvider?.(spotId) ?? 0,
+            externalActorCount: () => this.options.actorCountProvider?.(spotId) ?? 0
         });
         try {
             await instance.configure?.();
@@ -243,14 +243,14 @@ class ZLinkSpotActivationLifecycle {
     }
     resourcesReleased(activation) {
         const state = this.cleanupStates.get(activation);
-        return state?.timersDisposed === true &&
+        return (state?.timersDisposed === true &&
             state.handlersDisposed === true &&
             state.nativeDisposed === true &&
-            state.locationReleased === true;
+            state.locationReleased === true);
     }
     async create(meshName, spotType, spotId, request, signal, authority) {
-        const executionMode = this.options.userSpotExecutionMode?.(meshName, spotType)
-            ?? contracts_1.ZLinkUserSpotExecutionMode.SpotWide;
+        const executionMode = this.options.userSpotExecutionMode?.(meshName, spotType) ??
+            contracts_1.ZLinkUserSpotExecutionMode.SpotWide;
         const serial = new spot_serial_turn_executor_1.ZLinkSpotSerialTurnExecutor(executionMode === contracts_1.ZLinkUserSpotExecutionMode.SpotWide, spotId);
         const serialExecutor = new spot_serial_executor_1.ZLinkSpotSerialExecutor(serial, executionMode, spotId);
         const actorHandlers = new actors_1.ZLinkSpotActorHandlerRegistryRuntime();
@@ -332,7 +332,8 @@ class ZLinkSpotActivationLifecycle {
                 domain: {
                     kind: 'user',
                     executionMode,
-                    relocationCoordinationMode: this.options.userSpotRelocationCoordinationMode?.(meshName, spotType) ?? contracts_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged
+                    relocationCoordinationMode: this.options.userSpotRelocationCoordinationMode?.(meshName, spotType) ??
+                        contracts_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged
                 },
                 spotType,
                 spot,
@@ -410,14 +411,19 @@ class ZLinkSpotActivationLifecycle {
             close: this.contextClose(meshName, spotId, () => activation)
         });
         spot = await (0, spot_provider_1.createFreshProviderInstance)(spotType, this.options.providerResolver, context);
-        Object.defineProperty(spot, 'context', { configurable: true, enumerable: false, value: context });
+        Object.defineProperty(spot, 'context', {
+            configurable: true,
+            enumerable: false,
+            value: context
+        });
         activation = new spot_activation_state_1.ZLinkSpotActivation({
             meshName,
             spotId,
             domain: {
                 kind: 'user',
                 executionMode,
-                relocationCoordinationMode: this.options.userSpotRelocationCoordinationMode?.(meshName, spotType) ?? contracts_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged
+                relocationCoordinationMode: this.options.userSpotRelocationCoordinationMode?.(meshName, spotType) ??
+                    contracts_1.ZLinkSpotRelocationCoordinationMode.FrameworkManaged
             },
             spotType,
             spot,
@@ -440,7 +446,9 @@ class ZLinkSpotActivationLifecycle {
             if (activation?.serial.isExecuting === true && !activation.serial.isCurrentTurn) {
                 activation.requestClose();
                 const retry = activation.serial.post(() => this.options.closeSpot(meshName, spotId, signal));
-                this.options.detachedTaskRunner?.runDetached(`spot close ${String(spotId)}`, async () => { await retry; });
+                this.options.detachedTaskRunner?.runDetached(`spot close ${String(spotId)}`, async () => {
+                    await retry;
+                });
                 if (this.options.detachedTaskRunner === undefined) {
                     void retry.catch(() => undefined);
                 }
@@ -540,8 +548,9 @@ class ZLinkSpotActivationLifecycle {
         this.cleanupStates.set(activation, state);
         if (state.inFlight !== undefined)
             return await state.inFlight;
-        state.inFlight = this.runCleanup(activation, locationMeshName, notifyClosing, reason, state, deadline)
-            .finally(() => { state.inFlight = undefined; });
+        state.inFlight = this.runCleanup(activation, locationMeshName, notifyClosing, reason, state, deadline).finally(() => {
+            state.inFlight = undefined;
+        });
         return await state.inFlight;
     }
     async runCleanup(activation, locationMeshName, notifyClosing, reason, state, deadline) {
@@ -560,18 +569,26 @@ class ZLinkSpotActivationLifecycle {
             await cleanup(() => (0, spot_closing_1.invokeSpotClosing)(activation.spot.onClosing?.bind(activation.spot), reason, deadline), () => undefined);
         }
         if (!state.timersDisposed) {
-            await cleanup(() => activation.timers.dispose(), () => { state.timersDisposed = true; });
+            await cleanup(() => activation.timers.dispose(), () => {
+                state.timersDisposed = true;
+            });
         }
         await cleanup(() => activation.serialExecutor.close(), () => undefined);
         if (!state.handlersDisposed) {
-            await cleanup(() => (0, handler_instance_scope_1.disposeLifecycleHandlers)(activation.spot), () => { state.handlersDisposed = true; });
+            await cleanup(() => (0, handler_instance_scope_1.disposeLifecycleHandlers)(activation.spot), () => {
+                state.handlersDisposed = true;
+            });
         }
         if (!state.nativeDisposed) {
             await cleanup(() => activation.actorDispatch?.dispose(), () => undefined);
-            await cleanup(() => activation.nativeSpot?.dispose(), () => { state.nativeDisposed = true; });
+            await cleanup(() => activation.nativeSpot?.dispose(), () => {
+                state.nativeDisposed = true;
+            });
         }
         if (!state.locationReleased) {
-            await cleanup(() => this.options.releaseLocation(activation, locationMeshName, activation.spotId), () => { state.locationReleased = true; });
+            await cleanup(() => this.options.releaseLocation(activation, locationMeshName, activation.spotId), () => {
+                state.locationReleased = true;
+            });
         }
         if (errors.length === 1)
             throw errors[0];

package/dist/runtime/spots/spot-actor-admission-coordinator.js

@@ -27,13 +27,15 @@ class ZLinkSpotActorAdmissionCoordinator {
             actors: {
                 resolveActor: (actorId) => activation.hasDepartedActor(actorId)
                     ? undefined
-                    : activation.resolveJoinedActor(actorId) ?? this.options.actorResolver?.(actorId),
+                    : (activation.resolveJoinedActor(actorId) ?? this.options.actorResolver?.(actorId)),
                 getTarget: () => activation.spot,
                 defaultAccept: false,
-                transfer: this.options.actorTransferRuntime === undefined ? { kind: 'disabled' } : {
-                    kind: 'enabled',
-                    runtime: this.options.actorTransferRuntime
-                },
+                transfer: this.options.actorTransferRuntime === undefined
+                    ? { kind: 'disabled' }
+                    : {
+                        kind: 'enabled',
+                        runtime: this.options.actorTransferRuntime
+                    },
                 commitNativeActor: (actor) => this.commitNativeActorTransaction(activation, actor),
                 commitActorDeparture: (actorId) => activation.commitActorDeparture(actorId),
                 commitTransferredActor: (actor, backlog) => this.commitTransferredActorTransaction(activation, actor, backlog)
@@ -50,7 +52,9 @@ class ZLinkSpotActorAdmissionCoordinator {
                     }
                     node.bindRemoteActorSession(actor, sourceNodeRid, sourceSessionRid);
                 },
-                replyNoBind: (info, parts, result) => this.options.nativeSpotNodeProvider?.(activation.meshName)?.replyActorNoBind(info, parts, result)
+                replyNoBind: (info, parts, result) => this.options
+                    .nativeSpotNodeProvider?.(activation.meshName)
+                    ?.replyActorNoBind(info, parts, result)
             },
             boundSessionRuntime: this.options.boundSessionRuntime,
             messageSerializers: this.options.messageSerializers,
@@ -66,7 +70,7 @@ class ZLinkSpotActorAdmissionCoordinator {
     }
     /** @internal Dispatches a coordinator-owned replay without recapturing it. */
     dispatchActorPacketDirect(activation, actorId, parts, returnResponse = false, remoteBoundSessionTarget, fallbackActorRef, requestTerminal) {
-        return activation.executeActor(actorId, actorSerial => this.dispatchActorPacketInActorTurn(activation, actorSerial, actorId, parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef, requestTerminal));
+        return activation.executeActor(actorId, (actorSerial) => this.dispatchActorPacketInActorTurn(activation, actorSerial, actorId, parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef, requestTerminal));
     }
     /**
      * Atomically restores one durable packet prefix at the Actor FIFO tail.
@@ -76,13 +80,13 @@ class ZLinkSpotActorAdmissionCoordinator {
      * @internal
      */
     admitActorPacketPrefix(activation, actorId, records) {
-        const terminals = activation.admitActorDurablePrefix(actorId, records.map(record => ({
-            operation: executeChild => record.drain((parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef) => executeChild(actorSerial => this.dispatchActorPacketInActorTurn(activation, actorSerial, actorId, parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef))),
+        const terminals = activation.admitActorDurablePrefix(actorId, records.map((record) => ({
+            operation: (executeChild) => record.drain((parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef) => executeChild((actorSerial) => this.dispatchActorPacketInActorTurn(activation, actorSerial, actorId, parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef))),
             preparation: record.preparation,
             workOptions: { payloadBytes: record.payloadBytes }
         })));
-        const terminal = Promise.allSettled(terminals).then(outcomes => {
-            const errors = outcomes.flatMap(outcome => outcome.status === 'rejected' ? [outcome.reason] : []);
+        const terminal = Promise.allSettled(terminals).then((outcomes) => {
+            const errors = outcomes.flatMap((outcome) => outcome.status === 'rejected' ? [outcome.reason] : []);
             if (errors.length === 1)
                 throw errors[0];
             if (errors.length > 1) {
@@ -99,7 +103,8 @@ class ZLinkSpotActorAdmissionCoordinator {
             serial: actorSerial,
             resolveActor: (targetActorId) => activation.hasDepartedActor(targetActorId)
                 ? undefined
-                : activation.resolveJoinedActor(targetActorId) ?? this.options.actorResolver?.(targetActorId),
+                : (activation.resolveJoinedActor(targetActorId) ??
+                    this.options.actorResolver?.(targetActorId)),
             actorLeft: (targetActorId) => activation.hasDepartedActor(targetActorId),
             onRemoteBoundSessionTarget: (targetActorId, target) => this.options.boundSessionRuntime?.rememberRemoteBoundSessionTarget(targetActorId, target),
             onDisconnectActor: (actor) => activation.serial.execute(() => activation.spot.onDisconnectActor?.(actor)),
@@ -149,9 +154,7 @@ class ZLinkSpotActorAdmissionCoordinator {
             activation.commitActorJoin(actor);
             activation.beginActorTransfer(actor.context.actorId);
             await activation.serial.execute(() => activation.spot.onJoinedActor(actor));
-            const results = backlog.length === 0
-                ? []
-                : await this.replayActorBacklog(activation, actor, backlog);
+            const results = backlog.length === 0 ? [] : await this.replayActorBacklog(activation, actor, backlog);
             await transfer?.claimRoutedActorLocation(actor, activation.spotId, activation.meshName);
             routeSwitchStarted = true;
             await transfer?.publishRoutedActorOwnership(actor);

package/dist/runtime/spots/spot-actor-membership.js

@@ -58,9 +58,7 @@ class ZLinkSpotActorMembership {
             this.options.entryNodeRidProvider?.() ??
             this.options.entryNodeRid ??
             this.options.nodeRid;
-        const entrySpotId = meshName === undefined
-            ? undefined
-            : this.options.entrySpotIdProvider?.(meshName);
+        const entrySpotId = meshName === undefined ? undefined : this.options.entrySpotIdProvider?.(meshName);
         const resolvedEntry = entrySpotId === undefined
             ? undefined
             : await this.options.spotRouteResolver?.resolve(entrySpotId, signal);

package/dist/runtime/spots/spot-actor-packet-dispatch.d.ts

@@ -1,4 +1,4 @@
-import type { ActorRef, ZLinkActor, ZLinkMessageSerializer, ZLinkSpot } from '../../contracts';
+import type { ActorRef, RoutingId, ZLinkActor, ZLinkMessageSerializer, ZLinkSpot } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
 import type { ZLinkRemoteBoundSessionTarget } from '../actors';
 import { ZLinkSpotActorHandlerRegistryRuntime } from '../actors';
@@ -24,6 +24,7 @@ export interface ZLinkActorPacketDelivery {
     readonly fallbackActorRef?: ActorRef;
     readonly requestTerminal?: ZLinkActorRequestTerminal;
     readonly messageFollowOrigin?: ZLinkMessageFollowOrigin;
+    readonly sourceSessionRid?: RoutingId;
 }
 /**
  * Spec 15 §4.2 relocation temporary queue: consulted when {@code

package/dist/runtime/spots/spot-actor-packet-dispatch.js

@@ -6,6 +6,7 @@ const contracts_1 = require("../../contracts");
 const ZLinkDispatchOptions_1 = require("../../contracts/Dispatch/ZLinkDispatchOptions");
 const diagnostics_1 = require("../diagnostics");
 const flow_context_1 = require("../diagnostics/flow-context");
+const managed_stream_1 = require("../streams/managed-stream");
 const actors_1 = require("../actors");
 const protocol_1 = require("../streams/protocol");
 const payload_codec_1 = require("../messaging/payload-codec");
@@ -39,15 +40,20 @@ class ZLinkSpotActorPacketDispatch {
         let requestDeadlineUnixMs;
         try {
             header = (0, protocol_1.decodeStreamHeader)((0, protocol_1.messageToBytes)(parts[0]), flowEnabled);
-            requestDeadlineUnixMs = header.kind === protocol_1.ZLinkStreamMessageKind.Request
-                ? (0, protocol_1.decodeActorRequestDeadlineUnixMs)((0, protocol_1.messageToBytes)(parts[0]))
-                : undefined;
+            requestDeadlineUnixMs =
+                header.kind === protocol_1.ZLinkStreamMessageKind.Request
+                    ? (0, protocol_1.decodeActorRequestDeadlineUnixMs)((0, protocol_1.messageToBytes)(parts[0]))
+                    : undefined;
         }
         catch (error) {
             this.reportInvalidFrame(actorId, ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorSend, error);
             throw error;
         }
-        return (0, flow_context_1.runWithFlow)((0, flow_context_1.createInboundFlow)(header.flowId, header.flowOrigin, flowEnabled), async () => {
+        return (0, flow_context_1.runWithFlow)((0, flow_context_1.createInboundFlow)(header.flowId, header.flowOrigin, flowEnabled, !flowEnabled
+            ? undefined
+            : delivery.sourceSessionRid === undefined
+                ? (0, flow_context_1.currentFlowContext)()?.streamSessionId
+                : (0, managed_stream_1.streamSessionIdFromRoutingId)(delivery.sourceSessionRid)), async () => {
             const messageKind = header.kind === protocol_1.ZLinkStreamMessageKind.Request
                 ? ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorRequest
                 : ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorSend;
@@ -59,8 +65,8 @@ class ZLinkSpotActorPacketDispatch {
                 header.name === actors_1.ZLINK_REMOTE_ACTOR_SESSION_DISCONNECTED_PACKET) {
                 return undefined;
             }
-            if (remoteBoundSessionTarget !== undefined
-                && (0, actors_1.actorMessageFollowContext)(fallbackActorRef) === undefined) {
+            if (remoteBoundSessionTarget !== undefined &&
+                (0, actors_1.actorMessageFollowContext)(fallbackActorRef) === undefined) {
                 // A replayed handoff/Message Follow packet keeps its captured Session
                 // route solely for that packet's response. It cannot republish the
                 // predecessor route over a binding already confirmed by a later Actor
@@ -85,14 +91,14 @@ class ZLinkSpotActorPacketDispatch {
         });
     }
     async handleMissingActor(actorId, parts, header, messageKind, action, returnResponse, fallbackBoundSessionTarget, fallbackActorRef, requestTerminal) {
-        if (this.options.routeToActorJoinPrewarm !== undefined
-            && fallbackActorRef !== undefined
-            && parts.length >= 2
+        if (this.options.routeToActorJoinPrewarm !== undefined &&
+            fallbackActorRef !== undefined &&
+            parts.length >= 2 &&
             //  A Request without a terminal has no way to complete once
             //  migrated later — parking it would leave the caller hanging
             //  forever with no reply route. Fall through to the existing
             //  missing-actor handling for that shape instead.
-            && (messageKind !== ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorRequest || requestTerminal !== undefined)) {
+            (messageKind !== ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorRequest || requestTerminal !== undefined)) {
             const parked = this.parkForActorJoinPrewarm(actorId, parts, messageKind, returnResponse, fallbackBoundSessionTarget, fallbackActorRef, requestTerminal);
             if (parked !== undefined)
                 return parked;
@@ -111,7 +117,9 @@ class ZLinkSpotActorPacketDispatch {
             return undefined;
         }
         const missingActorError = (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound, `SPOT actor is not registered locally: ${actorId}`);
-        if (header.requestSeq !== undefined && !returnResponse && this.options.actorErrorSender !== undefined) {
+        if (header.requestSeq !== undefined &&
+            !returnResponse &&
+            this.options.actorErrorSender !== undefined) {
             await this.options.actorErrorSender(actorId, header.name, header.requestSeq, missingActorError, header.metadata, fallbackBoundSessionTarget, fallbackActorRef);
             return undefined;
         }
@@ -177,9 +185,7 @@ class ZLinkSpotActorPacketDispatch {
         return () => (0, payload_codec_1.decodeFrameworkTypedPayloadMessage)(message, this.options.messageSerializers, undefined, (0, protocol_1.streamCodecContentType)(header.codec), header.name);
     }
     async dispatchActorPacket(actor, actorId, decodePayload, header, messageKind, action, returnResponse, fallbackBoundSessionTarget, fallbackActorRef, requestTerminal, requestDeadlineUnixMs, workOptions) {
-        const spot = typeof this.options.spot === 'function'
-            ? this.options.spot()
-            : this.options.spot;
+        const spot = typeof this.options.spot === 'function' ? this.options.spot() : this.options.spot;
         const dispatcher = new actors_1.ZLinkSpotActorDispatcher({
             registry: this.options.registry,
             spot,
@@ -192,9 +198,9 @@ class ZLinkSpotActorPacketDispatch {
                 // A transferred backlog is returned to the Actor queue as one FIFO
                 // prefix. Check the request deadline when its owner turn actually
                 // starts, not when that prefix is admitted.
-                if (messageKind === ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorRequest
-                    && requestDeadlineUnixMs !== undefined
-                    && Date.now() >= requestDeadlineUnixMs) {
+                if (messageKind === ZLinkDispatchOptions_1.ZLinkDispatchMessageKind.ActorRequest &&
+                    requestDeadlineUnixMs !== undefined &&
+                    Date.now() >= requestDeadlineUnixMs) {
                     throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded, `Actor request '${actorId}' expired before handler admission.`);
                 }
                 (0, application_job_queue_scope_1.releaseApplicationJobPermitBeforeHandler)();
@@ -265,11 +271,13 @@ class ZLinkSpotActorPacketDispatch {
             this.options.dispatchErrors?.report({
                 surface: ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.SpotActor,
                 messageKind,
-                reason: error instanceof contracts_1.ZLinkFrameworkException
-                    && (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound
+                reason: error instanceof contracts_1.ZLinkFrameworkException &&
+                    (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) ===
+                        framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound
                     ? ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.HandlerMissing
-                    : error instanceof contracts_1.ZLinkFrameworkException
-                        && (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed
+                    : error instanceof contracts_1.ZLinkFrameworkException &&
+                        (0, framework_errors_internal_1.internalFrameworkErrorKind)(error) ===
+                            framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed
                         ? ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.PayloadDecodeFailed
                         : ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.HandlerException,
                 action,

package/dist/runtime/spots/spot-actor-packet-drain.js

@@ -86,6 +86,7 @@ class ZLinkSpotActorPacketDrain {
                     actorId,
                     parts,
                     returnResponse: false,
+                    sourceSessionRid,
                     fallbackActorRef: actorRef
                 });
             }
@@ -102,15 +103,15 @@ class ZLinkSpotActorPacketDrain {
         this.continuations.clear();
     }
     createNoBindReplyInfo(actor, sourceNodeRid, sourceSessionRid, requestId, flags, parts) {
-        if (actor === undefined
-            || sourceNodeRid === undefined
-            || sourceSessionRid === undefined
-            || requestId === undefined
-            || requestId === 0n
-            || flags === undefined
-            || (flags & ZLINK_SPOT_ACTOR_RECV_INFO_NO_BIND) === 0
-            || this.options.replyActorNoBind === undefined
-            || !this.isActorRequest(parts)) {
+        if (actor === undefined ||
+            sourceNodeRid === undefined ||
+            sourceSessionRid === undefined ||
+            requestId === undefined ||
+            requestId === 0n ||
+            flags === undefined ||
+            (flags & ZLINK_SPOT_ACTOR_RECV_INFO_NO_BIND) === 0 ||
+            this.options.replyActorNoBind === undefined ||
+            !this.isActorRequest(parts)) {
             return undefined;
         }
         return { actor, sourceNodeRid, sourceSessionRid, requestId, flags };
@@ -133,12 +134,15 @@ class ZLinkSpotActorPacketDrain {
                 actorId,
                 parts,
                 returnResponse: true,
+                sourceSessionRid: info.sourceSessionRid,
                 fallbackActorRef: actorRef
             });
             this.options.replyActorNoBind?.(info, [this.encodeActorReplyFrame(parts[0], protocol_1.ZLinkStreamMessageKind.Response, response)], runtime_values_1.RequestResult.Ok);
         }
         catch (error) {
-            this.options.replyActorNoBind?.(info, [this.encodeActorReplyFrame(parts[0], protocol_1.ZLinkStreamMessageKind.Error, frameworkErrorPayload(error))], runtime_values_1.RequestResult.Ok);
+            this.options.replyActorNoBind?.(info, [
+                this.encodeActorReplyFrame(parts[0], protocol_1.ZLinkStreamMessageKind.Error, frameworkErrorPayload(error))
+            ], runtime_values_1.RequestResult.Ok);
         }
     }
     encodeActorReplyFrame(requestHeaderPart, kind, payload) {

package/dist/runtime/spots/spot-actor-packet-relay-dispatch.js

@@ -59,8 +59,8 @@ class ZLinkSpotActorPacketRelayDispatch {
                 }
                 return true;
             }
-            if (actorPacketRelay.messageFollowContext?.deadlineUnixMs !== undefined
-                && Date.now() >= actorPacketRelay.messageFollowContext.deadlineUnixMs) {
+            if (actorPacketRelay.messageFollowContext?.deadlineUnixMs !== undefined &&
+                Date.now() >= actorPacketRelay.messageFollowContext.deadlineUnixMs) {
                 throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded, `Actor request '${actorPacketRelay.actorId}' expired before target handler admission.`);
             }
             //  Spec 28 §5.2/§10 — a Message Follow relay is a one-way send that
@@ -71,9 +71,9 @@ class ZLinkSpotActorPacketRelayDispatch {
             //  actorErrorSender instead of returning it locally, where it would
             //  be discarded. Non-follow relays keep the synchronous-return path.
             const outerReplyable = (0, spot_route_replies_1.hasReplyToken)(received.replyToken);
-            const followedBoundSessionReply = !outerReplyable
-                && actorPacketRelay.messageFollowContext !== undefined
-                && remoteBoundSessionTarget !== undefined;
+            const followedBoundSessionReply = !outerReplyable &&
+                actorPacketRelay.messageFollowContext !== undefined &&
+                remoteBoundSessionTarget !== undefined;
             const response = await this.options.actorPacketHandler({
                 actorId: actorPacketRelay.actorId,
                 parts: [header, payload],
@@ -83,7 +83,11 @@ class ZLinkSpotActorPacketRelayDispatch {
             });
             const actorPacketTarget = this.actorPacketTarget(actorPacketRelay.actorId);
             if ((0, spot_route_replies_1.hasReplyToken)(received.replyToken)) {
-                (0, spot_route_replies_1.submitSpotRouteBridgeReply)(received, actorPacketRelay.envelope, { ok: true, response, actorPacketTarget });
+                (0, spot_route_replies_1.submitSpotRouteBridgeReply)(received, actorPacketRelay.envelope, {
+                    ok: true,
+                    response,
+                    actorPacketTarget
+                });
             }
             return true;
         }

package/dist/runtime/spots/spot-closing.js

@@ -5,15 +5,11 @@ const DEFAULT_CLEANUP_TIMEOUT_MS = 30_000;
 async function invokeSpotClosing(callback, reason, cleanupDeadline = DEFAULT_CLEANUP_TIMEOUT_MS) {
     if (callback === undefined)
         return;
-    const deadline = new Date(cleanupDeadline instanceof Date
-        ? cleanupDeadline.getTime()
-        : Date.now() + cleanupDeadline);
-    const timeoutMs = Math.max(0, cleanupDeadline instanceof Date
-        ? cleanupDeadline.getTime() - Date.now()
-        : cleanupDeadline);
+    const deadline = new Date(cleanupDeadline instanceof Date ? cleanupDeadline.getTime() : Date.now() + cleanupDeadline);
+    const timeoutMs = Math.max(0, cleanupDeadline instanceof Date ? cleanupDeadline.getTime() - Date.now() : cleanupDeadline);
     const controller = new AbortController();
     let timer;
-    const expired = new Promise(resolve => {
+    const expired = new Promise((resolve) => {
         timer = setTimeout(() => {
             controller.abort();
             resolve();

package/dist/runtime/spots/spot-context.js

@@ -44,11 +44,11 @@ function createSpotContext(options) {
         },
         relocationReady: () => {
             options.ensureOperationAllowed?.();
-            return options.relocationReady?.() ?? {
+            return (options.relocationReady?.() ?? {
                 defer() {
                     throw new configuration_1.ZLinkConfigurationException('Spot relocation readiness is not configured for application signaling.');
                 }
-            };
+            });
         },
         leaveActor: (actor, signal) => {
             options.ensureOperationAllowed?.();