@origintrail-official/dkg-agent 10.0.19 → 10.0.21

package/dist/vm-recovery-stream-profile.js

@@ -0,0 +1,53 @@
+// SPDX-License-Identifier: Apache-2.0
+import { estimateVmRecoveryAssetBytes, planVmRecoveryMicrobatch, } from './vm-recovery-microbatch.js';
+export const VM_RECOVERY_STREAM_MAX_ASSET_ESTIMATED_BYTES = 8n * 1024n * 1024n;
+export const VM_RECOVERY_STREAM_MAX_ASSET_LEAVES = 16384n;
+/** The executor still checks the actual encoded, signed START request. */
+export const VM_RECOVERY_STREAM_MAX_START_BYTES = 8 * 1024;
+/** Fixed pilot profile; ordinary recovery configuration cannot widen it. */
+export const VM_RECOVERY_STREAM_MICROBATCH_LIMITS = Object.freeze({
+    maxAssets: 10,
+    targetBytes: 80n * 1024n * 1024n,
+    targetLeaves: 163840n,
+    fixedBytesPerAsset: 64n * 1024n,
+    bytesPerLeafOverhead: 128n,
+    byteSizeMultiplierBps: 11500n,
+    // Reserve half of START for request fields, authentication and encoding.
+    maxSelectorBytes: VM_RECOVERY_STREAM_MAX_START_BYTES / 2,
+});
+function isStreamSizedTarget(candidate) {
+    const footprint = candidate.recoveryFootprint;
+    if (footprint?.kind !== 'public-v10')
+        return false;
+    const { byteSize, merkleLeafCount } = footprint;
+    if (typeof byteSize !== 'bigint'
+        || typeof merkleLeafCount !== 'bigint'
+        || byteSize <= 0n
+        || merkleLeafCount <= 0n
+        || byteSize > VM_RECOVERY_STREAM_MAX_ASSET_ESTIMATED_BYTES
+        || merkleLeafCount > VM_RECOVERY_STREAM_MAX_ASSET_LEAVES)
+        return false;
+    const estimatedBytes = estimateVmRecoveryAssetBytes(byteSize, merkleLeafCount, VM_RECOVERY_STREAM_MICROBATCH_LIMITS);
+    return estimatedBytes <= VM_RECOVERY_STREAM_MAX_ASSET_ESTIMATED_BYTES;
+}
+/**
+ * Select only a stable prefix with complete, nonzero public-v10 sizing hints.
+ * Unknown or oversize work stays on the existing legacy singleton path; it
+ * must never be skipped to stream a later asset. The caller separately proves
+ * opt-in, current Core capability and public authority. This is sizing only.
+ */
+export function planVmRecoveryStreamMicrobatch(candidates, selectorBytesFor) {
+    const eligible = [];
+    for (const candidate of candidates) {
+        if (eligible.length >= VM_RECOVERY_STREAM_MICROBATCH_LIMITS.maxAssets)
+            break;
+        if (!isStreamSizedTarget(candidate))
+            break;
+        eligible.push(candidate);
+    }
+    if (eligible.length === 0)
+        return undefined;
+    const plan = planVmRecoveryMicrobatch(eligible, VM_RECOVERY_STREAM_MICROBATCH_LIMITS, selectorBytesFor);
+    return plan.targets.length > 0 ? plan : undefined;
+}
+//# sourceMappingURL=vm-recovery-stream-profile.js.map

package/dist/vm-recovery-stream-profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-stream-profile.js","sourceRoot":"","sources":["../src/vm-recovery-stream-profile.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EACL,4BAA4B,EAC5B,wBAAwB,GAIzB,MAAM,6BAA6B,CAAC;AAErC,MAAM,CAAC,MAAM,4CAA4C,GAAG,EAAE,GAAG,KAAK,GAAG,KAAK,CAAC;AAC/E,MAAM,CAAC,MAAM,mCAAmC,GAAG,MAAO,CAAC;AAC3D,0EAA0E;AAC1E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,GAAG,IAAI,CAAC;AAE3D,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oCAAoC,GAAyC,MAAM,CAAC,MAAM,CAAC;IACtG,SAAS,EAAE,EAAE;IACb,WAAW,EAAE,GAAG,GAAG,KAAK,GAAG,KAAK;IAChC,YAAY,EAAE,OAAQ;IACtB,kBAAkB,EAAE,GAAG,GAAG,KAAK;IAC/B,oBAAoB,EAAE,IAAI;IAC1B,qBAAqB,EAAE,MAAO;IAC9B,yEAAyE;IACzE,gBAAgB,EAAE,kCAAkC,GAAG,CAAC;CACzD,CAAC,CAAC;AAEH,SAAS,mBAAmB,CAAC,SAAoC;IAC/D,MAAM,SAAS,GAAG,SAAS,CAAC,iBAAiB,CAAC;IAC9C,IAAI,SAAS,EAAE,IAAI,KAAK,YAAY;QAAE,OAAO,KAAK,CAAC;IACnD,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,SAAS,CAAC;IAChD,IACE,OAAO,QAAQ,KAAK,QAAQ;WACzB,OAAO,eAAe,KAAK,QAAQ;WACnC,QAAQ,IAAI,EAAE;WACd,eAAe,IAAI,EAAE;WACrB,QAAQ,GAAG,4CAA4C;WACvD,eAAe,GAAG,mCAAmC;QACxD,OAAO,KAAK,CAAC;IAEf,MAAM,cAAc,GAAG,4BAA4B,CACjD,QAAQ,EACR,eAAe,EACf,oCAAoC,CACrC,CAAC;IACF,OAAO,cAAc,IAAI,4CAA4C,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAC5C,UAAwB,EACxB,gBAAmD;IAEnD,MAAM,QAAQ,GAAQ,EAAE,CAAC;IACzB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,QAAQ,CAAC,MAAM,IAAI,oCAAoC,CAAC,SAAS;YAAE,MAAM;QAC7E,IAAI,CAAC,mBAAmB,CAAC,SAAS,CAAC;YAAE,MAAM;QAC3C,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5C,MAAM,IAAI,GAAG,wBAAwB,CACnC,QAAQ,EACR,oCAAoC,EACpC,gBAAgB,CACjB,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC"}

package/dist/vm-recovery-stream-setback-policy.d.ts

@@ -0,0 +1,54 @@
+import type { ExactBatchStreamSetback } from './sync/requester/exact-recovery-transport.js';
+export interface VmRecoveryStreamSetbackLimits {
+    /** How long a peer is left alone after a stream attempt that gave no verdict. */
+    readonly holdOffMs: number;
+    /**
+     * How long one run of such attempts may go on keeping targets' turns open.
+     * Past it the peer is rotated like any other until it completes an exchange.
+     */
+    readonly streakWindowMs: number;
+    /** Broken streams in one run that keep the turn. Busy answers are not counted. */
+    readonly maxInterruptedInStreak: number;
+    readonly maxEntries: number;
+}
+export declare const VM_RECOVERY_STREAM_SETBACK_LIMITS: VmRecoveryStreamSetbackLimits;
+export interface VmRecoveryStreamSetbackDecision {
+    /**
+     * The targets of the attempt keep their turn at this peer, and the peer is
+     * asked again once `holdOffMs` has passed. False rotates them as before.
+     */
+    readonly keepsTurn: boolean;
+    readonly holdOffMs: number;
+}
+/**
+ * What a stream attempt that ended without a verdict on the peer's data costs
+ * that peer in one graph's recovery.
+ *
+ * A peer that answered BUSY is alive and said so: the assets asked for keep
+ * their turn at it. A stream that broke keeps the turn only for a peer that
+ * has already completed a stream exchange for this graph, and only a couple of
+ * times in a row, so an asset the peer aborts on every time is rotated like
+ * before. Either way the peer is left alone for a short hold-off, which is
+ * what bounds how often it is asked.
+ *
+ * Process-local transport history on the caller's monotonic clock. It never
+ * says an asset is present or absent anywhere, and forgetting it only restores
+ * the ordinary rotation.
+ */
+export declare class VmRecoveryStreamSetbackPolicy {
+    private readonly limits;
+    private readonly entries;
+    constructor(limits?: VmRecoveryStreamSetbackLimits);
+    /** A stream exchange with this peer delivered everything it was asked for. */
+    recordServed(localCgId: string, peerId: string, now: number): void;
+    recordSetback(localCgId: string, peerId: string, kind: ExactBatchStreamSetback, now: number): VmRecoveryStreamSetbackDecision;
+    /** Whether the peer is still inside the hold-off of its last setback. */
+    heldOff(localCgId: string, peerId: string, now: number): boolean;
+    /** Whether the peer's last stream attempt for this graph was a setback, with no complete exchange since. */
+    inSetbackStreak(localCgId: string, peerId: string, now: number): boolean;
+    forgetContextGraph(localCgId: string): void;
+    clear(): void;
+    private touch;
+    private key;
+}
+//# sourceMappingURL=vm-recovery-stream-setback-policy.d.ts.map

package/dist/vm-recovery-stream-setback-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-stream-setback-policy.d.ts","sourceRoot":"","sources":["../src/vm-recovery-stream-setback-policy.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8CAA8C,CAAC;AAE5F,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kFAAkF;IAClF,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,eAAO,MAAM,iCAAiC,EAAE,6BAK9C,CAAC;AAEH,MAAM,WAAW,+BAA+B;IAC9C;;;OAGG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAaD;;;;;;;;;;;;;;GAcG;AACH,qBAAa,6BAA6B;IAG5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAsC;gBAEjC,MAAM,GAAE,6BAAiE;IAEtG,8EAA8E;IAC9E,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQlE,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,uBAAuB,EAC7B,GAAG,EAAE,MAAM,GACV,+BAA+B;IAWlC,yEAAyE;IACzE,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAKhE,4GAA4G;IAC5G,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO;IAMxE,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO3C,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,KAAK;IAWb,OAAO,CAAC,GAAG;CAGZ"}

package/dist/vm-recovery-stream-setback-policy.js

@@ -0,0 +1,85 @@
+// SPDX-License-Identifier: Apache-2.0
+import { rememberBounded } from './bounded-map.js';
+export const VM_RECOVERY_STREAM_SETBACK_LIMITS = Object.freeze({
+    holdOffMs: 15_000,
+    streakWindowMs: 30 * 60_000,
+    maxInterruptedInStreak: 2,
+    maxEntries: 1_024,
+});
+/**
+ * What a stream attempt that ended without a verdict on the peer's data costs
+ * that peer in one graph's recovery.
+ *
+ * A peer that answered BUSY is alive and said so: the assets asked for keep
+ * their turn at it. A stream that broke keeps the turn only for a peer that
+ * has already completed a stream exchange for this graph, and only a couple of
+ * times in a row, so an asset the peer aborts on every time is rotated like
+ * before. Either way the peer is left alone for a short hold-off, which is
+ * what bounds how often it is asked.
+ *
+ * Process-local transport history on the caller's monotonic clock. It never
+ * says an asset is present or absent anywhere, and forgetting it only restores
+ * the ordinary rotation.
+ */
+export class VmRecoveryStreamSetbackPolicy {
+    limits;
+    entries = new Map();
+    constructor(limits = VM_RECOVERY_STREAM_SETBACK_LIMITS) {
+        this.limits = limits;
+    }
+    /** A stream exchange with this peer delivered everything it was asked for. */
+    recordServed(localCgId, peerId, now) {
+        const state = this.touch(localCgId, peerId, now);
+        state.served = true;
+        state.streakStartedAt = undefined;
+        state.interruptedInStreak = 0;
+        state.retryAt = 0;
+    }
+    recordSetback(localCgId, peerId, kind, now) {
+        const state = this.touch(localCgId, peerId, now);
+        state.streakStartedAt ??= now;
+        if (kind === 'stream-interrupted')
+            state.interruptedInStreak += 1;
+        const keepsTurn = now - state.streakStartedAt <= this.limits.streakWindowMs
+            && (kind === 'responder-busy'
+                || (state.served && state.interruptedInStreak <= this.limits.maxInterruptedInStreak));
+        state.retryAt = keepsTurn ? now + this.limits.holdOffMs : 0;
+        return { keepsTurn, holdOffMs: keepsTurn ? this.limits.holdOffMs : 0 };
+    }
+    /** Whether the peer is still inside the hold-off of its last setback. */
+    heldOff(localCgId, peerId, now) {
+        const state = this.entries.get(this.key(localCgId, peerId));
+        return state !== undefined && now < state.retryAt;
+    }
+    /** Whether the peer's last stream attempt for this graph was a setback, with no complete exchange since. */
+    inSetbackStreak(localCgId, peerId, now) {
+        const state = this.entries.get(this.key(localCgId, peerId));
+        return state !== undefined && state.streakStartedAt !== undefined
+            && now - state.touchedAt <= this.limits.streakWindowMs;
+    }
+    forgetContextGraph(localCgId) {
+        const prefix = `${localCgId}\0`;
+        for (const key of this.entries.keys()) {
+            if (key.startsWith(prefix))
+                this.entries.delete(key);
+        }
+    }
+    clear() {
+        this.entries.clear();
+    }
+    touch(localCgId, peerId, now) {
+        const key = this.key(localCgId, peerId);
+        let state = this.entries.get(key);
+        // History older than one streak window is not "the current recovery".
+        if (state !== undefined && now - state.touchedAt > this.limits.streakWindowMs)
+            state = undefined;
+        state ??= { served: false, streakStartedAt: undefined, interruptedInStreak: 0, retryAt: 0, touchedAt: now };
+        state.touchedAt = now;
+        rememberBounded(this.entries, key, state, this.limits.maxEntries);
+        return state;
+    }
+    key(localCgId, peerId) {
+        return `${localCgId}\0${peerId}`;
+    }
+}
+//# sourceMappingURL=vm-recovery-stream-setback-policy.js.map

package/dist/vm-recovery-stream-setback-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-stream-setback-policy.js","sourceRoot":"","sources":["../src/vm-recovery-stream-setback-policy.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAgBnD,MAAM,CAAC,MAAM,iCAAiC,GAAkC,MAAM,CAAC,MAAM,CAAC;IAC5F,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,EAAE,GAAG,MAAM;IAC3B,sBAAsB,EAAE,CAAC;IACzB,UAAU,EAAE,KAAK;CAClB,CAAC,CAAC;AAsBH;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,6BAA6B;IAGX;IAFZ,OAAO,GAAG,IAAI,GAAG,EAA2B,CAAC;IAE9D,YAA6B,SAAwC,iCAAiC;QAAzE,WAAM,GAAN,MAAM,CAAmE;IAAG,CAAC;IAE1G,8EAA8E;IAC9E,YAAY,CAAC,SAAiB,EAAE,MAAc,EAAE,GAAW;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACjD,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACpB,KAAK,CAAC,eAAe,GAAG,SAAS,CAAC;QAClC,KAAK,CAAC,mBAAmB,GAAG,CAAC,CAAC;QAC9B,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,aAAa,CACX,SAAiB,EACjB,MAAc,EACd,IAA6B,EAC7B,GAAW;QAEX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QACjD,KAAK,CAAC,eAAe,KAAK,GAAG,CAAC;QAC9B,IAAI,IAAI,KAAK,oBAAoB;YAAE,KAAK,CAAC,mBAAmB,IAAI,CAAC,CAAC;QAClE,MAAM,SAAS,GAAG,GAAG,GAAG,KAAK,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc;eACtE,CAAC,IAAI,KAAK,gBAAgB;mBACxB,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC,CAAC;QAC1F,KAAK,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5D,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,CAAC;IAED,yEAAyE;IACzE,OAAO,CAAC,SAAiB,EAAE,MAAc,EAAE,GAAW;QACpD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,OAAO,KAAK,KAAK,SAAS,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC;IACpD,CAAC;IAED,4GAA4G;IAC5G,eAAe,CAAC,SAAiB,EAAE,MAAc,EAAE,GAAW;QAC5D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,CAAC;QAC5D,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,eAAe,KAAK,SAAS;eAC5D,GAAG,GAAG,KAAK,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IAC3D,CAAC;IAED,kBAAkB,CAAC,SAAiB;QAClC,MAAM,MAAM,GAAG,GAAG,SAAS,IAAI,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED,KAAK;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;IAEO,KAAK,CAAC,SAAiB,EAAE,MAAc,EAAE,GAAW;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACxC,IAAI,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,sEAAsE;QACtE,IAAI,KAAK,KAAK,SAAS,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,cAAc;YAAE,KAAK,GAAG,SAAS,CAAC;QACjG,KAAK,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,mBAAmB,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC;QAC5G,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC;QACtB,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,GAAG,CAAC,SAAiB,EAAE,MAAc;QAC3C,OAAO,GAAG,SAAS,KAAK,MAAM,EAAE,CAAC;IACnC,CAAC;CACF"}

package/dist/vm-recovery-timing-observer.d.ts

@@ -0,0 +1,27 @@
+import { VmRecoveryPhaseRecorder } from './vm-recovery-phase-timing.js';
+import type { VmRecoveryFootprintObservation } from './vm-recovery-footprint.js';
+import { type VmRecoveryPreparationStats } from './vm-recovery-preparation.js';
+export interface VmRecoveryBatchTimingMetadata {
+    readonly peerId: string;
+    readonly assets: number;
+    readonly candidates: number;
+    readonly kind: string;
+    readonly transport: string;
+    readonly streamAdvertised: number;
+    readonly streamPeers: number;
+    readonly registeredAuthority: string;
+}
+/** Observation-only owner of per-batch marks, sizing, counters and log formatting. */
+export declare class VmRecoveryTimingObserver {
+    #private;
+    private readonly localCgId;
+    private readonly log;
+    readonly phases: VmRecoveryPhaseRecorder;
+    constructor(localCgId: string, log: (message: string) => void);
+    beginBatch(): {
+        observeSizing: (observation: VmRecoveryFootprintObservation) => void;
+        complete: (metadata: VmRecoveryBatchTimingMetadata) => void;
+    };
+    finish(eligible: number, preparation?: () => VmRecoveryPreparationStats): void;
+}
+//# sourceMappingURL=vm-recovery-timing-observer.d.ts.map

package/dist/vm-recovery-timing-observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-timing-observer.d.ts","sourceRoot":"","sources":["../src/vm-recovery-timing-observer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EACmB,MAAM,+BAA+B,CAAC;AACzF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAoC,KAAK,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAMjH,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,sFAAsF;AACtF,qBAAa,wBAAwB;;IAMvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAAU,OAAO,CAAC,QAAQ,CAAC,GAAG;IALpE,QAAQ,CAAC,MAAM,0BAAiC;gBAKnB,SAAS,EAAE,MAAM,EAAmB,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI;IAE/F,UAAU;qCAKuB,8BAA8B,KAAG,IAAI;6BAC7C,6BAA6B,KAAG,IAAI;;IAkB7D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,0BAA0B,GAAG,IAAI;CAS/E"}

package/dist/vm-recovery-timing-observer.js

@@ -0,0 +1,49 @@
+// SPDX-License-Identifier: Apache-2.0
+import { VmRecoveryPhaseRecorder, markVmRecoveryRpc, describeVmRecoveryRpcSince, formatVmRecoveryPhases, observeVmRecoveryTiming } from './vm-recovery-phase-timing.js';
+import { formatVmRecoveryPreparationStats } from './vm-recovery-preparation.js';
+const NO_SIZING = Object.freeze({
+    elapsedMs: 0, requested: 0, prepared: 0, resolved: 0, timedOut: 0, aborted: 0, invalid: 0, failed: 0,
+});
+/** Observation-only owner of per-batch marks, sizing, counters and log formatting. */
+export class VmRecoveryTimingObserver {
+    localCgId;
+    log;
+    phases = new VmRecoveryPhaseRecorder();
+    #startedAt = performance.now();
+    #batches = 0;
+    #assets = 0;
+    constructor(localCgId, log) {
+        this.localCgId = localCgId;
+        this.log = log;
+    }
+    beginBatch() {
+        const startedAt = performance.now();
+        const rpcMark = markVmRecoveryRpc();
+        let sizing = NO_SIZING;
+        return {
+            observeSizing: (observation) => { sizing = observation; },
+            complete: (metadata) => {
+                this.#batches += 1;
+                this.#assets += metadata.assets;
+                observeVmRecoveryTiming(() => this.log(`VM recovery batch timing for "${this.localCgId}" from ${metadata.peerId.slice(-8)}: `
+                    + `assets=${metadata.assets} candidates=${metadata.candidates} kind=${metadata.kind} `
+                    + `transport=${metadata.transport} streamAdvertised=${metadata.streamAdvertised} `
+                    + `streamPeers=${metadata.streamPeers} registeredAuthority=${metadata.registeredAuthority} `
+                    + `totalMs=${Math.round(performance.now() - startedAt)} `
+                    + `${formatVmRecoveryPhases(this.phases.take())} `
+                    + `sizingRequested=${sizing.requested} sizingPrepared=${sizing.prepared} sizingResolved=${sizing.resolved} sizingTimedOut=${sizing.timedOut} `
+                    + `sizingAborted=${sizing.aborted} sizingInvalid=${sizing.invalid} sizingFailed=${sizing.failed} `
+                    + `${describeVmRecoveryRpcSince(rpcMark)}`));
+            },
+        };
+    }
+    finish(eligible, preparation) {
+        if (this.#batches === 0)
+            return;
+        observeVmRecoveryTiming(() => this.log(`VM recovery pass timing for "${this.localCgId}": batches=${this.#batches} assets=${this.#assets} `
+            + `eligible=${eligible} totalMs=${Math.round(performance.now() - this.#startedAt)} `
+            + `${formatVmRecoveryPhases(this.phases.cumulative())}`
+            + (preparation ? ` ${formatVmRecoveryPreparationStats(preparation())}` : '')));
+    }
+}
+//# sourceMappingURL=vm-recovery-timing-observer.js.map

package/dist/vm-recovery-timing-observer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-timing-observer.js","sourceRoot":"","sources":["../src/vm-recovery-timing-observer.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,0BAA0B,EAC7E,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AAEzF,OAAO,EAAE,gCAAgC,EAAmC,MAAM,8BAA8B,CAAC;AAEjH,MAAM,SAAS,GAAmC,MAAM,CAAC,MAAM,CAAC;IAC9D,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;CACrG,CAAC,CAAC;AAaH,sFAAsF;AACtF,MAAM,OAAO,wBAAwB;IAMN;IAAoC;IALxD,MAAM,GAAG,IAAI,uBAAuB,EAAE,CAAC;IACvC,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACxC,QAAQ,GAAG,CAAC,CAAC;IACb,OAAO,GAAG,CAAC,CAAC;IAEZ,YAA6B,SAAiB,EAAmB,GAA8B;QAAlE,cAAS,GAAT,SAAS,CAAQ;QAAmB,QAAG,GAAH,GAAG,CAA2B;IAAG,CAAC;IAEnG,UAAU;QACR,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;QACpC,IAAI,MAAM,GAAG,SAAS,CAAC;QACvB,OAAO;YACL,aAAa,EAAE,CAAC,WAA2C,EAAQ,EAAE,GAAG,MAAM,GAAG,WAAW,CAAC,CAAC,CAAC;YAC/F,QAAQ,EAAE,CAAC,QAAuC,EAAQ,EAAE;gBAC1D,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACnB,IAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,MAAM,CAAC;gBAChC,uBAAuB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CACpC,iCAAiC,IAAI,CAAC,SAAS,UAAU,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI;sBAClF,UAAU,QAAQ,CAAC,MAAM,eAAe,QAAQ,CAAC,UAAU,SAAS,QAAQ,CAAC,IAAI,GAAG;sBACpF,aAAa,QAAQ,CAAC,SAAS,qBAAqB,QAAQ,CAAC,gBAAgB,GAAG;sBAChF,eAAe,QAAQ,CAAC,WAAW,wBAAwB,QAAQ,CAAC,mBAAmB,GAAG;sBAC1F,WAAW,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC,GAAG;sBACvD,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG;sBAChD,mBAAmB,MAAM,CAAC,SAAS,mBAAmB,MAAM,CAAC,QAAQ,mBAAmB,MAAM,CAAC,QAAQ,mBAAmB,MAAM,CAAC,QAAQ,GAAG;sBAC5I,iBAAiB,MAAM,CAAC,OAAO,kBAAkB,MAAM,CAAC,OAAO,iBAAiB,MAAM,CAAC,MAAM,GAAG;sBAChG,GAAG,0BAA0B,CAAC,OAAO,CAAC,EAAE,CAC7C,CAAC,CAAC;YACL,CAAC;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,QAAgB,EAAE,WAA8C;QACrE,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;YAAE,OAAO;QAChC,uBAAuB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CACpC,gCAAgC,IAAI,CAAC,SAAS,cAAc,IAAI,CAAC,QAAQ,WAAW,IAAI,CAAC,OAAO,GAAG;cAC/F,YAAY,QAAQ,YAAY,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG;cAClF,GAAG,sBAAsB,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC,EAAE;cACrD,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,gCAAgC,CAAC,WAAW,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAC/E,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/vm-recovery-transport-budget-policy.d.ts

@@ -0,0 +1,32 @@
+import type { VmRecoveryProviderAttemptKind } from './vm-recovery-provider-policy.js';
+export interface VmRecoveryTransportBudgetTarget {
+    readonly localCgId: string;
+    readonly onChainCgId: string;
+    readonly ordinal: number;
+    readonly ual: string;
+    readonly merkleRoot: string;
+}
+interface BudgetSelection {
+    readonly target: VmRecoveryTransportBudgetTarget;
+    readonly peerId: string;
+    readonly providerAttemptKind: VmRecoveryProviderAttemptKind;
+    readonly registeredPublicAccess: boolean;
+    readonly competingStreamAvailable: boolean;
+    readonly streamEligible: boolean;
+}
+/** Process-local physical-attempt history; it never creates asset or absence evidence. */
+export declare class VmRecoveryTransportBudgetPolicy {
+    private readonly maxEntries;
+    private readonly attempts;
+    /** Once a counter was evicted, missing history cannot justify a shortened probe. */
+    private historyEvicted;
+    constructor(maxEntries?: number);
+    attemptOrdinal(target: VmRecoveryTransportBudgetTarget, peerId: string): number;
+    timeoutFor(selection: BudgetSelection): number | undefined;
+    recordAdmitted(target: VmRecoveryTransportBudgetTarget, peerId: string): void;
+    forgetContextGraph(localCgId: string): void;
+    clear(): void;
+    private key;
+}
+export {};
+//# sourceMappingURL=vm-recovery-transport-budget-policy.d.ts.map

package/dist/vm-recovery-transport-budget-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-transport-budget-policy.d.ts","sourceRoot":"","sources":["../src/vm-recovery-transport-budget-policy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,kCAAkC,CAAC;AAOtF,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,UAAU,eAAe;IACvB,QAAQ,CAAC,MAAM,EAAE,+BAA+B,CAAC;IACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,mBAAmB,EAAE,6BAA6B,CAAC;IAC5D,QAAQ,CAAC,sBAAsB,EAAE,OAAO,CAAC;IACzC,QAAQ,CAAC,wBAAwB,EAAE,OAAO,CAAC;IAC3C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,0FAA0F;AAC1F,qBAAa,+BAA+B;IAK9B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,oFAAoF;IACpF,OAAO,CAAC,cAAc,CAAS;gBAEF,UAAU,SAAsB;IAE7D,cAAc,CAAC,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM;IAI/E,UAAU,CAAC,SAAS,EAAE,eAAe,GAAG,MAAM,GAAG,SAAS;IAQ1D,cAAc,CAAC,MAAM,EAAE,+BAA+B,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAc7E,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAO3C,KAAK,IAAI,IAAI;IAKb,OAAO,CAAC,GAAG;CAIZ"}

package/dist/vm-recovery-transport-budget-policy.js

@@ -0,0 +1,55 @@
+// SPDX-License-Identifier: Apache-2.0
+/** The budget is per exact probe and its full-scan fallback, not per wire request. */
+const MIXED_LEGACY_TIMEOUT_MS = 120_000;
+const FULL_BUDGET_EVERY = 4;
+const MAX_HISTORY_ENTRIES = 16_384;
+/** Process-local physical-attempt history; it never creates asset or absence evidence. */
+export class VmRecoveryTransportBudgetPolicy {
+    maxEntries;
+    attempts = new Map();
+    /** Once a counter was evicted, missing history cannot justify a shortened probe. */
+    historyEvicted = false;
+    constructor(maxEntries = MAX_HISTORY_ENTRIES) {
+        this.maxEntries = maxEntries;
+    }
+    attemptOrdinal(target, peerId) {
+        return this.attempts.get(this.key(target, peerId)) ?? 0;
+    }
+    timeoutFor(selection) {
+        if (selection.providerAttemptKind !== 'probe' || !selection.registeredPublicAccess
+            || !selection.competingStreamAvailable || selection.streamEligible)
+            return undefined;
+        const ordinal = this.attempts.get(this.key(selection.target, selection.peerId));
+        return (ordinal === undefined && this.historyEvicted) || ordinal === FULL_BUDGET_EVERY - 1
+            ? undefined : MIXED_LEGACY_TIMEOUT_MS;
+    }
+    recordAdmitted(target, peerId) {
+        const key = this.key(target, peerId);
+        const next = (this.attempts.get(key) ?? 0) + 1;
+        this.attempts.delete(key);
+        this.attempts.set(key, next % FULL_BUDGET_EVERY);
+        if (this.attempts.size > this.maxEntries) {
+            const oldest = this.attempts.keys().next().value;
+            if (oldest !== undefined) {
+                this.attempts.delete(oldest);
+                this.historyEvicted = true;
+            }
+        }
+    }
+    forgetContextGraph(localCgId) {
+        const prefix = `${localCgId}\0`;
+        for (const key of this.attempts.keys()) {
+            if (key.startsWith(prefix))
+                this.attempts.delete(key);
+        }
+    }
+    clear() {
+        this.attempts.clear();
+        this.historyEvicted = false;
+    }
+    key(target, peerId) {
+        return `${target.localCgId}\0${target.onChainCgId}\0${target.ordinal}\0`
+            + `${target.ual}\0${target.merkleRoot.toLowerCase()}\0${peerId}`;
+    }
+}
+//# sourceMappingURL=vm-recovery-transport-budget-policy.js.map

package/dist/vm-recovery-transport-budget-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-transport-budget-policy.js","sourceRoot":"","sources":["../src/vm-recovery-transport-budget-policy.ts"],"names":[],"mappings":"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"}

package/dist/vm-recovery-transport-plan.d.ts

@@ -0,0 +1,83 @@
+import type { VmRecoveryPreparation, VmRecoveryPreparationScope, VmRecoveryPreparationCandidate } from './vm-recovery-preparation.js';
+import type { ExactRecoveryTransportMode } from './sync/requester/exact-recovery-transport.js';
+import { type VmRecoveryFootprintBridge, type VmRecoveryFootprintObservation, type VmRecoveryFootprintSizingReader, type VmRecoveryPreparedHints } from './vm-recovery-footprint.js';
+import type { VmRecoveryChainFootprint } from './vm-recovery-types.js';
+import { type VmRecoveryMicrobatchPlan } from './vm-recovery-microbatch.js';
+import type { VmRecoveryProviderAttemptKind } from './vm-recovery-provider-policy.js';
+export declare const VM_EXACT_MICROBATCH_LIMITS: Readonly<{
+    maxAssets: 10;
+    targetBytes: bigint;
+    targetLeaves: 4096n;
+    fixedBytesPerAsset: bigint;
+    bytesPerLeafOverhead: 128n;
+    byteSizeMultiplierBps: 11500n;
+    maxSelectorBytes: number;
+}>;
+export interface VmRecoveryTransportCandidate<T> {
+    readonly attempt: T;
+    readonly kaId: string;
+    readonly assetUal: string;
+}
+export interface VmRecoveryTransportPlanningOptions<T> {
+    /** The host has already selected a rotation-compatible prefix. */
+    readonly candidates: readonly VmRecoveryTransportCandidate<T>[];
+    readonly providerAttemptKind: VmRecoveryProviderAttemptKind;
+    readonly onChainCgId: bigint;
+    readonly streamEligible: boolean;
+    readonly registeredPublicAccess: boolean;
+    /** Budget selected by transport policy for this probe and its full-scan fallback. */
+    readonly legacyAttemptTimeoutMs?: number;
+    readonly signal?: AbortSignal;
+    readonly isCurrent: () => boolean;
+    /** Observation only: outcome counts of this plan's sizing, never consulted by a decision. */
+    readonly observeSizing?: (observation: VmRecoveryFootprintObservation) => void;
+    /** Bounds in-flight live sizing reads; omitted keeps every read concurrent. */
+    readonly sizingReadConcurrency?: number;
+    /** Deadline of one live sizing read; omitted keeps the sizing bridge's default. */
+    readonly sizingReadTimeoutMs?: number;
+    /** Pending candidates after a probe; the transport owner prepares their sizing. */
+    readonly probeRemainder?: readonly VmRecoveryPreparationCandidate[];
+}
+export interface VmRecoveryTransportPlanningPorts {
+    readonly resolvePublicAccess: VmRecoveryFootprintBridge['resolvePublicAccess'];
+    /** Ordinary probes do not inspect or invoke optional sizing ports. */
+    readonly createSizingReader: () => VmRecoveryFootprintSizingReader | null;
+    /** The scoped owner of advisory sizing and its transport-plan lifetime. */
+    readonly preparation?: VmRecoveryTransportPreparationPort;
+}
+/** A sized candidate the plan left for a later batch, with the footprint already observed. */
+export interface VmRecoveryUnplannedCandidate<T> {
+    readonly attempt: T;
+    readonly kaId: string;
+    readonly recoveryFootprint?: VmRecoveryChainFootprint;
+}
+export interface VmRecoveryTransportPlan<T> {
+    readonly attempts: readonly T[];
+    readonly transportMode: ExactRecoveryTransportMode;
+    readonly legacyAttemptTimeoutMs?: number;
+    /** Unobserved probes cannot create reusable public-holder credit. */
+    readonly publicAccessEvidence: boolean | undefined;
+    readonly packing: Readonly<Omit<VmRecoveryMicrobatchPlan<unknown>, 'targets'>> | undefined;
+    /** The sized candidates a holder plan did not select, in candidate order. */
+    readonly unplanned: readonly VmRecoveryUnplannedCandidate<T>[];
+}
+export interface VmRecoveryTransportPreparationPort {
+    /** Holder sizing consumes hints; probes always inspect live sizing. */
+    hints(): VmRecoveryPreparedHints;
+    release(): void;
+    prepareRemainder(candidates: readonly VmRecoveryPreparationCandidate[]): void;
+}
+/** Coordinate advisory hint lifetime at transport-plan boundaries. */
+export declare class VmRecoveryTransportPreparation implements VmRecoveryTransportPreparationPort {
+    #private;
+    private readonly owner;
+    private readonly scope;
+    constructor(owner: VmRecoveryPreparation, scope: VmRecoveryPreparationScope);
+    preparePass(candidates: readonly VmRecoveryPreparationCandidate[]): void;
+    hints(): VmRecoveryPreparedHints;
+    release(): void;
+    prepareRemainder(candidates: readonly VmRecoveryPreparationCandidate[]): void;
+}
+/** Plan, release consumed hints, then prepare only the still-pending remainder. */
+export declare function planVmRecoveryTransport<T>(options: VmRecoveryTransportPlanningOptions<T>, ports: VmRecoveryTransportPlanningPorts): Promise<VmRecoveryTransportPlan<T>>;
+//# sourceMappingURL=vm-recovery-transport-plan.d.ts.map

package/dist/vm-recovery-transport-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-transport-plan.d.ts","sourceRoot":"","sources":["../src/vm-recovery-transport-plan.ts"],"names":[],"mappings":"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"}

package/dist/vm-recovery-transport-plan.js

@@ -0,0 +1,117 @@
+// SPDX-License-Identifier: Apache-2.0
+import { Buffer } from 'node:buffer';
+import { encodeExactAssetUals, MAX_EXACT_SYNC_ASSETS } from './sync/exact-assets.js';
+import { enrichVmRecoveryFootprints, } from './vm-recovery-footprint.js';
+import { planVmRecoveryMicrobatch } from './vm-recovery-microbatch.js';
+import { planVmRecoveryStreamMicrobatch } from './vm-recovery-stream-profile.js';
+// Exact ordinary responses are capped at 64 rows per page. These soft targets
+// keep one microbatch near 64 non-empty pages; individually larger KAs still
+// run alone under the executor's hard guards.
+export const VM_EXACT_MICROBATCH_LIMITS = Object.freeze({
+    maxAssets: MAX_EXACT_SYNC_ASSETS,
+    targetBytes: 24n * 1024n * 1024n,
+    targetLeaves: 4096n,
+    fixedBytesPerAsset: 64n * 1024n,
+    bytesPerLeafOverhead: 128n,
+    byteSizeMultiplierBps: 11500n,
+    maxSelectorBytes: 16 * 1024,
+});
+function freezePlan(attempts, transportMode, publicAccessEvidence, packing, unplanned = [], legacyAttemptTimeoutMs) {
+    // Attempt records remain owned by the host; only the planning decision and
+    // its selected order are frozen, without freezing mutable rotation state.
+    return Object.freeze({
+        attempts: Object.freeze([...attempts]), transportMode, publicAccessEvidence,
+        ...(legacyAttemptTimeoutMs === undefined ? {} : { legacyAttemptTimeoutMs }),
+        packing: packing === undefined ? undefined : Object.freeze({ ...packing }),
+        unplanned: Object.freeze([...unplanned]),
+    });
+}
+/** Coordinate advisory hint lifetime at transport-plan boundaries. */
+export class VmRecoveryTransportPreparation {
+    owner;
+    scope;
+    #entryPrepared = false;
+    constructor(owner, scope) {
+        this.owner = owner;
+        this.scope = scope;
+    }
+    preparePass(candidates) {
+        if (this.#entryPrepared)
+            return;
+        this.#entryPrepared = true;
+        this.owner.prepare(this.scope, candidates);
+    }
+    hints() { return this.owner.hintsFor(this.scope); }
+    release() { this.owner.release(this.scope); }
+    prepareRemainder(candidates) { this.owner.prepare(this.scope, candidates); }
+}
+/** Plan, release consumed hints, then prepare only the still-pending remainder. */
+export async function planVmRecoveryTransport(options, ports) {
+    let plan;
+    try {
+        plan = await selectVmRecoveryTransport(options, {
+            resolvePublicAccess: ports.resolvePublicAccess,
+            createSizingReader: ports.createSizingReader,
+        }, ports.preparation?.hints());
+    }
+    finally {
+        if (options.providerAttemptKind !== 'probe')
+            ports.preparation?.release();
+    }
+    if (plan.attempts.length > 0 && !options.signal?.aborted && options.isCurrent()) {
+        ports.preparation?.prepareRemainder(options.providerAttemptKind === 'probe'
+            ? options.probeRemainder ?? []
+            : plan.unplanned.map(({ kaId, recoveryFootprint }) => ({
+                kaId, ...(recoveryFootprint ? { footprint: recoveryFootprint } : {}),
+            })));
+    }
+    return plan;
+}
+/** Size and select one transport plan without changing provider/rotation state. */
+async function selectVmRecoveryTransport(options, ports, preparedHints) {
+    const probe = options.providerAttemptKind === 'probe';
+    const candidates = probe ? options.candidates.slice(0, 1) : options.candidates;
+    if (probe && !options.streamEligible) {
+        return freezePlan(candidates.map(({ attempt }) => attempt), 'legacy', undefined, undefined, [], options.legacyAttemptTimeoutMs);
+    }
+    let publicAccessEvidence;
+    const sized = await enrichVmRecoveryFootprints(candidates, options.onChainCgId, {
+        resolvePublicAccess: async (contextGraphId, readOptions) => {
+            const allowed = options.registeredPublicAccess
+                || await ports.resolvePublicAccess(contextGraphId, readOptions);
+            if (!probe && !options.signal?.aborted && options.isCurrent())
+                publicAccessEvidence = allowed;
+            return allowed;
+        },
+        sizing: ports.createSizingReader(),
+        ...(!probe && preparedHints ? { prepared: preparedHints } : {}),
+    }, {
+        maxContextReads: probe ? 1 : MAX_EXACT_SYNC_ASSETS,
+        signal: options.signal, isCurrent: options.isCurrent,
+        ...(options.observeSizing ? { observe: options.observeSizing } : {}),
+        ...(options.sizingReadConcurrency !== undefined ? { readConcurrency: options.sizingReadConcurrency } : {}),
+        ...(options.sizingReadTimeoutMs !== undefined ? { sizingReadTimeoutMs: options.sizingReadTimeoutMs } : {}),
+    });
+    if (options.signal?.aborted || !options.isCurrent())
+        publicAccessEvidence = undefined;
+    const selectorBytesFor = (selected) => Buffer.byteLength(encodeExactAssetUals(selected.map(({ assetUal }) => assetUal)), 'utf8');
+    const streamPlan = options.streamEligible
+        ? planVmRecoveryStreamMicrobatch(sized, selectorBytesFor)
+        : undefined;
+    if (probe) {
+        // A probe remains one KA even when its footprint is unknown/oversized.
+        // Only its optional wire changes; ordinary probe admission is unchanged.
+        return freezePlan(candidates.map(({ attempt }) => attempt), streamPlan === undefined ? 'legacy' : 'stream-preferred', undefined);
+    }
+    const plan = streamPlan ?? planVmRecoveryMicrobatch(sized, VM_EXACT_MICROBATCH_LIMITS, selectorBytesFor);
+    const { targets, ...packing } = plan;
+    const selected = new Set(targets.map(({ attempt }) => attempt));
+    // The candidates after the selected prefix are the next batch's work; keep the
+    // footprints already observed for them so a later pass need not read them again.
+    const unplanned = sized.filter(({ attempt }) => !selected.has(attempt)).map(({ attempt, kaId, recoveryFootprint }) => ({
+        attempt, kaId, ...(recoveryFootprint ? { recoveryFootprint } : {}),
+    }));
+    // Holder streaming retains required mode even for a one-KA sized prefix.
+    return freezePlan(targets.map(({ attempt }) => attempt), streamPlan === undefined ? 'legacy' : 'stream-required', publicAccessEvidence, packing, unplanned);
+}
+//# sourceMappingURL=vm-recovery-transport-plan.js.map

package/dist/vm-recovery-transport-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-recovery-transport-plan.js","sourceRoot":"","sources":["../src/vm-recovery-transport-plan.ts"],"names":[],"mappings":"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"}