@zlink-systems/framework 0.30.0 → 0.30.1

package/dist/runtime/host/entry-actor-runtime.js

@@ -16,6 +16,9 @@ class ZLinkEntryActorRuntimeService {
     resolveActor(actorId) {
         return this.options.actorManager()?.getState(actorId)?.actor;
     }
+    async releaseMembers(meshName) {
+        await this.options.actorManager()?.releaseSpotActorMembers(meshName);
+    }
     async commitActorTransaction(actor, onJoined) {
         const state = this.options.actorManager()?.getState(actor.context.actorId);
         const entryNode = this.options.spotNodeRuntime()?.primaryMeshNode;

package/dist/runtime/host/index.d.ts

@@ -30,7 +30,7 @@ export declare class ZLinkFrameworkRuntimeHost implements ZLinkFrameworkRuntimeL
     private readonly lifecycleSink?;
     private executionState?;
     private runtimeState;
-    private runtimeSequence;
+    private runtimeStatus?;
     private readonly runtimeObservationSource;
     private runtimeDeadline?;
     private shutdownDeadline?;
@@ -95,6 +95,7 @@ export declare class ZLinkFrameworkRuntimeHost implements ZLinkFrameworkRuntimeL
     constructor(options: ZLinkFrameworkRuntimeHostOptions, internalOptions?: unknown);
     get isStarted(): boolean;
     get status(): ZLinkFrameworkRuntimeStatus;
+    private buildRuntimeStatus;
     private listenerRecords;
     getListenerStatus(kind: ZLinkListenerKind, name: string): ZLinkListenerStatus;
     observe(signal?: AbortSignal): AsyncIterable<ZLinkObservedStatus<ZLinkFrameworkRuntimeStatus>>;
@@ -109,6 +110,7 @@ export declare class ZLinkFrameworkRuntimeHost implements ZLinkFrameworkRuntimeL
     private recordRelocationResult;
     private completeTermination;
     private setRuntimeState;
+    private publishCurrentRuntimeStatus;
     private publishRuntimeStatus;
     private notifyTopologyHostStateChanged;
     private stopTopologyObservers;
@@ -163,7 +165,11 @@ export declare class ZLinkFrameworkRuntimeHost implements ZLinkFrameworkRuntimeL
     private actorRuntimeOptionsFactory;
     private createChannelRuntimeOptions;
     private createSpotNodeRuntimeOptions;
+    private dispatchMeshNodeRecord;
+    private dispatchMeshNodePayload;
+    private completeFormalSourceLeave;
     private dispatchMeshRecord;
+    private dispatchMeshActorBinding;
     private submitLocalMeshRoute;
     private dispatchMeshSpotRecord;
     private createDispatchErrorReporter;

package/dist/runtime/host/index.js

@@ -7,6 +7,7 @@ const application_job_queue_scope_1 = require("../application-jobs/application-j
 const location_store_pages_1 = require("../locations/location-store-pages");
 const stream_wire_1 = require("@zlink-systems/stream-wire");
 const node_crypto_1 = require("node:crypto");
+const node_util_1 = require("node:util");
 const contracts_1 = require("../../contracts");
 const ConfigurationException_1 = require("../../contracts/Configuration/ConfigurationException");
 const DiagnosticsValidation_1 = require("../../contracts/Configuration/DiagnosticsValidation");
@@ -77,7 +78,7 @@ class ZLinkFrameworkRuntimeHost {
     lifecycleSink;
     executionState;
     runtimeState = contracts_1.ZLinkFrameworkRuntimeState.Preparing;
-    runtimeSequence = 0n;
+    runtimeStatus;
     runtimeObservationSource = Symbol('zlink.framework-runtime');
     runtimeDeadline;
     shutdownDeadline;
@@ -153,16 +154,8 @@ class ZLinkFrameworkRuntimeHost {
         this.runtimeEventPublisher =
             options.runtimeEventPublisher ?? new diagnostics_1.DefaultZLinkRuntimeEventPublisher();
         this.metrics = new diagnostics_1.ZLinkRuntimeMetrics(options.registration.metrics?.meterProvider);
-        this.applicationJobQueue = new application_job_queue_1.ApplicationJobQueue((0, application_job_queue_1.resolveApplicationJobQueueConfiguration)(options.registration.applicationJobQueue, () => (0, application_job_queue_1.nodeEffectiveProcessorCount)(options.registration.worker?.maxThreads)), undefined, () => {
-            try {
-                return (this.options.providerResolver
-                    ?.get?.(application_job_queue_handler_start_gate_1.ZLINK_INTERNAL_APPLICATION_JOB_QUEUE_HANDLER_START_GATE)
-                    ?.shouldHoldPermitBeforeHandler() === true);
-            }
-            catch {
-                return false;
-            }
-        }, (error) => (this.errorSink ?? this.preStartErrorSink).reportRuntimeTaskException('logger-provider', error));
+        const handlerStartGate = options.providerResolver?.get?.(application_job_queue_handler_start_gate_1.ZLINK_INTERNAL_APPLICATION_JOB_QUEUE_HANDLER_START_GATE);
+        this.applicationJobQueue = new application_job_queue_1.ApplicationJobQueue((0, application_job_queue_1.resolveApplicationJobQueueConfiguration)(options.registration.applicationJobQueue, () => (0, application_job_queue_1.nodeEffectiveProcessorCount)(options.registration.worker?.maxThreads)), undefined, handlerStartGate?.shouldHoldPermitBeforeHandler.bind(handlerStartGate), (error) => (this.errorSink ?? this.preStartErrorSink).reportRuntimeTaskException('logger-provider', error));
         this.capacityStatus = new host_capacity_status_1.HostCapacityStatusProjection(options.registration.coreHwm, this.applicationJobQueue);
         this.clientServerRuntime = new topology_runtime_projections_1.ZLinkClientServerRuntimeProjection(() => this.channelRuntime, () => this.runtimeState);
         this.fanoutRuntime = new topology_runtime_projections_1.ZLinkFanoutRuntimeProjection(() => this.channelRuntime, () => this.runtimeState);
@@ -509,6 +502,7 @@ class ZLinkFrameworkRuntimeHost {
         this.serviceRelocation = new service_relocation_host_runtime_1.ZLinkHostServiceRelocationRuntime({
             registration: options.registration,
             targetAdmissionSealed: () => this.shutdownOperationStartedAt !== undefined,
+            sourceQuiescenceChanged: () => this.publishCurrentRuntimeStatus(),
             providerResolver: options.providerResolver,
             locationStore: () => this.locationOwner.currentStores?.locationStore,
             currentOwner: () => this.locationOwner.currentRuntime?.currentOwnerToken,
@@ -582,6 +576,9 @@ class ZLinkFrameworkRuntimeHost {
         return this.executionState !== undefined && !this.executionState.abortController.signal.aborted;
     }
     get status() {
+        return this.publishCurrentRuntimeStatus();
+    }
+    buildRuntimeStatus() {
         return {
             state: this.runtimeState,
             isReady: (0, runtime_state_projections_1.runtimeStateIsReady)(this.runtimeState),
@@ -591,8 +588,8 @@ class ZLinkFrameworkRuntimeHost {
             deadline: this.runtimeDeadline,
             relocationResult: this.runtimeRelocationResult,
             terminationResult: this.runtimeTerminationResult,
-            sequence: this.runtimeSequence,
-            observedAt: new Date()
+            sequence: this.runtimeStatus?.sequence ?? 0n,
+            observedAt: this.runtimeStatus?.observedAt ?? new Date()
         };
     }
     // Bound listener records of the current runtime generation.
@@ -605,10 +602,11 @@ class ZLinkFrameworkRuntimeHost {
         return { kind, name, endpoint, observedAt: new Date() };
     }
     observe(signal) {
+        const status = this.status;
         const queue = new runtime_observation_queue_1.RuntimeEventQueue(undefined, signal);
         this.runtimeObservers.add(queue);
         queue.onClose(() => this.runtimeObservers.delete(queue));
-        this.publishRuntimeStatus(queue, this.status);
+        this.publishRuntimeStatus(queue, status);
         return queue;
     }
     resetCapacityMetrics() {
@@ -771,6 +769,9 @@ class ZLinkFrameworkRuntimeHost {
                 const shutdown = this.routeMeshCoordinator.shutdownHost(this.runtimeDeadline, this.shutdownDeadline.signal);
                 const drain = await shutdown;
                 await unscopedStreamDrain;
+                if (drain.kind === 'forceStopped' && drain.error !== undefined) {
+                    this.runtimeOrPreStartErrorSink.reportRuntimeTaskException('host shutdown', drain.error);
+                }
                 await this.stop();
                 if (drain.kind === 'forceStopped') {
                     return this.completeTermination({
@@ -892,12 +893,24 @@ class ZLinkFrameworkRuntimeHost {
         if (this.runtimeState === state)
             return;
         this.runtimeState = state;
-        this.runtimeSequence += 1n;
         this.notifyTopologyHostStateChanged();
-        const status = this.status;
+        this.publishCurrentRuntimeStatus();
+    }
+    publishCurrentRuntimeStatus() {
+        const current = this.buildRuntimeStatus();
+        if (this.runtimeStatus !== undefined && (0, node_util_1.isDeepStrictEqual)(this.runtimeStatus, current)) {
+            return this.runtimeStatus;
+        }
+        const status = {
+            ...current,
+            sequence: (this.runtimeStatus?.sequence ?? 0n) + 1n,
+            observedAt: new Date()
+        };
+        this.runtimeStatus = status;
         for (const observer of this.runtimeObservers) {
             this.publishRuntimeStatus(observer, status);
         }
+        return status;
     }
     publishRuntimeStatus(observer, status) {
         if ((0, runtime_state_projections_1.runtimeObservationIsTerminal)(status.state)) {
@@ -1969,92 +1982,45 @@ class ZLinkFrameworkRuntimeHost {
             activationConcurrency: (meshName) => this.activationAdmission.current(meshName)
         };
     }
-    async dispatchMeshRecord(applicationJobOrigin, meshName, owner, record, signal) {
+    dispatchMeshNodeRecord(meshName, record, signal) {
+        const control = this.serviceRelocation.tryHandleControl(meshName, record, signal);
+        if (control instanceof Promise)
+            return control.then((handled) => handled ? undefined : this.dispatchMeshNodePayload(meshName, record, signal));
+        if (!control)
+            return this.dispatchMeshNodePayload(meshName, record, signal);
+    }
+    dispatchMeshNodePayload(meshName, record, signal) {
+        if (record.kind === service_runtime_contracts_1.ReceiveKind.NodeRequest && record.parts.length === 1) {
+            const terminal = (0, actors_1.decodeRemoteActorSourceLeaveTerminal)(record.parts[0].data());
+            if (terminal !== undefined) {
+                return this.completeFormalSourceLeave(record, terminal);
+            }
+        }
+        const channelRuntime = this.channelRuntime;
+        if (channelRuntime === undefined) {
+            throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode node-direct dispatch requires the channel runtime.');
+        }
+        return channelRuntime.dispatchMeshRoute(meshName, record, signal);
+    }
+    async completeFormalSourceLeave(record, terminal) {
+        const completed = await this.spotManager?.completeFormalSourceLeaveTerminal(terminal.actorId, terminal.transferId, terminal.succeeded);
+        if (completed !== true) {
+            throw new ConfigurationException_1.ZLinkConfigurationException(`Actor '${terminal.actorId}' has no matching formal transfer terminal gate.`);
+        }
+        if (record.reply(Buffer.alloc(0)) !== runtime_values_1.SubmitResult.Ok) {
+            throw new ConfigurationException_1.ZLinkConfigurationException(`Actor '${terminal.actorId}' formal transfer terminal acknowledgement failed.`);
+        }
+        return;
+    }
+    dispatchMeshRecord(applicationJobOrigin, meshName, owner, record, signal) {
         if (record.operationKind === service_runtime_contracts_1.OperationKind.ActorJoin) {
             if (this.spotManager === undefined) {
                 throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode Actor join dispatch requires the Spot manager.');
             }
             return this.spotManager.dispatchMeshActorJoin(meshName, owner, record);
         }
-        if (record.kind === service_runtime_contracts_1.ReceiveKind.ActorBinding) {
-            if (record.kindData?.kind !== 'actorBinding') {
-                throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode Actor binding record has no binding generation.');
-            }
-            const binding = record.kindData;
-            const replyBindingFailure = (kind) => {
-                const terminal = (0, framework_errors_internal_1.internalFrameworkWireReply)(kind);
-                if (record.replyFailure?.(terminal.terminalResult, terminal.failureCode) !== runtime_values_1.SubmitResult.Ok) {
-                    throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode Actor binding target '${binding.actor.actorId}' failure acknowledgement failed.`);
-                }
-            };
-            const replyBindingSuccess = () => {
-                if (record.reply(Buffer.alloc(0)) !== runtime_values_1.SubmitResult.Ok) {
-                    throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode Actor binding target '${binding.actor.actorId}' acknowledgement failed.`);
-                }
-            };
-            const state = this.actorManager?.getState(binding.actor.actorId);
-            const nativeActorRef = state?.nativeActorRef;
-            if (state === undefined ||
-                nativeActorRef === undefined ||
-                nativeActorRef.actorId !== binding.actor.actorId ||
-                !(0, routing_id_1.routingIdsEqual)(nativeActorRef.nodeRid, binding.actor.nodeRid)) {
-                replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
-                return;
-            }
-            if (nativeActorRef.generation !== binding.actor.generation) {
-                replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorGenerationStale);
-                return;
-            }
-            const node = state.meshName === meshName ? this.spotNodeRuntime?.meshNode(meshName) : undefined;
-            const localStatus = node?.status();
-            // ownsLocation tracks local cleanup responsibility, not Actor authority.
-            // A relocation target can exact-read committed authority without owning that cleanup.
-            if (localStatus === undefined ||
-                !(0, routing_id_1.routingIdsEqual)(localStatus.routingId, binding.actor.nodeRid) ||
-                localStatus.lifecycleGeneration !== binding.actorNodeGeneration ||
-                state.locationGeneration !== binding.authorityOwnerGeneration ||
-                state.isMoving) {
-                replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
-                return;
-            }
-            const sessionOwnerIsLocal = (0, routing_id_1.routingIdsEqual)(localStatus.routingId, binding.sessionNodeRid) &&
-                localStatus.lifecycleGeneration === binding.sessionOwnerNodeGeneration;
-            if (binding.transition === 'tombstone') {
-                const actorRef = {
-                    actorId: binding.actor.actorId,
-                    objectGeneration: binding.actor.generation,
-                    meshName,
-                    nodeRid: binding.actor.nodeRid
-                };
-                if (sessionOwnerIsLocal) {
-                    (0, application_job_queue_scope_2.releaseApplicationJobPermitBeforeHandler)();
-                    await this.streamBindingRuntime.retireRemoteBinding(actorRef, binding.sessionRid, binding.bindingGeneration, signal);
-                }
-                state.retireBoundSessionBinding(binding);
-                replyBindingSuccess();
-                return;
-            }
-            const target = this.boundSessionRelay.boundSessions.resolveRemoteBoundSessionTarget(binding.sessionNodeRid, binding.sessionRid);
-            if (target === undefined) {
-                replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
-                return;
-            }
-            const installed = state.installBoundSessionBinding({
-                ...target,
-                sessionNodeRid: binding.sessionNodeRid,
-                sessionRid: binding.sessionRid,
-                sessionOwnerNodeGeneration: binding.sessionOwnerNodeGeneration,
-                sessionOwnerId: binding.sessionOwnerId,
-                sessionOwnerLeaseGeneration: binding.sessionOwnerLeaseGeneration,
-                bindingGeneration: binding.bindingGeneration
-            });
-            if (!installed) {
-                replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
-                return;
-            }
-            replyBindingSuccess();
-            return Promise.resolve();
-        }
+        if (record.kind === service_runtime_contracts_1.ReceiveKind.ActorBinding)
+            return this.dispatchMeshActorBinding(meshName, record, signal);
         switch (record.kind) {
             case service_runtime_contracts_1.ReceiveKind.TransferControl:
                 if (record.kindData?.kind !== 'transferControl') {
@@ -2071,28 +2037,7 @@ class ZLinkFrameworkRuntimeHost {
             }
             case service_runtime_contracts_1.ReceiveKind.NodeSend:
             case service_runtime_contracts_1.ReceiveKind.NodeRequest: {
-                return this.admission.run(meshName, 'RouteMesh node dispatch', async () => {
-                    if (await this.serviceRelocation.tryHandleControl(meshName, record, signal)) {
-                        return;
-                    }
-                    if (record.kind === service_runtime_contracts_1.ReceiveKind.NodeRequest && record.parts.length === 1) {
-                        const terminal = (0, actors_1.decodeRemoteActorSourceLeaveTerminal)(record.parts[0].data());
-                        if (terminal !== undefined) {
-                            if ((await this.spotManager?.completeFormalSourceLeaveTerminal(terminal.actorId, terminal.transferId, terminal.succeeded)) !== true) {
-                                throw new ConfigurationException_1.ZLinkConfigurationException(`Actor '${terminal.actorId}' has no matching formal transfer terminal gate.`);
-                            }
-                            if (record.reply(Buffer.alloc(0)) !== runtime_values_1.SubmitResult.Ok) {
-                                throw new ConfigurationException_1.ZLinkConfigurationException(`Actor '${terminal.actorId}' formal transfer terminal acknowledgement failed.`);
-                            }
-                            return;
-                        }
-                    }
-                    const channelRuntime = this.channelRuntime;
-                    if (channelRuntime === undefined) {
-                        throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode node-direct dispatch requires the channel runtime.');
-                    }
-                    return await channelRuntime.dispatchMeshRoute(meshName, record, signal);
-                });
+                return this.admission.run(meshName, 'RouteMesh node dispatch', () => this.dispatchMeshNodeRecord(meshName, record, signal));
             }
             case service_runtime_contracts_1.ReceiveKind.SpotSend:
             case service_runtime_contracts_1.ReceiveKind.SpotRequest:
@@ -2120,6 +2065,85 @@ class ZLinkFrameworkRuntimeHost {
                 throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode record kind '${record.kind}' does not yet have a registered framework consumer.`);
         }
     }
+    async dispatchMeshActorBinding(meshName, record, signal) {
+        if (record.kindData?.kind !== 'actorBinding') {
+            throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode Actor binding record has no binding generation.');
+        }
+        const binding = record.kindData;
+        const replyBindingFailure = (kind) => {
+            const terminal = (0, framework_errors_internal_1.internalFrameworkWireReply)(kind);
+            if (record.replyFailure?.(terminal.terminalResult, terminal.failureCode) !== runtime_values_1.SubmitResult.Ok) {
+                throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode Actor binding target '${binding.actor.actorId}' failure acknowledgement failed.`);
+            }
+        };
+        const replyBindingSuccess = () => {
+            if (record.reply(Buffer.alloc(0)) !== runtime_values_1.SubmitResult.Ok) {
+                throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode Actor binding target '${binding.actor.actorId}' acknowledgement failed.`);
+            }
+        };
+        const state = this.actorManager?.getState(binding.actor.actorId);
+        const nativeActorRef = state?.nativeActorRef;
+        if (state === undefined ||
+            nativeActorRef === undefined ||
+            nativeActorRef.actorId !== binding.actor.actorId ||
+            !(0, routing_id_1.routingIdsEqual)(nativeActorRef.nodeRid, binding.actor.nodeRid)) {
+            replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
+            return;
+        }
+        if (nativeActorRef.generation !== binding.actor.generation) {
+            replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorGenerationStale);
+            return;
+        }
+        const node = state.meshName === meshName ? this.spotNodeRuntime?.meshNode(meshName) : undefined;
+        const localStatus = node?.status();
+        // ownsLocation tracks local cleanup responsibility, not Actor authority.
+        // A relocation target can exact-read committed authority without owning that cleanup.
+        if (localStatus === undefined ||
+            !(0, routing_id_1.routingIdsEqual)(localStatus.routingId, binding.actor.nodeRid) ||
+            localStatus.lifecycleGeneration !== binding.actorNodeGeneration ||
+            state.locationGeneration !== binding.authorityOwnerGeneration ||
+            state.isMoving) {
+            replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
+            return;
+        }
+        const sessionOwnerIsLocal = (0, routing_id_1.routingIdsEqual)(localStatus.routingId, binding.sessionNodeRid) &&
+            localStatus.lifecycleGeneration === binding.sessionOwnerNodeGeneration;
+        if (binding.transition === 'tombstone') {
+            const actorRef = {
+                actorId: binding.actor.actorId,
+                objectGeneration: binding.actor.generation,
+                meshName,
+                nodeRid: binding.actor.nodeRid
+            };
+            if (sessionOwnerIsLocal) {
+                (0, application_job_queue_scope_2.releaseApplicationJobPermitBeforeHandler)();
+                await this.streamBindingRuntime.retireRemoteBinding(actorRef, binding.sessionRid, binding.bindingGeneration, signal);
+            }
+            state.retireBoundSessionBinding(binding);
+            replyBindingSuccess();
+            return;
+        }
+        const target = this.boundSessionRelay.boundSessions.resolveRemoteBoundSessionTarget(binding.sessionNodeRid, binding.sessionRid);
+        if (target === undefined) {
+            replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
+            return;
+        }
+        const installed = state.installBoundSessionBinding({
+            ...target,
+            sessionNodeRid: binding.sessionNodeRid,
+            sessionRid: binding.sessionRid,
+            sessionOwnerNodeGeneration: binding.sessionOwnerNodeGeneration,
+            sessionOwnerId: binding.sessionOwnerId,
+            sessionOwnerLeaseGeneration: binding.sessionOwnerLeaseGeneration,
+            bindingGeneration: binding.bindingGeneration
+        });
+        if (!installed) {
+            replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
+            return;
+        }
+        replyBindingSuccess();
+        return Promise.resolve();
+    }
     submitLocalMeshRoute(meshName, sourceNodeRid, parts) {
         const state = this.executionState;
         const channelRuntime = this.channelRuntime;

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

@@ -520,33 +520,17 @@ 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 &&
+    const sameSession = (0, routing_id_1.routingIdsEqual)(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 &&
+        (0, routing_id_1.routingIdsEqual)(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) {
-            throw new service_wire_m6a_codec_1.ServiceWireProtocolError(`Session relocation '${serviceWireBarrierKey(route)}' changed its source authority fence.`);
-        }
-        return;
-    }
-    if (route.route.currentAuthorityOwnerGeneration !== sealed.actor.authorityOwnerGeneration) {
-        throw new service_wire_m6a_codec_1.ServiceWireProtocolError(`Session relocation '${serviceWireBarrierKey(route)}' abort changed its authority fence.`);
-    }
 }

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

@@ -409,7 +409,7 @@ class ZLinkRouteMeshRuntimeCoordinator {
                     ? 'deadline_exceeded'
                     : classified;
             await Promise.all(entries.map(([meshName]) => this.options.forceStopResources(meshName).catch(() => undefined)));
-            result = { kind: 'forceStopped', reason };
+            result = { kind: 'forceStopped', reason, error };
             for (const [meshName, state] of entries) {
                 this.transition(meshName, state, contracts_1.ZLinkTopologyState.Failed);
             }

package/dist/runtime/host/service-relocation-control.d.ts

@@ -3,5 +3,6 @@ export type ZLinkServiceRelocationControlRequest = ServiceMaintenanceRelocationC
 export type ZLinkServiceRelocationControlResponse = ServiceMaintenanceRelocationControl;
 export declare function encodeServiceRelocationControlRequest(request: ZLinkServiceRelocationControlRequest): Buffer;
 export declare function decodeServiceRelocationControlRequest(payload: Uint8Array): ZLinkServiceRelocationControlRequest | undefined;
+export declare function serviceRelocationControlCommand(payload: Uint8Array): number | undefined;
 export declare function encodeServiceRelocationControlResponse(response: ZLinkServiceRelocationControlResponse): Buffer;
 export declare function decodeServiceRelocationControlResponse(payload: Uint8Array): ZLinkServiceRelocationControlResponse;

package/dist/runtime/host/service-relocation-control.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.encodeServiceRelocationControlRequest = encodeServiceRelocationControlRequest;
 exports.decodeServiceRelocationControlRequest = decodeServiceRelocationControlRequest;
+exports.serviceRelocationControlCommand = serviceRelocationControlCommand;
 exports.encodeServiceRelocationControlResponse = encodeServiceRelocationControlResponse;
 exports.decodeServiceRelocationControlResponse = decodeServiceRelocationControlResponse;
 const service_wire_binary_primitives_1 = require("../foundation/service-wire-binary-primitives");
@@ -14,13 +15,18 @@ function decodeServiceRelocationControlRequest(payload) {
     const bytes = Buffer.isBuffer(payload)
         ? payload
         : Buffer.from(payload.buffer, payload.byteOffset, payload.byteLength);
-    if (bytes.byteLength < service_wire_binary_primitives_1.SERVICE_WIRE_PREFIX_SIZE ||
-        bytes[0] !== service_wire_constants_generated_1.SERVICE_WIRE_MAGIC[0] ||
-        bytes[1] !== service_wire_constants_generated_1.SERVICE_WIRE_MAGIC[1] ||
-        bytes[service_wire_binary_primitives_1.SERVICE_WIRE_MAJOR_OFFSET] !== service_wire_constants_generated_1.SERVICE_WIRE_MAJOR)
+    if (serviceRelocationControlCommand(bytes) === undefined)
         return undefined;
     return (0, service_stateful_wire_codec_1.decodeMaintenanceRelocationControl)(bytes);
 }
+function serviceRelocationControlCommand(payload) {
+    if (payload.byteLength < service_wire_binary_primitives_1.SERVICE_WIRE_PREFIX_SIZE ||
+        payload[0] !== service_wire_constants_generated_1.SERVICE_WIRE_MAGIC[0] ||
+        payload[1] !== service_wire_constants_generated_1.SERVICE_WIRE_MAGIC[1] ||
+        payload[service_wire_binary_primitives_1.SERVICE_WIRE_MAJOR_OFFSET] !== service_wire_constants_generated_1.SERVICE_WIRE_MAJOR)
+        return undefined;
+    return payload[service_wire_binary_primitives_1.SERVICE_WIRE_COMMAND_OFFSET];
+}
 function encodeServiceRelocationControlResponse(response) {
     return (0, service_stateful_wire_codec_1.encodeMaintenanceRelocationControl)(response);
 }

package/dist/runtime/host/service-relocation-host-runtime.d.ts

@@ -24,6 +24,7 @@ interface ZLinkHostRelocationOptions {
     readonly locationStore: () => ZLinkLocationStore | undefined;
     readonly currentOwner: () => ZLinkLocationOwnerToken | undefined;
     readonly targetAdmissionSealed?: () => boolean;
+    readonly sourceQuiescenceChanged?: () => void;
     readonly liveDescriptors: (meshName: string, signal?: AbortSignal) => Promise<readonly ZLinkMeshNodeDescriptor[]>;
     readonly localDescriptor?: (meshName: string) => ZLinkMeshNodeDescriptor | undefined;
     readonly meshNode: (meshName: string) => ZLinkBackendMeshNode | undefined;
@@ -97,7 +98,8 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
     completeActorJoinSourceCleanup(actorId: string): void;
     private finalizeActorJoinSource;
     relocateMesh(meshName: string, targetApplicationVersion?: bigint, signal?: AbortSignal, stopStartingSignal?: AbortSignal): Promise<void>;
-    tryHandleControl(meshName: string, record: ReceiveRecord, signal?: AbortSignal): Promise<boolean>;
+    tryHandleControl(meshName: string, record: ReceiveRecord, signal?: AbortSignal): boolean | Promise<boolean>;
+    private handleControl;
     /** Sends the Ready reply once the async restore finished; failures replay on resend. */
     private deliverTargetReady;
     /** Cleans up a Ready reply that never delivered within the Restore validity window. */
@@ -153,11 +155,7 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
     /** The authority settlement ended: the retained batch copy is released. */
     private closeSourceCutoverWindow;
     private releaseSourceCutoverWindow;
-    /**
-     * Sends the whole boundary batch and cutover again after a failed submit
-     * or an observed loss of the target connection (spec 28 §4.4). The target
-     * replaces its partial span with the whole batch.
-     */
+    /** Relocation flow §4.4: replay the whole batch on a different ready route. */
     private resendSourceCutover;
     /**
      * The one source authority settlement after Ready (Location runtime
@@ -167,8 +165,8 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
      * excludes a late target commit. `target`: the
      * target committed. `source`: Preserve fenced the target out while the
      * source owner lease was valid. `lost`: the source owner lease ended first
-     * or another authority owns the object. An uncertain Store or lease result
-     * keeps the work retained and repeats the same decision.
+     * or authority is Missing or another authority owns the object. An uncertain
+     * Store or lease result keeps the work retained and repeats the same decision.
      */
     private settleSourceAuthority;
     private readSourceSettlement;