@zlink-systems/framework 0.30.0 → 0.30.2

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

@@ -7,35 +7,39 @@ import type { ZLinkActorJoinRelocation } from '../actors/actor-join-relocation';
 import type { ZLinkBackendMeshNode, ZLinkMeshCompletionTable } from '../backend';
 import type { ZLinkFrameworkRegistration } from '../configuration';
 import { type ZLinkRuntimeEventPublisher, type ZLinkRuntimeMetrics } from '../diagnostics';
+import { type ZLinkMessageFlowTracer } from '../diagnostics/message-flow';
 import { type ServiceRelocationQueuedMessage } from '../foundation/service-relocation-runtime';
 import { type ReceiveRecord } from '../foundation/service-runtime-contracts';
 import { type ServiceSessionRelocationRoute, type ServiceSessionRelocationSeal, type ServiceSessionRelocationSealed } from '../foundation/service-stateful-wire-codec';
 import type { ZLinkDomainLocationStore as ZLinkLocationStore } from '../locations/domain-store-contract';
 import type { ZLinkLocationOwnerToken } from '../locations/internal-location-contracts';
 import type { ZLinkTrackedInstanceAuthority } from '../locations/spot-location-claims';
-import type { DefaultZLinkSpotManager, ZLinkSpotNodeRuntimeManager } from '../spots';
+import type { DefaultZLinkSpotManager } from '../spots';
 import { type ZLinkActorTransferRuntime } from './actor-transfer-runtime';
 export declare class ZLinkRelocationStateIncompatibleError extends Error {
     constructor(message: string);
 }
 interface ZLinkHostRelocationOptions {
+    readonly flowCreationEnabled?: () => boolean;
+    readonly messageFlow?: () => ZLinkMessageFlowTracer | undefined;
     readonly registration: ZLinkFrameworkRegistration;
     readonly providerResolver?: ZLinkProviderResolver;
     readonly locationStore: () => ZLinkLocationStore | undefined;
     readonly currentOwner: () => ZLinkLocationOwnerToken | undefined;
     readonly targetAdmissionSealed?: () => boolean;
+    readonly requestPeerReconcile?: (meshName: string, peerRid: string) => Promise<void>;
+    readonly sourceQuiescenceChanged?: () => void;
     readonly liveDescriptors: (meshName: string, signal?: AbortSignal) => Promise<readonly ZLinkMeshNodeDescriptor[]>;
     readonly localDescriptor?: (meshName: string) => ZLinkMeshNodeDescriptor | undefined;
     readonly meshNode: (meshName: string) => ZLinkBackendMeshNode | undefined;
     readonly completions: (meshName: string) => ZLinkMeshCompletionTable | undefined;
     readonly spotManager: () => DefaultZLinkSpotManager | undefined;
-    readonly spotNodeRuntime: () => ZLinkSpotNodeRuntimeManager | undefined;
     readonly actorManager: () => DefaultZLinkActorManager | undefined;
     readonly actorTransfer: ZLinkActorTransferRuntime;
     readonly boundSessionRelocation?: {
-        receiveSeal(value: ServiceSessionRelocationSeal, signal?: AbortSignal): Promise<ServiceSessionRelocationSealed>;
+        receiveSeal(value: ServiceSessionRelocationSeal, signal?: AbortSignal, onInstalled?: () => void): Promise<ServiceSessionRelocationSealed | undefined>;
         receiveRoute(value: ServiceSessionRelocationRoute): Promise<void>;
-        clear?(): void;
+        clear?(): void | Promise<void>;
     };
     readonly trackInstanceSpot?: (input: ZLinkTrackedInstanceAuthority) => void;
     readonly invalidateActorRoute?: (actorId: string) => void;
@@ -49,7 +53,6 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
     private readonly options;
     private readonly targetStages;
     private readonly terminalTargets;
-    private readonly relocationAuthorityKeys;
     private readonly targetPrepareOperations;
     private readonly pendingReplyRelays;
     private readonly pendingSessionRelocations;
@@ -87,6 +90,7 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
      * checksum integrity failure — it must not be reported as DataLost(35).
      */
     private disposed;
+    private readonly targetPreparationStop;
     constructor(options: ZLinkHostRelocationOptions);
     relocateActorJoin(input: Parameters<ZLinkActorJoinRelocation['relocateActorJoin']>[0]): ReturnType<ZLinkActorJoinRelocation['relocateActorJoin']>;
     dispose(): Promise<void>;
@@ -94,10 +98,16 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
     drainTargetAttempts(): Promise<void>;
     /** Spec 28 §4.4: the target owner alone orders shutdown seal and verified cutover. */
     private targetStageSealed;
+    /** The Shutdown admission seal: closed once the target owner starts shutdown. */
+    private targetAdmissionSealed;
     completeActorJoinSourceCleanup(actorId: string): void;
+    /** Drains the exact source scopes before their Spot lifecycle owners stop. */
+    drainActorJoinSources(meshName?: string): Promise<void>;
+    private retireActorJoinSource;
     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. */
@@ -131,6 +141,7 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
     private reserveRelocationId;
     private reserveExactRelocationId;
     private runCoordinator;
+    private completeSourceRelocationMetric;
     /** Streams the payload chunks of one stage under the effective in-flight budgets. */
     private sendRelocationStateChunks;
     /**
@@ -153,11 +164,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 +174,9 @@ 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 fails the same-object, advanced-generation fence.
+     * A committed later owner has no Follow snapshot (Location runtime §10). An uncertain
+     * Store or lease result keeps the work retained and repeats the same decision.
      */
     private settleSourceAuthority;
     private readSourceSettlement;
@@ -214,7 +222,7 @@ export declare class ZLinkHostServiceRelocationRuntime implements ZLinkActorJoin
     private acceptReplyRelayAck;
     private requireAdmittedPeer;
     private targetReplyRelayCoordinator;
-    private relayTerminalReplies;
+    private relayTerminalReply;
     private exactSourceLeaseExpired;
     private publishSessionRoutes;
     private sendControl;