@origintrail-official/dkg-agent 10.0.20 → 10.0.21

package/dist/sync/requester/exact-batch-stream-driver.js

@@ -0,0 +1,299 @@
+// SPDX-License-Identifier: Apache-2.0
+import { exchangeExperimentalExactBatch, ExperimentalExactBatchUnsupportedError, } from '@origintrail-official/dkg-core';
+import { runBoundedOperation } from '../../bounded-operation.js';
+import { SYNC_PAGE_SIZE } from '../../dkg-agent-constants.js';
+import { createDurableSyncAccumulator, finalizeDurableSyncCompletion, markDurableTerminalBoundary, recordDurableSyncDiagnostics, } from '../durable-progress.js';
+import { buildSyncRequestEnvelope } from '../auth/request-build.js';
+import { exactAssetUalsForSelection } from '../exact-assets.js';
+import { exactBatchStreamUnsupported, rememberExactBatchStreamResourceRefusal, rememberExactBatchStreamUnsupported, } from '../exact-batch-stream-capability.js';
+import { observeExactBatch } from '../exact-batch-observation.js';
+import { EXACT_BATCH_STREAM_PROTOCOL } from '../exact-batch-stream-contract.js';
+import { exactBatchTransportOptions, exactBatchStartFrame, exchangeExactBatchVerified, ExactBatchPartialSyncError, } from './exact-batch-stream.js';
+/** How a stream that broke is given a second exchange with the same peer. */
+export const EXACT_BATCH_STREAM_RETRY = Object.freeze({
+    /** Exchanges opened after a break, per driver call. */
+    maxRetries: 1,
+    /** How long the peer may take to be connected again. */
+    reconnectWindowMs: 15_000,
+    /** Pause between reconnection attempts inside that window. */
+    reconnectPollMs: 1_000,
+    /** Fetch time that must remain for a second exchange to be opened. */
+    minRemainingMs: 5_000,
+});
+/**
+ * How a peer that answered BUSY is asked again inside the same fetch. Kept
+ * short on purpose: the fetch holds this node's sync admission while it waits,
+ * and a peer that stays busy longer is asked again by the recovery pass, which
+ * can use other peers in between.
+ */
+export const EXACT_BATCH_STREAM_BUSY_RETRY = Object.freeze({
+    /** The pause before each further exchange; one entry per exchange allowed. */
+    backoffMs: Object.freeze([2_000, 5_000, 10_000]),
+});
+function unavailableStream() {
+    const accumulator = createDurableSyncAccumulator();
+    recordDurableSyncDiagnostics(accumulator, { failedPhases: 1 });
+    markDurableTerminalBoundary(accumulator, false);
+    return { kind: 'settled', detailed: {
+            result: finalizeDurableSyncCompletion(accumulator), exactFetchDisposition: 'incomplete',
+        } };
+}
+function isUnsupportedBeforeStart(error) {
+    const cause = error instanceof Error ? error.cause : undefined;
+    return error instanceof ExperimentalExactBatchUnsupportedError
+        || cause instanceof ExperimentalExactBatchUnsupportedError;
+}
+/** Whether an exchange stopped for a reason that says nothing about the peer's data. */
+function exactBatchStreamSetback(error) {
+    if (!(error instanceof ExactBatchPartialSyncError))
+        return undefined;
+    if (error.refusalObservation?.code === 'BUSY')
+        return 'responder-busy';
+    return error.streamInterrupted ? 'stream-interrupted' : undefined;
+}
+/**
+ * Why an exchange stopped, as one log line. `origin` says where the failure
+ * came from: the stream itself, a responder refusal, a local cancellation, or
+ * anything else (verification, the store, a frame the window refused, or the
+ * stream never opening). `lastStage` is the last stage that completed.
+ */
+function exactBatchFailureLine(error, fields) {
+    const partial = error instanceof ExactBatchPartialSyncError ? error : undefined;
+    const cause = partial === undefined ? error : partial.cause;
+    const origin = fields.cancelled ? 'cancelled'
+        : partial?.refusalObservation !== undefined ? 'refusal'
+            : partial?.streamInterrupted === true ? 'stream'
+                : 'other';
+    const name = cause instanceof Error ? cause.name : typeof cause;
+    const code = cause?.code;
+    const detail = (cause instanceof Error ? cause.message : String(cause)).replace(/\s+/g, ' ').slice(0, 200);
+    return `Exact batch requester failure assetCount=${fields.assetCount} committedAssets=${fields.committedAssets} `
+        + `origin=${origin} lastStage=${fields.lastStage} error=${name} `
+        + `code=${typeof code === 'string' || typeof code === 'number' ? code : 'none'} detail=${JSON.stringify(detail)}`;
+}
+/** Resolves true after `ms`, or false as soon as `signal` aborts. */
+function pause(ms, signal) {
+    if (signal?.aborted)
+        return Promise.resolve(false);
+    return new Promise((resolve) => {
+        const onAbort = () => { clearTimeout(timer); resolve(false); };
+        const timer = setTimeout(() => { signal?.removeEventListener('abort', onAbort); resolve(true); }, ms);
+        signal?.addEventListener('abort', onAbort, { once: true });
+    });
+}
+/** Wait, inside the retry window and the fetch deadline, for the peer to be connected again. */
+async function reconnectForRetry(options, ports) {
+    const { signal } = options;
+    const windowEndsAt = Math.min(Date.now() + EXACT_BATCH_STREAM_RETRY.reconnectWindowMs, options.fetchDeadline - EXACT_BATCH_STREAM_RETRY.minRemainingMs);
+    // The attempt count bounds the loop on its own, whatever the clock does.
+    const maxAttempts = Math.ceil(EXACT_BATCH_STREAM_RETRY.reconnectWindowMs / EXACT_BATCH_STREAM_RETRY.reconnectPollMs);
+    for (let attempt = 0; attempt < maxAttempts; attempt += 1) {
+        const remainingMs = windowEndsAt - Date.now();
+        if (remainingMs < 1 || signal?.aborted || options.isCurrent?.() === false)
+            return false;
+        try {
+            if (await runBoundedOperation(attemptSignal => ports.reconnect(attemptSignal), {
+                timeoutMs: remainingMs, label: 'Exact batch stream reconnect', signal,
+            }))
+                return true;
+        }
+        catch {
+            // Cancelled, out of time, or the peer is still unreachable: the loop decides.
+        }
+        const pauseMs = Math.min(EXACT_BATCH_STREAM_RETRY.reconnectPollMs, windowEndsAt - Date.now());
+        if (pauseMs < 1 || !await pause(pauseMs, signal))
+            return false;
+    }
+    return false;
+}
+/**
+ * Wait before asking a busy peer again. False when the fetch is cancelled, or
+ * would be left with less time than another exchange needs.
+ */
+async function pauseForBusyRetry(options, backoffMs) {
+    if (Date.now() + backoffMs > options.fetchDeadline - EXACT_BATCH_STREAM_RETRY.minRemainingMs)
+        return false;
+    return await pause(backoffMs, options.signal) && options.isCurrent?.() !== false;
+}
+/** Open one stream for `assetUals` and apply what it delivers. */
+async function exchangeExactBatchOnce(options, ports, assetUals, accumulator) {
+    const { contextGraphId, remotePeerId, signal } = options;
+    let committedAssetUals = Object.freeze([]);
+    // Registered public authority permits the unchanged public START without
+    // requiring an identity/signature from a requester that has not joined yet.
+    const start = await buildSyncRequestEnvelope({
+        contextGraphId, offset: 0, limit: SYNC_PAGE_SIZE, includeSharedMemory: false,
+        targetPeerId: remotePeerId, phase: 'data',
+        assetUals: [...assetUals], needsAuth: false, ...ports.requestIdentity(),
+    });
+    const remainingMs = Math.floor(options.fetchDeadline - Date.now());
+    const exchangeStartedAtMs = Date.now();
+    let streamComplete = false, streamReadyMs = -1, startSent = 0, nativeAcceptedSentBytes = 0, receivedPayloadBytes = 0;
+    let lastStage = 'none';
+    const sentFrames = [0, 0, 0, 0, 0, 0, 0, 0], receivedFrames = [0, 0, 0, 0, 0, 0, 0, 0];
+    const onTransportEvent = (event) => {
+        if (event.event === 'streamReady')
+            streamReadyMs = event.elapsedMs;
+        else if (event.event === 'bytes') {
+            if (event.direction === 'sent')
+                nativeAcceptedSentBytes += event.byteLength;
+            else
+                receivedPayloadBytes += event.byteLength;
+        }
+        else {
+            const frames = event.direction === 'sent' ? sentFrames : receivedFrames;
+            frames[event.frameKind] += 1;
+            if (event.direction === 'sent' && event.frameKind === 1) {
+                startSent += 1;
+                observeExactBatch(() => ports.logInfo(`Exact batch requester start assetCount=${assetUals.length} requestEncodedBytes=${start.byteLength} sentAtMs=${Date.now()}`));
+            }
+        }
+    };
+    try {
+        if (remainingMs < 1)
+            throw new Error('Exact batch recovery fetch deadline expired');
+        const exchanged = await exchangeExactBatchVerified(consume => exchangeExperimentalExactBatch(ports.router, remotePeerId, exactBatchStartFrame(start), { ...exactBatchTransportOptions(Math.min(120_000, remainingMs), signal), assetUals, onTransportEvent }, consume), {
+            ...ports.verification, contextGraphId, assetUals,
+            storeGraphScopedAsset: async (request) => {
+                const outcome = await ports.verification.storeGraphScopedAsset(request);
+                if (outcome === 'applied') {
+                    recordDurableSyncDiagnostics(accumulator, {
+                        insertedDataTriples: request.asset.dataQuads.length,
+                        insertedMetaTriples: request.asset.metadataQuads.length,
+                        insertedTriples: request.asset.dataQuads.length + request.asset.metadataQuads.length,
+                        fetchedDataTriples: request.asset.dataQuads.length,
+                        fetchedMetaTriples: request.asset.metadataQuads.length,
+                    });
+                }
+                return outcome;
+            },
+            onStage: (stage, assetIndex, durationMs) => {
+                lastStage = `${stage}@${assetIndex}`;
+                ports.logInfo(`Exact batch requester stage=${stage} asset=${assetIndex} durationMs=${durationMs.toFixed(3)}`);
+            },
+            onCommitted: ual => {
+                const assetIndex = assetUals.indexOf(ual);
+                ports.logInfo(`Exact batch committed asset=${assetIndex} committedAssets=${assetIndex + 1}`);
+            },
+        });
+        committedAssetUals = exchanged.committedAssetUals;
+        streamComplete = true;
+        return { complete: true, committedAssetUals };
+    }
+    catch (error) {
+        // Core settles physical stream/decoder cleanup before rejection. Progress
+        // reflects the guarded atomic callback, including a failed final close.
+        if (error instanceof ExactBatchPartialSyncError)
+            committedAssetUals = error.committedAssetUals;
+        const committedAssets = committedAssetUals.length;
+        observeExactBatch(() => ports.logInfo(exactBatchFailureLine(error, {
+            assetCount: assetUals.length, committedAssets, lastStage,
+            cancelled: signal?.aborted === true || options.isCurrent?.() === false,
+        })));
+        return { complete: false, committedAssetUals, error };
+    }
+    finally {
+        // Encoded native payload totals exclude Noise/TCP overhead. Success also
+        // requires Core's final close to settle; observations grant no authority.
+        observeExactBatch(() => ports.logInfo(`Exact batch requester transport assetCount=${assetUals.length} streamComplete=${streamComplete ? 1 : 0} committedAssets=${committedAssetUals.length} startSent=${startSent} nativeAcceptedSentBytes=${nativeAcceptedSentBytes} receivedPayloadBytes=${receivedPayloadBytes} sentAckFrames=${sentFrames[5]} receivedMetaFrames=${receivedFrames[2]} receivedDataFrames=${receivedFrames[3]} receivedAssetEndFrames=${receivedFrames[4]} receivedBatchEndFrames=${receivedFrames[6]} streamReadyMs=${streamReadyMs.toFixed(3)} exchangeElapsedMs=${Date.now() - exchangeStartedAtMs}`));
+    }
+}
+/**
+ * Own the optional exact stream inside the caller's existing admission. The
+ * typed ordinary outcomes are possible only before the first START; a settled
+ * stream always retains its applied prefix and never replays the enlarged
+ * selection over the ordinary wire.
+ *
+ * Two ways of stopping say nothing about the peer's data, and leaving the peer
+ * after either sends every outstanding asset to the peers that cannot stream.
+ * So the same peer is asked again for the assets not applied yet: once after
+ * the stream broke, and after each short pause while it answers BUSY. Nothing
+ * else is retried. Any other refusal, a rejected or unstorable asset and a
+ * cancellation settle as they did. When the retries run out, the outcome names
+ * which of the two it was, for the caller to decide whether to come back.
+ */
+export async function runExactBatchStreamDriver(options, ports) {
+    const { remotePeerId, signal, transportMode } = options;
+    if (transportMode === 'legacy')
+        return { kind: 'not-selected' };
+    const selected = exactAssetUalsForSelection(options.selection);
+    const accumulator = createDurableSyncAccumulator();
+    const committed = [];
+    // Set while the last exchange stopped without a verdict on the peer's data.
+    let setback;
+    const incomplete = () => {
+        recordDurableSyncDiagnostics(accumulator, { failedPhases: 1 });
+        markDurableTerminalBoundary(accumulator, false);
+        return { kind: 'settled', detailed: {
+                result: finalizeDurableSyncCompletion(accumulator), exactFetchDisposition: 'incomplete',
+                committedExactAssetUals: Object.freeze([...committed]),
+                ...(setback === undefined ? {} : { exactStreamOutcome: setback }),
+            } };
+    };
+    let interruptionRetries = 0, busyRetries = 0;
+    for (let exchanges = 0;; exchanges += 1) {
+        const resourceRefusalScope = options.streamEnabled ? ports.captureRefusalScope() : null;
+        const connectionKey = options.streamEnabled ? ports.captureConnectionKey() : null;
+        if (!options.streamEnabled || !ports.isChainEnabled()
+            || exactBatchStreamUnsupported(ports.capabilityOwner, remotePeerId, connectionKey, Date.now(), resourceRefusalScope)
+            || !(await ports.getPeerProtocols()).includes(EXACT_BATCH_STREAM_PROTOCOL)
+            || !await ports.isRegisteredPublic()) {
+            // An earlier exchange of this call has run: its applied prefix stands.
+            if (exchanges > 0)
+                return incomplete();
+            // Required stream sizing must never widen an ordinary paging request.
+            return transportMode === 'stream-required' ? unavailableStream() : { kind: 'not-selected' };
+        }
+        const exchange = await exchangeExactBatchOnce(options, ports, selected.slice(committed.length), accumulator);
+        committed.push(...exchange.committedAssetUals);
+        if (exchange.complete) {
+            markDurableTerminalBoundary(accumulator, true, { countCompletedPhase: true });
+            return { kind: 'settled', detailed: {
+                    result: finalizeDurableSyncCompletion(accumulator), exactFetchDisposition: 'found',
+                    committedExactAssetUals: Object.freeze([...committed]), exactStreamOutcome: 'complete',
+                } };
+        }
+        const { error } = exchange;
+        if (error instanceof ExactBatchPartialSyncError && error.refusalObservation !== undefined) {
+            const observed = error.refusalObservation;
+            if (observed.code === 'RESOURCE_LIMIT' && !signal?.aborted && options.isCurrent?.() !== false) {
+                rememberExactBatchStreamResourceRefusal(ports.capabilityOwner, remotePeerId, connectionKey, ports.captureConnectionKey(), resourceRefusalScope, ports.captureRefusalScope(), Date.now());
+            }
+            observeExactBatch(() => ports.logInfo(`Exact batch requester refusal code=${observed.code} startedAssets=${observed.startedAssets} committedAssets=${observed.committedAssets} acknowledgedAssets=${observed.acknowledgedAssets} atAssetBoundary=${observed.atAssetBoundary ? 1 : 0} verifiedPrefix=${observed.verifiedPrefix ? 1 : 0}`));
+        }
+        if (isUnsupportedBeforeStart(error)) {
+            rememberExactBatchStreamUnsupported(ports.capabilityOwner, remotePeerId, connectionKey, ports.captureConnectionKey(), Date.now());
+            // Only while no START of this call has been sent may the ordinary wire take over.
+            if (exchanges === 0 && transportMode !== 'stream-required')
+                return { kind: 'unsupported-before-start' };
+        }
+        const outstandingAssets = selected.length - committed.length;
+        setback = outstandingAssets < 1 || signal?.aborted || options.isCurrent?.() === false
+            ? undefined
+            : exactBatchStreamSetback(error);
+        if (setback === undefined)
+            return incomplete();
+        // A fetch cancelled while it waits settles as a cancellation, not as a setback.
+        const settleUnretried = () => {
+            if (signal?.aborted || options.isCurrent?.() === false)
+                setback = undefined;
+            return incomplete();
+        };
+        if (setback === 'responder-busy') {
+            const backoffMs = EXACT_BATCH_STREAM_BUSY_RETRY.backoffMs[busyRetries];
+            if (backoffMs === undefined || !await pauseForBusyRetry(options, backoffMs))
+                return settleUnretried();
+            busyRetries += 1;
+            observeExactBatch(() => ports.logInfo(`Exact batch requester retry reason=responder-busy committedAssets=${committed.length} outstandingAssets=${outstandingAssets} backoffMs=${backoffMs}`));
+            continue;
+        }
+        if (interruptionRetries >= EXACT_BATCH_STREAM_RETRY.maxRetries)
+            return incomplete();
+        const reconnectStartedAtMs = Date.now();
+        if (!await reconnectForRetry(options, ports))
+            return settleUnretried();
+        interruptionRetries += 1;
+        observeExactBatch(() => ports.logInfo(`Exact batch requester retry reason=stream-interrupted committedAssets=${committed.length} outstandingAssets=${outstandingAssets} reconnectMs=${Date.now() - reconnectStartedAtMs}`));
+    }
+}
+//# sourceMappingURL=exact-batch-stream-driver.js.map

package/dist/sync/requester/exact-batch-stream-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-batch-stream-driver.js","sourceRoot":"","sources":["../../../src/sync/requester/exact-batch-stream-driver.ts"],"names":[],"mappings":"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"}

package/dist/sync/requester/exact-batch-stream.d.ts

@@ -0,0 +1,72 @@
+import { type ExactBatchTransportSession, type ExactBatchTransportOptions } from '@origintrail-official/dkg-core';
+import type { Quad } from '@origintrail-official/dkg-storage';
+import { type ExactBatchFrame, type ExactBatchRefusal, type ReceivedExactBatchAsset } from '../exact-batch-stream-contract.js';
+import type { DurableSyncContext } from './durable-sync.js';
+/** Agent consumes the public operations of Core's fixed wire session. */
+export type ExactBatchAgentSession = Pick<ExactBatchTransportSession, 'signal' | 'windowSize' | 'assetUals' | 'next' | 'send'>;
+export type ExactBatchStage = 'decode' | 'parse' | 'verify' | 'authenticate-and-store';
+export interface ExactBatchVerifiedReceiverOptions {
+    readonly contextGraphId: string;
+    readonly assetUals: readonly string[];
+    readonly ctx: Parameters<DurableSyncContext['processDurableBatchInWorker']>[2];
+    readonly parseAndFilter: (text: string, graph: string, contextGraphId: string) => Promise<{
+        quads: Quad[];
+        totalQuads: number;
+    }>;
+    readonly processDurableBatchInWorker: DurableSyncContext['processDurableBatchInWorker'];
+    /** The normal host callback, including chain/binding fences, atomic write and retirement. */
+    readonly storeGraphScopedAsset: NonNullable<DurableSyncContext['storeGraphScopedAsset']>;
+    readonly authenticationDeadline: () => number;
+    readonly onStage?: (stage: ExactBatchStage, assetIndex: number, durationMs: number) => void;
+    /** Observation only, after the normal store callback; progress is returned separately. */
+    readonly onCommitted?: (assetUal: string) => void;
+}
+export interface ExactBatchVerifiedResult {
+    readonly complete: true;
+    readonly committedAssetUals: readonly string[];
+}
+export declare function exactBatchTransportOptions(timeoutMs: number, signal?: AbortSignal): ExactBatchTransportOptions;
+/** Settled local observations only; these never grant recovery or holder credit. */
+export interface ExactBatchRefusalObservation {
+    readonly code: ExactBatchRefusal;
+    readonly startedAssets: number;
+    readonly committedAssets: number;
+    readonly acknowledgedAssets: number;
+    readonly atAssetBoundary: boolean;
+    readonly verifiedPrefix: boolean;
+}
+export declare class ExactBatchPartialSyncError extends Error {
+    readonly committedAssetUals: readonly string[];
+    readonly refusalObservation?: ExactBatchRefusalObservation | undefined;
+    /**
+     * The stream itself failed or ended before completion, and no local
+     * cancellation caused it. False for a refusal, for an asset this node
+     * rejected or could not store, and for a frame the receive window refused.
+     */
+    readonly streamInterrupted: boolean;
+    readonly code = "EXACT_BATCH_PARTIAL";
+    constructor(committedAssetUals: readonly string[], cause: unknown, refusalObservation?: ExactBatchRefusalObservation | undefined, 
+    /**
+     * The stream itself failed or ended before completion, and no local
+     * cancellation caused it. False for a refusal, for an asset this node
+     * rejected or could not store, and for a frame the receive window refused.
+     */
+    streamInterrupted?: boolean);
+}
+/** Normal worker and graph-scoped callback; no direct INSERT or authority bypass. */
+export declare function createExactBatchVerifiedCommitter(options: ExactBatchVerifiedReceiverOptions): (received: ReceivedExactBatchAsset, signal?: AbortSignal) => Promise<void>;
+/**
+ * One reader overlaps the next compressed asset with one normal verifier/write.
+ * On failure the Core exchange must abort the physical stream and settle its
+ * decoder before returning. Pending reads remain owned by that exchange; this
+ * module never releases a live atomic callback by racing it against cancellation.
+ */
+export declare function consumeExactBatchVerifiedSession(session: ExactBatchAgentSession, options: ExactBatchVerifiedReceiverOptions): Promise<ExactBatchVerifiedResult>;
+/** START contains unchanged bytes from the normal public or signed builder. */
+export declare function exactBatchStartFrame(requestBytes: Uint8Array): ExactBatchFrame;
+/**
+ * Preserve real per-KA progress even if Core's final physical close rejects
+ * after consume reached BATCH_END. No fallback can run inside this boundary.
+ */
+export declare function exchangeExactBatchVerified(exchange: (consume: (session: ExactBatchAgentSession) => Promise<ExactBatchVerifiedResult>) => Promise<ExactBatchVerifiedResult>, options: ExactBatchVerifiedReceiverOptions): Promise<ExactBatchVerifiedResult>;
+//# sourceMappingURL=exact-batch-stream.d.ts.map

package/dist/sync/requester/exact-batch-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exact-batch-stream.d.ts","sourceRoot":"","sources":["../../../src/sync/requester/exact-batch-stream.ts"],"names":[],"mappings":"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"}