@zlink-systems/framework 0.21.0 → 0.22.0

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

@@ -14,9 +14,7 @@ import {
   ZLinkDispatchMessageKind
 } from '../../contracts/Dispatch/ZLinkDispatchOptions';
 import { ZLinkBufferMessage as RuntimeMessage } from '../backend/runtime-message';
-import type {
-  ZLinkBackendReceived as BackendReceived
-} from '../backend/runtime-values';
+import type { ZLinkBackendReceived as BackendReceived } from '../backend/runtime-values';
 import type { Message } from '../../contracts/Common/Message';
 import type { ZLinkDispatchErrorReporter } from '../channels';
 import {
@@ -41,11 +39,7 @@ import type { ZLinkSpotSerialTurnExecutor } from './spot-serial-turn-executor';
 import type { ZLinkApplicationWorkClaim } from '../admission';
 import { zlinkMetadataByteLength, zlinkSerialWorkOptions } from '../execution/serial-work-size';
 import { REMOTE_ACTOR_JOIN_PACKET } from './spot-remote-codec';
-import {
-  appendRouteReplyParts,
-  hasReplyToken,
-  submitRouteReply
-} from './spot-route-replies';
+import { appendRouteReplyParts, hasReplyToken, submitRouteReply } from './spot-route-replies';
 import { createInboundFlow, runWithFlow } from '../diagnostics/flow-context';
 import {
   ZLinkFrameworkInternalErrorKind,
@@ -115,9 +109,7 @@ export class ZLinkSpotRoutePacketDispatch {
     }
     const registrations = this.options.packetHandlers.get(envelope.packetName ?? '');
     const replyable = hasReplyToken(received.replyToken);
-    const action = replyable
-      ? ZLinkDispatchErrorAction.ReplyError
-      : ZLinkDispatchErrorAction.Drop;
+    const action = replyable ? ZLinkDispatchErrorAction.ReplyError : ZLinkDispatchErrorAction.Drop;
     if (registrations === undefined || registrations.length === 0) {
       this.options.dispatchErrors?.report({
         surface: ZLinkDispatchErrorSurface.SpotRoute,
@@ -136,14 +128,16 @@ export class ZLinkSpotRoutePacketDispatch {
         // D5: this error is generated by the framework itself, so the reply
         // carries the framework-origin marker (never set for application
         // handler failures).
-        submitRouteReply(appendRouteReplyParts(
-          received.reply(),
-          encodeChannelErrorReplyParts(
-            envelope.header,
-            `SPOT route handler not found: ${envelope.packetName}`,
-            FRAMEWORK_ORIGIN_REPLY_METADATA
+        submitRouteReply(
+          appendRouteReplyParts(
+            received.reply(),
+            encodeChannelErrorReplyParts(
+              envelope.header,
+              `SPOT route handler not found: ${envelope.packetName}`,
+              FRAMEWORK_ORIGIN_REPLY_METADATA
+            )
           )
-        ));
+        );
       }
       return true;
     }
@@ -158,43 +152,55 @@ export class ZLinkSpotRoutePacketDispatch {
       let response: unknown;
       const applicationClaim = this.options.claimApplicationWork?.();
       try {
-        await runWithFlow(createInboundFlow(
-          envelope.header.flowId,
-          envelope.header.flowOrigin,
-          this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true
-        ), () =>
-          this.options.serial.execute(async () => {
-            const spot = this.options.getTarget();
-            // Keep the wire payload raw until this Spot has acquired its
-            // execution authority. A rejected or superseded work item must not
-            // pay the deserialization cost.
-            const payload = decodeChannelPayload(envelope, this.channelCodecs());
-            for (const registration of registrations) {
-              const handler = await resolveLifecycleHandler(
-                spot,
-                registration.handlerType as Type<ZLinkSpotPacketHandler<ZLinkSpot, unknown> | ZLinkSpotRequestHandler<ZLinkSpot, unknown, unknown>>,
-                this.options.providerResolver
-              );
-              releaseApplicationJobPermitBeforeHandler();
-              response = await handler.handle(spot, payload, context);
-            }
-          }, zlinkSerialWorkOptions(
-            envelope.payload.byteLength,
-            zlinkMetadataByteLength(envelope.header.metadata)
-          )));
+        await runWithFlow(
+          createInboundFlow(
+            envelope.header.flowId,
+            envelope.header.flowOrigin,
+            this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true
+          ),
+          () =>
+            this.options.serial.execute(
+              async () => {
+                const spot = this.options.getTarget();
+                // Keep the wire payload raw until this Spot has acquired its
+                // execution authority. A rejected or superseded work item must not
+                // pay the deserialization cost.
+                const payload = decodeChannelPayload(envelope, this.channelCodecs());
+                for (const registration of registrations) {
+                  const handler = await resolveLifecycleHandler(
+                    spot,
+                    registration.handlerType as Type<
+                      | ZLinkSpotPacketHandler<ZLinkSpot, unknown>
+                      | ZLinkSpotRequestHandler<ZLinkSpot, unknown, unknown>
+                    >,
+                    this.options.providerResolver
+                  );
+                  releaseApplicationJobPermitBeforeHandler();
+                  response = await handler.handle(spot, payload, context);
+                }
+              },
+              zlinkSerialWorkOptions(
+                envelope.payload.byteLength,
+                zlinkMetadataByteLength(envelope.header.metadata)
+              )
+            )
+        );
       } finally {
         applicationClaim?.close();
       }
       if (replyable) {
-        submitRouteReply(appendRouteReplyParts(
-          received.reply(),
-          encodeChannelReplyParts(envelope.header, response)
-        ));
+        submitRouteReply(
+          appendRouteReplyParts(
+            received.reply(),
+            encodeChannelReplyParts(envelope.header, response)
+          )
+        );
       }
       return true;
     } catch (error) {
-      const payloadDecodeFailed = error instanceof ZLinkFrameworkException
-        && internalFrameworkErrorKind(error) === ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed;
+      const payloadDecodeFailed =
+        error instanceof ZLinkFrameworkException &&
+        internalFrameworkErrorKind(error) === ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed;
       this.options.dispatchErrors?.report({
         surface: ZLinkDispatchErrorSurface.SpotRoute,
         messageKind: replyable ? ZLinkDispatchMessageKind.Request : ZLinkDispatchMessageKind.Send,
@@ -215,14 +221,16 @@ export class ZLinkSpotRoutePacketDispatch {
         // D5: only a decode failure created by the framework's own payload
         // decoding carries the framework-origin marker; application handler
         // failures never do.
-        submitRouteReply(appendRouteReplyParts(
-          received.reply(),
-          encodeChannelErrorReplyParts(
-            envelope.header,
-            error,
-            payloadDecodeFailed ? FRAMEWORK_ORIGIN_REPLY_METADATA : undefined
+        submitRouteReply(
+          appendRouteReplyParts(
+            received.reply(),
+            encodeChannelErrorReplyParts(
+              envelope.header,
+              error,
+              payloadDecodeFailed ? FRAMEWORK_ORIGIN_REPLY_METADATA : undefined
+            )
           )
-        ));
+        );
       }
       return true;
     }
@@ -232,8 +240,11 @@ export class ZLinkSpotRoutePacketDispatch {
     received: BackendReceived,
     envelope: ZLinkSpotDirectEnvelope
   ): Promise<void> {
-    const replyable = envelope.kind === ZLinkChannelMessageKind.Request && hasReplyToken(received.replyToken);
-    const messageKind = replyable ? ZLinkDispatchMessageKind.Request : ZLinkDispatchMessageKind.Send;
+    const replyable =
+      envelope.kind === ZLinkChannelMessageKind.Request && hasReplyToken(received.replyToken);
+    const messageKind = replyable
+      ? ZLinkDispatchMessageKind.Request
+      : ZLinkDispatchMessageKind.Send;
     const action = replyable ? ZLinkDispatchErrorAction.ReplyError : ZLinkDispatchErrorAction.Drop;
     const registrations = this.options.packetHandlers.get(envelope.packetName ?? '');
     if (registrations === undefined || registrations.length === 0) {
@@ -247,39 +258,49 @@ export class ZLinkSpotRoutePacketDispatch {
       });
       if (replyable) {
         submitRouteReply(
-          received.reply()
-            .message(encodeSpotDirectReply(false, undefined, `SPOT route handler not found: ${envelope.packetName}`))
+          received
+            .reply()
+            .message(
+              encodeSpotDirectReply(
+                false,
+                undefined,
+                `SPOT route handler not found: ${envelope.packetName}`
+              )
+            )
         );
       }
       return;
     }
     try {
       let response: unknown;
-      await this.options.serial.execute(async () => {
-        const spot = this.options.getTarget();
-        for (const registration of registrations) {
-          const handler = await resolveLifecycleHandler(
-            spot,
-            registration.handlerType as Type<ZLinkSpotPacketHandler<ZLinkSpot, unknown> | ZLinkSpotRequestHandler<ZLinkSpot, unknown, unknown>>,
-            this.options.providerResolver
-          );
-          releaseApplicationJobPermitBeforeHandler();
-          response = await handler.handle(spot, envelope.payload, {
-            channelName: envelope.channelName,
-            packetName: envelope.packetName!,
-            metadata: zlinkMessageMetadata(envelope.metadata),
-            correlationId: undefined
-          });
-        }
-      }, zlinkSerialWorkOptions(
-        received.parts[0]?.size() ?? 0,
-        zlinkMetadataByteLength(envelope.metadata)
-      ));
+      await this.options.serial.execute(
+        async () => {
+          const spot = this.options.getTarget();
+          for (const registration of registrations) {
+            const handler = await resolveLifecycleHandler(
+              spot,
+              registration.handlerType as Type<
+                | ZLinkSpotPacketHandler<ZLinkSpot, unknown>
+                | ZLinkSpotRequestHandler<ZLinkSpot, unknown, unknown>
+              >,
+              this.options.providerResolver
+            );
+            releaseApplicationJobPermitBeforeHandler();
+            response = await handler.handle(spot, envelope.payload, {
+              channelName: envelope.channelName,
+              packetName: envelope.packetName!,
+              metadata: zlinkMessageMetadata(envelope.metadata),
+              correlationId: undefined
+            });
+          }
+        },
+        zlinkSerialWorkOptions(
+          received.parts[0]?.size() ?? 0,
+          zlinkMetadataByteLength(envelope.metadata)
+        )
+      );
       if (replyable) {
-        submitRouteReply(
-          received.reply()
-            .message(encodeSpotDirectReply(true, response))
-        );
+        submitRouteReply(received.reply().message(encodeSpotDirectReply(true, response)));
       }
     } catch (error) {
       this.options.dispatchErrors?.report({
@@ -293,8 +314,15 @@ export class ZLinkSpotRoutePacketDispatch {
       });
       if (replyable) {
         submitRouteReply(
-          received.reply()
-            .message(encodeSpotDirectReply(false, undefined, error instanceof Error ? error.message : String(error)))
+          received
+            .reply()
+            .message(
+              encodeSpotDirectReply(
+                false,
+                undefined,
+                error instanceof Error ? error.message : String(error)
+              )
+            )
         );
         return;
       }
@@ -324,16 +352,17 @@ function decodeSpotDirectEnvelope(parts: readonly Message[]): ZLinkSpotDirectEnv
     };
     if (
       decoded.marker !== SPOT_DIRECT_ENVELOPE ||
-      (decoded.kind !== ZLinkChannelMessageKind.Request && decoded.kind !== ZLinkChannelMessageKind.Command) ||
+      (decoded.kind !== ZLinkChannelMessageKind.Request &&
+        decoded.kind !== ZLinkChannelMessageKind.Command) ||
       typeof decoded.channelName !== 'string'
     ) {
       return undefined;
     }
     const metadata = decoded.metadata ?? {};
     if (
-      typeof metadata !== 'object'
-      || Array.isArray(metadata)
-      || !Object.values(metadata).every(value => typeof value === 'string')
+      typeof metadata !== 'object' ||
+      Array.isArray(metadata) ||
+      !Object.values(metadata).every((value) => typeof value === 'string')
     ) {
       return undefined;
     }
@@ -350,10 +379,14 @@ function decodeSpotDirectEnvelope(parts: readonly Message[]): ZLinkSpotDirectEnv
 }
 
 function encodeSpotDirectReply(ok: boolean, response?: unknown, error?: string): Message {
-  return RuntimeMessage.fromOwned(Buffer.from(JSON.stringify({
-    marker: SPOT_DIRECT_ENVELOPE,
-    ok,
-    response,
-    error
-  })));
+  return RuntimeMessage.fromOwned(
+    Buffer.from(
+      JSON.stringify({
+        marker: SPOT_DIRECT_ENVELOPE,
+        ok,
+        response,
+        error
+      })
+    )
+  );
 }

package/src/runtime/spots/spot-route-replies.ts

@@ -34,15 +34,11 @@ export function submitRoutePayloadReply(
   payload: unknown
 ): boolean {
   if (envelope === undefined) {
-    return submitRouteReply(
-      received.reply()
-        .message(Buffer.from(JSON.stringify(payload)))
-    );
+    return submitRouteReply(received.reply().message(Buffer.from(JSON.stringify(payload))));
   }
-  return submitRouteReply(appendRouteReplyParts(
-    received.reply(),
-    encodeChannelReplyParts(envelope.header, payload)
-  ));
+  return submitRouteReply(
+    appendRouteReplyParts(received.reply(), encodeChannelReplyParts(envelope.header, payload))
+  );
 }
 
 export function submitSpotRouteBridgeReply(
@@ -59,15 +55,14 @@ export function submitRoutedActorJoinReply(
   payload: unknown
 ): boolean {
   if (decoded.raw) {
-    return submitRouteReply(
-      received.reply()
-        .message(Buffer.from(JSON.stringify(payload)))
-    );
+    return submitRouteReply(received.reply().message(Buffer.from(JSON.stringify(payload))));
   }
-  return submitRouteReply(appendRouteReplyParts(
-    received.reply(),
-    encodeChannelReplyParts(requireRoutedActorJoinEnvelope(decoded).header, payload)
-  ));
+  return submitRouteReply(
+    appendRouteReplyParts(
+      received.reply(),
+      encodeChannelReplyParts(requireRoutedActorJoinEnvelope(decoded).header, payload)
+    )
+  );
 }
 
 export function submitRoutedActorJoinError(
@@ -83,13 +78,15 @@ export function submitRoutedActorJoinError(
       actorGeneration: '0'
     });
   }
-  return submitRouteReply(appendRouteReplyParts(
-    received.reply(),
-    encodeChannelErrorReplyParts(
-      requireRoutedActorJoinEnvelope(decoded).header,
-      error instanceof Error ? error.message : String(error)
+  return submitRouteReply(
+    appendRouteReplyParts(
+      received.reply(),
+      encodeChannelErrorReplyParts(
+        requireRoutedActorJoinEnvelope(decoded).header,
+        error instanceof Error ? error.message : String(error)
+      )
     )
-  ));
+  );
 }
 
 export function appendRouteReplyParts(
@@ -120,7 +117,9 @@ function requireRoutedActorJoinEnvelope(
 }
 
 function isNativeBadAddress(error: unknown): boolean {
-  return typeof error === 'object' &&
+  return (
+    typeof error === 'object' &&
     error !== null &&
-    Number((error as { nativeErrno?: unknown }).nativeErrno) === 14;
+    Number((error as { nativeErrno?: unknown }).nativeErrno) === 14
+  );
 }

package/src/runtime/spots/spot-route-reply-wire.ts

@@ -9,7 +9,8 @@ export interface ZLinkSpotRouteBridgeReplyPayload {
   readonly actorPacketTarget?: ZLinkRemoteActorPacketTargetWire;
 }
 
-export function encodeSpotRouteBridgeReply(payload: ZLinkSpotRouteBridgeReplyPayload): ZLinkSpotRouteBridgeReplyPayload {
+export function encodeSpotRouteBridgeReply(
+  payload: ZLinkSpotRouteBridgeReplyPayload
+): ZLinkSpotRouteBridgeReplyPayload {
   return payload;
 }
-

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

@@ -26,10 +26,7 @@ import {
   type ZLinkRoutedActorTransferProvider,
   type ZLinkRemoteActorJoinWirePayload
 } from './spot-remote-codec';
-import {
-  submitRoutedActorJoinError,
-  submitRoutedActorJoinReply
-} from './spot-route-replies';
+import { submitRoutedActorJoinError, submitRoutedActorJoinReply } from './spot-route-replies';
 import type { ZLinkSpotSerialTurnExecutor } from './spot-serial-turn-executor';
 import type { ZLinkActorHandoffPacket, ZLinkActorHandoffResult } from '../actors/actor-handoff';
 
@@ -107,8 +104,9 @@ export class ZLinkSpotRoutedActorAdmission {
       const existing = this.pending.get(decoded.transferId);
       if (existing !== undefined) {
         this.requireMatchingTransfer(existing, decoded);
-        const reply = existing.admissionReply ?? await existing.admissionTask;
-        if (reply === undefined) throw new Error(`Remote actor transfer '${decoded.transferId}' has no admission result.`);
+        const reply = existing.admissionReply ?? (await existing.admissionTask);
+        if (reply === undefined)
+          throw new Error(`Remote actor transfer '${decoded.transferId}' has no admission result.`);
         submitRoutedActorJoinReply(received, decoded, reply);
         return;
       }
@@ -138,8 +136,14 @@ export class ZLinkSpotRoutedActorAdmission {
         throw new Error('Remote actor transfer commit requires a transfer id.');
       }
       const pending = this.pending.get(transferId);
-      if (pending === undefined || pending.actorId !== decoded.actorId || pending.actorType !== decoded.actorType) {
-        throw new Error(`Remote actor transfer '${transferId}' does not have a matching admission.`);
+      if (
+        pending === undefined ||
+        pending.actorId !== decoded.actorId ||
+        pending.actorType !== decoded.actorType
+      ) {
+        throw new Error(
+          `Remote actor transfer '${transferId}' does not have a matching admission.`
+        );
       }
       if (pending.phase === 'rejected') {
         throw new Error(`Remote actor transfer '${transferId}' admission was rejected.`);
@@ -152,7 +156,7 @@ export class ZLinkSpotRoutedActorAdmission {
         if (pending.deadline !== undefined) clearTimeout(pending.deadline);
         pending.commitTask = this.evaluateCommit(decoded, transferId, pending);
       }
-      const commitReply = pending.commitReply ?? await pending.commitTask;
+      const commitReply = pending.commitReply ?? (await pending.commitTask);
       submitRoutedActorJoinReply(received, decoded, commitReply);
     } catch (error) {
       submitRoutedActorJoinError(received, decoded, error);
@@ -167,15 +171,17 @@ export class ZLinkSpotRoutedActorAdmission {
   ): Promise<Record<string, unknown>> {
     try {
       const response = await this.runJoinCallback(decoded, decoded.request);
-      const reply = response.reply === undefined
-        ? undefined
-        : encodeFrameworkPayloadMessage(response.reply, this.options.messageSerializers);
+      const reply =
+        response.reply === undefined
+          ? undefined
+          : encodeFrameworkPayloadMessage(response.reply, this.options.messageSerializers);
       try {
         const actorRef = decoded.actorRef;
         const admissionReply = {
           accepted: response.accepted,
           actorNodeRid: String(actorRef?.nodeRid ?? ''),
-          actorNodeRidHex: actorRef?.nodeRid === undefined ? undefined : encodeRoutingIdHex(actorRef.nodeRid),
+          actorNodeRidHex:
+            actorRef?.nodeRid === undefined ? undefined : encodeRoutingIdHex(actorRef.nodeRid),
           actorId: decoded.actorId,
           actorGeneration: (actorRef?.generation ?? 0n).toString(),
           reply: reply?.data().toString('base64')
@@ -199,7 +205,10 @@ export class ZLinkSpotRoutedActorAdmission {
     pending: ZLinkPendingRoutedActorTransfer
   ): Promise<Record<string, unknown>> {
     try {
-      if (decoded.transferState === undefined || this.options.routedActorTransferProvider === undefined) {
+      if (
+        decoded.transferState === undefined ||
+        this.options.routedActorTransferProvider === undefined
+      ) {
         throw new Error('Remote actor transfer commit cannot materialize the target actor.');
       }
       const { actor, actorRef } = await this.options.routedActorTransferProvider(
@@ -210,7 +219,8 @@ export class ZLinkSpotRoutedActorAdmission {
         decoded.actorEntryNodeRid,
         decoded.remoteBoundSessionTarget
       );
-      const handoffResults = await this.options.commitTransferredActor?.(actor, decoded.handoffBacklog) ?? [];
+      const handoffResults =
+        (await this.options.commitTransferredActor?.(actor, decoded.handoffBacklog)) ?? [];
       const commitReply = {
         accepted: true,
         actorNodeRid: String(actorRef.nodeRid),
@@ -258,18 +268,17 @@ export class ZLinkSpotRoutedActorAdmission {
     decoded: ZLinkDecodedRemoteActorJoinRequest
   ): void {
     if (pending.actorId !== decoded.actorId || pending.actorType !== decoded.actorType) {
-      throw new Error(`Remote actor transfer '${decoded.transferId}' identity does not match its first request.`);
+      throw new Error(
+        `Remote actor transfer '${decoded.transferId}' identity does not match its first request.`
+      );
     }
   }
 
   private scheduleExpiration(transferId: string, pending: ZLinkPendingRoutedActorTransfer): void {
     if (pending.deadline !== undefined) clearTimeout(pending.deadline);
-    pending.deadline = setTimeout(
-      () => {
-        if (this.pending.get(transferId) === pending) this.pending.delete(transferId);
-      },
-      this.options.pendingAdmissionTimeoutMs ?? 30_000
-    );
+    pending.deadline = setTimeout(() => {
+      if (this.pending.get(transferId) === pending) this.pending.delete(transferId);
+    }, this.options.pendingAdmissionTimeoutMs ?? 30_000);
     pending.deadline.unref();
   }
 
@@ -289,10 +298,7 @@ export class ZLinkSpotRoutedActorAdmission {
       }
       try {
         const payload = JSON.parse(parts[0].data().toString()) as ZLinkRemoteActorJoinWirePayload;
-        if (
-          payload.packetName !== REMOTE_ACTOR_JOIN_PACKET ||
-          !isRemoteActorJoinPayload(payload)
-        ) {
+        if (payload.packetName !== REMOTE_ACTOR_JOIN_PACKET || !isRemoteActorJoinPayload(payload)) {
           return undefined;
         }
         return decodeRemoteActorJoinPayload(
@@ -306,7 +312,11 @@ export class ZLinkSpotRoutedActorAdmission {
       }
     }
     try {
-      const envelope = decodeChannelEnvelope(parts, undefined, this.options.flowEnabled?.() ?? true);
+      const envelope = decodeChannelEnvelope(
+        parts,
+        undefined,
+        this.options.flowEnabled?.() ?? true
+      );
       if (envelope.packetName !== REMOTE_ACTOR_JOIN_PACKET) {
         return undefined;
       }

package/src/runtime/spots/spot-routed-bound-session-dispatch.ts

@@ -6,11 +6,7 @@ import {
   decodeRemoteBoundSessionResponse,
   decodeRemoteBoundSessionSend
 } from './spot-remote-route-codec';
-import {
-  hasReplyToken,
-  submitRoutePayloadReply,
-  submitRouteReply
-} from './spot-route-replies';
+import { hasReplyToken, submitRoutePayloadReply, submitRouteReply } from './spot-route-replies';
 import type { ZLinkActorResponseOptions } from './spot-actor-packet-dispatch';
 import { createInboundFlow, runWithFlow } from '../diagnostics/flow-context';
 import type { ZLinkDispatchErrorReporter } from '../channels';
@@ -63,14 +59,15 @@ export class ZLinkSpotRoutedBoundSessionDispatch {
           boundSessionSend.flowOrigin ?? boundSessionSend.envelope?.header.flowOrigin,
           this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true
         ),
-        () => this.options.routedBoundSessionReceiver?.(
-          boundSessionSend.actorId,
-          boundSessionSend.message,
-          boundSessionSend.packetName,
-          boundSessionSend.metadata,
-          boundSessionSend.actorRef,
-          boundSessionSend.actorPacketTarget
-        )
+        () =>
+          this.options.routedBoundSessionReceiver?.(
+            boundSessionSend.actorId,
+            boundSessionSend.message,
+            boundSessionSend.packetName,
+            boundSessionSend.metadata,
+            boundSessionSend.actorRef,
+            boundSessionSend.actorPacketTarget
+          )
       );
       if (hasReplyToken(received.replyToken)) {
         submitRoutePayloadReply(received, boundSessionSend.envelope, { ok: true });
@@ -124,9 +121,6 @@ export class ZLinkSpotRoutedBoundSessionDispatch {
     if (!hasReplyToken(received.replyToken)) {
       return;
     }
-    submitRouteReply(
-      received.reply()
-        .message(Buffer.from(JSON.stringify({ ok: true })))
-    );
+    submitRouteReply(received.reply().message(Buffer.from(JSON.stringify({ ok: true }))));
   }
 }

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

@@ -8,14 +8,8 @@ import type {
 import type { ZLinkProviderResolver } from '../../contracts/Common/ZLinkProviderResolver';
 import type { RoutingId } from '../../contracts';
 import type { ActorRef } from '../../contracts/Common/ActorRef';
-import type {
-  ZLinkRemoteActorPacketTarget,
-  ZLinkRemoteBoundSessionTarget
-} from '../actors';
-import type {
-  ZLinkBackendReceived,
-  ZLinkBackendSpot
-} from '../backend/contracts';
+import type { ZLinkRemoteActorPacketTarget, ZLinkRemoteBoundSessionTarget } from '../actors';
+import type { ZLinkBackendReceived, ZLinkBackendSpot } from '../backend/contracts';
 import type { ZLinkDispatchErrorReporter } from '../channels';
 import type { ZLinkChannelEnvelopeCodecRegistry } from '../channels/channel-envelope';
 import { decodeRemoteActorPacketRelay } from './spot-remote-route-codec';
@@ -79,7 +73,9 @@ interface ZLinkSpotRoutedFrameDispatchOptions {
     actorPacketTarget?: unknown,
     signal?: AbortSignal
   ) => Promise<void>;
-  readonly actorPacketTargetProvider?: (actorId: string) => ZLinkRemoteActorPacketTarget | undefined;
+  readonly actorPacketTargetProvider?: (
+    actorId: string
+  ) => ZLinkRemoteActorPacketTarget | undefined;
   readonly bindRemoteSession?: (
     actor: ActorRef,
     sourceNodeRid: RoutingId,
@@ -148,7 +144,10 @@ export class ZLinkSpotRoutedFrameDispatch {
     }
   }
 
-  async drain(received: ZLinkBackendReceived | undefined = undefined, retryDeadlineMs = performance.now()): Promise<void> {
+  async drain(
+    received: ZLinkBackendReceived | undefined = undefined,
+    retryDeadlineMs = performance.now()
+  ): Promise<void> {
     if (this.routeDraining) {
       if (received !== undefined) {
         try {
@@ -226,7 +225,10 @@ export class ZLinkSpotRoutedFrameDispatch {
       this.channelCodecs(),
       this.options.dispatchErrors?.flow.flowCreationEnabled() ?? true
     );
-    if (actorPacketRelay !== undefined && await this.actorPacketRelayDispatch.dispatch(received, actorPacketRelay)) {
+    if (
+      actorPacketRelay !== undefined &&
+      (await this.actorPacketRelayDispatch.dispatch(received, actorPacketRelay))
+    ) {
       return;
     }
     if (await this.routePacketDispatch.dispatch(received)) {
@@ -237,14 +239,15 @@ export class ZLinkSpotRoutedFrameDispatch {
 }
 
 function isRouteRecvRetryable(error: unknown): boolean {
-  return typeof error === 'object' &&
+  return (
+    typeof error === 'object' &&
     error !== null &&
-    [201, 202, 204].includes(Number((error as { result?: unknown }).result));
+    [201, 202, 204].includes(Number((error as { result?: unknown }).result))
+  );
 }
 
 function closeReceivedQuietly(received: ZLinkBackendReceived): void {
   try {
     received.close();
-  } catch {
-  }
+  } catch {}
 }