@zlink-systems/framework 0.10.0

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

@@ -0,0 +1,597 @@
+import type { ServiceActorRef, ServiceSessionBinding, ServiceSpotRef } from './service-stateful-registry';
+export declare const M6bServiceWireCommand: {
+    readonly hello: 1;
+    readonly admit: 2;
+    readonly reject: 3;
+    readonly update: 4;
+    readonly livenessProbe: 5;
+    readonly livenessAck: 6;
+    readonly nodeSend: 16;
+    readonly nodeRequest: 17;
+    readonly channelSend: 18;
+    readonly channelRequest: 19;
+    readonly reply: 20;
+    readonly spotSend: 21;
+    readonly spotRequest: 22;
+    readonly logicalMulticast: 23;
+    readonly actorSend: 24;
+    readonly actorRequest: 25;
+    readonly actorLookup: 26;
+    readonly actorDestroy: 27;
+    readonly actorJoin: 28;
+    readonly actorLeft: 29;
+    readonly relocationReady: 30;
+    readonly relocationData: 31;
+    readonly replyRelay: 33;
+    readonly relocationCutover: 34;
+    readonly boundSessionSend: 36;
+    readonly actorJoined: 37;
+    readonly boundSessionBind: 38;
+    readonly instanceSpot: 39;
+    readonly relocationPrepare: 40;
+    readonly sessionRelocationSeal: 42;
+    readonly sessionRelocationSealed: 43;
+    readonly sessionRelocationRoute: 44;
+    readonly replyRelayAck: 46;
+    readonly userSpotCreate: 47;
+    readonly userSpotClose: 48;
+    readonly actorCreate: 49;
+    readonly messageFollow: 50;
+    readonly boundSessionReplaced: 51;
+    readonly relocationState: 52;
+    readonly relocationFailed: 53;
+};
+export interface ServiceWireOperationId {
+    readonly high: bigint;
+    readonly low: bigint;
+}
+export interface ServiceWireRelocationCoordinatorFence {
+    readonly ownerId: string;
+    readonly leaseGeneration: bigint;
+    readonly nodeRid: string;
+    readonly nodeGeneration: bigint;
+    readonly expectedAuthorityStoreVersion: string;
+}
+export interface ServiceWireRequestSourceFence {
+    readonly ownerId: string;
+    readonly leaseGeneration: bigint;
+    readonly nodeRid: string;
+    readonly nodeGeneration: bigint;
+}
+export interface ServiceMaintenanceReplyRelay {
+    readonly relocation: ServiceWireOperationId;
+    readonly targetAttemptGeneration: bigint;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+    readonly operation: ServiceWireOperationId;
+    readonly replyRouteId: bigint;
+    readonly participantId: bigint;
+    readonly sequence: bigint;
+    readonly terminalResult: number;
+    readonly failureCode: number;
+    readonly payload?: {
+        readonly packetName: string;
+        readonly contentType: string;
+        readonly bytes: Uint8Array;
+    };
+}
+export interface ServiceMaintenanceReplyRelayAck {
+    readonly relocation: ServiceWireOperationId;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+    readonly operation: ServiceWireOperationId;
+    readonly replyRouteId: bigint;
+    readonly requestSource: ServiceWireRequestSourceFence;
+    readonly status: 'terminalReceived' | 'alreadyTerminal';
+}
+export type ServiceWireRelocationRole = 'source' | 'target' | 'coordinator';
+export interface ServiceWireRelocationTarget {
+    readonly nodeRid: string;
+    readonly nodeGeneration: bigint;
+    readonly ownerId: string;
+    readonly ownerLeaseGeneration: bigint;
+}
+export type ServiceWireRelocationObject = {
+    readonly kind: 'actor';
+    readonly actorId: string;
+    readonly objectGeneration: bigint;
+    readonly expectedAuthorityOwnerGeneration: bigint;
+} | {
+    readonly kind: 'userSpot';
+    readonly spotId: string;
+    readonly objectGeneration: bigint;
+    readonly expectedAuthorityOwnerGeneration: bigint;
+} | {
+    readonly kind: 'instanceSpot';
+    readonly stableType: string;
+    readonly spotId: string;
+    readonly objectGeneration: bigint;
+};
+/** Shared CRC-32C wire bounds for the direct relocation payload transfer. */
+export declare const RELOCATION_PAYLOAD_TOTAL_LENGTH_MAX = 274877906944n;
+export declare const RELOCATION_PAYLOAD_CHUNK_COUNT_MAX = 4096;
+export declare const RELOCATION_STATE_CHUNK_DATA_MAX_BYTES = 67108864;
+interface ServiceWireRelocationBase {
+    readonly relocation: ServiceWireOperationId;
+    readonly targetAttemptGeneration: bigint;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+}
+export interface ServiceMaintenanceRelocationPrepare extends ServiceWireRelocationBase {
+    readonly kind: 'prepare';
+    readonly target: ServiceWireRelocationTarget;
+    readonly initiatorRole: ServiceWireRelocationRole;
+    readonly object: ServiceWireRelocationObject;
+    readonly sourceNodeRid: string;
+    readonly sourceNodeGeneration: bigint;
+    /** Total encoded byte length of the directly transferred relocation payload. */
+    readonly payloadTotalLength: bigint;
+    /** Number of relocationState chunks that carry the payload. */
+    readonly payloadChunkCount: number;
+    /** CRC-32C (Castagnoli) over the fully assembled payload bytes. */
+    readonly payloadChecksumCrc32c: number;
+    readonly applicationVersion: bigint;
+    /** NODE-INTERNAL; serialized as extra frames after canonical command 40. */
+    readonly nodeInternalBoundSessions?: readonly {
+        readonly participantKey: string;
+        readonly payload: Uint8Array;
+    }[];
+}
+export interface ServiceMaintenanceRelocationReady extends ServiceWireRelocationBase {
+    readonly kind: 'ready';
+    readonly target: ServiceWireRelocationTarget;
+    readonly object: ServiceWireRelocationObject;
+    readonly senderRole: ServiceWireRelocationRole;
+}
+/** Explicit target-side pre-cutover relocation failure (command 53). */
+export interface ServiceMaintenanceRelocationFailed extends ServiceWireRelocationBase {
+    readonly kind: 'failed';
+    readonly target: ServiceWireRelocationTarget;
+    readonly object: ServiceWireRelocationObject;
+    readonly senderRole: ServiceWireRelocationRole;
+    readonly failureCode: number;
+}
+export interface ServiceWireFrozenRecord {
+    readonly recordKind: number;
+    readonly sourceKind: number;
+    readonly source: ServiceWireRequestSourceFence;
+    readonly sourceSpotId?: string;
+    readonly sourceActor?: {
+        readonly actorId: string;
+        readonly generation: bigint;
+    };
+    readonly sourceSessionRid?: string;
+    readonly sourceBindingGeneration?: bigint;
+    readonly sourceSessionSequence?: bigint;
+    readonly hasMetadata: boolean;
+    readonly operationId: ServiceWireOperationId;
+    readonly operationKind: number;
+    readonly replyRouteId?: bigint;
+    /** Decoded routing/application body used by the target temporary queue owner. */
+    readonly target?: {
+        readonly kind: 'spot';
+        readonly spotId: string;
+        readonly generation: bigint;
+        readonly targetNodeRid: string;
+        readonly targetNodeGeneration: bigint;
+        readonly authorityOwnerGeneration: bigint;
+        readonly ownerLeaseGeneration: bigint;
+    } | {
+        readonly kind: 'actor';
+        readonly actorId: string;
+        readonly generation: bigint;
+        readonly targetNodeRid: string;
+        readonly targetNodeGeneration: bigint;
+        readonly authorityOwnerGeneration: bigint;
+        readonly ownerLeaseGeneration: bigint;
+    };
+    readonly applicationPayload?: NonNullable<ServiceMaintenanceReplyRelay['payload']>;
+    readonly canonicalBytes: Buffer;
+}
+export interface ServiceMaintenanceRelocationData extends ServiceWireRelocationBase {
+    readonly kind: 'data';
+    readonly senderRole: ServiceWireRelocationRole;
+    readonly object: ServiceWireRelocationObject;
+    readonly frozenRecord: ServiceWireFrozenRecord;
+}
+export interface ServiceMaintenanceRelocationCutover extends ServiceWireRelocationBase {
+    readonly kind: 'cutover';
+    readonly senderRole: ServiceWireRelocationRole;
+    readonly object: ServiceWireRelocationObject;
+    /** Number of boundary relay records sent before this cutover. */
+    readonly boundaryRecordCount: bigint;
+    /** CRC-32C over the concatenated canonical bytes of those relay records. */
+    readonly boundaryChecksumCrc32c: number;
+}
+/** One relocation payload chunk (command 52), sent one-way on the ordered connection. */
+export interface ServiceMaintenanceRelocationState extends ServiceWireRelocationBase {
+    readonly kind: 'state';
+    readonly senderRole: ServiceWireRelocationRole;
+    readonly object: ServiceWireRelocationObject;
+    readonly chunkOrdinal: number;
+    readonly chunkData: Uint8Array;
+}
+export type ServiceMaintenanceRelocationControl = ServiceMaintenanceRelocationPrepare | ServiceMaintenanceRelocationReady | ServiceMaintenanceRelocationFailed | ServiceMaintenanceRelocationData | ServiceMaintenanceRelocationCutover | ServiceMaintenanceRelocationState;
+export declare const M6bServiceWireFlag: {
+    readonly metadata: 1;
+    readonly boundSession: 2;
+    readonly sourceSpotId: 4;
+    readonly extension: 8;
+};
+export interface ServiceSpotRouteFence {
+    readonly spot: ServiceSpotRef;
+    readonly targetNodeRid: string;
+    readonly targetNodeGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+    /** Schema spot-route-fence expectedOwnerLeaseGeneration. */
+    readonly ownerLeaseGeneration: bigint;
+}
+export interface ServiceDirectSpotRouteFence extends ServiceSpotRouteFence {
+    readonly ownerLeaseGeneration: bigint;
+    readonly storeVersion: string;
+}
+export interface ServiceActorRouteFence {
+    readonly actor: ServiceActorRef;
+    readonly targetNodeGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+    readonly ownerLeaseGeneration: bigint;
+}
+/**
+ * The authority fence carried by a bound-session replacement notice.  This
+ * command is deliberately separate from the legacy Actor message fence: the
+ * receiver validates the transport source against this authority target and
+ * must not resolve a local Actor object for the retired session.
+ */
+export interface ServiceBoundSessionActorAuthority {
+    readonly actor: ServiceActorRef;
+    readonly targetNodeGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+    readonly ownerLeaseGeneration: bigint;
+}
+export interface ServiceSessionRelocationOwnerFence {
+    readonly sessionOwnerNodeRid: string;
+    readonly sessionOwnerNodeGeneration: bigint;
+    readonly sessionOwnerId: string;
+    readonly sessionOwnerLeaseGeneration: bigint;
+    readonly sessionRid: string;
+    readonly bindingGeneration: bigint;
+}
+export interface ServiceSessionRelocationSeal {
+    readonly relocation: ServiceWireOperationId;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+    readonly senderRole: 'source' | 'coordinator';
+    readonly actor: ServiceBoundSessionActorAuthority;
+    readonly session: ServiceSessionRelocationOwnerFence;
+}
+export interface ServiceSessionRelocationSealed {
+    readonly relocation: ServiceWireOperationId;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+    readonly actor: ServiceBoundSessionActorAuthority;
+    readonly session: ServiceSessionRelocationOwnerFence;
+}
+export type ServiceSessionRelocationRoute = {
+    readonly relocation: ServiceWireOperationId;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+    readonly senderRole: 'target' | 'coordinator';
+    readonly actor: ServiceActorRef;
+    readonly session: ServiceSessionRelocationOwnerFence;
+    readonly route: {
+        readonly action: 'commit';
+        readonly previousAuthorityOwnerGeneration: bigint;
+        readonly targetAuthorityOwnerGeneration: bigint;
+        readonly targetNodeRid: string;
+        readonly targetNodeGeneration: bigint;
+    };
+} | {
+    readonly relocation: ServiceWireOperationId;
+    readonly coordinator: ServiceWireRelocationCoordinatorFence;
+    readonly senderRole: 'source' | 'coordinator';
+    readonly actor: ServiceActorRef;
+    readonly session: ServiceSessionRelocationOwnerFence;
+    readonly route: {
+        readonly action: 'abort';
+        readonly currentAuthorityOwnerGeneration: bigint;
+    };
+};
+export declare function serviceSessionRelocationIdentityKey(value: ServiceSessionRelocationSeal | ServiceSessionRelocationSealed | ServiceSessionRelocationRoute): string;
+export interface ServiceRetiredBoundSessionRouteFence {
+    readonly sessionOwnerNodeRid: string;
+    readonly sessionOwnerNodeGeneration: bigint;
+    readonly sessionOwnerId: string;
+    readonly sessionOwnerLeaseGeneration: bigint;
+    readonly sessionRid: string;
+    readonly retiredBindingGeneration: bigint;
+}
+export interface ServiceBoundSessionSource {
+    readonly sessionRid: string;
+    readonly bindingGeneration: bigint;
+    readonly sequence: bigint;
+}
+export interface ServiceInstanceRouteFence {
+    readonly targetNodeRid: string;
+    readonly targetNodeGeneration: bigint;
+    readonly targetSpotId: string;
+    readonly objectGeneration: bigint;
+    readonly ownerId: string;
+    readonly authorityOwnerGeneration: bigint;
+    readonly leaseGeneration: bigint;
+    readonly storeVersion: string;
+}
+export interface ServiceInstanceActivationTarget {
+    readonly targetNodeRid: string;
+    readonly targetNodeGeneration: bigint;
+    readonly targetSpotId: string;
+    readonly stableType: string;
+    readonly descriptorVersion: string;
+}
+export interface ServiceUserSpotReservationFence {
+    readonly reservationId: string;
+    readonly expectedStoreVersion: string;
+    readonly objectGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+    readonly targetNodeRid: string;
+    readonly targetNodeGeneration: bigint;
+    readonly targetOwnerId: string;
+    readonly targetOwnerLeaseGeneration: bigint;
+    readonly pendingCapacityDelta: number;
+}
+export interface ServiceUserSpotCreateRecord {
+    readonly kind: 'userSpotCreate';
+    readonly correlation: bigint;
+    readonly operation: {
+        readonly high: bigint;
+        readonly low: bigint;
+    };
+    readonly sourceNodeRid: string;
+    readonly sourceNodeGeneration: bigint;
+    readonly spotId: string;
+    readonly stableType: string;
+    readonly reservation: ServiceUserSpotReservationFence;
+    readonly deadlineUnixMs: bigint;
+}
+export interface ServiceActorCreateRecord {
+    readonly kind: 'actorCreate';
+    readonly correlation: bigint;
+    readonly operation: {
+        readonly high: bigint;
+        readonly low: bigint;
+    };
+    readonly sourceNodeRid: string;
+    readonly sourceNodeGeneration: bigint;
+    readonly actorId: string;
+    readonly stableType: string;
+    readonly reservation: ServiceUserSpotReservationFence;
+    readonly deadlineUnixMs: bigint;
+}
+export interface ServiceUserSpotCloseRecord {
+    readonly kind: 'userSpotClose';
+    readonly correlation: bigint;
+    readonly operation: {
+        readonly high: bigint;
+        readonly low: bigint;
+    };
+    readonly sourceNodeRid: string;
+    readonly sourceNodeGeneration: bigint;
+    readonly target: {
+        readonly spotId: string;
+        readonly objectGeneration: bigint;
+        readonly targetNodeRid: string;
+        readonly targetNodeGeneration: bigint;
+        readonly authorityOwnerGeneration: bigint;
+        readonly expectedStoreVersion: string;
+    };
+    readonly deadlineUnixMs: bigint;
+}
+export type ServiceMessageFollowRoute = {
+    readonly kind: 'actor';
+    readonly actor: ServiceActorRef;
+    readonly targetNodeRid: string;
+    readonly targetNodeGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+    readonly ownerLeaseGeneration: bigint;
+} | {
+    readonly kind: 'spot';
+    readonly spot: ServiceSpotRef;
+    readonly targetNodeRid: string;
+    readonly targetNodeGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+    readonly ownerLeaseGeneration: bigint;
+};
+export interface ServiceMessageFollowRecord {
+    readonly kind: 'messageFollow';
+    readonly source: ServiceMessageFollowRoute;
+    readonly target: ServiceMessageFollowRoute;
+    readonly hopCount: number;
+    readonly queuedMessages: number;
+    readonly queuedBytes: number;
+    readonly originalOperation: ServiceWireOperationId;
+    readonly originalReplyRouteId: bigint;
+}
+export type ServiceBoundSessionTransition = {
+    readonly state: 'active';
+    readonly generation: bigint;
+} | {
+    readonly state: 'tombstone';
+    readonly retiredGeneration: bigint;
+};
+export type ServiceStatefulWireRecord = {
+    readonly kind: 'spotSend' | 'spotRequest';
+    readonly correlation?: bigint;
+    readonly sourceSpotId: string;
+    readonly target: ServiceDirectSpotRouteFence;
+} | {
+    readonly kind: 'logicalMulticast';
+    readonly channelName: string;
+    readonly topic: string;
+    readonly sourceSpotId: string;
+} | {
+    readonly kind: 'actorSend' | 'actorRequest';
+    readonly correlation?: bigint;
+    readonly sourceActor?: ServiceActorRef;
+    readonly target: ServiceActorRouteFence;
+    readonly boundSession?: ServiceBoundSessionSource;
+} | {
+    readonly kind: 'actorLookup';
+    readonly correlation: bigint;
+    readonly actorId: string;
+} | {
+    readonly kind: 'actorDestroy';
+    readonly correlation: bigint;
+    readonly actor: ServiceActorRouteFence;
+} | {
+    readonly kind: 'actorJoin';
+    readonly correlation: bigint;
+    readonly actor: ServiceActorRouteFence;
+    readonly entry: boolean;
+    readonly target: ServiceSpotRouteFence;
+} | {
+    readonly kind: 'boundSessionSend';
+    readonly actor: ServiceActorRouteFence;
+    readonly expectedBindingGeneration: bigint;
+} | {
+    readonly kind: 'boundSessionBind';
+    readonly correlation: bigint;
+    readonly actor: ServiceActorRouteFence;
+    readonly sessionRid: string;
+    readonly binding: ServiceBoundSessionTransition;
+} | {
+    readonly kind: 'boundSessionReplaced';
+    readonly actorAuthority: ServiceBoundSessionActorAuthority;
+    readonly retiredSession: ServiceRetiredBoundSessionRouteFence;
+} | {
+    readonly kind: 'instanceSpot';
+    readonly activation: 'ready';
+    readonly route: ServiceInstanceRouteFence;
+    readonly sourceNodeGeneration: bigint;
+    readonly sourceNodeRid: string;
+    readonly sourceSpotId?: string;
+    readonly operationKind: 'send' | 'request';
+    readonly operation: {
+        readonly high: bigint;
+        readonly low: bigint;
+    };
+    readonly replyRouteId?: bigint;
+} | {
+    readonly kind: 'instanceSpot';
+    readonly activation: 'missing';
+    readonly target: ServiceInstanceActivationTarget;
+    readonly sourceNodeGeneration: bigint;
+    readonly sourceNodeRid: string;
+    readonly sourceSpotId?: string;
+    readonly operationKind: 'send' | 'request';
+    readonly operation: {
+        readonly high: bigint;
+        readonly low: bigint;
+    };
+    readonly deadlineUnixMs: bigint;
+    readonly replyRouteId?: bigint;
+} | ServiceUserSpotCreateRecord | ServiceUserSpotCloseRecord | ServiceActorCreateRecord | ServiceMessageFollowRecord;
+export type ServiceStatefulReplyTail = {
+    readonly kind: 'actorLookup';
+    readonly actor: ServiceActorRef;
+    readonly spot: ServiceSpotRef;
+    readonly membershipEpoch: bigint;
+    readonly authorityOwnerGeneration: bigint;
+} | {
+    readonly kind: 'actorJoin';
+    readonly joinResult: 0 | 1;
+    readonly spot?: ServiceSpotRef;
+    readonly membershipEpoch?: bigint;
+    /** Target's advertised valid receive chunk cap. 0 = not advertised (accepted only). */
+    readonly receiveChunkLimitBytes?: number;
+} | {
+    readonly kind: 'streamBind';
+    readonly bindingGeneration: bigint;
+    readonly authorityOwnerGeneration: bigint;
+} | {
+    readonly kind: 'userSpotCreate';
+    readonly createResult: 'existing' | 'created' | 'rejected';
+    readonly spotId: string;
+    readonly objectGeneration: bigint;
+} | {
+    readonly kind: 'userSpotClose';
+    readonly closed: boolean;
+} | {
+    readonly kind: 'actorCreate';
+    readonly createResult: 'existing' | 'created' | 'rejected';
+    readonly actor?: ServiceActorRef & {
+        readonly nodeRid: string;
+    };
+};
+export interface ServiceStatefulReply {
+    readonly correlation: bigint;
+    readonly terminalResult: number;
+    readonly failureCode: number;
+    readonly tail?: ServiceStatefulReplyTail;
+}
+export declare function encodeSpotHeader(kind: 'spotSend' | 'spotRequest', sourceSpotId: string, target: ServiceDirectSpotRouteFence, correlation?: bigint): Buffer;
+export declare function encodeActorHeader(kind: 'actorSend' | 'actorRequest', target: ServiceActorRouteFence, correlation?: bigint, sourceActor?: ServiceActorRef, boundSession?: ServiceBoundSessionSource): Buffer;
+export declare function encodeLogicalMulticastHeader(channelName: string, topic: string, sourceSpotId: string): Buffer;
+export declare function encodeActorLookupHeader(correlation: bigint, actorId: string): Buffer;
+export declare function encodeActorDestroyHeader(correlation: bigint, actor: ServiceActorRouteFence): Buffer;
+export declare function encodeBoundSessionSendHeader(actor: ServiceActorRouteFence, expectedBindingGeneration: bigint): Buffer;
+export declare function encodeBoundSessionBindHeader(correlation: bigint, actor: ServiceActorRouteFence, sessionRid: string, binding: ServiceBoundSessionTransition): Buffer;
+export declare function encodeBoundSessionReplacedHeader(actorAuthority: ServiceBoundSessionActorAuthority, retiredSession: ServiceRetiredBoundSessionRouteFence): Buffer;
+/** Encodes canonical service-wire command 42. */
+export declare function encodeSessionRelocationSeal(value: ServiceSessionRelocationSeal): Buffer;
+/** Decodes canonical service-wire command 42. */
+export declare function decodeSessionRelocationSeal(frame: Uint8Array): ServiceSessionRelocationSeal;
+/** Encodes canonical service-wire command 43. */
+export declare function encodeSessionRelocationSealed(value: ServiceSessionRelocationSealed): Buffer;
+/** Decodes canonical service-wire command 43. */
+export declare function decodeSessionRelocationSealed(frame: Uint8Array): ServiceSessionRelocationSealed;
+/** Encodes canonical service-wire command 44. */
+export declare function encodeSessionRelocationRoute(value: ServiceSessionRelocationRoute): Buffer;
+/** Decodes canonical service-wire command 44. */
+export declare function decodeSessionRelocationRoute(frame: Uint8Array): ServiceSessionRelocationRoute;
+export declare function encodeInstanceSpotHeader(route: ServiceInstanceRouteFence, sourceNodeGeneration: bigint, sourceNodeRid: string, sourceSpotId: string | undefined, operationKind: 'send' | 'request', operation: {
+    readonly high: bigint;
+    readonly low: bigint;
+}, replyRouteId?: bigint, hasMetadata?: boolean): Buffer;
+export declare function encodeInstanceSpotActivationHeader(target: ServiceInstanceActivationTarget, sourceNodeGeneration: bigint, sourceNodeRid: string, sourceSpotId: string | undefined, operationKind: 'send' | 'request', operation: {
+    readonly high: bigint;
+    readonly low: bigint;
+}, deadlineUnixMs: bigint, replyRouteId?: bigint, hasMetadata?: boolean): Buffer;
+export declare function encodeUserSpotCreateHeader(record: Omit<ServiceUserSpotCreateRecord, 'kind'>): Buffer;
+export declare function encodeActorCreateHeader(record: Omit<ServiceActorCreateRecord, 'kind'>): Buffer;
+export declare function encodeUserSpotCloseHeader(record: Omit<ServiceUserSpotCloseRecord, 'kind'>): Buffer;
+export declare function encodeMessageFollowHeader(record: Omit<ServiceMessageFollowRecord, 'kind'>): Buffer;
+export declare function decodeStatefulHeader(frame: Uint8Array): ServiceStatefulWireRecord;
+export declare function encodeStatefulReply(correlation: bigint, terminalResult: number, failureCode: number, tail?: ServiceStatefulReplyTail): Buffer;
+/** Encodes canonical maintenance relocation commands 30, 31, 34, 40, 52, and 53. */
+export declare function encodeMaintenanceRelocationControl(value: ServiceMaintenanceRelocationControl): Buffer;
+/** Decodes canonical maintenance relocation commands and rejects malformed vectors. */
+export declare function decodeMaintenanceRelocationControl(frame: Uint8Array): ServiceMaintenanceRelocationControl;
+/** Encodes canonical service-wire command 33 for a maintenance terminal relay. */
+export declare function encodeMaintenanceReplyRelay(value: ServiceMaintenanceReplyRelay): readonly Buffer[];
+/** Decodes canonical service-wire command 33 and rejects non-maintenance contexts. */
+export declare function decodeMaintenanceReplyRelay(frames: readonly Uint8Array[]): ServiceMaintenanceReplyRelay;
+/** Encodes canonical service-wire command 46. */
+export declare function encodeMaintenanceReplyRelayAck(value: ServiceMaintenanceReplyRelayAck): Buffer;
+/** Decodes canonical service-wire command 46. */
+export declare function decodeMaintenanceReplyRelayAck(frame: Uint8Array): ServiceMaintenanceReplyRelayAck;
+export declare function decodeStatefulReply(frame: Uint8Array, expectedCorrelation: bigint, operationKind: 'spotRequest' | 'actorRequest' | 'actorLookup' | 'actorDestroy' | 'actorJoin' | 'streamBind' | 'streamUnbind' | 'instanceSpotRequest' | 'userSpotCreate' | 'userSpotClose' | 'actorCreate', hasPayload?: boolean): ServiceStatefulReply;
+export declare function sessionBindingFromWire(actor: ServiceActorRef, sessionRid: string, sessionOwnerNodeRid: string, generation: bigint, membershipEpoch: bigint, sessionOwnerNodeGeneration?: bigint, sessionOwnerId?: string, sessionOwnerLeaseGeneration?: bigint): ServiceSessionBinding;
+export declare function decodeServiceWireFrozenRecord(bytes: Uint8Array): ServiceWireFrozenRecord;
+/**
+ * Consumes exactly one canonical frozen record at `offset`.  Relocation
+ * saved-work is a vector of back-to-back records, so its boundary is the
+ * record grammar itself rather than an enclosing length field.
+ */
+export declare function decodeServiceWireFrozenRecordPrefix(bytes: Uint8Array, offset?: number): {
+    readonly record: ServiceWireFrozenRecord;
+    readonly length: number;
+};
+export declare function encodeServiceWireFrozenRecord(record: ServiceWireFrozenRecord): Buffer;
+export declare function encodeServiceWireFrozenActorApplicationRecord(input: {
+    readonly source: ServiceWireRequestSourceFence;
+    readonly target: {
+        readonly actorId: string;
+        readonly objectGeneration: bigint;
+        readonly nodeRid: string;
+        readonly nodeGeneration: bigint;
+        readonly authorityOwnerGeneration: bigint;
+        readonly ownerLeaseGeneration: bigint;
+    };
+    readonly operationId: ServiceWireOperationId;
+    readonly replyRouteId?: bigint;
+    readonly payload: NonNullable<ServiceMaintenanceReplyRelay['payload']>;
+}): ServiceWireFrozenRecord;
+export {};