@zlink-systems/framework 0.11.0 → 0.12.0

package/src/runtime/foundation/raw-service-mesh-runtime.ts

@@ -17,7 +17,7 @@ import {
 } from '../application-jobs/application-ingress-record-owner';
 import { OperationRegistry, type PendingOperation } from './operation-registry';
 import { ServiceLivenessRegistry, type ServiceLivenessTick } from './service-liveness-registry';
-import { ServiceMailbox, type ServiceMailboxLimits, type ServiceMailboxRecord } from './service-mailbox';
+import { ServiceMailbox, type ServiceMailboxRecord } from './service-mailbox';
 import {
   ServiceTopologyRegistry,
   sameServiceNodeDescriptor,
@@ -28,7 +28,7 @@ import {
   type ServiceNodeDescriptor
 } from './service-topology-registry';
 import {
-  decodeApplicationPayload,
+  decodeApplicationPayloadView,
   decodeChannelRequestHeader,
   decodeChannelSendHeader,
   decodeHeader,
@@ -72,6 +72,9 @@ export interface RawServiceRequestResult {
   readonly payload?: ServiceApplicationPayload;
 }
 
+/** An M6A application frame already owned by the Framework runtime. */
+type ServiceApplicationPayloadInput = ServiceApplicationPayload | Buffer;
+
 export interface RawServiceIngressRecord {
   readonly command: number;
   readonly flags: number;
@@ -91,7 +94,6 @@ export type RawServiceIngressHandler = (
 export interface RawServiceMeshRuntimeOptions {
   readonly descriptor: ServiceNodeDescriptor;
   readonly resolveAdvertisedEndpoint?: (boundEndpoint: string) => string;
-  readonly mailbox?: Partial<ServiceMailboxLimits>;
   readonly probeIntervalMs?: number;
   readonly peerTimeoutMs?: number;
   readonly bindingPort: ZLinkRawBindingPort;
@@ -195,7 +197,7 @@ export class RawServiceMeshRuntime {
   constructor(options: RawServiceMeshRuntimeOptions) {
     this.descriptor = options.descriptor;
     this.topology = new ServiceTopologyRegistry(options.descriptor);
-    this.mailbox = new ServiceMailbox(undefined, options.onMailboxReady);
+    this.mailbox = new ServiceMailbox(options.onMailboxReady);
     this.liveness = new ServiceLivenessRegistry(options.probeIntervalMs, options.peerTimeoutMs);
     this.bindingPort = options.bindingPort;
     if (options.applicationJobQueue === undefined) {
@@ -474,23 +476,24 @@ export class RawServiceMeshRuntime {
 
   async sendToNode(
     targetNodeRoutingId: string,
-    payload: ServiceApplicationPayload
+    payload: ServiceApplicationPayloadInput
   ): Promise<boolean> {
     return this.send(
       targetNodeRoutingId,
-      [encodeNodeSendHeader(), encodeApplicationPayload(payload)]
+      [encodeNodeSendHeader(), this.applicationFrame(payload)]
     );
   }
 
   async sendToChannel(
     channelName: string,
-    payload: ServiceApplicationPayload
+    payload: ServiceApplicationPayloadInput
   ): Promise<boolean> {
     const selected = this.topology.selectChannel(
       channelName,
       peer => this.isLocalOrReadyPeer(peer.descriptor.nodeRoutingId)
     );
     if (selected === undefined) return false;
+    const applicationFrame = this.applicationFrame(payload);
     if (selected.descriptor.nodeRoutingId === this.descriptor.nodeRoutingId) {
       const applicationJobOwner = await this.reserveLocalIngress();
       try {
@@ -498,7 +501,7 @@ export class RawServiceMeshRuntime {
         const accepted = this.mailbox.tryEnqueue({
           owner: `channel:${channelName}`,
           domain: 'application',
-          parts: [encodeChannelSendHeader(channelName), encodeApplicationPayload(payload)],
+          parts: [encodeChannelSendHeader(channelName), applicationFrame],
           sourceRoutingId: this.descriptor.nodeRoutingId,
           applicationJob
         });
@@ -510,13 +513,13 @@ export class RawServiceMeshRuntime {
     }
     return this.send(selected.descriptor.nodeRoutingId, [
       encodeChannelSendHeader(channelName),
-      encodeApplicationPayload(payload)
+      applicationFrame
     ]);
   }
 
   requestToNode(
     targetNodeRoutingId: string,
-    payload: ServiceApplicationPayload,
+    payload: ServiceApplicationPayloadInput,
     timeoutMs: number
   ): PendingOperation<RawServiceRequestResult> {
     return this.requestToTarget(targetNodeRoutingId, payload, timeoutMs);
@@ -524,7 +527,7 @@ export class RawServiceMeshRuntime {
 
   requestToChannel(
     channelName: string,
-    payload: ServiceApplicationPayload,
+    payload: ServiceApplicationPayloadInput,
     timeoutMs: number
   ): PendingOperation<RawServiceRequestResult> | undefined {
     const selected = this.topology.selectChannel(
@@ -595,7 +598,7 @@ export class RawServiceMeshRuntime {
 
   reply(
     request: ServiceMailboxRecord,
-    payload: ServiceApplicationPayload,
+    payload: ServiceApplicationPayloadInput,
     terminalResult = 0,
     failureCode = 0
   ): void {
@@ -603,7 +606,7 @@ export class RawServiceMeshRuntime {
       request.localReply(
         terminalResult,
         failureCode,
-        terminalResult === 0 ? payload : undefined
+        terminalResult === 0 ? this.applicationPayload(payload) : undefined
       );
       return;
     }
@@ -612,7 +615,7 @@ export class RawServiceMeshRuntime {
     }
     request.reply([
       encodeReplyHeader(request.correlation, terminalResult, failureCode),
-      ...(terminalResult === 0 ? [encodeApplicationPayload(payload)] : [])
+      ...(terminalResult === 0 ? [this.applicationFrame(payload)] : [])
     ]);
   }
 
@@ -620,8 +623,44 @@ export class RawServiceMeshRuntime {
     nowMs = performance.now(),
     observe?: RawServicePumpObserver
   ): Promise<RawServicePumpResult> {
-    const router = this.requireStarted();
     this.pullMonitorEvents();
+    return this.receiveOne(nowMs, observe);
+  }
+
+  setReadableHandler(handler: () => void): void {
+    this.requireStarted().setReadableHandler(handler);
+  }
+
+  /** Returns whether a receive budget ended before no-data; idle ticks only maintain peers. */
+  async pumpBatch(receiveReady = true): Promise<boolean> {
+    await this.drainMonitorEvents();
+    const startedAtMs = performance.now();
+    let messages = 0;
+    let bytes = 0;
+    const observe: RawServicePumpObserver = (_source, byteCount) => { bytes += byteCount; };
+    while (receiveReady && messages < 64 && !this.closed) {
+      const result = await this.receiveOne(performance.now(), observe);
+      if (result === 'noData') {
+        receiveReady = false;
+        break;
+      }
+      messages += 1;
+      // Core owns the per-peer fair-queue cursor. The Framework limit bounds
+      // the entire round, so changing peers does not renew its byte/count budget.
+      if (bytes >= 4 * 1024 * 1024 || performance.now() - startedAtMs >= 2) break;
+    }
+    if (!this.closed) {
+      await this.announceExpectedPeers();
+      await this.tickLiveness();
+    }
+    return receiveReady && messages > 0;
+  }
+
+  private async receiveOne(
+    nowMs: number,
+    observe?: RawServicePumpObserver
+  ): Promise<RawServicePumpResult> {
+    const router = this.requireStarted();
     let permit: ApplicationJobPermitPort;
     try {
       permit = await this.applicationJobQueue.acquire(this.applicationJobStop.signal);
@@ -629,6 +668,10 @@ export class RawServiceMeshRuntime {
       if (this.closed || this.applicationJobStop.signal.aborted) return 'noData';
       throw error;
     }
+    if (this.closed) {
+      permit.releaseAfterInternalProcessing();
+      return 'noData';
+    }
     let received: ZLinkRawReceivedRecord | undefined;
     try {
       received = router.receive(true);
@@ -1122,7 +1165,7 @@ export class RawServiceMeshRuntime {
 
   private requestToTarget(
     targetNodeRoutingId: string,
-    payload: ServiceApplicationPayload,
+    payload: ServiceApplicationPayloadInput,
     timeoutMs: number,
     channelName?: string
   ): PendingOperation<RawServiceRequestResult> {
@@ -1130,8 +1173,8 @@ export class RawServiceMeshRuntime {
     const header = channelName === undefined
       ? encodeNodeRequestHeader(correlation)
       : encodeChannelRequestHeader(correlation, channelName);
-    const encodedPayload = encodeApplicationPayload(payload);
-    const pending = this.operations.reserve(timeoutMs);
+    const encodedPayload = this.applicationFrame(payload);
+    const pending = this.operations.register(timeoutMs);
     let selectedTargetNodeRoutingId = targetNodeRoutingId;
     if (
       selectedTargetNodeRoutingId !== this.descriptor.nodeRoutingId
@@ -1263,7 +1306,7 @@ export class RawServiceMeshRuntime {
           this.operations.complete(
             pending.id,
             reply.terminalResult === 0
-              ? { ...result, payload: decodeApplicationPayload(replyParts[1]!) }
+              ? { ...result, payload: decodeApplicationPayloadView(replyParts[1]!) }
               : result
           );
         } catch (error) {
@@ -1277,6 +1320,18 @@ export class RawServiceMeshRuntime {
     return pending;
   }
 
+  /**
+   * The generic node/channel backend may supply its single owned M6A frame
+   * directly. All other callers keep the typed application-payload boundary.
+   */
+  private applicationFrame(payload: ServiceApplicationPayloadInput): Buffer {
+    return Buffer.isBuffer(payload) ? payload : encodeApplicationPayload(payload);
+  }
+
+  private applicationPayload(payload: ServiceApplicationPayloadInput): ServiceApplicationPayload {
+    return Buffer.isBuffer(payload) ? decodeApplicationPayloadView(payload) : payload;
+  }
+
   private admitPeer(
     descriptor: ServiceNodeDescriptor,
     connection: PhysicalConnectionCandidate,

package/src/runtime/foundation/service-mailbox.ts

@@ -55,14 +55,6 @@ interface DomainState {
   bytes: number;
 }
 
-export interface ServiceMailboxLimits {
-  readonly applicationMessages: number;
-  readonly applicationBytes: number;
-  readonly infrastructureMessages: number;
-  readonly infrastructureBytes: number;
-}
-
-
 /** Level-triggered queues with one active application claim per owner. */
 export class ServiceMailbox {
   private readonly application: DomainState;
@@ -78,10 +70,7 @@ export class ServiceMailbox {
   private nextRelocationSerial = 1n;
   private closed = false;
 
-  constructor(
-    _legacyLimits?: ServiceMailboxLimits,
-    private readonly onReady?: (domain: ServiceMailboxDomain) => void
-  ) {
+  constructor(private readonly onReady?: (domain: ServiceMailboxDomain) => void) {
     // Host ApplicationJobQueue permits own ordinary-record admission. The
     // Framework-owned payload lifetime does not retain Core HWM credit. A
     // second mailbox cap would reject already-admitted work before the shared
@@ -125,8 +114,8 @@ export class ServiceMailbox {
     if (!queue.claimed && !target.indexed.has(record.owner)) {
       target.indexed.add(record.owner);
       target.ready.push(record.owner);
+      this.onReady?.(record.domain);
     }
-    this.onReady?.(record.domain);
     return true;
   }
 
@@ -186,6 +175,7 @@ export class ServiceMailbox {
     } else if (!target.indexed.has(claim.owner)) {
       target.indexed.add(claim.owner);
       target.ready.push(claim.owner);
+      this.onReady?.(claim.domain);
     }
     return true;
   }

package/src/runtime/foundation/service-runtime-contracts.ts

@@ -269,7 +269,8 @@ export interface ReadyBatch {
 }
 
 export interface ReceiveBatch {
-  reset(): void;
+  /** Reuses the batch, limiting this receive to the admitted record count. */
+  reset(messageCapacity?: number): void;
   close(): void;
 }
 

package/src/runtime/foundation/service-stateful-registry.ts

@@ -619,8 +619,8 @@ export class ServiceTerminalOperationRegistry<T> {
     this.operations = operations;
   }
 
-  reserve(timeoutMs: number, timeoutOwner: 'registry' | 'sender' = 'registry'): PendingOperation<T> {
-    return this.operations.reserve(timeoutMs, timeoutOwner);
+  register(timeoutMs: number, timeoutOwner: 'registry' | 'sender' = 'registry'): PendingOperation<T> {
+    return this.operations.register(timeoutMs, timeoutOwner);
   }
 
   reply(id: bigint, value: T): boolean {

package/src/runtime/foundation/service-stateful-runtime.ts

@@ -1240,7 +1240,7 @@ export class ServiceStatefulRuntime {
     payload: ServiceApplicationPayload,
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     const target = this.acceptSpotAuthority(requested);
     if (target === undefined) {
       this.operations.reply(pending.id, {
@@ -1294,7 +1294,7 @@ export class ServiceStatefulRuntime {
     sourceActor?: ServiceActorRef,
     boundSession?: { readonly sessionRid: string; readonly bindingGeneration: bigint }
   ): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     const route = this.tryActorFence(target);
     if (route === undefined) {
       this.operations.reply(pending.id, {
@@ -1393,7 +1393,7 @@ export class ServiceStatefulRuntime {
     sourceSpotId?: string,
     metadataFrame?: Uint8Array
   ): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     this.submitRequest(
       pending,
       route.targetNodeRid,
@@ -1442,7 +1442,7 @@ export class ServiceStatefulRuntime {
     metadataFrame?: Uint8Array
   ): ServiceStatefulPendingOperation {
     const timeoutMs = remainingDeadlineMs(deadlineUnixMs);
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     this.submitRequest(
       pending,
       target.targetNodeRid,
@@ -1471,7 +1471,7 @@ export class ServiceStatefulRuntime {
     actorId: string,
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     this.submitRequest(
       pending,
       targetNodeRid,
@@ -1483,7 +1483,7 @@ export class ServiceStatefulRuntime {
   }
 
   destroyActor(actor: ServiceActorRef, timeoutMs: number): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     const local = actor.nodeRid === this.nodeRid;
     if (local) {
       queueMicrotask(() => {
@@ -1510,7 +1510,7 @@ export class ServiceStatefulRuntime {
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
     const deadlineMs = performance.now() + timeoutMs;
-    const pending = this.operations.reserve(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
+    const pending = this.operations.register(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
     const target = this.trySpotFence(targetNodeRid, {
       ...targetSpot,
       generation: targetSpotGeneration
@@ -1537,7 +1537,7 @@ export class ServiceStatefulRuntime {
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
     const deadlineMs = performance.now() + timeoutMs;
-    const pending = this.operations.reserve(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
+    const pending = this.operations.register(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
     const target = this.trySpotFence(targetNodeRid, {
       ...targetSpot,
       generation: targetSpotGeneration
@@ -1561,7 +1561,7 @@ export class ServiceStatefulRuntime {
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
     const deadlineMs = performance.now() + timeoutMs;
-    const pending = this.operations.reserve(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
+    const pending = this.operations.register(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
     this.submitActorJoin(
       pending,
       actor,
@@ -1582,7 +1582,7 @@ export class ServiceStatefulRuntime {
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
     const deadlineMs = performance.now() + timeoutMs;
-    const pending = this.operations.reserve(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
+    const pending = this.operations.register(timeoutMs, targetNodeRid === this.nodeRid ? 'registry' : 'sender');
     this.submitActorJoin(
       pending,
       actor,
@@ -1600,7 +1600,7 @@ export class ServiceStatefulRuntime {
     expectedMembershipEpoch: bigint,
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     queueMicrotask(() => {
       try {
         const transition = this.registry.leaveActor(actor, expectedMembershipEpoch);
@@ -1635,7 +1635,7 @@ export class ServiceStatefulRuntime {
     actorAuthority?: StreamSessionActorAuthorityFence
   ): ServiceStatefulPendingOperation {
     const deadlineMs = performance.now() + timeoutMs;
-    const pending = this.operations.reserve(timeoutMs, 'sender');
+    const pending = this.operations.register(timeoutMs, 'sender');
     const generation = this.nextSessionSequence++;
     const localBinding: ServiceSessionBinding = {
       actor,
@@ -1777,7 +1777,7 @@ export class ServiceStatefulRuntime {
     expectedBindingGeneration: bigint,
     timeoutMs: number
   ): ServiceStatefulPendingOperation {
-    const pending = this.operations.reserve(timeoutMs);
+    const pending = this.operations.register(timeoutMs);
     const delivery = this.sessionDeliveries.get(actorKey(actor));
     if (
       delivery === undefined
@@ -2644,7 +2644,7 @@ export class ServiceStatefulRuntime {
       return;
     }
 
-    const pending = this.operations.reserve(remainingMs);
+    const pending = this.operations.register(remainingMs);
     this.submitRequest(
       pending,
       route.targetNodeRid,

package/src/runtime/framework-errors-internal.ts

@@ -69,7 +69,7 @@ const INTERNAL_TO_PUBLIC: Readonly<Record<ZLinkFrameworkInternalErrorKind, ZLink
   [ZLinkFrameworkInternalErrorKind.RequestRejected]: ZLinkFrameworkErrorKind.Rejected,
   [ZLinkFrameworkInternalErrorKind.RequestProtocolError]: ZLinkFrameworkErrorKind.ProtocolError,
   [ZLinkFrameworkInternalErrorKind.RequestFailed]: ZLinkFrameworkErrorKind.InternalFailure,
-  [ZLinkFrameworkInternalErrorKind.WorkerQueueFull]: ZLinkFrameworkErrorKind.CapacityExceeded,
+  [ZLinkFrameworkInternalErrorKind.WorkerQueueFull]: ZLinkFrameworkErrorKind.Unavailable,
   [ZLinkFrameworkInternalErrorKind.WorkerTimedOut]: ZLinkFrameworkErrorKind.DeadlineExceeded,
   [ZLinkFrameworkInternalErrorKind.WorkerFailed]: ZLinkFrameworkErrorKind.InternalFailure,
   [ZLinkFrameworkInternalErrorKind.ActorLocationStale]: ZLinkFrameworkErrorKind.Unavailable,
@@ -82,7 +82,7 @@ const INTERNAL_TO_PUBLIC: Readonly<Record<ZLinkFrameworkInternalErrorKind, ZLink
   [ZLinkFrameworkInternalErrorKind.ActorGenerationStale]: ZLinkFrameworkErrorKind.InvalidOperation,
   [ZLinkFrameworkInternalErrorKind.ActorMoving]: ZLinkFrameworkErrorKind.Unavailable,
   [ZLinkFrameworkInternalErrorKind.DeadlineExceeded]: ZLinkFrameworkErrorKind.DeadlineExceeded,
-  [ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted]: ZLinkFrameworkErrorKind.CapacityExceeded,
+  [ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted]: ZLinkFrameworkErrorKind.Unavailable,
   [ZLinkFrameworkInternalErrorKind.RoutingIdConflict]: ZLinkFrameworkErrorKind.AlreadyExists,
   [ZLinkFrameworkInternalErrorKind.SpotGenerationStale]: ZLinkFrameworkErrorKind.InvalidOperation,
   [ZLinkFrameworkInternalErrorKind.SpotMoving]: ZLinkFrameworkErrorKind.Unavailable,
@@ -145,8 +145,7 @@ const INTERNAL_KIND_BY_WIRE_FAILURE_CODE: ReadonlyMap<number, ZLinkFrameworkInte
   ...Object.entries(ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES)
     .map(([kind, code]) => [code + 1, kind as ZLinkFrameworkInternalErrorKind] as const),
   //  Spec 32-framework-error-model:99-103 — a workerQueueFull(18) received in a
-  //  remote reply is the target's queue state (Unavailable), not the source-owned
-  //  CapacityExceeded that the wire-value-minus-one derivation would give.
+  //  remote reply is the target's queue state and maps to Unavailable.
   [18, ZLinkFrameworkInternalErrorKind.RouteNotConnected]
 ]);
 
@@ -188,8 +187,8 @@ export function internalFrameworkErrorKind(
  * terminal is classified identically across languages instead of collapsing to
  * Unavailable. Spec 32-framework-error-model:81-92 (request-terminal
  * classification); a deadline yields DeadlineExceeded, a lost route Unavailable.
- * Backpressure on the REQUEST path is CapacityExceeded (distinct from the
- * one-way submit path, which is DeadlineExceeded).
+ * Backpressure waits in Core until the operation deadline, so request and
+ * one-way terminals both surface DeadlineExceeded when that wait expires.
  */
 export function requestResultToPublicErrorKind(result: number): ZLinkFrameworkErrorKind {
   switch (result) {
@@ -204,8 +203,7 @@ export function requestResultToPublicErrorKind(result: number): ZLinkFrameworkEr
     case RequestResult.Rejected:
       return ZLinkFrameworkErrorKind.Rejected;
     case RequestResult.Backpressured:
-      //  Source-owned send/completion reservation exhausted (spec 32:93-98).
-      return ZLinkFrameworkErrorKind.CapacityExceeded;
+      return ZLinkFrameworkErrorKind.DeadlineExceeded;
     case RequestResult.Conflict:
     case RequestResult.Busy:
     case RequestResult.NotConnected:
@@ -229,8 +227,8 @@ export function requestResultToPublicErrorKind(result: number): ZLinkFrameworkEr
  * coarse terminal; when absent (0) or unrecognised, the coarse terminal
  * classifies. Remote another-node queue/operation-table saturation
  * (Conflict/Busy) is Unavailable — a resource this runtime does not own — while
- * only the placement admission terminal Backpressured(113) is CapacityExceeded,
- * a target-owned admission decision rather than a queue. Shared by the lifecycle
+ * placement admission terminal Backpressured(113) is Unavailable because no
+ * node can host the Spot. Shared by the lifecycle
  * completion paths (Actor join, User Spot create/close) so they classify
  * identically to the request path instead of collapsing to a single kind.
  */

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

@@ -170,7 +170,7 @@ export class ZLinkActorPlacementCoordinator {
           //  ownership-aware translator instead of collapsing every non-OK
           //  remote create to InternalFailure (spec 32-framework-error-model:
           //  83-118, 99-108). Backpressured(113) still surfaces as target
-          //  placement capacity -> CapacityExceeded through the shared path.
+          //  placement capacity -> Unavailable through the shared path.
           throw wireReplyFailureException(
             remote.terminalResult,
             remote.failureCode,

package/src/runtime/host/index.ts

@@ -380,7 +380,8 @@ export class ZLinkFrameworkRuntimeHost implements
         this.meshRouters.classifyManualNodeTarget(meshName, targetNodeRid),
       (meshName, sourceNodeRid, parts) =>
         this.submitLocalMeshRoute(meshName, sourceNodeRid, parts),
-      this.metrics
+      this.metrics,
+      () => this.flowCreationEnabled()
     );
     this.spotAddressTransport = new ZLinkHostSpotAddressTransport({
       resolver: () => this.createLocationSpotRouteResolver(),

package/src/runtime/host/service-relocation-host-runtime.ts

@@ -5035,10 +5035,6 @@ export function relocationFailedFailureCode(
       return ServiceWireFrameworkErrorCode.requestRejected;
     case ZLinkFrameworkErrorKind.ProtocolError:
       return ServiceWireFrameworkErrorCode.requestProtocolError;
-    //  No dedicated "capacity exceeded" wire code exists; a full queue is
-    //  the closest capacity-shaped signal.
-    case ZLinkFrameworkErrorKind.CapacityExceeded:
-      return ServiceWireFrameworkErrorCode.workerQueueFull;
     //  No dedicated "deadline exceeded" wire code exists; a worker timeout
     //  is the closest timeout-shaped signal.
     case ZLinkFrameworkErrorKind.DeadlineExceeded:

package/src/runtime/host/spot-address-transport.ts

@@ -763,7 +763,7 @@ function missingInstanceRequestFailure(
           ? ZLinkFrameworkInternalErrorKind.RuntimeShutdown
           : result === RequestResult.Backpressured
             //  Spec 32-framework-error-model:104-108 — the bounded admission
-            //  terminal is target placement capacity: CapacityExceeded.
+            //  terminal is target placement capacity: Unavailable.
             ? ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted
             : result === RequestResult.NotConnected
               ? ZLinkFrameworkInternalErrorKind.RouteNotConnected

package/src/runtime/host/user-spot-creation-coordinator.ts

@@ -1110,7 +1110,7 @@ function remoteUserSpotFailure(
   //  Remote operation-table saturation Busy(108)+None is Unavailable,
   //  InvalidState(111)+None is InvalidOperation, every fine code follows the
   //  shared table, and only placement admission Backpressured(113) stays
-  //  CapacityExceeded.
+  //  Unavailable.
   return wireReplyFailureException(
     terminalResult,
     failureCode,