@zlink-systems/framework 0.26.0 → 0.27.0

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

@@ -1004,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

@@ -5401,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;
 }
@@ -5415,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);
 }
@@ -5669,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;
@@ -5778,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);
@@ -5894,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);
@@ -5951,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)
@@ -7309,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);
@@ -7336,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);
@@ -7373,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/spots/formal-remote-actor-transfer-registry.d.ts

@@ -1,5 +1,5 @@
 import type { RoutingId, ZLinkActor } from '../../contracts';
-import type { ZLinkDeferredJoinCompletion } from '../actors';
+import type { ZLinkDeferredJoinCompletion, ZLinkRemoteBoundSessionTarget } from '../actors';
 import type { ZLinkActorHandoffPacket } from '../actors/actor-handoff';
 export interface ZLinkFormalRemoteActorTransfer {
     readonly actor: ZLinkActor;
@@ -7,6 +7,8 @@ export interface ZLinkFormalRemoteActorTransfer {
     readonly transferId: string;
     readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
     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>;
 }
@@ -24,6 +26,7 @@ export declare class ZLinkFormalRemoteActorTransferRegistry {
         readonly transferId: string;
         readonly handoffBacklog: readonly ZLinkActorHandoffPacket[];
         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,7 +8,7 @@ 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';
@@ -27,7 +27,6 @@ export { DefaultZLinkSpotHandlerRegistry, type ZLinkSpotHandlerRegistration } fr
 export { ZLinkRuntimeSpotPublisherTransport } from './spot-publisher-transport';
 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';
@@ -62,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;
@@ -69,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;
@@ -77,7 +76,6 @@ 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;
@@ -86,16 +84,10 @@ export interface ZLinkSpotManagerOptions {
     readonly messageSerializers?: ReadonlyMap<string, ZLinkMessageSerializer>;
     readonly locationLifecycle?: ZLinkLocationLifecycle;
     readonly releaseInstanceAuthority?: (meshName: string, spotId: RoutingId, objectGeneration: bigint) => Promise<void>;
-    readonly beginInstanceIdleClosingAuthority?: (meshName: string, spotId: RoutingId, onCommitted: () => void) => Promise<{
-        release(): Promise<void>;
-    } | undefined>;
-    readonly beginInstanceClosingAuthority?: (meshName: string, spotId: RoutingId, onCommitted: () => void) => Promise<{
-        release(): 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<{
-        release(): Promise<void>;
-    } | undefined>;
+    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;
@@ -116,13 +108,16 @@ 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 statefulExecution?: {
+        readonly admissionOpen: () => boolean;
+        readonly hostState: () => ZLinkFrameworkRuntimeState;
+    };
     readonly activationAdmission?: ZLinkActivationAdmission;
 }
 export declare class DefaultZLinkSpotManager {
@@ -156,10 +151,10 @@ export declare class DefaultZLinkSpotManager {
     materializeInstance(meshName: string, instanceType: string, spotId: RoutingId, objectGeneration: bigint, signal?: AbortSignal): Promise<void>;
     private materializeInstanceCore;
     isInstanceMaterialized(meshName: string, instanceType: string, spotId: RoutingId): boolean;
+    private resolveApplicationActivation;
     isInstanceMaterializing(meshName: string, spotId: RoutingId): boolean;
     isSpotClosing(meshName: string, spotId: RoutingId): boolean;
     pendingSpotCloseDecision(meshName: string, spotId: RoutingId): Promise<void> | undefined;
-    isInstanceClosing(meshName: string, spotId: RoutingId): boolean;
     discardInstance(meshName: string, spotId: RoutingId): Promise<void>;
     isInstanceSpotIdleEvicting(meshName: string, spotId: RoutingId): boolean;
     beginInstanceSpotIdleEviction(meshName: string, spotId: RoutingId): boolean;
@@ -184,9 +179,7 @@ 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<{
-        release(): Promise<void>;
-    }>, 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;
@@ -197,7 +190,7 @@ export declare class DefaultZLinkSpotManager {
     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>;
@@ -225,6 +218,7 @@ 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>;