@origintrail-official/dkg-agent 10.0.20 → 10.0.21

package/dist/sync/wire-compression.js

@@ -0,0 +1,111 @@
+// SPDX-License-Identifier: Apache-2.0
+import { gzipBounded, gunzipBounded } from '@origintrail-official/dkg-core';
+export const EXACT_SYNC_GZIP_ENCODING = 'gzip-nquads-v1';
+export const EXACT_SYNC_GZIP_MAX_COMPRESSED_BYTES = 4 * 1024 * 1024;
+export const EXACT_SYNC_GZIP_MAX_INFLATED_BYTES = 16 * 1024 * 1024;
+export const EXACT_SYNC_GZIP_MAX_ROWS = 100_000;
+export const EXACT_SYNC_GZIP_MAX_HEAP_BYTES_ESTIMATE = 32 * 1024 * 1024;
+const EXACT_SYNC_GZIP_PROFILE = Object.freeze({
+    responseEncoding: EXACT_SYNC_GZIP_ENCODING,
+    maxCompressedBytes: EXACT_SYNC_GZIP_MAX_COMPRESSED_BYTES,
+    maxInflatedBytes: EXACT_SYNC_GZIP_MAX_INFLATED_BYTES,
+    maxRows: EXACT_SYNC_GZIP_MAX_ROWS,
+    maxHeapBytesEstimate: EXACT_SYNC_GZIP_MAX_HEAP_BYTES_ESTIMATE,
+});
+const MAGIC = new TextEncoder().encode('DKGZQ01\n');
+const HEADER_BYTES = 20;
+const CODEC_TIMEOUT_MS = 5_000;
+export function normalizeExactSyncResponseEncoding(value) {
+    return value === EXACT_SYNC_GZIP_ENCODING ? EXACT_SYNC_GZIP_ENCODING : undefined;
+}
+/** Encoding is response shaping only; it never establishes read authority. */
+export function negotiatesExactSyncGzip(request) {
+    return request.responseEncoding === EXACT_SYNC_GZIP_ENCODING && request.includeSharedMemory !== true
+        && (request.phase === 'data' || request.phase === 'meta') && request.assetUals?.length === 1;
+}
+/** One negotiated encoding decision and its fixed resource ceilings. */
+export function resolveExactSyncGzipProfile(request) {
+    return negotiatesExactSyncGzip(request) ? EXACT_SYNC_GZIP_PROFILE : undefined;
+}
+export function isExactSyncGzipFrame(bytes) {
+    return bytes.byteLength >= MAGIC.length && MAGIC.every((byte, index) => bytes[index] === byte);
+}
+function lines(bytes) {
+    let count = 0;
+    for (const byte of bytes)
+        if (byte === 10)
+            count++;
+    return count + (bytes.byteLength > 0 && bytes.at(-1) !== 10 ? 1 : 0);
+}
+/** Compress unchanged N-Quads only for a requesting, already-authorized exact peer. */
+export async function encodeNegotiatedExactSyncResponse(bytes, options) {
+    return encodeResolvedExactSyncResponse(bytes, {
+        profile: resolveExactSyncGzipProfile(options.request), signal: options.signal,
+    });
+}
+/** Encode with the request profile already chosen by the authenticated responder. */
+export async function encodeResolvedExactSyncResponse(bytes, options) {
+    options.signal?.throwIfAborted();
+    const profile = options.profile;
+    if (!profile || bytes.byteLength === 0)
+        return bytes;
+    if (bytes.byteLength > profile.maxInflatedBytes || lines(bytes) > profile.maxRows) {
+        throw new RangeError('Exact sync decoded page exceeds bounded transport profile');
+    }
+    let compressed;
+    try {
+        compressed = await gzipBounded(bytes, { maxInputBytes: profile.maxInflatedBytes,
+            maxOutputBytes: profile.maxCompressedBytes - HEADER_BYTES, timeoutMs: CODEC_TIMEOUT_MS, signal: options.signal });
+    }
+    catch (error) {
+        options.signal?.throwIfAborted();
+        // The responder can use its existing plain path only within that path's
+        // four-MiB body cap. Larger codec refusal is an error, never a partial EOF.
+        if (bytes.byteLength <= profile.maxCompressedBytes)
+            return bytes;
+        throw error;
+    }
+    if (compressed.byteLength + HEADER_BYTES >= bytes.byteLength && bytes.byteLength <= profile.maxCompressedBytes)
+        return bytes;
+    const frame = new Uint8Array(HEADER_BYTES + compressed.byteLength);
+    frame.set(MAGIC);
+    const view = new DataView(frame.buffer);
+    view.setUint32(8, bytes.byteLength);
+    view.setUint32(12, lines(bytes));
+    view.setUint32(16, compressed.byteLength);
+    frame.set(compressed, HEADER_BYTES);
+    return frame;
+}
+/** A recognized malformed/compression-bomb frame never falls back to plaintext. */
+export async function decodeNegotiatedExactSyncResponse(bytes, options) {
+    options.signal?.throwIfAborted();
+    const maxInflated = Math.min(options.maxInflatedBytes ?? EXACT_SYNC_GZIP_MAX_INFLATED_BYTES, EXACT_SYNC_GZIP_MAX_INFLATED_BYTES);
+    if (!Number.isSafeInteger(maxInflated) || maxInflated < 0)
+        throw new TypeError('Invalid exact sync inflate allowance');
+    if (!isExactSyncGzipFrame(bytes)) {
+        if (options.allowCompression && bytes.byteLength > EXACT_SYNC_GZIP_MAX_COMPRESSED_BYTES)
+            throw new RangeError('Exact sync plaintext frame exceeds physical wire allowance');
+        if (options.allowCompression && bytes.byteLength > maxInflated)
+            throw new RangeError('Exact sync decoded phase exceeds remaining allowance');
+        const rows = options.allowCompression ? lines(bytes) : undefined;
+        if (rows !== undefined && rows > EXACT_SYNC_GZIP_MAX_ROWS)
+            throw new RangeError('Exact sync decoded page exceeds row allowance');
+        return Object.freeze({ bytes, compressed: false, ...(rows === undefined ? {} : { rows }) });
+    }
+    if (!options.allowCompression || bytes.byteLength < HEADER_BYTES || bytes.byteLength > EXACT_SYNC_GZIP_MAX_COMPRESSED_BYTES) {
+        throw new Error('Unnegotiated or oversized exact sync gzip frame');
+    }
+    const view = new DataView(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    const inflatedLength = view.getUint32(8), rowCount = view.getUint32(12), compressedLength = view.getUint32(16);
+    if (inflatedLength < 1 || inflatedLength > maxInflated || rowCount < 1 || rowCount > EXACT_SYNC_GZIP_MAX_ROWS
+        || compressedLength < 18 || compressedLength !== bytes.byteLength - HEADER_BYTES)
+        throw new Error('Invalid exact sync gzip lengths or rows');
+    const inflated = await gunzipBounded(bytes.subarray(HEADER_BYTES), { maxInputBytes: EXACT_SYNC_GZIP_MAX_COMPRESSED_BYTES,
+        maxOutputBytes: inflatedLength, maxOutputLines: rowCount, timeoutMs: CODEC_TIMEOUT_MS, signal: options.signal });
+    if (inflated.byteLength !== inflatedLength || lines(inflated) !== rowCount)
+        throw new Error('Exact sync gzip declared length/row mismatch');
+    new TextDecoder('utf-8', { fatal: true }).decode(inflated);
+    options.signal?.throwIfAborted();
+    return Object.freeze({ bytes: inflated, compressed: true, rows: rowCount });
+}
+//# sourceMappingURL=wire-compression.js.map

package/dist/sync/wire-compression.js.map

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

package/dist/unscoped-query-consistency.d.ts

@@ -1,3 +1,15 @@
+/**
+ * A local write or a read-authority change landed inside the interval an
+ * unscoped query has to hold unchanged, so its result was withheld. The request
+ * is sound and the same query can succeed once that change has settled. The
+ * code and the sentence are the dkg-core contract the daemon answers with; the
+ * class itself stays out of the public agent surface.
+ */
+export declare class UnscopedQueryInvalidatedError extends Error {
+    readonly code = "UNSCOPED_QUERY_INVALIDATED";
+    readonly retryable = true;
+    constructor();
+}
 /**
  * Own result release across one unchanged local dataset/metadata interval.
  * Chain authorization retains the admission-time semantics of scoped reads;

package/dist/unscoped-query-consistency.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"unscoped-query-consistency.d.ts","sourceRoot":"","sources":["../src/unscoped-query-consistency.ts"],"names":[],"mappings":"AAWA;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,oBAAoB,IAAI,MAAM,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,IAAI,CAAC,CAAC;CACb,GAAG,OAAO,CAAC,CAAC,CAAC,CAOb;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,oBAAoB,EAAE,MAAM,MAAM,GACjC,MAAM,IAAI,CAkBZ"}
+{"version":3,"file":"unscoped-query-consistency.d.ts","sourceRoot":"","sources":["../src/unscoped-query-consistency.ts"],"names":[],"mappings":"AAYA;;;;;;GAMG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD,QAAQ,CAAC,IAAI,gCAAmC;IAChD,QAAQ,CAAC,SAAS,QAAQ;;CAM3B;AAID;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAAE,IAAI,EAAE;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,oBAAoB,IAAI,MAAM,CAAC;IAC/B,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1B,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACtB,MAAM,IAAI,CAAC,CAAC;CACb,GAAG,OAAO,CAAC,CAAC,CAAC,CAOb;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,OAAO,EACd,oBAAoB,EAAE,MAAM,MAAM,GACjC,MAAM,IAAI,CAkBZ"}

package/dist/unscoped-query-consistency.js

@@ -1,7 +1,23 @@
 // SPDX-License-Identifier: Apache-2.0
+import { UNSCOPED_QUERY_INVALIDATED_CODE, UNSCOPED_QUERY_INVALIDATED_MESSAGE, } from '@origintrail-official/dkg-core';
 import { asGraphWriteRevisionSource } from '@origintrail-official/dkg-storage';
 const unsupported = () => new Error('Unscoped query requires a store with all-writer consistency coverage; specify contextGraphId to scope the query');
-const invalidated = () => new Error('Unscoped query dataset or read authority changed; retry the query or specify contextGraphId');
+/**
+ * A local write or a read-authority change landed inside the interval an
+ * unscoped query has to hold unchanged, so its result was withheld. The request
+ * is sound and the same query can succeed once that change has settled. The
+ * code and the sentence are the dkg-core contract the daemon answers with; the
+ * class itself stays out of the public agent surface.
+ */
+export class UnscopedQueryInvalidatedError extends Error {
+    code = UNSCOPED_QUERY_INVALIDATED_CODE;
+    retryable = true;
+    constructor() {
+        super(UNSCOPED_QUERY_INVALIDATED_MESSAGE);
+        this.name = 'UnscopedQueryInvalidatedError';
+    }
+}
+const invalidated = () => new UnscopedQueryInvalidatedError();
 /**
  * Own result release across one unchanged local dataset/metadata interval.
  * Chain authorization retains the admission-time semantics of scoped reads;

package/dist/unscoped-query-consistency.js.map

@@ -1 +1 @@
-{"version":3,"file":"unscoped-query-consistency.js","sourceRoot":"","sources":["../src/unscoped-query-consistency.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,KAAK,CACjC,iHAAiH,CAClH,CAAC;AACF,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,KAAK,CACjC,6FAA6F,CAC9F,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,IAM7C;IACC,MAAM,eAAe,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/F,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IAChD,eAAe,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,eAAe,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAAc,EACd,oBAAkC;IAElC,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,MAAM,EAAE,qBAAqB,KAAK,aAAa;QAAE,MAAM,WAAW,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,WAAW,EAAE,CAAC;IACvG,MAAM,gBAAgB,GAAG,oBAAoB,EAAE,CAAC;IAEhD,OAAO,GAAG,EAAE;QACV,MAAM,aAAa,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,aAAa,EAAE,qBAAqB,KAAK,aAAa;YAAE,MAAM,WAAW,EAAE,CAAC;QAChF,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACnD,IACE,OAAO,CAAC,MAAM,KAAK,IAAI;eACpB,OAAO,CAAC,UAAU,KAAK,UAAU;eACjC,oBAAoB,EAAE,KAAK,gBAAgB;YAC9C,MAAM,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"unscoped-query-consistency.js","sourceRoot":"","sources":["../src/unscoped-query-consistency.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,EACL,+BAA+B,EAC/B,kCAAkC,GACnC,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAE/E,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,KAAK,CACjC,iHAAiH,CAClH,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IAC7C,IAAI,GAAG,+BAA+B,CAAC;IACvC,SAAS,GAAG,IAAI,CAAC;IAE1B;QACE,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,6BAA6B,EAAE,CAAC;AAE9D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,IAM7C;IACC,MAAM,eAAe,GAAG,+BAA+B,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC/F,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;IAChD,eAAe,EAAE,CAAC;IAClB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,eAAe,EAAE,CAAC;IAClB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,+BAA+B,CAC7C,KAAc,EACd,oBAAkC;IAElC,MAAM,MAAM,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;IACjD,IAAI,MAAM,EAAE,qBAAqB,KAAK,aAAa;QAAE,MAAM,WAAW,EAAE,CAAC;IACzE,MAAM,MAAM,GAAG,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC;QAAE,MAAM,WAAW,EAAE,CAAC;IACvG,MAAM,gBAAgB,GAAG,oBAAoB,EAAE,CAAC;IAEhD,OAAO,GAAG,EAAE;QACV,MAAM,aAAa,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC;QACxD,IAAI,aAAa,EAAE,qBAAqB,KAAK,aAAa;YAAE,MAAM,WAAW,EAAE,CAAC;QAChF,MAAM,OAAO,GAAG,aAAa,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACnD,IACE,OAAO,CAAC,MAAM,KAAK,IAAI;eACpB,OAAO,CAAC,UAAU,KAAK,UAAU;eACjC,oBAAoB,EAAE,KAAK,gBAAgB;YAC9C,MAAM,WAAW,EAAE,CAAC;IACxB,CAAC,CAAC;AACJ,CAAC"}

package/dist/vm-promotion-audit.d.ts

@@ -77,8 +77,8 @@ export declare function storageAckPendingUpdatesQuery(input: Readonly<{
 export declare function storageAckAssetSubGraphsQuery(namespace: string, kaUal: string): string;
 /** Sub-graphs of one namespace that hold ledgered copies. */
 export declare function storageAckNamespaceSubGraphsQuery(namespace: string, limit: number): string;
-/** Whether the namespace's VM holds the asset at `version` or later. */
-export declare function storageAckPromotedQuery(namespace: string, kaUal: string, version: bigint): string;
+/** Check one already-bounded audit slice across its exact VM metadata graphs. */
+export declare function storageAckPromotedBatchQuery(candidates: readonly Pick<StorageAckLedgerCandidate, 'operationSubject' | 'namespace' | 'kaUal' | 'assertionVersion'>[]): string;
 /** Ledger rows whose ACK copy no longer exists (retired or expired). */
 export declare function storageAckLedgerOrphansQuery(limit: number): string;
 /**

package/dist/vm-promotion-audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vm-promotion-audit.d.ts","sourceRoot":"","sources":["../src/vm-promotion-audit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vm-promotion-audit.d.ts","sourceRoot":"","sources":["../src/vm-promotion-audit.ts"],"names":[],"mappings":"AA6BA,mEAAmE;AACnE,MAAM,WAAW,sBAAsB;IACrC,0EAA0E;IAC1E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4EAA4E;IAC5E,WAAW,EAAE,OAAO,CAAC;IACrB,sEAAsE;IACtE,uBAAuB,EAAE,MAAM,CAAC;IAChC,0EAA0E;IAC1E,gBAAgB,EAAE,OAAO,CAAC;IAC1B,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,eAAe,EAAE,MAAM,CAAC;IACxB,sEAAsE;IACtE,gBAAgB,EAAE,MAAM,CAAC;IACzB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,qEAAqE;IACrE,yBAAyB,EAAE,MAAM,CAAC;IAClC,8EAA8E;IAC9E,gBAAgB,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,4BAA4B,IAAI,sBAAsB,CAoBrE;AAED,mDAAmD;AACnD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,mFAAmF;AACnF,wBAAgB,0BAA0B,IAAI,MAAM,CAMnD;AAQD,kEAAkE;AAClE,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKpF;AAED,+DAA+D;AAC/D,wBAAgB,+BAA+B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,GAAG,MAAM,CAgBV;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,QAAQ,CAAC;IAC5D,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,GAAG,MAAM,CAiBV;AAED,wEAAwE;AACxE,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtF;AAED,6DAA6D;AAC7D,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED,iFAAiF;AACjF,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,IAAI,CACpE,yBAAyB,EAAE,kBAAkB,GAAG,WAAW,GAAG,OAAO,GAAG,kBAAkB,CAC3F,EAAE,GAAG,MAAM,CAsBX;AAED,wEAAwE;AACxE,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,IAAI,MAAM,CAM5D;AAED,wBAAgB,8BAA8B,CAC5C,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,GAChD,yBAAyB,GAAG,IAAI,CAkClC;AAED,qEAAqE;AACrE,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOlE;AAED,8DAA8D;AAC9D,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGlD"}

package/dist/vm-promotion-audit.js

@@ -8,7 +8,7 @@
  * paged): no COUNT or GROUP BY, which Blazegraph mis-evaluates over
  * multi-graph patterns.
  */
-import { contextGraphMetaUri, createGraphKnowledgeAssetScope, isSafeIri, sparqlString, validateSubGraphName, } from '@origintrail-official/dkg-core';
+import { contextGraphMetaUri, createGraphKnowledgeAssetScope, assertSafeIri, isSafeIri, sparqlString, validateSubGraphName, } from '@origintrail-official/dkg-core';
 import { STORAGE_ACK_LEDGER_GRAPH, STORAGE_ACK_LEDGER_PREDICATES as LEDGER, } from '@origintrail-official/dkg-publisher';
 const DKG = 'http://dkg.io/ontology/';
 const XSD_DATE_TIME = 'http://www.w3.org/2001/XMLSchema#dateTime';
@@ -120,13 +120,30 @@ export function storageAckNamespaceSubGraphsQuery(namespace, limit) {
       <${LEDGER.subGraphName}> ?subGraph .
   } } ORDER BY ?subGraph LIMIT ${limit}`;
 }
-/** Whether the namespace's VM holds the asset at `version` or later. */
-export function storageAckPromotedQuery(namespace, kaUal, version) {
-    return `ASK { GRAPH <${contextGraphMetaUri(namespace)}> {
-    <${kaUal}> <${DKG}status> "confirmed" ;
-      <${DKG}assertionVersion> ?confirmedVersion .
-    FILTER(?confirmedVersion >= ${version})
-  } }`;
+/** Check one already-bounded audit slice across its exact VM metadata graphs. */
+export function storageAckPromotedBatchQuery(candidates) {
+    if (candidates.length === 0)
+        throw new Error('Promoted-copy batch must not be empty');
+    const values = candidates.map((candidate) => {
+        if (typeof candidate.assertionVersion !== 'bigint' || candidate.assertionVersion < 0n) {
+            throw new Error('Promoted-copy batch requires a non-negative assertion version');
+        }
+        return `(<${assertSafeIri(candidate.operationSubject)}> `
+            + `<${assertSafeIri(contextGraphMetaUri(candidate.namespace))}> `
+            + `<${assertSafeIri(candidate.kaUal)}> ${candidate.assertionVersion})`;
+    }).join('\n      ');
+    // Keep the filter outside GRAPH: Oxigraph does not see the VALUES-bound
+    // minimum inside the graph pattern, even though it sees the graph's version.
+    return `SELECT DISTINCT ?op WHERE {
+    VALUES (?op ?graph ?ka ?minVersion) {
+      ${values}
+    }
+    GRAPH ?graph {
+      ?ka <${DKG}status> "confirmed" ;
+        <${DKG}assertionVersion> ?confirmedVersion .
+    }
+    FILTER(?confirmedVersion >= ?minVersion)
+  }`;
 }
 /** Ledger rows whose ACK copy no longer exists (retired or expired). */
 export function storageAckLedgerOrphansQuery(limit) {
@@ -155,7 +172,7 @@ export function parseStorageAckLedgerCandidate(row) {
     if (!operationSubject || !namespace || !kaUal || !versionLiteral || !Number.isFinite(signedAtMs)) {
         return null;
     }
-    if (!isStorageAckNamespace(namespace) || !isSafeIri(kaUal))
+    if (!isSafeIri(operationSubject) || !isStorageAckNamespace(namespace) || !isSafeIri(kaUal))
         return null;
     let assertionVersion;
     try {

package/dist/vm-promotion-audit.js.map

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

package/dist/vm-reconcile-dispatcher.d.ts

@@ -1,10 +1,15 @@
 /** Agent-owned admission and scheduling for chain-driven VM reconciliation. */
+import { type LocalAdmissionWaitOptions } from './internal/vm-reconcile-local-admission-wait.js';
 import { type VmReconcileSource } from './vm-reconcile-service.js';
 export interface VmReconcileDispatcherOptions {
     concurrency?: number;
     maxPending?: number;
     maxForegroundBurst?: number;
 }
+export interface VmReconcileSchedulingOptions extends VmReconcileDispatcherOptions {
+    discoveryBatchSize?: number;
+    periodicBoundBatchSize?: number;
+}
 /**
  * Single admission and scheduling policy for chain-driven VM reconciliation.
  *
@@ -30,9 +35,17 @@ export declare class VmReconcileDispatcher<T> {
     private readonly concurrency;
     private readonly maxPending;
     private readonly maxForegroundBurst;
+    private timerBoundOutstanding;
+    private readonly timerBoundOutstandingLimit;
     constructor(run: (key: string, source: VmReconcileSource) => Promise<T>, onFailure: (key: string, error: unknown) => void, options?: VmReconcileDispatcherOptions);
     /** Enqueue a low-latency chain-event nudge; suppressed until a sweep after failure. */
     triggerLive(key: string): void;
+    /**
+     * A live nudge with its completion handle. Undefined in the two cases
+     * `triggerLive` drops without a trace: the nudge is held after a failed
+     * pass, or the bounded queue has no room for it.
+     */
+    protected tryDispatchLive(key: string): Promise<T> | undefined;
     /** A newly established binding is fresh evidence, so its first live nudge must not inherit an old discovery miss. */
     releaseLiveHold(key: string): void;
     /** Enqueue the reliability path; every periodic sweep gets one failure retry. */
@@ -49,6 +62,8 @@ export declare class VmReconcileDispatcher<T> {
     tryTriggerPeriodic(key: string): boolean;
     /** Periodic admission with its exact completion handle; undefined means no admission. */
     protected tryDispatchPeriodic(key: string): Promise<T> | undefined;
+    /** Count only newly admitted timer work; coalesced calls create no backlog. */
+    protected tryDispatchPeriodicBoundTimer(key: string): Promise<T> | undefined;
     protected waitForPeriodicStateChange(signal?: AbortSignal): Promise<void>;
     /** A sweep owns its capacity claim across notifications, retries, and cancellation. */
     protected retainPeriodicCapacity(signal: AbortSignal): () => void;
@@ -80,6 +95,7 @@ export declare class VmReconcileDispatcher<T> {
     private resolveKeyIdleWaiters;
     private drain;
 }
+export type { LocalAdmissionWaitOptions };
 /**
  * Cohesive host-owned runtime for foreground nudges and periodic sweep work.
  *
@@ -91,8 +107,33 @@ export declare class VmReconcileSchedulingRuntime<T> {
     private readonly dispatcher;
     private readonly planner;
     private readonly sweepAdmission;
-    constructor(run: (key: string, source: VmReconcileSource) => Promise<T>, onFailure: (key: string, error: unknown) => void, options?: VmReconcileDispatcherOptions, discoveryBatchSize?: number);
+    private readonly localAdmissionWait;
+    constructor(run: (key: string, source: VmReconcileSource) => Promise<T>, onFailure: (key: string, error: unknown) => void, options?: VmReconcileSchedulingOptions);
     triggerLive(key: string): void;
+    /**
+     * Local sync pressure earns a bounded retry, rather than peer backoff: the
+     * graph waits in arrival order and is nudged once the node's sync admission
+     * can take its fetch (see `internal/vm-reconcile-local-admission-wait.ts`).
+     * The nudge re-enters the ordinary bounded dispatcher, including
+     * foreground-burst and periodic fairness.
+     */
+    retryLocalAdmission(key: string, options: LocalAdmissionWaitOptions): void;
+    /**
+     * A graph that just used the node's sync admission and has more to fetch
+     * goes behind the graphs already waiting for it. Returns false, and parks
+     * nothing, when no other graph is waiting.
+     */
+    yieldLocalAdmissionTurn(key: string, options: LocalAdmissionWaitOptions): boolean;
+    /**
+     * A pass whose read-authority check got no answer did none of its work, so
+     * its end says nothing about the graph. The graph waits with those refused
+     * by sync admission and is asked again from there (see `defer` in
+     * `internal/vm-reconcile-local-admission-wait.ts`). The pass still ends as
+     * a failed one, so live nudges from elsewhere stay held; only the wait's own
+     * nudge lifts that hold. Undefined when the wait did not take the graph: the
+     * periodic sweep then retries it, as after any failed pass.
+     */
+    deferForReadAuthority(key: string, options: LocalAdmissionWaitOptions): 'parked' | 'again' | undefined;
     releaseLiveHold(key: string): void;
     triggerPeriodic(key: string): void;
     tryTriggerPeriodic(key: string): boolean;

package/dist/vm-reconcile-dispatcher.d.ts.map

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

package/dist/vm-reconcile-dispatcher.js

@@ -1,4 +1,5 @@
 /** Agent-owned admission and scheduling for chain-driven VM reconciliation. */
+import { VmReconcileLocalAdmissionWait, } from './internal/vm-reconcile-local-admission-wait.js';
 import { VmReconcileSweepPlanner } from './internal/vm-reconcile-sweep.js';
 import { VmReconcileQueueClosedError, VmReconcileQueueFullError, } from './vm-reconcile-service.js';
 function vmReconcileSourceRank(source) {
@@ -33,6 +34,8 @@ export class VmReconcileDispatcher {
     concurrency;
     maxPending;
     maxForegroundBurst;
+    timerBoundOutstanding = 0;
+    timerBoundOutstandingLimit;
     constructor(run, onFailure, options = {}) {
         this.run = run;
         this.onFailure = onFailure;
@@ -49,6 +52,7 @@ export class VmReconcileDispatcher {
         this.concurrency = concurrency;
         this.maxPending = maxPending;
         this.maxForegroundBurst = maxForegroundBurst;
+        this.timerBoundOutstandingLimit = 2 * concurrency;
     }
     /** Enqueue a low-latency chain-event nudge; suppressed until a sweep after failure. */
     triggerLive(key) {
@@ -56,6 +60,20 @@ export class VmReconcileDispatcher {
             return;
         void this.dispatch(key, 'live').catch(() => undefined);
     }
+    /**
+     * A live nudge with its completion handle. Undefined in the two cases
+     * `triggerLive` drops without a trace: the nudge is held after a failed
+     * pass, or the bounded queue has no room for it.
+     */
+    tryDispatchLive(key) {
+        if (this.states.get(key)?.hold === 'live-blocked')
+            return undefined;
+        const outcome = this.admit(key, 'live');
+        if (!('completion' in outcome))
+            return undefined;
+        void outcome.completion.catch(() => undefined);
+        return outcome.completion;
+    }
     /** A newly established binding is fresh evidence, so its first live nudge must not inherit an old discovery miss. */
     releaseLiveHold(key) {
         const state = this.states.get(key);
@@ -92,6 +110,24 @@ export class VmReconcileDispatcher {
         void outcome.completion.catch(() => undefined);
         return outcome.completion;
     }
+    /** Count only newly admitted timer work; coalesced calls create no backlog. */
+    tryDispatchPeriodicBoundTimer(key) {
+        if (this.timerBoundOutstanding >= this.timerBoundOutstandingLimit) {
+            const state = this.states.get(key);
+            // Pending/trailing work can coalesce without creating another task.
+            if (!state?.pending && !state?.trailing)
+                return undefined;
+        }
+        const outcome = this.admit(key, 'periodic');
+        if (!('completion' in outcome))
+            return undefined;
+        if (outcome.kind === 'admitted') {
+            this.timerBoundOutstanding += 1;
+            void outcome.completion.then(() => { this.timerBoundOutstanding -= 1; }, () => { this.timerBoundOutstanding -= 1; });
+        }
+        void outcome.completion.catch(() => undefined);
+        return outcome.completion;
+    }
     waitForPeriodicStateChange(signal) {
         return new Promise(resolve => {
             const finish = () => {
@@ -402,11 +438,16 @@ class VmReconcileRuntimeDispatcher extends VmReconcileDispatcher {
         super(run, onFailure, options);
         installSweepAdmission(Object.freeze({
             tryAdmit: (key) => this.tryDispatchPeriodic(key),
+            tryAdmitBoundTimer: (key) => this.tryDispatchPeriodicBoundTimer(key),
             waitForChange: (signal) => this.waitForPeriodicStateChange(signal),
             isClosed: () => this.closed,
             retainCapacity: (signal) => this.retainPeriodicCapacity(signal),
         }));
     }
+    /** The runtime's nudge for a graph that waited for sync admission. */
+    nudgeLive(key) {
+        return this.tryDispatchLive(key);
+    }
 }
 /**
  * Cohesive host-owned runtime for foreground nudges and periodic sweep work.
@@ -419,13 +460,66 @@ export class VmReconcileSchedulingRuntime {
     dispatcher;
     planner;
     sweepAdmission;
-    constructor(run, onFailure, options = {}, discoveryBatchSize = 8) {
+    localAdmissionWait;
+    constructor(run, onFailure, options = {}) {
         let sweepAdmission;
-        this.dispatcher = new VmReconcileRuntimeDispatcher(run, onFailure, options, (admission) => { sweepAdmission = admission; });
-        this.planner = new VmReconcileSweepPlanner(discoveryBatchSize, sweepAdmission.retainCapacity);
+        this.dispatcher = new VmReconcileRuntimeDispatcher(async (key, source) => {
+            const pass = this.localAdmissionWait.passStarted(key);
+            try {
+                return await run(key, source);
+            }
+            finally {
+                this.localAdmissionWait.passEnded(pass);
+            }
+        }, onFailure, options, (admission) => { sweepAdmission = admission; });
+        this.localAdmissionWait = new VmReconcileLocalAdmissionWait({
+            nudge: (key, deferred) => {
+                // A deferred graph's last pass ended as a failed one and left the
+                // live hold. This nudge is that pass's retry, so it lifts the hold it
+                // is about to use; nudges from elsewhere stayed held meanwhile.
+                if (deferred)
+                    this.dispatcher.releaseLiveHold(key);
+                return this.dispatcher.nudgeLive(key);
+            },
+            maxWaiters: options.maxPending ?? 256,
+        });
+        this.planner = new VmReconcileSweepPlanner({
+            discoveryBatchSize: options.discoveryBatchSize ?? 8,
+            periodicBoundBatchSize: options.periodicBoundBatchSize ?? 8,
+        }, sweepAdmission.retainCapacity);
         this.sweepAdmission = sweepAdmission;
     }
     triggerLive(key) { this.dispatcher.triggerLive(key); }
+    /**
+     * Local sync pressure earns a bounded retry, rather than peer backoff: the
+     * graph waits in arrival order and is nudged once the node's sync admission
+     * can take its fetch (see `internal/vm-reconcile-local-admission-wait.ts`).
+     * The nudge re-enters the ordinary bounded dispatcher, including
+     * foreground-burst and periodic fairness.
+     */
+    retryLocalAdmission(key, options) {
+        this.localAdmissionWait.retry(key, options);
+    }
+    /**
+     * A graph that just used the node's sync admission and has more to fetch
+     * goes behind the graphs already waiting for it. Returns false, and parks
+     * nothing, when no other graph is waiting.
+     */
+    yieldLocalAdmissionTurn(key, options) {
+        return this.localAdmissionWait.yieldTurn(key, options);
+    }
+    /**
+     * A pass whose read-authority check got no answer did none of its work, so
+     * its end says nothing about the graph. The graph waits with those refused
+     * by sync admission and is asked again from there (see `defer` in
+     * `internal/vm-reconcile-local-admission-wait.ts`). The pass still ends as
+     * a failed one, so live nudges from elsewhere stay held; only the wait's own
+     * nudge lifts that hold. Undefined when the wait did not take the graph: the
+     * periodic sweep then retries it, as after any failed pass.
+     */
+    deferForReadAuthority(key, options) {
+        return this.localAdmissionWait.defer(key, options);
+    }
     releaseLiveHold(key) { this.dispatcher.releaseLiveHold(key); }
     triggerPeriodic(key) { this.dispatcher.triggerPeriodic(key); }
     tryTriggerPeriodic(key) { return this.dispatcher.tryTriggerPeriodic(key); }
@@ -442,13 +536,18 @@ export class VmReconcileSchedulingRuntime {
     }
     waitForIdle(key) { return this.dispatcher.waitForIdle(key); }
     scheduleSweep(boundKeys, unboundKeys, isCurrent) {
-        this.planner.admit(boundKeys, unboundKeys, key => isCurrent() ? this.sweepAdmission.tryAdmit(key) : undefined);
+        this.planner.admit(boundKeys, unboundKeys, {
+            tryAdmit: key => isCurrent() ? this.sweepAdmission.tryAdmit(key) : undefined,
+            tryAdmitBoundTimer: key => isCurrent()
+                ? this.sweepAdmission.tryAdmitBoundTimer(key) : undefined,
+        });
     }
     completeSweep(boundKeys, unboundKeys, isCurrent, signal) {
         return this.planner.complete(boundKeys, unboundKeys, this.sweepAdmission, isCurrent, signal);
     }
     resetSweep() { this.planner.reset(); }
     close() {
+        this.localAdmissionWait.close();
         this.planner.reset();
         return this.dispatcher.close();
     }