@origintrail-official/dkg-agent 10.0.19 → 10.0.21

package/dist/sync/wire-compression.d.ts

@@ -0,0 +1,47 @@
+export declare const EXACT_SYNC_GZIP_ENCODING: "gzip-nquads-v1";
+export declare const EXACT_SYNC_GZIP_MAX_COMPRESSED_BYTES: number;
+export declare const EXACT_SYNC_GZIP_MAX_INFLATED_BYTES: number;
+export declare const EXACT_SYNC_GZIP_MAX_ROWS = 100000;
+export declare const EXACT_SYNC_GZIP_MAX_HEAP_BYTES_ESTIMATE: number;
+declare const EXACT_SYNC_GZIP_PROFILE: Readonly<{
+    responseEncoding: "gzip-nquads-v1";
+    maxCompressedBytes: number;
+    maxInflatedBytes: number;
+    maxRows: 100000;
+    maxHeapBytesEstimate: number;
+}>;
+export type ExactSyncGzipProfile = typeof EXACT_SYNC_GZIP_PROFILE;
+type CompressionRequest = Readonly<{
+    responseEncoding?: unknown;
+    assetUals?: readonly string[];
+    includeSharedMemory?: boolean;
+    phase?: string;
+}>;
+export declare function normalizeExactSyncResponseEncoding(value: unknown): typeof EXACT_SYNC_GZIP_ENCODING | undefined;
+/** Encoding is response shaping only; it never establishes read authority. */
+export declare function negotiatesExactSyncGzip(request: CompressionRequest): boolean;
+/** One negotiated encoding decision and its fixed resource ceilings. */
+export declare function resolveExactSyncGzipProfile(request: CompressionRequest): typeof EXACT_SYNC_GZIP_PROFILE | undefined;
+export declare function isExactSyncGzipFrame(bytes: Uint8Array): boolean;
+/** Compress unchanged N-Quads only for a requesting, already-authorized exact peer. */
+export declare function encodeNegotiatedExactSyncResponse(bytes: Uint8Array, options: {
+    readonly request: CompressionRequest;
+    readonly signal?: AbortSignal;
+}): Promise<Uint8Array>;
+/** Encode with the request profile already chosen by the authenticated responder. */
+export declare function encodeResolvedExactSyncResponse(bytes: Uint8Array, options: {
+    readonly profile: ExactSyncGzipProfile | undefined;
+    readonly signal?: AbortSignal;
+}): Promise<Uint8Array>;
+/** A recognized malformed/compression-bomb frame never falls back to plaintext. */
+export declare function decodeNegotiatedExactSyncResponse(bytes: Uint8Array, options: {
+    readonly allowCompression: boolean;
+    readonly signal?: AbortSignal;
+    readonly maxInflatedBytes?: number;
+}): Promise<Readonly<{
+    bytes: Uint8Array;
+    compressed: boolean;
+    rows?: number;
+}>>;
+export {};
+//# sourceMappingURL=wire-compression.d.ts.map

package/dist/sync/wire-compression.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-compression.d.ts","sourceRoot":"","sources":["../../src/sync/wire-compression.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,wBAAwB,EAAG,gBAAyB,CAAC;AAClE,eAAO,MAAM,oCAAoC,QAAkB,CAAC;AACpE,eAAO,MAAM,kCAAkC,QAAmB,CAAC;AACnE,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAChD,eAAO,MAAM,uCAAuC,QAAmB,CAAC;AACxE,QAAA,MAAM,uBAAuB;;;;;;EAM3B,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,uBAAuB,CAAC;AAIlE,KAAK,kBAAkB,GAAG,QAAQ,CAAC;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7F,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AACnD,wBAAgB,kCAAkC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,wBAAwB,GAAG,SAAS,CAE9G;AACD,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAG5E;AACD,wEAAwE;AACxE,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,uBAAuB,GAAG,SAAS,CAEnH;AACD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE/D;AAMD,uFAAuF;AACvF,wBAAsB,iCAAiC,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;IAClF,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CACrE,GAAG,OAAO,CAAC,UAAU,CAAC,CAItB;AAED,qFAAqF;AACrF,wBAAsB,+BAA+B,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;IAChF,QAAQ,CAAC,OAAO,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CACnF,GAAG,OAAO,CAAC,UAAU,CAAC,CAuBtB;AAED,mFAAmF;AACnF,wBAAsB,iCAAiC,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE;IAClF,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACvG,GAAG,OAAO,CAAC,QAAQ,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,UAAU,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAuB/E"}

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":"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"}

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-publish-snapshot-preflight.d.ts

@@ -0,0 +1,13 @@
+import { type Logger } from '@origintrail-official/dkg-core';
+import { type TripleStore } from '@origintrail-official/dkg-storage';
+import { type KnowledgeAssetVmPublishRequest, type WorkspacePublicSnapshotStore } from '@origintrail-official/dkg-publisher';
+interface SnapshotPreflightDependencies {
+    store: TripleStore;
+    publicSnapshotStore?: WorkspacePublicSnapshotStore;
+    log: Pick<Logger, 'warn' | 'debug'>;
+    request: KnowledgeAssetVmPublishRequest;
+}
+/** Verify the immutable share before any VM publish job is admitted. */
+export declare function preflightKnowledgeAssetVmPublishSnapshot(input: SnapshotPreflightDependencies): Promise<void>;
+export {};
+//# sourceMappingURL=vm-publish-snapshot-preflight.d.ts.map

package/dist/vm-publish-snapshot-preflight.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-publish-snapshot-preflight.d.ts","sourceRoot":"","sources":["../src/vm-publish-snapshot-preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,MAAM,EACZ,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAKL,KAAK,8BAA8B,EACnC,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAC;AAE7C,UAAU,6BAA6B;IACrC,KAAK,EAAE,WAAW,CAAC;IACnB,mBAAmB,CAAC,EAAE,4BAA4B,CAAC;IACnD,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC;IACpC,OAAO,EAAE,8BAA8B,CAAC;CACzC;AAED,wEAAwE;AACxE,wBAAsB,wCAAwC,CAC5D,KAAK,EAAE,6BAA6B,GACnC,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/vm-publish-snapshot-preflight.js

@@ -0,0 +1,94 @@
+import { LegacyKnowledgeAssetReadOnlyError, createOperationContext, } from '@origintrail-official/dkg-core';
+import { GraphManager, isStoreOperationTimeoutError, isStoreSchedulerBusyError, } from '@origintrail-official/dkg-storage';
+import { createKnowledgeAssetVmPublishSnapshotMetadata, createKnowledgeAssetVmPublishSnapshotRequest, resolveLiftWorkspaceSlice, validateLiftPublishPayload, } from '@origintrail-official/dkg-publisher';
+/** Verify the immutable share before any VM publish job is admitted. */
+export async function preflightKnowledgeAssetVmPublishSnapshot(input) {
+    const { store, publicSnapshotStore, request } = input;
+    const startedAt = performance.now();
+    const snapshot = createKnowledgeAssetVmPublishSnapshotRequest(request);
+    const snapshotMetadata = createKnowledgeAssetVmPublishSnapshotMetadata(request);
+    try {
+        const resolved = await resolveLiftWorkspaceSlice({
+            store,
+            graphManager: new GraphManager(store),
+            request: snapshot,
+            publicSnapshotStore,
+        });
+        validateLiftPublishPayload({ request: snapshot, metadata: snapshotMetadata, resolved });
+        if (resolved.quads.length === 0 && (resolved.privateQuads ?? []).length === 0) {
+            throw new Error(`No queued shared-memory snapshot quads for context graph ${request.contextGraphId} ` +
+                `share operation ${request.shareOperationId}`);
+        }
+    }
+    catch (err) {
+        const failure = classifySnapshotPreflightFailure(err);
+        recordSnapshotPreflightFailure(input, failure, performance.now() - startedAt);
+        // A failed read proves nothing about snapshot validity. Preserve the typed
+        // store failure so admission can retry the same immutable share after recovery.
+        if (failure.classification !== 'stale')
+            throw err;
+        const wrapped = new Error(`Cannot enqueue VM publish for "${request.name}" because share snapshot ` +
+            `${request.shareOperationId} is unavailable or stale. Re-share the knowledge asset before enqueueing: ` +
+            (err instanceof Error ? err.message : String(err)));
+        wrapped.code = 'PUBLISH_INTENT_STALE';
+        throw wrapped;
+    }
+}
+function classifySnapshotPreflightFailure(error) {
+    if (error instanceof LegacyKnowledgeAssetReadOnlyError) {
+        return { classification: 'legacy_read_only', code: 'LEGACY_KA_READ_ONLY' };
+    }
+    if (isStoreSchedulerBusyError(error)) {
+        return {
+            classification: 'store_busy', code: 'STORE_SCHEDULER_BUSY', outcome: 'not_started',
+            reason: error.reason, lane: error.priority,
+        };
+    }
+    if (isStoreOperationTimeoutError(error)) {
+        return {
+            classification: 'store_timeout', code: 'STORE_OPERATION_TIMEOUT',
+            outcome: error.outcome ?? 'indeterminate',
+        };
+    }
+    return { classification: 'stale', code: 'PUBLISH_INTENT_STALE' };
+}
+const PRESSURE_FIELDS = [
+    'ackInflight', 'healthInflight', 'normalInflight', 'backgroundInflight',
+    'ackQueued', 'healthQueued', 'normalQueued', 'backgroundQueued',
+    'maxConcurrent', 'ackReservedSlots', 'normalReservedSlots',
+    'healthReservedSlots', 'backgroundReservedSlots',
+];
+/** Payload-free, best-effort attribution for the read-only admission boundary. */
+function recordSnapshotPreflightFailure(input, failure, elapsedMs) {
+    try {
+        const diagnostic = {
+            event: 'vm_publish_snapshot_preflight_rejected',
+            phase: 'snapshot_preflight',
+            ...failure,
+            ...(Number.isFinite(elapsedMs) && elapsedMs >= 0
+                ? { elapsedMs: Math.round(elapsedMs) } : {}),
+        };
+        const snapshot = input.store.getPressureSnapshot?.();
+        if (snapshot) {
+            const pressure = {};
+            for (const field of PRESSURE_FIELDS) {
+                const value = snapshot[field];
+                if (typeof value === 'number' && Number.isFinite(value) && value >= 0) {
+                    pressure[field] = value;
+                }
+            }
+            diagnostic.pressure = pressure;
+        }
+        const ctx = createOperationContext('publishFromSWM');
+        if (failure.classification === 'store_busy' || failure.classification === 'store_timeout') {
+            input.log.warn(ctx, JSON.stringify(diagnostic));
+        }
+        else {
+            input.log.debug(ctx, JSON.stringify(diagnostic));
+        }
+    }
+    catch {
+        // Pressure providers and logger sinks must never change the admission error.
+    }
+}
+//# sourceMappingURL=vm-publish-snapshot-preflight.js.map

package/dist/vm-publish-snapshot-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vm-publish-snapshot-preflight.js","sourceRoot":"","sources":["../src/vm-publish-snapshot-preflight.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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"}