@zlink-systems/framework 0.29.1 → 0.30.1

package/src/runtime/backend/node/node-raw-mesh-backend.ts

@@ -1,3 +1,4 @@
+import { requestDurableService } from '../../foundation/durable-service-request';
 import {
   decodeStreamWireFrame,
   decodeStreamWireHeader,
@@ -17,8 +18,13 @@ import {
   type SubmitResult as SubmitResultValue
 } from '@zlink-systems/zlink';
 import { randomBytes } from 'node:crypto';
+import type { ZLinkMeshCompletionHandler } from '../mesh-completion-table';
 import { setImmediate as yieldToIO } from 'node:timers/promises';
-import { type RoutingId, ZLinkFrameworkException } from '../../../contracts';
+import {
+  type RoutingId,
+  ZLinkFrameworkException,
+  ZLinkFrameworkErrorKind
+} from '../../../contracts';
 
 import type { Message as FrameworkMessage } from '../../../contracts/Common/Message';
 import { ZLinkConfigurationException } from '../../../contracts/Configuration/ConfigurationException';
@@ -32,7 +38,6 @@ import {
   ZLINK_MAX_CAPACITY,
   ZLINK_MAX_PUBLIC_WEIGHT
 } from '../../../contracts/Configuration/RegistrationBuilderPolicy';
-import { shouldCompactBackingArray } from '../../admission';
 import type { ApplicationJobQueuePort } from '../../application-jobs/contracts';
 import type { ZLinkDispatchErrorReporter } from '../../channels/dispatch-error-reporter';
 import { ZLINK_NATIVE_CORRELATION_OPERATION_NAMESPACE } from '../../foundation/operation-identity';
@@ -91,6 +96,7 @@ import type {
   ServiceActorCreateRecord,
   ServiceDirectSpotRouteFence,
   ServiceInstanceActivationTarget,
+  ServiceInstanceColdActivationTarget,
   ServiceInstanceRouteFence,
   ServiceRetiredBoundSessionRouteFence,
   ServiceSpotRouteFence,
@@ -170,10 +176,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
       readonly lifecycleGeneration?: bigint;
     }
   >();
-  private readonly completions: Array<PendingCompletion | undefined> = [];
-  private completionHead = 0;
-  private completionCount = 0;
-  private readonly routingId: string;
+  private completionHandler?: ZLinkMeshCompletionHandler;
+  readonly routingId: string;
   private readonly lifecycleGeneration: bigint;
   private bindEndpoint?: string;
   private advertiseHost?: string;
@@ -231,7 +235,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     private readonly bindingPort: ZLinkRawBindingPort,
     private readonly applicationJobQueue?: ApplicationJobQueuePort,
     private readonly applicationJobReceiveFlowFailureSink?: (error: unknown) => void,
-    private readonly peerAdmissionSealed?: () => boolean
+    private readonly peerAdmissionSealed?: () => boolean,
+    private readonly infrastructureTaskRunner?: import('../../spots/spot-actor-join-dispatch').ZLinkDetachedTaskRunner
   ) {
     if (meshName.length === 0) throw new TypeError('MeshName must be non-empty.');
     if (routingId === undefined || routingId.length === 0) {
@@ -321,7 +326,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   }
 
   async sendToMissingInstanceSpot(
-    target: ServiceInstanceActivationTarget,
+    target: ServiceInstanceColdActivationTarget,
     parts: MessageLike | readonly MessageLike[],
     deadlineUnixMs: bigint,
     sourceSpotId?: string,
@@ -338,11 +343,12 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   }
 
   requestToMissingInstanceSpot(
-    target: ServiceInstanceActivationTarget,
+    target: ServiceInstanceColdActivationTarget,
     parts: MessageLike | readonly MessageLike[],
     deadlineUnixMs: bigint,
     sourceSpotId?: string,
-    metadata?: ReadonlyMap<string, string>
+    metadata?: ReadonlyMap<string, string>,
+    onAdmitted?: () => void
   ): MeshOperationId {
     return this.observeStateful(
       OperationKind.InstanceSpotRequest,
@@ -351,7 +357,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
         encodeMultipartApplicationFrame(parts),
         deadlineUnixMs,
         sourceSpotId,
-        metadata === undefined ? undefined : encodeServiceMetadataFrame(metadata)
+        metadata === undefined ? undefined : encodeServiceMetadataFrame(metadata),
+        onAdmitted
       )
     );
   }
@@ -386,6 +393,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
       resolveAdvertisedEndpoint: (boundEndpoint) => this.resolveAdvertisedEndpoint(boundEndpoint),
       bindingPort: this.bindingPort,
       applicationJobQueue: this.requireApplicationJobQueue(),
+      onReceiveReady: () => this.onReadable(true, false),
+      infrastructureTaskRunner: this.infrastructureTaskRunner,
       peerAdmissionSealed: this.peerAdmissionSealed,
       onReceiveFlowConfigFailure: this.applicationJobReceiveFlowFailureSink,
       onMailboxReady: (domain) =>
@@ -409,15 +418,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
           }
         }
       },
-      onPeerDisconnected: (nodeRoutingId, endpoint) => {
-        for (const [intentId, peer] of this.peerIntents) {
-          if (
-            peer.endpoint === endpoint &&
-            (peer.nodeRoutingId === undefined || peer.nodeRoutingId === nodeRoutingId)
-          ) {
-            this.peerIntents.delete(intentId);
-          }
-        }
+      onPeerDisconnected: (_nodeRoutingId, endpoint) => {
         for (const handler of this.peerDisconnectedHandlers) handler(endpoint);
       }
     });
@@ -481,7 +482,6 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     this.stateful = undefined;
     this.runtime?.close();
     this.runtime = undefined;
-    this.clearCompletions();
     this.closed = true;
   }
 
@@ -629,20 +629,38 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     return this.requireRuntime().isObjectClientNodeDirectTarget(String(targetRid));
   }
 
+  observePeerRoute(targetRid: unknown) {
+    return this.requireRuntime().observePeerRoute(String(targetRid));
+  }
+
+  hasPeerRouteOrConnectionIntent(targetRid: unknown, endpoint: string): boolean {
+    const rid = String(targetRid);
+    if (this.requireRuntime().hasSelectedPeerRoute(rid)) return true;
+    for (const intent of this.peerIntents.values()) {
+      if (
+        intent.nodeRoutingId === rid ||
+        (intent.nodeRoutingId === undefined && intent.endpoint === endpoint)
+      )
+        return true;
+    }
+    return false;
+  }
+
   isPeerRouteReady(targetRid: unknown, lifecycleGeneration?: bigint): boolean {
     return this.requireRuntime().isPeerRouteReady(String(targetRid), lifecycleGeneration);
   }
 
-  async sendToNode(
+  sendToNode(
     targetRid: unknown,
     parts: MessageLike | readonly MessageLike[]
-  ): Promise<SubmitResultValue> {
-    return (await this.requireRuntime().sendToNode(
+  ): SubmitResultValue | Promise<SubmitResultValue> {
+    const submitted = this.requireRuntime().sendToNode(
       String(targetRid),
       encodeMultipartApplicationFrame(parts)
-    ))
-      ? SubmitResult.Ok
-      : SubmitResult.NotConnected;
+    );
+    return submitted instanceof Promise
+      ? submitted.then(nodeSendResult)
+      : nodeSendResult(submitted);
   }
 
   async sendInfrastructureControl(
@@ -672,24 +690,33 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   async requestInfrastructureControlFrames(
     targetRid: unknown,
     frames: readonly Uint8Array[],
-    options?: { readonly timeoutMs?: number }
+    options?: {
+      readonly timeoutMs?: number;
+      readonly signal?: AbortSignal;
+      readonly onSubmitted?: (signal: AbortSignal) => Promise<void>;
+    }
   ): Promise<readonly Uint8Array[]> {
-    return await this.requireRuntime().requestService(
+    return requestDurableService(
+      this.requireRuntime(),
       String(targetRid),
-      frames.map((frame) => Buffer.from(frame)),
-      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS
+      frames,
+      performance.now() + (options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS),
+      'relocation control',
+      options?.signal,
+      options?.onSubmitted
     );
   }
 
   requestToNode(
     targetRid: unknown,
     parts: MessageLike | readonly MessageLike[],
-    options?: { readonly timeoutMs?: number }
+    options?: { readonly timeoutMs?: number; readonly onAdmitted?: () => void }
   ): MeshOperationId {
     const pending = this.requireRuntime().requestToNode(
       String(targetRid),
       encodeMultipartApplicationFrame(parts),
-      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS
+      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+      options?.onAdmitted
     );
     return this.observeCompletion(pending.id, OperationKind.NodeRequest, pending.promise);
   }
@@ -704,12 +731,13 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   requestToChannel(
     channelName: string,
     parts: MessageLike | readonly MessageLike[],
-    options?: { readonly timeoutMs?: number }
+    options?: { readonly timeoutMs?: number; readonly onAdmitted?: () => void }
   ): MeshOperationId {
     const pending = this.requireRuntime().requestToChannel(
       channelName,
       encodeMultipartApplicationFrame(parts),
-      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS
+      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+      options?.onAdmitted
     );
     return this.observeCompletion(pending.id, OperationKind.ChannelRequest, pending.promise);
   }
@@ -730,7 +758,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
       drainingPeerCount: peers.filter((peer) => peer.descriptor.state === 'draining').length,
       pendingApplicationMessages: BigInt(this.runtime?.mailbox.pendingMessages('application') ?? 0),
       pendingInfrastructureMessages: BigInt(
-        (this.runtime?.mailbox.pendingMessages('infrastructure') ?? 0) + this.completionCount
+        this.runtime?.mailbox.pendingMessages('infrastructure') ?? 0
       ),
       pendingBytes: BigInt(
         (this.runtime?.mailbox.pendingBytes('application') ?? 0) +
@@ -846,6 +874,10 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     };
   }
 
+  setCompletionHandler(handler: ZLinkMeshCompletionHandler): void {
+    this.completionHandler = handler;
+  }
+
   setReadyHandler(handler: (readyDomains: number) => number): void {
     this.readyHandler = handler;
     this.notifyReady();
@@ -869,7 +901,6 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   } {
     const target = requireRawReadyBatch(batch);
     if ((domains & ReadyDomain.Infrastructure) !== 0) {
-      this.drainCompletions(target);
       this.drainMailbox('infrastructure', target);
     }
     if ((domains & ReadyDomain.Application) !== 0) {
@@ -878,7 +909,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     const runtime = this.runtime;
     const infrastructureResidue =
       (domains & ReadyDomain.Infrastructure) !== 0 &&
-      (this.completionCount > 0 || (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0);
+      (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0;
     const applicationResidue =
       (domains & ReadyDomain.Application) !== 0 &&
       (runtime?.mailbox.pendingMessages('application') ?? 0) > 0;
@@ -1169,7 +1200,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     timeoutMs: number = DEFAULT_REQUEST_TIMEOUT_MS,
     sourceSpotId?: string,
     metadata?: ReadonlyMap<string, string>,
-    instanceIntent = false
+    instanceIntent = false,
+    onAdmitted?: () => void
   ): MeshOperationId {
     return this.observeStateful(
       OperationKind.InstanceSpotRequest,
@@ -1179,7 +1211,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
         timeoutMs,
         sourceSpotId,
         metadata === undefined ? undefined : encodeServiceMetadataFrame(metadata),
-        instanceIntent
+        instanceIntent,
+        onAdmitted
       )
     );
   }
@@ -1324,7 +1357,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   requestToActor(
     actor: ZLinkBackendActorRef,
     parts: MessageLike | readonly MessageLike[],
-    options?: { readonly timeoutMs?: number }
+    options?: { readonly timeoutMs?: number; readonly onAdmitted?: () => void }
   ): MeshOperationId {
     return this.observeStateful(
       OperationKind.ActorRequest,
@@ -1333,7 +1366,10 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
         this.peerGeneration(String(actor.nodeRid)),
         actor.generation,
         encodeMultipart(parts),
-        options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS
+        options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+        undefined,
+        undefined,
+        options?.onAdmitted
       )
     );
   }
@@ -1356,7 +1392,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     source: ZLinkBackendActorRef,
     target: ZLinkBackendActorRef,
     parts: MessageLike | readonly MessageLike[],
-    options?: { readonly timeoutMs?: number }
+    options?: { readonly timeoutMs?: number; readonly onAdmitted?: () => void }
   ): MeshOperationId {
     return this.observeStateful(
       OperationKind.ActorRequest,
@@ -1366,7 +1402,9 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
         target.generation,
         encodeMultipart(parts),
         options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
-        source
+        source,
+        undefined,
+        options?.onAdmitted
       )
     );
   }
@@ -1391,7 +1429,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   ): MeshOperationId {
     const binding = this.requireStateful().registry.binding(actor);
     if (binding === undefined) {
-      return this.enqueueImmediateFailure(OperationKind.StreamUnbind, RequestResult.NotFound);
+      return this.observeImmediateFailure(OperationKind.StreamUnbind, RequestResult.NotFound);
     }
     return this.observeStateful(
       OperationKind.StreamUnbind,
@@ -1439,7 +1477,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     source: ServiceSpotState,
     target: ServiceDirectSpotRouteFence,
     parts: MessageLike | readonly MessageLike[],
-    timeoutMs: number
+    timeoutMs: number,
+    onAdmitted?: () => void
   ): MeshOperationId {
     return this.observeStateful(
       OperationKind.SpotRequest,
@@ -1447,7 +1486,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
         source.ref.spotId,
         target,
         encodeMultipart(parts),
-        timeoutMs
+        timeoutMs,
+        onAdmitted
       )
     );
   }
@@ -1471,6 +1511,11 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   }
 
   setSpotSubscription(state: ServiceSpotState, channelName: string, topicFilter: string): void {
+    if (!this.channels.has(channelName))
+      throw new ZLinkFrameworkException(
+        ZLinkFrameworkErrorKind.InvalidOperation,
+        `Spot does not participate in subscription channel '${channelName}'.`
+      );
     this.requireStateful().setSubscription(state, channelName, topicFilter);
   }
 
@@ -1559,7 +1604,7 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   private notifyReady(): void {
     const runtime = this.runtime;
     let domains = ReadyDomain.None;
-    if (this.completionCount > 0 || (runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0) {
+    if ((runtime?.mailbox.pendingMessages('infrastructure') ?? 0) > 0) {
       domains |= ReadyDomain.Infrastructure;
     }
     if ((runtime?.mailbox.pendingMessages('application') ?? 0) > 0) {
@@ -1575,8 +1620,8 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   ): MeshOperationId {
     const id = { high: 1n, low };
     void promise.then(
-      (result) => this.enqueueCompletion(id, operationKind, result),
-      (error) => this.enqueueCompletion(id, operationKind, requestFailureResult(error))
+      (result) => this.deliverCompletion(id, operationKind, result),
+      (error) => this.deliverCompletion(id, operationKind, requestFailureResult(error))
     );
     return id;
   }
@@ -1587,66 +1632,40 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   ): MeshOperationId {
     const id = { high: ZLINK_NATIVE_CORRELATION_OPERATION_NAMESPACE, low: pending.id };
     void pending.promise.then(
-      (result) => this.enqueueCompletion(id, operationKind, result),
-      (error) => this.enqueueCompletion(id, operationKind, requestFailureResult(error))
+      (result) => this.deliverCompletion(id, operationKind, result),
+      (error) => this.deliverCompletion(id, operationKind, requestFailureResult(error))
     );
     return id;
   }
 
-  private enqueueImmediateFailure(operationKind: number, terminalResult: number): MeshOperationId {
+  private observeImmediateFailure(operationKind: number, terminalResult: number): MeshOperationId {
     const low = this.nextPeerIntent++;
-    const id = { high: 1n, low };
-    this.enqueueCompletion(id, operationKind, { terminalResult, failureCode: 0 });
-    return id;
+    return this.observeCompletion(
+      low,
+      operationKind,
+      Promise.resolve({ terminalResult, failureCode: 0 })
+    );
   }
 
-  private enqueueCompletion(
+  private deliverCompletion(
     operationId: MeshOperationId,
     operationKind: number,
     result: RawServiceRequestResult | ServiceStatefulResult
   ): void {
-    if (this.closed) return;
-    this.completions.push({ operationId, operationKind, result });
-    this.completionCount += 1;
-    this.readyHandler?.(ReadyDomain.Infrastructure);
-  }
-
-  private drainCompletions(batch: RawReadyBatch): void {
-    while (!batch.full && this.completionCount > 0) {
-      const completion = this.takeCompletion();
-      if (completion === undefined) continue;
-      batch.push(
-        {
-          ownerKind: ReadyOwnerKind.Node,
-          domain: ReadyDomain.Infrastructure,
-          spotId: null,
-          actor: null,
-          terminalCompletion: true
-        },
-        new CompletionClaim(completion)
+    if (this.completionHandler !== undefined) {
+      this.completionHandler({ operationId, terminalResult: result.terminalResult }, () =>
+        completionRecord(operationId, operationKind, result)
       );
+      return;
     }
-  }
-
-  private takeCompletion(): PendingCompletion | undefined {
-    const completion = this.completions[this.completionHead];
-    if (completion === undefined) return undefined;
-    this.completions[this.completionHead] = undefined;
-    this.completionHead += 1;
-    this.completionCount -= 1;
-    if (this.completionCount === 0) {
-      this.clearCompletions();
-    } else if (shouldCompactBackingArray(this.completionHead, this.completions.length)) {
-      this.completions.splice(0, this.completionHead);
-      this.completionHead = 0;
-    }
-    return completion;
-  }
-
-  private clearCompletions(): void {
-    this.completions.length = 0;
-    this.completionHead = 0;
-    this.completionCount = 0;
+    // The raw pull contract uses the existing infrastructure mailbox. A
+    // registered Framework owner receives the terminal directly above.
+    this.runtime?.mailbox.tryEnqueue({
+      owner: this.routingId,
+      domain: 'infrastructure',
+      parts: [],
+      completion: completionRecord(operationId, operationKind, result)
+    });
   }
 
   private drainMailbox(domain: ServiceMailboxDomain, batch: RawReadyBatch): void {
@@ -1655,7 +1674,16 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     while (!batch.full) {
       const claim = runtime.mailbox.tryClaim(domain, MAX_DRAIN_RECORDS, Number.MAX_SAFE_INTEGER);
       if (claim === undefined) break;
-      const owner = readyOwner(claim.owner, this.routingId, this.stateful, domain);
+      const owner =
+        claim.records[0]?.completion === undefined
+          ? readyOwner(claim.owner, this.routingId, this.stateful, domain)
+          : {
+              ownerKind: ReadyOwnerKind.Node,
+              domain: ReadyDomain.Infrastructure,
+              spotId: null,
+              actor: null,
+              terminalCompletion: true
+            };
       batch.push(owner, new MailboxClaim(runtime, claim));
     }
   }
@@ -1690,12 +1718,6 @@ export class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
   }
 }
 
-interface PendingCompletion {
-  readonly operationId: MeshOperationId;
-  readonly operationKind: number;
-  readonly result: RawServiceRequestResult | ServiceStatefulResult;
-}
-
 interface RawClaim {
   recvBatch(batch: ReceiveBatch): {
     readonly ok: boolean;
@@ -1738,7 +1760,11 @@ class RawServiceSpot implements ServiceSpot {
   requestToChannel(
     channelName: string,
     parts: MessageLike | readonly MessageLike[],
-    options?: { readonly flags?: number; readonly timeoutMs?: number }
+    options?: {
+      readonly flags?: number;
+      readonly timeoutMs?: number;
+      readonly onAdmitted?: () => void;
+    }
   ): MeshOperationId {
     this.requireOpen();
     return this.backend.requestToChannel(channelName, parts, options);
@@ -1774,6 +1800,7 @@ class RawServiceSpot implements ServiceSpot {
     parts: MessageLike | readonly MessageLike[],
     options?: {
       readonly timeoutMs?: number;
+      readonly onAdmitted?: () => void;
       readonly routeFence?: ServiceDirectSpotRouteFence;
       readonly entrySpot?: boolean;
     }
@@ -1792,7 +1819,8 @@ class RawServiceSpot implements ServiceSpot {
       this.state,
       routeFence,
       parts,
-      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS
+      options?.timeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS,
+      options?.onAdmitted
     );
   }
 
@@ -1842,6 +1870,10 @@ class RawServiceSpot implements ServiceSpot {
   }
 }
 
+function nodeSendResult(submitted: boolean): SubmitResultValue {
+  return submitted ? SubmitResult.Ok : SubmitResult.NotConnected;
+}
+
 function requireDirectSpotRouteFence(
   route: ServiceDirectSpotRouteFence | undefined,
   targetNodeRid: string,
@@ -1989,7 +2021,10 @@ class RawStreamSessionService implements StreamSessionService {
     const target = this.sessionTargets.get(sessionRid);
     if (target === undefined) return false;
     const operation = this.stream.send(target as unknown as BindingRoutingId);
-    const parts = decodeMultipartBuffers(decodeApplicationPayloadView(payload).payload);
+    const parts = decodeMultipartParts(
+      decodeApplicationPayloadView(payload).payload,
+      borrowMultipartPart
+    );
     if (parts.length === 0) return false;
     const actorSlot = await serviceSessionBindingIngressPortIfRegistered(this)?.actorSlot(
       actorId,
@@ -2166,54 +2201,43 @@ class MailboxClaim implements RawClaim {
   }
 }
 
-class CompletionClaim implements RawClaim {
-  private consumed = false;
-
-  constructor(private readonly completion: PendingCompletion) {}
-
-  recvBatch(): { readonly ok: boolean; readonly records: ReceiveRecord[] } {
-    if (this.consumed) return { ok: false, records: [] };
-    this.consumed = true;
-    const payload = this.completion.result.payload;
-    return {
-      ok: true,
-      records: [
-        {
-          kind: ReceiveKind.Completion,
-          domain: ReadyDomain.Infrastructure,
-          sourceNodeRid: null,
-          sourceSpotId: null,
-          sourceBindingGeneration: 0n,
-          sourceActor: null,
-          operationId: this.completion.operationId,
-          operationKind: this.completion.operationKind,
-          channelName: null,
-          topic: null,
-          applicationMetadata: null,
-          kindData:
-            'kindData' in this.completion.result ? (this.completion.result.kindData ?? null) : null,
-          terminalResult: this.completion.result.terminalResult,
-          failureErrno: this.completion.result.failureCode,
-          parts:
-            payload === undefined
-              ? []
-              : payload.contentType === MULTIPART_CONTENT_TYPE
-                ? decodeMultipart(payload.payload)
-                : [Message.from(payload.payload)],
-          reply: () => SubmitResult.InvalidState,
-          replyActorJoin: () => SubmitResult.NotSupported
-        }
-      ]
-    };
-  }
-
-  release(): void {}
+function completionRecord(
+  operationId: MeshOperationId,
+  operationKind: number,
+  result: RawServiceRequestResult | ServiceStatefulResult
+): ReceiveRecord {
+  const payload = result.payload;
+  return {
+    kind: ReceiveKind.Completion,
+    domain: ReadyDomain.Infrastructure,
+    sourceNodeRid: null,
+    sourceSpotId: null,
+    sourceBindingGeneration: 0n,
+    sourceActor: null,
+    operationId,
+    operationKind,
+    channelName: null,
+    topic: null,
+    applicationMetadata: null,
+    kindData: 'kindData' in result ? (result.kindData ?? null) : null,
+    terminalResult: result.terminalResult,
+    failureErrno: result.failureCode,
+    parts:
+      payload === undefined
+        ? []
+        : payload.contentType === MULTIPART_CONTENT_TYPE
+          ? decodeMultipart(payload.payload)
+          : [ZLinkBufferMessage.from(payload.payload)],
+    reply: () => SubmitResult.InvalidState,
+    replyActorJoin: () => SubmitResult.NotSupported
+  };
 }
 
 function decodeMultipartRecord(
   runtime: RawServiceMeshRuntime,
   record: ServiceMailboxRecord
 ): ReceiveRecord {
+  if (record.completion !== undefined) return record.completion;
   const stateful = statefulMailboxData(record);
   if (stateful !== undefined) {
     return decodeStatefulRecord(record, stateful);
@@ -2614,45 +2638,54 @@ function decodeApplicationEnvelope(frame: Uint8Array) {
 }
 
 function decodeMultipart(payload: Uint8Array): FrameworkMessage[] {
-  const buffers = decodeMultipartBuffers(payload);
-  const parts = new Array<FrameworkMessage>(buffers.length);
-  let materialized = 0;
-  try {
-    for (; materialized < buffers.length; materialized += 1) {
-      parts[materialized] = ZLinkBufferMessage.fromOwned(buffers[materialized]!);
-    }
-    return parts;
-  } catch (error) {
-    for (let index = 0; index < materialized; index += 1) parts[index]!.close();
-    throw error;
-  }
+  return decodeMultipartParts(payload, ZLinkBufferMessage.fromOwned, closeMultipartMessage);
+}
+
+function closeMultipartMessage(part: FrameworkMessage): void {
+  part.close();
 }
 
-function decodeMultipartBuffers(payload: Uint8Array): Buffer[] {
+function borrowMultipartPart(part: Buffer): Buffer {
+  return part;
+}
+
+function decodeMultipartParts<T>(
+  payload: Uint8Array,
+  materialize: (part: Buffer) => T,
+  release?: (part: T) => void
+): T[] {
   const bytes = Buffer.from(payload.buffer, payload.byteOffset, payload.byteLength);
   if (bytes.length < 4) throw new ServiceWireProtocolError('Truncated multipart payload.');
   const count = bytes.readUInt32BE(0);
   if (count === 0 || count > Math.floor((bytes.length - 4) / 4)) {
     throw new ServiceWireProtocolError('Invalid multipart part count.');
   }
-  const result = new Array<Buffer>(count);
+  const result = new Array<T>(count);
   let offset = 4;
-  for (let index = 0; index < count; index++) {
-    if (bytes.length - offset < 4) {
-      throw new ServiceWireProtocolError('Truncated multipart part length.');
+  let index = 0;
+  try {
+    for (; index < count; index++) {
+      if (bytes.length - offset < 4) {
+        throw new ServiceWireProtocolError('Truncated multipart part length.');
+      }
+      const length = bytes.readUInt32BE(offset);
+      offset += 4;
+      if (bytes.length - offset < length) {
+        throw new ServiceWireProtocolError('Truncated multipart part.');
+      }
+      result[index] = materialize(bytes.subarray(offset, offset + length));
+      offset += length;
     }
-    const length = bytes.readUInt32BE(offset);
-    offset += 4;
-    if (bytes.length - offset < length) {
-      throw new ServiceWireProtocolError('Truncated multipart part.');
+    if (offset !== bytes.length) {
+      throw new ServiceWireProtocolError('Multipart payload has trailing bytes.');
     }
-    result[index] = bytes.subarray(offset, offset + length);
-    offset += length;
-  }
-  if (offset !== bytes.length) {
-    throw new ServiceWireProtocolError('Multipart payload has trailing bytes.');
+    return result;
+  } catch (error) {
+    if (release !== undefined) {
+      for (let retained = 0; retained < index; retained++) release(result[retained]!);
+    }
+    throw error;
   }
-  return result;
 }
 
 function messageBytesView(value: MessageLike): Uint8Array {