@zlink-systems/framework 0.26.0 → 0.28.0

package/dist/runtime/streams/actor-session-binding-registry.d.ts

@@ -1,6 +1,10 @@
-import type { ServiceSessionBindingAdmissionResult } from '../foundation/service-session-binding-ingress-port';
+export declare const DEFAULT_TERMINAL_RELOCATION_CAPACITY = 4096;
 export interface ZLinkActorSessionBindingActor {
     readonly actorId: string;
+    readonly ref: {
+        readonly actorId: string;
+        readonly bindingGeneration?: bigint;
+    };
 }
 export interface ZLinkActorSessionBindingContext<TActor extends ZLinkActorSessionBindingActor> {
     readonly routingId?: unknown;
@@ -30,10 +34,6 @@ export interface ZLinkActorSessionRelocationClaim {
     readonly actorNodeGeneration?: bigint;
     readonly sealId: string;
 }
-export interface ZLinkActorSessionRetainedOutbound {
-    deliver(): Promise<boolean>;
-    fail(error: unknown): void;
-}
 export interface ZLinkActorSessionRelocationSnapshot extends ZLinkActorSessionRelocationClaim {
     readonly phase: 'sealed' | 'applying' | 'applied' | 'terminal';
     readonly applyFingerprint?: string;
@@ -71,7 +71,6 @@ export declare enum ZLinkActorSessionBindingTermination {
 }
 export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActorSessionBindingContext<TActor>, TActor extends ZLinkActorSessionBindingActor> {
     private readonly terminalRelocationCapacity;
-    private readonly outboundCapacity;
     private readonly sealWaitTimeoutMs;
     private readonly errorSink?;
     private readonly lane;
@@ -81,7 +80,7 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
     private readonly activeFrameWaiters;
     private readonly relocations;
     private readonly terminalRelocations;
-    constructor(terminalRelocationCapacity?: number, outboundCapacity?: number, sealWaitTimeoutMs?: number, errorSink?: (() => {
+    constructor(terminalRelocationCapacity?: number, sealWaitTimeoutMs?: number, errorSink?: (() => {
         reportRuntimeTaskException(taskName: string, error: unknown): void;
     } | undefined) | undefined);
     bind(context: TContext, actor: TActor, bindingToken: string, authorityFence?: ZLinkActorSessionAuthorityFence, sessionIdentity?: string, commitActor?: () => void): Promise<void>;
@@ -93,12 +92,15 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
     find(actorId: string): Promise<TActor | undefined>;
     private findCore;
     route(actorId: string): Promise<ZLinkActorSessionRoute<TContext, TActor> | undefined>;
+    /** Selects the route only when it is the exact Session binding (§8.1 validation values). */
+    routeForSessionBinding(actorId: string, sessionRid: string, bindingGeneration?: bigint): Promise<ZLinkActorSessionRoute<TContext, TActor> | undefined>;
     private routeCore;
     capturePendingReplyClaim(actorId: string, actor: ZLinkActorSessionBindingActor, bindingToken: string): Promise<{
         readonly context: TContext;
     } | undefined>;
     private capturePendingReplyClaimCore;
     unbind(actorId: string, context: TContext, bindingToken: string, termination?: ZLinkActorSessionBindingTermination): Promise<void>;
+    /** Fixes the unbind order in the lane; the caller awaits transport completion outside it. */
     private unbindCore;
     unbindActor(actorId: string): Promise<void>;
     private unbindActorCore;
@@ -110,6 +112,10 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
     private requireCurrentTokenCore;
     accept(actorId: string, bindingToken: string): Promise<void>;
     private acceptCore;
+    acceptOneWay(actorId: string, bindingToken: string, prepare: () => {
+        readonly deliver: () => Promise<void>;
+        readonly drop: (reason: 'stale_target' | 'target_closed' | 'shutdown', error?: unknown) => void;
+    }): Promise<boolean>;
     /**
      * Holds Session ingress accepted after a relocation seal until the target
      * route is published and the seal is released. The caller keeps the
@@ -129,31 +135,15 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
     private prepareRelocationSeal;
     relocationSnapshot(actorId: string, sealId: string): Promise<ZLinkActorSessionRelocationSnapshot | undefined>;
     private relocationSnapshotCore;
-    retainRelocationOutbound(actorId: string, operation: ZLinkActorSessionRetainedOutbound, sealId?: string): Promise<ServiceSessionBindingAdmissionResult>;
-    private retainRelocationOutboundCorePublic;
-    /**
-     * Session–Actor binding §8.1: the Session owner holds a push only while the
-     * binding's relocation seal is open, and keeps it behind earlier held pushes.
-     * Whether the push names the current binding was decided once by the Session
-     * owner's binding record before this call.
-     */
-    private retainRelocationOutboundCore;
-    discardRelocationOutbound(actorId: string, sealId: string, error: unknown): Promise<void>;
-    private discardRelocationOutboundCore;
     applyRelocation(actorId: string, sealId: string, applyFingerprint: string, commitOwnerTransition: () => Promise<void>): Promise<void>;
     private prepareRelocationApply;
-    /**
-     * Command 44 commit or abort releases every push held under this seal in
-     * arrival order (Session–Actor binding §8.1). The held pushes were admitted
-     * by the current binding; the route change does not judge them again.
-     */
     private completeRelocationApply;
     private failRelocationApply;
     observeRelocationTerminal(actorId: string, sealId: string, applyFingerprint: string): Promise<void>;
     private observeRelocationTerminalCore;
     /**
      * Actor-wide relocation teardown: every seal (active and terminal-retained)
-     * and every held outbound entry for `actorId` is discarded unconditionally.
+     * for `actorId` is discarded unconditionally.
      * Reserved for paths where the Actor itself is gone or being torn down
      * (destroy, ownership clear, relocation-seal expiry/failure) — never for a
      * single physical route's disconnect, which must not disturb a relocation
@@ -165,7 +155,7 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
      * Spec 48 §137: a relocation seal's lifecycle is independent of any single
      * physical route's binding. Unbinding one physical route (a disconnect)
      * must retire only the still-open (nonterminal) relocation seal that this
-     * exact route's Session owns, and the outbound held against that seal — it
+     * exact route's Session owns — it
      * must never reach into a seal that has already reached 'terminal' (its
      * bounded retention exists precisely so a late same-seal relay can still
      * pass on a successor route) nor into a different Session's active seal
@@ -188,14 +178,11 @@ export declare class ZLinkActorSessionBindingRegistry<TContext extends ZLinkActo
     private waitForActiveFramesCore;
     private resolveActiveFrameWaiters;
     private rejectActiveFrameWaiters;
-    private startOutboundDrain;
-    private reserveOutbound;
-    private settleOutbound;
-    private failOutbound;
     private rememberTerminalRelocation;
     private deleteEmptyRelocationQueue;
     private resolveSealWaiters;
     private rejectSealWaiters;
+    private startHeldOneWayDrain;
 }
 export interface ZLinkActorSessionRouteFence {
     readonly objectGeneration: bigint;