@zlink-systems/framework 0.30.3 → 0.32.0

package/dist/runtime/host/index.js

@@ -3,6 +3,9 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkUserSpotCreationCoordinator = exports.ZLinkHostSpotAddressTransport = exports.ZLinkRelocationStateIncompatibleError = exports.ZLinkRouteMeshRuntimeCoordinator = exports.ZLinkRetiringRollbackError = exports.ZLinkDrainingStatePublishError = exports.transferIdString = exports.ZLinkActorTransferAuthorityRuntime = exports.ZLinkFrameworkRuntimeHost = void 0;
 exports.hasUnsupportedManualTopology = hasUnsupportedManualTopology;
 exports.hasExactPeerReadiness = hasExactPeerReadiness;
+const contracts_1 = require("../../contracts");
+const request_runtime_1 = require("../foundation/request-runtime");
+const internal_observation_1 = require("../internal-observation");
 const relocation_blob_1 = require("../locations/relocation-blob");
 const application_job_queue_scope_1 = require("../application-jobs/application-job-queue-scope");
 const location_store_pages_1 = require("../locations/location-store-pages");
@@ -10,7 +13,7 @@ const descriptor_publication_1 = require("../locations/descriptor-publication");
 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 contracts_2 = require("../../contracts");
 const ConfigurationException_1 = require("../../contracts/Configuration/ConfigurationException");
 const DiagnosticsValidation_1 = require("../../contracts/Configuration/DiagnosticsValidation");
 const InternalDefaults_1 = require("../../contracts/Configuration/InternalDefaults");
@@ -35,6 +38,7 @@ const channel_envelope_1 = require("../channels/channel-envelope");
 const diagnostics_1 = require("../diagnostics");
 const runtime_metrics_1 = require("../diagnostics/runtime-metrics");
 const runtime_observation_queue_1 = require("../diagnostics/runtime-observation-queue");
+const message_flow_delivery_1 = require("../diagnostics/message-flow-delivery");
 const topology_runtime_projections_1 = require("../diagnostics/topology-runtime-projections");
 const execution_1 = require("../execution");
 const listener_records_1 = require("../foundation/listener-records");
@@ -79,10 +83,26 @@ const HANDOFF_ACCEPTANCE_POLL_INTERVAL_MS = 10;
 const DEFAULT_HOST_CONTROL_TIMEOUT_MS = 30_000;
 class ZLinkFrameworkRuntimeHost {
     options;
+    [internal_observation_1.inspectRuntime]() {
+        return Object.freeze({
+            ownerLeaseUsable: this.locationOwner.currentRuntime?.ownerLeaseUsable,
+            ownerId: this.locationOwner.currentRuntime?.ownerId,
+            hasOwnerToken: this.locationOwner.currentRuntime?.currentOwnerToken !== undefined,
+            ownerAdmissionOpen: this.admission.ownerAdmissionOpen(),
+            channelRuntimeStarted: this.channelRuntime !== undefined,
+            fanoutStoreIsLocationStore: this.locationOwner.currentStores?.fanoutStore ===
+                this.locationOwner.currentStores?.locationStore,
+            fanoutStoreMethods: Object.freeze({
+                update: typeof this.locationOwner.currentStores?.fanoutStore?.updateFanoutPublisher,
+                remove: typeof this.locationOwner.currentStores?.fanoutStore?.removeFanoutPublisher,
+                list: typeof this.locationOwner.currentStores?.fanoutStore?.listFanoutPublishers
+            })
+        });
+    }
     backendAdapterFactory;
     lifecycleSink;
     executionState;
-    runtimeState = contracts_1.ZLinkFrameworkRuntimeState.Preparing;
+    runtimeState = contracts_2.ZLinkFrameworkRuntimeState.Preparing;
     runtimeStatus;
     runtimeObservationSource = Symbol('zlink.framework-runtime');
     runtimeDeadline;
@@ -123,7 +143,7 @@ class ZLinkFrameworkRuntimeHost {
     applicationJobQueue;
     capacityStatus;
     metricRegistrations = [];
-    admission = new admission_1.ZLinkRuntimeAdmissionGate(() => this.ownerAdmissionOpen());
+    admission;
     activationAdmission = new activation_admission_1.ZLinkActivationAdmission((meshName) => this.options.registration.spotNodes.get(meshName)?.activationConcurrencyLimit ??
         InternalDefaults_1.DEFAULT_ACTIVATION_CONCURRENCY_LIMIT);
     cachedLocationSpotRouteResolver;
@@ -133,6 +153,7 @@ class ZLinkFrameworkRuntimeHost {
     messageFlowModeCell = {
         mode: 'errors'
     };
+    telemetryLease = (0, message_flow_delivery_1.openTelemetryLease)();
     dispatchErrorReporters = new WeakMap();
     runtimeOrPreStartErrorSink = {
         reportRuntimeTaskException: (taskName, error) => (this.errorSink ?? this.preStartErrorSink).reportRuntimeTaskException(taskName, error)
@@ -142,6 +163,7 @@ class ZLinkFrameworkRuntimeHost {
     channelTransport = () => this.channelRuntime;
     channelRuntimeOptions = new channels_1.DefaultZLinkChannelRuntimeOptions(() => this.channelRuntime);
     routeMeshRuntimeOptions = new route_mesh_runtime_options_1.DefaultZLinkRouteMeshRuntimeOptions(() => this.spotNodeRuntime);
+    requests = new request_runtime_1.RequestRuntime();
     routeTransport;
     spotAddressTransport;
     spotPublisherTransport = new spots_1.ZLinkRuntimeSpotPublisherTransport(() => this.spotNodeRuntime);
@@ -155,6 +177,9 @@ class ZLinkFrameworkRuntimeHost {
     routeMeshCoordinator;
     constructor(options, internalOptions) {
         this.options = options;
+        const factories = internalOptions;
+        this.spotNodeRuntime = factories?.spotNodeRuntime;
+        this.admission = (factories?.createAdmissionGate ?? ((ownerOpen) => new admission_1.ZLinkRuntimeAdmissionGate(ownerOpen)))(() => this.ownerAdmissionOpen());
         this.backendAdapterFactory = resolveBackendAdapterFactory(internalOptions);
         this.lifecycleSink = options.lifecycleSink;
         this.runtimeEventPublisher =
@@ -172,8 +197,15 @@ class ZLinkFrameworkRuntimeHost {
         this.fanoutRuntime = new topology_runtime_projections_1.ZLinkFanoutRuntimeProjection(() => this.channelRuntime, () => this.runtimeState);
         this.meshRouters = new mesh_router_resolver_1.MeshRouterResolver(options.registration);
         this.spotRouterChannelIdForMesh = this.meshRouters.spotRouterChannelIdByMesh();
-        this.routeTransport = new channels_1.ZLinkRuntimeRouteTransport(() => this.channelRuntime, (routerChannelId) => this.meshRouters.canUseRouterChannel(routerChannelId), () => this.spotNodeRuntime, { serializers: options.registration.messageSerializers }, (meshName, targetNodeRid) => this.meshRouters.classifyManualNodeTarget(meshName, targetNodeRid), (meshName, sourceNodeRid, parts) => this.submitLocalMeshRoute(meshName, sourceNodeRid, parts), this.metrics, () => this.flowCreationEnabled(), () => this.createDispatchErrorReporter(this.runtimeOrPreStartErrorSink).flow);
+        this.routeTransport = new channels_1.ZLinkRuntimeRouteTransport(() => {
+            if (this.channelRuntime === undefined &&
+                this.runtimeState === contracts_2.ZLinkFrameworkRuntimeState.Stopped) {
+                throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RuntimeShutdown, 'Route channel runtime is stopped.');
+            }
+            return this.channelRuntime;
+        }, (routerChannelId) => this.meshRouters.canUseRouterChannel(routerChannelId), () => this.spotNodeRuntime, { serializers: options.registration.messageSerializers }, (meshName, targetNodeRid) => this.meshRouters.classifyManualNodeTarget(meshName, targetNodeRid), (meshName, sourceNodeRid, parts) => this.submitLocalMeshRoute(meshName, sourceNodeRid, parts), this.metrics, () => this.flowCreationEnabled(), () => this.createDispatchErrorReporter(this.runtimeOrPreStartErrorSink).flow, this.requests);
         this.spotAddressTransport = new spot_address_transport_1.ZLinkHostSpotAddressTransport({
+            requests: this.requests,
             resolver: () => this.createLocationSpotRouteResolver(),
             routed: this.routeTransport,
             meshNames: () => [...this.options.registration.spotNodes]
@@ -225,9 +257,10 @@ class ZLinkFrameworkRuntimeHost {
                     : this.boundSessionRelay.actorPackets.confirmRemoteSessionBinding(actor, sessionNode.status().routingId, sessionRid, signal, options);
             },
             relay: (actor, header, payload) => this.boundSessionRelay.actorPackets.relayActorPacket(actor, header, payload),
-            notifyDisconnected: (actor, signal, binding) => this.boundSessionRelay.actorPackets.notifyBoundActorDisconnected(actor, signal, binding)
+            notifyDisconnected: (actor, signal, binding, authorityFence) => this.boundSessionRelay.actorPackets.notifyBoundActorDisconnected(actor, signal, binding, authorityFence)
         });
         this.actorHandoff = new actors_1.ZLinkActorHandoffCoordinator({
+            requests: this.requests,
             routedTransport: this.routeTransport,
             messageFollowDurationMs: options.registration.locations.options.messageFollowDurationMs,
             requestTimeoutMs: options.registration.requestTimeoutMs,
@@ -385,7 +418,9 @@ class ZLinkFrameworkRuntimeHost {
         });
         this.actorTransferRegistry = new actors_1.ZLinkActorTransferRegistry(options.registration.spotNodes, options.providerResolver, options.registration.messageSerializers);
         this.boundSessionFactory = new streams_1.DefaultZLinkBoundSessionFactory(this.streamBindingRuntime);
-        this.boundSessionRelay = new bound_session_relay_1.ZLinkBoundSessionRelay({
+        const createBoundSessionRelay = factories?.createBoundSessionRelay ??
+            ((relayOptions) => new bound_session_relay_1.ZLinkBoundSessionRelay(relayOptions));
+        this.boundSessionRelay = createBoundSessionRelay({
             requestTimeoutMs: options.registration.requestTimeoutMs,
             sessionRelocationSealTimeoutMs: options.registration.locations.options.sessionRelocationSealTimeoutMs ??
                 Locations_1.zlinkDefaultLocationOptions.sessionRelocationSealTimeoutMs,
@@ -500,6 +535,7 @@ class ZLinkFrameworkRuntimeHost {
             shutdownSignal: () => this.executionState?.abortController.signal
         });
         this.serviceRelocation = new service_relocation_host_runtime_1.ZLinkHostServiceRelocationRuntime({
+            requests: this.requests,
             flowCreationEnabled: () => this.flowCreationEnabled(),
             messageFlow: () => this.createDispatchErrorReporter(this.runtimeOrPreStartErrorSink).flow,
             registration: options.registration,
@@ -523,7 +559,7 @@ class ZLinkFrameworkRuntimeHost {
                 clear: () => this.boundSessionRelay.boundSessions.clearServiceWireSessionRelocations()
             },
             trackInstanceSpot: (input) => this.locationOwner.currentLifecycle?.trackInstanceSpot(input),
-            invalidateActorRoute: (actorId) => this.actorClientLocationResolver?.invalidateActorRoute(actorId),
+            observeActorAuthorityVersion: (actorId, storeVersion) => this.actorClientLocationResolver?.observeActorAuthorityVersion(actorId, storeVersion),
             reconcileStatefulAuthorityRoutes: (signal) => this.statefulAuthorityRoutes?.reconcile(signal) ?? Promise.resolve(),
             runtimeEventPublisher: this.runtimeEventPublisher,
             metrics: this.metrics,
@@ -537,7 +573,8 @@ class ZLinkFrameworkRuntimeHost {
                 ...options.registration.locations.options
             }.ownerLeaseTtlMs
         });
-        this.routeMeshCoordinator = new route_mesh_runtime_1.ZLinkRouteMeshRuntimeCoordinator({
+        this.routeMeshCoordinator = (factories?.createRouteMeshCoordinator ??
+            ((meshOptions) => new route_mesh_runtime_1.ZLinkRouteMeshRuntimeCoordinator(meshOptions)))({
             meshNames: [...options.registration.spotNodes.keys()],
             meshOptions: options.registration.spotNodes,
             meshNode: (meshName) => this.spotNodeRuntime?.meshNode(meshName),
@@ -624,15 +661,15 @@ class ZLinkFrameworkRuntimeHost {
         if (!Number.isFinite(deadlineMs) || deadlineMs <= 0) {
             return Promise.reject(new RangeError('Relocation deadlineMs must be greater than zero.'));
         }
-        if (this.runtimeRelocationResult?.outcome === contracts_1.ZLinkFrameworkRelocationOutcome.Relocated) {
+        if (this.runtimeRelocationResult?.outcome === contracts_2.ZLinkFrameworkRelocationOutcome.Relocated) {
             return Promise.resolve(this.runtimeRelocationResult);
         }
         if (this.shutdownOperation !== undefined) {
             return Promise.resolve({
                 mode: options.mode,
                 effectiveTargetApplicationVersion,
-                outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Blocked,
-                reason: contracts_1.ZLinkFrameworkRelocationReason.ShutdownRequested
+                outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Blocked,
+                reason: contracts_2.ZLinkFrameworkRelocationReason.ShutdownRequested
             });
         }
         const operationKey = `${options.mode}:${effectiveTargetApplicationVersion}`;
@@ -643,34 +680,34 @@ class ZLinkFrameworkRuntimeHost {
             return Promise.resolve({
                 mode: options.mode,
                 effectiveTargetApplicationVersion,
-                outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Blocked,
-                reason: contracts_1.ZLinkFrameworkRelocationReason.OperationInProgress
+                outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Blocked,
+                reason: contracts_2.ZLinkFrameworkRelocationReason.OperationInProgress
             });
         }
-        if (this.runtimeState !== contracts_1.ZLinkFrameworkRuntimeState.Serving) {
+        if (this.runtimeState !== contracts_2.ZLinkFrameworkRuntimeState.Serving) {
             return Promise.resolve({
                 mode: options.mode,
                 effectiveTargetApplicationVersion,
-                outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Blocked,
-                reason: this.runtimeState === contracts_1.ZLinkFrameworkRuntimeState.Relocating
-                    ? contracts_1.ZLinkFrameworkRelocationReason.OperationInProgress
-                    : contracts_1.ZLinkFrameworkRelocationReason.RuntimeNotReady
+                outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Blocked,
+                reason: this.runtimeState === contracts_2.ZLinkFrameworkRuntimeState.Relocating
+                    ? contracts_2.ZLinkFrameworkRelocationReason.OperationInProgress
+                    : contracts_2.ZLinkFrameworkRelocationReason.RuntimeNotReady
             });
         }
         if (!this.admission.acceptsNewWork) {
             return Promise.resolve({
                 mode: options.mode,
                 effectiveTargetApplicationVersion,
-                outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Blocked,
-                reason: contracts_1.ZLinkFrameworkRelocationReason.StoreUnavailable
+                outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Blocked,
+                reason: contracts_2.ZLinkFrameworkRelocationReason.StoreUnavailable
             });
         }
         if (hasUnsupportedManualTopology(this.options.registration)) {
             return Promise.resolve({
                 mode: options.mode,
                 effectiveTargetApplicationVersion,
-                outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Blocked,
-                reason: contracts_1.ZLinkFrameworkRelocationReason.ManualTopologyUnsupported
+                outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Blocked,
+                reason: contracts_2.ZLinkFrameworkRelocationReason.ManualTopologyUnsupported
             });
         }
         this.runtimeDeadline = new Date(Date.now() + deadlineMs);
@@ -696,7 +733,7 @@ class ZLinkFrameworkRuntimeHost {
     }
     async runRelocation(mode, effectiveTargetApplicationVersion, deadlineMs, stopStartingSignal) {
         if (!this.isStarted) {
-            return this.completeRelocation(blockedRelocation(mode, effectiveTargetApplicationVersion, contracts_1.ZLinkFrameworkRelocationReason.RuntimeNotReady));
+            return this.completeRelocation(blockedRelocation(mode, effectiveTargetApplicationVersion, contracts_2.ZLinkFrameworkRelocationReason.RuntimeNotReady));
         }
         const deadlineAtMs = performance.now() + deadlineMs;
         const remainingDeadlineMs = () => Math.max(1, deadlineAtMs - performance.now());
@@ -713,39 +750,39 @@ class ZLinkFrameworkRuntimeHost {
             const descriptorPreparation = await this.routeMeshCoordinator.prepareHostRetire(remainingDeadlineMs());
             if (descriptorPreparation !== 'prepared') {
                 return this.resetBlockedRelocation(blockedRelocation(mode, effectiveTargetApplicationVersion, descriptorPreparation === 'deadline_exceeded'
-                    ? contracts_1.ZLinkFrameworkRelocationReason.DeadlineExceeded
-                    : contracts_1.ZLinkFrameworkRelocationReason.StoreUnavailable));
+                    ? contracts_2.ZLinkFrameworkRelocationReason.DeadlineExceeded
+                    : contracts_2.ZLinkFrameworkRelocationReason.StoreUnavailable));
             }
-            this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Relocating);
+            this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Relocating);
             const drained = await this.routeMeshCoordinator.relocateHost(remainingDeadlineMs(), stopStartingSignal);
             if (drained.kind === 'forceStopped') {
                 // Settled authority on both sides or an expired source owner lease
                 // ends the host in Error (spec 30 §13).
                 if (drained.error instanceof service_relocation_coordinator_1.ServiceRelocationAuthorityError) {
-                    return this.completeRelocation(blockedRelocation(mode, effectiveTargetApplicationVersion, contracts_1.ZLinkFrameworkRelocationReason.RelocationFailed));
+                    return this.completeRelocation(blockedRelocation(mode, effectiveTargetApplicationVersion, contracts_2.ZLinkFrameworkRelocationReason.RelocationFailed));
                 }
                 return this.resetBlockedRelocation(blockedRelocation(mode, effectiveTargetApplicationVersion, stopStartingSignal.aborted
-                    ? contracts_1.ZLinkFrameworkRelocationReason.ShutdownRequested
+                    ? contracts_2.ZLinkFrameworkRelocationReason.ShutdownRequested
                     : drained.error instanceof service_relocation_host_runtime_1.ZLinkRelocationStateIncompatibleError
-                        ? contracts_1.ZLinkFrameworkRelocationReason.StateIncompatible
+                        ? contracts_2.ZLinkFrameworkRelocationReason.StateIncompatible
                         : relocationReason(drained.reason)));
             }
             await this.publishHostRelocated();
             return this.completeRelocation({
                 mode,
                 effectiveTargetApplicationVersion,
-                outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Relocated,
-                reason: contracts_1.ZLinkFrameworkRelocationReason.None
+                outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Relocated,
+                reason: contracts_2.ZLinkFrameworkRelocationReason.None
             });
         }
         catch (error) {
             const result = blockedRelocation(mode, effectiveTargetApplicationVersion, stopStartingSignal.aborted
-                ? contracts_1.ZLinkFrameworkRelocationReason.ShutdownRequested
+                ? contracts_2.ZLinkFrameworkRelocationReason.ShutdownRequested
                 : (0, abort_1.isDeadlineExceededError)(error)
-                    ? contracts_1.ZLinkFrameworkRelocationReason.DeadlineExceeded
+                    ? contracts_2.ZLinkFrameworkRelocationReason.DeadlineExceeded
                     : error instanceof service_relocation_host_runtime_1.ZLinkRelocationStateIncompatibleError
-                        ? contracts_1.ZLinkFrameworkRelocationReason.StateIncompatible
-                        : contracts_1.ZLinkFrameworkRelocationReason.RelocationFailed);
+                        ? contracts_2.ZLinkFrameworkRelocationReason.StateIncompatible
+                        : contracts_2.ZLinkFrameworkRelocationReason.RelocationFailed);
             return error instanceof route_mesh_runtime_1.ZLinkRetiringRollbackError
                 ? this.completeRelocation(result)
                 : this.resetBlockedRelocation(result);
@@ -756,10 +793,10 @@ class ZLinkFrameworkRuntimeHost {
             const deadlineAtMs = performance.now() + deadlineMs;
             try {
                 this.admission.close();
-                if (this.runtimeState === contracts_1.ZLinkFrameworkRuntimeState.Preparing) {
+                if (this.runtimeState === contracts_2.ZLinkFrameworkRuntimeState.Preparing) {
                     this.executionState?.abortController.abort();
                 }
-                this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Draining);
+                this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Draining);
                 if (this.relocationOperation !== undefined &&
                     this.relocationStopStarting?.signal.aborted === true) {
                     await this.relocationOperation;
@@ -777,27 +814,27 @@ class ZLinkFrameworkRuntimeHost {
                 await this.stop();
                 if (drain.kind === 'forceStopped') {
                     return this.completeTermination({
-                        outcome: contracts_1.ZLinkFrameworkTerminationOutcome.ForceStopped,
+                        outcome: contracts_2.ZLinkFrameworkTerminationOutcome.ForceStopped,
                         reason: drain.reason === 'deadline_exceeded'
-                            ? contracts_1.ZLinkFrameworkTerminationReason.DeadlineExceeded
-                            : contracts_1.ZLinkFrameworkTerminationReason.TeardownFailed
+                            ? contracts_2.ZLinkFrameworkTerminationReason.DeadlineExceeded
+                            : contracts_2.ZLinkFrameworkTerminationReason.TeardownFailed
                     });
                 }
                 if (performance.now() >= deadlineAtMs) {
                     throw (0, abort_1.createDeadlineExceededError)('Shutdown resource cleanup exceeded its deadline.');
                 }
                 return this.completeTermination({
-                    outcome: contracts_1.ZLinkFrameworkTerminationOutcome.Stopped,
-                    reason: contracts_1.ZLinkFrameworkTerminationReason.None
+                    outcome: contracts_2.ZLinkFrameworkTerminationOutcome.Stopped,
+                    reason: contracts_2.ZLinkFrameworkTerminationReason.None
                 });
             }
             catch (error) {
                 await this.stop().catch(() => undefined);
                 return this.completeTermination({
-                    outcome: contracts_1.ZLinkFrameworkTerminationOutcome.ForceStopped,
+                    outcome: contracts_2.ZLinkFrameworkTerminationOutcome.ForceStopped,
                     reason: (0, abort_1.isDeadlineExceededError)(error)
-                        ? contracts_1.ZLinkFrameworkTerminationReason.DeadlineExceeded
-                        : contracts_1.ZLinkFrameworkTerminationReason.TeardownFailed
+                        ? contracts_2.ZLinkFrameworkTerminationReason.DeadlineExceeded
+                        : contracts_2.ZLinkFrameworkTerminationReason.TeardownFailed
                 });
             }
         });
@@ -822,8 +859,8 @@ class ZLinkFrameworkRuntimeHost {
     }
     resetBlockedRelocation(result) {
         this.recordRelocationResult(result);
-        if (this.runtimeState === contracts_1.ZLinkFrameworkRuntimeState.Relocating) {
-            this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Serving);
+        if (this.runtimeState === contracts_2.ZLinkFrameworkRuntimeState.Relocating) {
+            this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Serving);
         }
         this.runtimeDeadline = undefined;
         this.relocationTargetApplicationVersion = undefined;
@@ -837,9 +874,9 @@ class ZLinkFrameworkRuntimeHost {
         this.runtimeRelocationResult = result;
         this.runtimeDeadline = undefined;
         this.recordRelocationResult(result);
-        this.setRuntimeState(result.outcome === contracts_1.ZLinkFrameworkRelocationOutcome.Relocated
-            ? contracts_1.ZLinkFrameworkRuntimeState.Relocated
-            : contracts_1.ZLinkFrameworkRuntimeState.Error);
+        this.setRuntimeState(result.outcome === contracts_2.ZLinkFrameworkRelocationOutcome.Relocated
+            ? contracts_2.ZLinkFrameworkRuntimeState.Relocated
+            : contracts_2.ZLinkFrameworkRuntimeState.Error);
         return result;
     }
     recordRelocationResult(result) {
@@ -847,10 +884,10 @@ class ZLinkFrameworkRuntimeHost {
             this.metrics.duration(runtime_metrics_1.METRIC_NAMES.HostRelocationDuration, Math.max(0, performance.now() - this.relocationOperationStartedAt) /
                 runtime_metrics_1.MILLISECONDS_PER_SECOND, {
                 mode: relocationModeMetricName(result.mode),
-                outcome: result.outcome === contracts_1.ZLinkFrameworkRelocationOutcome.Relocated ? 'relocated' : 'blocked'
+                outcome: result.outcome === contracts_2.ZLinkFrameworkRelocationOutcome.Relocated ? 'relocated' : 'blocked'
             });
         }
-        if (result.outcome === contracts_1.ZLinkFrameworkRelocationOutcome.Blocked) {
+        if (result.outcome === contracts_2.ZLinkFrameworkRelocationOutcome.Blocked) {
             this.metrics.count(runtime_metrics_1.METRIC_NAMES.HostRelocationBlocked, 1, {
                 mode: relocationModeMetricName(result.mode),
                 reason: relocationReasonMetricName(result.reason)
@@ -871,12 +908,12 @@ class ZLinkFrameworkRuntimeHost {
         this.runtimeDeadline = undefined;
         if (this.shutdownOperationStartedAt !== undefined) {
             this.metrics.duration(runtime_metrics_1.METRIC_NAMES.HostShutdownDuration, Math.max(0, performance.now() - this.shutdownOperationStartedAt) / runtime_metrics_1.MILLISECONDS_PER_SECOND, {
-                outcome: result.outcome === contracts_1.ZLinkFrameworkTerminationOutcome.Stopped
+                outcome: result.outcome === contracts_2.ZLinkFrameworkTerminationOutcome.Stopped
                     ? 'stopped'
                     : 'force_stopped'
             });
         }
-        if (result.outcome === contracts_1.ZLinkFrameworkTerminationOutcome.ForceStopped) {
+        if (result.outcome === contracts_2.ZLinkFrameworkTerminationOutcome.ForceStopped) {
             this.metrics.count(runtime_metrics_1.METRIC_NAMES.HostShutdownForced, 1, {
                 reason: terminationReasonMetricName(result.reason)
             });
@@ -888,7 +925,7 @@ class ZLinkFrameworkRuntimeHost {
             outcome: result.outcome,
             reason: result.reason
         });
-        this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Stopped);
+        this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Stopped);
         return result;
     }
     setRuntimeState(state) {
@@ -1004,7 +1041,13 @@ class ZLinkFrameworkRuntimeHost {
         if (this.executionState !== undefined) {
             return;
         }
-        this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Preparing);
+        const previousLease = this.telemetryLease;
+        this.telemetryLease = (0, message_flow_delivery_1.renewTelemetryLease)(previousLease);
+        if (this.telemetryLease !== previousLease) {
+            this.dispatchErrorReporters = new WeakMap();
+            this.cachedDiagnosticsContext = undefined;
+        }
+        this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Preparing);
         this.lifecycleSink?.push('framework:start');
         const listenerRecords = new listener_records_1.ZLinkListenerRecords();
         this.listenerRecords = listenerRecords;
@@ -1024,10 +1067,11 @@ class ZLinkFrameworkRuntimeHost {
             this.messageFlowModeCell.mode =
                 this.options.registration.dispatch?.diagnostics.messageFlow ?? 'errors';
             const dispatchErrors = this.createDispatchErrorReporter(this.executionState.errorSink);
-            channelRuntime = new channels_1.ZLinkChannelRuntimeManager(this.options.registration, channelAdapter, context, this.options.providerResolver, { ...this.createChannelRuntimeOptions(), listenerRecords });
+            channelRuntime = new channels_1.ZLinkChannelRuntimeManager(this.options.registration, channelAdapter, context, this.options.providerResolver, { ...this.createChannelRuntimeOptions(), listenerRecords, requests: this.requests });
             this.channelRuntime = channelRuntime;
             channelRuntime.prepareMeshDispatch(this.executionState.taskRunner);
             spotNodeRuntime = new spots_1.ZLinkSpotNodeRuntimeManager({
+                requests: this.requests,
                 ...this.createSpotNodeRuntimeOptions(context, dispatchErrors),
                 listenerRecords
             });
@@ -1045,7 +1089,7 @@ class ZLinkFrameworkRuntimeHost {
                 await this.publishOrStayPreparing(locationRuntime, async (publishSignal) => {
                     await spotNodeRuntime.startLocationAutoConnect(publishSignal);
                     await channelRuntime.startLocationAutoConnect(publishSignal);
-                    await spotNodeRuntime.publishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Preparing, publishSignal);
+                    await spotNodeRuntime.publishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Preparing, publishSignal);
                 });
             }
             streamRuntime = new streams_1.ZLinkStreamRuntimeManager({
@@ -1108,6 +1152,8 @@ class ZLinkFrameworkRuntimeHost {
         }
     }
     async stop() {
+        (0, message_flow_delivery_1.retireTelemetryLease)(this.telemetryLease);
+        this.requests.close(new contracts_1.ZLinkFrameworkException(contracts_1.ZLinkFrameworkErrorKind.ShuttingDown, 'Host stopped.'));
         await this.runWithShutdownDeadline(DEFAULT_HOST_CONTROL_TIMEOUT_MS, async () => this.runLifecycle(() => this.stopCore()));
     }
     runtimeMetricMeshSnapshots() {
@@ -1133,7 +1179,7 @@ class ZLinkFrameworkRuntimeHost {
                 meshName,
                 source,
                 configuredPeers: status.peers.length,
-                connectedPeers: status.peers.filter((peer) => peer.state !== contracts_1.ZLinkPeerState.NotConnected)
+                connectedPeers: status.peers.filter((peer) => peer.state !== contracts_2.ZLinkPeerState.NotConnected)
                     .length,
                 readyPeers: status.readyPeerCount,
                 channels: status.channels.map((channel) => ({
@@ -1190,7 +1236,7 @@ class ZLinkFrameworkRuntimeHost {
         this.listenerRecords.clear();
         this.lifecycleSink?.push('framework:stopped');
         if (this.shutdownOperation === undefined) {
-            this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Stopped);
+            this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Stopped);
         }
     }
     installOwnerLeaseRecoveryPublication(runtime, spotNodeRuntime, channelRuntime) {
@@ -1198,7 +1244,7 @@ class ZLinkFrameworkRuntimeHost {
         const handler = (_renewal, wasOwnerLeaseUsable) => {
             if (!this.ownerAdmissionOpen())
                 return;
-            if (wasOwnerLeaseUsable && this.runtimeState !== contracts_1.ZLinkFrameworkRuntimeState.Preparing)
+            if (wasOwnerLeaseUsable && this.runtimeState !== contracts_2.ZLinkFrameworkRuntimeState.Preparing)
                 return;
             if (recoveryOperation !== undefined)
                 return;
@@ -1219,17 +1265,17 @@ class ZLinkFrameworkRuntimeHost {
         if (!this.ownerAdmissionOpen())
             return;
         await this.publishOrStayPreparing(runtime, async (signal) => {
-            await spotNodeRuntime.publishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Preparing, signal);
+            await spotNodeRuntime.publishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Preparing, signal);
             if (runtime.ownerLeaseUsable === false)
                 return;
-            if (this.runtimeState !== contracts_1.ZLinkFrameworkRuntimeState.Preparing) {
+            if (this.runtimeState !== contracts_2.ZLinkFrameworkRuntimeState.Preparing) {
                 await spotNodeRuntime.publishMeshNodeState(this.runtimeState, signal);
             }
             await spotNodeRuntime.startLocationAutoConnect(signal);
             await channelRuntime.startLocationAutoConnect(signal);
             await channelRuntime.reclaimLocationOwnerRows(signal);
             await this.locationOwner.currentLifecycle?.reclaimOwnerRows();
-            if (this.runtimeState === contracts_1.ZLinkFrameworkRuntimeState.Preparing) {
+            if (this.runtimeState === contracts_2.ZLinkFrameworkRuntimeState.Preparing) {
                 await this.enterServing(spotNodeRuntime, signal);
             }
         });
@@ -1241,9 +1287,9 @@ class ZLinkFrameworkRuntimeHost {
         if (store !== undefined) {
             await this.startStatefulAuthority(store, spotNodeRuntime, signal);
         }
-        await spotNodeRuntime.publishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Serving, signal);
+        await spotNodeRuntime.publishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Serving, signal);
         this.routeMeshCoordinator.markServing();
-        this.setRuntimeState(contracts_1.ZLinkFrameworkRuntimeState.Serving);
+        this.setRuntimeState(contracts_2.ZLinkFrameworkRuntimeState.Serving);
     }
     // Location runtime §5: a startup publication the Store does not confirm (a
     // provider error, or no answer within the renew timeout) leaves the host in
@@ -1366,10 +1412,10 @@ class ZLinkFrameworkRuntimeHost {
         await awaitWithDrainSignal(this.streamRuntime?.notifyServerDrain(meshName), signal);
     }
     async publishMeshRetiring(meshName, signal) {
-        await this.spotNodeRuntime?.publishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Relocating, signal, meshName);
+        await this.spotNodeRuntime?.publishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Relocating, signal, meshName);
     }
     async publishMeshServing(meshName, signal) {
-        await this.spotNodeRuntime?.reconcileAndPublishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Serving, meshName, signal);
+        await this.spotNodeRuntime?.reconcileAndPublishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Serving, meshName, signal);
         // A failed relocation rolls the local object barriers back before the
         // descriptor is published as Serving. Reconcile the durable authority
         // routes before returning so the next local request cannot observe the
@@ -1382,7 +1428,7 @@ class ZLinkFrameworkRuntimeHost {
         if (node !== undefined) {
             await node.publishDraining?.();
         }
-        await this.spotNodeRuntime?.publishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Draining, signal, meshName);
+        await this.spotNodeRuntime?.publishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Draining, signal, meshName);
     }
     async preflightAutomaticPeerReadiness(deadlineAt, targetApplicationVersion) {
         // A host with no local stateful workload has nothing to move. The public
@@ -1394,7 +1440,7 @@ class ZLinkFrameworkRuntimeHost {
             return undefined;
         const location = this.locationOwner.currentRuntime;
         if (location === undefined)
-            return contracts_1.ZLinkFrameworkRelocationReason.StoreUnavailable;
+            return contracts_2.ZLinkFrameworkRelocationReason.StoreUnavailable;
         let storeUnavailable = false;
         while (performance.now() < deadlineAt) {
             try {
@@ -1409,8 +1455,8 @@ class ZLinkFrameworkRuntimeHost {
                 Locations_1.zlinkDefaultLocationOptions.pollingIntervalMs, Math.max(1, deadlineAt - performance.now()))));
         }
         return storeUnavailable
-            ? contracts_1.ZLinkFrameworkRelocationReason.StoreUnavailable
-            : contracts_1.ZLinkFrameworkRelocationReason.TargetUnavailable;
+            ? contracts_2.ZLinkFrameworkRelocationReason.StoreUnavailable
+            : contracts_2.ZLinkFrameworkRelocationReason.TargetUnavailable;
     }
     hasLocalStatefulRelocationWork() {
         const spotManager = this.spotManager;
@@ -1447,7 +1493,7 @@ class ZLinkFrameworkRuntimeHost {
         return true;
     }
     async publishHostRelocated() {
-        await Promise.all([...this.options.registration.spotNodes.keys()].map((meshName) => this.spotNodeRuntime?.publishMeshNodeState(contracts_1.ZLinkFrameworkRuntimeState.Relocated, undefined, meshName)));
+        await Promise.all([...this.options.registration.spotNodes.keys()].map((meshName) => this.spotNodeRuntime?.publishMeshNodeState(contracts_2.ZLinkFrameworkRuntimeState.Relocated, undefined, meshName)));
     }
     async publishHostDraining(signal) {
         try {
@@ -1613,7 +1659,7 @@ class ZLinkFrameworkRuntimeHost {
                 const descriptors = await (0, location_store_pages_1.listAllMeshNodeDescriptors)(locationStore, meshName, signal);
                 const selected = await selectReadyLocationPlacementDescriptor(descriptors, meshNode, signal, (descriptor) => {
                     const capability = descriptor.objectCapabilities.find((candidate) => candidate.objectKind === 'actor' && candidate.stableType === stableType);
-                    return (descriptor.state === contracts_1.ZLinkFrameworkRuntimeState.Serving &&
+                    return (descriptor.state === contracts_2.ZLinkFrameworkRuntimeState.Serving &&
                         descriptor.objectRole === 'server' &&
                         descriptor.placementWeight > 0 &&
                         descriptor.entrySpotId !== undefined &&
@@ -1642,10 +1688,33 @@ class ZLinkFrameworkRuntimeHost {
                 };
             }
         });
+        const selectUserSpotMesh = (requestedMeshName) => {
+            const clientMeshes = [...this.options.registration.spotNodes]
+                .filter(([, node]) => (0, spot_address_transport_1.hasObjectClientCapability)(node.objectRole))
+                .map(([meshName]) => meshName);
+            const meshes = requestedMeshName === undefined ? clientMeshes : [requestedMeshName];
+            if (meshes.length === 0) {
+                throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured, 'No object-client RouteMesh is configured.');
+            }
+            if (requestedMeshName === undefined && meshes.length > 1) {
+                throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.MeshSelectionRequired, 'Multiple object-client RouteMeshes are configured; call inMesh(...).');
+            }
+            const meshName = meshes[0];
+            if (!this.options.registration.spotNodes.has(meshName)) {
+                throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.MeshNotFound, `RouteMesh '${meshName}' is not configured.`);
+            }
+            if (!clientMeshes.includes(meshName)) {
+                throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured, `RouteMesh '${meshName}' has no object-client role.`);
+            }
+            return meshName;
+        };
         const coordinator = (this.userSpotCoordinator = new user_spot_creation_coordinator_1.ZLinkUserSpotCreationCoordinator({
             store: locationStore,
-            relocationPolicy: (meshName, stableType) => this.options.registration.spotNodes.get(meshName)?.spotFactoryRegistrations?.[stableType]
-                ?.relocation.kind,
+            leaseTracker: this.locationOwner.currentLeaseTracker,
+            relocationPolicy: (meshName, stableType) => {
+                const node = this.options.registration.spotNodes.get(selectUserSpotMesh(meshName));
+                return node?.spotFactoryRegistrations?.[stableType]?.relocation.kind;
+            },
             publishReadyRoute: (meshName, route) => {
                 this.cachedLocationSpotRouteResolver?.invalidate?.(route.spot.spotId);
                 this.spotNodeRuntime?.meshNode(meshName)?.rememberSpotRoute?.(route);
@@ -1673,23 +1742,7 @@ class ZLinkFrameworkRuntimeHost {
                 }
             },
             target: async (request, signal, excludedNodeRids) => {
-                const clientMeshes = [...this.options.registration.spotNodes]
-                    .filter(([, node]) => (0, spot_address_transport_1.hasObjectClientCapability)(node.objectRole))
-                    .map(([meshName]) => meshName);
-                const meshes = request.meshName === undefined ? clientMeshes : [request.meshName];
-                if (meshes.length === 0) {
-                    throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured, 'No object-client RouteMesh is configured.');
-                }
-                if (request.meshName === undefined && meshes.length > 1) {
-                    throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.MeshSelectionRequired, 'Multiple object-client RouteMeshes are configured; call inMesh(...).');
-                }
-                const meshName = meshes[0];
-                if (!this.options.registration.spotNodes.has(meshName)) {
-                    throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.MeshNotFound, `RouteMesh '${meshName}' is not configured.`);
-                }
-                if (!clientMeshes.includes(meshName)) {
-                    throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured, `RouteMesh '${meshName}' has no object-client role.`);
-                }
+                const meshName = selectUserSpotMesh(request.meshName);
                 const meshNode = this.spotNodeRuntime?.meshNode(meshName);
                 const descriptors = await (0, location_store_pages_1.listAllMeshNodeDescriptors)(locationStore, meshName, signal);
                 const selected = await selectReadyLocationPlacementDescriptor(descriptors, meshNode, signal, (descriptor) => {
@@ -1764,7 +1817,7 @@ class ZLinkFrameworkRuntimeHost {
                         }, signal);
                         const reply = coordinated.result.reply;
                         let payload;
-                        if (reply !== undefined && coordinated.result.state !== contracts_1.ZLinkSpotCreateState.Existing) {
+                        if (reply !== undefined && coordinated.result.state !== contracts_2.ZLinkSpotCreateState.Existing) {
                             const message = (0, payload_codec_1.encodeFrameworkPayloadMessage)(reply, this.options.registration.messageSerializers);
                             try {
                                 payload = {
@@ -1782,9 +1835,9 @@ class ZLinkFrameworkRuntimeHost {
                             failureCode: 0,
                             tail: {
                                 kind: 'userSpotCreate',
-                                createResult: coordinated.result.state === contracts_1.ZLinkSpotCreateState.Existing
+                                createResult: coordinated.result.state === contracts_2.ZLinkSpotCreateState.Existing
                                     ? 'existing'
-                                    : coordinated.result.state === contracts_1.ZLinkSpotCreateState.Created
+                                    : coordinated.result.state === contracts_2.ZLinkSpotCreateState.Created
                                         ? 'created'
                                         : 'rejected',
                                 spotId: String(coordinated.spot.spotId),
@@ -1870,7 +1923,7 @@ class ZLinkFrameworkRuntimeHost {
                             failureCode: 0,
                             tail: {
                                 kind: 'userSpotClose',
-                                closed: await coordinator.handleRemoteClose(record, (spot, beginAuthority, closeSignal) => local.closeUserWithAuthority(spot.meshName, spot.spotId, beginAuthority, closeSignal), signal, (spot) => local.isSpotClosing(spot.meshName, spot.spotId))
+                                closed: await coordinator.handleRemoteClose(record, (spot, beginAuthority, closeSignal) => local.closeUserWithAuthority(spot.meshName, spot.spotId, beginAuthority, closeSignal, new Date(Number(record.deadlineUnixMs))), signal, (spot) => local.isSpotClosing(spot.meshName, spot.spotId))
                             }
                         };
                     }
@@ -1906,6 +1959,7 @@ class ZLinkFrameworkRuntimeHost {
     }
     actorRuntimeOptionsFactory() {
         return new actor_runtime_options_factory_1.ZLinkActorRuntimeOptionsFactory({
+            requests: this.requests,
             terminateActorActivation: (actor, terminal) => this.spotNodeRuntime?.terminateActorActivation(actor, terminal) ?? terminal(),
             registration: this.options.registration,
             messageFlow: () => this.createDispatchErrorReporter(this.runtimeOrPreStartErrorSink).flow,
@@ -1944,7 +1998,7 @@ class ZLinkFrameworkRuntimeHost {
                 if (entrySpotId === undefined) {
                     throw new ConfigurationException_1.ZLinkConfigurationException(`Actor '${actorRef.actorId}' authority requires its RouteMesh Entry Spot.`);
                 }
-                await (0, actors_1.publishInitialActorAuthority)(store, {
+                const authority = await (0, actors_1.publishInitialActorAuthority)(store, {
                     actorType,
                     actor: actorRef,
                     meshName,
@@ -1952,9 +2006,9 @@ class ZLinkFrameworkRuntimeHost {
                     owner,
                     spotId: entrySpotId,
                     spotGeneration: ownerNodeGeneration,
-                    spotKind: contracts_1.ZLinkSpotKind.Entry
+                    spotKind: contracts_2.ZLinkSpotKind.Entry
                 }, signal);
-                this.actorClientLocationResolver?.invalidateActorRoute(actorRef.actorId);
+                this.actorClientLocationResolver?.observeActorAuthorityVersion(actorRef.actorId, authority.storeVersion.value);
             },
             reportPostCommitError: (error) => this.runtimeOrPreStartErrorSink.reportRuntimeTaskException('post-commit actor binding', error),
             reportBoundSessionSendError: (error) => this.runtimeOrPreStartErrorSink.reportRuntimeTaskException('bound session one-way submit', error),
@@ -1983,6 +2037,7 @@ class ZLinkFrameworkRuntimeHost {
         return new channel_runtime_options_factory_1.ZLinkChannelRuntimeOptionsFactory({
             monitoringAdapter: this.backendAdapterFactory.createMonitoringAdapter(),
             messageFlowModeCell: this.messageFlowModeCell,
+            telemetryLease: this.telemetryLease,
             boundSessionRelay: this.boundSessionRelay,
             applicationJobQueue: this.applicationJobQueue,
             spotManager: () => this.spotManager,
@@ -2012,6 +2067,7 @@ class ZLinkFrameworkRuntimeHost {
         }).create();
         return {
             ...options,
+            admission: this.admission,
             errorSink: this.runtimeOrPreStartErrorSink,
             peerAdmissionSealed: (meshName) => !this.admission.accepts(meshName),
             messageFollowReceiver: (record) => {
@@ -2090,21 +2146,21 @@ class ZLinkFrameworkRuntimeHost {
                 if (channelRuntime === undefined) {
                     throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode channel dispatch requires the channel runtime.');
                 }
-                return channelRuntime.dispatchMeshChannel(meshName, record, signal, (dispatch, onRejected) => this.admitMeshDispatch(meshName, record, 'RouteMesh channel dispatch', dispatch, onRejected));
+                return channelRuntime.dispatchMeshChannel(meshName, record, signal, (dispatch, onRejected, receiver, context) => this.admitMeshDispatch(meshName, record, 'RouteMesh channel dispatch', dispatch, onRejected, receiver, context));
             }
             case service_runtime_contracts_1.ReceiveKind.NodeSend:
             case service_runtime_contracts_1.ReceiveKind.NodeRequest: {
-                return this.dispatchMeshNodeRecord(meshName, record, signal, (dispatch, onRejected) => this.admitMeshDispatch(meshName, record, 'RouteMesh node dispatch', dispatch, onRejected));
+                return this.dispatchMeshNodeRecord(meshName, record, signal, (dispatch, onRejected, receiver, context) => this.admitMeshDispatch(meshName, record, 'RouteMesh node dispatch', dispatch, onRejected, receiver, context));
             }
             case service_runtime_contracts_1.ReceiveKind.SpotSend:
             case service_runtime_contracts_1.ReceiveKind.SpotRequest:
             case service_runtime_contracts_1.ReceiveKind.SpotMulticast:
-                return this.dispatchMeshSpotRecord(meshName, owner, record, (dispatch, onRejected) => this.admitMeshDispatch(meshName, record, 'RouteMesh Spot dispatch', dispatch, onRejected));
+                return this.dispatchMeshSpotRecord(meshName, owner, record, (dispatch, onRejected, receiver, context) => this.admitMeshDispatch(meshName, record, 'RouteMesh Spot dispatch', dispatch, onRejected, receiver, context));
             case service_runtime_contracts_1.ReceiveKind.InstanceSpotActivation:
                 if (this.spotManager === undefined) {
                     throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode Instance Spot dispatch requires the Spot manager.');
                 }
-                return this.spotManager.dispatchMeshInstance(meshName, owner, record, (dispatch, onRejected) => this.admitMeshDispatch(meshName, record, 'RouteMesh Instance Spot dispatch', dispatch, onRejected));
+                return this.spotManager.dispatchMeshInstance(meshName, owner, record, (dispatch, onRejected, receiver, context) => this.admitMeshDispatch(meshName, record, 'RouteMesh Instance Spot dispatch', dispatch, onRejected, receiver, context));
             case service_runtime_contracts_1.ReceiveKind.SpotControl:
                 if (this.spotManager === undefined) {
                     throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode Spot control dispatch requires the Spot manager.');
@@ -2115,19 +2171,19 @@ class ZLinkFrameworkRuntimeHost {
                 if (this.spotManager === undefined) {
                     throw new ConfigurationException_1.ZLinkConfigurationException('MeshNode Actor dispatch requires the Spot manager.');
                 }
-                return this.spotManager.dispatchMeshActor(applicationJobOrigin(), meshName, owner, record, (dispatch, onRejected) => this.admitMeshDispatch(meshName, record, 'RouteMesh Actor dispatch', dispatch, onRejected));
+                return this.spotManager.dispatchMeshActor(applicationJobOrigin(), meshName, owner, record, (dispatch, onRejected, receiver, context) => this.admitMeshDispatch(meshName, record, 'RouteMesh Actor dispatch', dispatch, onRejected, receiver, context));
             case service_runtime_contracts_1.ReceiveKind.SendReady:
                 return Promise.resolve();
             default:
                 throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode record kind '${record.kind}' does not yet have a registered framework consumer.`);
         }
     }
-    admitMeshDispatch(meshName, record, operation, dispatch, onRejected) {
+    admitMeshDispatch(meshName, record, operation, dispatch, onRejected, receiver, context) {
         // Execution gate §13 and host relocation §14 keep control progress independent
         // of new application admission. Disconnect callbacks still use their owner gate.
         if (record.domain === service_runtime_contracts_1.ReadyDomain.Infrastructure)
-            return dispatch();
-        if (!this.admission.accepts(meshName) &&
+            return dispatch.call(receiver, context);
+        if (!this.admission.accepts(meshName, record.kind) &&
             (record.kind === service_runtime_contracts_1.ReceiveKind.NodeSend ||
                 record.kind === service_runtime_contracts_1.ReceiveKind.NodeRequest ||
                 record.kind === service_runtime_contracts_1.ReceiveKind.SpotSend ||
@@ -2136,10 +2192,10 @@ class ZLinkFrameworkRuntimeHost {
             if (relay !== undefined &&
                 (0, protocol_1.decodeStreamHeader)(Buffer.from(relay.header, 'base64'), this.flowCreationEnabled()).name ===
                     actor_packet_relay_wire_1.ZLINK_REMOTE_ACTOR_SESSION_DISCONNECTED_PACKET) {
-                return dispatch();
+                return dispatch.call(receiver, context);
             }
         }
-        return this.admission.run(meshName, operation, dispatch, onRejected);
+        return this.admission.run(meshName, operation, dispatch, record.kind, onRejected, receiver, context);
     }
     async dispatchMeshActorBinding(meshName, record, signal) {
         if (record.kindData?.kind !== 'actorBinding') {
@@ -2204,8 +2260,7 @@ class ZLinkFrameworkRuntimeHost {
             replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
             return;
         }
-        replyBindingSuccess();
-        state.installBoundSessionBinding({
+        const incomingTarget = {
             ...target,
             sessionNodeRid: binding.sessionNodeRid,
             sessionRid: binding.sessionRid,
@@ -2213,19 +2268,92 @@ class ZLinkFrameworkRuntimeHost {
             sessionOwnerId: binding.sessionOwnerId,
             sessionOwnerLeaseGeneration: binding.sessionOwnerLeaseGeneration,
             bindingGeneration: binding.bindingGeneration
+        };
+        const currentBinding = state.boundSession;
+        const currentActor = state.actor;
+        if (currentBinding === undefined ||
+            currentActor?.onDuplicateBind === undefined ||
+            samePhysicalSession(currentBinding, incomingTarget)) {
+            state.installBoundSessionBinding(incomingTarget);
+            replyBindingSuccess();
+            return;
+        }
+        const spotManager = this.spotManager;
+        if (spotManager === undefined || state.meshName === undefined) {
+            replyBindingFailure(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.ActorLocationStale);
+            return;
+        }
+        let callbackStarted;
+        const started = new Promise((resolve) => {
+            callbackStarted = resolve;
         });
-        return Promise.resolve();
+        let callbackTimedOut = false;
+        let timeoutHandle;
+        const cancellation = new AbortController();
+        const callbackSignal = signal === undefined ? cancellation.signal : AbortSignal.any([signal, cancellation.signal]);
+        const turn = spotManager.executeActorTurn(state.meshName, state.actor?.context.spotId, state.actorId, async () => {
+            const current = state.boundSession;
+            const actor = state.actor;
+            const duplicateCallback = current !== undefined && !samePhysicalSession(current, incomingTarget)
+                ? actor?.onDuplicateBind
+                : undefined;
+            if (duplicateCallback === undefined || actor === undefined || current === undefined) {
+                state.installBoundSessionBinding(incomingTarget);
+                replyBindingSuccess();
+                return;
+            }
+            callbackStarted();
+            const decision = await duplicateCallback.call(actor, sessionBindingIdentity(current), sessionBindingIdentity(incomingTarget), callbackSignal);
+            if (callbackTimedOut)
+                return;
+            if (decision !== undefined && decision.length > 0) {
+                if (Buffer.byteLength(decision, 'utf8') > 0xffff) {
+                    throw new RangeError('Duplicate bind rejection message exceeds Text16 capacity.');
+                }
+                if (record.replyFailure?.(runtime_values_1.RequestResult.Rejected, 0, {
+                    kind: 'streamBindRejected',
+                    rejectionMessage: decision
+                }) !== runtime_values_1.SubmitResult.Ok) {
+                    throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode Actor binding target '${binding.actor.actorId}' rejection acknowledgement failed.`);
+                }
+                return;
+            }
+            state.installBoundSessionBinding(incomingTarget);
+            replyBindingSuccess();
+        });
+        const timeout = started.then(() => new Promise((resolve) => {
+            timeoutHandle = setTimeout(() => {
+                callbackTimedOut = true;
+                resolve('timedOut');
+            }, this.options.registration.sessionReplacementCallbackTimeoutMs);
+        }));
+        try {
+            const outcome = await Promise.race([turn.then(() => 'completed'), timeout]);
+            if (outcome === 'timedOut') {
+                cancellation.abort((0, abort_1.createDeadlineExceededError)('Duplicate bind callback timed out.'));
+                if (record.replyFailure?.(runtime_values_1.RequestResult.TimedOut, 0) !== runtime_values_1.SubmitResult.Ok) {
+                    throw new ConfigurationException_1.ZLinkConfigurationException(`MeshNode Actor binding target '${binding.actor.actorId}' timeout acknowledgement failed.`);
+                }
+                void turn.catch((error) => this.runtimeOrPreStartErrorSink.reportRuntimeTaskException(`duplicate bind callback '${binding.actor.actorId}'`, error));
+            }
+        }
+        finally {
+            if (timeoutHandle !== undefined)
+                clearTimeout(timeoutHandle);
+        }
     }
     submitLocalMeshRoute(meshName, sourceNodeRid, parts) {
         const state = this.executionState;
         const channelRuntime = this.channelRuntime;
-        if (state === undefined || channelRuntime === undefined || !this.admission.accepts(meshName)) {
+        if (state === undefined ||
+            channelRuntime === undefined ||
+            !this.admission.accepts(meshName, service_runtime_contracts_1.ReceiveKind.NodeSend)) {
             return { status: submission_result_1.ZLinkSubmitStatus.Shutdown };
         }
         if (!channelRuntime.canDispatchLocalMeshRoute(meshName)) {
             return { status: submission_result_1.ZLinkSubmitStatus.TargetNotFound };
         }
-        const claim = this.admission.claim(meshName, 'RouteMesh local node dispatch');
+        const claim = this.admission.claim(meshName, 'RouteMesh local node dispatch', service_runtime_contracts_1.ReceiveKind.NodeSend);
         const ownedParts = [];
         try {
             for (const part of parts) {
@@ -2273,8 +2401,9 @@ class ZLinkFrameworkRuntimeHost {
                 packetName: envelope.packetName,
                 contentType: envelope.header.contentType,
                 sourceNodeRid: String(record.sourceNodeRid ?? ''),
-                metadata: (0, contracts_1.zlinkMessageMetadata)(envelope.header.metadata),
-                correlationId: envelope.header.correlationId ?? undefined
+                metadata: (0, contracts_2.zlinkMessageMetadata)(envelope.header.metadata),
+                correlationId: envelope.header.correlationId ?? undefined,
+                receivedAt: record.receivedAt ?? new Date()
             };
             try {
                 const dispatch = async () => {
@@ -2305,7 +2434,7 @@ class ZLinkFrameworkRuntimeHost {
         if (existing !== undefined) {
             return existing;
         }
-        const reporter = new channels_1.ZLinkDispatchErrorReporter(undefined, undefined, errorSink, this.diagnosticsContext(), this.metrics);
+        const reporter = new channels_1.ZLinkDispatchErrorReporter(this.diagnosticsContext(), this.metrics);
         this.dispatchErrorReporters.set(errorSink, reporter);
         return reporter;
     }
@@ -2322,7 +2451,7 @@ class ZLinkFrameworkRuntimeHost {
         };
     }
     diagnosticsContext() {
-        this.cachedDiagnosticsContext ??= (0, diagnostics_1.createDiagnosticsContext)(this.options.registration.dispatch, this.options.providerResolver, this.messageFlowModeCell);
+        this.cachedDiagnosticsContext ??= (0, diagnostics_1.createDiagnosticsContext)(this.options.registration.dispatch, this.options.providerResolver, this.messageFlowModeCell, this.telemetryLease);
         return this.cachedDiagnosticsContext;
     }
     flowCreationEnabled() {
@@ -2394,16 +2523,39 @@ function hasUnsupportedManualTopology(registration) {
     }
     return false;
 }
+function samePhysicalSession(left, right) {
+    return (left.sessionNodeRid !== undefined &&
+        left.sessionRid !== undefined &&
+        left.sessionOwnerNodeGeneration !== undefined &&
+        right.sessionNodeRid !== undefined &&
+        right.sessionRid !== undefined &&
+        right.sessionOwnerNodeGeneration !== undefined &&
+        (0, routing_id_1.routingIdsEqual)(left.sessionNodeRid, right.sessionNodeRid) &&
+        left.sessionRid === right.sessionRid &&
+        left.sessionOwnerNodeGeneration === right.sessionOwnerNodeGeneration);
+}
+function sessionBindingIdentity(value) {
+    if (value.sessionNodeRid === undefined ||
+        value.sessionOwnerNodeGeneration === undefined ||
+        value.bindingGeneration === undefined) {
+        throw new ConfigurationException_1.ZLinkConfigurationException('Duplicate bind callback requires a complete identity.');
+    }
+    return {
+        sessionOwnerNodeRid: value.sessionNodeRid,
+        sessionOwnerNodeGeneration: value.sessionOwnerNodeGeneration,
+        bindingGeneration: value.bindingGeneration
+    };
+}
 function hasConfiguredLocationStore(registration) {
     return (registration.locations.useInMemoryStores || registration.locations.storeInstance !== undefined);
 }
 function hasExactPeerReadiness(descriptors, local, peers) {
     const replacementDescriptors = descriptors.filter((descriptor) => !((0, routing_id_1.routingIdsEqual)(descriptor.rid, (0, routing_id_1.toBackendRoutingId)(local.routingId)) &&
         descriptor.lifecycleGeneration === local.lifecycleGeneration) &&
-        descriptor.state === contracts_1.ZLinkFrameworkRuntimeState.Serving &&
+        descriptor.state === contracts_2.ZLinkFrameworkRuntimeState.Serving &&
         local.applicationVersion !== undefined &&
         descriptor.applicationVersion === local.applicationVersion &&
-        descriptor.objectRole === contracts_1.ZLinkObjectRole.Server &&
+        descriptor.objectRole === contracts_2.ZLinkObjectRole.Server &&
         (local.maintenanceWave === undefined || descriptor.maintenanceWave !== local.maintenanceWave));
     return (replacementDescriptors.length > 0 &&
         replacementDescriptors.some((descriptor) => peers.some((peer) => peer.routingId !== null &&
@@ -2478,60 +2630,60 @@ function resolveStreamPayloadCodec(registration) {
 }
 function runtimeStateMetricName(state) {
     switch (state) {
-        case contracts_1.ZLinkFrameworkRuntimeState.Preparing:
+        case contracts_2.ZLinkFrameworkRuntimeState.Preparing:
             return 'preparing';
-        case contracts_1.ZLinkFrameworkRuntimeState.Serving:
+        case contracts_2.ZLinkFrameworkRuntimeState.Serving:
             return 'serving';
-        case contracts_1.ZLinkFrameworkRuntimeState.Relocating:
+        case contracts_2.ZLinkFrameworkRuntimeState.Relocating:
             return 'relocating';
-        case contracts_1.ZLinkFrameworkRuntimeState.Relocated:
+        case contracts_2.ZLinkFrameworkRuntimeState.Relocated:
             return 'relocated';
-        case contracts_1.ZLinkFrameworkRuntimeState.Draining:
+        case contracts_2.ZLinkFrameworkRuntimeState.Draining:
             return 'draining';
-        case contracts_1.ZLinkFrameworkRuntimeState.Stopped:
+        case contracts_2.ZLinkFrameworkRuntimeState.Stopped:
             return 'stopped';
-        case contracts_1.ZLinkFrameworkRuntimeState.Error:
+        case contracts_2.ZLinkFrameworkRuntimeState.Error:
             return 'error';
     }
 }
 function relocationModeMetricName(mode) {
-    return mode === contracts_1.ZLinkFrameworkRelocationMode.RollingUpdate
+    return mode === contracts_2.ZLinkFrameworkRelocationMode.RollingUpdate
         ? 'rolling_update'
         : 'planned_maintenance';
 }
 function relocationReasonMetricName(reason) {
     switch (reason) {
-        case contracts_1.ZLinkFrameworkRelocationReason.None:
+        case contracts_2.ZLinkFrameworkRelocationReason.None:
             return 'none';
-        case contracts_1.ZLinkFrameworkRelocationReason.TargetUnavailable:
+        case contracts_2.ZLinkFrameworkRelocationReason.TargetUnavailable:
             return 'target_unavailable';
-        case contracts_1.ZLinkFrameworkRelocationReason.StoreUnavailable:
+        case contracts_2.ZLinkFrameworkRelocationReason.StoreUnavailable:
             return 'store_unavailable';
-        case contracts_1.ZLinkFrameworkRelocationReason.RelocationDisabled:
+        case contracts_2.ZLinkFrameworkRelocationReason.RelocationDisabled:
             return 'relocation_disabled';
-        case contracts_1.ZLinkFrameworkRelocationReason.StateIncompatible:
+        case contracts_2.ZLinkFrameworkRelocationReason.StateIncompatible:
             return 'state_incompatible';
-        case contracts_1.ZLinkFrameworkRelocationReason.DeadlineExceeded:
+        case contracts_2.ZLinkFrameworkRelocationReason.DeadlineExceeded:
             return 'deadline_exceeded';
-        case contracts_1.ZLinkFrameworkRelocationReason.RelocationFailed:
+        case contracts_2.ZLinkFrameworkRelocationReason.RelocationFailed:
             return 'relocation_failed';
-        case contracts_1.ZLinkFrameworkRelocationReason.RuntimeNotReady:
+        case contracts_2.ZLinkFrameworkRelocationReason.RuntimeNotReady:
             return 'runtime_not_ready';
-        case contracts_1.ZLinkFrameworkRelocationReason.ManualTopologyUnsupported:
+        case contracts_2.ZLinkFrameworkRelocationReason.ManualTopologyUnsupported:
             return 'manual_topology_unsupported';
-        case contracts_1.ZLinkFrameworkRelocationReason.ShutdownRequested:
+        case contracts_2.ZLinkFrameworkRelocationReason.ShutdownRequested:
             return 'shutdown_requested';
-        case contracts_1.ZLinkFrameworkRelocationReason.OperationInProgress:
+        case contracts_2.ZLinkFrameworkRelocationReason.OperationInProgress:
             return 'operation_in_progress';
     }
 }
 function terminationReasonMetricName(reason) {
     switch (reason) {
-        case contracts_1.ZLinkFrameworkTerminationReason.None:
+        case contracts_2.ZLinkFrameworkTerminationReason.None:
             return 'none';
-        case contracts_1.ZLinkFrameworkTerminationReason.DeadlineExceeded:
+        case contracts_2.ZLinkFrameworkTerminationReason.DeadlineExceeded:
             return 'deadline_exceeded';
-        case contracts_1.ZLinkFrameworkTerminationReason.TeardownFailed:
+        case contracts_2.ZLinkFrameworkTerminationReason.TeardownFailed:
             return 'teardown_failed';
     }
 }
@@ -2614,13 +2766,13 @@ function randomBigIntBelow(exclusiveUpperBound) {
 function relocationReason(reason) {
     switch (reason) {
         case 'deadline_exceeded':
-            return contracts_1.ZLinkFrameworkRelocationReason.DeadlineExceeded;
+            return contracts_2.ZLinkFrameworkRelocationReason.DeadlineExceeded;
         case 'store_unavailable':
-            return contracts_1.ZLinkFrameworkRelocationReason.StoreUnavailable;
+            return contracts_2.ZLinkFrameworkRelocationReason.StoreUnavailable;
         case 'target_unavailable':
-            return contracts_1.ZLinkFrameworkRelocationReason.TargetUnavailable;
+            return contracts_2.ZLinkFrameworkRelocationReason.TargetUnavailable;
         default:
-            return contracts_1.ZLinkFrameworkRelocationReason.RelocationFailed;
+            return contracts_2.ZLinkFrameworkRelocationReason.RelocationFailed;
     }
 }
 function rewriteAuthorityPayloadForOwner(payload, owner) {
@@ -2635,11 +2787,11 @@ function validateRelocationOptions(options, sourceApplicationVersion) {
         throw new TypeError('Relocation mode is required.');
     }
     const mode = options.mode;
-    if (mode !== contracts_1.ZLinkFrameworkRelocationMode.PlannedMaintenance &&
-        mode !== contracts_1.ZLinkFrameworkRelocationMode.RollingUpdate) {
+    if (mode !== contracts_2.ZLinkFrameworkRelocationMode.PlannedMaintenance &&
+        mode !== contracts_2.ZLinkFrameworkRelocationMode.RollingUpdate) {
         throw new TypeError('Relocation mode is required.');
     }
-    if (options.mode === contracts_1.ZLinkFrameworkRelocationMode.PlannedMaintenance) {
+    if (options.mode === contracts_2.ZLinkFrameworkRelocationMode.PlannedMaintenance) {
         if (options.targetApplicationVersion !== undefined) {
             throw new TypeError('PlannedMaintenance relocation cannot define targetApplicationVersion.');
         }
@@ -2655,7 +2807,7 @@ function blockedRelocation(mode, effectiveTargetApplicationVersion, reason) {
     return {
         mode,
         effectiveTargetApplicationVersion,
-        outcome: contracts_1.ZLinkFrameworkRelocationOutcome.Blocked,
+        outcome: contracts_2.ZLinkFrameworkRelocationOutcome.Blocked,
         reason
     };
 }