@zlink-systems/framework 0.25.0 → 0.27.0

package/dist/contracts/Handlers/JsonContract.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineZLinkPacketJsonContract = defineZLinkPacketJsonContract;
 exports.readZLinkPacketJsonContract = readZLinkPacketJsonContract;
+const MAX_CONTRACT_SCHEMA_DEPTH = 64;
 const ZLINK_PACKET_JSON_CONTRACTS = Symbol.for('@zlink-systems/framework:packet-json-contracts');
 function defineZLinkPacketJsonContract(packetName, contract) {
     if (packetName.trim().length === 0) {
@@ -35,8 +36,10 @@ function normalizeJsonSchema(schema, parents, depth) {
     // Keep the runtime boundary defensive for JavaScript callers even though
     // the TypeScript signature describes the accepted shape.
     const runtimeSchema = schema;
-    if (typeof runtimeSchema !== 'object' || runtimeSchema === null || depth > 64) {
-        throw new TypeError('ZLink packet JSON schema must be an acyclic object with at most 64 levels.');
+    if (typeof runtimeSchema !== 'object' ||
+        runtimeSchema === null ||
+        depth > MAX_CONTRACT_SCHEMA_DEPTH) {
+        throw new TypeError(`ZLink packet JSON schema must be an acyclic object with at most ${MAX_CONTRACT_SCHEMA_DEPTH} levels.`);
     }
     const normalizedSchema = runtimeSchema;
     if (parents.has(normalizedSchema))
@@ -95,7 +98,7 @@ function normalizeJsonSchema(schema, parents, depth) {
             }
             const properties = {};
             for (const [name, property] of Object.entries(runtimeProperties)) {
-                if (name === '__proto__' || name === 'prototype' || name === 'constructor') {
+                if (isPrototypeKey(name)) {
                     throw new TypeError(`ZLink packet JSON property '${name}' is not allowed.`);
                 }
                 properties[name] = normalizeJsonSchema(property, nextParents, depth + 1);
@@ -104,7 +107,7 @@ function normalizeJsonSchema(schema, parents, depth) {
                 throw new TypeError('ZLink packet JSON required properties must be unique.');
             }
             for (const name of normalizedSchema.required) {
-                if (name === '__proto__' || name === 'prototype' || name === 'constructor') {
+                if (isPrototypeKey(name)) {
                     throw new TypeError(`ZLink packet JSON property '${name}' is not allowed.`);
                 }
                 if (!Object.prototype.hasOwnProperty.call(properties, name)) {
@@ -147,3 +150,6 @@ function canonicalContract(value) {
         .map(([key, item]) => `${JSON.stringify(key)}:${canonicalContract(item)}`)
         .join(',')}}`;
 }
+function isPrototypeKey(name) {
+    return name === '__proto__' || name === 'prototype' || name === 'constructor';
+}

package/dist/contracts/Locations/Authority.d.ts

@@ -60,7 +60,7 @@ export type ZLinkAuthorityReadResult = {
 export type ZLinkAuthorityMutation = {
     readonly kind: 'put';
     readonly payload: Uint8Array;
-    readonly generationTransition: 'preserve';
+    readonly generationTransition: 'preserve' | 'reincarnate';
 } | {
     /** Rebinds an authority retained by the same owner after lease recovery. */
     readonly kind: 'rebindOwnerLease';

package/dist/contracts/Locations/Authority.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkAuthorityScanCursor = void 0;
+const ZLINK_AUTHORITY_MAX_SCAN_CURSOR_BYTES = 4096;
 class ZLinkAuthorityScanCursor {
     encoded;
     constructor(encoded) {
@@ -8,8 +9,8 @@ class ZLinkAuthorityScanCursor {
     }
     static from(encoded) {
         const byteLength = Buffer.byteLength(encoded, 'utf8');
-        if (byteLength < 1 || byteLength > 4096) {
-            throw new RangeError('Authority scan cursor must contain 1..4096 UTF-8 bytes.');
+        if (byteLength < 1 || byteLength > ZLINK_AUTHORITY_MAX_SCAN_CURSOR_BYTES) {
+            throw new RangeError(`Authority scan cursor must contain 1..${ZLINK_AUTHORITY_MAX_SCAN_CURSOR_BYTES} UTF-8 bytes.`);
         }
         return new ZLinkAuthorityScanCursor(encoded);
     }

package/dist/contracts/Locations/Options.js

@@ -5,7 +5,7 @@ exports.zlinkRuntimeDefaultLocationOptions = {
     ownerLeaseRenewIntervalMs: 5000,
     ownerLeaseTtlMs: 15000,
     pollingIntervalMs: 1000,
-    listPageSize: 1000,
+    listPageSize: 100,
     storeFailureGraceMs: 30000,
     ownerLeaseFencingMarginMs: 5000,
     ownerLeaseRenewTimeoutMs: 3000,

package/dist/contracts/Locations/Stores.d.ts

@@ -1,3 +1,11 @@
+export declare const ZLINK_PROVIDER_MAX_PAGE_SIZE = 1000;
+export declare const ZLINK_PROVIDER_MAX_KEY_BYTES = 1024;
+export declare const ZLINK_PROVIDER_MAX_VALUE_BYTES: number;
+export declare const ZLINK_PROVIDER_MAX_VERSION_BYTES = 4096;
+export declare const ZLINK_PROVIDER_MAX_WRITE_KEYS = 2048;
+export declare const ZLINK_PROVIDER_MAX_WRITE_BYTES: number;
+export declare const ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES: number;
+export declare const ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES = 4096;
 declare const zlinkStoreKeyBrand: unique symbol;
 declare const zlinkStoreVersionBrand: unique symbol;
 declare const zlinkStoreScanCursorBrand: unique symbol;
@@ -33,6 +41,10 @@ export type ZLinkStoreCondition = {
     readonly kind: 'version';
     readonly key: ZLinkStoreKey;
     readonly expected: ZLinkStoreVersion;
+} | {
+    readonly kind: 'value';
+    readonly key: ZLinkStoreKey;
+    readonly expected: Uint8Array;
 };
 export type ZLinkStoreMutation = {
     readonly kind: 'put';

package/dist/contracts/Locations/Stores.js

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES = exports.ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES = exports.ZLINK_PROVIDER_MAX_WRITE_BYTES = exports.ZLINK_PROVIDER_MAX_WRITE_KEYS = exports.ZLINK_PROVIDER_MAX_VERSION_BYTES = exports.ZLINK_PROVIDER_MAX_VALUE_BYTES = exports.ZLINK_PROVIDER_MAX_KEY_BYTES = exports.ZLINK_PROVIDER_MAX_PAGE_SIZE = void 0;
+exports.ZLINK_PROVIDER_MAX_PAGE_SIZE = 1000;
+exports.ZLINK_PROVIDER_MAX_KEY_BYTES = 1024;
+exports.ZLINK_PROVIDER_MAX_VALUE_BYTES = 1024 * 1024;
+exports.ZLINK_PROVIDER_MAX_VERSION_BYTES = 4096;
+exports.ZLINK_PROVIDER_MAX_WRITE_KEYS = 2048;
+exports.ZLINK_PROVIDER_MAX_WRITE_BYTES = 4 * 1024 * 1024;
+exports.ZLINK_PROVIDER_MAX_ENCODED_PAGE_BYTES = 4 * 1024 * 1024;
+exports.ZLINK_PROVIDER_MAX_SCAN_CURSOR_BYTES = 4096;

package/dist/contracts/RouteMesh/RuntimeTopology.d.ts

@@ -123,11 +123,19 @@ export interface ZLinkHostCapacityStatus {
 }
 export interface ZLinkFrameworkRuntime {
     readonly status: ZLinkFrameworkRuntimeStatus;
+    getListenerStatus(kind: ZLinkListenerKind, name: string): ZLinkListenerStatus;
     observe(signal?: AbortSignal): AsyncIterable<ZLinkObservedStatus<ZLinkFrameworkRuntimeStatus>>;
     resetCapacityMetrics(): void;
     relocate(options: ZLinkFrameworkRelocationOptions): Promise<ZLinkFrameworkRelocationResult>;
     shutdown(options?: ZLinkFrameworkLifecycleOptions): Promise<ZLinkFrameworkTerminationResult>;
 }
+export type ZLinkListenerKind = 'routeMesh' | 'clientServer' | 'fanout' | 'stream';
+export interface ZLinkListenerStatus {
+    readonly kind: ZLinkListenerKind;
+    readonly name: string;
+    readonly endpoint: string;
+    readonly observedAt: Date;
+}
 export type ZLinkClientServerRole = 'client' | 'server' | 'clientAndServer';
 export interface ZLinkClientServerTargetStatus {
     readonly nodeRid: RoutingId;

package/dist/contracts/Spots/Contracts.d.ts

@@ -22,7 +22,7 @@ export interface ZLinkWorkerCall<T> {
 export interface ZLinkSpotCommonContext<TSpot = ZLinkSpot> {
     readonly meshName: string;
     readonly spotId: SpotId;
-    readonly objectGeneration: number;
+    readonly objectGeneration: bigint;
     readonly nodeRid: RoutingId;
     readonly outbound: ZLinkSpotOutbound;
     addTimer<THandler extends ZLinkSpotTimerHandler<TSpot>>(name: string, periodMs: number, handlerType: Type<THandler>, options?: ZLinkTimerOptions, signal?: AbortSignal): Promise<ZLinkTimer>;

package/dist/internal.d.ts

@@ -3,6 +3,7 @@ export * from './index';
 export * from './runtime/diagnostics';
 export * from './runtime/host';
 export * from './runtime/admission';
+export * from './runtime/activation-admission';
 export * from './runtime/streams';
 export * from './runtime/streams/protocol';
 export * from './runtime/actors';
@@ -24,3 +25,7 @@ export * from './runtime/foundation';
 export * from './runtime/foundation/service-authority-payload-codec';
 export * from './runtime/framework-errors-internal';
 export * from './contracts/Configuration/Registration';
+export * from './contracts/Locations/Stores';
+export { ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES } from './contracts/Configuration/InternalDefaults';
+export { ZLINK_MAX_STABLE_TYPE_BYTES } from './contracts/Common/CoreTypes';
+export { MAX_LISTENER_PORT, ZLINK_MAX_PUBLIC_WEIGHT, ZLINK_MAX_CAPACITY, isValidPublicWeight, isValidPositiveCapacity, isValidListenerPort, isValidCapacity, requirePublicWeight } from './contracts/Configuration/RegistrationBuilderPolicy';

package/dist/internal.js

@@ -14,12 +14,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = void 0;
+exports.requirePublicWeight = exports.isValidCapacity = exports.isValidListenerPort = exports.isValidPositiveCapacity = exports.isValidPublicWeight = exports.ZLINK_MAX_CAPACITY = exports.ZLINK_MAX_PUBLIC_WEIGHT = exports.MAX_LISTENER_PORT = exports.ZLINK_MAX_STABLE_TYPE_BYTES = exports.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES = exports.ZLinkLocationWriteStatus = exports.ZLinkLocationWriteIntent = exports.ZLinkRouteKind = exports.ZLinkLocationKind = exports.ZLinkLocationAutoConnectType = void 0;
 /** Test and companion-package integration surface. It is not exported by package.json. */
 __exportStar(require("./index"), exports);
 __exportStar(require("./runtime/diagnostics"), exports);
 __exportStar(require("./runtime/host"), exports);
 __exportStar(require("./runtime/admission"), exports);
+__exportStar(require("./runtime/activation-admission"), exports);
 __exportStar(require("./runtime/streams"), exports);
 __exportStar(require("./runtime/streams/protocol"), exports);
 __exportStar(require("./runtime/actors"), exports);
@@ -46,3 +47,17 @@ __exportStar(require("./runtime/foundation"), exports);
 __exportStar(require("./runtime/foundation/service-authority-payload-codec"), exports);
 __exportStar(require("./runtime/framework-errors-internal"), exports);
 __exportStar(require("./contracts/Configuration/Registration"), exports);
+__exportStar(require("./contracts/Locations/Stores"), exports);
+var InternalDefaults_1 = require("./contracts/Configuration/InternalDefaults");
+Object.defineProperty(exports, "ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES", { enumerable: true, get: function () { return InternalDefaults_1.ZLINK_RELOCATION_MAX_BLOB_REFERENCE_BYTES; } });
+var CoreTypes_1 = require("./contracts/Common/CoreTypes");
+Object.defineProperty(exports, "ZLINK_MAX_STABLE_TYPE_BYTES", { enumerable: true, get: function () { return CoreTypes_1.ZLINK_MAX_STABLE_TYPE_BYTES; } });
+var RegistrationBuilderPolicy_1 = require("./contracts/Configuration/RegistrationBuilderPolicy");
+Object.defineProperty(exports, "MAX_LISTENER_PORT", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.MAX_LISTENER_PORT; } });
+Object.defineProperty(exports, "ZLINK_MAX_PUBLIC_WEIGHT", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.ZLINK_MAX_PUBLIC_WEIGHT; } });
+Object.defineProperty(exports, "ZLINK_MAX_CAPACITY", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.ZLINK_MAX_CAPACITY; } });
+Object.defineProperty(exports, "isValidPublicWeight", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidPublicWeight; } });
+Object.defineProperty(exports, "isValidPositiveCapacity", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidPositiveCapacity; } });
+Object.defineProperty(exports, "isValidListenerPort", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidListenerPort; } });
+Object.defineProperty(exports, "isValidCapacity", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.isValidCapacity; } });
+Object.defineProperty(exports, "requirePublicWeight", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.requirePublicWeight; } });

package/dist/nest-integration.d.ts

@@ -1,7 +1,8 @@
-export { ZLinkConfigurationException, createFrameworkRegistration, hasActorManager, hasSpotNode, hasSpotPublisherClient } from './contracts/Configuration/Registration';
+export { ZLinkConfigurationException, createFrameworkRegistration, normalizeFrameworkRegistration, hasActorManager, hasSpotNode, hasSpotPublisherClient } from './contracts/Configuration/Registration';
 export type * from './contracts/Configuration/RegistrationTypes';
 export type * from './contracts';
-export { registerActorFactory, validateRoutingIdPrefix, registerEntrySpot, registerSpotFactory, validateActorTransferTimeout, validateMessageFollowDuration, validateSessionReplacementCallbackTimeout } from './contracts/Configuration/RegistrationBuilderPolicy';
+export { ZLinkSpotActorSend, ZLinkSpotActorRequest } from './contracts/Handlers/Attributes';
+export { registerActorFactory, registerRelocationStore, validateRoutingIdPrefix, registerEntrySpot, registerSpotFactory, validateActorTransferTimeout, validateMessageFollowDuration, validateSessionReplacementCallbackTimeout } from './contracts/Configuration/RegistrationBuilderPolicy';
 import type { ZLinkLocationRuntimeQuery, ZLinkActorClient, ZLinkActorManager, ZLinkChannelClient, ZLinkClientServerRuntime, ZLinkCodecRegistryBuilder, ZLinkCodecRegistrar, ZLinkDispatchOptions, ZLinkDispatchOptionsBuilder, ZLinkFanoutClient, ZLinkFanoutRuntime, ZLinkRouteClient, ZLinkRouteMeshRuntime, ZLinkRouteMeshRuntimeOptions, ZLinkSpotManager, ZLinkSpotOutbound, ZLinkSpotPublisherClient, ZLinkStreamCompressionBuilder, ZLinkStreamCompressionCodec } from './contracts';
 import type { ZLinkProviderResolver } from './contracts/Common/ZLinkProviderResolver';
 import type { ZLinkSpotHandleResolver } from './runtime/spots/spot-handle';
@@ -10,6 +11,7 @@ import type { ZLinkFrameworkRegistration } from './contracts/Configuration/Regis
 import type { ZLinkCodecSerializerRegistration, ZLinkFrameworkRegistrationOptions, ZLinkStreamCodecRegistration } from './contracts/Configuration/RegistrationTypes';
 import { captureZLinkExecutionTurn } from './runtime/execution';
 export { registerHandlerFilterScope as registerIntegrationHandlerFilterScope, type ZLinkHandlerFilterScopeRunner } from './runtime/channels/handler-filter-scope';
+export { disposeOwnedInstance as disposeIntegrationHandler, disposeOwnedInstances as disposeIntegrationHandlers } from './runtime/handlers/handler-instance-scope';
 export interface ZLinkNestIntegrationRuntimeHost extends Pick<import('./contracts').ZLinkFrameworkRuntime, 'shutdown'> {
     readonly channelRuntimeOptions: unknown;
     readonly routeMeshRuntimeOptions: ZLinkRouteMeshRuntimeOptions;

package/dist/nest-integration.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.registerIntegrationHandlerFilterScope = exports.validateSessionReplacementCallbackTimeout = exports.validateMessageFollowDuration = exports.validateActorTransferTimeout = exports.registerSpotFactory = exports.registerEntrySpot = exports.validateRoutingIdPrefix = exports.registerActorFactory = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.createFrameworkRegistration = exports.ZLinkConfigurationException = void 0;
+exports.disposeIntegrationHandlers = exports.disposeIntegrationHandler = exports.registerIntegrationHandlerFilterScope = exports.validateSessionReplacementCallbackTimeout = exports.validateMessageFollowDuration = exports.validateActorTransferTimeout = exports.registerSpotFactory = exports.registerEntrySpot = exports.validateRoutingIdPrefix = exports.registerRelocationStore = exports.registerActorFactory = exports.ZLinkSpotActorRequest = exports.ZLinkSpotActorSend = exports.hasSpotPublisherClient = exports.hasSpotNode = exports.hasActorManager = exports.normalizeFrameworkRegistration = exports.createFrameworkRegistration = exports.ZLinkConfigurationException = void 0;
 exports.createIntegrationDispatchOptionsBuilder = createIntegrationDispatchOptionsBuilder;
 exports.createIntegrationInboundDispatchOptionsBuilder = createIntegrationInboundDispatchOptionsBuilder;
 exports.createIntegrationLocationOptionsBuilder = createIntegrationLocationOptionsBuilder;
@@ -19,11 +19,16 @@ exports.createIntegrationHttpExecutionScheduler = createIntegrationHttpExecution
 var Registration_1 = require("./contracts/Configuration/Registration");
 Object.defineProperty(exports, "ZLinkConfigurationException", { enumerable: true, get: function () { return Registration_1.ZLinkConfigurationException; } });
 Object.defineProperty(exports, "createFrameworkRegistration", { enumerable: true, get: function () { return Registration_1.createFrameworkRegistration; } });
+Object.defineProperty(exports, "normalizeFrameworkRegistration", { enumerable: true, get: function () { return Registration_1.normalizeFrameworkRegistration; } });
 Object.defineProperty(exports, "hasActorManager", { enumerable: true, get: function () { return Registration_1.hasActorManager; } });
 Object.defineProperty(exports, "hasSpotNode", { enumerable: true, get: function () { return Registration_1.hasSpotNode; } });
 Object.defineProperty(exports, "hasSpotPublisherClient", { enumerable: true, get: function () { return Registration_1.hasSpotPublisherClient; } });
+var Attributes_1 = require("./contracts/Handlers/Attributes");
+Object.defineProperty(exports, "ZLinkSpotActorSend", { enumerable: true, get: function () { return Attributes_1.ZLinkSpotActorSend; } });
+Object.defineProperty(exports, "ZLinkSpotActorRequest", { enumerable: true, get: function () { return Attributes_1.ZLinkSpotActorRequest; } });
 var RegistrationBuilderPolicy_1 = require("./contracts/Configuration/RegistrationBuilderPolicy");
 Object.defineProperty(exports, "registerActorFactory", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerActorFactory; } });
+Object.defineProperty(exports, "registerRelocationStore", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerRelocationStore; } });
 Object.defineProperty(exports, "validateRoutingIdPrefix", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.validateRoutingIdPrefix; } });
 Object.defineProperty(exports, "registerEntrySpot", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerEntrySpot; } });
 Object.defineProperty(exports, "registerSpotFactory", { enumerable: true, get: function () { return RegistrationBuilderPolicy_1.registerSpotFactory; } });
@@ -40,6 +45,9 @@ const workers_1 = require("./runtime/workers");
 const execution_1 = require("./runtime/execution");
 var handler_filter_scope_1 = require("./runtime/channels/handler-filter-scope");
 Object.defineProperty(exports, "registerIntegrationHandlerFilterScope", { enumerable: true, get: function () { return handler_filter_scope_1.registerHandlerFilterScope; } });
+var handler_instance_scope_1 = require("./runtime/handlers/handler-instance-scope");
+Object.defineProperty(exports, "disposeIntegrationHandler", { enumerable: true, get: function () { return handler_instance_scope_1.disposeOwnedInstance; } });
+Object.defineProperty(exports, "disposeIntegrationHandlers", { enumerable: true, get: function () { return handler_instance_scope_1.disposeOwnedInstances; } });
 function createIntegrationDispatchOptionsBuilder(dispatch) {
     return new RegistrationBuilders_1.DefaultDispatchOptionsBuilder(dispatch);
 }
@@ -59,14 +67,15 @@ function createIntegrationRuntimeHost(registration, providerResolver) {
     return new host_1.ZLinkFrameworkRuntimeHost({ registration, providerResolver });
 }
 function createIntegrationChannelClient(registration, runtime) {
-    return new channels_1.DefaultZLinkChannelClient(registration, runtimeHost(runtime).channelTransport);
+    const host = runtimeHost(runtime);
+    return new channels_1.DefaultZLinkChannelClient(registration, host.channelTransport, host.routeTransport, host.spotRouterChannelIdForMesh);
 }
 function createIntegrationFanoutClient(registration, runtime) {
     return new channels_1.DefaultZLinkFanoutClient(registration, runtimeHost(runtime).channelTransport);
 }
 function createIntegrationRouteClient(registration, runtime) {
     const host = runtimeHost(runtime);
-    return new channels_1.DefaultZLinkRouteClient(registration, host.routeTransport, host.spotRouterChannelIdForMesh);
+    return new channels_1.DefaultZLinkRouteClient(registration, host.routeTransport, host.spotRouterChannelIdForMesh, host.channelTransport);
 }
 function createIntegrationSpotPublisherClient(registration, runtime) {
     return new channels_1.DefaultZLinkSpotPublisherClient(registration, runtimeHost(runtime).spotPublisherTransport);
@@ -84,7 +93,7 @@ function createIntegrationActorManager(registration, runtime, providerResolver)
         boundSessionFactory: runtimeOptions.boundSessionFactory ??
             host.boundSessionFactory.create.bind(host.boundSessionFactory),
         providerResolver
-    });
+    }, host.detachedTaskRunner());
     host.setActorManager(manager);
     return manager;
 }
@@ -117,6 +126,7 @@ function createIntegrationSpotManager(registration, runtime, providerResolver) {
             ...(spotNode.spotActorRequestHandlers ?? [])
         ]),
         ...runtimeOptions,
+        detachedTaskRunner: host.detachedTaskRunner(),
         spotRouteResolver: runtimeOptions.spotRouteResolver,
         routedTransport: host.routeTransport,
         providerResolver,

package/dist/runtime/abort.d.ts

@@ -10,4 +10,5 @@ export declare function isAbortError(error: unknown): boolean;
 export declare function createDeadlineExceededError(message?: string): ZLinkDeadlineExceededError;
 export declare function isDeadlineExceededError(error: unknown): boolean;
 export declare function throwIfAborted(signal: AbortSignal | undefined): void;
+export declare function macrotaskBoundary(): Promise<void>;
 export declare function awaitWithAbort<T>(operation: Promise<T>, signal: AbortSignal | undefined, abortOperation?: () => void): Promise<T>;

package/dist/runtime/abort.js

@@ -6,6 +6,7 @@ exports.isAbortError = isAbortError;
 exports.createDeadlineExceededError = createDeadlineExceededError;
 exports.isDeadlineExceededError = isDeadlineExceededError;
 exports.throwIfAborted = throwIfAborted;
+exports.macrotaskBoundary = macrotaskBoundary;
 exports.awaitWithAbort = awaitWithAbort;
 /** The typed cancellation error produced by Framework admission helpers. */
 class ZLinkAbortError extends Error {
@@ -40,11 +41,10 @@ function throwIfAborted(signal) {
         throw createAbortError();
     }
 }
+function macrotaskBoundary() {
+    return new Promise((resolve) => setImmediate(resolve));
+}
 function awaitWithAbort(operation, signal, abortOperation) {
-    if (signal?.aborted === true) {
-        abortOperation?.();
-        throw createAbortError();
-    }
     if (signal === undefined) {
         return operation;
     }
@@ -63,7 +63,6 @@ function awaitWithAbort(operation, signal, abortOperation) {
             abortOperation?.();
             reject(createAbortError());
         };
-        signal.addEventListener('abort', abort, { once: true });
         operation.then((value) => {
             if (settle())
                 resolve(value);
@@ -71,5 +70,9 @@ function awaitWithAbort(operation, signal, abortOperation) {
             if (settle())
                 reject(error);
         });
+        if (signal.aborted)
+            abort();
+        else
+            signal.addEventListener('abort', abort, { once: true });
     });
 }

package/dist/runtime/activation-admission.d.ts

@@ -0,0 +1,28 @@
+/** Current activation admission count and limit of one MeshNode. */
+export interface ZLinkActivationConcurrency {
+    readonly active: number;
+    readonly limit: number;
+}
+/**
+ * MeshNode §5.1 "Pending activation": the single per-MeshNode record of activation admissions.
+ *
+ * Actor creation, User Spot creation, Instance Spot cold activation and a relocation target's
+ * Restore each hold one admission from the moment the target MeshNode receives the operation
+ * until Ready or its target commit, or until it ends by rejection, failure or cleanup. Entry Spot
+ * and Actor Join never acquire one. The limit is enforced here, and the status current value and
+ * the placement `IsAvailable` headroom both read this record.
+ */
+export declare class ZLinkActivationAdmission {
+    private readonly limitOf;
+    private readonly records;
+    constructor(limitOf: (meshName: string) => number);
+    current(meshName: string): ZLinkActivationConcurrency;
+    hasHeadroom(meshName: string): boolean;
+    /**
+     * Holds one admission for `meshName`. A MeshNode without headroom does not accept a new
+     * admission (MeshNode §5.1): the operation fails as Unavailable at once. The returned release
+     * is idempotent.
+     */
+    acquire(meshName: string, signal?: AbortSignal): Promise<() => void>;
+    private record;
+}

package/dist/runtime/activation-admission.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZLinkActivationAdmission = void 0;
+const framework_errors_internal_1 = require("./framework-errors-internal");
+/**
+ * MeshNode §5.1 "Pending activation": the single per-MeshNode record of activation admissions.
+ *
+ * Actor creation, User Spot creation, Instance Spot cold activation and a relocation target's
+ * Restore each hold one admission from the moment the target MeshNode receives the operation
+ * until Ready or its target commit, or until it ends by rejection, failure or cleanup. Entry Spot
+ * and Actor Join never acquire one. The limit is enforced here, and the status current value and
+ * the placement `IsAvailable` headroom both read this record.
+ */
+class ZLinkActivationAdmission {
+    limitOf;
+    records = new Map();
+    constructor(limitOf) {
+        this.limitOf = limitOf;
+    }
+    current(meshName) {
+        const record = this.records.get(meshName);
+        return { active: record?.active ?? 0, limit: record?.limit ?? this.limitOf(meshName) };
+    }
+    hasHeadroom(meshName) {
+        const { active, limit } = this.current(meshName);
+        return active < limit;
+    }
+    /**
+     * Holds one admission for `meshName`. A MeshNode without headroom does not accept a new
+     * admission (MeshNode §5.1): the operation fails as Unavailable at once. The returned release
+     * is idempotent.
+     */
+    async acquire(meshName, signal) {
+        signal?.throwIfAborted();
+        const record = this.record(meshName);
+        if (record.active >= record.limit) {
+            throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PlacementCapacityExhausted, `MeshNode '${meshName}' has no activation admission headroom.`);
+        }
+        record.active += 1;
+        let released = false;
+        return () => {
+            if (released)
+                return;
+            released = true;
+            record.active -= 1;
+        };
+    }
+    record(meshName) {
+        let record = this.records.get(meshName);
+        if (record === undefined) {
+            record = { limit: this.limitOf(meshName), active: 0 };
+            this.records.set(meshName, record);
+        }
+        return record;
+    }
+}
+exports.ZLinkActivationAdmission = ZLinkActivationAdmission;

package/dist/runtime/actors/actor-authority-payload-codec.d.ts

@@ -1,5 +1,4 @@
-import type { RoutingId } from '../../contracts';
-import { ZLinkSpotKind } from '../../contracts';
+import { type RoutingId, ZLinkSpotKind } from '../../contracts';
 export type ZLinkActorAuthorityState = 'creating' | 'ready';
 export interface ZLinkActorAuthorityPayload {
     readonly state: ZLinkActorAuthorityState;

package/dist/runtime/actors/actor-authority-payload-codec.js

@@ -7,22 +7,33 @@ exports.decodeActorAuthorityPayload = decodeActorAuthorityPayload;
 exports.actorRelocationAuthorityApplicationPayload = actorRelocationAuthorityApplicationPayload;
 exports.relocatingActorAuthorityApplicationPayload = relocatingActorAuthorityApplicationPayload;
 exports.replaceActorRelocationAuthorityApplicationPayload = replaceActorRelocationAuthorityApplicationPayload;
+const stream_wire_1 = require("@zlink-systems/stream-wire");
 const contracts_1 = require("../../contracts");
+const CoreTypes_1 = require("../../contracts/Common/CoreTypes");
+const InternalDefaults_1 = require("../../contracts/Configuration/InternalDefaults");
 const service_relocation_runtime_1 = require("../foundation/service-relocation-runtime");
+const service_wire_binary_primitives_1 = require("../foundation/service-wire-binary-primitives");
 const routing_id_1 = require("../routing-id");
 const AUTHORITY_MAGIC = Buffer.from([0x5a, 0x4c, 0x41, 0x55]);
 const AUTHORITY_VERSION = 1;
 const AUTHORITY_FLAGS = 0;
 const ACTOR_RELOCATION_MAGIC = Buffer.from([0x5a, 0x4c, 0x41, 0x50]);
-const MAXIMUM_BYTES = 1024 * 1024;
+const AUTHORITY_MINIMUM_BYTES = 15;
+const ACTOR_RELOCATION_MINIMUM_BYTES = 32;
+const ACTOR_RELOCATION_VERSION_WITHOUT_SESSION_FENCE = 5;
+const ACTOR_RELOCATION_VERSION_WITH_SESSION_FENCE = 6;
+const ACTOR_RELOCATION_FIRST_PHASE = 1;
+const ACTOR_RELOCATION_STEADY_PHASE = 4;
+const ENTRY_SPOT_WIRE_KIND = (0, contracts_1.zlinkSpotKindToWire)(contracts_1.ZLinkSpotKind.Entry);
+const USER_SPOT_WIRE_KIND = (0, contracts_1.zlinkSpotKindToWire)(contracts_1.ZLinkSpotKind.User);
 const FATAL_UTF8 = new TextDecoder('utf-8', { fatal: true });
 /** Encodes the durable authority-payload-v1 envelope around one schema body. */
 function encodeCanonicalAuthorityPayload(value) {
     const body = Buffer.from(value.body);
     const envelope = concat(AUTHORITY_MAGIC, Buffer.of(AUTHORITY_VERSION), u16be(AUTHORITY_FLAGS), u32be(body.byteLength), body);
     const encoded = concat(envelope, u32be((0, service_relocation_runtime_1.crc32c)(envelope)));
-    if (encoded.byteLength > MAXIMUM_BYTES) {
-        throw new RangeError('Actor authority payload exceeds 1 MiB.');
+    if (encoded.byteLength > InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES) {
+        throw new RangeError(`Actor authority payload exceeds ${InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES / (1024 * 1024)} MiB.`);
     }
     return encoded;
 }
@@ -30,7 +41,8 @@ function encodeCanonicalAuthorityPayload(value) {
 function decodeCanonicalAuthorityPayload(payload) {
     try {
         const reader = new BigEndianReader(payload);
-        if (reader.bytes.byteLength < 15 || reader.bytes.byteLength > MAXIMUM_BYTES) {
+        if (reader.bytes.byteLength < AUTHORITY_MINIMUM_BYTES ||
+            reader.bytes.byteLength > InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES) {
             return undefined;
         }
         reader.expect(AUTHORITY_MAGIC);
@@ -52,7 +64,7 @@ function decodeCanonicalAuthorityPayload(payload) {
 /** Byte-exact Node counterpart of .NET ZLinkActorAuthorityPayloadCodec.Encode. */
 function encodeActorAuthorityPayload(value) {
     const spotKind = (0, contracts_1.zlinkSpotKindToWire)(value.currentSpotKind);
-    if (spotKind !== 1 && spotKind !== 2) {
+    if (spotKind !== ENTRY_SPOT_WIRE_KIND && spotKind !== USER_SPOT_WIRE_KIND) {
         throw new RangeError('Actor currentSpotKind must be Entry or User.');
     }
     const actor = concat(text8(value.stableType, 'stableType'), text8(value.actorId, 'actorId'), Buffer.of(value.state === 'creating' ? 0 : 1), text8(value.currentSpotId, 'currentSpotId'), nonzeroU64be(value.currentSpotGeneration, 'currentSpotGeneration'), Buffer.of(spotKind));
@@ -117,7 +129,7 @@ function actorRelocationAuthorityApplicationPayload(payload) {
     const current = decodeActorRelocationEnvelope(payload);
     return current === undefined
         ? Buffer.from(payload)
-        : current.phase === 4
+        : current.phase === ACTOR_RELOCATION_STEADY_PHASE
             ? Buffer.from(current.applicationPayload)
             : undefined;
 }
@@ -132,15 +144,16 @@ function replaceActorRelocationAuthorityApplicationPayload(payload, applicationP
         return Buffer.from(applicationPayload);
     const withoutChecksum = concat(current.prefix, i32le(applicationPayload.byteLength), applicationPayload);
     const encoded = concat(withoutChecksum, u32le((0, service_relocation_runtime_1.crc32c)(withoutChecksum)));
-    if (encoded.byteLength > MAXIMUM_BYTES) {
-        throw new RangeError('Actor relocation authority payload exceeds 1 MiB.');
+    if (encoded.byteLength > InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES) {
+        throw new RangeError(`Actor relocation authority payload exceeds ${InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES / (1024 * 1024)} MiB.`);
     }
     return encoded;
 }
 function decodeActorRelocationEnvelope(payload) {
     try {
         const bytes = Buffer.from(payload);
-        if (bytes.byteLength < 32 || bytes.byteLength > MAXIMUM_BYTES)
+        if (bytes.byteLength < ACTOR_RELOCATION_MINIMUM_BYTES ||
+            bytes.byteLength > InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES)
             return undefined;
         const checksumOffset = bytes.byteLength - 4;
         if (bytes.readUInt32LE(checksumOffset) !== (0, service_relocation_runtime_1.crc32c)(bytes.subarray(0, checksumOffset))) {
@@ -149,12 +162,13 @@ function decodeActorRelocationEnvelope(payload) {
         const reader = new LittleEndianReader(bytes.subarray(0, checksumOffset));
         reader.expect(ACTOR_RELOCATION_MAGIC);
         const version = reader.u16();
-        if (version !== 5 && version !== 6)
+        if (version !== ACTOR_RELOCATION_VERSION_WITHOUT_SESSION_FENCE &&
+            version !== ACTOR_RELOCATION_VERSION_WITH_SESSION_FENCE)
             return undefined;
         if (reader.take(16).every((byte) => byte === 0))
             return undefined;
         const phase = reader.u8();
-        if (phase < 1 || phase > 4)
+        if (phase < ACTOR_RELOCATION_FIRST_PHASE || phase > ACTOR_RELOCATION_STEADY_PHASE)
             return undefined;
         const isBound = reader.bool();
         if (isBound) {
@@ -169,7 +183,7 @@ function decodeActorRelocationEnvelope(payload) {
             const ownerLeaseGeneration = reader.u64();
             const sessionOwnerNodeGeneration = reader.u64();
             reader.u64();
-            if (version === 6) {
+            if (version === ACTOR_RELOCATION_VERSION_WITH_SESSION_FENCE) {
                 reader.text16();
                 reader.u64();
             }
@@ -184,7 +198,7 @@ function decodeActorRelocationEnvelope(payload) {
         }
         const prefix = Buffer.from(reader.bytes.subarray(0, reader.offset));
         const applicationLength = reader.i32();
-        if (applicationLength < 1 || applicationLength > MAXIMUM_BYTES)
+        if (applicationLength < 1 || applicationLength > InternalDefaults_1.AUTHORITY_ENVELOPE_MAX_BYTES)
             return undefined;
         const applicationPayload = Buffer.from(reader.take(applicationLength));
         if (!reader.done)
@@ -197,20 +211,22 @@ function decodeActorRelocationEnvelope(payload) {
 }
 function text8(value, name) {
     const bytes = Buffer.from(value, 'utf8');
-    if (bytes.byteLength < 1 || bytes.byteLength > 0xff || bytes.includes(0)) {
-        throw new RangeError(`${name} must contain 1..255 UTF-8 bytes without NUL.`);
+    if (bytes.byteLength < 1 ||
+        bytes.byteLength > service_wire_binary_primitives_1.SERVICE_WIRE_TEXT8_MAX_BYTES ||
+        bytes.includes(0)) {
+        throw new RangeError(`${name} must contain 1..${service_wire_binary_primitives_1.SERVICE_WIRE_TEXT8_MAX_BYTES} UTF-8 bytes without NUL.`);
     }
     return concat(Buffer.of(bytes.byteLength), bytes);
 }
 function rid(value, name) {
     const bytes = Buffer.from((0, routing_id_1.encodeRoutingIdStorageHex)(value), 'hex');
-    if (bytes.byteLength < 1 || bytes.byteLength > 0xff) {
-        throw new RangeError(`${name} must contain 1..255 bytes.`);
+    if (bytes.byteLength < 1 || bytes.byteLength > CoreTypes_1.ZLINK_MAX_ROUTING_ID_BYTES) {
+        throw new RangeError(`${name} must contain 1..${CoreTypes_1.ZLINK_MAX_ROUTING_ID_BYTES} bytes.`);
     }
     return concat(Buffer.of(bytes.byteLength), bytes);
 }
 function nonzeroU64be(value, name) {
-    if (value === 0n || value < 0n || value > 0xffffffffffffffffn) {
+    if (value === 0n || value < 0n || value > stream_wire_1.UINT64_MAX) {
         throw new RangeError(`${name} must be a non-zero u64.`);
     }
     const result = Buffer.alloc(8);

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

@@ -1,6 +1,6 @@
-import type { ActorRef, ZLinkActorClient, ZLinkActorRequestCall, ZLinkActorSendCall, ZLinkMessageSerializer } from '../../contracts';
+import { type ActorRef, type ZLinkActorClient, type ZLinkActorRequestCall, type ZLinkActorSendCall, type ZLinkMessageSerializer } from '../../contracts';
 import type { Message } from '../../contracts/Common/Message';
-import type { ZLinkBackendMeshNode, ZLinkMeshCompletionTable } from '../backend';
+import { type ZLinkBackendMeshNode, type ZLinkMeshCompletionTable } from '../backend';
 import type { ZLinkStoreLocationResolvers } from '../locations';
 import type { ZLinkActorRoutedJoinTransport } from './actor-routed-join-transport';
 export interface ZLinkActorClientOptions {