@zlink-systems/framework 0.31.0 → 0.32.0

package/dist/contracts/Actors/ZLinkActor.d.ts

@@ -1,7 +1,9 @@
 import type { ZLinkActorContext } from './ZLinkActorContext';
 import type { ZLinkActorJoinCompletion } from './ZLinkActorFactory';
+import type { ZLinkSessionBindingIdentity } from './ZLinkSessionBindingIdentity';
 export interface ZLinkActor {
     readonly context: ZLinkActorContext;
     configure?(): void;
     onJoinCompleted?(completion: ZLinkActorJoinCompletion): Promise<void>;
+    onDuplicateBind?(current: ZLinkSessionBindingIdentity, incoming: ZLinkSessionBindingIdentity, signal: AbortSignal): Promise<string | undefined>;
 }

package/dist/contracts/Actors/ZLinkSessionBindingIdentity.d.ts

@@ -0,0 +1,6 @@
+import type { RoutingId } from '../Common';
+export interface ZLinkSessionBindingIdentity {
+    readonly sessionOwnerNodeRid: RoutingId;
+    readonly sessionOwnerNodeGeneration: bigint;
+    readonly bindingGeneration: bigint;
+}

package/dist/contracts/Actors/ZLinkSessionBindingIdentity.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/contracts/Actors/index.d.ts

@@ -1,4 +1,5 @@
 export * from './ZLinkActor';
+export * from './ZLinkSessionBindingIdentity';
 export * from './ZLinkActorContext';
 export * from './ZLinkActorClient';
 export * from './ZLinkActorFactory';

package/dist/contracts/Actors/index.js

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./ZLinkActor"), exports);
+__exportStar(require("./ZLinkSessionBindingIdentity"), exports);
 __exportStar(require("./ZLinkActorContext"), exports);
 __exportStar(require("./ZLinkActorClient"), exports);
 __exportStar(require("./ZLinkActorFactory"), exports);

package/dist/contracts/Common/payload-slab.d.ts

@@ -0,0 +1,4 @@
+/** Allocates independent bytes; previously returned regions are never reused. */
+export declare function allocatePayloadBytes(length: number): Buffer;
+/** Copies bytes into an exact, standalone backing store with no Buffer pool. */
+export declare function copyPayloadBytes(bytes: Uint8Array): Buffer;

package/dist/contracts/Common/payload-slab.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allocatePayloadBytes = allocatePayloadBytes;
+exports.copyPayloadBytes = copyPayloadBytes;
+const SLAB_BYTES = 64 * 1024;
+const MAX_POOLED_BYTES = 16 * 1024;
+const ALIGNMENT = 8;
+let slab;
+let offset = 0;
+/** Allocates independent bytes; previously returned regions are never reused. */
+function allocatePayloadBytes(length) {
+    if (length > MAX_POOLED_BYTES || length < 0 || !Number.isInteger(length)) {
+        return Buffer.allocUnsafe(length);
+    }
+    if (slab === undefined || offset + length > SLAB_BYTES) {
+        slab = Buffer.allocUnsafe(SLAB_BYTES);
+        offset = 0;
+    }
+    const bytes = slab.subarray(offset, offset + length);
+    offset += Math.ceil(length / ALIGNMENT) * ALIGNMENT;
+    // Transient runtime frames only; local queues and application boundaries
+    // copy before they retain or expose these bytes.
+    return bytes;
+}
+/** Copies bytes into an exact, standalone backing store with no Buffer pool. */
+function copyPayloadBytes(bytes) {
+    const copy = Buffer.allocUnsafeSlow(bytes.byteLength);
+    copy.set(bytes);
+    return copy;
+}

package/dist/contracts/Handlers/Contexts.d.ts

@@ -6,6 +6,7 @@ export interface ZLinkMessageContext {
     readonly contentType?: string;
     readonly metadata: ZLinkMessageMetadata;
     readonly correlationId?: string;
+    readonly receivedAt: Date;
 }
 export interface ZLinkPublishMessageContext extends ZLinkMessageContext {
     readonly channelName: string;

package/dist/internal.d.ts

@@ -3,6 +3,11 @@ export * from './index';
 export { requireValidSendTimeoutMs } from './contracts/Configuration/SendTimeoutValidation';
 export * from './runtime/diagnostics';
 export * from './runtime/host';
+export { ZLinkActorPlacementCoordinator } from './runtime/host/actor-placement-coordinator';
+export { ZLinkActorTransferRuntime } from './runtime/host/actor-transfer-runtime';
+export { ApplicationJobQueue, ApplicationJobQueuePermit, nodeEffectiveProcessorCount, resolveApplicationJobQueueConfiguration } from './runtime/host/application-job-queue';
+export { ZLinkLocationRuntimeOwner } from './runtime/host/location-runtime-owner';
+export { relocationFailedFailureCode, ZLinkHostServiceRelocationRuntime } from './runtime/host/service-relocation-host-runtime';
 export * from './runtime/admission';
 export * from './runtime/activation-admission';
 export * from './runtime/streams';
@@ -17,9 +22,13 @@ export * from './runtime/locations/canonical-codec';
 export { ZLinkLocationAutoConnectType, ZLinkLocationKind, ZLinkRouteKind } from './contracts/Locations/Values';
 export { ZLinkLocationWriteIntent, ZLinkLocationWriteStatus } from './contracts/Locations/Writes';
 export * from './runtime/channels';
+export { ZLinkChannelRuntimeLifecycle } from './runtime/channels/channel-runtime-lifecycle';
+export { ZLinkChannelSocketRegistry } from './runtime/channels/channel-socket-registry';
+export { ZLinkChannelDispatchPipeline } from './runtime/channels/channel-dispatch-pipeline';
 export * from './runtime/backend';
 export * from './runtime/codecs';
 export * from './runtime/execution';
+export { ZLinkSerialExecutionQueue } from './runtime/execution/serial-execution-queue';
 export * from './runtime/handlers';
 export * from './runtime/messaging';
 export * from './runtime/foundation';

package/dist/internal.js

@@ -14,13 +14,27 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.requirePublicWeight = exports.isValidCapacity = exports.isValidListenerPort = exports.isValidPositiveCapacity = exports.isValidPublicWeight = exports.ZLINK_MAX_CAPACITY = exports.ZLINK_MAX_PUBLIC_WEIGHT = exports.MAX_LISTENER_PORT = exports.ZLINK_MAX_STABLE_TYPE_BYTES = exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = exports.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = exports.requireValidSendTimeoutMs = void 0;
+exports.requirePublicWeight = exports.isValidCapacity = exports.isValidListenerPort = exports.isValidPositiveCapacity = exports.isValidPublicWeight = exports.ZLINK_MAX_CAPACITY = exports.ZLINK_MAX_PUBLIC_WEIGHT = exports.MAX_LISTENER_PORT = exports.ZLINK_MAX_STABLE_TYPE_BYTES = exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = exports.ZLinkSerialExecutionQueue = exports.ZLinkChannelDispatchPipeline = exports.ZLinkChannelSocketRegistry = exports.ZLinkChannelRuntimeLifecycle = exports.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = exports.ZLinkHostServiceRelocationRuntime = exports.relocationFailedFailureCode = exports.ZLinkLocationRuntimeOwner = exports.resolveApplicationJobQueueConfiguration = exports.nodeEffectiveProcessorCount = exports.ApplicationJobQueuePermit = exports.ApplicationJobQueue = exports.ZLinkActorTransferRuntime = exports.ZLinkActorPlacementCoordinator = exports.requireValidSendTimeoutMs = void 0;
 /** Test and companion-package integration surface. It is not exported by package.json. */
 __exportStar(require("./index"), exports);
 var SendTimeoutValidation_1 = require("./contracts/Configuration/SendTimeoutValidation");
 Object.defineProperty(exports, "requireValidSendTimeoutMs", { enumerable: true, get: function () { return SendTimeoutValidation_1.requireValidSendTimeoutMs; } });
 __exportStar(require("./runtime/diagnostics"), exports);
 __exportStar(require("./runtime/host"), exports);
+var actor_placement_coordinator_1 = require("./runtime/host/actor-placement-coordinator");
+Object.defineProperty(exports, "ZLinkActorPlacementCoordinator", { enumerable: true, get: function () { return actor_placement_coordinator_1.ZLinkActorPlacementCoordinator; } });
+var actor_transfer_runtime_1 = require("./runtime/host/actor-transfer-runtime");
+Object.defineProperty(exports, "ZLinkActorTransferRuntime", { enumerable: true, get: function () { return actor_transfer_runtime_1.ZLinkActorTransferRuntime; } });
+var application_job_queue_1 = require("./runtime/host/application-job-queue");
+Object.defineProperty(exports, "ApplicationJobQueue", { enumerable: true, get: function () { return application_job_queue_1.ApplicationJobQueue; } });
+Object.defineProperty(exports, "ApplicationJobQueuePermit", { enumerable: true, get: function () { return application_job_queue_1.ApplicationJobQueuePermit; } });
+Object.defineProperty(exports, "nodeEffectiveProcessorCount", { enumerable: true, get: function () { return application_job_queue_1.nodeEffectiveProcessorCount; } });
+Object.defineProperty(exports, "resolveApplicationJobQueueConfiguration", { enumerable: true, get: function () { return application_job_queue_1.resolveApplicationJobQueueConfiguration; } });
+var location_runtime_owner_1 = require("./runtime/host/location-runtime-owner");
+Object.defineProperty(exports, "ZLinkLocationRuntimeOwner", { enumerable: true, get: function () { return location_runtime_owner_1.ZLinkLocationRuntimeOwner; } });
+var service_relocation_host_runtime_1 = require("./runtime/host/service-relocation-host-runtime");
+Object.defineProperty(exports, "relocationFailedFailureCode", { enumerable: true, get: function () { return service_relocation_host_runtime_1.relocationFailedFailureCode; } });
+Object.defineProperty(exports, "ZLinkHostServiceRelocationRuntime", { enumerable: true, get: function () { return service_relocation_host_runtime_1.ZLinkHostServiceRelocationRuntime; } });
 __exportStar(require("./runtime/admission"), exports);
 __exportStar(require("./runtime/activation-admission"), exports);
 __exportStar(require("./runtime/streams"), exports);
@@ -40,9 +54,17 @@ var Writes_1 = require("./contracts/Locations/Writes");
 Object.defineProperty(exports, "ZLinkLocationWriteIntent", { enumerable: true, get: function () { return Writes_1.ZLinkLocationWriteIntent; } });
 Object.defineProperty(exports, "ZLinkLocationWriteStatus", { enumerable: true, get: function () { return Writes_1.ZLinkLocationWriteStatus; } });
 __exportStar(require("./runtime/channels"), exports);
+var channel_runtime_lifecycle_1 = require("./runtime/channels/channel-runtime-lifecycle");
+Object.defineProperty(exports, "ZLinkChannelRuntimeLifecycle", { enumerable: true, get: function () { return channel_runtime_lifecycle_1.ZLinkChannelRuntimeLifecycle; } });
+var channel_socket_registry_1 = require("./runtime/channels/channel-socket-registry");
+Object.defineProperty(exports, "ZLinkChannelSocketRegistry", { enumerable: true, get: function () { return channel_socket_registry_1.ZLinkChannelSocketRegistry; } });
+var channel_dispatch_pipeline_1 = require("./runtime/channels/channel-dispatch-pipeline");
+Object.defineProperty(exports, "ZLinkChannelDispatchPipeline", { enumerable: true, get: function () { return channel_dispatch_pipeline_1.ZLinkChannelDispatchPipeline; } });
 __exportStar(require("./runtime/backend"), exports);
 __exportStar(require("./runtime/codecs"), exports);
 __exportStar(require("./runtime/execution"), exports);
+var serial_execution_queue_1 = require("./runtime/execution/serial-execution-queue");
+Object.defineProperty(exports, "ZLinkSerialExecutionQueue", { enumerable: true, get: function () { return serial_execution_queue_1.ZLinkSerialExecutionQueue; } });
 __exportStar(require("./runtime/handlers"), exports);
 __exportStar(require("./runtime/messaging"), exports);
 __exportStar(require("./runtime/foundation"), exports);

package/dist/runtime/actors/actor-client.d.ts

@@ -30,7 +30,7 @@ export declare class DefaultZLinkActorClient implements ZLinkActorClient {
     private send;
     private request;
     private resolveActorRoute;
-    private invalidateActorRoute;
+    private mapActorFailure;
     private throwIfKnownStale;
     private createPacketParts;
     private submitActorSend;

package/dist/runtime/actors/actor-client.js

@@ -42,10 +42,12 @@ class DefaultZLinkActorClient {
     async send(actorId, explicitPacketName, message, metadata) {
         const route = await this.resolveActorRoute(actorId);
         const { meshName, actorRef: actor } = route;
-        this.throwIfKnownStale(meshName, actor);
+        this.throwIfKnownStale(route);
         const parts = this.createPacketParts(protocol_1.ZLinkStreamMessageKind.Send, undefined, explicitPacketName, message, metadata);
+        let routeFence;
         try {
             const messageFollow = createActorMessageFollowContext(route, parts, false);
+            routeFence = actorRouteInvalidationFence(route);
             const routedActor = (0, actor_message_follow_context_1.attachActorMessageFollowContext)(actor, messageFollow);
             const submissionCopies = (await this.options.transportDeliveryGate?.()?.waitBeforeSubmit(actorId, 'oneWay')) ?? 1;
             const handoff = this.options.handoffCapture?.(meshName, actor.actorId, parts, false, routedActor);
@@ -76,12 +78,7 @@ class DefaultZLinkActorClient {
             return await this.submitActorSend(meshName, toBackendActorRef(actor), parts, route);
         }
         catch (error) {
-            if (isStaleActorError(error)) {
-                this.invalidateActorRoute(actorId);
-                this.options.staleActorRefReporter?.(meshName, actor.actorId);
-                throw actorLocationStale(actor.actorId, error);
-            }
-            throw error;
+            throw this.mapActorFailure(actorId, error, routeFence, meshName);
         }
         finally {
             closeMessages(parts);
@@ -92,6 +89,7 @@ class DefaultZLinkActorClient {
         const sourceSpotId = (0, actor_execution_context_1.currentZLinkActorExecution)()?.spotId ?? (0, execution_1.currentZLinkSpotSerialSourceId)();
         const effectiveTimeoutMs = timeoutMs ?? this.options.defaultRequestTimeoutMs;
         let meshName;
+        let routeFence;
         return this.requests.prepare(effectiveTimeoutMs, signal, (requestOperation, receiver) => {
             void (async () => {
                 const deadlineMs = requestOperation.deadlineMs;
@@ -106,14 +104,17 @@ class DefaultZLinkActorClient {
                 }
                 const { actorRef: actor } = route;
                 meshName = route.meshName;
-                if (this.options.staleActorRefPredicate?.(meshName, actor) === true)
+                if (this.options.staleActorRefPredicate?.(meshName, actor) === true) {
+                    routeFence = actorRouteInvalidationFence(route);
                     throw actorLocationStale(actor.actorId, undefined);
+                }
                 const operationId = (0, actor_message_follow_context_1.createMessageFollowId)();
                 const correlationId = (0, actor_message_follow_context_1.createMessageFollowId)();
                 const requestSequence = BigInt(`0x${operationId.slice(16)}`);
                 const parts = this.createPacketParts(protocol_1.ZLinkStreamMessageKind.Request, requestSequence === 0n ? 1n : requestSequence, explicitPacketName, request, mergeActorRequestMetadata(metadata, deadlineUnixMs), correlationId);
                 try {
                     const messageFollow = createActorMessageFollowContext(route, parts, true, deadlineUnixMs, correlationId, operationId);
+                    routeFence = actorRouteInvalidationFence(route);
                     const routedActor = (0, actor_message_follow_context_1.attachActorMessageFollowContext)(actor, messageFollow);
                     const delivery = this.options
                         .transportDeliveryGate?.()
@@ -139,15 +140,7 @@ class DefaultZLinkActorClient {
                     closeMessages(parts);
                 }
             })().catch((error) => receiver.operationFailed(requestOperation.id, error, undefined));
-        }, (value) => value, (error) => {
-            if (isStaleActorError(error)) {
-                this.invalidateActorRoute(actorId);
-                if (meshName !== undefined)
-                    this.options.staleActorRefReporter?.(meshName, actorId);
-                return actorLocationStale(actorId, error);
-            }
-            return error;
-        });
+        }, (value) => value, (error) => this.mapActorFailure(actorId, error, routeFence, meshName));
     }
     async resolveActorRoute(actorId, signal, deadlineMs, requestOperation) {
         const resolver = this.options.locationResolver();
@@ -163,15 +156,21 @@ class DefaultZLinkActorClient {
         }
         return resolution.route;
     }
-    invalidateActorRoute(actorId) {
-        this.options.locationResolver()?.invalidateActorRoute(actorId);
+    mapActorFailure(actorId, error, routeFence, meshName) {
+        if (!isStaleActorError(error))
+            return error;
+        const resolver = this.options.locationResolver();
+        if (routeFence !== undefined && resolver !== undefined)
+            resolver.invalidateActorRouteIfMatches(routeFence);
+        if (meshName !== undefined)
+            this.options.staleActorRefReporter?.(meshName, actorId);
+        return actorLocationStale(actorId, error);
     }
-    throwIfKnownStale(meshName, actor) {
+    throwIfKnownStale(route) {
+        const { meshName, actorRef: actor } = route;
         if (this.options.staleActorRefPredicate?.(meshName, actor) !== true)
             return;
-        this.invalidateActorRoute(actor.actorId);
-        this.options.staleActorRefReporter?.(meshName, actor.actorId);
-        throw actorLocationStale(actor.actorId, undefined);
+        throw this.mapActorFailure(actor.actorId, actorLocationStale(actor.actorId, undefined), actorRouteInvalidationFence(route), meshName);
     }
     createPacketParts(kind, requestSeq, explicitPacketName, message, metadata, correlationId) {
         const packetName = (0, packet_name_1.resolveFrameworkPacketName)(message, explicitPacketName, 'Actor');
@@ -301,6 +300,16 @@ function nativeActorRouteFence(route, actor) {
         ownerLeaseGeneration: route.ownerLeaseGeneration
     };
 }
+function actorRouteInvalidationFence(route) {
+    return {
+        actorId: route.actorRef.actorId,
+        objectGeneration: route.actorRef.objectGeneration,
+        targetNodeRid: route.actorRef.nodeRid,
+        targetNodeGeneration: route.ownerNodeGeneration,
+        authorityOwnerGeneration: route.authorityOwnerGeneration,
+        ownerLeaseGeneration: route.ownerLeaseGeneration
+    };
+}
 function remoteActorRouteTarget(route) {
     if (route.enclosingSpotRoute !== undefined) {
         return route.enclosingSpotRoute;

package/dist/runtime/actors/actor-mailbox.d.ts

@@ -2,7 +2,7 @@ import { ZLinkSerialExecutionQueue, type ZLinkSerialSchedulerOptions, type ZLink
 export declare class ZLinkActorSerialExecutor {
     private readonly actorId;
     private readonly sourceSpotId;
-    private readonly scheduler;
+    readonly scheduler: ZLinkSerialExecutionQueue;
     constructor(actorId: string, sourceSpotId: unknown, options?: ZLinkSerialSchedulerOptions, sharedOwner?: ZLinkSerialExecutionQueue);
     execute<T>(operation: () => Promise<T> | T, workOptions?: ZLinkSerialWorkOptions): Promise<T>;
     close(): Promise<void>;

package/dist/runtime/actors/actor-runtime-state.d.ts

@@ -77,7 +77,7 @@ export declare class ZLinkActorRuntimeState {
     private spotMembershipEpochValue;
     private nativeActorRefValue;
     private entryNodeRidValue;
-    private boundSessionValue;
+    boundSessionValue: ZLinkRemoteBoundSessionTarget | undefined;
     private remoteActorPacketTargetValue;
     private createRequestPayloadValue;
     private ownsLocationValue;

package/dist/runtime/actors/spot-actor-dispatch.d.ts

@@ -54,8 +54,10 @@ export declare class ZLinkSpotActorDispatcher {
     notifyDisconnectActor(actor: ZLinkActor): Promise<void>;
     private requirePacket;
     private ensureActorType;
-    private invokeHandler;
+    invokeHandler<THandler, TResult>(actor: ZLinkActor, descriptor: Pick<ZLinkActorPacketDescriptor, 'handlerType' | 'methodName'>, callback: (handler: THandler, method: THandler extends {
+        handle: infer TMethod;
+    } ? TMethod : never) => Promise<TResult>): Promise<TResult>;
     private execute;
-    private createContext;
+    createContext(packetName: string, context: Partial<ZLinkMessageContext> | undefined): ZLinkMessageContext;
 }
 export {};

package/dist/runtime/actors/spot-actor-dispatch.js

@@ -205,7 +205,8 @@ class ZLinkSpotActorDispatcher {
             packetName,
             contentType: context?.contentType,
             metadata: context?.metadata ?? contracts_1.ZLinkMessageMetadataEmpty,
-            correlationId: context?.correlationId
+            correlationId: context?.correlationId,
+            receivedAt: context?.receivedAt ?? new Date()
         };
     }
 }

package/dist/runtime/application-jobs/application-ingress-record-owner.d.ts

@@ -29,6 +29,7 @@ export declare class ApplicationJobRecordLease implements ApplicationJobPermitPo
     private processingTerminal;
     detachedForHandlerTurn: boolean;
     constructor(shared: SharedIngressRecordState, permit: ApplicationJobPermitPort | undefined);
+    reacquire(signal: AbortSignal): Promise<ApplicationJobPermitPort>;
     get origin(): ApplicationJobOrigin;
     markApplicationQueued(): void;
     detachForHandlerTurn(): void;

package/dist/runtime/application-jobs/application-ingress-record-owner.js

@@ -84,6 +84,9 @@ class ApplicationJobRecordLease {
         this.shared = shared;
         this.permit = permit;
     }
+    reacquire(signal) {
+        return this.shared.acquirePermit(signal);
+    }
     get origin() {
         return this.shared.origin;
     }

package/dist/runtime/backend/contracts/index.d.ts

@@ -472,6 +472,8 @@ export interface ZLinkMeshBackendAdapter {
     createMeshNode(context: ZLinkBackendContext, options: {
         readonly meshName: string;
         readonly routingId?: RoutingId;
+        readonly sendHighWaterMark?: number;
+        readonly receiveHighWaterMark?: number;
         readonly receiveTimeoutMs?: number;
         readonly trustProfile?: string;
         readonly applicationJobQueue: import('../../application-jobs/contracts').ApplicationJobQueuePort;

package/dist/runtime/backend/mesh-completion-table.d.ts

@@ -9,6 +9,7 @@ export interface ZLinkMeshCompletionDiagnostic {
 export interface ZLinkMeshCompletion {
     readonly terminalResult: number;
     readonly failureErrno: number;
+    readonly failureMessage?: string;
     readonly operationKind: number;
     readonly kindData: ReceiveKindData | null;
     readonly parts: Message[];

package/dist/runtime/backend/mesh-completion-table.js

@@ -269,6 +269,7 @@ function retainCompletion(record) {
     return {
         terminalResult: record.terminalResult,
         failureErrno: record.failureErrno,
+        ...(record.failureMessage === undefined ? {} : { failureMessage: record.failureMessage }),
         operationKind: record.operationKind,
         kindData: record.kindData,
         parts

package/dist/runtime/backend/node/node-mesh-backend-adapter.js

@@ -12,7 +12,11 @@ class ZLinkNodeMeshBackendAdapter {
         if (!isBindingContext(bindingContext)) {
             throw new TypeError('Node MeshNode creation requires the Node binding Context owned by the host.');
         }
-        return new node_raw_mesh_backend_1.ZLinkNodeRawMeshBackend(options.meshName, options.routingId, new node_raw_binding_port_1.ZLinkNodeRawBindingPort(bindingContext, options.receiveTimeoutMs), options.applicationJobQueue, options.applicationJobReceiveFlowFailureSink, options.peerAdmissionSealed, options.infrastructureTaskRunner);
+        return new node_raw_mesh_backend_1.ZLinkNodeRawMeshBackend(options.meshName, options.routingId, new node_raw_binding_port_1.ZLinkNodeRawBindingPort(bindingContext, {
+            sendHighWaterMark: options.sendHighWaterMark,
+            receiveHighWaterMark: options.receiveHighWaterMark,
+            receiveTimeoutMs: options.receiveTimeoutMs
+        }), options.applicationJobQueue, options.applicationJobReceiveFlowFailureSink, options.peerAdmissionSealed, options.infrastructureTaskRunner);
     }
 }
 exports.ZLinkNodeMeshBackendAdapter = ZLinkNodeMeshBackendAdapter;

package/dist/runtime/backend/node/node-raw-binding-port.d.ts

@@ -1,9 +1,14 @@
 import { type Context } from '@zlink-systems/zlink';
 import type { ZLinkRawBindingPort, ZLinkRawHostPort } from '../raw-binding-port';
+interface ZLinkNodeRawRouterSocketOptions {
+    readonly sendHighWaterMark?: number;
+    readonly receiveHighWaterMark?: number;
+    readonly receiveTimeoutMs?: number;
+}
 export type { ZLinkRawBindingPort, ZLinkRawDealerPort, ZLinkRawHostPort, ZLinkRawMonitorPort, ZLinkRawMonitorRecord, ZLinkRawReceivedRecord, ZLinkRawRouterPort, ZLinkRawRouterRoute, ZLinkRawSocketPort } from '../raw-binding-port';
 export declare class ZLinkNodeRawBindingPort implements ZLinkRawBindingPort {
     private readonly sharedContext?;
-    private readonly routerReceiveTimeoutMs?;
-    constructor(sharedContext?: Context | undefined, routerReceiveTimeoutMs?: number | undefined);
+    private readonly routerSocketOptions?;
+    constructor(sharedContext?: Context | undefined, routerSocketOptions?: ZLinkNodeRawRouterSocketOptions | undefined);
     createHost(): ZLinkRawHostPort;
 }

package/dist/runtime/backend/node/node-raw-binding-port.js

@@ -11,30 +11,30 @@ const node_event_loop_poller_1 = require("./node-event-loop-poller");
 const runtime_message_1 = require("../runtime-message");
 class ZLinkNodeRawBindingPort {
     sharedContext;
-    routerReceiveTimeoutMs;
-    constructor(sharedContext, routerReceiveTimeoutMs) {
+    routerSocketOptions;
+    constructor(sharedContext, routerSocketOptions) {
         this.sharedContext = sharedContext;
-        this.routerReceiveTimeoutMs = routerReceiveTimeoutMs;
+        this.routerSocketOptions = routerSocketOptions;
     }
     createHost() {
-        return new NodeRawHostPort(this.sharedContext ?? (0, zlink_1.createContext)(), this.sharedContext === undefined, this.routerReceiveTimeoutMs);
+        return new NodeRawHostPort(this.sharedContext ?? (0, zlink_1.createContext)(), this.sharedContext === undefined, this.routerSocketOptions);
     }
 }
 exports.ZLinkNodeRawBindingPort = ZLinkNodeRawBindingPort;
 class NodeRawHostPort {
     context;
     ownsContext;
-    routerReceiveTimeoutMs;
+    routerSocketOptions;
     resources = [];
     state = 'open';
-    constructor(context, ownsContext, routerReceiveTimeoutMs) {
+    constructor(context, ownsContext, routerSocketOptions) {
         this.context = context;
         this.ownsContext = ownsContext;
-        this.routerReceiveTimeoutMs = routerReceiveTimeoutMs;
+        this.routerSocketOptions = routerSocketOptions;
     }
     createRouter() {
         this.requireOpen();
-        return this.own(new NodeRawRouterPort((0, zlink_1.createRouterSocket)(this.context), this.routerReceiveTimeoutMs));
+        return this.own(new NodeRawRouterPort((0, zlink_1.createRouterSocket)(this.context), this.routerSocketOptions));
     }
     createDealer() {
         this.requireOpen();
@@ -218,13 +218,19 @@ class NodeRawRouterPort extends NodeRawSocketPort {
         this.requireOpen();
         (0, node_socket_backend_adapter_1.disconnectSocketPeer)(this.socket, this.preparedRoutingId(routingId));
     }
-    constructor(socket, receiveTimeoutMs) {
+    constructor(socket, options) {
         super(socket, true);
         socket.options.handover = true;
         socket.options.mandatory = true;
         socket.options.probe = true;
-        if (receiveTimeoutMs !== undefined) {
-            socket.options.recvTimeout = receiveTimeoutMs;
+        if (options?.sendHighWaterMark !== undefined) {
+            socket.options.sendHwm = BigInt(options.sendHighWaterMark);
+        }
+        if (options?.receiveHighWaterMark !== undefined) {
+            socket.options.recvHwm = BigInt(options.receiveHighWaterMark);
+        }
+        if (options?.receiveTimeoutMs !== undefined) {
+            socket.options.recvTimeout = options.receiveTimeoutMs;
         }
     }
     localEndpoint() {

package/dist/runtime/backend/node/node-raw-mesh-backend.d.ts

@@ -36,7 +36,7 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     private readonly lifecycleGeneration;
     private bindEndpoint?;
     private advertiseHost?;
-    private runtime?;
+    runtime?: RawServiceMeshRuntime;
     private stateful?;
     private readyHandler?;
     private maintenanceTimer?;
@@ -277,7 +277,7 @@ export declare class ZLinkNodeRawMeshBackend implements ZLinkBackendMeshNode {
     setSpotSubscription(state: ServiceSpotState, channelName: string, topicFilter: string): void;
     unsetSpotSubscription(state: ServiceSpotState, channelName: string, topicFilter: string): void;
     clearSpotSubscriptions(state: ServiceSpotState): void;
-    private createDescriptor;
+    createDescriptor(): ServiceNodeDescriptor;
     private resolveAdvertisedEndpoint;
     /**
      * Arms the one maintenance timer for the nearest management deadline

package/dist/runtime/backend/node/node-raw-mesh-backend.js

@@ -369,6 +369,7 @@ class ZLinkNodeRawMeshBackend {
     }
     expectPeer(peer) {
         this.requireRuntime().expectPeerByRoutingId(peer.endpoint, peer.nodeRoutingId, peer.securityIdentity, peer.lifecycleGeneration);
+        this.scheduleMaintenance();
     }
     removePeerConnection(intentId) {
         const intent = this.peerIntents.get(intentId);
@@ -1447,6 +1448,9 @@ function completionRecord(operationId, operationKind, result) {
         kindData: 'kindData' in result ? (result.kindData ?? null) : null,
         terminalResult: result.terminalResult,
         failureErrno: result.failureCode,
+        ...('failureMessage' in result && result.failureMessage !== undefined
+            ? { failureMessage: result.failureMessage }
+            : {}),
         parts: payload === undefined
             ? []
             : payload.contentType === MULTIPART_CONTENT_TYPE
@@ -1667,10 +1671,10 @@ function decodeStatefulRecord(record, stateful) {
             });
             return accepted ? zlink_1.SubmitResult.Ok : zlink_1.SubmitResult.InvalidState;
         },
-        replyFailure(terminalResult, failureCode) {
+        replyFailure(terminalResult, failureCode, tail) {
             if (stateful.reply === undefined)
                 return zlink_1.SubmitResult.InvalidState;
-            return stateful.reply(terminalResult, failureCode)
+            return stateful.reply(terminalResult, failureCode, undefined, tail)
                 ? zlink_1.SubmitResult.Ok
                 : zlink_1.SubmitResult.InvalidState;
         }
@@ -1678,12 +1682,15 @@ function decodeStatefulRecord(record, stateful) {
 }
 function receiveIngressLifecycle(record) {
     const applicationJob = record.applicationJob;
-    return applicationJob === undefined
-        ? {}
-        : {
-            applicationJobPermit: applicationJob,
-            releaseRetainedIngress: () => applicationJob.close()
-        };
+    return {
+        ...(record.receivedAt === undefined ? {} : { receivedAt: record.receivedAt }),
+        ...(applicationJob === undefined
+            ? {}
+            : {
+                applicationJobPermit: applicationJob,
+                releaseRetainedIngress: () => applicationJob.close()
+            })
+    };
 }
 function prepareStatefulMailboxDispatch(signal) {
     const mailboxRecord = this.statefulMailboxRecord;

package/dist/runtime/channels/channel-dispatch-pipeline.d.ts

@@ -2,7 +2,7 @@ import type { ZLinkHandlerMessageType } from '../../contracts/Common/HandlerMess
 import type { ZLinkMeshDispatchAdmission } from '../admission';
 import type { ZLinkMessageContext, ZLinkHandlerFilter, ZLinkUnhandledDispatchOptions, ZLinkFlowOrigin } from '../../contracts';
 import { ZLinkFrameworkException } from '../../contracts';
-import { ZLinkDispatchMessageKind, ZLinkDispatchErrorSurface } from '../../contracts/Dispatch/ZLinkDispatchOptions';
+import { ZLinkRuntimeMessageFlowOutcome as ZLinkMessageFlowOutcome, ZLinkDispatchMessageKind, ZLinkDispatchErrorSurface } from '../../contracts/Dispatch/ZLinkDispatchOptions';
 import { type ZLinkChannelEnvelope, type ZLinkChannelEnvelopeCodecRegistry } from './channel-envelope';
 import type { ZLinkMalformedChannelHeaderInfo } from './channel-envelope-inspection';
 import type { ZLinkDispatchErrorReporter } from './dispatch-error-reporter';
@@ -47,8 +47,8 @@ export interface ZLinkRequestDispatch<TContext extends ZLinkMessageContext> {
     readonly writeError: (error: unknown) => void | Promise<void>;
 }
 export declare class ZLinkChannelDispatchPipeline {
-    private readonly options;
-    private readonly filters;
+    readonly options: ZLinkChannelDispatchPipelineOptions;
+    readonly filters: readonly ZLinkHandlerFilter[];
     private readonly unhandled;
     constructor(options: ZLinkChannelDispatchPipelineOptions);
     /**
@@ -67,7 +67,7 @@ export declare class ZLinkChannelDispatchPipeline {
      */
     dispatchRequest<TContext extends ZLinkMessageContext>(dispatch: ZLinkRequestDispatch<TContext>, admit?: ZLinkMeshDispatchAdmission): void | Promise<void>;
     private dispatchMissingRequest;
-    private invokeInFlow;
+    invokeInFlow<TContext extends ZLinkMessageContext, TResult>(dispatch: ZLinkOneWayDispatch<TContext> | ZLinkRequestDispatch<TContext>, handler: ZLinkChannelDispatchHandler<TContext, TResult>): unknown;
     private completeRequest;
     private replyPathMissing;
     private failRequest;
@@ -87,13 +87,14 @@ export declare class ZLinkChannelDispatchPipeline {
         readonly sourceRid?: string;
         readonly writeProtocolError?: (error: ZLinkFrameworkException) => Promise<void>;
     }): Promise<void>;
-    private invoke;
+    invoke<TContext extends ZLinkMessageContext, TResult>(dispatch: ZLinkOneWayDispatch<TContext> | ZLinkRequestDispatch<TContext>, handler: ZLinkChannelDispatchHandler<TContext, TResult>): TResult | undefined | typeof HANDLER_FILTER_REJECTED | Promise<TResult | undefined | typeof HANDLER_FILTER_REJECTED>;
     private invokeFiltered;
     private createFilterContext;
     private dispatchKind;
     private report;
-    private trace;
+    trace(outcome: ZLinkMessageFlowOutcome, fields: ZLinkChannelDispatchFields): void;
     private failureReason;
     private applyOneWayUnhandled;
 }
+declare const HANDLER_FILTER_REJECTED: unique symbol;
 export {};

package/dist/runtime/channels/channel-dispatch-pipeline.js

@@ -225,6 +225,7 @@ class ZLinkChannelDispatchPipeline {
             contentType: context.contentType,
             metadata: context.metadata,
             correlationId: context.correlationId,
+            receivedAt: context.receivedAt,
             dispatchKind
         };
     }