@zlink-systems/framework 0.25.0 → 0.27.0

package/dist/runtime/messaging/payload-codec.js

@@ -9,6 +9,7 @@ exports.wrapFrameworkPayloadMessage = wrapFrameworkPayloadMessage;
 exports.selectDefaultSerializer = selectDefaultSerializer;
 exports.selectSerializer = selectSerializer;
 exports.selectSerializerWithContentType = selectSerializerWithContentType;
+const stream_wire_1 = require("@zlink-systems/stream-wire");
 const framework_errors_internal_1 = require("../framework-errors-internal");
 const runtime_message_1 = require("../backend/runtime-message");
 const contracts_1 = require("../../contracts");
@@ -20,8 +21,11 @@ const Attributes_1 = require("../../contracts/Handlers/Attributes");
 const packet_name_1 = require("./packet-name");
 const CodecContentType_1 = require("../../contracts/Configuration/CodecContentType");
 const CodecSerializerSelection_1 = require("../../contracts/Configuration/CodecSerializerSelection");
+const MAX_DECLARED_TYPE_SELECTIONS = 1024;
 const noSerializer = Symbol('noSerializer');
-const JSON_CONTENT_TYPE = 'application/json';
+const JSON_CONTENT_TYPE = stream_wire_1.ZlinkStreamContentType.Json;
+const frameworkJsonReceiveCodec = Symbol('frameworkJsonReceiveCodec');
+const defaultReceiveCodecs = new Map([[JSON_CONTENT_TYPE, frameworkJsonReceiveCodec]]);
 // Registration maps are created during host configuration and are immutable
 // for the runtime lifetime. Compile the candidate list and reverse content
 // type lookup once per map so the message path does not allocate arrays or
@@ -36,8 +40,8 @@ function encodeFrameworkPayload(payload, registry, packetName, contractPart = 'p
     if ((0, contracts_1.isZLinkMessage)(payload)) {
         if (payload.isEncoded()) {
             return {
-                message: rememberContentType(toRuntimeMessage(payload.toEncodedPayload()), 'application/octet-stream'),
-                contentType: 'application/octet-stream'
+                message: rememberContentType(toRuntimeMessage(payload.toEncodedPayload()), stream_wire_1.ZlinkStreamContentType.Raw),
+                contentType: stream_wire_1.ZlinkStreamContentType.Raw
             };
         }
         declaredType = (0, ZLinkMessage_1.readZLinkMessageDeclaredType)(payload);
@@ -72,16 +76,11 @@ function decodeFrameworkTypedPayloadMessage(message, registry, type, contentType
     return decodeFrameworkPayload(message, registry, type, contentType, packetName, contractPart);
 }
 function decodeFrameworkPayload(message, registry, type, contentType, packetName, contractPart) {
-    if (!(0, CodecContentType_1.isCanonicalCodecContentType)(contentType)) {
-        throw unsupportedContentType(contentType);
-    }
-    if (contentType !== JSON_CONTENT_TYPE) {
-        const serializer = serializerMapOf(registry)?.get(contentType);
-        if (serializer === undefined)
-            throw unsupportedContentType(contentType);
+    const codec = receiveCodecFor(contentType, registry);
+    if (codec !== frameworkJsonReceiveCodec) {
         if (message.isEmpty())
             return undefined;
-        return serializer.deserialize(encodedPayloadFromOwned(message.data()), (type ?? Object));
+        return codec.deserialize(encodedPayloadFromOwned(message.data()), (type ?? Object));
     }
     if (message.isEmpty())
         return undefined;
@@ -96,16 +95,11 @@ function wrapFrameworkPayloadMessage(message, registry, contentType = JSON_CONTE
     return (0, ZLinkMessage_1.createZLinkMessageFromEncoded)(payload, (type) => decodeFrameworkEncodedPayload(payload, registry, type, contentType, packetName, contractPart));
 }
 function decodeFrameworkEncodedPayload(payload, registry, type, contentType, packetName, contractPart) {
-    if (!(0, CodecContentType_1.isCanonicalCodecContentType)(contentType)) {
-        throw unsupportedContentType(contentType);
-    }
-    if (contentType !== JSON_CONTENT_TYPE) {
-        const serializer = serializerMapOf(registry)?.get(contentType);
-        if (serializer === undefined)
-            throw unsupportedContentType(contentType);
+    const codec = receiveCodecFor(contentType, registry);
+    if (codec !== frameworkJsonReceiveCodec) {
         if (payload.isEmpty())
             return undefined;
-        return serializer.deserialize(payload, (type ?? Object));
+        return codec.deserialize(payload, (type ?? Object));
     }
     if (payload.isEmpty())
         return undefined;
@@ -117,6 +111,18 @@ function decodeFrameworkEncodedPayload(payload, registry, type, contentType, pac
         throw (0, framework_errors_internal_1.createInternalFrameworkException)(framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.PayloadDecodeFailed, 'PayloadDecodeFailed: framework payload is not valid JSON.', false, error);
     }
 }
+function receiveCodecFor(contentType, registry) {
+    if (!(0, CodecContentType_1.isCanonicalCodecContentType)(contentType)) {
+        throw unsupportedContentType(contentType);
+    }
+    const registeredCodec = serializerMapOf(registry)?.get(contentType);
+    if (registeredCodec !== undefined)
+        return registeredCodec;
+    const defaultCodec = defaultReceiveCodecs.get(contentType);
+    if (defaultCodec !== undefined)
+        return defaultCodec;
+    throw unsupportedContentType(contentType);
+}
 function schemaForDecode(type, packetName, contractPart) {
     const contract = type === undefined ? undefined : (0, packet_name_1.readFrameworkPacketJsonContract)(type, packetName);
     return (contract ??
@@ -167,7 +173,7 @@ function serializerSelectionPlanOf(registry) {
                 return cached === noSerializer ? undefined : cached;
             }
             const selected = selectSerializerFromEntries(frozenEntries, declaredType);
-            if (cachedBusinessTypeCount < 1024) {
+            if (cachedBusinessTypeCount < MAX_DECLARED_TYPE_SELECTIONS) {
                 outboundByBusinessType.set(declaredType, selected ?? noSerializer);
                 cachedBusinessTypeCount += 1;
             }

package/dist/runtime/messaging/submission-result.d.ts

@@ -10,6 +10,9 @@ export declare enum ZLinkSubmitStatus {
 export interface ZLinkSubmitResult {
     readonly status: ZLinkSubmitStatus;
 }
+/** Projects the Core submit result once; phase only determines capacity refusal meaning. */
+export declare function submitToRequestResult(result: number, phase: 'submit' | 'completion'): number;
+export declare function classifySubmitResult(result: number, operation: string, phase?: 'submit' | 'completion'): ZLinkSubmitResult;
 export declare function requireOneWayCompletion(result: ZLinkSubmitResult, operation: string, notFoundKind?: ZLinkFrameworkInternalErrorKind): void;
 export declare function requirePublishCompletion(result: ZLinkSubmitResult, operation: string): void;
 export declare function throwAlreadySubmitted(operation: string): never;

package/dist/runtime/messaging/submission-result.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ZLinkSubmitStatus = void 0;
+exports.submitToRequestResult = submitToRequestResult;
+exports.classifySubmitResult = classifySubmitResult;
 exports.requireOneWayCompletion = requireOneWayCompletion;
 exports.requirePublishCompletion = requirePublishCompletion;
 exports.throwAlreadySubmitted = throwAlreadySubmitted;
 const framework_errors_internal_1 = require("../framework-errors-internal");
+const contracts_1 = require("../../contracts");
+const runtime_values_1 = require("../backend/runtime-values");
 var ZLinkSubmitStatus;
 (function (ZLinkSubmitStatus) {
     ZLinkSubmitStatus["Submitted"] = "submitted";
@@ -14,6 +18,50 @@ var ZLinkSubmitStatus;
     ZLinkSubmitStatus["RouteNotConnected"] = "routeNotConnected";
     ZLinkSubmitStatus["Shutdown"] = "shutdown";
 })(ZLinkSubmitStatus || (exports.ZLinkSubmitStatus = ZLinkSubmitStatus = {}));
+/** Projects the Core submit result once; phase only determines capacity refusal meaning. */
+function submitToRequestResult(result, phase) {
+    switch (result) {
+        case runtime_values_1.SubmitResult.Ok:
+            return runtime_values_1.RequestResult.Ok;
+        case runtime_values_1.SubmitResult.Backpressured:
+            return phase === 'submit' ? runtime_values_1.RequestResult.NotConnected : runtime_values_1.RequestResult.TimedOut;
+        case runtime_values_1.SubmitResult.NotConnected:
+            return runtime_values_1.RequestResult.NotConnected;
+        case runtime_values_1.SubmitResult.NotFound:
+            return runtime_values_1.RequestResult.NotFound;
+        case runtime_values_1.SubmitResult.NotAdmitted:
+            return runtime_values_1.RequestResult.Rejected;
+        case runtime_values_1.SubmitResult.InvalidHandle:
+        case runtime_values_1.SubmitResult.InvalidArgument:
+        case runtime_values_1.SubmitResult.ThreadViolation:
+            return runtime_values_1.RequestResult.InvalidArgument;
+        case runtime_values_1.SubmitResult.InvalidState:
+            return runtime_values_1.RequestResult.InvalidState;
+        case runtime_values_1.SubmitResult.NotSupported:
+            return runtime_values_1.RequestResult.NotSupported;
+        case runtime_values_1.SubmitResult.Terminated:
+            return runtime_values_1.RequestResult.Terminated;
+        default:
+            return runtime_values_1.RequestResult.InternalError;
+    }
+}
+function classifySubmitResult(result, operation, phase = 'completion') {
+    const terminal = submitToRequestResult(result, phase);
+    switch (terminal) {
+        case runtime_values_1.RequestResult.Ok:
+            return { status: ZLinkSubmitStatus.Submitted };
+        case runtime_values_1.RequestResult.TimedOut:
+            return { status: ZLinkSubmitStatus.TimedOut };
+        case runtime_values_1.RequestResult.NotFound:
+            return { status: ZLinkSubmitStatus.TargetNotFound };
+        case runtime_values_1.RequestResult.NotConnected:
+            return { status: ZLinkSubmitStatus.RouteNotConnected };
+        case runtime_values_1.RequestResult.Terminated:
+            return { status: ZLinkSubmitStatus.Shutdown };
+        default:
+            throw new contracts_1.ZLinkFrameworkException((0, framework_errors_internal_1.requestResultToPublicErrorKind)(terminal), `${operation} failed with submit result ${result}.`);
+    }
+}
 function requireOneWayCompletion(result, operation, notFoundKind = framework_errors_internal_1.ZLinkFrameworkInternalErrorKind.RequestTargetNotFound) {
     switch (result.status) {
         case ZLinkSubmitStatus.Submitted:

package/dist/runtime/protocol/service_wire_codec.generated.d.ts

@@ -343,6 +343,7 @@ export type SessionRelocationRouteUpdate = {
     readonly targetAuthorityOwnerGeneration: NonzeroU64;
     readonly targetNodeRid: Rid;
     readonly targetNodeGeneration: NonzeroU64;
+    readonly targetOwnerLeaseGeneration: NonzeroU64;
 } | {
     readonly action: "abort";
     readonly currentAuthorityOwnerGeneration: NonzeroU64;
@@ -1003,6 +1004,7 @@ export type InstanceRouteV1 = {
     readonly targetNodeGeneration: NonzeroU64;
     readonly targetSpotId: Text8;
     readonly authority: AuthorityGenerationFence;
+    readonly instanceIntent: Bool8;
 } | {
     readonly routeKind: "coldActivation";
     readonly targetNodeRid: Rid;

package/dist/runtime/protocol/service_wire_codec.generated.js

@@ -3701,6 +3701,7 @@ function readSessionRelocationRouteUpdate(reader, context, enclosing, flags) {
         value["targetAuthorityOwnerGeneration"] = readNonzeroU64(body, context, value, flags);
         value["targetNodeRid"] = readRid(body, context, value, flags);
         value["targetNodeGeneration"] = readNonzeroU64(body, context, value, flags);
+        value["targetOwnerLeaseGeneration"] = readNonzeroU64(body, context, value, flags);
     }
     else if (same(value["action"], "abort")) {
         value["currentAuthorityOwnerGeneration"] = readNonzeroU64(body, context, value, flags);
@@ -3732,9 +3733,12 @@ function writeSessionRelocationRouteUpdate(input, writer, context, enclosing, fl
         if (value["targetNodeGeneration"] === undefined)
             fail("targetNodeGeneration required");
         writeNonzeroU64(numeric(value["targetNodeGeneration"]), body, context, value, flags);
+        if (value["targetOwnerLeaseGeneration"] === undefined)
+            fail("targetOwnerLeaseGeneration required");
+        writeNonzeroU64(numeric(value["targetOwnerLeaseGeneration"]), body, context, value, flags);
     }
     else if (same(value["action"], "abort")) {
-        if (value["previousAuthorityOwnerGeneration"] !== undefined || value["targetAuthorityOwnerGeneration"] !== undefined || value["targetNodeRid"] !== undefined || value["targetNodeGeneration"] !== undefined)
+        if (value["previousAuthorityOwnerGeneration"] !== undefined || value["targetAuthorityOwnerGeneration"] !== undefined || value["targetNodeRid"] !== undefined || value["targetNodeGeneration"] !== undefined || value["targetOwnerLeaseGeneration"] !== undefined)
             fail("session-relocation-route-update discriminator agreement");
         if (value["currentAuthorityOwnerGeneration"] === undefined)
             fail("currentAuthorityOwnerGeneration required");
@@ -5397,7 +5401,7 @@ function readChannelEntry(reader, context, enclosing, flags) {
     const value = {};
     value["channelName"] = readText8(reader, context, value, flags);
     value["weight"] = readU32(reader, context, value, flags);
-    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n)
+    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n)
         fail("weight constraint");
     return value;
 }
@@ -5411,7 +5415,7 @@ function writeChannelEntry(input, writer, context, enclosing, flags) {
     writeText8(value["channelName"], writer, context, value, flags);
     if (value["weight"] === undefined)
         fail("weight required");
-    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n)
+    if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n)
         fail("weight constraint");
     writeU32(value["weight"], writer, context, value, flags);
 }
@@ -5665,7 +5669,7 @@ function readDescriptorExtension(reader, context, enclosing, flags) {
                     if (value["placementWeight"] !== undefined)
                         fail("descriptor-extension duplicate");
                     value["placementWeight"] = readU32(item, context, value, flags);
-                    if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 100n)
+                    if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 10000n)
                         fail("placementWeight constraint");
                     item.done("placementWeight");
                     break;
@@ -5774,7 +5778,7 @@ function writeDescriptorExtension(input, writer, context, enclosing, flags) {
         body.put(itemBytes);
     }
     if (value["placementWeight"] !== undefined) {
-        if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 100n)
+        if (numeric(value["placementWeight"]) < 0n || numeric(value["placementWeight"]) > 10000n)
             fail("placementWeight constraint");
         const item = new Writer();
         writeU32(value["placementWeight"], item, context, value, flags);
@@ -5890,7 +5894,7 @@ function readClientServerAdmission(reader, context, enclosing, flags) {
         value["lifecycleGeneration"] = readNonzeroU64(body, context, value, flags);
         value["descriptorRevision"] = readNonzeroU64(body, context, value, flags);
         value["weight"] = readU32(body, context, value, flags);
-        if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n)
+        if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n)
             fail("weight constraint");
         value["runtimeState"] = readRuntimeState(body, context, value, flags);
         value["securityIdentity"] = readText8(body, context, value, flags);
@@ -5947,7 +5951,7 @@ function writeClientServerAdmission(input, writer, context, enclosing, flags) {
         writeNonzeroU64(numeric(value["descriptorRevision"]), body, context, value, flags);
         if (value["weight"] === undefined)
             fail("weight required");
-        if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 100n)
+        if (numeric(value["weight"]) < 0n || numeric(value["weight"]) > 10000n)
             fail("weight constraint");
         writeU32(value["weight"], body, context, value, flags);
         if (value["runtimeState"] === undefined)
@@ -7305,6 +7309,7 @@ function readInstanceRouteV1(reader, context, enclosing, flags) {
         value["targetNodeGeneration"] = readNonzeroU64(body, context, value, flags);
         value["targetSpotId"] = readText8(body, context, value, flags);
         value["authority"] = readAuthorityGenerationFence(body, context, value, flags);
+        value["instanceIntent"] = readBool8(body, context, value, flags);
     }
     else if (same(value["routeKind"], "coldActivation")) {
         value["targetNodeRid"] = readRid(body, context, value, flags);
@@ -7332,6 +7337,7 @@ function* readIncrementalInstanceRouteV1(reader, context, enclosing, flags) {
         value["targetNodeGeneration"] = yield* readIncrementalNonzeroU64(body, context, value, flags);
         value["targetSpotId"] = yield* readIncrementalText8(body, context, value, flags);
         value["authority"] = yield* readIncrementalAuthorityGenerationFence(body, context, value, flags);
+        value["instanceIntent"] = yield* readIncrementalBool8(body, context, value, flags);
     }
     else if (same(value["routeKind"], "coldActivation")) {
         value["targetNodeRid"] = yield* readIncrementalRid(body, context, value, flags);
@@ -7369,9 +7375,12 @@ function writeInstanceRouteV1(input, writer, context, enclosing, flags) {
         if (value["authority"] === undefined)
             fail("authority required");
         writeAuthorityGenerationFence(value["authority"], body, context, value, flags);
+        if (value["instanceIntent"] === undefined)
+            fail("instanceIntent required");
+        writeBool8(value["instanceIntent"], body, context, value, flags);
     }
     else if (same(value["routeKind"], "coldActivation")) {
-        if (value["authority"] !== undefined)
+        if (value["authority"] !== undefined || value["instanceIntent"] !== undefined)
             fail("instance-route-v1 discriminator agreement");
         if (value["targetNodeRid"] === undefined)
             fail("targetNodeRid required");

package/dist/runtime/protocol/service_wire_pilot_codec.generated.d.ts

@@ -200,6 +200,7 @@ export type ServiceWireSessionRouteUpdate = {
     readonly targetAuthorityOwnerGeneration: bigint;
     readonly targetNodeRid: Uint8Array;
     readonly targetNodeGeneration: bigint;
+    readonly targetOwnerLeaseGeneration: bigint;
 } | {
     readonly action: "abort";
     readonly currentAuthorityOwnerGeneration: bigint;

package/dist/runtime/protocol/service_wire_pilot_codec.generated.js

@@ -522,12 +522,13 @@ function b3ValidTerminal(result, failure, payload) { const boundary = [101, 103,
 } if (b3FailureResults.get(failure) !== result)
     throw new RangeError("typed failure"); }
 function b3WriteRoute(out, v) { out.push(v.action === "commit" ? 1 : 2); body16(out, b => { if (v.action === "commit") {
-    if (v.previousAuthorityOwnerGeneration === 0n || v.targetAuthorityOwnerGeneration === 0n || v.targetNodeGeneration === 0n)
+    if (v.previousAuthorityOwnerGeneration === 0n || v.targetAuthorityOwnerGeneration === 0n || v.targetNodeGeneration === 0n || v.targetOwnerLeaseGeneration === 0n)
         throw new RangeError("route commit");
     u64(b, v.previousAuthorityOwnerGeneration);
     u64(b, v.targetAuthorityOwnerGeneration);
     rid(b, v.targetNodeRid);
     u64(b, v.targetNodeGeneration);
+    u64(b, v.targetOwnerLeaseGeneration);
 }
 else {
     if (v.currentAuthorityOwnerGeneration === 0n)
@@ -535,7 +536,7 @@ else {
     u64(b, v.currentAuthorityOwnerGeneration);
 } }); }
 function b3ReadRoute(bytes, at) { const action = read8(bytes, at), end = boundedEnd(bytes, at, read16(bytes, at), "session route"); let value; if (action === 1)
-    value = { action: "commit", previousAuthorityOwnerGeneration: nonzero64(bytes, at, "previous authority"), targetAuthorityOwnerGeneration: nonzero64(bytes, at, "target authority"), targetNodeRid: readRid(bytes, at), targetNodeGeneration: nonzero64(bytes, at, "target node") };
+    value = { action: "commit", previousAuthorityOwnerGeneration: nonzero64(bytes, at, "previous authority"), targetAuthorityOwnerGeneration: nonzero64(bytes, at, "target authority"), targetNodeRid: readRid(bytes, at), targetNodeGeneration: nonzero64(bytes, at, "target node"), targetOwnerLeaseGeneration: nonzero64(bytes, at, "target lease") };
 else if (action === 2)
     value = { action: "abort", currentAuthorityOwnerGeneration: nonzero64(bytes, at, "current authority") };
 else

package/dist/runtime/spots/formal-remote-actor-admission-registry.d.ts

@@ -1,6 +1,6 @@
 import type { ActorRef, RoutingId, ZLinkActor, ZLinkActorJoinOperationId } from '../../contracts';
 import type { ZLinkRemoteBoundSessionTarget } from '../actors/actor-runtime-state';
-import type { ZLinkDeferredJoinAcceptedRoot } from '../actors/deferred-join-accepted-journal';
+import type { ZLinkDeferredJoinCompletion } from '../actors/deferred-join-completion';
 import type { ZLinkActorRequestTerminal } from './spot-actor-packet-dispatch';
 /**
  * One production-ingress arrival parked at the target between admission
@@ -40,7 +40,7 @@ export interface ZLinkFormalRemoteActorAdmissionOutcome {
     readonly actorRef: ActorRef;
     readonly reply?: Buffer;
     readonly replyContentType?: string;
-    readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+    readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
 }
 export interface ZLinkFormalRemoteActorAdmissionFailure {
     readonly error: unknown;
@@ -111,7 +111,7 @@ export declare class ZLinkFormalRemoteActorAdmissionRegistry {
     complete(transferId: string, outcome: ZLinkFormalRemoteActorAdmissionOutcome): void;
     fail(transferId: string, error: unknown): void;
     markCommitted(transferId: string, actor: ZLinkActor): void;
-    attachDeferredJoinRoot(transferId: string, root: ZLinkDeferredJoinAcceptedRoot): void;
+    attachDeferredJoinCompletion(transferId: string, root: ZLinkDeferredJoinCompletion): void;
     abort(transferId: string): void;
     /**
      * Releases the admission for {@code transferId} — normal retention

package/dist/runtime/spots/formal-remote-actor-admission-registry.js

@@ -161,9 +161,9 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
             ...(outcome.replyContentType === undefined
                 ? {}
                 : { replyContentType: outcome.replyContentType }),
-            ...(outcome.deferredJoinRoot === undefined
+            ...(outcome.deferredJoinCompletion === undefined
                 ? {}
-                : { deferredJoinRoot: outcome.deferredJoinRoot })
+                : { deferredJoinCompletion: outcome.deferredJoinCompletion })
         };
         entry.resolveResult(entry.result);
         if (!outcome.accepted) {
@@ -192,7 +192,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
         entry.state = 'committed';
         entry.actor = actor;
     }
-    attachDeferredJoinRoot(transferId, root) {
+    attachDeferredJoinCompletion(transferId, root) {
         const entry = this.admissions.get(transferId);
         if (entry === undefined ||
             entry.state !== 'admitted' ||
@@ -201,7 +201,7 @@ class ZLinkFormalRemoteActorAdmissionRegistry {
             !entry.result.accepted) {
             throw new Error(`Remote actor admission '${transferId}' cannot attach deferred recovery.`);
         }
-        entry.result = { ...entry.result, deferredJoinRoot: root };
+        entry.result = { ...entry.result, deferredJoinCompletion: root };
     }
     abort(transferId) {
         const entry = this.admissions.get(transferId);

package/dist/runtime/spots/formal-remote-actor-transfer-registry.d.ts

@@ -1,12 +1,14 @@
 import type { RoutingId, ZLinkActor } from '../../contracts';
-import type { ZLinkDeferredJoinAcceptedRoot } from '../actors';
+import type { ZLinkDeferredJoinCompletion, ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 export interface ZLinkFormalRemoteActorTransfer {
     readonly actor: ZLinkActor;
     readonly spotId: RoutingId;
     readonly transferId: string;
     readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
-    readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+    readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
+    /** The Session seal this relocation carries until it publishes command 44. */
+    readonly sealedSession?: ZLinkRemoteBoundSessionTarget;
     readonly targetLifecycleCompleted: Promise<void>;
     readonly sourceLeaveSubmitted: Promise<boolean>;
 }
@@ -23,7 +25,8 @@ export declare class ZLinkFormalRemoteActorTransferRegistry {
         readonly spotId: RoutingId;
         readonly transferId: string;
         readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
-        readonly deferredJoinRoot?: ZLinkDeferredJoinAcceptedRoot;
+        readonly deferredJoinCompletion?: ZLinkDeferredJoinCompletion;
+        readonly sealedSession?: ZLinkRemoteBoundSessionTarget;
     }): ZLinkFormalRemoteActorTransfer;
     delete(actorId: string): void;
     completeTargetLifecycle(actorId: string, transferId: string): boolean;

package/dist/runtime/spots/index.d.ts

@@ -8,13 +8,13 @@ export { ZLinkSpotActorAdmissionCoordinator } from './spot-actor-admission-coord
 import type { ZLinkSpotRouteResolver, ZLinkSpotRouteTarget } from './spot-routing-internal';
 import type { Message } from '../../contracts/Common/Message';
 import type { ZLinkMessageFollowOrigin } from '../foundation/service-runtime-contracts';
-import { ZLinkMessage } from '../../contracts';
+import { ZLinkMessage, ZLinkFrameworkRuntimeState } from '../../contracts';
 import { type ZLinkRuntimeEventPublisher } from '../diagnostics';
 import { type ReadyRecord, type ReceiveRecord } from '../foundation/service-runtime-contracts';
 import type { ZLinkBackendSpot, ZLinkBackendSpotNode } from '../backend/contracts';
 import { ZLinkDispatchErrorReporter } from '../channels';
 import { ZLinkWorkerRuntime } from '../workers';
-import { type ZLinkDeferredJoinAcceptedRoot, type ZLinkRemoteBoundSessionTarget } from '../actors';
+import { type ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkLocationLifecycle } from '../locations';
 import { type ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 import type { CanonicalActorJoinRecovery } from '../foundation/actor-join-recovery-codec';
@@ -25,11 +25,11 @@ export { DefaultZLinkSpotOutbound, type ZLinkSpotAddressCallOptions, type ZLinkS
 import { type ZLinkSpotRoutedTransport } from './spot-outbound';
 export { DefaultZLinkSpotHandlerRegistry, type ZLinkSpotHandlerRegistration } from './spot-handler-registry';
 export { ZLinkRuntimeSpotPublisherTransport } from './spot-publisher-transport';
-import { type ZLinkSpotActivation } from './spot-activation-state';
+import type { ZLinkSpotActivation } from './spot-activation-state';
 import { type ZLinkNativeSpotAuthority } from './spot-activation';
-import { type ZLinkActorJoinRollback } from './spot-actor-membership';
 import type { ZLinkSpotActorHandoffRuntime, ZLinkSpotActorTransferRuntime, ZLinkSpotBoundSessionRuntime } from './spot-runtime-ports';
 import type { ZLinkRuntimeAdmissionGate } from '../admission';
+import type { ZLinkActivationAdmission } from '../activation-admission';
 import type { ZLinkDetachedTaskRunner } from './spot-actor-join-dispatch';
 import type { ZLinkLocalSpotCreateResult } from './spot-manager-internal-contracts';
 export type { ZLinkLocalSpotCreateResult } from './spot-manager-internal-contracts';
@@ -61,6 +61,7 @@ export interface ZLinkSpotManagerOptions {
      * stateful reply has committed Core membership.
      */
     readonly dispatchEntryActorJoin?: (meshName: string, actor: ZLinkActor, handoffBacklog?: readonly ZLinkActorHandoffPacket[]) => Promise<void>;
+    readonly executeEntryActor?: <T>(meshName: string, actorId: string, operation: () => Promise<T>) => Promise<T>;
     readonly actorCountProvider?: (spotId: RoutingId) => number;
     readonly userSpotExecutionMode?: (meshName: string, spotType: Type<ZLinkSpot>) => import('../../contracts').ZLinkUserSpotExecutionMode;
     readonly userSpotRelocationCoordinationMode?: (meshName: string, spotType: Type<ZLinkSpot>) => import('../../contracts').ZLinkSpotRelocationCoordinationMode;
@@ -68,7 +69,6 @@ export interface ZLinkSpotManagerOptions {
         readonly actorRef?: ActorRef;
         readonly spotId?: RoutingId;
     };
-    readonly actorBindingGenerationObserver?: (actorId: string, generation: bigint) => void;
     readonly channelClient?: ZLinkChannelClient;
     readonly fanoutClient?: ZLinkFanoutClient;
     readonly spotPublisherClient?: ZLinkSpotPublisherClient;
@@ -76,27 +76,24 @@ export interface ZLinkSpotManagerOptions {
     readonly routedTransport?: ZLinkSpotRoutedTransport;
     readonly addressTransport?: import('./spot-outbound').ZLinkSpotAddressTransport;
     readonly spotRouterChannelIdForMesh?: (meshName: string) => string;
-    readonly channelMeshNameForChannel?: (channelName: string) => string | undefined;
     readonly providerResolver?: ZLinkProviderResolver;
     readonly dispatchErrors?: ZLinkDispatchErrorReporter;
+    readonly closeErrorSink?: import('../diagnostics/dispatch-error-port').ZLinkDispatchErrorSink;
     readonly runtimeEventPublisher?: ZLinkRuntimeEventPublisher;
     readonly workerRuntime?: ZLinkWorkerRuntime;
     readonly messageSerializers?: ReadonlyMap<string, ZLinkMessageSerializer>;
     readonly locationLifecycle?: ZLinkLocationLifecycle;
     readonly releaseInstanceAuthority?: (meshName: string, spotId: RoutingId, objectGeneration: bigint) => Promise<void>;
-    readonly beginInstanceIdleClosingAuthority?: (meshName: string, spotId: RoutingId) => Promise<{
-        restoreReady(): Promise<void>;
-    } | undefined>;
-    readonly beginInstanceClosingAuthority?: (meshName: string, spotId: RoutingId) => Promise<{
-        restoreReady(): Promise<void>;
-    } | undefined>;
+    readonly beginInstanceIdleClosingAuthority?: (meshName: string, spotId: RoutingId, onCommitted: () => void) => Promise<import('../locations/spot-location-claims').ZLinkInstanceClosingAuthority | undefined>;
+    readonly beginInstanceClosingAuthority?: (meshName: string, spotId: RoutingId, onCommitted: () => void, objectGeneration: bigint) => Promise<import('../locations/spot-location-claims').ZLinkInstanceClosingAuthority | undefined>;
+    /** Moves a local User Spot incarnation's authority to Closing for a context Close. */
+    readonly beginUserClosingAuthority?: (meshName: string, spotId: RoutingId, objectGeneration: bigint, onCommitted: () => void) => Promise<import('../locations/spot-location-claims').ZLinkInstanceClosingAuthority | undefined>;
     readonly instanceSpotApplicationTargetProvider?: (meshName: string, spotId: RoutingId) => {
         readonly stableType: string;
         readonly objectGeneration: bigint;
     } | undefined;
     readonly instanceSpotApplicationQuiescenceProvider?: (meshName: string, spotId: RoutingId, signal?: AbortSignal) => Promise<void>;
     readonly createNativeSpot?: (meshName: string, spotId: RoutingId, authority?: ZLinkNativeSpotAuthority) => ZLinkBackendSpot | undefined;
-    readonly createReceived?: () => import('../backend').ZLinkBackendReceived;
     readonly createTopicMessage?: () => import('../backend').ZLinkBackendTopicMessage;
     readonly nativeSpotNodeProvider?: (meshName: string) => ZLinkBackendSpotNode | undefined;
     readonly actorResolver?: (actorId: string) => ZLinkActor | undefined;
@@ -111,15 +108,17 @@ export interface ZLinkSpotManagerOptions {
         readonly actorType: string;
     }>;
     readonly actorLifecycleResolver?: (actorId: string) => ZLinkActor | undefined;
-    readonly detachedTaskRunner?: ZLinkDetachedTaskRunner;
+    readonly detachedTaskRunner: ZLinkDetachedTaskRunner;
     readonly actorTransferRuntime?: ZLinkSpotActorTransferRuntime;
     readonly boundSessionRuntime?: ZLinkSpotBoundSessionRuntime;
     readonly actorHandoffRuntime?: ZLinkSpotActorHandoffRuntime;
     readonly metrics?: import('../diagnostics').ZLinkRuntimeMetrics;
     readonly admission?: ZLinkRuntimeAdmissionGate;
-    readonly statefulExecutionAllowed?: () => boolean;
-    readonly activationConcurrencyLimitProvider?: (meshName: string) => number;
-    readonly onInstanceActivationConcurrencyChanged?: (meshName: string) => void;
+    readonly statefulExecution?: {
+        readonly admissionOpen: () => boolean;
+        readonly hostState: () => ZLinkFrameworkRuntimeState;
+    };
+    readonly activationAdmission?: ZLinkActivationAdmission;
 }
 export declare class DefaultZLinkSpotManager {
     private readonly options;
@@ -134,8 +133,7 @@ export declare class DefaultZLinkSpotManager {
     private readonly formalRemoteActorAdmissions;
     private readonly pendingInstanceMaterializations;
     private readonly pendingInstanceMaterializationsByPrefix;
-    private readonly instanceActivationGates;
-    private readonly pendingInstanceCloses;
+    private readonly closeOperations;
     private readonly pendingInstanceTerminals;
     private readonly pendingInstanceTerminalGenerations;
     private readonly deferredInstanceAuthorityReleases;
@@ -145,10 +143,6 @@ export declare class DefaultZLinkSpotManager {
     entrySpotIdForMesh(meshName: string): string | undefined;
     relocationActivations(meshName: string): readonly ZLinkSpotActivation[];
     activeSpotCount(meshName: string): number;
-    instanceActivationConcurrency(meshName: string): {
-        readonly active: number;
-        readonly limit: number;
-    };
     resolveRelocationActivation(meshName: string, spotId: RoutingId): ZLinkSpotActivation | undefined;
     prepareRelocationSpot(meshName: string, objectKind: 'user_spot' | 'instance_spot', stableType: string, implementation: Type<ZLinkSpot | ZLinkInstanceSpot>, spotId: RoutingId, objectGeneration: bigint, authorityOwnerGeneration: bigint, signal?: AbortSignal): Promise<ZLinkSpotActivation>;
     publishRelocationSpot(activation: ZLinkSpotActivation, beforeAdmission?: () => Promise<void>): Promise<void>;
@@ -156,11 +150,11 @@ export declare class DefaultZLinkSpotManager {
     completeRelocationSource(activation: ZLinkSpotActivation): Promise<void>;
     materializeInstance(meshName: string, instanceType: string, spotId: RoutingId, objectGeneration: bigint, signal?: AbortSignal): Promise<void>;
     private materializeInstanceCore;
-    private acquireInstanceActivation;
-    private releaseInstanceActivation;
     isInstanceMaterialized(meshName: string, instanceType: string, spotId: RoutingId): boolean;
+    private resolveApplicationActivation;
     isInstanceMaterializing(meshName: string, spotId: RoutingId): boolean;
-    isInstanceClosing(meshName: string, spotId: RoutingId): boolean;
+    isSpotClosing(meshName: string, spotId: RoutingId): boolean;
+    pendingSpotCloseDecision(meshName: string, spotId: RoutingId): Promise<void> | undefined;
     discardInstance(meshName: string, spotId: RoutingId): Promise<void>;
     isInstanceSpotIdleEvicting(meshName: string, spotId: RoutingId): boolean;
     beginInstanceSpotIdleEviction(meshName: string, spotId: RoutingId): boolean;
@@ -185,15 +179,18 @@ export declare class DefaultZLinkSpotManager {
     list(meshName: string): Promise<readonly ZLinkSpotInfo[]>;
     drainForShutdown(meshName: string, signal?: AbortSignal, deadline?: Date): Promise<void>;
     close(meshName: string, spotId: RoutingId, signal?: AbortSignal): Promise<boolean>;
+    closeUserWithAuthority(meshName: string, spotId: RoutingId, beginAuthority: (onCommitted: () => void) => Promise<import('../locations/spot-location-claims').ZLinkInstanceClosingAuthority>, signal?: AbortSignal): Promise<boolean>;
+    private closeFromContext;
     private closeWithReason;
+    private runCloseOperation;
+    private beginCloseAuthority;
     executeOnSpot<TSpot extends ZLinkSpot, TResult>(spotType: Type<TSpot>, spotId: RoutingId, operation: (spot: TSpot) => Promise<TResult> | TResult, signal?: AbortSignal): Promise<TResult>;
     hasActiveSpot(spotId: RoutingId): boolean;
-    canCloseUserSpot(meshName: string, spotId: RoutingId): boolean;
     beginUserSpotPublication(meshName: string, spotId: RoutingId): void;
     publishUserSpot(meshName: string, spotId: RoutingId): void;
     abortUserSpotPublication(meshName: string, spotId: RoutingId): void;
     resolveLocalSpotRoute(spotId: RoutingId): ZLinkSpotRouteTarget | undefined;
-    admitActorJoin(spotId: RoutingId, actor: ZLinkActor, request: Message, commit: (spot: ZLinkSpot) => Promise<ZLinkActorJoinRollback | void> | ZLinkActorJoinRollback | void, signal?: AbortSignal, leaveSource?: () => Promise<void>, contentType?: string): Promise<ZLinkSpotActorJoinResult>;
+    admitActorJoin(spotId: RoutingId, actor: ZLinkActor, request: Message, commit: (spot: ZLinkSpot) => Promise<void> | void, signal?: AbortSignal, leaveSource?: () => Promise<void>, contentType?: string): Promise<ZLinkSpotActorJoinResult>;
     leaveActor(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
     leaveActorInMesh(meshName: string, spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
     notifyActorLeftAfterTransfer(spotId: RoutingId, actor: ZLinkActor, signal?: AbortSignal): Promise<void>;
@@ -221,13 +218,16 @@ export declare class DefaultZLinkSpotManager {
     dispatchMeshSpot(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
     private ensureInstanceApplicationActivation;
     dispatchMeshInstance(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    private reportInstanceDispatchFailure;
     private traceInstanceMessage;
     dispatchMeshActor(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
     dispatchMeshActorJoin(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    private dispatchMeshActorJoinCore;
     dispatchMeshSpotControl(meshName: string, owner: ReadyRecord, record: ReceiveRecord): Promise<void>;
+    private dispatchMeshSpotControlCore;
     completeFormalSourceLeaveTerminal(actorId: string, transferId: string, succeeded: boolean): Promise<boolean>;
     finalizeActorJoinRelocation(meshName: string, relocationId: string, actor: ZLinkActor, actorRef: ActorRef, submitSourceLeave: (sourceNodeRid: RoutingId) => Promise<void>, signal?: AbortSignal): Promise<boolean>;
-    restoreCanonicalActorJoinRecovery(recovery: CanonicalActorJoinRecovery, signal?: AbortSignal, canonicalInventoryDigest?: string): Promise<ZLinkDeferredJoinAcceptedRoot | undefined>;
+    restoreCanonicalActorJoinRecovery(recovery: CanonicalActorJoinRecovery, signal?: AbortSignal): Promise<void>;
     private encodeMeshActorReply;
     private createActivation;
     private requireRegisteredFactory;