@zlink-systems/framework 0.30.1 → 0.30.2

package/dist/runtime/host/actor-transfer-runtime.d.ts

@@ -1,6 +1,6 @@
-import { type ActorRef, type RoutingId, type ZLinkActor, type ZLinkActorJoinOperationId, type ZLinkMessageSerializer, type ZLinkSpot, ZLinkMessage } from '../../contracts';
+import { type ActorRef, type RoutingId, type ZLinkActor, type ZLinkMeshNodeDescriptor, type ZLinkActorJoinOperationId, type ZLinkMessageSerializer, type ZLinkSpot, ZLinkMessage } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
-import { type ZLinkActorHandoffCoordinator, type ZLinkActorHandoffReplayPreparation, type ZLinkActorRoutedJoinTransport, type ZLinkActorTransferRegistry, type ZLinkDeferredJoinCompletion, type ZLinkRemoteBoundSessionTarget } from '../actors';
+import { type ZLinkActorHandoffCoordinator, type ZLinkActorHandoffReplayPreparation, type ZLinkActorRoutedJoinTransport, type ZLinkDeferredJoinCompletion, type ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkActorHandoffPacket, ZLinkActorHandoffResult, ZLinkActorHandoffTerminalAcceptance, ZLinkActorHandoffTerminalAck } from '../actors/actor-handoff';
 import { type ZLinkActorMessageFollowOwnerFence } from '../actors/actor-message-follow-context';
 import type { ZLinkActorRuntimeState } from '../actors/actor-runtime-state';
@@ -32,7 +32,6 @@ export interface ZLinkActorTransferRuntimeActorManager {
     }): Promise<ZLinkActor>;
     publishRelocationActor(actorId: string): void;
     rollbackTransferredActor(actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
-    completeCoreRelocationSource(actorId: string): Promise<void>;
 }
 export interface ZLinkActorTransferRuntimeOptions {
     readonly routeTransport: ZLinkActorRoutedJoinTransport;
@@ -41,36 +40,30 @@ export interface ZLinkActorTransferRuntimeOptions {
     readonly actorManager: () => ZLinkActorTransferRuntimeActorManager | undefined;
     readonly primaryMeshNode: () => ZLinkBackendMeshNode;
     readonly notifyEntrySpotActorLeft: (actor: ZLinkActor, signal?: AbortSignal) => Promise<void>;
-    readonly restoreEntrySpotActorJoined: (actor: ZLinkActor, signal?: AbortSignal) => Promise<void>;
     readonly locationLifecycle: () => ZLinkLocationLifecycle | undefined;
     /** Resolves the authoritative Ready route for a target User/Instance Spot. */
     readonly spotRouteResolver?: () => ZLinkSpotRouteResolver | undefined;
     readonly actorHandoff: ZLinkActorHandoffCoordinator;
-    readonly actorTransferRegistry: ZLinkActorTransferRegistry;
     readonly authorityStore: () => (ZLinkAuthorityStore & ZLinkObjectCreationStore & ZLinkOwnerLeaseStore) | undefined;
     readonly currentOwner: () => ZLinkLocationOwnerToken | undefined;
-    /** Live admitted peers of a mesh; used to stop retries against a gone session owner. */
-    readonly liveDescriptors?: (meshName: string, signal?: AbortSignal) => Promise<readonly import('../../contracts').ZLinkMeshNodeDescriptor[]>;
     /** Service-wire command 42/43/44 bridge, installed after the host runtime is assembled. */
     readonly sessionRelocationWire?: () => ZLinkSessionRelocationWirePort | undefined;
     readonly clearRemoteActorPacketTarget: (actorId: string) => void;
     /** Acquires that permit before the Actor FIFO claims the runnable child. */
     readonly prepareApplicationJob?: ZLinkActorHandoffReplayPreparation;
     readonly reportPostCommitError?: (error: unknown) => void;
-    readonly onSourceDepartureCompleted?: (actorId: string) => void;
     readonly shutdownSignal?: () => AbortSignal | undefined;
-    readonly metrics?: import('../diagnostics').ZLinkRuntimeMetrics;
 }
 export declare class ZLinkActorTransferRuntime {
     private readonly options;
-    private readonly coreSourceLeaves;
     private readonly activeDeferredJoinTerminals;
     private readonly deferredJoinTerminals;
     constructor(options: ZLinkActorTransferRuntimeOptions);
     beginDeferredActorHandoff(actor: ZLinkActor, state: ZLinkActorRuntimeState): void;
-    promoteDeferredActorHandoff(actor: ZLinkActor, _state: ZLinkActorRuntimeState): void;
+    /** Relocation activation owns admission; handler terminals are observed independently. */
+    admitRelocationPrefix(actor: ZLinkActor, objectGeneration: bigint, packets: readonly ZLinkActorHandoffPacket[], start: Promise<void>, onResult: (packet: ZLinkActorHandoffPacket, result: ZLinkActorHandoffResult) => Promise<void>): void;
     completeDeferredActorHandoff(actor: ZLinkActor, target: ZLinkSpotRouteTarget, _targetActorRef: ActorRef): Promise<void>;
-    cancelDeferredActorHandoff(actor: ZLinkActor, state: ZLinkActorRuntimeState): Promise<void>;
+    cancelDeferredActorHandoff(actor: ZLinkActor, _state: ZLinkActorRuntimeState): Promise<void>;
     prepareDeferredJoinAccepted(actorId: string, operationId: ZLinkActorJoinOperationId, actorRef: ActorRef, rawReply: Uint8Array, replyContentType?: string): ZLinkDeferredJoinCompletion;
     /**
      * Runs the completion callback once in the target Actor mailbox.
@@ -80,43 +73,26 @@ export declare class ZLinkActorTransferRuntime {
     deliverDeferredJoinCompletion(completion: ZLinkDeferredJoinCompletion, actor: ZLinkActor, actorRef: ActorRef, submitMailbox: <T>(operation: () => Promise<T>) => Promise<T>, signal?: AbortSignal): Promise<void>;
     private deliverDeferredJoinCompletionCore;
     private prepareSourceActorLeave;
-    private restoreSourceActor;
     private beginSourceActorMove;
     private cancelSourceActorMove;
     private admitCanceledSourcePrefix;
     private admitDeferredSourcePrefix;
     private observeHandoffReplay;
-    private sourceHandoffPrefixQueue;
-    prepareSource(actor: ZLinkActor, state: ZLinkActorRuntimeState, signal?: AbortSignal, lifecycleAuthority?: 'framework' | 'core', deferredJoin?: boolean, relocation?: ServiceWireOperationId): Promise<{
-        handoffBacklog: readonly ZLinkActorHandoffPacket[];
-        sourceLeaveCompletion: Promise<void> | undefined;
-        sourceLeaveSubmitted: Promise<void> | undefined;
-        onSourceLeaveSubmitted: (notify: () => Promise<void>) => void;
-        observeTargetAuthority: (target: ZLinkSpotRouteTarget, targetActorRef: ActorRef, observeSignal?: AbortSignal) => Promise<void>;
-        commit: (target: Parameters<ZLinkActorHandoffCoordinator["complete"]>[1], targetActorRef: ActorRef, results: Parameters<ZLinkActorHandoffCoordinator["complete"]>[3], releaseLocation?: boolean) => void;
-        rollback: () => Promise<void>;
-        adapterKey?: string;
-        state: ZLinkMessage;
-    }>;
-    prepareMaintenanceSession(actor: ZLinkActor, state: ZLinkActorRuntimeState, signal?: AbortSignal, manageMembership?: boolean, relocation?: ServiceWireOperationId): Promise<{
+    prepareMaintenanceSession(actor: ZLinkActor, state: ZLinkActorRuntimeState, signal?: AbortSignal, manageMembership?: boolean, relocation?: ServiceWireOperationId, relocationTarget?: Pick<ZLinkMeshNodeDescriptor, 'rid' | 'lifecycleGeneration'>): Promise<{
         readonly target?: ZLinkRemoteBoundSessionTarget;
         readonly handoffBacklog: readonly import('../actors').ZLinkActorHandoffPacket[];
         takeRelocationRelay(): readonly import('../actors').ZLinkActorHandoffPacket[];
         setReplayResults(results: readonly import('../actors').ZLinkActorHandoffResult[]): void;
-        commit(target: ZLinkSpotRouteTarget, targetActorRef: ActorRef, targetOwnerFence: ZLinkActorMessageFollowOwnerFence): Promise<void>;
+        commit(target: ZLinkSpotRouteTarget, targetActorRef: ActorRef, targetOwnerFence: ZLinkActorMessageFollowOwnerFence | null): Promise<void>;
         rollback(): Promise<void>;
         discard(reason: unknown): void;
     }>;
-    notifyCoreSourceLeave(actor: ZLinkActor, callback: () => Promise<void>): Promise<void>;
     completeRelocationSourceLeave(actor: ZLinkActor, sourceSpotId: RoutingId | undefined, signal?: AbortSignal): Promise<void>;
     relayMaintenanceTerminal(actorId: string, packet: ZLinkActorHandoffPacket, result: ZLinkActorHandoffResult, sourceNodeRid: RoutingId, targetAuthorityOwnerGeneration?: bigint): ZLinkActorHandoffTerminalAck;
     relayCanonicalMaintenanceTerminal(operationId: string, replyRouteId: string, result: ZLinkActorHandoffResult, sourceNodeRid: RoutingId, targetAuthorityOwnerGeneration?: bigint): ZLinkActorHandoffTerminalAcceptance;
     private sealBoundSessionRoute;
     private abortBoundSessionRouteSeal;
     private observeBoundSessionSealAbort;
-    private beginCoreSourceLeave;
-    private scheduleSourceDeparture;
-    private finishSourceDeparture;
     getOrCreateRoutedActor(actorId: string, actorType: string, actorRef?: ActorRef, remoteBoundSessionTarget?: ZLinkRemoteBoundSessionTarget, actorCreateRequest?: Message, signal?: AbortSignal): Promise<{
         readonly actor: ZLinkActor;
         readonly actorRef: ZLinkBackendActorRef;