@zlink-systems/framework 0.25.0 → 0.27.0

package/dist/runtime/foundation/service-topology-registry.js

@@ -3,12 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceTopologyRegistry = void 0;
 exports.validateDescriptor = validateDescriptor;
 exports.sameServiceNodeDescriptor = sameServiceNodeDescriptor;
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
+const RegistrationBuilderPolicy_1 = require("../../contracts/Configuration/RegistrationBuilderPolicy");
 const route_mesh_connection_policy_1 = require("./route-mesh-connection-policy");
 const service_weighted_selection_1 = require("./service-weighted-selection");
 const service_wire_constants_generated_1 = require("./service-wire-constants.generated");
 const REQUIRED_CAPABILITY = service_wire_constants_generated_1.SERVICE_WIRE_REQUIRED_CAPABILITY;
-const MAX_CAPACITY = 0x7fff_ffff;
-const MAX_PUBLIC_WEIGHT = 10_000;
 /** Owns immutable peer snapshots and fences late physical-connection events. */
 class ServiceTopologyRegistry {
     local;
@@ -41,11 +41,10 @@ class ServiceTopologyRegistry {
         }
         this.rebuildSelections();
     }
-    admit(descriptor, connectionId, expected, connectionDiscriminator = connectionId) {
+    admit(descriptor, connectionId, expected) {
         try {
             validateDescriptor(descriptor);
             requireText(connectionId, 'connectionId');
-            requireText(connectionDiscriminator, 'connectionDiscriminator');
         }
         catch (error) {
             return 'invalidDescriptor';
@@ -83,25 +82,11 @@ class ServiceTopologyRegistry {
                     !sameServiceNodeDescriptor(current.descriptor, descriptor)))) {
             return 'staleDescriptor';
         }
-        if (current !== undefined &&
-            current.descriptor.lifecycleGeneration === descriptor.lifecycleGeneration &&
-            current.descriptor.descriptorRevision === descriptor.descriptorRevision &&
-            sameServiceNodeDescriptor(current.descriptor, descriptor) &&
-            current.connectionId !== connectionId &&
-            // A fallback candidate is only a logical placeholder. Once the
-            // monitor reports the physical connection, its evidence supersedes
-            // candidate ordering so the request path uses the native route.
-            !(isUnmonitoredConnectionId(current.connectionId) && !isUnmonitoredConnectionId(connectionId)) &&
-            compareConnectionCandidate(current.connectionDiscriminator, current.connectionId, connectionDiscriminator, connectionId) <= 0) {
-            // Both manual directions can reach admission. The same comparison on
-            // every retry keeps one physical candidate instead of replacing it in
-            // arrival order.
-            return 'staleDescriptor';
-        }
+        // Core selects the one route per RID (Core ROUTER §10.1); an admission on
+        // that route replaces the admission of a route it replaced.
         this.peersByRid.set(descriptor.nodeRoutingId, {
             descriptor: cloneDescriptor(descriptor),
-            connectionId,
-            connectionDiscriminator
+            connectionId
         });
         this.remember(descriptor);
         this.rebuildSelections();
@@ -149,18 +134,6 @@ class ServiceTopologyRegistry {
         }
         this.rebuildSelections();
     }
-    markNotRequired(descriptor) {
-        validateDescriptor(descriptor);
-        if (descriptor.meshName !== this.local.meshName ||
-            descriptor.nodeRoutingId === this.local.nodeRoutingId ||
-            !(0, route_mesh_connection_policy_1.descriptorConnectionNotRequired)(this.local, descriptor)) {
-            return;
-        }
-        this.peersByRid.delete(descriptor.nodeRoutingId);
-        this.remember(descriptor);
-        this.notRequiredByRid.set(descriptor.nodeRoutingId, cloneDescriptor(descriptor));
-        this.rebuildSelections();
-    }
     forgetNotRequired(nodeRoutingId) {
         if (this.notRequiredByRid.delete(nodeRoutingId))
             this.rebuildSelections();
@@ -172,7 +145,10 @@ class ServiceTopologyRegistry {
     }
     hasKnownChannelTarget(channelName) {
         requireText(channelName, 'channelName');
-        return [this.local, ...this.knownByRid.values()].some((descriptor) => selectableChannel(descriptor, channelName) !== undefined);
+        return [...this.knownByRid.values()].some((descriptor) => (descriptor.state === 'serving' ||
+            descriptor.state === 'retiring' ||
+            descriptor.state === 'draining') &&
+            findChannel(descriptor, channelName) !== undefined);
     }
     remember(descriptor) {
         const current = this.knownByRid.get(descriptor.nodeRoutingId);
@@ -185,19 +161,12 @@ class ServiceTopologyRegistry {
     }
     selectChannel(channelName, isReady = () => true) {
         requireText(channelName, 'channelName');
-        return this.selectWeightedCycle(`channel:${channelName}`, () => {
-            const local = {
-                descriptor: cloneDescriptor(this.local),
-                connectionId: 'local',
-                connectionDiscriminator: 'local'
-            };
-            return [local, ...this.peersByRid.values()]
-                .map((peer) => ({
-                peer: clonePeer(peer),
-                channel: selectableChannel(peer.descriptor, channelName)
-            }))
-                .filter((value) => value.channel !== undefined);
-        }, (value) => value.channel.weight, (value) => value.peer.descriptor.nodeRoutingId, (left, right) => compareOrdinal(left.peer.descriptor.nodeRoutingId, right.peer.descriptor.nodeRoutingId), (value) => isReady(value.peer))?.peer;
+        return this.selectWeightedCycle(`channel:${channelName}`, () => [...this.peersByRid.values()]
+            .map((peer) => ({
+            peer: clonePeer(peer),
+            channel: selectableChannel(peer.descriptor, channelName)
+        }))
+            .filter((value) => value.channel !== undefined), (value) => value.channel.weight, (value) => value.peer.descriptor.nodeRoutingId, (left, right) => compareOrdinal(left.peer.descriptor.nodeRoutingId, right.peer.descriptor.nodeRoutingId), (value) => isReady(value.peer))?.peer;
     }
     selectPlacement(isReady = () => true) {
         return this.selectWeightedCycle('placement', () => [...this.peersByRid.values()]
@@ -291,8 +260,8 @@ function validateDescriptor(descriptor) {
     }
     if (descriptor.maintenanceWave !== undefined) {
         requireText(descriptor.maintenanceWave, 'maintenanceWave');
-        if (Buffer.byteLength(descriptor.maintenanceWave, 'utf8') > 255) {
-            throw new RangeError('maintenanceWave must not exceed 255 UTF-8 bytes.');
+        if (Buffer.byteLength(descriptor.maintenanceWave, 'utf8') > CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES) {
+            throw new RangeError(`maintenanceWave must not exceed ${CoreTypes_1.ZLINK_MAX_IDENTITY_TEXT_BYTES} UTF-8 bytes.`);
         }
     }
     validatePublicWeight(descriptor.placementWeight, 'placementWeight');
@@ -318,13 +287,13 @@ function validateDescriptor(descriptor) {
     }
 }
 function validateCapacity(value, allowZero, field) {
-    if (!Number.isInteger(value) || value < (allowZero ? 0 : 1) || value > MAX_CAPACITY) {
+    if (!(allowZero ? (0, RegistrationBuilderPolicy_1.isValidCapacity)(value) : (0, RegistrationBuilderPolicy_1.isValidPositiveCapacity)(value))) {
         throw new RangeError(`${field} is outside its supported range.`);
     }
 }
 function validatePublicWeight(value, field) {
-    if (!Number.isInteger(value) || value < 0 || value > MAX_PUBLIC_WEIGHT) {
-        throw new RangeError(`${field} must be an integer in 0..10000.`);
+    if (!(0, RegistrationBuilderPolicy_1.isValidPublicWeight)(value)) {
+        throw new RangeError(`${field} must be an integer in 0..${RegistrationBuilderPolicy_1.ZLINK_MAX_PUBLIC_WEIGHT}.`);
     }
 }
 function validateSortedUnique(values, key, field) {
@@ -361,8 +330,7 @@ function cloneDescriptor(descriptor) {
 function clonePeer(peer) {
     return {
         descriptor: cloneDescriptor(peer.descriptor),
-        connectionId: peer.connectionId,
-        connectionDiscriminator: peer.connectionDiscriminator
+        connectionId: peer.connectionId
     };
 }
 function sameServiceNodeDescriptor(left, right) {
@@ -382,13 +350,6 @@ function sameImmutableDescriptor(left, right) {
 function arraysEqual(left, right) {
     return left.length === right.length && left.every((value, index) => value === right[index]);
 }
-function isUnmonitoredConnectionId(connectionId) {
-    return connectionId.startsWith('unmonitored:');
-}
-function compareConnectionCandidate(leftDiscriminator, leftId, rightDiscriminator, rightId) {
-    const discriminator = compareOrdinal(leftDiscriminator, rightDiscriminator);
-    return discriminator === 0 ? compareOrdinal(leftId, rightId) : discriminator;
-}
 function compareOrdinal(left, right) {
     return left < right ? -1 : left > right ? 1 : 0;
 }

package/dist/runtime/foundation/service-wire-binary-primitives.d.ts

@@ -1,4 +1,9 @@
 import type { RoutingId } from '../../contracts';
+export declare const SERVICE_WIRE_MAJOR_OFFSET = 2;
+export declare const SERVICE_WIRE_COMMAND_OFFSET: number;
+export declare const SERVICE_WIRE_FLAGS_OFFSET: number;
+export declare const SERVICE_WIRE_PREFIX_SIZE: number;
+export declare const SERVICE_WIRE_TEXT8_MAX_BYTES = 255;
 export type ServiceWireInvalid = (message: string) => never;
 /** Encodes text without silently replacing an unpaired UTF-16 surrogate. */
 export declare function encodeCanonicalServiceWireText(value: string, field: string, maximumBytes: number, invalid: ServiceWireInvalid): Buffer;

package/dist/runtime/foundation/service-wire-binary-primitives.js

@@ -1,10 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICE_WIRE_TEXT8_MAX_BYTES = exports.SERVICE_WIRE_PREFIX_SIZE = exports.SERVICE_WIRE_FLAGS_OFFSET = exports.SERVICE_WIRE_COMMAND_OFFSET = exports.SERVICE_WIRE_MAJOR_OFFSET = void 0;
 exports.encodeCanonicalServiceWireText = encodeCanonicalServiceWireText;
 exports.decodeCanonicalServiceWireText = decodeCanonicalServiceWireText;
 exports.encodeServiceWireRoutingId = encodeServiceWireRoutingId;
 exports.decodeServiceWireRoutingId = decodeServiceWireRoutingId;
 const routing_id_1 = require("../routing-id");
+exports.SERVICE_WIRE_MAJOR_OFFSET = 2;
+exports.SERVICE_WIRE_COMMAND_OFFSET = exports.SERVICE_WIRE_MAJOR_OFFSET + 1;
+exports.SERVICE_WIRE_FLAGS_OFFSET = exports.SERVICE_WIRE_COMMAND_OFFSET + 1;
+exports.SERVICE_WIRE_PREFIX_SIZE = exports.SERVICE_WIRE_FLAGS_OFFSET + 1;
+exports.SERVICE_WIRE_TEXT8_MAX_BYTES = 255;
 /** Encodes text without silently replacing an unpaired UTF-16 surrogate. */
 function encodeCanonicalServiceWireText(value, field, maximumBytes, invalid) {
     const bytes = Buffer.from(value, 'utf8');

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

@@ -2,7 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceWireDecodeError = void 0;
 exports.createServiceWireCodec = createServiceWireCodec;
-const PREFIX_SIZE = 5;
+const stream_wire_1 = require("@zlink-systems/stream-wire");
+const service_wire_binary_primitives_1 = require("./service-wire-binary-primitives");
+const PREFIX_SIZE = service_wire_binary_primitives_1.SERVICE_WIRE_PREFIX_SIZE;
 const LIVENESS_FRAME_SIZE = PREFIX_SIZE + 8;
 class ServiceWireDecodeError extends Error {
     code;
@@ -21,15 +23,15 @@ function createServiceWireCodec(definition) {
                 record.command !== definition.commands.livenessAck) {
                 throw new RangeError('command must be a liveness command.');
             }
-            if (record.probeId <= 0n || record.probeId > 0xffffffffffffffffn) {
+            if (record.probeId <= 0n || record.probeId > stream_wire_1.UINT64_MAX) {
                 throw new RangeError('probeId must be a non-zero unsigned 64-bit integer.');
             }
             const frame = Buffer.allocUnsafe(LIVENESS_FRAME_SIZE);
             frame[0] = definition.magic[0];
             frame[1] = definition.magic[1];
-            frame[2] = definition.major;
-            frame[3] = record.command;
-            frame[4] = 0;
+            frame[service_wire_binary_primitives_1.SERVICE_WIRE_MAJOR_OFFSET] = definition.major;
+            frame[service_wire_binary_primitives_1.SERVICE_WIRE_COMMAND_OFFSET] = record.command;
+            frame[service_wire_binary_primitives_1.SERVICE_WIRE_FLAGS_OFFSET] = 0;
             frame.writeBigUInt64BE(record.probeId, PREFIX_SIZE);
             return frame;
         },
@@ -39,16 +41,16 @@ function createServiceWireCodec(definition) {
             if (frame[0] !== definition.magic[0] || frame[1] !== definition.magic[1]) {
                 fail('invalid-magic');
             }
-            if (frame[2] !== definition.major)
+            if (frame[service_wire_binary_primitives_1.SERVICE_WIRE_MAJOR_OFFSET] !== definition.major)
                 fail('unsupported-major');
-            const command = frame[3];
+            const command = frame[service_wire_binary_primitives_1.SERVICE_WIRE_COMMAND_OFFSET];
             if (!knownCommands.has(command))
                 fail('unknown-command');
             if (command !== definition.commands.livenessProbe &&
                 command !== definition.commands.livenessAck) {
                 fail('unknown-command');
             }
-            if (frame[4] !== 0)
+            if (frame[service_wire_binary_primitives_1.SERVICE_WIRE_FLAGS_OFFSET] !== 0)
                 fail('forbidden-flag');
             if (frame.byteLength < LIVENESS_FRAME_SIZE)
                 fail('truncated-field');

package/dist/runtime/foundation/service-wire-constants.generated.d.ts

@@ -1,5 +1,6 @@
 export declare const SERVICE_WIRE_MAGIC: readonly [90, 77];
 export declare const SERVICE_WIRE_MAJOR: 1;
+export declare const SERVICE_WIRE_METADATA_BYTES: 1024;
 export declare const SERVICE_WIRE_REQUIRED_CAPABILITY: "framework-service-v13";
 export declare const SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME: "ZLinkFrameworkMultipart";
 export declare const SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE: "application/x-zlink-multipart";

package/dist/runtime/foundation/service-wire-constants.generated.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isValidServiceWireTerminalFailure = exports.ServiceWireExactTerminalByFailureCode = exports.ServiceWireBoundaryTerminalResults = exports.ServiceWireFrameworkErrorCode = exports.ServiceWireFlag = exports.ServiceWireCommand = exports.SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE = exports.SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME = exports.SERVICE_WIRE_REQUIRED_CAPABILITY = exports.SERVICE_WIRE_MAJOR = exports.SERVICE_WIRE_MAGIC = void 0;
+exports.isValidServiceWireTerminalFailure = exports.ServiceWireExactTerminalByFailureCode = exports.ServiceWireBoundaryTerminalResults = exports.ServiceWireFrameworkErrorCode = exports.ServiceWireFlag = exports.ServiceWireCommand = exports.SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE = exports.SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME = exports.SERVICE_WIRE_REQUIRED_CAPABILITY = exports.SERVICE_WIRE_METADATA_BYTES = exports.SERVICE_WIRE_MAJOR = exports.SERVICE_WIRE_MAGIC = void 0;
 // Generated from service-wire-v1.schema.json. Do not edit.
 exports.SERVICE_WIRE_MAGIC = [90, 77];
 exports.SERVICE_WIRE_MAJOR = 1;
+exports.SERVICE_WIRE_METADATA_BYTES = 1024;
 exports.SERVICE_WIRE_REQUIRED_CAPABILITY = "framework-service-v13";
 exports.SERVICE_FRAMEWORK_MULTIPART_PACKET_NAME = "ZLinkFrameworkMultipart";
 exports.SERVICE_FRAMEWORK_MULTIPART_CONTENT_TYPE = "application/x-zlink-multipart";

package/dist/runtime/foundation/service-wire-m6a-codec.d.ts

@@ -1,4 +1,6 @@
 import { type ServiceNodeDescriptor } from './service-topology-registry';
+export declare const APPLICATION_PAYLOAD_VERSION = 1;
+export declare const APPLICATION_PAYLOAD_MINIMUM_FIELD_BYTES: number;
 export declare const M6A_SERVICE_WIRE_MAGIC: readonly [90, 77];
 export declare const M6A_SERVICE_WIRE_MAJOR: 1;
 export declare const M6A_SERVICE_WIRE_REQUIRED_CAPABILITY: "framework-service-v13";

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;
 };