@zlink-systems/framework 0.31.0 → 0.32.1

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

@@ -6,7 +6,7 @@ import { ZLinkBufferMessage as RuntimeMessage } from '../backend/runtime-message
 import type { ZLinkMessageSerializer } from '../../contracts';
 import {
   decodeApplicationPayloadView,
-  encodeApplicationPayload
+  encodeOwnedApplicationPayload
 } from '../foundation/service-wire-m6a-codec';
 import {
   decodeFrameworkPayloadMessage,
@@ -23,7 +23,7 @@ export function encodeFrameworkCreationPayload(
 ): Buffer {
   const message = encodeFrameworkPayloadMessage(payload ?? null, registry);
   try {
-    return encodeApplicationPayload({
+    return encodeOwnedApplicationPayload({
       packetName: CREATION_PACKET_NAME,
       contentType: frameworkPayloadContentType(message),
       payload: message.data()
@@ -42,7 +42,7 @@ export function decodeFrameworkCreationPayload<T>(
     if (application.packetName !== CREATION_PACKET_NAME) {
       throw new RangeError('Creation payload has an unexpected packet name.');
     }
-    // The M6A view decoder returns a Buffer over the retained input storage.
+    // Creation frames use owned storage and stay alive through synchronous decode.
     const message = RuntimeMessage.fromOwned(application.payload as Buffer);
     try {
       return decodeFrameworkPayloadMessage<T>(

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

@@ -5398,7 +5398,7 @@ function writeRelocationControlData(input: RelocationControlData, writer: Writer
 export function decodeRelocationControlData(bytes: Uint8Array, context: ServiceWireDecoderContext): RelocationControlData { const reader = new Reader(bytes); const value = readRelocationControlData(reader, context, {}, 0); reader.done("relocation-control-data"); return value; }
 export function encodeRelocationControlData(value: RelocationControlData, context: ServiceWireDecoderContext): Uint8Array { const writer = new Writer(); writeRelocationControlData(value, writer, context, {}, 0); return writer.result(); }
 
-export type RequestSpecificTail = { readonly originalOperationKind: "actorLookup"; readonly terminalResult: "ok"; readonly actor: ActorRef; readonly spotId: Text8; readonly spotGeneration: NonzeroU64; readonly membershipEpoch: NonzeroU64; readonly authorityOwnerGeneration: NonzeroU64 } | { readonly originalOperationKind: "actorJoin"; readonly terminalResult: "ok"; readonly join: ActorJoinReplyTail } | { readonly originalOperationKind: "streamBind"; readonly terminalResult: "ok"; readonly bindingGeneration: NonzeroU64; readonly authorityOwnerGeneration: NonzeroU64 } | { readonly originalOperationKind: "userSpotCreate"; readonly terminalResult: "ok"; readonly createResult: UserSpotCreateResult; readonly spot: SpotRef } | { readonly originalOperationKind: "userSpotClose"; readonly terminalResult: "ok"; readonly closed: Bool8 } | { readonly originalOperationKind: "actorCreate"; readonly terminalResult: "ok"; readonly creation: ActorCreateTerminal } | { readonly originalOperationKind: MeshOperationKind; readonly terminalResult: RequestTerminalResult };
+export type RequestSpecificTail = { readonly originalOperationKind: "actorLookup"; readonly terminalResult: "ok"; readonly actor: ActorRef; readonly spotId: Text8; readonly spotGeneration: NonzeroU64; readonly membershipEpoch: NonzeroU64; readonly authorityOwnerGeneration: NonzeroU64 } | { readonly originalOperationKind: "actorJoin"; readonly terminalResult: "ok"; readonly join: ActorJoinReplyTail } | { readonly originalOperationKind: "streamBind"; readonly terminalResult: "ok"; readonly bindingGeneration: NonzeroU64; readonly authorityOwnerGeneration: NonzeroU64 } | { readonly originalOperationKind: "streamBind"; readonly terminalResult: "rejected"; readonly rejectionMessage: NonemptyText16 } | { readonly originalOperationKind: "userSpotCreate"; readonly terminalResult: "ok"; readonly createResult: UserSpotCreateResult; readonly spot: SpotRef } | { readonly originalOperationKind: "userSpotClose"; readonly terminalResult: "ok"; readonly closed: Bool8 } | { readonly originalOperationKind: "actorCreate"; readonly terminalResult: "ok"; readonly creation: ActorCreateTerminal } | { readonly originalOperationKind: MeshOperationKind; readonly terminalResult: RequestTerminalResult };
 
 function readRequestSpecificTail(reader: Reader, context: ServiceWireDecoderContext, enclosing: any, flags: number): RequestSpecificTail {
   void context; void enclosing; void flags;
@@ -5433,6 +5433,10 @@ function readRequestSpecificTail(reader: Reader, context: ServiceWireDecoderCont
     value["authorityOwnerGeneration"] = readNonzeroU64(body, context, value, flags);
 
 
+  } else if (same(value["originalOperationKind"], "streamBind") && same(value["terminalResult"], "rejected")) {
+    value["rejectionMessage"] = readNonemptyText16(body, context, value, flags);
+
+
   } else if (same(value["originalOperationKind"], "userSpotCreate") && same(value["terminalResult"], "ok")) {
     value["createResult"] = readUserSpotCreateResult(body, context, value, flags);
 
@@ -5462,7 +5466,7 @@ function writeRequestSpecificTail(input: RequestSpecificTail, writer: Writer, co
 
   const body = writer;
   if (same(value["originalOperationKind"], "actorLookup") && same(value["terminalResult"], "ok")) {
-    if (value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["rejectionMessage"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
     if (value["actor"] === undefined) fail("actor required");
 
 
@@ -5484,13 +5488,13 @@ function writeRequestSpecificTail(input: RequestSpecificTail, writer: Writer, co
 
     writeNonzeroU64(numeric(value["authorityOwnerGeneration"]), body, context, value, flags);
   } else if (same(value["originalOperationKind"], "actorJoin") && same(value["terminalResult"], "ok")) {
-    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["bindingGeneration"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["bindingGeneration"] !== undefined || value["rejectionMessage"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
     if (value["join"] === undefined) fail("join required");
 
 
     writeActorJoinReplyTail(value["join"], body, context, value, flags);
   } else if (same(value["originalOperationKind"], "streamBind") && same(value["terminalResult"], "ok")) {
-    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["join"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["join"] !== undefined || value["rejectionMessage"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
     if (value["bindingGeneration"] === undefined) fail("bindingGeneration required");
 
 
@@ -5499,8 +5503,14 @@ function writeRequestSpecificTail(input: RequestSpecificTail, writer: Writer, co
 
 
     writeNonzeroU64(numeric(value["authorityOwnerGeneration"]), body, context, value, flags);
+  } else if (same(value["originalOperationKind"], "streamBind") && same(value["terminalResult"], "rejected")) {
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["rejectionMessage"] === undefined) fail("rejectionMessage required");
+
+
+    writeNonemptyText16(value["rejectionMessage"], body, context, value, flags);
   } else if (same(value["originalOperationKind"], "userSpotCreate") && same(value["terminalResult"], "ok")) {
-    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["rejectionMessage"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
     if (value["createResult"] === undefined) fail("createResult required");
 
 
@@ -5510,19 +5520,19 @@ function writeRequestSpecificTail(input: RequestSpecificTail, writer: Writer, co
 
     writeSpotRef(value["spot"], body, context, value, flags);
   } else if (same(value["originalOperationKind"], "userSpotClose") && same(value["terminalResult"], "ok")) {
-    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["rejectionMessage"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
     if (value["closed"] === undefined) fail("closed required");
 
 
     writeBool8(value["closed"], body, context, value, flags);
   } else if (same(value["originalOperationKind"], "actorCreate") && same(value["terminalResult"], "ok")) {
-    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["rejectionMessage"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined) fail("request-specific-tail discriminator agreement");
     if (value["creation"] === undefined) fail("creation required");
 
 
     writeActorCreateTerminal(value["creation"], body, context, value, flags);
   } else {
-    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
+    if (value["actor"] !== undefined || value["spotId"] !== undefined || value["spotGeneration"] !== undefined || value["membershipEpoch"] !== undefined || value["authorityOwnerGeneration"] !== undefined || value["join"] !== undefined || value["bindingGeneration"] !== undefined || value["rejectionMessage"] !== undefined || value["createResult"] !== undefined || value["spot"] !== undefined || value["closed"] !== undefined || value["creation"] !== undefined) fail("request-specific-tail discriminator agreement");
 
   }
 

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

@@ -1,4 +1,4 @@
-// <auto-generated> DO NOT EDIT. schema-sha256: 9ccb179e5231ac7a42bfa09ab1b5b9ea942ee17567e0db19023a6cba30c2e044
+// <auto-generated> DO NOT EDIT. schema-sha256: 1a066261b5770782bf4027d3d08723669d4092a085699963afb214872f27d710
 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; }

package/src/runtime/spots/index.ts

@@ -346,14 +346,14 @@ export class DefaultZLinkSpotManager {
   }
 
   private readonly factories: ReadonlySet<Type<ZLinkSpot>>;
-  private readonly activations: ZLinkSpotActivationRegistry;
+  readonly activations: ZLinkSpotActivationRegistry;
   private readonly workerRuntime: ZLinkWorkerRuntime;
   private readonly locationClaim: ZLinkSpotLocationClaim;
   private readonly routedSpotPackets: ZLinkRoutedSpotPacketDispatch;
   private readonly actorMembership: ZLinkSpotActorMembership;
   private readonly activationLifecycle: ZLinkSpotActivationLifecycle;
   private readonly formalRemoteTransfers = new ZLinkFormalRemoteActorTransferRegistry();
-  private readonly formalRemoteActorAdmissions = new ZLinkFormalRemoteActorAdmissionRegistry();
+  readonly formalRemoteActorAdmissions = new ZLinkFormalRemoteActorAdmissionRegistry();
   private readonly pendingInstanceMaterializations = new Map<
     string,
     Promise<ZLinkSpotActivation>
@@ -365,7 +365,7 @@ export class DefaultZLinkSpotManager {
     string,
     Map<string, Promise<ZLinkSpotActivation>>
   >();
-  private readonly closeOperations = new Map<string, ZLinkTargetSpotCloseOperation>();
+  readonly closeOperations = new Map<string, ZLinkTargetSpotCloseOperation>();
   private readonly pendingInstanceTerminals = new Map<string, number>();
   private readonly pendingInstanceTerminalGenerations = new Map<string, Map<string, number>>();
   private readonly deferredInstanceAuthorityReleases = new Map<string, Set<bigint>>();
@@ -1684,6 +1684,30 @@ export class DefaultZLinkSpotManager {
     return this.admitRoutedActorPacketPrefix(owner.spotId, actorId, records);
   }
 
+  /** Runs an owner-side lifecycle decision in the Actor's existing execution gate. */
+  executeActorTurn<T>(
+    meshName: string,
+    spotId: RoutingId | undefined,
+    actorId: string,
+    operation: () => Promise<T>
+  ): Promise<T> {
+    if (spotId === undefined) {
+      if (this.options.executeEntryActor === undefined) {
+        throw new ZLinkConfigurationException(
+          `Entry Spot Actor '${actorId}' has no execution gate for MeshNode '${meshName}'.`
+        );
+      }
+      return this.options.executeEntryActor(meshName, actorId, operation);
+    }
+    const activation = this.resolveApplicationActivation(spotId, meshName);
+    if (activation === undefined) {
+      throw new ZLinkConfigurationException(
+        `Actor '${actorId}' has no active Spot execution gate for '${String(spotId)}'.`
+      );
+    }
+    return activation.executeActor(actorId, operation);
+  }
+
   async dispatchRoutedSpotSend(
     spotId: RoutingId,
     packetName: string | undefined,
@@ -2254,7 +2278,7 @@ export class DefaultZLinkSpotManager {
     }
   }
 
-  private async dispatchMeshActorJoinCore(
+  async dispatchMeshActorJoinCore(
     meshName: string,
     owner: ReadyRecord,
     record: ReceiveRecord,

package/src/runtime/spots/spot-actor-admission-coordinator.ts

@@ -255,7 +255,7 @@ export class ZLinkSpotActorAdmissionCoordinator {
       : this.options.actorResolver(actorId);
   }
 
-  private async commitTransferredActorTransaction(
+  async commitTransferredActorTransaction(
     activation: ZLinkSpotActivation,
     actor: ZLinkActor,
     backlog: readonly ZLinkActorHandoffPacket[],

package/src/runtime/spots/spot-actor-packet-dispatch.ts

@@ -79,6 +79,7 @@ export interface ZLinkActorRequestTerminal {
 /** One admitted Actor packet and the routing context that must move with it. */
 export interface ZLinkActorPacketDelivery {
   readonly origin: ApplicationJobOrigin;
+  readonly receivedAt?: Date;
   readonly actorId: string;
   readonly parts: readonly Message[];
   readonly returnResponse: boolean;
@@ -142,6 +143,7 @@ export class ZLinkSpotActorPacketDispatch {
   ): Promise<unknown> {
     return this.dispatchDelivery(serial, {
       origin,
+      receivedAt: new Date(),
       actorId,
       parts,
       returnResponse,
@@ -168,10 +170,12 @@ export class ZLinkSpotActorPacketDispatch {
       actorId,
       parts,
       returnResponse,
+      receivedAt: deliveryReceivedAt,
       remoteBoundSessionTarget,
       fallbackActorRef,
       requestTerminal
     } = delivery;
+    const receivedAt = deliveryReceivedAt ?? new Date();
     if (parts.length < 2) {
       this.reportInvalidFrame(actorId, ZLinkDispatchMessageKind.ActorSend);
       return { response: undefined };
@@ -298,7 +302,8 @@ export class ZLinkSpotActorPacketDispatch {
             zlinkSerialWorkOptions(
               parts[1].data().byteLength,
               zlinkMetadataByteLength(header.metadata)
-            )
+            ),
+            receivedAt
           )
         };
       }
@@ -375,7 +380,8 @@ export class ZLinkSpotActorPacketDispatch {
     requestTerminal: ZLinkActorRequestTerminal | undefined,
     requestDeadlineUnixMs: number | undefined,
     serial: ZLinkSpotSerialTurnExecutor | undefined,
-    workOptions: ZLinkSerialWorkOptions
+    workOptions: ZLinkSerialWorkOptions,
+    receivedAt: Date
   ): Promise<unknown> {
     const spot = typeof this.options.spot === 'function' ? this.options.spot() : this.options.spot;
     const dispatcher = new ZLinkSpotActorDispatcher({
@@ -415,7 +421,8 @@ export class ZLinkSpotActorPacketDispatch {
         await dispatcher.dispatchSendDecoded(actor, header.name, decodePayload, {
           meshName: spot.context.meshName,
           metadata: zlinkMessageMetadata(header.metadata),
-          correlationId: header.correlationId ?? undefined
+          correlationId: header.correlationId ?? undefined,
+          receivedAt
         });
         this.trace(
           ZLinkMessageFlowOutcome.Completed,
@@ -448,7 +455,8 @@ export class ZLinkSpotActorPacketDispatch {
           {
             meshName: spot.context.meshName,
             metadata: zlinkMessageMetadata(header.metadata),
-            correlationId: header.correlationId ?? header.requestSeq.toString()
+            correlationId: header.correlationId ?? header.requestSeq.toString(),
+            receivedAt
           },
           async (response) => {
             this.trace(
@@ -476,7 +484,8 @@ export class ZLinkSpotActorPacketDispatch {
           {
             meshName: spot.context.meshName,
             metadata: zlinkMessageMetadata(header.metadata),
-            correlationId: header.correlationId ?? header.requestSeq.toString()
+            correlationId: header.correlationId ?? header.requestSeq.toString(),
+            receivedAt
           }
         );
         this.trace(
@@ -494,7 +503,8 @@ export class ZLinkSpotActorPacketDispatch {
         {
           meshName: spot.context.meshName,
           metadata: zlinkMessageMetadata(header.metadata),
-          correlationId: header.correlationId ?? header.requestSeq.toString()
+          correlationId: header.correlationId ?? header.requestSeq.toString(),
+          receivedAt
         },
         async (response, replyOptions) => {
           this.trace(

package/src/runtime/spots/spot-actor-packet-drain.ts

@@ -37,14 +37,16 @@ interface ZLinkSpotActorPacketDrainOptions {
   ) => void;
   readonly waitIdle: () => Promise<void>;
   readonly flowEnabled?: () => boolean;
+  readonly receivedAtClock?: () => Date;
 }
 
 const ZLINK_SPOT_ACTOR_RECV_INFO_NO_BIND = 1;
+const systemReceivedAtClock = (): Date => new Date();
 
 export class ZLinkSpotActorPacketDrain {
   private readonly continuations = new Map<
     string,
-    { readonly owner: string; readonly parts: Message[] }
+    { readonly owner: string; readonly parts: Message[]; readonly receivedAt: Date }
   >();
 
   constructor(private readonly options: ZLinkSpotActorPacketDrainOptions) {}
@@ -60,6 +62,7 @@ export class ZLinkSpotActorPacketDrain {
     let requestId: bigint | undefined;
     let flags: number | undefined;
     let packetKey: string | undefined;
+    let receivedAt: Date | undefined;
     try {
       for (;;) {
         const part = info.recvActorPart(ZLINK_RECV_DONT_WAIT);
@@ -67,7 +70,8 @@ export class ZLinkSpotActorPacketDrain {
           if (parts.length > 0 && packetKey !== undefined) {
             this.continuations.set(packetKey, {
               owner: continuationOwner(parts[0], this.flowEnabled()),
-              parts: parts.splice(0)
+              parts: parts.splice(0),
+              receivedAt: receivedAt ?? (this.options.receivedAtClock ?? systemReceivedAtClock)()
             });
             return;
           }
@@ -78,6 +82,8 @@ export class ZLinkSpotActorPacketDrain {
         if (packetKey === undefined) {
           packetKey = currentPacketKey;
           const pending = this.continuations.get(currentPacketKey);
+          receivedAt =
+            pending?.receivedAt ?? (this.options.receivedAtClock ?? systemReceivedAtClock)();
           if (pending !== undefined) {
             if (isStreamHeaderMessage(part.message, this.flowEnabled())) {
               closeMessages(pending.parts);
@@ -125,7 +131,13 @@ export class ZLinkSpotActorPacketDrain {
         return;
       }
       if (noBindInfo !== undefined) {
-        await this.dispatchNoBindActorRequest(noBindInfo, actorId, parts, actorRef);
+        await this.dispatchNoBindActorRequest(
+          noBindInfo,
+          actorId,
+          parts,
+          actorRef,
+          receivedAt ?? (this.options.receivedAtClock ?? systemReceivedAtClock)()
+        );
       } else {
         await this.options.actorPacketHandler({
           origin: 'remote',
@@ -133,7 +145,8 @@ export class ZLinkSpotActorPacketDrain {
           parts,
           returnResponse: false,
           sourceSessionRid,
-          fallbackActorRef: actorRef as unknown as ActorRef | undefined
+          fallbackActorRef: actorRef as unknown as ActorRef | undefined,
+          receivedAt
         });
       }
     } finally {
@@ -188,7 +201,8 @@ export class ZLinkSpotActorPacketDrain {
     info: ZLinkBackendActorRecvInfo,
     actorId: string,
     parts: readonly Message[],
-    actorRef: ZLinkBackendActorRef | undefined
+    actorRef: ZLinkBackendActorRef | undefined,
+    receivedAt: Date
   ): Promise<void> {
     try {
       const response = await this.options.actorPacketHandler?.({
@@ -197,7 +211,8 @@ export class ZLinkSpotActorPacketDrain {
         parts,
         returnResponse: true,
         sourceSessionRid: info.sourceSessionRid,
-        fallbackActorRef: actorRef as unknown as ActorRef | undefined
+        fallbackActorRef: actorRef as unknown as ActorRef | undefined,
+        receivedAt
       });
       this.options.replyActorNoBind?.(
         info,

package/src/runtime/spots/spot-entry-activation.ts

@@ -105,7 +105,7 @@ interface ZLinkEntrySpotActivationOptions {
 
 export class ZLinkEntrySpotActivation {
   private readonly serial: ZLinkSpotSerialTurnExecutor;
-  private readonly spotSerialExecutor: ZLinkSpotSerialExecutor;
+  readonly spotSerialExecutor: ZLinkSpotSerialExecutor;
   private readonly timers: ZLinkSpotTimerRegistry;
   private readonly actorHandlers = new ZLinkSpotActorHandlerRegistryRuntime();
   private readonly handlers: DefaultZLinkSpotHandlerRegistry;

package/src/runtime/spots/spot-node-runtime-manager.ts

@@ -158,10 +158,10 @@ export interface ZLinkSpotNodeRuntimeManagerOptions {
 }
 
 export class ZLinkSpotNodeRuntimeManager {
-  private readonly meshNodes = new Map<string, ZLinkBackendMeshNode>();
+  readonly meshNodes = new Map<string, ZLinkBackendMeshNode>();
   private readonly meshPumps = new Map<string, ZLinkMeshDispatchPump>();
   private readonly meshCompletions = new Map<string, ZLinkMeshCompletionTable>();
-  private readonly entryActivations = new Map<string, ZLinkEntrySpotActivation>();
+  readonly entryActivations = new Map<string, ZLinkEntrySpotActivation>();
   private readonly entryActivationStarts = new Map<string, Promise<void>>();
   private readonly publishers = new Map<
     string,
@@ -179,11 +179,11 @@ export class ZLinkSpotNodeRuntimeManager {
   private readonly runtimeChannelWeights = new Map<string, Map<string, number>>();
   private readonly entrySpotIds = new Map<string, string>();
   private runtimeWeightPublication = Promise.resolve();
-  private statePublication = Promise.resolve();
-  private locationAutoConnect?: ZLinkSpotNodeLocationAutoConnectContext;
+  statePublication = Promise.resolve();
+  locationAutoConnect?: ZLinkSpotNodeLocationAutoConnectContext;
   private readonly applicationJobQueue: ApplicationJobQueue;
 
-  constructor(private readonly options: ZLinkSpotNodeRuntimeManagerOptions) {
+  constructor(readonly options: ZLinkSpotNodeRuntimeManagerOptions) {
     if ((options.detachedTaskRunner as unknown) === undefined) {
       throw new ZLinkConfigurationException('Spot node runtime requires a detached task runner.');
     }
@@ -304,6 +304,8 @@ export class ZLinkSpotNodeRuntimeManager {
       const node = meshAdapter.createMeshNode(this.options.context, {
         meshName: spotNodeName,
         routingId,
+        sendHighWaterMark: spotNode.router?.sendHighWaterMark,
+        receiveHighWaterMark: spotNode.router?.receiveHighWaterMark,
         receiveTimeoutMs: spotNode.router?.receiveTimeoutMs,
         applicationJobQueue: this.applicationJobQueue,
         infrastructureTaskRunner: this.options.detachedTaskRunner,
@@ -1089,7 +1091,7 @@ export class ZLinkSpotNodeRuntimeManager {
     }
   }
 
-  private async initializeEntrySpot(
+  async initializeEntrySpot(
     spotNodeName: string,
     node: ZLinkBackendMeshNode,
     spotNode: ZLinkSpotNodeOptions

package/src/runtime/spots/spot-route-packet-dispatch.ts

@@ -79,9 +79,10 @@ export class ZLinkSpotRoutePacketDispatch {
   constructor(private readonly options: ZLinkSpotRoutePacketDispatchOptions) {}
 
   async dispatch(received: BackendReceived): Promise<boolean> {
+    const receivedAt = new Date();
     const directEnvelope = decodeSpotDirectEnvelope(received.parts);
     if (directEnvelope !== undefined) {
-      await this.dispatchSpotDirectEnvelope(received, directEnvelope);
+      await this.dispatchSpotDirectEnvelope(received, directEnvelope, receivedAt);
       return true;
     }
     let envelope: ReturnType<typeof decodeChannelEnvelope>;
@@ -148,7 +149,8 @@ export class ZLinkSpotRoutePacketDispatch {
       contentType: envelope.header.contentType,
       packetName: envelope.packetName!,
       metadata: zlinkMessageMetadata(envelope.header.metadata),
-      correlationId: envelope.header.correlationId ?? undefined
+      correlationId: envelope.header.correlationId ?? undefined,
+      receivedAt
     };
     try {
       let response: unknown;
@@ -245,7 +247,8 @@ export class ZLinkSpotRoutePacketDispatch {
 
   private async dispatchSpotDirectEnvelope(
     received: BackendReceived,
-    envelope: ZLinkSpotDirectEnvelope
+    envelope: ZLinkSpotDirectEnvelope,
+    receivedAt: Date
   ): Promise<void> {
     const replyable =
       envelope.kind === ZLinkChannelMessageKind.Request && hasReplyToken(received.replyToken);
@@ -296,7 +299,8 @@ export class ZLinkSpotRoutePacketDispatch {
               channelName: envelope.channelName,
               packetName: envelope.packetName!,
               metadata: zlinkMessageMetadata(envelope.metadata),
-              correlationId: undefined
+              correlationId: undefined,
+              receivedAt
             };
             releaseApplicationJobPermitBeforeHandler();
             response = await handler.handle(spot, envelope.payload, handlerContext);

package/src/runtime/spots/spot-routed-spot-packet-dispatch.ts

@@ -109,6 +109,7 @@ export class ZLinkRoutedSpotPacketDispatch {
     context: ZLinkRoutedSpotPacketContext,
     returnResponse: boolean
   ): Promise<unknown> {
+    const receivedAt = new Date();
     const activation = this.options.resolveActivation(spotId);
     if (activation === undefined) {
       this.reportMissing(spotId, packetName, context, returnResponse);
@@ -210,7 +211,8 @@ export class ZLinkRoutedSpotPacketDispatch {
             channelName: context.channelName,
             contentType: context.contentType,
             packetName: packetName!,
-            metadata: zlinkMessageMetadata({})
+            metadata: zlinkMessageMetadata({}),
+            receivedAt
           };
           releaseApplicationJobPermitBeforeHandler();
           response = await handler.handle(current.spot, payload, handlerContext);

package/src/runtime/spots/spot-serial-executor.ts

@@ -28,7 +28,7 @@ export type ZLinkActorPacketTurnDispatch = (
 export class ZLinkSpotSerialExecutor {
   private readonly actorSerials = new Map<string, ZLinkSpotSerialTurnExecutor>();
   private readonly timerSerials = new Map<string, ZLinkSpotSerialTurnExecutor>();
-  private readonly actorExecutors = new Map<string, ZLinkActorSerialExecutor>();
+  readonly actorExecutors = new Map<string, ZLinkActorSerialExecutor>();
   private executionBarrier: ZLinkExecutionBarrier | undefined;
   private closing = false;
   private closePromise: Promise<void> | undefined;

package/src/runtime/spots/spot-subscription-dispatch.ts

@@ -133,6 +133,7 @@ export class ZLinkSpotSubscriptionDispatch {
     readonly parts: readonly Message[];
     readonly routingId: RoutingId | unknown | null;
   }): Promise<void> {
+    const receivedAt = new Date();
     if (message.parts.length === 0) {
       this.options.dispatchErrors?.report({
         surface: ZLinkDispatchErrorSurface.SpotSubscription,
@@ -213,7 +214,8 @@ export class ZLinkSpotSubscriptionDispatch {
                   topic: message.topic,
                   source: subSource,
                   metadata: zlinkMessageMetadata(envelope.header.metadata),
-                  correlationId: envelope.header.correlationId ?? undefined
+                  correlationId: envelope.header.correlationId ?? undefined,
+                  receivedAt
                 });
               } catch (error) {
                 this.options.dispatchErrors?.report({

package/src/runtime/spots/spot-timer.ts

@@ -522,7 +522,7 @@ export class ZLinkManagedTimer implements ZLinkTimer {
   private pendingScheduledIndex: bigint | undefined;
   private timeout: unknown;
   /** The dispatch in flight, from its timer callback until `completeFireCore`. */
-  private running: Promise<void> | undefined;
+  running: Promise<void> | undefined;
   private dispatchFailure: { readonly cause: unknown } | undefined;
   private finalization: ZLinkTimerFinalization | undefined;
 

package/src/runtime/streams/actor-session-binding-registry.ts

@@ -1,3 +1,4 @@
+import { ZLinkStreamHeaderFlags, type ZLinkStreamFrameHeader } from './protocol';
 import {
   ZLinkFrameworkErrorKind,
   ZLinkFrameworkException
@@ -153,9 +154,9 @@ export class ZLinkActorSessionBindingRegistry<
   TContext extends ZLinkActorSessionBindingContext<TActor>,
   TActor extends ZLinkActorSessionBindingActor
 > {
-  private readonly lane = new ZLinkStateLane();
+  readonly lane = new ZLinkStateLane();
   private readonly routes = new Map<string, ZLinkActorSessionRoute<TContext, TActor>>();
-  private readonly nextActorSlots = new WeakMap<TContext, number>();
+  readonly nextActorSlots = new WeakMap<TContext, number>();
   private readonly sealWaiters = new Map<
     string,
     Set<{
@@ -166,7 +167,7 @@ export class ZLinkActorSessionBindingRegistry<
   >();
   private readonly activeFrameWaiters = new Map<string, Set<ZLinkActorSessionActiveFrameWaiter>>();
   private readonly relocations = new Map<string, ZLinkActorSessionRelocationQueue>();
-  private readonly absentSessionRelocationResults = new Map<
+  readonly absentSessionRelocationResults = new Map<
     string,
     {
       readonly result: SessionRelocationResult;
@@ -409,6 +410,32 @@ export class ZLinkActorSessionBindingRegistry<
     return await this.lane.run(() => this.routeCore(actorId));
   }
 
+  async submitReply<T>(
+    context: TContext,
+    header: ZLinkStreamFrameHeader,
+    submit: (header: ZLinkStreamFrameHeader) => Promise<T>
+  ): Promise<T> {
+    const { submission } = await this.lane.run(() => {
+      const current =
+        header.actorSlot === undefined ||
+        [...this.routes.values()].some(
+          (route) => route.context === context && route.actorSlot === header.actorSlot
+        );
+      return {
+        submission: submit(
+          current
+            ? header
+            : {
+                ...header,
+                actorSlot: undefined,
+                flags: header.flags & ~ZLinkStreamHeaderFlags.HasActorSlot
+              }
+        )
+      };
+    });
+    return await submission;
+  }
+
   /** Registers a current binding's frame in the same turn that can retire its slot. */
   async submitCurrent<T>(
     actorId: string,