@zlink-systems/framework 0.26.0 → 0.27.0

package/dist/runtime/foundation/service-wire-m6a-codec.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ServiceWireProtocolError = exports.M6aServiceWireCommand = exports.M6A_SERVICE_WIRE_REQUIRED_CAPABILITY = exports.M6A_SERVICE_WIRE_MAJOR = exports.M6A_SERVICE_WIRE_MAGIC = void 0;
+exports.ServiceWireProtocolError = exports.M6aServiceWireCommand = exports.M6A_SERVICE_WIRE_REQUIRED_CAPABILITY = exports.M6A_SERVICE_WIRE_MAJOR = exports.M6A_SERVICE_WIRE_MAGIC = exports.APPLICATION_PAYLOAD_MINIMUM_FIELD_BYTES = exports.APPLICATION_PAYLOAD_VERSION = void 0;
 exports.encodeNodeSendHeader = encodeNodeSendHeader;
 exports.encodeNodeRequestHeader = encodeNodeRequestHeader;
 exports.decodeNodeRequestHeader = decodeNodeRequestHeader;
@@ -20,13 +20,23 @@ exports.decodeRouteMeshAdmission = decodeRouteMeshAdmission;
 exports.encodeReject = encodeReject;
 exports.decodeReject = decodeReject;
 exports.decodeHeader = decodeHeader;
-const service_topology_registry_1 = require("./service-topology-registry");
+const stream_wire_1 = require("@zlink-systems/stream-wire");
 const EndpointNotation_1 = require("../../contracts/Configuration/EndpointNotation");
-const service_wire_constants_generated_1 = require("./service-wire-constants.generated");
+const service_topology_registry_1 = require("./service-topology-registry");
 const service_wire_binary_primitives_1 = require("./service-wire-binary-primitives");
-const PREFIX_SIZE = 5;
-const MAX_U32 = 0xffff_ffff;
-const MAX_U64 = 0xffffffffffffffffn;
+const service_wire_constants_generated_1 = require("./service-wire-constants.generated");
+const PREFIX_SIZE = service_wire_binary_primitives_1.SERVICE_WIRE_PREFIX_SIZE;
+const REPLY_HEADER_MIN_BYTES = PREFIX_SIZE + 16;
+const SERVICE_ROUTE_TEXT_MAX_BYTES = 4096;
+exports.APPLICATION_PAYLOAD_VERSION = 1;
+const APPLICATION_PAYLOAD_LENGTH_FIELD_BYTES = 4;
+const APPLICATION_PAYLOAD_TEXT_LENGTH_FIELD_BYTES = 1;
+exports.APPLICATION_PAYLOAD_MINIMUM_FIELD_BYTES = 1 +
+    APPLICATION_PAYLOAD_LENGTH_FIELD_BYTES +
+    2 * APPLICATION_PAYLOAD_TEXT_LENGTH_FIELD_BYTES +
+    APPLICATION_PAYLOAD_LENGTH_FIELD_BYTES;
+const MAX_U32 = stream_wire_1.UINT32_MAX;
+const MAX_U64 = stream_wire_1.UINT64_MAX;
 exports.M6A_SERVICE_WIRE_MAGIC = service_wire_constants_generated_1.SERVICE_WIRE_MAGIC;
 exports.M6A_SERVICE_WIRE_MAJOR = service_wire_constants_generated_1.SERVICE_WIRE_MAJOR;
 exports.M6A_SERVICE_WIRE_REQUIRED_CAPABILITY = service_wire_constants_generated_1.SERVICE_WIRE_REQUIRED_CAPABILITY;
@@ -100,7 +110,7 @@ function decodeReplyHeader(frame) {
     const header = decodeHeader(frame);
     if (header.command !== exports.M6aServiceWireCommand.reply ||
         header.flags !== 0 ||
-        frame.byteLength < 21) {
+        frame.byteLength < REPLY_HEADER_MIN_BYTES) {
         fail('Invalid reply header.');
     }
     const bytes = asBuffer(frame);
@@ -125,7 +135,7 @@ function encodeApplicationPayload(payload) {
     if (bodyLength > MAX_U32)
         fail('Application payload body exceeds u32.');
     const result = Buffer.alloc(5 + bodyLength);
-    result[0] = 1;
+    result[0] = exports.APPLICATION_PAYLOAD_VERSION;
     result.writeUInt32BE(bodyLength, 1);
     let offset = 5;
     offset += packetName.copy(result, offset);
@@ -159,7 +169,7 @@ function encodeMultipartApplicationPayload(parts, packetName, contentType) {
     if (bodyLength > MAX_U32)
         fail('Application payload body exceeds u32.');
     const result = Buffer.alloc(5 + bodyLength);
-    result[0] = 1;
+    result[0] = exports.APPLICATION_PAYLOAD_VERSION;
     result.writeUInt32BE(bodyLength, 1);
     let offset = 5;
     offset += packetNameBytes.copy(result, offset);
@@ -190,7 +200,7 @@ function decodeApplicationPayload(frame) {
  */
 function decodeApplicationPayloadView(frame) {
     const reader = new Reader(frame);
-    if (reader.u8('version') !== 1)
+    if (reader.u8('version') !== exports.APPLICATION_PAYLOAD_VERSION)
         fail('Invalid application payload version.');
     const bodyLength = reader.u32('bodyLength');
     if (bodyLength !== reader.remaining)
@@ -212,7 +222,7 @@ function decodeApplicationPayloadView(frame) {
  */
 function validateApplicationPayloadFrame(frame) {
     const reader = new Reader(frame);
-    if (reader.u8('version') !== 1)
+    if (reader.u8('version') !== exports.APPLICATION_PAYLOAD_VERSION)
         fail('Invalid application payload version.');
     const bodyLength = reader.u32('bodyLength');
     if (bodyLength !== reader.remaining)
@@ -413,7 +423,7 @@ function encodeText8(value, field) {
     return concat(Buffer.of(bytes.byteLength), bytes);
 }
 function encodeText16(value, field) {
-    const bytes = (0, service_wire_binary_primitives_1.encodeCanonicalServiceWireText)(value, field, 4096, fail);
+    const bytes = (0, service_wire_binary_primitives_1.encodeCanonicalServiceWireText)(value, field, SERVICE_ROUTE_TEXT_MAX_BYTES, fail);
     return concat(encodeU16(bytes.byteLength), bytes);
 }
 function tlv(id, value) {
@@ -539,7 +549,7 @@ class Reader {
     }
     text16(field) {
         const length = this.u16(`${field}.length`);
-        if (length === 0 || length > 4096)
+        if (length === 0 || length > SERVICE_ROUTE_TEXT_MAX_BYTES)
             fail(`${field} has invalid length.`);
         return decodeText(this.bytes(length, field), field);
     }

package/dist/runtime/framework-errors-internal.d.ts

@@ -45,6 +45,7 @@ export declare enum ZLinkFrameworkInternalErrorKind {
     ActorRouteUnavailable = "actorRouteUnavailable"
 }
 export declare const ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES: Readonly<Record<ZLinkFrameworkInternalErrorKind, number>>;
+export declare function frameworkRelocationFailureCode(error: ZLinkFrameworkErrorKind | ZLinkFrameworkException): number;
 export declare function createInternalFrameworkException(kind: ZLinkFrameworkInternalErrorKind, message: string, causeOrRetry?: unknown, cause?: unknown): ZLinkFrameworkException;
 export declare function internalFrameworkErrorKind(error: ZLinkFrameworkException): ZLinkFrameworkInternalErrorKind | undefined;
 /**
@@ -83,7 +84,7 @@ export declare function wireReplyFailureException(terminalResult: number, failur
 export declare function translateWireReplyDecodeError(error: unknown): unknown;
 export declare function internalFrameworkErrorCode(error: ZLinkFrameworkException): number;
 /** Produces the canonical stateful wire terminal without leaking internal kinds. */
-export declare function internalFrameworkWireReply(error: ZLinkFrameworkException): {
+export declare function internalFrameworkWireReply(error: ZLinkFrameworkException | ZLinkFrameworkInternalErrorKind | ZLinkFrameworkErrorKind): {
     readonly terminalResult: number;
     readonly failureCode: number;
 };

package/dist/runtime/framework-errors-internal.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES = exports.ZLinkFrameworkInternalErrorKind = void 0;
+exports.frameworkRelocationFailureCode = frameworkRelocationFailureCode;
 exports.createInternalFrameworkException = createInternalFrameworkException;
 exports.internalFrameworkErrorKind = internalFrameworkErrorKind;
 exports.requestResultToPublicErrorKind = requestResultToPublicErrorKind;
@@ -14,6 +15,7 @@ exports.isCanonicalWireReplyTerminal = isCanonicalWireReplyTerminal;
 const ZLinkFrameworkException_1 = require("../contracts/Errors/ZLinkFrameworkException");
 const runtime_values_1 = require("./backend/runtime-values");
 const service_wire_m6a_codec_1 = require("./foundation/service-wire-m6a-codec");
+const service_wire_constants_generated_1 = require("./foundation/service-wire-constants.generated");
 /** Detailed failure reasons owned by Framework runtime bounded contexts. */
 var ZLinkFrameworkInternalErrorKind;
 (function (ZLinkFrameworkInternalErrorKind) {
@@ -60,110 +62,326 @@ var ZLinkFrameworkInternalErrorKind;
     ZLinkFrameworkInternalErrorKind["InvalidOperation"] = "invalidOperation";
     ZLinkFrameworkInternalErrorKind["ActorRouteUnavailable"] = "actorRouteUnavailable";
 })(ZLinkFrameworkInternalErrorKind || (exports.ZLinkFrameworkInternalErrorKind = ZLinkFrameworkInternalErrorKind = {}));
-const INTERNAL_TO_PUBLIC = Object.freeze({
-    [ZLinkFrameworkInternalErrorKind.ActorRouteNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.ActorAlreadyExists]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
-    [ZLinkFrameworkInternalErrorKind.ActorTypeMismatch]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
-    [ZLinkFrameworkInternalErrorKind.SpotCreateFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.SpotRouteNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.SpotTypeMismatch]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
-    [ZLinkFrameworkInternalErrorKind.ActorSessionNotBound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.HandlerNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.RouteHandlerNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
-    [ZLinkFrameworkInternalErrorKind.RouteNotConnected]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RequestTargetNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.RequestRejected]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
-    [ZLinkFrameworkInternalErrorKind.RequestProtocolError]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
-    [ZLinkFrameworkInternalErrorKind.RequestFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.WorkerQueueFull]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.WorkerTimedOut]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
-    [ZLinkFrameworkInternalErrorKind.WorkerFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.ActorLocationStale]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateRejected]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
-    [ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
-    [ZLinkFrameworkInternalErrorKind.MeshSelectionRequired]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
-    [ZLinkFrameworkInternalErrorKind.MeshNotFound]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
-    [ZLinkFrameworkInternalErrorKind.InvalidConfiguration]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
-    [ZLinkFrameworkInternalErrorKind.AlreadySubmitted]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.ActorGenerationStale]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.ActorMoving]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.DeadlineExceeded]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
-    [ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RoutingIdConflict]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
-    [ZLinkFrameworkInternalErrorKind.SpotGenerationStale]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.SpotMoving]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RelocationDataLost]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DataLost,
-    [ZLinkFrameworkInternalErrorKind.SpotIdConflict]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
-    [ZLinkFrameworkInternalErrorKind.RuntimeShutdown]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ShuttingDown,
-    [ZLinkFrameworkInternalErrorKind.RelocationDisabled]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
-    [ZLinkFrameworkInternalErrorKind.RelocationTargetUnavailable]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
-    [ZLinkFrameworkInternalErrorKind.RelocationFailed]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
-    [ZLinkFrameworkInternalErrorKind.InvalidOperation]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
-    [ZLinkFrameworkInternalErrorKind.ActorRouteUnavailable]: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable
-});
-exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES = Object.freeze({
-    [ZLinkFrameworkInternalErrorKind.ActorRouteNotFound]: 0,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateFailed]: 1,
-    [ZLinkFrameworkInternalErrorKind.ActorAlreadyExists]: 2,
-    [ZLinkFrameworkInternalErrorKind.ActorTypeMismatch]: 3,
-    [ZLinkFrameworkInternalErrorKind.SpotCreateFailed]: 4,
-    [ZLinkFrameworkInternalErrorKind.SpotRouteNotFound]: 5,
-    [ZLinkFrameworkInternalErrorKind.SpotTypeMismatch]: 6,
-    [ZLinkFrameworkInternalErrorKind.ActorSessionNotBound]: 7,
-    [ZLinkFrameworkInternalErrorKind.HandlerNotFound]: 8,
-    [ZLinkFrameworkInternalErrorKind.RouteHandlerNotFound]: 9,
-    [ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound]: 10,
-    [ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed]: 11,
-    [ZLinkFrameworkInternalErrorKind.RouteNotConnected]: 12,
-    [ZLinkFrameworkInternalErrorKind.RequestTargetNotFound]: 13,
-    [ZLinkFrameworkInternalErrorKind.RequestRejected]: 14,
-    [ZLinkFrameworkInternalErrorKind.RequestProtocolError]: 15,
-    [ZLinkFrameworkInternalErrorKind.RequestFailed]: 16,
-    [ZLinkFrameworkInternalErrorKind.WorkerQueueFull]: 17,
-    [ZLinkFrameworkInternalErrorKind.WorkerTimedOut]: 18,
-    [ZLinkFrameworkInternalErrorKind.WorkerFailed]: 19,
-    [ZLinkFrameworkInternalErrorKind.ActorLocationStale]: 20,
-    [ZLinkFrameworkInternalErrorKind.ActorCreateRejected]: 21,
-    [ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured]: 22,
-    [ZLinkFrameworkInternalErrorKind.MeshSelectionRequired]: 23,
-    [ZLinkFrameworkInternalErrorKind.MeshNotFound]: 24,
-    [ZLinkFrameworkInternalErrorKind.InvalidConfiguration]: 25,
-    [ZLinkFrameworkInternalErrorKind.AlreadySubmitted]: 26,
-    [ZLinkFrameworkInternalErrorKind.ActorGenerationStale]: 27,
-    [ZLinkFrameworkInternalErrorKind.ActorMoving]: 28,
-    [ZLinkFrameworkInternalErrorKind.DeadlineExceeded]: 29,
-    [ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted]: 30,
-    [ZLinkFrameworkInternalErrorKind.RoutingIdConflict]: 31,
-    [ZLinkFrameworkInternalErrorKind.SpotGenerationStale]: 32,
-    [ZLinkFrameworkInternalErrorKind.SpotMoving]: 33,
-    [ZLinkFrameworkInternalErrorKind.RelocationDataLost]: 34,
-    [ZLinkFrameworkInternalErrorKind.SpotIdConflict]: 35,
-    [ZLinkFrameworkInternalErrorKind.RuntimeShutdown]: 36,
-    [ZLinkFrameworkInternalErrorKind.RelocationDisabled]: 37,
-    [ZLinkFrameworkInternalErrorKind.RelocationTargetUnavailable]: 38,
-    [ZLinkFrameworkInternalErrorKind.RelocationFailed]: 39,
-    [ZLinkFrameworkInternalErrorKind.InvalidOperation]: 40,
-    [ZLinkFrameworkInternalErrorKind.ActorRouteUnavailable]: 41
-});
-const INTERNAL_KIND_BY_WIRE_FAILURE_CODE = new Map([
-    ...Object.entries(exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES).map(([kind, code]) => [code + 1, kind]),
-    //  Spec 32-framework-error-model:99-103 — a workerQueueFull(18) received in a
-    //  remote reply is the target's queue state and maps to Unavailable.
-    [18, ZLinkFrameworkInternalErrorKind.RouteNotConnected]
-]);
+// Error model §2.1 owns the wire codes and public representatives.
+const FAILURE_MAPPINGS = [
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorRouteNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorRouteNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorRouteNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorCreateFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorAlreadyExists,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorAlreadyExists - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorAlreadyExists
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorTypeMismatch,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorTypeMismatch - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorTypeMismatch
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotCreateFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotCreateFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotCreateFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotRouteNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotRouteNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotRouteNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotTypeMismatch,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotTypeMismatch - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotTypeMismatch
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorSessionNotBound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorSessionNotBound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorSessionNotBound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.HandlerNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.handlerNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.handlerNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RouteHandlerNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeHandlerNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeHandlerNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorDispatchHandlerNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorDispatchHandlerNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorDispatchHandlerNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.payloadDecodeFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.payloadDecodeFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RouteNotConnected,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestTargetNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestTargetNotFound - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestTargetNotFound
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestRejected,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestRejected - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestRejected
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestProtocolError,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestProtocolError - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestProtocolError
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RequestFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.WorkerQueueFull,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerQueueFull - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerQueueFull
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.WorkerTimedOut,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerTimedOut - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerTimedOut
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.WorkerFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerFailed - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerFailed
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorLocationStale,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorLocationStale - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorLocationStale
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorCreateRejected,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateRejected - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorCreateRejected
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ObjectClientNotConfigured,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        internalValue: 22
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.MeshSelectionRequired,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        internalValue: 23
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.MeshNotFound,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        internalValue: 24
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.InvalidConfiguration,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        internalValue: 25
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.AlreadySubmitted,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: 26
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorGenerationStale,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: 27
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorMoving,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: 28
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.DeadlineExceeded,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
+        internalValue: 29
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: 30
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RoutingIdConflict,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        internalValue: 31
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotGenerationStale,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotGenerationStale - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotGenerationStale
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotMoving,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotMoving - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotMoving
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationDataLost,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DataLost,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.relocationDataLost - 1,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.relocationDataLost
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.SpotIdConflict,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        internalValue: 35
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RuntimeShutdown,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ShuttingDown,
+        internalValue: 36
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationDisabled,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        internalValue: 37
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationTargetUnavailable,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: 38
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.RelocationFailed,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        internalValue: 39
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.InvalidOperation,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        internalValue: 40
+    },
+    {
+        internalKind: ZLinkFrameworkInternalErrorKind.ActorRouteUnavailable,
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        internalValue: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected - 1
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotFound,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestTargetNotFound,
+        sendTerminal: runtime_values_1.RequestResult.NotFound
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.AlreadyExists,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.actorAlreadyExists,
+        sendTerminal: runtime_values_1.RequestResult.Conflict
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.TypeMismatch,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.spotTypeMismatch,
+        sendTerminal: runtime_values_1.RequestResult.Conflict
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.NotConfigured,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Rejected,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestRejected,
+        sendTerminal: runtime_values_1.RequestResult.Rejected
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.Unavailable,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DeadlineExceeded,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.workerTimedOut,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ShuttingDown,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.none,
+        codeOnlySend: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.routeNotConnected,
+        sendTerminal: runtime_values_1.RequestResult.Terminated
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.ProtocolError,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestProtocolError,
+        sendTerminal: runtime_values_1.RequestResult.ProtocolError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InvalidOperation,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.none,
+        codeOnlySend: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed,
+        sendTerminal: runtime_values_1.RequestResult.InvalidState
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.DataLost,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.relocationDataLost,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    },
+    {
+        publicKind: ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure,
+        send: service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.requestFailed,
+        sendTerminal: runtime_values_1.RequestResult.InternalError
+    }
+];
+const INTERNAL_MAPPING = new Map(FAILURE_MAPPINGS.filter((row) => row.internalKind !== undefined).map((row) => [
+    row.internalKind,
+    row
+]));
+const PUBLIC_MAPPING = new Map(FAILURE_MAPPINGS.filter((row) => row.internalKind === undefined).map((row) => [
+    row.publicKind,
+    row
+]));
+const RECEIVE_MAPPING = new Map(FAILURE_MAPPINGS.filter((row) => row.internalKind !== undefined && row.send !== undefined).map((row) => [row.send, row.internalKind]));
+exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES = Object.freeze(Object.fromEntries([...INTERNAL_MAPPING].map(([kind, row]) => [kind, row.internalValue])));
+function frameworkRelocationFailureCode(error) {
+    const row = outgoingFailureMapping(error);
+    return row.codeOnlySend ?? row.send;
+}
 const WIRE_TERMINAL_RESULT_BY_FAILURE_CODE = new Map([
-    ...[1, 6, 8, 9, 10, 11, 14].map((code) => [code, 102]),
-    ...[2, 5, 13, 17, 19, 20, 35, 42].map((code) => [code, 105]),
-    ...[3, 4, 7, 21, 33, 34].map((code) => [code, 107]),
-    ...[12, 16].map((code) => [code, 104]),
-    ...[15, 18, 22].map((code) => [code, 106])
+    ...Object.entries(service_wire_constants_generated_1.ServiceWireExactTerminalByFailureCode).map(([code, terminal]) => [Number(code), terminal])
 ]);
 const INTERNAL_KIND = new WeakMap();
 function createInternalFrameworkException(kind, message, causeOrRetry, cause) {
-    const error = new ZLinkFrameworkException_1.ZLinkFrameworkException(INTERNAL_TO_PUBLIC[kind], message, typeof causeOrRetry === 'boolean' ? cause : causeOrRetry);
+    const error = new ZLinkFrameworkException_1.ZLinkFrameworkException(INTERNAL_MAPPING.get(kind).publicKind, message, typeof causeOrRetry === 'boolean' ? cause : causeOrRetry);
     INTERNAL_KIND.set(error, kind);
     return error;
 }
@@ -252,44 +470,47 @@ function internalFrameworkErrorCode(error) {
     const kind = INTERNAL_KIND.get(error);
     return kind === undefined ? error.kind : exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES[kind];
 }
+/** Selects a known cause or the public kind's representative for both wire forms. */
+function outgoingFailureMapping(error) {
+    const internal = typeof error === 'string' ? INTERNAL_MAPPING.get(error) : undefined;
+    const publicKind = internal?.publicKind ??
+        (typeof error === 'number' ? error : error.kind);
+    let cause = error;
+    while (cause instanceof ZLinkFrameworkException_1.ZLinkFrameworkException || typeof cause === 'string') {
+        const row = INTERNAL_MAPPING.get(typeof cause === 'string'
+            ? cause
+            : INTERNAL_KIND.get(cause));
+        if (row?.send !== undefined && row.publicKind === publicKind)
+            return row;
+        cause = typeof cause === 'string' ? undefined : cause.cause;
+    }
+    return (PUBLIC_MAPPING.get(publicKind) ?? PUBLIC_MAPPING.get(ZLinkFrameworkException_1.ZLinkFrameworkErrorKind.InternalFailure));
+}
 /** Produces the canonical stateful wire terminal without leaking internal kinds. */
 function internalFrameworkWireReply(error) {
-    const kind = INTERNAL_KIND.get(error);
-    if (kind === ZLinkFrameworkInternalErrorKind.DeadlineExceeded) {
-        return { terminalResult: 101, failureCode: 0 };
-    }
-    if (kind === undefined) {
-        return { terminalResult: 105, failureCode: 17 };
-    }
-    const failureCode = exports.ZLINK_FRAMEWORK_INTERNAL_ERROR_KIND_VALUES[kind] + 1;
-    const terminalResult = WIRE_TERMINAL_RESULT_BY_FAILURE_CODE.get(failureCode);
-    return terminalResult === undefined
-        ? { terminalResult: 105, failureCode: 17 }
-        : { terminalResult, failureCode };
+    const row = outgoingFailureMapping(error);
+    return {
+        terminalResult: row.sendTerminal ?? WIRE_TERMINAL_RESULT_BY_FAILURE_CODE.get(row.send),
+        failureCode: row.send
+    };
 }
 /** Decodes the stateful reply failureCode convention without exposing wire offsets to callers. */
 function internalFrameworkErrorKindFromWireFailureCode(failureCode) {
-    return INTERNAL_KIND_BY_WIRE_FAILURE_CODE.get(failureCode);
+    return RECEIVE_MAPPING.get(failureCode);
 }
 /** Restores a typed failure only when its wire terminal result is canonical. */
 function internalFrameworkErrorKindFromWireReply(terminalResult, failureCode) {
-    // ServiceStaleGenerationError is emitted as NotFound with the historical
-    // stale-route code, while the same internal code is also used by Conflict
-    // replies from the actor route protocol.
-    if (terminalResult === 102 && failureCode === 21) {
-        return ZLinkFrameworkInternalErrorKind.ActorLocationStale;
-    }
     const kind = internalFrameworkErrorKindFromWireFailureCode(failureCode);
     if (kind === undefined)
         return undefined;
     const expectedTerminalResult = WIRE_TERMINAL_RESULT_BY_FAILURE_CODE.get(failureCode);
     return expectedTerminalResult === terminalResult ? kind : undefined;
 }
-const BOUNDARY_WIRE_TERMINAL_RESULTS = new Set([101, 103, 108, 109, 110, 111, 112, 113]);
+const BOUNDARY_WIRE_TERMINAL_RESULTS = new Set(service_wire_constants_generated_1.ServiceWireBoundaryTerminalResults);
 /** Checks the terminal and failure-code pair before a transport maps it. */
 function isCanonicalWireReplyTerminal(terminalResult, failureCode) {
-    if (terminalResult === 0)
-        return failureCode === 0;
+    if (terminalResult === runtime_values_1.RequestResult.Ok)
+        return failureCode === service_wire_constants_generated_1.ServiceWireFrameworkErrorCode.none;
     if (BOUNDARY_WIRE_TERMINAL_RESULTS.has(terminalResult))
         return failureCode === 0;
     return internalFrameworkErrorKindFromWireReply(terminalResult, failureCode) !== undefined;