@zlink-systems/framework 0.21.0 → 0.23.0

package/dist/runtime/channels/channel-transports.js

@@ -42,9 +42,9 @@ class ZLinkRuntimeRouteTransport {
         return this.routeChannelPredicate?.(routerChannelId) ?? false;
     }
     canRoutePacketChannel(routerChannelId) {
-        return this.manager()?.canRoutePacketChannel(routerChannelId)
-            ?? this.routeChannelPredicate?.(routerChannelId)
-            ?? false;
+        return (this.manager()?.canRoutePacketChannel(routerChannelId) ??
+            this.routeChannelPredicate?.(routerChannelId) ??
+            false);
     }
     async submit(meshName, targetNodeRid, packetName, message, signal, metadata) {
         // Call-scoped flow (spec 27 §4): the envelope flow pair lives only for
@@ -60,8 +60,8 @@ class ZLinkRuntimeRouteTransport {
             return this.requireManager().routeSubmit(meshName, targetNodeRid, packetName, message, signal, metadata);
         }
         (0, abort_1.throwIfAborted)(signal);
-        if (!allowObjectClientTarget
-            && node.isObjectClientNodeDirectTarget?.((0, routing_id_1.toBackendRoutingId)(targetNodeRid)) === true) {
+        if (!allowObjectClientTarget &&
+            node.isObjectClientNodeDirectTarget?.((0, routing_id_1.toBackendRoutingId)(targetNodeRid)) === true) {
             return { status: submission_result_1.ZLinkSubmitStatus.TargetNotFound };
         }
         const parts = this.encodeMessage(3 /* ZLinkChannelMessageKind.Command */, meshName, packetName, message, undefined, metadata);
@@ -69,8 +69,8 @@ class ZLinkRuntimeRouteTransport {
         if (this.isSelfNode(node, targetNodeRid)) {
             return this.submitLocalNode(meshName, String(node.status().routingId), parts);
         }
-        if (!this.isKnownBackendPeer(node, targetNodeRid)
-            && this.manualNodeTarget?.(meshName, targetNodeRid) === false) {
+        if (!this.isKnownBackendPeer(node, targetNodeRid) &&
+            this.manualNodeTarget?.(meshName, targetNodeRid) === false) {
             return { status: submission_result_1.ZLinkSubmitStatus.TargetNotFound };
         }
         try {
@@ -93,7 +93,10 @@ class ZLinkRuntimeRouteTransport {
             throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound, `MeshNode '${meshName}' target '${targetNodeRid}' is an Object Client.`);
         }
         const parts = this.encodeMessage(1 /* ZLinkChannelMessageKind.Request */, meshName, packetName, request, timeoutMs ?? 30_000, metadata);
-        const completion = await this.submitRequestOperation(meshName, timeoutMs, signal, `MeshNode '${meshName}' request to node '${targetNodeRid}'`, (remainingTimeoutMs) => node.requestToNode((0, routing_id_1.toBackendRoutingId)(targetNodeRid), parts, { flags: 1, timeoutMs: remainingTimeoutMs }));
+        const completion = await this.submitRequestOperation(meshName, timeoutMs, signal, `MeshNode '${meshName}' request to node '${targetNodeRid}'`, (remainingTimeoutMs) => node.requestToNode((0, routing_id_1.toBackendRoutingId)(targetNodeRid), parts, {
+            flags: 1,
+            timeoutMs: remainingTimeoutMs
+        }));
         return this.decodeMeshReply(meshName, completion);
     }
     submitToChannel(meshName, channelName, packetName, message, signal, metadata) {
@@ -170,7 +173,9 @@ class ZLinkRuntimeRouteTransport {
             if (spotRouteTarget.spotKind === Spots_1.ZLinkSpotKind.Instance) {
                 return mapMeshSubmitResult(await node.sendToInstanceSpot(instanceSpotRouteFence(spotRouteTarget), encoded, undefined, options.metadata));
             }
-            return mapMeshSubmitResult(await node.entrySpot().sendToSpot((0, routing_id_1.toBackendRoutingId)(spotRouteTarget.targetNodeRid), (0, routing_id_1.toBackendRoutingId)(spotRouteTarget.spotId), spotRouteTarget.targetSpotGeneration ?? 0n, encoded, {
+            return mapMeshSubmitResult(await node
+                .entrySpot()
+                .sendToSpot((0, routing_id_1.toBackendRoutingId)(spotRouteTarget.targetNodeRid), (0, routing_id_1.toBackendRoutingId)(spotRouteTarget.spotId), spotRouteTarget.targetSpotGeneration ?? 0n, encoded, {
                 flags: 1,
                 routeFence: directSpotRouteFence(spotRouteTarget),
                 entrySpot: spotRouteTarget.spotKind === Spots_1.ZLinkSpotKind.Entry
@@ -202,7 +207,9 @@ class ZLinkRuntimeRouteTransport {
             const encoded = this.encodeMessage(1 /* ZLinkChannelMessageKind.Request */, meshName, options.packetName, request, options.timeoutMs, options.metadata);
             completionPromise = this.completionTable(meshName).submit(() => spotRouteTarget.spotKind === Spots_1.ZLinkSpotKind.Instance
                 ? node.requestInstanceSpot(instanceSpotRouteFence(spotRouteTarget), encoded, options.timeoutMs, undefined, options.metadata)
-                : node.entrySpot().requestToSpot((0, routing_id_1.toBackendRoutingId)(spotRouteTarget.targetNodeRid), (0, routing_id_1.toBackendRoutingId)(spotRouteTarget.spotId), spotRouteTarget.targetSpotGeneration ?? 0n, encoded, {
+                : node
+                    .entrySpot()
+                    .requestToSpot((0, routing_id_1.toBackendRoutingId)(spotRouteTarget.targetNodeRid), (0, routing_id_1.toBackendRoutingId)(spotRouteTarget.spotId), spotRouteTarget.targetSpotGeneration ?? 0n, encoded, {
                     flags: 1,
                     timeoutMs: options.timeoutMs,
                     routeFence: directSpotRouteFence(spotRouteTarget),
@@ -229,13 +236,13 @@ class ZLinkRuntimeRouteTransport {
         if (node !== undefined) {
             (0, abort_1.throwIfAborted)(options.signal);
             const payload = JSON.parse(request.getString('utf8'));
-            const packetName = typeof payload.packetName === 'string'
-                ? payload.packetName
-                : undefined;
+            const packetName = typeof payload.packetName === 'string' ? payload.packetName : undefined;
             const parts = this.encodeMessage(1 /* ZLinkChannelMessageKind.Request */, meshName, packetName, payload, options.timeoutMs);
             let completionPromise;
             try {
-                completionPromise = this.completionTable(meshName).submit(() => node.entrySpot().requestToSpot((0, routing_id_1.toBackendRoutingId)(spotRouteTarget.targetNodeRid), (0, routing_id_1.toBackendRoutingId)(spotRouteTarget.spotId), spotRouteTarget.targetSpotGeneration ?? 0n, parts, {
+                completionPromise = this.completionTable(meshName).submit(() => node
+                    .entrySpot()
+                    .requestToSpot((0, routing_id_1.toBackendRoutingId)(spotRouteTarget.targetNodeRid), (0, routing_id_1.toBackendRoutingId)(spotRouteTarget.spotId), spotRouteTarget.targetSpotGeneration ?? 0n, parts, {
                     flags: 1,
                     timeoutMs: options.timeoutMs,
                     routeFence: directSpotRouteFence(spotRouteTarget),
@@ -279,7 +286,10 @@ class ZLinkRuntimeRouteTransport {
         return (0, routing_id_1.routingIdsEqual)(node.status().routingId, targetNodeRid);
     }
     isKnownBackendPeer(node, targetNodeRid) {
-        return node.peers().some((peer) => peer.routingId !== null && (0, routing_id_1.routingIdsEqual)(peer.routingId, targetNodeRid));
+        return node
+            .peers()
+            .some((peer) => peer.routingId !== null &&
+            (0, routing_id_1.routingIdsEqual)(peer.routingId, targetNodeRid));
     }
     submitLocalNode(meshName, sourceNodeRid, parts) {
         if (this.localNodeSubmit === undefined) {
@@ -328,12 +338,12 @@ function directSpotRouteFence(target) {
     if (target.spotKind === Spots_1.ZLinkSpotKind.Entry) {
         return undefined;
     }
-    if (target.targetSpotGeneration === undefined
-        || target.targetNodeGeneration === undefined
-        || target.authorityOwnerGeneration === undefined
-        || target.targetOwnerId === undefined
-        || target.ownerLeaseGeneration === undefined
-        || target.authorityStoreVersion === undefined) {
+    if (target.targetSpotGeneration === undefined ||
+        target.targetNodeGeneration === undefined ||
+        target.authorityOwnerGeneration === undefined ||
+        target.targetOwnerId === undefined ||
+        target.ownerLeaseGeneration === undefined ||
+        target.authorityStoreVersion === undefined) {
         throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound, `Spot '${String(target.spotId)}' has no complete Ready authority fence.`);
     }
     return {
@@ -349,12 +359,12 @@ function directSpotRouteFence(target) {
     };
 }
 function instanceSpotRouteFence(target) {
-    if (target.targetSpotGeneration === undefined
-        || target.targetNodeGeneration === undefined
-        || target.authorityOwnerGeneration === undefined
-        || target.targetOwnerId === undefined
-        || target.ownerLeaseGeneration === undefined
-        || target.authorityStoreVersion === undefined) {
+    if (target.targetSpotGeneration === undefined ||
+        target.targetNodeGeneration === undefined ||
+        target.authorityOwnerGeneration === undefined ||
+        target.targetOwnerId === undefined ||
+        target.ownerLeaseGeneration === undefined ||
+        target.authorityStoreVersion === undefined) {
         throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.SpotRouteNotFound, `Instance Spot '${String(target.spotId)}' has no complete Ready authority fence.`);
     }
     return {
@@ -399,10 +409,10 @@ function mapMeshSubmissionError(error, operation) {
     }
     if ((0, runtime_values_1.isZLinkBackendResultError)(error)) {
         const notFound = error.result === runtime_values_1.SubmitResult.NotFound || error.result === 102;
-        const retriable = error.result === runtime_values_1.SubmitResult.Backpressured
-            || error.result === runtime_values_1.SubmitResult.NotConnected
-            || error.result === 109
-            || error.result === 113;
+        const retriable = error.result === runtime_values_1.SubmitResult.Backpressured ||
+            error.result === runtime_values_1.SubmitResult.NotConnected ||
+            error.result === 109 ||
+            error.result === 113;
         return (0, framework_errors_internal_1.createInternalFrameworkException)(notFound
             ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound
             : framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected, `${operation} failed with result ${error.result}.`, retriable, error);
@@ -414,15 +424,9 @@ function meshRequestFailure(meshName, result, nativeErrno) {
     const wireKind = canonical
         ? (0, framework_errors_internal_1.internalFrameworkErrorKindFromWireReply)(result, nativeErrno)
         : undefined;
-    // NotFound without an errno is the selection itself coming back empty: the
-    // send path and its connection are there, and applying eligibility and drain
-    // left no member to pick. The spec names that Unavailable, not NotFound, and
-    // not the protocol error a non-canonical pair would otherwise produce
-    // (06-framework-api "no eligible select-one member"). A named target that
-    // does not exist arrives with an errno and still ends as NotFound.
-    const noEligibleMember = result === runtime_values_1.RequestResult.NotFound && nativeErrno === 0;
-    const kind = noEligibleMember
-        ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected
+    const localNoMember = result === runtime_values_1.RequestResult.NotFound && nativeErrno === 0;
+    const kind = localNoMember
+        ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound
         : !canonical
             ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestProtocolError
             : result === runtime_values_1.RequestResult.NotFound
@@ -432,10 +436,10 @@ function meshRequestFailure(meshName, result, nativeErrno) {
                     : result === runtime_values_1.RequestResult.Terminated
                         ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RuntimeShutdown
                         : result === runtime_values_1.RequestResult.Conflict || result === runtime_values_1.RequestResult.InternalError
-                            ? wireKind ?? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestProtocolError
+                            ? (wireKind ?? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestProtocolError)
                             : result === runtime_values_1.RequestResult.NotConnected || result === runtime_values_1.RequestResult.Backpressured
                                 ? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RouteNotConnected
-                                : wireKind ?? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestFailed;
+                                : (wireKind ?? framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestFailed);
     const error = (0, framework_errors_internal_1.createInternalFrameworkException)(kind, `MeshNode '${meshName}' request failed with result ${result} and errno ${nativeErrno}.`, result === runtime_values_1.RequestResult.NotConnected || result === runtime_values_1.RequestResult.Backpressured);
     // An operation id was returned before this completion was observed. The
     // application envelope therefore crossed the native submission boundary,

package/dist/runtime/channels/client-server-location-runtime.js

@@ -73,7 +73,7 @@ class ZLinkClientServerLocationRuntime {
     }
     activeTargets(channelName) {
         return [...this.connections.values()]
-            .filter(target => target.state === 'ready')
+            .filter((target) => target.state === 'ready')
             .map((target) => target.descriptor)
             .filter((descriptor) => descriptor.channelName === channelName);
     }
@@ -81,8 +81,7 @@ class ZLinkClientServerLocationRuntime {
         const owner = this.requireOwnerToken();
         const descriptors = await this.lane.run(() => [...this.localDescriptors]);
         for (const [channelName, current] of descriptors) {
-            if (current.ownerId === owner.ownerId
-                && current.leaseGeneration === owner.leaseGeneration) {
+            if (current.ownerId === owner.ownerId && current.leaseGeneration === owner.leaseGeneration) {
                 continue;
             }
             const candidate = {
@@ -152,10 +151,7 @@ class ZLinkClientServerLocationRuntime {
                 continue;
             }
             const rows = await this.listLiveServers(channelName, signal);
-            const desired = new Map(rows.map((descriptor) => [
-                clientServerConnectionId(descriptor),
-                descriptor
-            ]));
+            const desired = new Map(rows.map((descriptor) => [clientServerConnectionId(descriptor), descriptor]));
             const desiredStableKeys = new Set(rows.map(clientServerStableKey));
             for (const [connectionId, descriptor] of desired) {
                 const current = await this.lane.run(() => this.connections.get(connectionId));
@@ -185,8 +181,8 @@ class ZLinkClientServerLocationRuntime {
             for (const [connectionId, current] of connections) {
                 if (current.descriptor.channelName !== channelName || desired.has(connectionId))
                     continue;
-                if (desiredStableKeys.has(clientServerStableKey(current.descriptor))
-                    && current.state === 'ready') {
+                if (desiredStableKeys.has(clientServerStableKey(current.descriptor)) &&
+                    current.state === 'ready') {
                     continue;
                 }
                 await this.closeConnection(connectionId);
@@ -203,14 +199,14 @@ class ZLinkClientServerLocationRuntime {
         } while (continuationToken !== undefined);
         const live = [];
         for (const descriptor of rows) {
-            if (descriptor.state === Locations_1.ZLinkFrameworkRuntimeState.Stopped
-                || descriptor.state === Locations_1.ZLinkFrameworkRuntimeState.Error) {
+            if (descriptor.state === Locations_1.ZLinkFrameworkRuntimeState.Stopped ||
+                descriptor.state === Locations_1.ZLinkFrameworkRuntimeState.Error) {
                 continue;
             }
             const lease = await this.stores.ownerLeaseStore.readOwnerLease(descriptor.ownerId, signal);
-            if (lease.kind === 'found'
-                && lease.token.leaseGeneration === descriptor.leaseGeneration
-                && lease.leaseExpiresAt.getTime() > lease.storeNow.getTime()) {
+            if (lease.kind === 'found' &&
+                lease.token.leaseGeneration === descriptor.leaseGeneration &&
+                lease.leaseExpiresAt.getTime() > lease.storeNow.getTime()) {
                 live.push(descriptor);
             }
         }
@@ -218,7 +214,7 @@ class ZLinkClientServerLocationRuntime {
     }
     async disconnectClients() {
         const connectionIds = await this.lane.run(() => [...this.connections.keys()]);
-        await Promise.allSettled(connectionIds.map(connectionId => this.closeConnection(connectionId)));
+        await Promise.allSettled(connectionIds.map((connectionId) => this.closeConnection(connectionId)));
     }
     async openConnection(descriptor, connectionId) {
         const target = {
@@ -231,8 +227,7 @@ class ZLinkClientServerLocationRuntime {
         try {
             target.dealer = this.sockets.openClientServerConnection(descriptor.channelName, connectionId, descriptor.endpoint, {
                 onTransportReady: (routingId, endpoint) => {
-                    void this.handleTransportReady(connectionId, routingId, endpoint)
-                        .catch(error => this.locationRuntime.reportDiscoveryFailure(error));
+                    void this.handleTransportReady(connectionId, routingId, endpoint).catch((error) => this.locationRuntime.reportDiscoveryFailure(error));
                 },
                 onTerminated: () => {
                     void this.handleConnectionTerminated(connectionId);
@@ -310,8 +305,7 @@ class ZLinkClientServerLocationRuntime {
                 return retryAdmission;
             });
             if (shouldRetry) {
-                void this.handleTransportReady(connectionId, _routingId, _endpoint)
-                    .catch(error => this.locationRuntime.reportDiscoveryFailure(error));
+                void this.handleTransportReady(connectionId, _routingId, _endpoint).catch((error) => this.locationRuntime.reportDiscoveryFailure(error));
             }
         }
     }
@@ -319,9 +313,9 @@ class ZLinkClientServerLocationRuntime {
         const stableKey = clientServerStableKey(admitted.descriptor);
         const connections = await this.lane.run(() => [...this.connections.values()]);
         const superseded = connections
-            .filter(current => current.connectionId !== admitted.connectionId
-            && clientServerStableKey(current.descriptor) === stableKey)
-            .map(current => current.connectionId);
+            .filter((current) => current.connectionId !== admitted.connectionId &&
+            clientServerStableKey(current.descriptor) === stableKey)
+            .map((current) => current.connectionId);
         for (const connectionId of superseded) {
             await this.closeConnection(connectionId);
         }
@@ -403,13 +397,13 @@ function clientServerConnectionId(descriptor) {
     return `${channelName.length}:${channelName}:${serverRid.length}:${serverRid}:${descriptor.lifecycleGeneration}`;
 }
 function sameDescriptor(left, right) {
-    return left.lifecycleGeneration === right.lifecycleGeneration
-        && left.descriptorRevision === right.descriptorRevision
-        && left.endpoint === right.endpoint
-        && left.weight === right.weight
-        && left.state === right.state
-        && left.ownerId === right.ownerId
-        && left.leaseGeneration === right.leaseGeneration;
+    return (left.lifecycleGeneration === right.lifecycleGeneration &&
+        left.descriptorRevision === right.descriptorRevision &&
+        left.endpoint === right.endpoint &&
+        left.weight === right.weight &&
+        left.state === right.state &&
+        left.ownerId === right.ownerId &&
+        left.leaseGeneration === right.leaseGeneration);
 }
 function toDiscoveryDescriptor(descriptor, effectiveMaxMessageBytes = 0x7fff_ffff) {
     return {
@@ -455,14 +449,14 @@ function requestAdmission(dealer, descriptor, timeoutMs) {
     });
 }
 function requireMatchingAdmission(expected, actual) {
-    if (actual.channelName !== expected.channelName
-        || actual.serverRid !== String(expected.serverRid)
-        || actual.lifecycleGeneration !== expected.lifecycleGeneration
-        || actual.descriptorRevision !== expected.descriptorRevision
-        || actual.weight !== expected.weight
-        || actual.state !== expected.state
-        || actual.securityIdentity !== expected.securityIdentity
-        || actual.advertisedEndpoint !== expected.endpoint) {
+    if (actual.channelName !== expected.channelName ||
+        actual.serverRid !== String(expected.serverRid) ||
+        actual.lifecycleGeneration !== expected.lifecycleGeneration ||
+        actual.descriptorRevision !== expected.descriptorRevision ||
+        actual.weight !== expected.weight ||
+        actual.state !== expected.state ||
+        actual.securityIdentity !== expected.securityIdentity ||
+        actual.advertisedEndpoint !== expected.endpoint) {
         throw new configuration_1.ZLinkConfigurationException(`ClientServer '${expected.channelName}' admission does not match its descriptor.`);
     }
 }
@@ -471,7 +465,5 @@ function closeMessages(parts) {
         part.close();
 }
 function normalizedMessageLimit(value) {
-    return Number.isSafeInteger(value) && value > 0
-        ? Math.min(value, 0xffff_ffff)
-        : 0x7fff_ffff;
+    return Number.isSafeInteger(value) && value > 0 ? Math.min(value, 0xffff_ffff) : 0x7fff_ffff;
 }

package/dist/runtime/channels/client-server-service-wire.js

@@ -58,18 +58,15 @@ function encodeClientServerLivenessAck(probeId) {
     return encodeLiveness(COMMAND_LIVENESS_ACK, probeId);
 }
 function isClientServerControlFrame(frame) {
-    return frame.byteLength >= 5
-        && frame[0] === MAGIC_0
-        && frame[1] === MAGIC_1
-        && frame[2] === WIRE_MAJOR;
+    return (frame.byteLength >= 5 && frame[0] === MAGIC_0 && frame[1] === MAGIC_1 && frame[2] === WIRE_MAJOR);
 }
 function decodeClientServerControl(frame) {
     if (frame.byteLength > MAX_DESCRIPTOR_BYTES)
         fail('ClientServer control record is oversized.');
     const reader = new Reader(frame);
-    if (reader.u8('magic[0]') !== MAGIC_0
-        || reader.u8('magic[1]') !== MAGIC_1
-        || reader.u8('wireMajor') !== WIRE_MAJOR) {
+    if (reader.u8('magic[0]') !== MAGIC_0 ||
+        reader.u8('magic[1]') !== MAGIC_1 ||
+        reader.u8('wireMajor') !== WIRE_MAJOR) {
         fail('ClientServer control record prefix is invalid.');
     }
     const command = reader.u8('command');
@@ -113,9 +110,7 @@ function decodeClientServerControl(frame) {
         fail('ClientServer server admission role is invalid.');
     const admission = decodeServerAdmission(reader);
     reader.end();
-    return command === COMMAND_ADMIT
-        ? { kind: 'admit', admission }
-        : { kind: 'update', admission };
+    return command === COMMAND_ADMIT ? { kind: 'admit', admission } : { kind: 'update', admission };
 }
 function encodeLiveness(command, probeId) {
     return concat(prefix(command), encodeNonZeroU64(probeId, 'probeId'));
@@ -206,24 +201,36 @@ function encodeText16(value, field) {
 }
 function runtimeStateToWire(value) {
     switch (value) {
-        case Locations_1.ZLinkFrameworkRuntimeState.Preparing: return 0;
-        case Locations_1.ZLinkFrameworkRuntimeState.Serving: return 1;
+        case Locations_1.ZLinkFrameworkRuntimeState.Preparing:
+            return 0;
+        case Locations_1.ZLinkFrameworkRuntimeState.Serving:
+            return 1;
         case Locations_1.ZLinkFrameworkRuntimeState.Relocating:
         case Locations_1.ZLinkFrameworkRuntimeState.Relocated:
-        case Locations_1.ZLinkFrameworkRuntimeState.Draining: return 2;
-        case Locations_1.ZLinkFrameworkRuntimeState.Stopped: return 3;
-        case Locations_1.ZLinkFrameworkRuntimeState.Error: return 4;
-        default: fail('ClientServer runtime state is invalid.');
+        case Locations_1.ZLinkFrameworkRuntimeState.Draining:
+            return 2;
+        case Locations_1.ZLinkFrameworkRuntimeState.Stopped:
+            return 3;
+        case Locations_1.ZLinkFrameworkRuntimeState.Error:
+            return 4;
+        default:
+            fail('ClientServer runtime state is invalid.');
     }
 }
 function runtimeStateFromWire(value) {
     switch (value) {
-        case 0: return Locations_1.ZLinkFrameworkRuntimeState.Preparing;
-        case 1: return Locations_1.ZLinkFrameworkRuntimeState.Serving;
-        case 2: return Locations_1.ZLinkFrameworkRuntimeState.Draining;
-        case 3: return Locations_1.ZLinkFrameworkRuntimeState.Stopped;
-        case 4: return Locations_1.ZLinkFrameworkRuntimeState.Error;
-        default: fail('ClientServer runtime state is invalid.');
+        case 0:
+            return Locations_1.ZLinkFrameworkRuntimeState.Preparing;
+        case 1:
+            return Locations_1.ZLinkFrameworkRuntimeState.Serving;
+        case 2:
+            return Locations_1.ZLinkFrameworkRuntimeState.Draining;
+        case 3:
+            return Locations_1.ZLinkFrameworkRuntimeState.Stopped;
+        case 4:
+            return Locations_1.ZLinkFrameworkRuntimeState.Error;
+        default:
+            fail('ClientServer runtime state is invalid.');
     }
 }
 function concat(...parts) {

package/dist/runtime/channels/dispatch-error-reporter.d.ts

@@ -17,6 +17,7 @@ export declare class ZLinkDispatchErrorReporter {
     readonly flow: ZLinkMessageFlowTracer;
     constructor(_observerType: undefined, _providerResolver: unknown, errorSink: ZLinkDispatchErrorSink, ctx?: ZLinkDiagnosticsContext, metrics?: ZLinkRuntimeMetrics | undefined);
     report(event: ZLinkRuntimeDispatchFailure): void;
+    captureEnabled(): boolean;
     get reportedCount(): number;
     get providerFailureCount(): number;
 }

package/dist/runtime/channels/dispatch-error-reporter.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkDispatchErrorReporter = void 0;
 const ZLinkDispatchOptions_1 = require("../../contracts/Dispatch/ZLinkDispatchOptions");
 const diagnostics_1 = require("../diagnostics");
+const dispatch_error_details_1 = require("../diagnostics/dispatch-error-details");
 class ZLinkDispatchErrorReporter {
     metrics;
     reportedEvents = 0;
@@ -23,7 +24,6 @@ class ZLinkDispatchErrorReporter {
     }
     report(event) {
         const normalized = normalizeDispatchFailure(event);
-        const tracePoint = this.flow.begin(ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Error);
         const dropReason = channelDropReason(normalized);
         if (dropReason !== undefined) {
             this.metrics?.count('zlink.mesh_node.messages.dropped', 1, {
@@ -32,9 +32,10 @@ class ZLinkDispatchErrorReporter {
                 reason: dropReason
             });
         }
+        const tracePoint = this.flow.begin(ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Error);
         if (tracePoint === undefined)
             return;
-        const errorInfo = dispatchErrorInfo(normalized);
+        const errorInfo = (0, dispatch_error_details_1.dispatchErrorDetails)(normalized.error);
         this.reportedEvents += 1;
         tracePoint.trace({
             outcome: ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Error,
@@ -64,6 +65,9 @@ class ZLinkDispatchErrorReporter {
             errorCauseMessage: errorInfo.errorCauseMessage
         });
     }
+    captureEnabled() {
+        return this.flow.enabled(ZLinkDispatchOptions_1.ZLinkRuntimeMessageFlowOutcome.Error);
+    }
     get reportedCount() {
         return this.reportedEvents;
     }
@@ -83,9 +87,9 @@ function normalizeDispatchFailure(event) {
     };
 }
 function channelDropReason(event) {
-    if (event.action !== ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorAction.Drop
-        || (event.surface !== ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.Channel
-            && event.surface !== ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.RouteMeshChannel))
+    if (event.action !== ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorAction.Drop ||
+        (event.surface !== ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.Channel &&
+            event.surface !== ZLinkDispatchOptions_1.ZLinkDispatchErrorSurface.RouteMeshChannel))
         return undefined;
     switch (event.reason) {
         case ZLinkDispatchOptions_1.ZLinkRuntimeDispatchErrorReason.HandlerMissing:
@@ -97,37 +101,3 @@ function channelDropReason(event) {
             return undefined;
     }
 }
-function dispatchErrorInfo(event) {
-    if (event.errorType !== undefined || event.errorMessage !== undefined) {
-        return {
-            errorType: event.errorType,
-            errorMessage: event.errorMessage,
-            errorCauseType: event.errorCauseType,
-            errorCauseMessage: event.errorCauseMessage
-        };
-    }
-    if (event.error === undefined) {
-        return {};
-    }
-    if (event.error instanceof Error) {
-        const cause = deepestErrorCause(event.error);
-        return {
-            errorType: event.error.name,
-            errorMessage: event.error.message,
-            ...(cause === event.error ? {} : {
-                errorCauseType: cause instanceof Error ? cause.name : typeof cause,
-                errorCauseMessage: cause instanceof Error ? cause.message : String(cause)
-            })
-        };
-    }
-    return { errorType: typeof event.error, errorMessage: String(event.error) };
-}
-function deepestErrorCause(error) {
-    let current = error;
-    const seen = new Set();
-    while (current instanceof Error && current.cause !== undefined && !seen.has(current)) {
-        seen.add(current);
-        current = current.cause;
-    }
-    return current;
-}