@zlink-systems/framework 0.25.0 → 0.27.0

package/src/runtime/locations/spot-location-claims.ts

@@ -126,7 +126,8 @@ export class ZLinkSpotLocationClaims {
 
   async beginInstanceClosing(
     meshName: string,
-    spotId: RoutingId
+    spotId: RoutingId,
+    onCommitted: () => void
   ): Promise<ZLinkInstanceClosingAuthority | undefined> {
     const canonical = ZLinkLocationKeyCodec.encodeSpotKey({ meshName, spotId });
     const tracked = this.spots.get(canonical);
@@ -166,38 +167,60 @@ export class ZLinkSpotLocationClaims {
       return undefined;
     }
     tracked.storeVersion = result.storeVersion.value;
-    this.invalidateSpotRoute?.(tracked.spotId);
-    let restored = false;
+    onCommitted();
     return {
-      restoreReady: async () => {
-        if (restored) return;
-        const restore = await store.compareExchangeAuthority(key, result.storeVersion, {
+      release: () => this.release(meshName, spotId),
+      reincarnate: async (initialize) => {
+        const reincarnated = await store.compareExchangeAuthority(key, result.storeVersion, {
           kind: 'put',
-          generationTransition: 'preserve',
+          generationTransition: 'reincarnate',
           payload: replaceServiceRelocationAuthorityApplicationPayload(
-            current.payload,
-            encodeServiceInstanceAuthorityPayload({
-              state: 'ready',
-              stableType: decoded.stableType,
-              spotId: decoded.spotId,
-              ownerId: decoded.ownerId,
-              ownerLeaseGeneration: decoded.ownerLeaseGeneration,
-              ownerMeshName: decoded.ownerMeshName,
-              ownerNodeRid: decoded.ownerNodeRid,
-              ownerNodeGeneration: decoded.ownerNodeGeneration
-            })
+            result.payload,
+            encodeServiceInstanceAuthorityPayload({ ...decoded, state: 'coldActivating' })
           )
         });
-        if (restore.kind !== 'stored') {
+        if (reincarnated.kind !== 'stored') {
           throw createInternalFrameworkException(
-            ZLinkFrameworkInternalErrorKind.SpotMoving,
-            `Instance Spot '${String(spotId)}' Ready authority could not be restored after idle eviction was declined.`,
-            true
+            reincarnated.kind === 'generationExhausted'
+              ? ZLinkFrameworkInternalErrorKind.InvalidOperation
+              : ZLinkFrameworkInternalErrorKind.SpotMoving,
+            `Instance Spot '${String(spotId)}' Closing authority changed before reincarnation.`
           );
         }
-        restored = true;
-        tracked.storeVersion = restore.storeVersion.value;
-        this.invalidateSpotRoute?.(tracked.spotId);
+        this.trackInstanceAuthority({
+          ...tracked,
+          objectGeneration: reincarnated.objectGeneration,
+          authorityOwnerGeneration: reincarnated.authorityOwnerGeneration,
+          storeVersion: reincarnated.storeVersion.value
+        });
+        this.invalidateSpotRoute?.(spotId);
+        try {
+          await initialize({ ...reincarnated, kind: 'snapshot', stableType: tracked.stableType });
+          const ready = await store.compareExchangeAuthority(key, reincarnated.storeVersion, {
+            kind: 'put',
+            generationTransition: 'preserve',
+            payload: replaceServiceRelocationAuthorityApplicationPayload(
+              reincarnated.payload,
+              encodeServiceInstanceAuthorityPayload({ ...decoded, state: 'ready' })
+            )
+          });
+          if (ready.kind !== 'stored') {
+            throw createInternalFrameworkException(
+              ready.kind === 'generationExhausted'
+                ? ZLinkFrameworkInternalErrorKind.InvalidOperation
+                : ZLinkFrameworkInternalErrorKind.SpotMoving,
+              `Instance Spot '${String(spotId)}' reincarnation authority changed before initialization completed.`
+            );
+          }
+          const latest = this.spots.get(canonical);
+          if (latest?.kind === 'authority' && latest.objectGeneration === ready.objectGeneration) {
+            latest.storeVersion = ready.storeVersion.value;
+          }
+          return { ...ready, kind: 'snapshot', stableType: tracked.stableType };
+        } catch (error) {
+          await this.release(meshName, spotId, reincarnated.objectGeneration);
+          throw error;
+        }
       }
     };
   }
@@ -382,7 +405,12 @@ export interface ZLinkTrackedInstanceAuthority {
 }
 
 export interface ZLinkInstanceClosingAuthority {
-  restoreReady(): Promise<void>;
+  release(): Promise<void>;
+  reincarnate?(
+    initialize: (
+      authority: ZLinkAuthoritySnapshot & { readonly stableType: string }
+    ) => Promise<void>
+  ): Promise<ZLinkAuthoritySnapshot & { readonly stableType: string }>;
 }
 
 interface TrackedLegacySpot {

package/src/runtime/messaging/payload-codec.ts

@@ -1,3 +1,4 @@
+import { ZlinkStreamContentType } from '@zlink-systems/stream-wire';
 import {
   ZLinkFrameworkInternalErrorKind,
   createInternalFrameworkException
@@ -31,6 +32,8 @@ import {
   matchEveryDeclaredMessageType
 } from '../../contracts/Configuration/CodecSerializerSelection';
 
+const MAX_DECLARED_TYPE_SELECTIONS = 1024;
+
 export interface ZLinkSerializerRegistryLike {
   readonly serializers: ReadonlyMap<string, ZLinkMessageSerializer>;
 }
@@ -49,7 +52,12 @@ interface ZLinkSerializerSelectionPlan {
 }
 
 const noSerializer = Symbol('noSerializer');
-const JSON_CONTENT_TYPE = 'application/json';
+const JSON_CONTENT_TYPE = ZlinkStreamContentType.Json;
+const frameworkJsonReceiveCodec = Symbol('frameworkJsonReceiveCodec');
+const defaultReceiveCodecs: ReadonlyMap<string, typeof frameworkJsonReceiveCodec> = new Map<
+  string,
+  typeof frameworkJsonReceiveCodec
+>([[JSON_CONTENT_TYPE, frameworkJsonReceiveCodec]]);
 
 // Registration maps are created during host configuration and are immutable
 // for the runtime lifetime. Compile the candidate list and reverse content
@@ -84,9 +92,9 @@ export function encodeFrameworkPayload(
       return {
         message: rememberContentType(
           toRuntimeMessage(payload.toEncodedPayload()),
-          'application/octet-stream'
+          ZlinkStreamContentType.Raw
         ),
-        contentType: 'application/octet-stream'
+        contentType: ZlinkStreamContentType.Raw
       };
     }
     declaredType = readZLinkMessageDeclaredType(payload);
@@ -141,7 +149,7 @@ export function decodeFrameworkPayloadMessage<T>(
   message: Message,
   registry?: ZLinkSerializerRegistryLike | ReadonlyMap<string, ZLinkMessageSerializer>,
   type?: Type<T>,
-  contentType = JSON_CONTENT_TYPE,
+  contentType: string = JSON_CONTENT_TYPE,
   packetName?: string,
   contractPart: 'payload' | 'reply' = 'payload'
 ): T {
@@ -152,7 +160,7 @@ export function decodeFrameworkTypedPayloadMessage<T>(
   message: Message,
   registry?: ZLinkSerializerRegistryLike | ReadonlyMap<string, ZLinkMessageSerializer>,
   type?: Type<T>,
-  contentType = JSON_CONTENT_TYPE,
+  contentType: string = JSON_CONTENT_TYPE,
   packetName?: string,
   contractPart: 'payload' | 'reply' = 'payload'
 ): T {
@@ -167,17 +175,10 @@ function decodeFrameworkPayload<T>(
   packetName: string | undefined,
   contractPart: 'payload' | 'reply'
 ): T {
-  if (!isCanonicalCodecContentType(contentType)) {
-    throw unsupportedContentType(contentType);
-  }
-  if (contentType !== JSON_CONTENT_TYPE) {
-    const serializer = serializerMapOf(registry)?.get(contentType);
-    if (serializer === undefined) throw unsupportedContentType(contentType);
+  const codec = receiveCodecFor(contentType, registry);
+  if (codec !== frameworkJsonReceiveCodec) {
     if (message.isEmpty()) return undefined as T;
-    return serializer.deserialize(
-      encodedPayloadFromOwned(message.data()),
-      (type ?? Object) as Type<T>
-    );
+    return codec.deserialize(encodedPayloadFromOwned(message.data()), (type ?? Object) as Type<T>);
   }
 
   if (message.isEmpty()) return undefined as T;
@@ -197,7 +198,7 @@ function decodeFrameworkPayload<T>(
 export function wrapFrameworkPayloadMessage(
   message: Message,
   registry?: ZLinkSerializerRegistryLike | ReadonlyMap<string, ZLinkMessageSerializer>,
-  contentType = JSON_CONTENT_TYPE,
+  contentType: string = JSON_CONTENT_TYPE,
   packetName?: string,
   contractPart: 'payload' | 'reply' = 'payload'
 ): ZLinkMessage {
@@ -215,14 +216,10 @@ function decodeFrameworkEncodedPayload<T>(
   packetName: string | undefined,
   contractPart: 'payload' | 'reply'
 ): T {
-  if (!isCanonicalCodecContentType(contentType)) {
-    throw unsupportedContentType(contentType);
-  }
-  if (contentType !== JSON_CONTENT_TYPE) {
-    const serializer = serializerMapOf(registry)?.get(contentType);
-    if (serializer === undefined) throw unsupportedContentType(contentType);
+  const codec = receiveCodecFor(contentType, registry);
+  if (codec !== frameworkJsonReceiveCodec) {
     if (payload.isEmpty()) return undefined as T;
-    return serializer.deserialize(payload, (type ?? Object) as Type<T>);
+    return codec.deserialize(payload, (type ?? Object) as Type<T>);
   }
   if (payload.isEmpty()) return undefined as T;
   const text = payload.getString('utf8');
@@ -241,6 +238,20 @@ function decodeFrameworkEncodedPayload<T>(
   }
 }
 
+function receiveCodecFor(
+  contentType: string,
+  registry: ZLinkSerializerRegistryLike | ReadonlyMap<string, ZLinkMessageSerializer> | undefined
+): ZLinkMessageSerializer | typeof frameworkJsonReceiveCodec {
+  if (!isCanonicalCodecContentType(contentType)) {
+    throw unsupportedContentType(contentType);
+  }
+  const registeredCodec = serializerMapOf(registry)?.get(contentType);
+  if (registeredCodec !== undefined) return registeredCodec;
+  const defaultCodec = defaultReceiveCodecs.get(contentType);
+  if (defaultCodec !== undefined) return defaultCodec;
+  throw unsupportedContentType(contentType);
+}
+
 function schemaForDecode(
   type: Type<unknown> | undefined,
   packetName: string | undefined,
@@ -316,7 +327,7 @@ function serializerSelectionPlanOf(
         return cached === noSerializer ? undefined : cached;
       }
       const selected = selectSerializerFromEntries(frozenEntries, declaredType);
-      if (cachedBusinessTypeCount < 1024) {
+      if (cachedBusinessTypeCount < MAX_DECLARED_TYPE_SELECTIONS) {
         outboundByBusinessType.set(declaredType, selected ?? noSerializer);
         cachedBusinessTypeCount += 1;
       }

package/src/runtime/messaging/submission-result.ts

@@ -1,7 +1,10 @@
 import {
   ZLinkFrameworkInternalErrorKind,
-  createInternalFrameworkException
+  createInternalFrameworkException,
+  requestResultToPublicErrorKind
 } from '../framework-errors-internal';
+import { ZLinkFrameworkException } from '../../contracts';
+import { RequestResult, SubmitResult } from '../backend/runtime-values';
 export enum ZLinkSubmitStatus {
   Submitted = 'submitted',
   Backpressured = 'backpressured',
@@ -15,6 +18,59 @@ export interface ZLinkSubmitResult {
   readonly status: ZLinkSubmitStatus;
 }
 
+/** Projects the Core submit result once; phase only determines capacity refusal meaning. */
+export function submitToRequestResult(result: number, phase: 'submit' | 'completion'): number {
+  switch (result) {
+    case SubmitResult.Ok:
+      return RequestResult.Ok;
+    case SubmitResult.Backpressured:
+      return phase === 'submit' ? RequestResult.NotConnected : RequestResult.TimedOut;
+    case SubmitResult.NotConnected:
+      return RequestResult.NotConnected;
+    case SubmitResult.NotFound:
+      return RequestResult.NotFound;
+    case SubmitResult.NotAdmitted:
+      return RequestResult.Rejected;
+    case SubmitResult.InvalidHandle:
+    case SubmitResult.InvalidArgument:
+    case SubmitResult.ThreadViolation:
+      return RequestResult.InvalidArgument;
+    case SubmitResult.InvalidState:
+      return RequestResult.InvalidState;
+    case SubmitResult.NotSupported:
+      return RequestResult.NotSupported;
+    case SubmitResult.Terminated:
+      return RequestResult.Terminated;
+    default:
+      return RequestResult.InternalError;
+  }
+}
+
+export function classifySubmitResult(
+  result: number,
+  operation: string,
+  phase: 'submit' | 'completion' = 'completion'
+): ZLinkSubmitResult {
+  const terminal = submitToRequestResult(result, phase);
+  switch (terminal) {
+    case RequestResult.Ok:
+      return { status: ZLinkSubmitStatus.Submitted };
+    case RequestResult.TimedOut:
+      return { status: ZLinkSubmitStatus.TimedOut };
+    case RequestResult.NotFound:
+      return { status: ZLinkSubmitStatus.TargetNotFound };
+    case RequestResult.NotConnected:
+      return { status: ZLinkSubmitStatus.RouteNotConnected };
+    case RequestResult.Terminated:
+      return { status: ZLinkSubmitStatus.Shutdown };
+    default:
+      throw new ZLinkFrameworkException(
+        requestResultToPublicErrorKind(terminal),
+        `${operation} failed with submit result ${result}.`
+      );
+  }
+}
+
 export function requireOneWayCompletion(
   result: ZLinkSubmitResult,
   operation: string,

package/src/runtime/protocol/service_wire_codec.generated.ts

@@ -2260,7 +2260,7 @@ function writeRetiredBoundSessionRouteFence(input: RetiredBoundSessionRouteFence
 export function decodeRetiredBoundSessionRouteFence(bytes: Uint8Array, context: ServiceWireDecoderContext): RetiredBoundSessionRouteFence { const reader = new Reader(bytes); const value = readRetiredBoundSessionRouteFence(reader, context, {}, 0); reader.done("retired-bound-session-route-fence"); return value; }
 export function encodeRetiredBoundSessionRouteFence(value: RetiredBoundSessionRouteFence, context: ServiceWireDecoderContext): Uint8Array { const writer = new Writer(); writeRetiredBoundSessionRouteFence(value, writer, context, {}, 0); return writer.result(); }
 
-export type SessionRelocationRouteUpdate = { readonly action: "commit"; readonly previousAuthorityOwnerGeneration: NonzeroU64; readonly targetAuthorityOwnerGeneration: NonzeroU64; readonly targetNodeRid: Rid; readonly targetNodeGeneration: NonzeroU64 } | { readonly action: "abort"; readonly currentAuthorityOwnerGeneration: NonzeroU64 };
+export type SessionRelocationRouteUpdate = { readonly action: "commit"; readonly previousAuthorityOwnerGeneration: NonzeroU64; readonly targetAuthorityOwnerGeneration: NonzeroU64; readonly targetNodeRid: Rid; readonly targetNodeGeneration: NonzeroU64; readonly targetOwnerLeaseGeneration: NonzeroU64 } | { readonly action: "abort"; readonly currentAuthorityOwnerGeneration: NonzeroU64 };
 
 function readSessionRelocationRouteUpdate(reader: Reader, context: ServiceWireDecoderContext, enclosing: any, flags: number): SessionRelocationRouteUpdate {
   void context; void enclosing; void flags;
@@ -2280,6 +2280,9 @@ function readSessionRelocationRouteUpdate(reader: Reader, context: ServiceWireDe
     value["targetNodeGeneration"] = readNonzeroU64(body, context, value, flags);
 
 
+    value["targetOwnerLeaseGeneration"] = readNonzeroU64(body, context, value, flags);
+
+
   } else if (same(value["action"], "abort")) {
     value["currentAuthorityOwnerGeneration"] = readNonzeroU64(body, context, value, flags);
 
@@ -2313,8 +2316,12 @@ function writeSessionRelocationRouteUpdate(input: SessionRelocationRouteUpdate,
 
 
     writeNonzeroU64(numeric(value["targetNodeGeneration"]), body, context, value, flags);
+    if (value["targetOwnerLeaseGeneration"] === undefined) fail("targetOwnerLeaseGeneration required");
+
+
+    writeNonzeroU64(numeric(value["targetOwnerLeaseGeneration"]), body, context, value, flags);
   } else if (same(value["action"], "abort")) {
-    if (value["previousAuthorityOwnerGeneration"] !== undefined || value["targetAuthorityOwnerGeneration"] !== undefined || value["targetNodeRid"] !== undefined || value["targetNodeGeneration"] !== undefined) fail("session-relocation-route-update discriminator agreement");
+    if (value["previousAuthorityOwnerGeneration"] !== undefined || value["targetAuthorityOwnerGeneration"] !== undefined || value["targetNodeRid"] !== undefined || value["targetNodeGeneration"] !== undefined || value["targetOwnerLeaseGeneration"] !== undefined) fail("session-relocation-route-update discriminator agreement");
     if (value["currentAuthorityOwnerGeneration"] === undefined) fail("currentAuthorityOwnerGeneration required");
 
 
@@ -4250,7 +4257,7 @@ function readChannelEntry(reader: Reader, context: ServiceWireDecoderContext, en
 
 
   value["weight"] = readU32(reader, context, value, flags);
-  if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n) fail("weight constraint");
+  if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n) fail("weight constraint");
 
 
 
@@ -4266,7 +4273,7 @@ function writeChannelEntry(input: ChannelEntry, writer: Writer, context: Service
 
   writeText8(value["channelName"], writer, context, value, flags);
   if (value["weight"] === undefined) fail("weight required");
-  if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n) fail("weight constraint");
+  if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n) fail("weight constraint");
 
   writeU32(value["weight"], writer, context, value, flags);
 }
@@ -4444,7 +4451,7 @@ function readDescriptorExtension(reader: Reader, context: ServiceWireDecoderCont
             item.done("objectRole"); break;
       case 8:
             if (value["placementWeight"] !== undefined) fail("descriptor-extension duplicate"); value["placementWeight"] = readU32(item, context, value, flags);
-            if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 100n) fail("placementWeight constraint");
+            if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 10000n) fail("placementWeight constraint");
 
             item.done("placementWeight"); break;
       case 9:
@@ -4519,7 +4526,7 @@ function writeDescriptorExtension(input: DescriptorExtension, writer: Writer, co
     const item = new Writer(); writeObjectRole(value["objectRole"], item, context, value, flags); const itemBytes = item.result(); writeU8(7, body, context, value, flags); writeU32(itemBytes.length, body, context, value, flags); body.put(itemBytes);
   }
   if (value["placementWeight"] !== undefined) {
-    if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 100n) fail("placementWeight constraint");
+    if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 10000n) fail("placementWeight constraint");
 
     const item = new Writer(); writeU32(value["placementWeight"], item, context, value, flags); const itemBytes = item.result(); writeU8(8, body, context, value, flags); writeU32(itemBytes.length, body, context, value, flags); body.put(itemBytes);
   }
@@ -4653,7 +4660,7 @@ function readClientServerAdmission(reader: Reader, context: ServiceWireDecoderCo
 
 
     value["weight"] = readU32(body, context, value, flags);
-    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n) fail("weight constraint");
+    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n) fail("weight constraint");
 
     value["runtimeState"] = readRuntimeState(body, context, value, flags);
 
@@ -4719,7 +4726,7 @@ function writeClientServerAdmission(input: ClientServerAdmission, writer: Writer
 
     writeNonzeroU64(numeric(value["descriptorRevision"]), body, context, value, flags);
     if (value["weight"] === undefined) fail("weight required");
-    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n) fail("weight constraint");
+    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n) fail("weight constraint");
 
     writeU32(value["weight"], body, context, value, flags);
     if (value["runtimeState"] === undefined) fail("runtimeState required");
@@ -6369,7 +6376,7 @@ function writeFrozenRecord(input: FrozenRecord, writer: Writer, context: Service
 export function decodeFrozenRecord(bytes: Uint8Array, context: ServiceWireDecoderContext): FrozenRecord { const reader = new Reader(bytes); const value = readFrozenRecord(reader, context, {}, 0); reader.done("frozen-record"); return value; }
 export function encodeFrozenRecord(value: FrozenRecord, context: ServiceWireDecoderContext): Uint8Array { const writer = new Writer(); writeFrozenRecord(value, writer, context, {}, 0); return writer.result(); }
 
-export type InstanceRouteV1 = { readonly routeKind: "ready"; readonly targetNodeRid: Rid; readonly targetNodeGeneration: NonzeroU64; readonly targetSpotId: Text8; readonly authority: AuthorityGenerationFence } | { readonly routeKind: "coldActivation"; readonly targetNodeRid: Rid; readonly targetNodeGeneration: NonzeroU64; readonly targetSpotId: Text8; readonly targetMeshName: Text8; readonly stableType: Text8; readonly targetDescriptorVersion: Text8; readonly deadlineUnixMs: NonzeroU64 };
+export type InstanceRouteV1 = { readonly routeKind: "ready"; readonly targetNodeRid: Rid; readonly targetNodeGeneration: NonzeroU64; readonly targetSpotId: Text8; readonly authority: AuthorityGenerationFence; readonly instanceIntent: Bool8 } | { readonly routeKind: "coldActivation"; readonly targetNodeRid: Rid; readonly targetNodeGeneration: NonzeroU64; readonly targetSpotId: Text8; readonly targetMeshName: Text8; readonly stableType: Text8; readonly targetDescriptorVersion: Text8; readonly deadlineUnixMs: NonzeroU64 };
 
 function readInstanceRouteV1(reader: Reader, context: ServiceWireDecoderContext, enclosing: any, flags: number): InstanceRouteV1 {
   void context; void enclosing; void flags;
@@ -6389,6 +6396,9 @@ function readInstanceRouteV1(reader: Reader, context: ServiceWireDecoderContext,
     value["authority"] = readAuthorityGenerationFence(body, context, value, flags);
 
 
+    value["instanceIntent"] = readBool8(body, context, value, flags);
+
+
   } else if (same(value["routeKind"], "coldActivation")) {
     value["targetNodeRid"] = readRid(body, context, value, flags);
 
@@ -6434,6 +6444,9 @@ function* readIncrementalInstanceRouteV1(reader: IncrementalInput, context: Serv
     value["authority"] = yield* readIncrementalAuthorityGenerationFence(body, context, value, flags);
 
 
+    value["instanceIntent"] = yield* readIncrementalBool8(body, context, value, flags);
+
+
   } else if (same(value["routeKind"], "coldActivation")) {
     value["targetNodeRid"] = yield* readIncrementalRid(body, context, value, flags);
 
@@ -6484,8 +6497,12 @@ function writeInstanceRouteV1(input: InstanceRouteV1, writer: Writer, context: S
 
 
     writeAuthorityGenerationFence(value["authority"], body, context, value, flags);
+    if (value["instanceIntent"] === undefined) fail("instanceIntent required");
+
+
+    writeBool8(value["instanceIntent"], body, context, value, flags);
   } else if (same(value["routeKind"], "coldActivation")) {
-    if (value["authority"] !== undefined) fail("instance-route-v1 discriminator agreement");
+    if (value["authority"] !== undefined || value["instanceIntent"] !== undefined) fail("instance-route-v1 discriminator agreement");
     if (value["targetNodeRid"] === undefined) fail("targetNodeRid required");
 
 

package/src/runtime/protocol/service_wire_pilot_codec.generated.ts

@@ -1,4 +1,4 @@
-// <auto-generated> DO NOT EDIT. schema-sha256: 5099b874cd4e2fbff7fea9b821dd8fd670e0de676c6e409ba6e30455dc457e44
+// <auto-generated> DO NOT EDIT. schema-sha256: 77748ba8f585cb70ad337fa3203b5f9b9aa7a89e7f95f7fdc20159c30987be0f
 export interface ServiceWireRouteFence { readonly id: string; readonly generation: bigint; readonly targetNodeRid: Uint8Array; readonly targetNodeGeneration: bigint; readonly expectedAuthorityOwnerGeneration: bigint; readonly expectedOwnerLeaseGeneration: bigint; }
 	export interface ApplicationPayloadEnvelopeV1 { readonly packetName: string; readonly contentType: string; readonly payload: Uint8Array; }
 	export interface ActorJoin28 { readonly correlation: bigint; readonly actor: ServiceWireRouteFence; readonly entry: boolean; readonly targetSpot: ServiceWireRouteFence; readonly payload?: ApplicationPayloadEnvelopeV1; }
@@ -96,7 +96,7 @@ export interface ServiceWireRequestSourceFence { readonly sourceOwnerId:string;r
 export interface ServiceWireAuthorityFence { readonly objectGeneration:bigint;readonly ownerId:string;readonly authorityOwnerGeneration:bigint;readonly leaseGeneration:bigint;readonly storeVersion:string; }
 export type ServiceWireRelocationRole="source"|"target"|"coordinator";
 export type ServiceWireReplyRelayContext={readonly contextKind:"coldActivation";readonly completionKind:"readyBarrier"|"activationFailure";readonly authority:ServiceWireAuthorityFence}|{readonly contextKind:"maintenanceRelocation";readonly relocation:ServiceWireRelocationId;readonly targetAttemptGeneration:bigint;readonly coordinator:ServiceWireCoordinatorFence;readonly participantId:bigint;readonly sequence:bigint};
-export type ServiceWireSessionRouteUpdate={readonly action:"commit";readonly previousAuthorityOwnerGeneration:bigint;readonly targetAuthorityOwnerGeneration:bigint;readonly targetNodeRid:Uint8Array;readonly targetNodeGeneration:bigint}|{readonly action:"abort";readonly currentAuthorityOwnerGeneration:bigint};
+export type ServiceWireSessionRouteUpdate={readonly action:"commit";readonly previousAuthorityOwnerGeneration:bigint;readonly targetAuthorityOwnerGeneration:bigint;readonly targetNodeRid:Uint8Array;readonly targetNodeGeneration:bigint;readonly targetOwnerLeaseGeneration:bigint}|{readonly action:"abort";readonly currentAuthorityOwnerGeneration:bigint};
 export interface ReplyRelay33 {readonly operation:ServiceWireOperationId;readonly replyRouteId:bigint;readonly context:ServiceWireReplyRelayContext;readonly terminalResult:number;readonly failureCode:number;readonly payload?:ApplicationPayloadEnvelopeV1;}
 export interface ReplyRelayAck46 {readonly relocation:ServiceWireRelocationId;readonly coordinator:ServiceWireCoordinatorFence;readonly operation:ServiceWireOperationId;readonly replyRouteId:bigint;readonly requestSource:ServiceWireRequestSourceFence;readonly status:"terminalReceived"|"alreadyTerminal";}
 export interface RelocationReady30 {readonly relocation:ServiceWireRelocationId;readonly targetAttemptGeneration:bigint;readonly coordinator:ServiceWireCoordinatorFence;readonly target:ServiceWireTargetFence;readonly object:RelocationObjectIdentity;readonly senderRole:ServiceWireRelocationRole;}
@@ -128,8 +128,8 @@ function b3WriteContext(out:number[],v:ServiceWireReplyRelayContext):void{out.pu
 function b3ReadContext(bytes:Uint8Array,at:{value:number}):ServiceWireReplyRelayContext{const kind=read8(bytes,at),end=boundedEnd(bytes,at,read16(bytes,at),"reply context");let value:ServiceWireReplyRelayContext;if(kind===1){const completion=read8(bytes,at),inner=boundedEnd(bytes,at,read16(bytes,at),"cold activation");if(completion<1||completion>2)throw new RangeError("completion kind");const authority=b3ReadAuthority(bytes,at);exactEnd(at,inner,"cold activation");value={contextKind:"coldActivation",completionKind:completion===1?"readyBarrier":"activationFailure",authority};}else if(kind===2)value={contextKind:"maintenanceRelocation",relocation:b3ReadId(bytes,at,"relocation"),targetAttemptGeneration:nonzero64(bytes,at,"target attempt"),coordinator:b3ReadCoordinator(bytes,at),participantId:nonzero64(bytes,at,"participant"),sequence:nonzero64(bytes,at,"sequence")};else throw new RangeError("reply context kind");exactEnd(at,end,"reply context");return value;}
 const b3FailureResults=new Map<number,number>([[1,102],[2,105],[3,107],[4,107],[5,105],[6,102],[7,107],[8,102],[9,102],[10,102],[11,102],[12,104],[13,105],[14,102],[15,106],[16,104],[17,105],[18,106],[19,105],[20,105],[21,107],[22,106],[33,107],[34,107],[35,105]]);
 function b3ValidTerminal(result:number,failure:number,payload:boolean):void{const boundary=[101,103,108,109,110,111,112,113];if(result===0){if(failure!==0)throw new RangeError("terminal failure");return;}if(payload)throw new RangeError("failure payload");if(boundary.includes(result)){if(failure!==0)throw new RangeError("boundary failure");return;}if(b3FailureResults.get(failure)!==result)throw new RangeError("typed failure");}
-function b3WriteRoute(out:number[],v:ServiceWireSessionRouteUpdate):void{out.push(v.action==="commit"?1:2);body16(out,b=>{if(v.action==="commit"){if(v.previousAuthorityOwnerGeneration===0n||v.targetAuthorityOwnerGeneration===0n||v.targetNodeGeneration===0n)throw new RangeError("route commit");u64(b,v.previousAuthorityOwnerGeneration);u64(b,v.targetAuthorityOwnerGeneration);rid(b,v.targetNodeRid);u64(b,v.targetNodeGeneration);}else{if(v.currentAuthorityOwnerGeneration===0n)throw new RangeError("route abort");u64(b,v.currentAuthorityOwnerGeneration);}});}
-function b3ReadRoute(bytes:Uint8Array,at:{value:number}):ServiceWireSessionRouteUpdate{const action=read8(bytes,at),end=boundedEnd(bytes,at,read16(bytes,at),"session route");let value:ServiceWireSessionRouteUpdate;if(action===1)value={action:"commit",previousAuthorityOwnerGeneration:nonzero64(bytes,at,"previous authority"),targetAuthorityOwnerGeneration:nonzero64(bytes,at,"target authority"),targetNodeRid:readRid(bytes,at),targetNodeGeneration:nonzero64(bytes,at,"target node")};else if(action===2)value={action:"abort",currentAuthorityOwnerGeneration:nonzero64(bytes,at,"current authority")};else throw new RangeError("route action");exactEnd(at,end,"session route");return value;}
+function b3WriteRoute(out:number[],v:ServiceWireSessionRouteUpdate):void{out.push(v.action==="commit"?1:2);body16(out,b=>{if(v.action==="commit"){if(v.previousAuthorityOwnerGeneration===0n||v.targetAuthorityOwnerGeneration===0n||v.targetNodeGeneration===0n||v.targetOwnerLeaseGeneration===0n)throw new RangeError("route commit");u64(b,v.previousAuthorityOwnerGeneration);u64(b,v.targetAuthorityOwnerGeneration);rid(b,v.targetNodeRid);u64(b,v.targetNodeGeneration);u64(b,v.targetOwnerLeaseGeneration);}else{if(v.currentAuthorityOwnerGeneration===0n)throw new RangeError("route abort");u64(b,v.currentAuthorityOwnerGeneration);}});}
+function b3ReadRoute(bytes:Uint8Array,at:{value:number}):ServiceWireSessionRouteUpdate{const action=read8(bytes,at),end=boundedEnd(bytes,at,read16(bytes,at),"session route");let value:ServiceWireSessionRouteUpdate;if(action===1)value={action:"commit",previousAuthorityOwnerGeneration:nonzero64(bytes,at,"previous authority"),targetAuthorityOwnerGeneration:nonzero64(bytes,at,"target authority"),targetNodeRid:readRid(bytes,at),targetNodeGeneration:nonzero64(bytes,at,"target node"),targetOwnerLeaseGeneration:nonzero64(bytes,at,"target lease")};else if(action===2)value={action:"abort",currentAuthorityOwnerGeneration:nonzero64(bytes,at,"current authority")};else throw new RangeError("route action");exactEnd(at,end,"session route");return value;}
 function b3WriteSession(out:number[],v:{readonly sessionOwnerNodeRid:Uint8Array;readonly sessionOwnerNodeGeneration:bigint;readonly sessionOwnerId:string;readonly sessionOwnerLeaseGeneration:bigint;readonly sessionRid:Uint8Array;readonly bindingGeneration:bigint}):void{rid(out,v.sessionOwnerNodeRid);if(v.sessionOwnerNodeGeneration===0n||v.sessionOwnerLeaseGeneration===0n||v.bindingGeneration===0n)throw new RangeError("session");u64(out,v.sessionOwnerNodeGeneration);text8(out,v.sessionOwnerId);u64(out,v.sessionOwnerLeaseGeneration);rid(out,v.sessionRid);u64(out,v.bindingGeneration);}
 function b3ReadSession(bytes:Uint8Array,at:{value:number}){return{sessionOwnerNodeRid:readRid(bytes,at),sessionOwnerNodeGeneration:nonzero64(bytes,at,"session owner node"),sessionOwnerId:readText8(bytes,at),sessionOwnerLeaseGeneration:nonzero64(bytes,at,"session owner lease"),sessionRid:readRid(bytes,at),bindingGeneration:nonzero64(bytes,at,"binding generation")};}
 function b3Finish(at:{value:number},bytes:Uint8Array,name:string):void{exactEnd(at,bytes.length,name);}

package/src/runtime/spots/formal-remote-actor-admission-registry.ts

@@ -1,6 +1,6 @@
 import type { ActorRef, RoutingId, ZLinkActor, ZLinkActorJoinOperationId } from '../../contracts';
 import type { ZLinkRemoteBoundSessionTarget } from '../actors/actor-runtime-state';
-import type { ZLinkDeferredJoinAcceptedRoot } from '../actors/deferred-join-accepted-journal';
+import type { ZLinkDeferredJoinCompletion } from '../actors/deferred-join-completion';
 import type { ZLinkActorRequestTerminal } from './spot-actor-packet-dispatch';
 
 const ADMISSION_RETENTION_MS = 30_000;
@@ -57,7 +57,7 @@ export interface ZLinkFormalRemoteActorAdmissionOutcome {
   readonly actorRef: ActorRef;
   readonly reply?: Buffer;
   readonly replyContentType?: string;
-  readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+  readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
 }
 
 export interface ZLinkFormalRemoteActorAdmissionFailure {
@@ -282,9 +282,9 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
       ...(outcome.replyContentType === undefined
         ? {}
         : { replyContentType: outcome.replyContentType }),
-      ...(outcome.deferredJoinRoot === undefined
+      ...(outcome.deferredJoinCompletion === undefined
         ? {}
-        : { deferredJoinRoot: outcome.deferredJoinRoot })
+        : { deferredJoinCompletion: outcome.deferredJoinCompletion })
     };
     entry.resolveResult(entry.result);
     if (!outcome.accepted) {
@@ -314,7 +314,7 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     entry.actor = actor;
   }
 
-  attachDeferredJoinRoot(transferId: string, root: ZLinkDeferredJoinAcceptedRoot): void {
+  attachDeferredJoinCompletion(transferId: string, root: ZLinkDeferredJoinCompletion): void {
     const entry = this.admissions.get(transferId);
     if (
       entry === undefined ||
@@ -325,7 +325,7 @@ export class ZLinkFormalRemoteActorAdmissionRegistry {
     ) {
       throw new Error(`Remote actor admission '${transferId}' cannot attach deferred recovery.`);
     }
-    entry.result = { ...entry.result, deferredJoinRoot: root };
+    entry.result = { ...entry.result, deferredJoinCompletion: root };
   }
 
   abort(transferId: string): void {

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

@@ -1,5 +1,5 @@
 import type { RoutingId, ZLinkActor } from '../../contracts';
-import type { ZLinkDeferredJoinAcceptedRoot } from '../actors';
+import type { ZLinkDeferredJoinCompletion, ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 import { ZLinkStateLane } from '../execution/state-lane';
 
@@ -8,7 +8,9 @@ export interface ZLinkFormalRemoteActorTransfer {
   readonly spotId: RoutingId;
   readonly transferId: string;
   readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
-  readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+  readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
+  /** The Session seal this relocation carries until it publishes command 44. */
+  readonly sealedSession?: ZLinkRemoteBoundSessionTarget;
   readonly targetLifecycleCompleted: Promise<void>;
   readonly sourceLeaveSubmitted: Promise<boolean>;
 }
@@ -43,7 +45,8 @@ export class ZLinkFormalRemoteActorTransferRegistry {
     readonly spotId: RoutingId;
     readonly transferId: string;
     readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
-    readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+    readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
+    readonly sealedSession?: ZLinkRemoteBoundSessionTarget;
   }): ZLinkFormalRemoteActorTransfer {
     const existingByActor = this.transfers.get(input.actor.context.actorId)?.transfer;
     if (existingByActor !== undefined) {