@zlink-systems/framework 0.26.0 → 0.28.0

package/src/runtime/host/actor-placement-coordinator.ts

@@ -19,6 +19,7 @@ import type {
 } from '../locations/internal-store-contracts';
 import { encodeAuthorityKey } from '../locations/authority-key-codec';
 import { randomOperationId } from '../locations/creation-operation-id';
+import { diagnosticTextOrAbsent } from '../diagnostics/diagnostic-text';
 import type {
   ServiceActorCreateRecord,
   ServiceUserSpotReservationFence
@@ -84,9 +85,10 @@ export class ZLinkActorPlacementCoordinator {
     timeoutMs: number,
     signal?: AbortSignal
   ): Promise<ZLinkActorCreateResult> {
-    const deadline = createDeadline(timeoutMs, signal);
-    const deadlineMs = performance.now() + timeoutMs;
     const deadlineUnixMs = Date.now() + timeoutMs;
+    const remainingMs = Math.max(0, deadlineUnixMs - Date.now());
+    const deadline = createDeadline(remainingMs, signal);
+    const deadlineMs = performance.now() + remainingMs;
     const contentReference = encodeLocationCreationContent(requestPayload);
     const requestSha256 = createHash('sha256').update(requestPayload).digest();
     const excluded = new Set<string>();
@@ -130,7 +132,8 @@ export class ZLinkActorPlacementCoordinator {
             creatingPayload,
             capacity: { actors: 1, spots: 0 }
           },
-          deadline.signal
+          deadline.signal,
+          BigInt(deadlineUnixMs)
         );
         const existing = existingActor(reserved, actorId, stableType);
         if (existing !== undefined) {
@@ -204,7 +207,7 @@ export class ZLinkActorPlacementCoordinator {
             remote.terminalResult,
             remote.failureCode,
             `Remote Actor '${actorId}' creation failed with result ${remote.terminalResult}, ` +
-              `failure code ${remote.failureCode}, and tail ${remote.tail?.kind ?? 'none'}.`
+              `failure code ${remote.failureCode}, and tail ${diagnosticTextOrAbsent(remote.tail?.kind)}.`
           );
         }
         if (remote.tail?.kind !== 'actorCreate') {
@@ -213,7 +216,7 @@ export class ZLinkActorPlacementCoordinator {
           throw createInternalFrameworkException(
             ZLinkFrameworkInternalErrorKind.RequestProtocolError,
             `Remote Actor '${actorId}' create reply carried tail ` +
-              `${remote.tail?.kind ?? 'none'} on an OK terminal.`
+              `${diagnosticTextOrAbsent(remote.tail?.kind)} on an OK terminal.`
           );
         }
         if (remote.tail.createResult === 'rejected') {

package/src/runtime/host/actor-runtime-options-factory.ts

@@ -13,7 +13,6 @@ import type { ZLinkSpotRouteResolver } from '../spots/spot-routing-internal';
 import {
   DefaultZLinkActorClient,
   ZLinkActorNativeJoinCoordinator,
-  preferredRemoteBoundSessionTarget,
   type ZLinkActorTransferRegistry,
   type ZLinkActorManagerOptions
 } from '../actors';
@@ -56,6 +55,8 @@ export interface ZLinkActorRuntimeOptionsFactoryOptions {
     createRequest: ZLinkMessage,
     signal?: AbortSignal
   ) => Promise<import('../../contracts').ZLinkActorCreateResponse | undefined>;
+  readonly notifyEntrySpotActorJoined: (actor: ZLinkActor, signal?: AbortSignal) => Promise<void>;
+  readonly notifyEntrySpotActorLeft: (actor: ZLinkActor, signal?: AbortSignal) => Promise<void>;
   readonly locationLifecycle: () => ZLinkLocationLifecycle | undefined;
   readonly primaryMeshName: () => string | undefined;
   readonly actorMeshName: (actorType: string) => string | undefined;
@@ -124,6 +125,29 @@ export class ZLinkActorRuntimeOptionsFactory {
         completionTableProvider: this.options.primaryMeshCompletions,
         spotRouteResolver: this.options.createLocationSpotRouteResolver(),
         locationLifecycle: this.options.locationLifecycle(),
+        localSpotJoin: (spotId, actor, request, commit, signal, leaveSource, contentType) => {
+          const manager = this.options.spotManager();
+          if (manager === undefined)
+            throw new Error('Actor Spot membership runtime is not started.');
+          return manager.admitActorJoin(
+            spotId,
+            actor,
+            request,
+            commit,
+            signal,
+            leaveSource,
+            contentType
+          );
+        },
+        localEntryJoin: this.options.notifyEntrySpotActorJoined,
+        reportSourceLeaveError: this.options.reportPostCommitError,
+        localSourceLeave: async (actor, spotId, signal) => {
+          if (spotId === undefined) return this.options.notifyEntrySpotActorLeft(actor, signal);
+          const manager = this.options.spotManager();
+          if (manager === undefined)
+            throw new Error('Actor Spot membership runtime is not started.');
+          return manager.notifyActorLeftAfterTransfer(spotId, actor, signal);
+        },
         postCommitErrorReporter: this.options.reportPostCommitError,
         sourceTransfer: this.options.actorTransferRuntime,
         actorJoinRelocation: this.options.actorJoinRelocation,
@@ -194,13 +218,8 @@ export class ZLinkActorRuntimeOptionsFactory {
           },
           localActorProvider: () =>
             this.options.actorManager()?.getState(actorId)?.actor !== undefined,
-          remoteBoundSessionTargetProvider: () => {
-            const state = this.options.actorManager()?.getState(actorId);
-            return preferredRemoteBoundSessionTarget(
-              state?.remoteBoundSessionTarget,
-              state?.boundSessionTransferTarget
-            );
-          },
+          remoteBoundSessionTargetProvider: () =>
+            this.options.actorManager()?.getState(actorId)?.remoteBoundSessionTarget,
           remoteActorPacketTargetProvider: () => this.options.actorPacketTargetForState(actorId),
           requestTimeoutMs: this.options.registration.requestTimeoutMs,
           actorId,