@zlink-systems/framework 0.21.0 → 0.22.0

package/dist/runtime/spots/index.js

@@ -168,8 +168,8 @@ class DefaultZLinkSpotManager {
                     return this.locationClaim.release(meshName, spotId);
                 }
                 const currentApplication = this.options.instanceSpotApplicationTargetProvider?.(meshName, spotId);
-                if (currentApplication !== undefined
-                    && currentApplication.objectGeneration !== activation.domain.objectGeneration) {
+                if (currentApplication !== undefined &&
+                    currentApplication.objectGeneration !== activation.domain.objectGeneration) {
                     // A superseded local application must not release the authority row
                     // that now belongs to the newer object generation.
                     return Promise.resolve();
@@ -191,8 +191,10 @@ class DefaultZLinkSpotManager {
         return this.options.entrySpotIdProvider?.(meshName);
     }
     relocationActivations(meshName) {
-        return this.activations.activeActivations().filter(activation => activation.meshName === meshName
-            && this.activations.resolve(meshName, activation.spotId) === activation);
+        return this.activations
+            .activeActivations()
+            .filter((activation) => activation.meshName === meshName &&
+            this.activations.resolve(meshName, activation.spotId) === activation);
     }
     activeSpotCount(meshName) {
         return this.activations.list(meshName).length;
@@ -269,8 +271,7 @@ class DefaultZLinkSpotManager {
                 }
                 if (current.objectGeneration === objectGeneration)
                     return;
-                if (current.objectGeneration === undefined
-                    || current.objectGeneration > objectGeneration) {
+                if (current.objectGeneration === undefined || current.objectGeneration > objectGeneration) {
                     throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale, `Instance Spot '${String(spotId)}' has a newer application generation.`);
                 }
                 // A newer authority route may become visible while the previous
@@ -281,16 +282,16 @@ class DefaultZLinkSpotManager {
                 await this.discardInstance(meshName, spotId);
                 continue;
             }
-            const lifecycleActivation = this.activations.activeActivations().find((activation) => activation.meshName === meshName && String(activation.spotId) === String(spotId));
+            const lifecycleActivation = this.activations
+                .activeActivations()
+                .find((activation) => activation.meshName === meshName && String(activation.spotId) === String(spotId));
             if (lifecycleActivation?.isIdleEvicting === true) {
                 throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale, `Instance Spot '${String(spotId)}' is entering idle eviction.`);
             }
             let pending = this.pendingInstanceMaterializations.get(materializationKey);
             if (pending === undefined) {
                 const siblings = this.pendingInstanceMaterializationsByPrefix.get(materializationPrefix);
-                const otherPending = siblings === undefined
-                    ? undefined
-                    : siblings.values().next().value;
+                const otherPending = siblings === undefined ? undefined : siblings.values().next().value;
                 if (otherPending !== undefined) {
                     await (0, abort_1.awaitWithAbort)(otherPending, signal);
                     continue;
@@ -298,10 +299,12 @@ class DefaultZLinkSpotManager {
             }
             if (pending === undefined) {
                 const metric = this.options.metrics?.startInstanceSpotActivation(meshName, instanceType);
-                pending = this.activationLifecycle.materializeInstance(meshName, instanceType, factory, spotId, objectGeneration, signal).then(activation => {
+                pending = this.activationLifecycle
+                    .materializeInstance(meshName, instanceType, factory, spotId, objectGeneration, signal)
+                    .then((activation) => {
                     metric?.complete('ready');
                     return activation;
-                }, error => {
+                }, (error) => {
                     metric?.complete(instanceActivationOutcome(error));
                     throw error;
                 });
@@ -312,7 +315,8 @@ class DefaultZLinkSpotManager {
                     this.pendingInstanceMaterializationsByPrefix.set(materializationPrefix, siblings);
                 }
                 siblings.set(materializationKey, pending);
-                void pending.finally(() => {
+                void pending
+                    .finally(() => {
                     if (this.pendingInstanceMaterializations.get(materializationKey) === pending) {
                         this.pendingInstanceMaterializations.delete(materializationKey);
                     }
@@ -323,7 +327,8 @@ class DefaultZLinkSpotManager {
                             this.pendingInstanceMaterializationsByPrefix.delete(materializationPrefix);
                         }
                     }
-                }).catch(() => undefined);
+                })
+                    .catch(() => undefined);
             }
             await pending;
             return;
@@ -383,8 +388,8 @@ class DefaultZLinkSpotManager {
     }
     isInstanceMaterialized(meshName, instanceType, spotId) {
         const activation = this.activations.resolve(meshName, spotId);
-        return activation !== undefined
-            && activation.spotType === this.requireInstanceFactory(meshName, instanceType);
+        return (activation !== undefined &&
+            activation.spotType === this.requireInstanceFactory(meshName, instanceType));
     }
     isInstanceMaterializing(meshName, spotId) {
         const prefix = instanceMaterializationPrefix(meshName, spotId);
@@ -392,8 +397,8 @@ class DefaultZLinkSpotManager {
     }
     isInstanceClosing(meshName, spotId) {
         const key = `${meshName}\0${String(spotId)}`;
-        return this.pendingInstanceCloses.has(key)
-            || this.activations.closingOperation(meshName, spotId) !== undefined;
+        return (this.pendingInstanceCloses.has(key) ||
+            this.activations.closingOperation(meshName, spotId) !== undefined);
     }
     async discardInstance(meshName, spotId) {
         const activation = this.activations.resolve(meshName, spotId);
@@ -404,16 +409,18 @@ class DefaultZLinkSpotManager {
         await operation?.ready;
     }
     isInstanceSpotIdleEvicting(meshName, spotId) {
-        const activation = this.activations.activeActivations().find((candidate) => candidate.meshName === meshName && String(candidate.spotId) === String(spotId));
-        return activation !== undefined
-            && activation.domain.kind === 'instance'
-            && activation.isIdleEvicting;
+        const activation = this.activations
+            .activeActivations()
+            .find((candidate) => candidate.meshName === meshName && String(candidate.spotId) === String(spotId));
+        return (activation !== undefined && activation.domain.kind === 'instance' && activation.isIdleEvicting);
     }
     beginInstanceSpotIdleEviction(meshName, spotId) {
-        const activation = this.activations.activeActivations().find((candidate) => candidate.meshName === meshName && String(candidate.spotId) === String(spotId));
-        if (activation === undefined
-            || activation.domain.kind !== 'instance'
-            || !activation.isIdleFor(performance.now(), this.options.instanceSpotIdleTimeoutMs?.get(meshName) ?? 0)) {
+        const activation = this.activations
+            .activeActivations()
+            .find((candidate) => candidate.meshName === meshName && String(candidate.spotId) === String(spotId));
+        if (activation === undefined ||
+            activation.domain.kind !== 'instance' ||
+            !activation.isIdleFor(performance.now(), this.options.instanceSpotIdleTimeoutMs?.get(meshName) ?? 0)) {
             return false;
         }
         return activation.beginIdleEviction();
@@ -437,13 +444,12 @@ class DefaultZLinkSpotManager {
             return true;
         }
         const deferredRelease = this.deferredInstanceAuthorityReleases.get(key)?.has(objectGeneration) === true;
-        if (!deferredRelease
-            && this.activations.closingOperation(meshName, spotId) === undefined) {
+        if (!deferredRelease && this.activations.closingOperation(meshName, spotId) === undefined) {
             return false;
         }
         const currentApplication = this.options.instanceSpotApplicationTargetProvider?.(meshName, spotId);
-        if (currentApplication !== undefined
-            && currentApplication.objectGeneration !== objectGeneration) {
+        if (currentApplication !== undefined &&
+            currentApplication.objectGeneration !== objectGeneration) {
             this.removeDeferredInstanceAuthorityRelease(key, objectGeneration);
             return false;
         }
@@ -484,8 +490,8 @@ class DefaultZLinkSpotManager {
             generations.set(generationKey, pending - 1);
     }
     releaseInstanceAuthority(meshName, spotId, objectGeneration) {
-        return this.options.releaseInstanceAuthority?.(meshName, spotId, objectGeneration)
-            ?? Promise.resolve();
+        return (this.options.releaseInstanceAuthority?.(meshName, spotId, objectGeneration) ??
+            Promise.resolve());
     }
     requireInstanceFactory(meshName, instanceType) {
         const factory = this.options.instanceSpotFactories?.get(meshName)?.get(instanceType);
@@ -499,8 +505,7 @@ class DefaultZLinkSpotManager {
             return;
         if (!this.hasIdleSweepTarget())
             return;
-        const delays = [...(this.options.instanceSpotIdleTimeoutMs?.values() ?? [])]
-            .filter((value) => value > 0);
+        const delays = [...(this.options.instanceSpotIdleTimeoutMs?.values() ?? [])].filter((value) => value > 0);
         if (delays.length === 0)
             return;
         const delay = Math.max(1, Math.min(...delays));
@@ -522,10 +527,10 @@ class DefaultZLinkSpotManager {
             const now = performance.now();
             for (const activation of this.activations.nextActiveActivationBatch()) {
                 const timeoutMs = this.options.instanceSpotIdleTimeoutMs?.get(activation.meshName) ?? 0;
-                if (timeoutMs <= 0
-                    || activation.domain.kind !== 'instance'
-                    || !activation.isIdleFor(now, timeoutMs)
-                    || !activation.beginIdleEviction()) {
+                if (timeoutMs <= 0 ||
+                    activation.domain.kind !== 'instance' ||
+                    !activation.isIdleFor(now, timeoutMs) ||
+                    !activation.beginIdleEviction()) {
                     continue;
                 }
                 let durableClosing;
@@ -613,12 +618,13 @@ class DefaultZLinkSpotManager {
         return this.activations.list(meshName);
     }
     async drainForShutdown(meshName, signal, deadline) {
-        const results = await Promise.allSettled(this.activations.activeActivations()
-            .filter(activation => activation.meshName === meshName)
-            .map(activation => this.closeWithReason(meshName, activation.spotId, signal, contracts_1.ZLinkSpotCloseReason.HostShutdown, deadline)));
+        const results = await Promise.allSettled(this.activations
+            .activeActivations()
+            .filter((activation) => activation.meshName === meshName)
+            .map((activation) => this.closeWithReason(meshName, activation.spotId, signal, contracts_1.ZLinkSpotCloseReason.HostShutdown, deadline)));
         const errors = results
             .filter((result) => result.status === 'rejected')
-            .map(result => result.reason);
+            .map((result) => result.reason);
         if (errors.length === 1)
             throw errors[0];
         if (errors.length > 1)
@@ -694,7 +700,9 @@ class DefaultZLinkSpotManager {
                 // release the activation recovery fence and allow the durable close
                 // CAS. The registered close gate prevents a second admission while
                 // that detached close finishes.
-                this.options.detachedTaskRunner?.runDetached(`instance spot close ${String(spotId)}`, async () => { await trackedClosePromise; });
+                this.options.detachedTaskRunner?.runDetached(`instance spot close ${String(spotId)}`, async () => {
+                    await trackedClosePromise;
+                });
                 if (this.options.detachedTaskRunner === undefined) {
                     void trackedClosePromise.catch(() => undefined);
                 }
@@ -708,7 +716,9 @@ class DefaultZLinkSpotManager {
         }
         if (currentTurn) {
             if (operation.started) {
-                this.options.detachedTaskRunner?.runDetached(`spot close ${String(spotId)}`, async () => { await operation.ready; });
+                this.options.detachedTaskRunner?.runDetached(`spot close ${String(spotId)}`, async () => {
+                    await operation.ready;
+                });
                 if (this.options.detachedTaskRunner === undefined) {
                     void operation.ready.catch(() => undefined);
                 }
@@ -877,9 +887,9 @@ class DefaultZLinkSpotManager {
             return;
         for (;;) {
             const current = this.activations.resolve(meshName, spotId);
-            if (current !== undefined
-                && current.objectGeneration === target.objectGeneration
-                && current.spotType === this.requireInstanceFactory(meshName, target.stableType))
+            if (current !== undefined &&
+                current.objectGeneration === target.objectGeneration &&
+                current.spotType === this.requireInstanceFactory(meshName, target.stableType))
                 return;
             await this.materializeInstance(meshName, target.stableType, spotId, target.objectGeneration);
             const latest = this.options.instanceSpotApplicationTargetProvider?.(meshName, spotId);
@@ -908,8 +918,8 @@ class DefaultZLinkSpotManager {
                     throw new configuration_1.ZLinkConfigurationException(`MeshNode Instance Spot target '${String(spotId)}' is not active.`);
                 }
                 const target = this.options.instanceSpotApplicationTargetProvider?.(meshName, spotId);
-                if (target !== undefined
-                    && activation.domain.objectGeneration !== target.objectGeneration) {
+                if (target !== undefined &&
+                    activation.domain.objectGeneration !== target.objectGeneration) {
                     throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale, `Instance Spot target '${String(spotId)}' application generation is stale.`);
                 }
                 const codecs = this.options.messageSerializers === undefined
@@ -920,7 +930,8 @@ class DefaultZLinkSpotManager {
                     channelName: envelope.header.channelName,
                     contentType: envelope.header.contentType,
                     awaitFirstHandlerTurn: record.kind === service_runtime_contracts_1.ReceiveKind.InstanceSpotActivation,
-                    workOptions: (0, serial_work_size_1.zlinkSerialWorkOptions)(envelope.payload.byteLength, record.applicationMetadata?.byteLength ?? (0, serial_work_size_1.zlinkMetadataByteLength)(envelope.header.metadata))
+                    workOptions: (0, serial_work_size_1.zlinkSerialWorkOptions)(envelope.payload.byteLength, record.applicationMetadata?.byteLength ??
+                        (0, serial_work_size_1.zlinkMetadataByteLength)(envelope.header.metadata))
                 };
                 this.traceInstanceMessage(ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Admitted, meshName, spotId, record, envelope, 'ready', target?.stableType);
                 if (!request) {
@@ -949,7 +960,8 @@ class DefaultZLinkSpotManager {
                     correlationId: envelope.header.correlationId ?? undefined,
                     sourceRid: record.sourceNodeRid === null ? undefined : String(record.sourceNodeRid),
                     spotId: String(spotId),
-                    instanceSpotType: this.options.instanceSpotApplicationTargetProvider?.(meshName, spotId)?.stableType,
+                    instanceSpotType: this.options.instanceSpotApplicationTargetProvider?.(meshName, spotId)
+                        ?.stableType,
                     activationState: 'closing',
                     flowId: envelope.header.flowId,
                     flowOrigin: envelope.header.flowOrigin,
@@ -987,8 +999,7 @@ class DefaultZLinkSpotManager {
     async dispatchMeshActor(meshName, owner, record) {
         const spotId = owner.spotId;
         const entrySpotId = this.options.entryNodeRidProvider?.() ?? this.options.entryNodeRid;
-        const targetsEntrySpot = spotId === null
-            || (entrySpotId !== undefined && spotId === entrySpotId);
+        const targetsEntrySpot = spotId === null || (entrySpotId !== undefined && spotId === entrySpotId);
         const actor = owner.actor;
         if (actor === null) {
             throw new configuration_1.ZLinkConfigurationException('MeshNode Actor record is missing its Actor owner.');
@@ -1068,12 +1079,9 @@ class DefaultZLinkSpotManager {
         }
         const entrySpotId = this.options.entryNodeRidProvider?.() ?? this.options.entryNodeRid;
         let requestContentType = record.contentType ?? 'application/json';
-        const targetsEntrySpot = entrySpotId !== undefined
-            && String(spotId) === String(entrySpotId);
+        const targetsEntrySpot = entrySpotId !== undefined && String(spotId) === String(entrySpotId);
         const activation = this.activations.resolve(meshName, spotId);
-        const transferRequest = record.parts.length === 0
-            ? undefined
-            : decodeFormalRemoteTransferRequest(record.parts[0]);
+        const transferRequest = record.parts.length === 0 ? undefined : decodeFormalRemoteTransferRequest(record.parts[0]);
         const remoteJoinPhase = transferRequest?.phase;
         const isRemoteAdmission = remoteJoinPhase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION;
         const isRemoteCommit = remoteJoinPhase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_COMMIT;
@@ -1139,9 +1147,7 @@ class DefaultZLinkSpotManager {
         if (actor === undefined && admissionRecord?.actor !== undefined) {
             actor = admissionRecord.actor;
         }
-        let callbackRequest = record.parts.length === 0
-            ? undefined
-            : record.parts[0];
+        let callbackRequest = record.parts.length === 0 ? undefined : record.parts[0];
         let ownedCallbackRequest;
         let materialized = false;
         let reply;
@@ -1149,11 +1155,10 @@ class DefaultZLinkSpotManager {
         let preparedTransferState;
         let admissionOutcome;
         let accepted = false;
-        let committedAdmissionReplay = isRemoteCommit
-            && admissionRecord?.state === 'committed';
+        let committedAdmissionReplay = isRemoteCommit && admissionRecord?.state === 'committed';
         let targetCommitPublished;
-        const actorJoinIsCurrent = () => ((record.deadlineUnixMs === undefined || record.deadlineUnixMs > BigInt(Date.now()))
-            && (record.isPending?.() ?? true));
+        const actorJoinIsCurrent = () => (record.deadlineUnixMs === undefined || record.deadlineUnixMs > BigInt(Date.now())) &&
+            (record.isPending?.() ?? true);
         const abandonStaleAdmission = () => {
             if (isRemoteAdmission && transferRequest !== undefined) {
                 this.formalRemoteActorAdmissions.abort(transferRequest.transferId);
@@ -1213,9 +1218,10 @@ class DefaultZLinkSpotManager {
                         const response = await activation.serial.execute(async () => activation.spot.onActorJoin(actorRef.actorId, (0, payload_codec_1.wrapFrameworkPayloadMessage)(callbackRequest, this.options.messageSerializers, requestContentType)));
                         let encodedReply;
                         try {
-                            encodedReply = response.reply === undefined
-                                ? undefined
-                                : (0, payload_codec_1.encodeFrameworkPayloadMessage)(response.reply, this.options.messageSerializers);
+                            encodedReply =
+                                response.reply === undefined
+                                    ? undefined
+                                    : (0, payload_codec_1.encodeFrameworkPayloadMessage)(response.reply, this.options.messageSerializers);
                             admissionOutcome = {
                                 accepted: response.accepted,
                                 actorRef,
@@ -1233,17 +1239,16 @@ class DefaultZLinkSpotManager {
                     }
                     this.formalRemoteActorAdmissions.complete(control.canonicalActorJoin.handoffId, admissionOutcome);
                 }
-                admissionOutcome = admissionRecord.result ?? await admissionRecord.resultTask;
+                admissionOutcome = admissionRecord.result ?? (await admissionRecord.resultTask);
                 if ('error' in admissionOutcome)
                     throw admissionOutcome.error;
                 accepted = admissionOutcome.accepted;
-                reply = admissionOutcome.reply === undefined
-                    ? undefined
-                    : runtime_message_1.ZLinkBufferMessage.from(admissionOutcome.reply);
+                reply =
+                    admissionOutcome.reply === undefined
+                        ? undefined
+                        : runtime_message_1.ZLinkBufferMessage.from(admissionOutcome.reply);
             }
-            if (transferRequest !== undefined
-                && !targetsEntrySpot
-                && remoteJoinPhase === undefined) {
+            if (transferRequest !== undefined && !targetsEntrySpot && remoteJoinPhase === undefined) {
                 // User Spot transfers must carry the private admission/commit phases.
                 // A legacy one-phase request would otherwise read relocation state
                 // before the target application has accepted the Actor.
@@ -1272,11 +1277,11 @@ class DefaultZLinkSpotManager {
                 if (admission.created) {
                     try {
                         if (targetsEntrySpot) {
-                            if (this.options.dispatchEntryActorJoin !== undefined
-                                && transferRequest.completionOperationId !== undefined
-                                && this.options.actorTransferRuntime !== undefined) {
-                                deferredJoinRoot = await this.options.actorTransferRuntime
-                                    .prepareDeferredJoinAccepted(actorId, transferRequest.completionOperationId, actorRef, Buffer.alloc(0));
+                            if (this.options.dispatchEntryActorJoin !== undefined &&
+                                transferRequest.completionOperationId !== undefined &&
+                                this.options.actorTransferRuntime !== undefined) {
+                                deferredJoinRoot =
+                                    await this.options.actorTransferRuntime.prepareDeferredJoinAccepted(actorId, transferRequest.completionOperationId, actorRef, Buffer.alloc(0));
                             }
                             admissionOutcome = {
                                 accepted: this.options.dispatchEntryActorJoin !== undefined,
@@ -1295,16 +1300,17 @@ class DefaultZLinkSpotManager {
                             const response = await activation.serial.execute(async () => activation.spot.onActorJoin(actorRef.actorId, (0, payload_codec_1.wrapFrameworkPayloadMessage)(ownedCallbackRequest, this.options.messageSerializers, transferRequest.requestContentType)));
                             let encodedReply;
                             try {
-                                encodedReply = response.reply === undefined
-                                    ? undefined
-                                    : (0, payload_codec_1.encodeFrameworkPayloadMessage)(response.reply, this.options.messageSerializers);
-                                if (response.accepted
-                                    && transferRequest.completionOperationId !== undefined
-                                    && this.options.actorTransferRuntime !== undefined) {
-                                    deferredJoinRoot = await this.options.actorTransferRuntime
-                                        .prepareDeferredJoinAccepted(actorId, transferRequest.completionOperationId, actorRef, encodedReply?.data() ?? Buffer.alloc(0), encodedReply === undefined
+                                encodedReply =
+                                    response.reply === undefined
                                         ? undefined
-                                        : (0, payload_codec_1.frameworkPayloadContentType)(encodedReply));
+                                        : (0, payload_codec_1.encodeFrameworkPayloadMessage)(response.reply, this.options.messageSerializers);
+                                if (response.accepted &&
+                                    transferRequest.completionOperationId !== undefined &&
+                                    this.options.actorTransferRuntime !== undefined) {
+                                    deferredJoinRoot =
+                                        await this.options.actorTransferRuntime.prepareDeferredJoinAccepted(actorId, transferRequest.completionOperationId, actorRef, encodedReply?.data() ?? Buffer.alloc(0), encodedReply === undefined
+                                            ? undefined
+                                            : (0, payload_codec_1.frameworkPayloadContentType)(encodedReply));
                                     this.options.runtimeEventPublisher?.publish({
                                         sourceName: 'zlink.framework.actor-handoff',
                                         timestamp: new Date(),
@@ -1344,9 +1350,10 @@ class DefaultZLinkSpotManager {
                     throw admissionOutcome.error;
                 }
                 accepted = admissionOutcome.accepted;
-                reply = admissionOutcome.reply === undefined
-                    ? undefined
-                    : runtime_message_1.ZLinkBufferMessage.from(admissionOutcome.reply);
+                reply =
+                    admissionOutcome.reply === undefined
+                        ? undefined
+                        : runtime_message_1.ZLinkBufferMessage.from(admissionOutcome.reply);
             }
             if (isRemoteCommit && admissionRecord !== undefined) {
                 admissionOutcome = await admissionRecord.resultTask;
@@ -1355,13 +1362,13 @@ class DefaultZLinkSpotManager {
                 }
                 deferredJoinRoot = admissionOutcome.deferredJoinRoot;
             }
-            if (actor === undefined
-                && transferRequest !== undefined
-                && this.options.actorTransferRuntime !== undefined
-                && !isRemoteAdmission
-                && !commitAdmissionMissing
-                && admissionRecord?.state !== 'committed'
-                && (targetsEntrySpot || activation !== undefined)) {
+            if (actor === undefined &&
+                transferRequest !== undefined &&
+                this.options.actorTransferRuntime !== undefined &&
+                !isRemoteAdmission &&
+                !commitAdmissionMissing &&
+                admissionRecord?.state !== 'committed' &&
+                (targetsEntrySpot || activation !== undefined)) {
                 // Relocation state travels inline with the join request. The store
                 // reference handoff was removed with the direct-transfer contract
                 // (spec 28 §2 — Relocation Store keeps no relocation state payloads).
@@ -1371,14 +1378,14 @@ class DefaultZLinkSpotManager {
                 preparedTransferState = runtime_message_1.ZLinkBufferMessage.from(Buffer.from(transferRequest.transferState, 'base64'));
             }
             if (isRemoteAdmission && targetsEntrySpot) {
-                accepted = admissionOutcome !== undefined
-                    && !('error' in admissionOutcome)
-                    && admissionOutcome.accepted;
+                accepted =
+                    admissionOutcome !== undefined &&
+                        !('error' in admissionOutcome) &&
+                        admissionOutcome.accepted;
             }
             else if (isRemoteCommit && pendingAdmission !== undefined) {
                 validateRemoteAdmissionCommit(pendingAdmission, transferRequest, actorId, control);
-                accepted = pendingAdmission.state === 'admitted'
-                    || pendingAdmission.state === 'committed';
+                accepted = pendingAdmission.state === 'admitted' || pendingAdmission.state === 'committed';
             }
             else if (commitAdmissionMissing) {
                 accepted = false;
@@ -1388,15 +1395,15 @@ class DefaultZLinkSpotManager {
                 // actor-manager transaction is committed after the Core reply below.
                 // A formal transfer payload materializes the existing actor state at
                 // the Entry owner before that transaction is committed.
-                accepted = actor !== undefined
-                    || (transferRequest !== undefined && this.options.actorTransferRuntime !== undefined);
+                accepted =
+                    actor !== undefined ||
+                        (transferRequest !== undefined && this.options.actorTransferRuntime !== undefined);
             }
-            else if (!isRemoteAdmission
-                && control.canonicalActorJoin === undefined
-                &&
-                    activation !== undefined
-                && callbackRequest !== undefined
-                && (actor !== undefined || transferRequest !== undefined)) {
+            else if (!isRemoteAdmission &&
+                control.canonicalActorJoin === undefined &&
+                activation !== undefined &&
+                callbackRequest !== undefined &&
+                (actor !== undefined || transferRequest !== undefined)) {
                 if (!actorJoinIsCurrent())
                     return;
                 const request = callbackRequest;
@@ -1416,14 +1423,14 @@ class DefaultZLinkSpotManager {
                 if (!actorJoinIsCurrent())
                     return;
                 accepted = response.accepted;
-                reply = response.reply === undefined
-                    ? undefined
-                    : (0, payload_codec_1.encodeFrameworkPayloadMessage)(response.reply, this.options.messageSerializers);
-                if (accepted
-                    && transferRequest?.completionOperationId !== undefined
-                    && this.options.actorTransferRuntime !== undefined) {
-                    deferredJoinRoot = await this.options.actorTransferRuntime
-                        .prepareDeferredJoinAccepted(actorId, transferRequest.completionOperationId, actorRef, reply?.data() ?? Buffer.alloc(0), reply === undefined ? undefined : (0, payload_codec_1.frameworkPayloadContentType)(reply));
+                reply =
+                    response.reply === undefined
+                        ? undefined
+                        : (0, payload_codec_1.encodeFrameworkPayloadMessage)(response.reply, this.options.messageSerializers);
+                if (accepted &&
+                    transferRequest?.completionOperationId !== undefined &&
+                    this.options.actorTransferRuntime !== undefined) {
+                    deferredJoinRoot = await this.options.actorTransferRuntime.prepareDeferredJoinAccepted(actorId, transferRequest.completionOperationId, actorRef, reply?.data() ?? Buffer.alloc(0), reply === undefined ? undefined : (0, payload_codec_1.frameworkPayloadContentType)(reply));
                     this.options.runtimeEventPublisher?.publish({
                         sourceName: 'zlink.framework.actor-handoff',
                         timestamp: new Date(),
@@ -1432,11 +1439,11 @@ class DefaultZLinkSpotManager {
                     });
                 }
             }
-            if (accepted
-                && !isRemoteAdmission
-                && actor === undefined
-                && transferRequest !== undefined
-                && this.options.actorTransferRuntime !== undefined) {
+            if (accepted &&
+                !isRemoteAdmission &&
+                actor === undefined &&
+                transferRequest !== undefined &&
+                this.options.actorTransferRuntime !== undefined) {
                 if (!actorJoinIsCurrent())
                     return;
                 const transferState = preparedTransferState;
@@ -1461,21 +1468,21 @@ class DefaultZLinkSpotManager {
                     return;
                 }
             }
-            if (accepted
-                && transferRequest !== undefined
-                && this.options.actorTransferRuntime !== undefined
-                && !isRemoteAdmission) {
+            if (accepted &&
+                transferRequest !== undefined &&
+                this.options.actorTransferRuntime !== undefined &&
+                !isRemoteAdmission) {
                 // A lightweight Core actor-join notification can create the Actor
                 // before the formal transfer request reaches this branch. Preserve
                 // the full relocation fence in that race so a later Session bind
                 // refresh cannot erase the seal or accepted journal.
                 this.options.actorTransferRuntime.rememberRoutedActorTransferTarget(actorId, transferRequest.remoteBoundSessionTarget);
             }
-            if (accepted
-                && actor !== undefined
-                && transferRequest !== undefined
-                && !isRemoteAdmission
-                && !committedAdmissionReplay) {
+            if (accepted &&
+                actor !== undefined &&
+                transferRequest !== undefined &&
+                !isRemoteAdmission &&
+                !committedAdmissionReplay) {
                 this.formalRemoteTransfers.begin({
                     actor,
                     spotId,
@@ -1508,9 +1515,7 @@ class DefaultZLinkSpotManager {
             }
             if (accepted && targetsEntrySpot && actor !== undefined) {
                 const entryActor = actor;
-                const pendingTransfer = transferRequest === undefined
-                    ? undefined
-                    : this.formalRemoteTransfers.get(actorId);
+                const pendingTransfer = transferRequest === undefined ? undefined : this.formalRemoteTransfers.get(actorId);
                 if (committedAdmissionReplay) {
                     if (!replyActorJoin())
                         return;
@@ -1543,17 +1548,17 @@ class DefaultZLinkSpotManager {
                                 throw new Error('Entry Spot saved handoff replay requires its Actor packet runtime.');
                             }
                             return await this.options.dispatchEntryActorPacket(entryActor.context.actorId, parts, returnResponse, remoteBoundSessionTarget, fallbackActorRef);
-                        }, index => this.options.runtimeEventPublisher?.publish({
+                        }, (index) => this.options.runtimeEventPublisher?.publish({
                             sourceName: 'zlink.framework.actor-handoff',
                             timestamp: new Date(),
                             marker: 'backlog_enqueued',
                             actorId: entryActor.context.actorId,
                             index
                         }));
-                        const failedHandoff = handoffResults.find(result => !result.ok);
+                        const failedHandoff = handoffResults.find((result) => !result.ok);
                         if (failedHandoff !== undefined) {
-                            throw new Error(`Actor '${entryActor.context.actorId}' saved Entry handoff packet `
-                                + `${failedHandoff.index} failed: ${failedHandoff.error ?? 'unknown error'}.`);
+                            throw new Error(`Actor '${entryActor.context.actorId}' saved Entry handoff packet ` +
+                                `${failedHandoff.index} failed: ${failedHandoff.error ?? 'unknown error'}.`);
                         }
                         this.formalRemoteTransfers.delete(entryActor.context.actorId);
                     };
@@ -1600,27 +1605,23 @@ class DefaultZLinkSpotManager {
             ? control.previousActor
             : control.currentActor;
         const actorId = actorRef?.actorId;
-        const pendingTransfer = actorId === undefined
-            ? undefined
-            : this.formalRemoteTransfers.get(actorId);
+        const pendingTransfer = actorId === undefined ? undefined : this.formalRemoteTransfers.get(actorId);
         const sourceActivation = actorId === undefined || spotId === null
             ? undefined
             : this.activations.resolve(meshName, spotId);
-        const sourceJoinedActor = actorId === undefined
-            ? undefined
-            : sourceActivation?.resolveJoinedActor(actorId);
+        const sourceJoinedActor = actorId === undefined ? undefined : sourceActivation?.resolveJoinedActor(actorId);
         const actor = actorId === undefined
             ? undefined
-            : pendingTransfer?.actor
-                ?? sourceJoinedActor
-                ?? this.options.actorLifecycleResolver?.(actorId)
-                ?? this.options.actorResolver?.(actorId);
+            : (pendingTransfer?.actor ??
+                sourceJoinedActor ??
+                this.options.actorLifecycleResolver?.(actorId) ??
+                this.options.actorResolver?.(actorId));
         const entrySpotId = this.options.entryNodeRidProvider?.() ?? this.options.entryNodeRid;
         if (actor === undefined) {
             return;
         }
-        if (control.lifecycleKind === service_runtime_contracts_1.ActorLifecycleKind.Left
-            && (spotId === null || (entrySpotId !== undefined && String(spotId) === String(entrySpotId)))) {
+        if (control.lifecycleKind === service_runtime_contracts_1.ActorLifecycleKind.Left &&
+            (spotId === null || (entrySpotId !== undefined && String(spotId) === String(entrySpotId)))) {
             const callback = async () => {
                 await this.options.entrySpotCallbacks?.onLeaveActor(actor, undefined, actorRef, control.previousMembershipEpoch);
             };
@@ -1665,7 +1666,7 @@ class DefaultZLinkSpotManager {
                         if (currentRef === null) {
                             throw new Error(`Actor '${actor.context.actorId}' has no target ref for deferred Join completion.`);
                         }
-                        await this.options.actorTransferRuntime?.commitAndDeliverDeferredJoinAccepted(deferredJoinRoot, actor, currentRef, operation => activation.executeActor(actor.context.actorId, async () => await operation()));
+                        await this.options.actorTransferRuntime?.commitAndDeliverDeferredJoinAccepted(deferredJoinRoot, actor, currentRef, (operation) => activation.executeActor(actor.context.actorId, async () => await operation()));
                     }
                 };
                 const completeTargetReady = async () => {
@@ -1677,10 +1678,10 @@ class DefaultZLinkSpotManager {
                             actorId: actor.context.actorId,
                             index
                         }));
-                        const failedHandoff = handoffResults.find(result => !result.ok);
+                        const failedHandoff = handoffResults.find((result) => !result.ok);
                         if (failedHandoff !== undefined) {
-                            throw new Error(`Actor '${actor.context.actorId}' saved handoff packet `
-                                + `${failedHandoff.index} failed: ${failedHandoff.error ?? 'unknown error'}.`);
+                            throw new Error(`Actor '${actor.context.actorId}' saved handoff packet ` +
+                                `${failedHandoff.index} failed: ${failedHandoff.error ?? 'unknown error'}.`);
                         }
                         // Spec 15 §4.2 relocation temporary queue: arrivals parked at
                         // this target directly (not relayed through the source's
@@ -1767,15 +1768,14 @@ class DefaultZLinkSpotManager {
         if (admission.admission.actorId !== actor.context.actorId) {
             throw new Error(`Actor Join relocation '${relocationId}' changed its admitted Actor.`);
         }
-        const outcome = admission.result ?? await admission.resultTask;
+        const outcome = admission.result ?? (await admission.resultTask);
         if ('error' in outcome)
             throw outcome.error;
         if (!outcome.accepted || admission.state !== 'admitted') {
             throw new Error(`Actor Join relocation '${relocationId}' has no accepted admission.`);
         }
         const entrySpotId = this.options.entryNodeRidProvider?.() ?? this.options.entryNodeRid;
-        const targetsEntry = entrySpotId !== undefined
-            && String(admission.admission.spotId) === String(entrySpotId);
+        const targetsEntry = entrySpotId !== undefined && String(admission.admission.spotId) === String(entrySpotId);
         if (targetsEntry) {
             await this.options.dispatchEntryActorJoin?.(meshName, actor, []);
         }
@@ -1808,7 +1808,7 @@ class DefaultZLinkSpotManager {
         if (admission === undefined) {
             throw new Error(`Actor Join recovery '${recovery.request.handoffId}' has no canonical command-28 admission.`);
         }
-        const outcome = admission.result ?? await admission.resultTask;
+        const outcome = admission.result ?? (await admission.resultTask);
         if ('error' in outcome || !outcome.accepted || admission.state !== 'admitted') {
             throw new Error(`Actor Join recovery '${recovery.request.handoffId}' has no accepted admission.`);
         }
@@ -1817,13 +1817,13 @@ class DefaultZLinkSpotManager {
             throw new Error(`Actor Join recovery '${recovery.request.handoffId}' lost its command-28 source route.`);
         }
         const admittedNodeBytes = Buffer.from((0, routing_id_1.encodeRoutingIdStorageHex)(admitted.sourceActorNodeRid), 'hex');
-        if (admitted.actorId !== recovery.request.actorId
-            || admitted.actorType !== recovery.request.actorType
-            || admitted.requestFingerprint !== recovery.request.request.toString('base64')
-            || String(admitted.spotId) !== recovery.targetSpotId
-            || admitted.targetSpotGeneration !== recovery.targetSpotGeneration
-            || admitted.actorRef.objectGeneration !== recovery.request.actorGeneration
-            || !admittedNodeBytes.equals(recovery.request.sourceNodeRid)) {
+        if (admitted.actorId !== recovery.request.actorId ||
+            admitted.actorType !== recovery.request.actorType ||
+            admitted.requestFingerprint !== recovery.request.request.toString('base64') ||
+            String(admitted.spotId) !== recovery.targetSpotId ||
+            admitted.targetSpotGeneration !== recovery.targetSpotGeneration ||
+            admitted.actorRef.objectGeneration !== recovery.request.actorGeneration ||
+            !admittedNodeBytes.equals(recovery.request.sourceNodeRid)) {
             throw new Error(`Actor Join recovery '${recovery.request.handoffId}' changed its command-28 identity.`);
         }
         const admittedReply = outcome.reply ?? Buffer.alloc(0);
@@ -1845,9 +1845,7 @@ class DefaultZLinkSpotManager {
         // Command 28 carries a present reply in one outer framework-multipart
         // part. The accepted target admission still owns the inner typed content
         // type, which the durable completion must retain for application decode.
-        const admittedContentType = admittedReply.byteLength === 0
-            ? recovery.replyContentType
-            : outcome.replyContentType;
+        const admittedContentType = admittedReply.byteLength === 0 ? recovery.replyContentType : outcome.replyContentType;
         const transfer = this.options.actorTransferRuntime;
         if (transfer === undefined) {
             throw new Error('Canonical Actor Join recovery requires the Actor transfer runtime.');
@@ -1911,10 +1909,7 @@ class DefaultZLinkSpotManager {
         const drained = this.formalRemoteActorAdmissions.completeMigration(transferId);
         for (const arrival of drained) {
             try {
-                const response = await this.dispatchActorPacket(activation, actor.context.actorId, [
-                    runtime_message_1.ZLinkBufferMessage.from(arrival.header),
-                    runtime_message_1.ZLinkBufferMessage.from(arrival.payload)
-                ], arrival.returnResponse, arrival.remoteBoundSessionTarget, arrival.fallbackActorRef, arrival.requestTerminal);
+                const response = await this.dispatchActorPacket(activation, actor.context.actorId, [runtime_message_1.ZLinkBufferMessage.from(arrival.header), runtime_message_1.ZLinkBufferMessage.from(arrival.payload)], arrival.returnResponse, arrival.remoteBoundSessionTarget, arrival.fallbackActorRef, arrival.requestTerminal);
                 arrival.resolve(response);
             }
             catch (error) {
@@ -1934,10 +1929,10 @@ exports.DefaultZLinkSpotManager = DefaultZLinkSpotManager;
 function instanceDispatchErrorReason(error) {
     if (error instanceof contracts_1.ZLinkFrameworkException) {
         const kind = (0, framework_errors_internal_1.internalFrameworkErrorKind)(error);
-        if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotMoving
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound
-            || kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound) {
+        if (kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotGenerationStale ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotMoving ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound ||
+            kind === framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound) {
             return ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.StaleTarget;
         }
     }
@@ -1954,34 +1949,30 @@ function decodeFormalRemoteTransferRequestBytes(bytes) {
     catch {
         return undefined;
     }
-    if (payload.packetName !== actor_remote_wire_1.REMOTE_ACTOR_JOIN_PACKET
-        || typeof payload.actorType !== 'string'
-        || typeof payload.transferId !== 'string'
-        || !(payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION
-            || payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ABORT
-            || payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_COMMIT
-            || payload.phase === undefined)
-        || !(payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION
-            || payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ABORT
-            || (typeof payload.transferState === 'string'))
-        || typeof payload.request !== 'string') {
+    if (payload.packetName !== actor_remote_wire_1.REMOTE_ACTOR_JOIN_PACKET ||
+        typeof payload.actorType !== 'string' ||
+        typeof payload.transferId !== 'string' ||
+        !(payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION ||
+            payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ABORT ||
+            payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_COMMIT ||
+            payload.phase === undefined) ||
+        !(payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION ||
+            payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ABORT ||
+            typeof payload.transferState === 'string') ||
+        typeof payload.request !== 'string') {
         return undefined;
     }
     return {
         actorType: payload.actorType,
         actorId: typeof payload.actorId === 'string' ? payload.actorId : undefined,
-        phase: payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION
-            || payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_COMMIT
-            || payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ABORT
+        phase: payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ADMISSION ||
+            payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_COMMIT ||
+            payload.phase === actor_remote_wire_1.REMOTE_ACTOR_JOIN_ABORT
             ? payload.phase
             : undefined,
         transferId: payload.transferId,
-        transferAdapterKey: typeof payload.transferAdapterKey === 'string'
-            ? payload.transferAdapterKey
-            : undefined,
-        transferState: typeof payload.transferState === 'string'
-            ? payload.transferState
-            : undefined,
+        transferAdapterKey: typeof payload.transferAdapterKey === 'string' ? payload.transferAdapterKey : undefined,
+        transferState: typeof payload.transferState === 'string' ? payload.transferState : undefined,
         request: payload.request,
         requestContentType: typeof payload.requestContentType === 'string'
             ? payload.requestContentType
@@ -1989,17 +1980,15 @@ function decodeFormalRemoteTransferRequestBytes(bytes) {
         actorEntryNodeRid: typeof payload.actorEntryNodeRid === 'string'
             ? (0, routing_id_1.decodeRoutingId)(payload.actorEntryNodeRid, payload.actorEntryNodeRidHex)
             : undefined,
-        sourceSpotId: typeof payload.sourceSpotId === 'string'
-            ? payload.sourceSpotId
-            : undefined,
+        sourceSpotId: typeof payload.sourceSpotId === 'string' ? payload.sourceSpotId : undefined,
         actorRef: decodeFormalRemoteActorRef(payload),
         remoteBoundSessionTarget: (0, spot_remote_codec_1.decodeRemoteBoundSessionTarget)(payload.boundSessionRouterChannelId, payload.boundSessionTargetNodeRid, payload.boundSessionTargetNodeRidHex, payload.boundSessionSpotId, payload.boundSessionNodeRid, payload.boundSessionNodeRidHex, payload.boundSessionRid, payload.boundSessionRidHex, payload.boundSessionBindingGeneration, payload.boundSessionPreviousAuthorityOwnerGeneration, payload.boundSessionPreviousOwnerLeaseGeneration, payload.boundSessionRelocationSealId, payload.boundSessionServiceWireRelocation),
         expectedMembershipEpoch: typeof payload.expectedMembershipEpoch === 'string'
             ? BigInt(payload.expectedMembershipEpoch)
             : 0n,
         handoffBacklog: (0, spot_remote_codec_1.decodeHandoffBacklog)(payload.handoffBacklog),
-        completionOperationId: typeof payload.completionOperationHigh === 'string'
-            && typeof payload.completionOperationLow === 'string'
+        completionOperationId: typeof payload.completionOperationHigh === 'string' &&
+            typeof payload.completionOperationLow === 'string'
             ? {
                 high: BigInt(payload.completionOperationHigh),
                 low: BigInt(payload.completionOperationLow)
@@ -2039,15 +2028,15 @@ function toFrameworkRemoteAdmissionActorRef(rawActorRef, meshName) {
 function validateRemoteAdmissionCommit(admission, request, actorId, control) {
     const expected = admission.admission;
     const actorRef = request.actorRef;
-    if (expected.actorId !== actorId
-        || expected.actorType !== request.actorType
-        || expected.expectedMembershipEpoch !== request.expectedMembershipEpoch
-        || expected.requestFingerprint !== request.request
-        || expected.targetSpotGeneration !== (control.currentSpotGeneration ?? 0n)
-        || actorRef === undefined
-        || actorRef.actorId !== expected.actorRef.actorId
-        || String(actorRef.nodeRid) !== String(expected.actorRef.nodeRid)
-        || actorRef.objectGeneration !== expected.actorRef.objectGeneration) {
+    if (expected.actorId !== actorId ||
+        expected.actorType !== request.actorType ||
+        expected.expectedMembershipEpoch !== request.expectedMembershipEpoch ||
+        expected.requestFingerprint !== request.request ||
+        expected.targetSpotGeneration !== (control.currentSpotGeneration ?? 0n) ||
+        actorRef === undefined ||
+        actorRef.actorId !== expected.actorRef.actorId ||
+        String(actorRef.nodeRid) !== String(expected.actorRef.nodeRid) ||
+        actorRef.objectGeneration !== expected.actorRef.objectGeneration) {
         throw new configuration_1.ZLinkConfigurationException(`Remote Actor '${actorId}' commit does not match its target admission.`);
     }
 }
@@ -2069,10 +2058,10 @@ function instanceMaterializationKey(meshName, spotId, objectGeneration) {
     return `${instanceMaterializationPrefix(meshName, spotId)}\0${objectGeneration}`;
 }
 function isAbortSignal(value) {
-    return typeof value === 'object'
-        && value !== null
-        && typeof value.aborted === 'boolean'
-        && typeof value.addEventListener === 'function';
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.aborted === 'boolean' &&
+        typeof value.addEventListener === 'function');
 }
 function instanceActivationOutcome(error) {
     if ((0, abort_1.isAbortError)(error))
@@ -2082,8 +2071,8 @@ function instanceActivationOutcome(error) {
             return 'timed_out';
         if (error.kind === contracts_1.ZLinkFrameworkErrorKind.AlreadyExists)
             return 'conflict';
-        if (error.kind === contracts_1.ZLinkFrameworkErrorKind.InvalidOperation
-            || error.kind === contracts_1.ZLinkFrameworkErrorKind.Unavailable)
+        if (error.kind === contracts_1.ZLinkFrameworkErrorKind.InvalidOperation ||
+            error.kind === contracts_1.ZLinkFrameworkErrorKind.Unavailable)
             return 'fenced';
     }
     return 'failed';