@zlink-systems/framework 0.24.0 → 0.26.0

package/dist/runtime/spots/formal-remote-actor-transfer-registry.d.ts

@@ -1,12 +1,12 @@
 import type { RoutingId, ZLinkActor } from '../../contracts';
-import type { ZLinkDeferredJoinAcceptedRoot } from '../actors';
+import type { ZLinkDeferredJoinCompletion } from '../actors';
 import type { ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 export interface ZLinkFormalRemoteActorTransfer {
     readonly actor: ZLinkActor;
     readonly spotId: RoutingId;
     readonly transferId: string;
     readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
-    readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+    readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
     readonly targetLifecycleCompleted: Promise<void>;
     readonly sourceLeaveSubmitted: Promise<boolean>;
 }
@@ -23,7 +23,7 @@ export declare class ZLinkFormalRemoteActorTransferRegistry {
         readonly spotId: RoutingId;
         readonly transferId: string;
         readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
-        readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+        readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
     }): ZLinkFormalRemoteActorTransfer;
     delete(actorId: string): void;
     completeTargetLifecycle(actorId: string, transferId: string): boolean;

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

@@ -14,7 +14,7 @@ import { type ReadyRecord, type ReceiveRecord } from '../foundation/service-runt
 import type { ZLinkBackendSpot, ZLinkBackendSpotNode } from '../backend/contracts';
 import { ZLinkDispatchErrorReporter } from '../channels';
 import { ZLinkWorkerRuntime } from '../workers';
-import { type ZLinkDeferredJoinAcceptedRoot, type ZLinkRemoteBoundSessionTarget } from '../actors';
+import { type ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkLocationLifecycle } from '../locations';
 import { type ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 import type { CanonicalActorJoinRecovery } from '../foundation/actor-join-recovery-codec';
@@ -25,11 +25,12 @@ export { DefaultZLinkSpotOutbound, type ZLinkSpotAddressCallOptions, type ZLinkS
 import { type ZLinkSpotRoutedTransport } from './spot-outbound';
 export { DefaultZLinkSpotHandlerRegistry, type ZLinkSpotHandlerRegistration } from './spot-handler-registry';
 export { ZLinkRuntimeSpotPublisherTransport } from './spot-publisher-transport';
-import { type ZLinkSpotActivation } from './spot-activation-state';
+import type { ZLinkSpotActivation } from './spot-activation-state';
 import { type ZLinkNativeSpotAuthority } from './spot-activation';
 import { type ZLinkActorJoinRollback } from './spot-actor-membership';
 import type { ZLinkSpotActorHandoffRuntime, ZLinkSpotActorTransferRuntime, ZLinkSpotBoundSessionRuntime } from './spot-runtime-ports';
 import type { ZLinkRuntimeAdmissionGate } from '../admission';
+import type { ZLinkActivationAdmission } from '../activation-admission';
 import type { ZLinkDetachedTaskRunner } from './spot-actor-join-dispatch';
 import type { ZLinkLocalSpotCreateResult } from './spot-manager-internal-contracts';
 export type { ZLinkLocalSpotCreateResult } from './spot-manager-internal-contracts';
@@ -79,16 +80,21 @@ export interface ZLinkSpotManagerOptions {
     readonly channelMeshNameForChannel?: (channelName: string) => string | undefined;
     readonly providerResolver?: ZLinkProviderResolver;
     readonly dispatchErrors?: ZLinkDispatchErrorReporter;
+    readonly closeErrorSink?: import('../diagnostics/dispatch-error-port').ZLinkDispatchErrorSink;
     readonly runtimeEventPublisher?: ZLinkRuntimeEventPublisher;
     readonly workerRuntime?: ZLinkWorkerRuntime;
     readonly messageSerializers?: ReadonlyMap<string, ZLinkMessageSerializer>;
     readonly locationLifecycle?: ZLinkLocationLifecycle;
     readonly releaseInstanceAuthority?: (meshName: string, spotId: RoutingId, objectGeneration: bigint) => Promise<void>;
-    readonly beginInstanceIdleClosingAuthority?: (meshName: string, spotId: RoutingId) => Promise<{
-        restoreReady(): Promise<void>;
+    readonly beginInstanceIdleClosingAuthority?: (meshName: string, spotId: RoutingId, onCommitted: () => void) => Promise<{
+        release(): Promise<void>;
     } | undefined>;
-    readonly beginInstanceClosingAuthority?: (meshName: string, spotId: RoutingId) => Promise<{
-        restoreReady(): Promise<void>;
+    readonly beginInstanceClosingAuthority?: (meshName: string, spotId: RoutingId, onCommitted: () => void) => Promise<{
+        release(): Promise<void>;
+    } | undefined>;
+    /** Moves a local User Spot incarnation's authority to Closing for a context Close. */
+    readonly beginUserClosingAuthority?: (meshName: string, spotId: RoutingId, objectGeneration: bigint, onCommitted: () => void) => Promise<{
+        release(): Promise<void>;
     } | undefined>;
     readonly instanceSpotApplicationTargetProvider?: (meshName: string, spotId: RoutingId) => {
         readonly stableType: string;
@@ -96,7 +102,6 @@ export interface ZLinkSpotManagerOptions {
     } | undefined;
     readonly instanceSpotApplicationQuiescenceProvider?: (meshName: string, spotId: RoutingId, signal?: AbortSignal) => Promise<void>;
     readonly createNativeSpot?: (meshName: string, spotId: RoutingId, authority?: ZLinkNativeSpotAuthority) => ZLinkBackendSpot | undefined;
-    readonly createReceived?: () => import('../backend').ZLinkBackendReceived;
     readonly createTopicMessage?: () => import('../backend').ZLinkBackendTopicMessage;
     readonly nativeSpotNodeProvider?: (meshName: string) => ZLinkBackendSpotNode | undefined;
     readonly actorResolver?: (actorId: string) => ZLinkActor | undefined;
@@ -118,8 +123,7 @@ export interface ZLinkSpotManagerOptions {
     readonly metrics?: import('../diagnostics').ZLinkRuntimeMetrics;
     readonly admission?: ZLinkRuntimeAdmissionGate;
     readonly statefulExecutionAllowed?: () => boolean;
-    readonly activationConcurrencyLimitProvider?: (meshName: string) => number;
-    readonly onInstanceActivationConcurrencyChanged?: (meshName: string) => void;
+    readonly activationAdmission?: ZLinkActivationAdmission;
 }
 export declare class DefaultZLinkSpotManager {
     private readonly options;
@@ -134,8 +138,7 @@ export declare class DefaultZLinkSpotManager {
     private readonly formalRemoteActorAdmissions;
     private readonly pendingInstanceMaterializations;
     private readonly pendingInstanceMaterializationsByPrefix;
-    private readonly instanceActivationGates;
-    private readonly pendingInstanceCloses;
+    private readonly closeOperations;
     private readonly pendingInstanceTerminals;
     private readonly pendingInstanceTerminalGenerations;
     private readonly deferredInstanceAuthorityReleases;
@@ -145,10 +148,6 @@ export declare class DefaultZLinkSpotManager {
     entrySpotIdForMesh(meshName: string): string | undefined;
     relocationActivations(meshName: string): readonly ZLinkSpotActivation[];
     activeSpotCount(meshName: string): number;
-    instanceActivationConcurrency(meshName: string): {
-        readonly active: number;
-        readonly limit: number;
-    };
     resolveRelocationActivation(meshName: string, spotId: RoutingId): ZLinkSpotActivation | undefined;
     prepareRelocationSpot(meshName: string, objectKind: 'user_spot' | 'instance_spot', stableType: string, implementation: Type<ZLinkSpot | ZLinkInstanceSpot>, spotId: RoutingId, objectGeneration: bigint, authorityOwnerGeneration: bigint, signal?: AbortSignal): Promise<ZLinkSpotActivation>;
     publishRelocationSpot(activation: ZLinkSpotActivation, beforeAdmission?: () => Promise<void>): Promise<void>;
@@ -156,10 +155,10 @@ export declare class DefaultZLinkSpotManager {
     completeRelocationSource(activation: ZLinkSpotActivation): Promise<void>;
     materializeInstance(meshName: string, instanceType: string, spotId: RoutingId, objectGeneration: bigint, signal?: AbortSignal): Promise<void>;
     private materializeInstanceCore;
-    private acquireInstanceActivation;
-    private releaseInstanceActivation;
     isInstanceMaterialized(meshName: string, instanceType: string, spotId: RoutingId): boolean;
     isInstanceMaterializing(meshName: string, spotId: RoutingId): boolean;
+    isSpotClosing(meshName: string, spotId: RoutingId): boolean;
+    pendingSpotCloseDecision(meshName: string, spotId: RoutingId): Promise<void> | undefined;
     isInstanceClosing(meshName: string, spotId: RoutingId): boolean;
     discardInstance(meshName: string, spotId: RoutingId): Promise<void>;
     isInstanceSpotIdleEvicting(meshName: string, spotId: RoutingId): boolean;
@@ -185,10 +184,15 @@ export declare class DefaultZLinkSpotManager {
     list(meshName: string): Promise<readonly ZLinkSpotInfo[]>;
     drainForShutdown(meshName: string, signal?: AbortSignal, deadline?: Date): Promise<void>;
     close(meshName: string, spotId: RoutingId, signal?: AbortSignal): Promise<boolean>;
+    closeUserWithAuthority(meshName: string, spotId: RoutingId, beginAuthority: (onCommitted: () => void) => Promise<{
+        release(): Promise<void>;
+    }>, signal?: AbortSignal): Promise<boolean>;
+    private closeFromContext;
     private closeWithReason;
+    private runCloseOperation;
+    private beginCloseAuthority;
     executeOnSpot<TSpot extends ZLinkSpot, TResult>(spotType: Type<TSpot>, spotId: RoutingId, operation: (spot: TSpot) => Promise<TResult> | TResult, signal?: AbortSignal): Promise<TResult>;
     hasActiveSpot(spotId: RoutingId): boolean;
-    canCloseUserSpot(meshName: string, spotId: RoutingId): boolean;
     beginUserSpotPublication(meshName: string, spotId: RoutingId): void;
     publishUserSpot(meshName: string, spotId: RoutingId): void;
     abortUserSpotPublication(meshName: string, spotId: RoutingId): void;
@@ -224,10 +228,12 @@ export declare class DefaultZLinkSpotManager {
     private traceInstanceMessage;
     dispatchMeshActor(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
     dispatchMeshActorJoin(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    private dispatchMeshActorJoinCore;
     dispatchMeshSpotControl(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    private dispatchMeshSpotControlCore;
     completeFormalSourceLeaveTerminal(actorId: string, transferId: string, succeeded: boolean): Promise<boolean>;
     finalizeActorJoinRelocation(meshName: string, relocationId: string, actor: ZLinkActor, actorRef: ActorRef, submitSourceLeave: (sourceNodeRid: RoutingId) => Promise<void>, signal?: AbortSignal): Promise<boolean>;
-    restoreCanonicalActorJoinRecovery(recovery: CanonicalActorJoinRecovery, signal?: AbortSignal, canonicalInventoryDigest?: string): Promise<ZLinkDeferredJoinAcceptedRoot | undefined>;
+    restoreCanonicalActorJoinRecovery(recovery: CanonicalActorJoinRecovery, signal?: AbortSignal): Promise<void>;
     private encodeMeshActorReply;
     private createActivation;
     private requireRegisteredFactory;