@zlink-systems/framework 0.21.0 → 0.22.0

package/dist/runtime/host/remote-bound-session-relay.js

@@ -20,8 +20,7 @@ class ZLinkRemoteBoundSessionRelay {
         this.options = options;
     }
     async receiveRoutedBoundSession(actorId, message, packetName, metadata, actorRef, actorPacketTarget) {
-        const ownershipGeneration = actorRef
-            ?.ownershipGeneration;
+        const ownershipGeneration = actorRef?.ownershipGeneration;
         const currentGeneration = this.actorOwnershipGenerations.get(actorId);
         if (currentGeneration !== undefined &&
             (ownershipGeneration === undefined || ownershipGeneration < currentGeneration))
@@ -30,21 +29,23 @@ class ZLinkRemoteBoundSessionRelay {
             this.actorOwnershipGenerations.set(actorId, ownershipGeneration);
         }
         await this.options.updateRemoteActorPacketTarget(actorId, actorPacketTarget);
-        if (ownershipGeneration !== undefined
-            && this.actorOwnershipGenerations.get(actorId) !== ownershipGeneration)
+        if (ownershipGeneration !== undefined &&
+            this.actorOwnershipGenerations.get(actorId) !== ownershipGeneration)
             return;
         if (actorRef !== undefined) {
             await this.options.streamBindingRuntime().rebindActor(actorRef);
         }
-        if (ownershipGeneration !== undefined
-            && this.actorOwnershipGenerations.get(actorId) !== ownershipGeneration)
+        if (ownershipGeneration !== undefined &&
+            this.actorOwnershipGenerations.get(actorId) !== ownershipGeneration)
             return;
-        const sent = await this.options.streamBindingRuntime().sendLocalBoundSession(actorId, message, packetName, metadata);
+        const sent = await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSession(actorId, message, packetName, metadata);
         if (sent) {
             return;
         }
-        if (ownershipGeneration !== undefined
-            && this.actorOwnershipGenerations.get(actorId) !== ownershipGeneration)
+        if (ownershipGeneration !== undefined &&
+            this.actorOwnershipGenerations.get(actorId) !== ownershipGeneration)
             return;
         if (this.options.actorManager()?.getState(actorId)?.remoteBoundSessionTarget === undefined) {
             return;
@@ -60,11 +61,15 @@ class ZLinkRemoteBoundSessionRelay {
     }
     async receiveRoutedBoundSessionResponse(actorId, packetName, requestSeq, message, replyOptions, actorPacketTarget) {
         await this.options.updateRemoteActorPacketTarget(actorId, actorPacketTarget);
-        await this.options.streamBindingRuntime().sendLocalBoundSessionResponse(actorId, packetName, requestSeq, message, replyOptions.metadata, replyOptions.compressPayload);
+        await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSessionResponse(actorId, packetName, requestSeq, message, replyOptions.metadata, replyOptions.compressPayload);
     }
     async receiveRoutedBoundSessionError(actorId, packetName, requestSeq, error, metadata, actorPacketTarget) {
         await this.options.updateRemoteActorPacketTarget(actorId, actorPacketTarget);
-        await this.options.streamBindingRuntime().sendLocalBoundSessionError(actorId, packetName, requestSeq, error, metadata);
+        await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSessionError(actorId, packetName, requestSeq, error, metadata);
     }
     async receiveRemoteBoundSessionSend(payload) {
         const send = (0, bound_session_wire_1.decodeRemoteBoundSessionSendPayload)(payload);
@@ -72,7 +77,7 @@ class ZLinkRemoteBoundSessionRelay {
         const owner = (0, actor_session_binding_runtime_owner_1.actorSessionBindingRuntimeOwnerIfRegistered)(this.options.streamBindingRuntime());
         const retained = await owner?.retainRelocationOutbound(send.actorId, {
             deliver: () => this.deliverRemoteBoundSessionSend(send),
-            fail: error => this.options.reportOwnershipRefreshError?.(send.actorId, error)
+            fail: (error) => this.options.reportOwnershipRefreshError?.(send.actorId, error)
         }, send.relocationSealId);
         if (retained === 'retained')
             return { ok: true };
@@ -82,7 +87,9 @@ class ZLinkRemoteBoundSessionRelay {
     }
     async deliverRemoteBoundSessionSend(send) {
         const metadata = new Map(Object.entries(send.metadata ?? {}));
-        if (await this.options.streamBindingRuntime().sendLocalBoundSession(send.actorId, send.message, send.boundPacketName, metadata)) {
+        if (await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSession(send.actorId, send.message, send.boundPacketName, metadata)) {
             return true;
         }
         if (this.options.actorManager()?.getState(send.actorId)?.remoteBoundSessionTarget === undefined) {
@@ -101,13 +108,17 @@ class ZLinkRemoteBoundSessionRelay {
     async receiveRemoteBoundSessionResponse(payload) {
         const response = (0, bound_session_wire_1.decodeRemoteBoundSessionResponsePayload)(payload);
         await this.options.updateRemoteActorPacketTarget(response.actorId, response.actorPacketTarget);
-        const sent = await this.options.streamBindingRuntime().sendLocalBoundSessionResponse(response.actorId, response.boundPacketName, response.requestSeq, response.message, new Map(Object.entries(response.metadata ?? {})), response.compressPayload);
+        const sent = await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSessionResponse(response.actorId, response.boundPacketName, response.requestSeq, response.message, new Map(Object.entries(response.metadata ?? {})), response.compressPayload);
         return { ok: sent };
     }
     async receiveRemoteBoundSessionError(payload) {
         const response = (0, bound_session_wire_1.decodeRemoteBoundSessionErrorPayload)(payload);
         await this.options.updateRemoteActorPacketTarget(response.actorId, response.actorPacketTarget);
-        const sent = await this.options.streamBindingRuntime().sendLocalBoundSessionError(response.actorId, response.boundPacketName, response.requestSeq, response.error, new Map(Object.entries(response.metadata ?? {})));
+        const sent = await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSessionError(response.actorId, response.boundPacketName, response.requestSeq, response.error, new Map(Object.entries(response.metadata ?? {})));
         return { ok: sent };
     }
     async receiveServiceWireSessionRelocationSeal(value, signal) {
@@ -179,15 +190,21 @@ class ZLinkRemoteBoundSessionRelay {
             }
             const owner = (0, actor_session_binding_runtime_owner_1.actorSessionBindingRuntimeOwner)(this.options.streamBindingRuntime());
             await owner.clearRelocation(actorId, error);
-            void this.options.streamBindingRuntime().disconnectBoundSession(actorId)
-                .catch(disconnectError => this.options.reportOwnershipRefreshError?.(actorId, disconnectError));
+            void this.options
+                .streamBindingRuntime()
+                .disconnectBoundSession(actorId)
+                .catch((disconnectError) => this.options.reportOwnershipRefreshError?.(actorId, disconnectError));
             state.sealAbortCleanup?.();
         };
         const timeoutError = () => (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.DeadlineExceeded, `Actor '${actorId}' Session relocation seal exceeded its absolute deadline.`, true);
-        state.sealTimer = setTimeout(() => { void expire(timeoutError()); }, this.options.sessionRelocationSealTimeoutMs);
+        state.sealTimer = setTimeout(() => {
+            void expire(timeoutError());
+        }, this.options.sessionRelocationSealTimeoutMs);
         state.sealTimer.unref();
         if (signal !== undefined) {
-            const onAbort = () => { void expire(signal.reason ?? timeoutError()); };
+            const onAbort = () => {
+                void expire(signal.reason ?? timeoutError());
+            };
             state.sealAbortCleanup = () => signal.removeEventListener('abort', onAbort);
             if (signal.aborted)
                 onAbort();
@@ -207,10 +224,12 @@ class ZLinkRemoteBoundSessionRelay {
             }
             if (state.terminal !== true) {
                 const owner = (0, actor_session_binding_runtime_owner_1.actorSessionBindingRuntimeOwner)(this.options.streamBindingRuntime());
-                if (await owner.relocationSnapshot(actorId, key) !== undefined) {
+                if ((await owner.relocationSnapshot(actorId, key)) !== undefined) {
                     await owner.clearRelocation(actorId, error);
-                    void this.options.streamBindingRuntime().disconnectBoundSession(actorId)
-                        .catch(disconnectError => this.options.reportOwnershipRefreshError?.(actorId, disconnectError));
+                    void this.options
+                        .streamBindingRuntime()
+                        .disconnectBoundSession(actorId)
+                        .catch((disconnectError) => this.options.reportOwnershipRefreshError?.(actorId, disconnectError));
                 }
             }
             throw sealController.signal.aborted ? sealController.signal.reason : error;
@@ -242,8 +261,8 @@ class ZLinkRemoteBoundSessionRelay {
             this.warnLateSessionRouteUpdate(value);
             return;
         }
-        if (state.routeRequestFingerprint !== undefined
-            && state.routeRequestFingerprint !== routeRequestFingerprint) {
+        if (state.routeRequestFingerprint !== undefined &&
+            state.routeRequestFingerprint !== routeRequestFingerprint) {
             throw new service_wire_m6a_codec_1.ServiceWireProtocolError(`Session relocation '${key}' repeated command 44 with different bytes.`);
         }
         if (state.routeFingerprint !== undefined) {
@@ -269,7 +288,7 @@ class ZLinkRemoteBoundSessionRelay {
             this.terminalServiceWireRelocations.remember(key, {
                 actorId: state.actorId,
                 sealFingerprint: state.sealFingerprint,
-                sealed: state.sealed ?? await state.sealPromise,
+                sealed: state.sealed ?? (await state.sealPromise),
                 routeRequestFingerprint,
                 routeFingerprint: fingerprint
             });
@@ -287,7 +306,7 @@ class ZLinkRemoteBoundSessionRelay {
             if (this.activeServiceWireRelocations.get(key) === state) {
                 this.activeServiceWireRelocations.delete(key);
             }
-            const sealed = state.sealed ?? await state.sealPromise;
+            const sealed = state.sealed ?? (await state.sealPromise);
             this.terminalServiceWireRelocations.remember(key, {
                 actorId: state.actorId,
                 sealFingerprint: state.sealFingerprint,
@@ -295,10 +314,11 @@ class ZLinkRemoteBoundSessionRelay {
                 routeRequestFingerprint,
                 routeFingerprint: fingerprint
             });
-            (0, actor_session_binding_runtime_owner_1.actorSessionBindingRuntimeOwner)(this.options.streamBindingRuntime())
-                .clearRelocation(state.actorId, error);
-            await this.options.streamBindingRuntime().disconnectBoundSession(state.actorId)
-                .catch(disconnectError => this.options.reportOwnershipRefreshError?.(state.actorId, disconnectError));
+            (0, actor_session_binding_runtime_owner_1.actorSessionBindingRuntimeOwner)(this.options.streamBindingRuntime()).clearRelocation(state.actorId, error);
+            await this.options
+                .streamBindingRuntime()
+                .disconnectBoundSession(state.actorId)
+                .catch((disconnectError) => this.options.reportOwnershipRefreshError?.(state.actorId, disconnectError));
             throw error;
         }
     }
@@ -345,8 +365,8 @@ class ZLinkRemoteBoundSessionRelay {
                     releaseSeal: { sealId: key }
                 });
                 const currentGeneration = this.actorOwnershipGenerations.get(value.actor.actorId);
-                if (currentGeneration === undefined
-                    || currentGeneration < committedRoute.targetAuthorityOwnerGeneration) {
+                if (currentGeneration === undefined ||
+                    currentGeneration < committedRoute.targetAuthorityOwnerGeneration) {
                     this.actorOwnershipGenerations.set(value.actor.actorId, committedRoute.targetAuthorityOwnerGeneration);
                 }
             });
@@ -354,12 +374,14 @@ class ZLinkRemoteBoundSessionRelay {
         await owner.observeRelocationTerminal(value.actor.actorId, key, fingerprint);
     }
     async validateServiceWireSessionRoute(value) {
-        const current = await this.options.streamBindingRuntime().sessionRouteFence(value.actor.actor.actorId);
-        if (current === undefined
-            || current.actor.objectGeneration !== value.actor.actor.generation
-            || !(0, routing_id_1.routingIdsEqual)(current.actor.nodeRid, value.actor.actor.nodeRid)
-            || current.sessionRid.toString() !== value.session.sessionRid
-            || current.bindingGeneration !== value.session.bindingGeneration) {
+        const current = await this.options
+            .streamBindingRuntime()
+            .sessionRouteFence(value.actor.actor.actorId);
+        if (current === undefined ||
+            current.actor.objectGeneration !== value.actor.actor.generation ||
+            !(0, routing_id_1.routingIdsEqual)(current.actor.nodeRid, value.actor.actor.nodeRid) ||
+            current.sessionRid.toString() !== value.session.sessionRid ||
+            current.bindingGeneration !== value.session.bindingGeneration) {
             throw new bound_session_wire_1.ZLinkRemoteBoundSessionFenceError(`Actor '${value.actor.actor.actorId}' command 42 was fenced by its exact Session route.`);
         }
     }
@@ -402,7 +424,9 @@ class ZLinkRemoteBoundSessionRelay {
     }
     async sendActorResponse(actor, packetName, requestSeq, response, replyOptions, fallbackBoundSessionTarget, fallbackActorRef, signal) {
         const state = this.options.actorManager()?.getState(actor.context.actorId);
-        if (await this.options.streamBindingRuntime().sendLocalBoundSessionResponse(actor.context.actorId, packetName, requestSeq, response, replyOptions.metadata, replyOptions.compressPayload)) {
+        if (await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSessionResponse(actor.context.actorId, packetName, requestSeq, response, replyOptions.metadata, replyOptions.compressPayload)) {
             return;
         }
         const actorRef = currentActorRef(state, fallbackActorRef);
@@ -418,15 +442,18 @@ class ZLinkRemoteBoundSessionRelay {
         if (actorSessionNode === undefined) {
             throw new Error('Native bound-session response requires the RouteMesh stream-session service.');
         }
-        await this.options.streamBindingRuntime().sendNativeBoundSessionResponse(actorSessionNode, actorRef, packetName, requestSeq, response, replyOptions.metadata, replyOptions.compressPayload, signal);
+        await this.options
+            .streamBindingRuntime()
+            .sendNativeBoundSessionResponse(actorSessionNode, actorRef, packetName, requestSeq, response, replyOptions.metadata, replyOptions.compressPayload, signal);
     }
     async sendActorError(actorId, packetName, requestSeq, error, metadata, fallbackBoundSessionTarget, fallbackActorRef, signal) {
-        if (await this.options.streamBindingRuntime().sendLocalBoundSessionError(actorId, packetName, requestSeq, error, metadata)) {
+        if (await this.options
+            .streamBindingRuntime()
+            .sendLocalBoundSessionError(actorId, packetName, requestSeq, error, metadata)) {
             return;
         }
         const state = this.options.actorManager()?.getState(actorId);
-        const actorRef = currentActorRef(state, fallbackActorRef)
-            ?? this.options.destroyedActorRefs.get(actorId);
+        const actorRef = currentActorRef(state, fallbackActorRef) ?? this.options.destroyedActorRefs.get(actorId);
         const remoteTarget = fallbackBoundSessionTarget ?? state?.remoteBoundSessionTarget;
         if (remoteTarget !== undefined) {
             await this.sendRemoteBoundSessionError(remoteTarget, actorId, packetName, requestSeq, error, metadata, signal);
@@ -439,7 +466,9 @@ class ZLinkRemoteBoundSessionRelay {
         if (actorSessionNode === undefined) {
             throw new Error('Native bound-session error response requires the RouteMesh stream-session service.');
         }
-        await this.options.streamBindingRuntime().sendNativeBoundSessionError(actorSessionNode, actorRef, packetName, requestSeq, error, metadata, signal);
+        await this.options
+            .streamBindingRuntime()
+            .sendNativeBoundSessionError(actorSessionNode, actorRef, packetName, requestSeq, error, metadata, signal);
     }
     async sendRemoteBoundSessionResponse(target, actorId, packetName, requestSeq, message, replyOptions, signal) {
         const actorPacketTarget = (0, actor_packet_relay_wire_1.encodeRemoteActorPacketTarget)(this.options.actorPacketTargetForState(actorId, target.routerChannelId));
@@ -468,16 +497,15 @@ class ZLinkRemoteBoundSessionRelay {
         if (typeof packetName !== 'string') {
             throw new Error('Remote bound session control payload does not declare a packet name.');
         }
-        const submit = this.options.routeTransport.submitInfrastructure
-            ?? this.options.routeTransport.submit;
+        const submit = this.options.routeTransport.submitInfrastructure ?? this.options.routeTransport.submit;
         if (submit === undefined) {
             throw new Error('Remote bound session node-direct transport is not available.');
         }
         const result = await submit.call(this.options.routeTransport, target.routerChannelId, String(target.targetNodeRid), packetName, payload, signal);
         if (result.status !== submission_result_1.ZLinkSubmitStatus.Submitted) {
-            throw new Error(`Remote bound session control '${packetName}' was not admitted`
-                + ` on '${target.routerChannelId}' for '${String(target.targetNodeRid)}'`
-                + ` (status ${result.status}).`);
+            throw new Error(`Remote bound session control '${packetName}' was not admitted` +
+                ` on '${target.routerChannelId}' for '${String(target.targetNodeRid)}'` +
+                ` (status ${result.status}).`);
         }
     }
 }
@@ -486,9 +514,7 @@ function currentActorRef(state, fallback) {
     const native = state?.nativeActorRef;
     if (native === undefined)
         return fallback;
-    const objectGeneration = native.generation
-        ?? native.objectGeneration
-        ?? fallback?.objectGeneration;
+    const objectGeneration = native.generation ?? native.objectGeneration ?? fallback?.objectGeneration;
     const meshName = state?.meshName ?? fallback?.meshName;
     if (objectGeneration === undefined || meshName === undefined)
         return fallback;
@@ -506,30 +532,28 @@ function serviceWireBarrierKey(value) {
     return (0, service_stateful_wire_codec_1.serviceSessionRelocationIdentityKey)(value);
 }
 function validateSessionRelocationRouteAgainstSeal(route, sealed) {
-    const sameCoordinator = route.coordinator.ownerId === sealed.coordinator.ownerId
-        && route.coordinator.leaseGeneration === sealed.coordinator.leaseGeneration
-        && route.coordinator.nodeRid === sealed.coordinator.nodeRid
-        && route.coordinator.nodeGeneration === sealed.coordinator.nodeGeneration
-        && route.coordinator.expectedAuthorityStoreVersion
-            === sealed.coordinator.expectedAuthorityStoreVersion;
-    const sameSession = route.session.sessionOwnerNodeRid === sealed.session.sessionOwnerNodeRid
-        && route.session.sessionOwnerNodeGeneration === sealed.session.sessionOwnerNodeGeneration
-        && route.session.sessionOwnerId === sealed.session.sessionOwnerId
-        && route.session.sessionOwnerLeaseGeneration
-            === sealed.session.sessionOwnerLeaseGeneration
-        && route.session.sessionRid === sealed.session.sessionRid
-        && route.session.bindingGeneration === sealed.session.bindingGeneration;
-    if (route.relocation.high !== sealed.relocation.high
-        || route.relocation.low !== sealed.relocation.low
-        || !sameCoordinator
-        || !sameSession
-        || route.actor.actorId !== sealed.actor.actor.actorId
-        || route.actor.generation !== sealed.actor.actor.generation) {
+    const sameCoordinator = route.coordinator.ownerId === sealed.coordinator.ownerId &&
+        route.coordinator.leaseGeneration === sealed.coordinator.leaseGeneration &&
+        route.coordinator.nodeRid === sealed.coordinator.nodeRid &&
+        route.coordinator.nodeGeneration === sealed.coordinator.nodeGeneration &&
+        route.coordinator.expectedAuthorityStoreVersion ===
+            sealed.coordinator.expectedAuthorityStoreVersion;
+    const sameSession = route.session.sessionOwnerNodeRid === sealed.session.sessionOwnerNodeRid &&
+        route.session.sessionOwnerNodeGeneration === sealed.session.sessionOwnerNodeGeneration &&
+        route.session.sessionOwnerId === sealed.session.sessionOwnerId &&
+        route.session.sessionOwnerLeaseGeneration === sealed.session.sessionOwnerLeaseGeneration &&
+        route.session.sessionRid === sealed.session.sessionRid &&
+        route.session.bindingGeneration === sealed.session.bindingGeneration;
+    if (route.relocation.high !== sealed.relocation.high ||
+        route.relocation.low !== sealed.relocation.low ||
+        !sameCoordinator ||
+        !sameSession ||
+        route.actor.actorId !== sealed.actor.actor.actorId ||
+        route.actor.generation !== sealed.actor.actor.generation) {
         throw new service_wire_m6a_codec_1.ServiceWireProtocolError(`Session relocation '${serviceWireBarrierKey(route)}' changed its command 42 fence.`);
     }
     if (route.route.action === 'commit') {
-        if (route.route.previousAuthorityOwnerGeneration
-            !== sealed.actor.authorityOwnerGeneration) {
+        if (route.route.previousAuthorityOwnerGeneration !== sealed.actor.authorityOwnerGeneration) {
             throw new service_wire_m6a_codec_1.ServiceWireProtocolError(`Session relocation '${serviceWireBarrierKey(route)}' changed its source authority fence.`);
         }
         return;

package/dist/runtime/host/route-mesh-runtime.js

@@ -69,51 +69,43 @@ class ZLinkRouteMeshRuntimeCoordinator {
                 unavailableReason: peerUnavailableReason(state)
             };
         });
-        const channels = Object.entries(this.options.meshOptions.get(meshName)?.meshChannels ?? {})
-            .map(([channelName, channel]) => {
-            const readyMemberCount = BigInt(peerChannels.filter((entry, index) => peers[index]?.state === contracts_1.ZLinkPeerState.Ready
-                && entry.names.some((name, channelIndex) => name === channelName && (entry.weights[channelIndex] ?? 0) > 0)).length);
+        const channels = Object.entries(this.options.meshOptions.get(meshName)?.meshChannels ?? {}).map(([channelName, channel]) => {
+            const readyMemberCount = BigInt(peerChannels.filter((entry, index) => peers[index]?.state === contracts_1.ZLinkPeerState.Ready &&
+                entry.names.some((name, channelIndex) => name === channelName && (entry.weights[channelIndex] ?? 0) > 0)).length);
             const localWeight = descriptor?.channelWeights[channelName] ?? channel.weight ?? 100;
-            const readyTargetCount = Number(readyMemberCount)
-                + (channel.server === true && localWeight > 0 ? 1 : 0);
+            const readyTargetCount = Number(readyMemberCount) + (channel.server === true && localWeight > 0 ? 1 : 0);
             return { channelName, isReady: readyTargetCount > 0, readyTargetCount };
         });
         const backendTopologyState = backendState(status.state);
-        const hasUnavailableRequiredPeer = peers.some(peer => peer.state === contracts_1.ZLinkPeerState.Connecting
-            || peer.state === contracts_1.ZLinkPeerState.NotConnected);
-        const localTopologyState = drain.state === contracts_1.ZLinkTopologyState.Ready
-            ? backendTopologyState
-            : drain.state;
-        const hostState = this.options.hostState?.()
-            ?? contracts_1.ZLinkFrameworkRuntimeState.Serving;
+        const hasUnavailableRequiredPeer = peers.some((peer) => peer.state === contracts_1.ZLinkPeerState.Connecting || peer.state === contracts_1.ZLinkPeerState.NotConnected);
+        const localTopologyState = drain.state === contracts_1.ZLinkTopologyState.Ready ? backendTopologyState : drain.state;
+        const hostState = this.options.hostState?.() ?? contracts_1.ZLinkFrameworkRuntimeState.Serving;
         const hostTopologyState = topologyStateForHost(hostState, localTopologyState);
         const locationStoreHealthy = this.options.isLocationStoreHealthy?.() ?? true;
-        const state = hostTopologyState === contracts_1.ZLinkTopologyState.Ready
-            && (hasUnavailableRequiredPeer || !locationStoreHealthy)
+        const state = hostTopologyState === contracts_1.ZLinkTopologyState.Ready &&
+            (hasUnavailableRequiredPeer || !locationStoreHealthy)
             ? contracts_1.ZLinkTopologyState.Degraded
             : hostTopologyState;
         const hostReady = (0, runtime_state_projections_1.runtimeStateIsReady)(hostState);
         const objectRole = descriptor?.objectRole ?? contracts_2.ZLinkObjectRole.None;
         const placementWeight = descriptor?.placementWeight ?? 0;
-        const capacityAvailable = descriptor !== undefined
-            && populationCapacity !== undefined
-            && hasRemainingCapacity(descriptor.activationConcurrency)
-            && (hasRemainingCapacity(populationCapacity.actors)
-                || hasRemainingCapacity(populationCapacity.spots));
-        const placementAvailable = objectRole === contracts_2.ZLinkObjectRole.Server
-            && placementWeight > 0
-            && capacityAvailable
-            && locationStoreHealthy
-            && hostReady
-            && localTopologyState === contracts_1.ZLinkTopologyState.Ready;
+        const capacityAvailable = descriptor !== undefined &&
+            populationCapacity !== undefined &&
+            hasRemainingCapacity(descriptor.activationConcurrency) &&
+            (hasRemainingCapacity(populationCapacity.actors) ||
+                hasRemainingCapacity(populationCapacity.spots));
+        const placementAvailable = objectRole === contracts_2.ZLinkObjectRole.Server &&
+            placementWeight > 0 &&
+            capacityAvailable &&
+            locationStoreHealthy &&
+            hostReady &&
+            localTopologyState === contracts_1.ZLinkTopologyState.Ready;
         const snapshot = {
             meshName,
             state,
             isReady: (0, runtime_state_projections_1.topologyRuntimeIsReady)(hostState, state === contracts_1.ZLinkTopologyState.Ready ? 1 : 0),
-            readyPeerCount: peers.filter(peer => peer.state === contracts_1.ZLinkPeerState.Ready).length,
-            channels: hostReady
-                ? channels
-                : channels.map(channel => ({ ...channel, isReady: false })),
+            readyPeerCount: peers.filter((peer) => peer.state === contracts_1.ZLinkPeerState.Ready).length,
+            channels: hostReady ? channels : channels.map((channel) => ({ ...channel, isReady: false })),
             peers,
             placement: {
                 isAvailable: placementAvailable,
@@ -174,15 +166,13 @@ class ZLinkRouteMeshRuntimeCoordinator {
             let terminal;
             try {
                 const current = this.snapshot(meshName);
-                const terminalSequence = current.sequence >= state.sequence
-                    ? current.sequence + 1n
-                    : state.sequence;
+                const terminalSequence = current.sequence >= state.sequence ? current.sequence + 1n : state.sequence;
                 state.sequence = terminalSequence;
                 terminal = {
                     ...current,
                     state: contracts_1.ZLinkTopologyState.Stopped,
                     isReady: false,
-                    channels: current.channels.map(channel => ({
+                    channels: current.channels.map((channel) => ({
                         ...channel,
                         isReady: false
                     })),
@@ -198,15 +188,13 @@ class ZLinkRouteMeshRuntimeCoordinator {
             catch {
                 const current = state.lastSnapshot;
                 if (current !== undefined) {
-                    const terminalSequence = current.sequence >= state.sequence
-                        ? current.sequence + 1n
-                        : state.sequence;
+                    const terminalSequence = current.sequence >= state.sequence ? current.sequence + 1n : state.sequence;
                     state.sequence = terminalSequence;
                     terminal = {
                         ...current,
                         state: contracts_1.ZLinkTopologyState.Stopped,
                         isReady: false,
-                        channels: current.channels.map(channel => ({
+                        channels: current.channels.map((channel) => ({
                             ...channel,
                             isReady: false
                         })),
@@ -243,7 +231,8 @@ class ZLinkRouteMeshRuntimeCoordinator {
         const state = this.requireState(meshName);
         if (this.states.size > 1)
             return Promise.reject(multiMeshDrainError());
-        const operation = state.operation ?? new Promise((resolve) => state.waiters.push(resolve));
+        const operation = state.operation ??
+            new Promise((resolve) => state.waiters.push(resolve));
         return waitForOperation(operation, signal);
     }
     drainHost(deadlineMs = 30_000, signal) {
@@ -371,7 +360,9 @@ class ZLinkRouteMeshRuntimeCoordinator {
             const classified = drainFailureReason(error);
             const reason = classified !== 'teardown_failed'
                 ? classified
-                : deadline.signal.aborted ? 'deadline_exceeded' : classified;
+                : deadline.signal.aborted
+                    ? 'deadline_exceeded'
+                    : classified;
             await this.options.forceStopResources(meshName).catch(() => undefined);
             result = { kind: 'forceStopped', reason };
             this.transition(meshName, state, contracts_1.ZLinkTopologyState.Failed);
@@ -419,7 +410,9 @@ class ZLinkRouteMeshRuntimeCoordinator {
             const classified = drainFailureReason(error);
             const reason = classified !== 'teardown_failed'
                 ? classified
-                : deadline.signal.aborted ? 'deadline_exceeded' : classified;
+                : deadline.signal.aborted
+                    ? 'deadline_exceeded'
+                    : classified;
             await Promise.all(entries.map(([meshName]) => this.options.forceStopResources(meshName).catch(() => undefined)));
             result = { kind: 'forceStopped', reason };
             for (const [meshName, state] of entries) {
@@ -438,12 +431,9 @@ class ZLinkRouteMeshRuntimeCoordinator {
         return result;
     }
     async performHostShutdown(cleanupDeadline, remainingTimeoutMs) {
-        const timeoutMs = Math.max(0, remainingTimeoutMs ?? (cleanupDeadline instanceof Date
-            ? cleanupDeadline.getTime() - Date.now()
-            : cleanupDeadline));
-        const deadlineAt = cleanupDeadline instanceof Date
-            ? cleanupDeadline
-            : new Date(Date.now() + cleanupDeadline);
+        const timeoutMs = Math.max(0, remainingTimeoutMs ??
+            (cleanupDeadline instanceof Date ? cleanupDeadline.getTime() - Date.now() : cleanupDeadline));
+        const deadlineAt = cleanupDeadline instanceof Date ? cleanupDeadline : new Date(Date.now() + cleanupDeadline);
         const entries = [...this.states.entries()];
         if (entries.length === 0)
             return { kind: 'drained' };
@@ -472,7 +462,9 @@ class ZLinkRouteMeshRuntimeCoordinator {
             const classified = drainFailureReason(error);
             const reason = classified !== 'teardown_failed'
                 ? classified
-                : deadline.signal.aborted ? 'deadline_exceeded' : classified;
+                : deadline.signal.aborted
+                    ? 'deadline_exceeded'
+                    : classified;
             await Promise.all(entries.map(([meshName]) => this.options.forceStopResources(meshName).catch(() => undefined)));
             result = { kind: 'forceStopped', reason };
             for (const [meshName, state] of entries) {
@@ -507,15 +499,13 @@ class ZLinkRouteMeshRuntimeCoordinator {
         const terminal = next === contracts_1.ZLinkTopologyState.Stopped || next === contracts_1.ZLinkTopologyState.Failed;
         if (current !== undefined) {
             if (terminal) {
-                const terminalSequence = current.sequence >= state.sequence
-                    ? current.sequence + 1n
-                    : state.sequence;
+                const terminalSequence = current.sequence >= state.sequence ? current.sequence + 1n : state.sequence;
                 state.sequence = terminalSequence;
                 const terminalStatus = {
                     ...current,
                     state: next,
                     isReady: false,
-                    channels: current.channels.map(channel => ({
+                    channels: current.channels.map((channel) => ({
                         ...channel,
                         isReady: false
                     })),
@@ -594,10 +584,7 @@ class ZLinkRouteMeshRuntimeCoordinator {
             const peers = node?.peers() ?? [];
             const nextPeers = peerFingerprintMap(peers);
             this.peerFingerprints.set(meshName, nextPeers);
-            for (const peerRid of new Set([
-                ...previousPeers.keys(),
-                ...nextPeers.keys()
-            ])) {
+            for (const peerRid of new Set([...previousPeers.keys(), ...nextPeers.keys()])) {
                 if (previousPeers.get(peerRid) === nextPeers.get(peerRid))
                     continue;
                 state.sequence += 1n;
@@ -655,11 +642,10 @@ function placementFingerprint(descriptor) {
     ]);
 }
 function hasRemainingCapacity(capacity) {
-    return capacity.limit === 0
-        || capacity.active + (capacity.reserved ?? 0) < capacity.limit;
+    return capacity.limit === 0 || capacity.active + (capacity.reserved ?? 0) < capacity.limit;
 }
 function peerFingerprintMap(peers) {
-    return new Map(peers.map(peer => [
+    return new Map(peers.map((peer) => [
         String(peer.routingId),
         JSON.stringify([
             peer.lifecycleGeneration.toString(),
@@ -685,20 +671,28 @@ function multiMeshDrainError() {
 }
 function backendState(state) {
     switch (state) {
-        case 1: return contracts_1.ZLinkTopologyState.Starting;
+        case 1:
+            return contracts_1.ZLinkTopologyState.Starting;
         case 2:
         case 3:
-        case 4: return contracts_1.ZLinkTopologyState.Ready;
-        case 5: return contracts_1.ZLinkTopologyState.Stopping;
-        case 6: return contracts_1.ZLinkTopologyState.Stopped;
-        default: return contracts_1.ZLinkTopologyState.Failed;
+        case 4:
+            return contracts_1.ZLinkTopologyState.Ready;
+        case 5:
+            return contracts_1.ZLinkTopologyState.Stopping;
+        case 6:
+            return contracts_1.ZLinkTopologyState.Stopped;
+        default:
+            return contracts_1.ZLinkTopologyState.Failed;
     }
 }
 function peerState(state) {
     switch (state) {
-        case 3: return contracts_1.ZLinkPeerState.Ready;
-        case 4: return contracts_1.ZLinkPeerState.Draining;
-        case 6: return contracts_1.ZLinkPeerState.NotRequired;
+        case 3:
+            return contracts_1.ZLinkPeerState.Ready;
+        case 4:
+            return contracts_1.ZLinkPeerState.Draining;
+        case 6:
+            return contracts_1.ZLinkPeerState.NotRequired;
         case 1:
         case 2:
             return contracts_1.ZLinkPeerState.Connecting;
@@ -721,8 +715,9 @@ function drainFailureReason(error) {
     const name = error instanceof Error ? error.name : '';
     if (name === 'ZLinkDrainingStatePublishError')
         return 'drain_state_publish_failed';
-    if (name === 'ZLinkOwnerCleanupError' || error instanceof AggregateError
-        && error.errors.some((nested) => nested instanceof Error && nested.name === 'ZLinkOwnerCleanupError')) {
+    if (name === 'ZLinkOwnerCleanupError' ||
+        (error instanceof AggregateError &&
+            error.errors.some((nested) => nested instanceof Error && nested.name === 'ZLinkOwnerCleanupError'))) {
         return 'owner_cleanup_failed';
     }
     return 'teardown_failed';

package/dist/runtime/host/runtime-shutdown.js

@@ -63,6 +63,5 @@ async function runShutdownStep(errors, step) {
 function isShutdownAbort(error) {
     if ((0, abort_1.isAbortError)(error))
         return true;
-    return error instanceof AggregateError
-        && error.errors.every((nested) => isShutdownAbort(nested));
+    return error instanceof AggregateError && error.errors.every((nested) => isShutdownAbort(nested));
 }