@xrkseek/harness-cli 0.0.10 → 0.1.0

package/node_modules/@xrkseek/attachment-local/dist/index.js

@@ -0,0 +1,188 @@
+/**
+ * Local durable attachment backend under `{XRK_HOME}/attachments/v1`.
+ */
+import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { AttachmentError, } from "@xrkseek/attachment";
+import { CompressionLimiter } from "./compression-limiter.js";
+import { commitPreparedImageFile, prepareImageFile, readImageByAttachmentId, readImageFile, validateImageFile, } from "./store.js";
+import { readRequestImageFile, requestImageVariantId } from "./request-image.js";
+export { canPassThroughNormalization, normalizeImage } from "./normalization.js";
+export { commitPreparedImageFile, prepareImageFile, readImageFile, validateImageFile, } from "./store.js";
+export { readRequestImageFile, requestImageDimensions, requestImageVariantId, REQUEST_IMAGE_TRANSFORM_VERSION, } from "./request-image.js";
+export const DEFAULT_MAX_IMAGE_BYTES = 20 * 1024 * 1024;
+export const DEFAULT_MAX_IMAGES_PER_MESSAGE = 20;
+export const DEFAULT_MAX_MESSAGE_IMAGE_BYTES = 200 * 1024 * 1024;
+export const DEFAULT_MAX_IMAGE_PIXELS = 64_000_000;
+export const DEFAULT_MAX_IMAGE_DIMENSION = 8192;
+export const DEFAULT_NORMALIZED_IMAGE_MAX_DIMENSION = 2048;
+export const DEFAULT_NORMALIZED_IMAGE_MAX_BYTES = 4 * 1024 * 1024;
+export const DEFAULT_IMAGE_COMPRESSION_CONCURRENCY = 2;
+export const MAX_IMAGE_COMPRESSION_CONCURRENCY = 8;
+function resolveAttachmentsRoot(xrkHome) {
+    const home = xrkHome?.trim() ||
+        process.env.XRK_HOME?.trim() ||
+        join(homedir(), ".xrk");
+    return resolve(join(home, "attachments", "v1"));
+}
+class SharedRequest {
+    controller = new AbortController();
+    promise;
+    settled = false;
+    waiters = 0;
+    constructor(start) {
+        this.promise = start(this.controller.signal).finally(() => {
+            this.settled = true;
+        });
+    }
+    wait(signal) {
+        signal?.throwIfAborted();
+        this.waiters += 1;
+        if (signal === undefined) {
+            return this.promise.finally(() => {
+                this.release(false);
+            });
+        }
+        let released = false;
+        const release = (cancelled) => {
+            if (released)
+                return;
+            released = true;
+            this.release(cancelled, signal);
+        };
+        return new Promise((resolve, reject) => {
+            const abort = () => {
+                release(true);
+                const reason = signal.reason;
+                reject(reason instanceof Error
+                    ? reason
+                    : new Error("Attachment request cancelled.", { cause: reason }));
+            };
+            signal.addEventListener("abort", abort, { once: true });
+            void this.promise.then((value) => {
+                signal.removeEventListener("abort", abort);
+                release(false);
+                resolve(value);
+            }, (error) => {
+                signal.removeEventListener("abort", abort);
+                release(false);
+                reject(error instanceof Error
+                    ? error
+                    : new Error(String(error), { cause: error }));
+            });
+        });
+    }
+    release(cancelled, signal) {
+        this.waiters -= 1;
+        if (cancelled &&
+            this.waiters === 0 &&
+            !this.settled &&
+            signal !== undefined) {
+            const reason = signal.reason;
+            this.controller.abort(reason instanceof Error
+                ? reason
+                : new Error(String(reason), { cause: reason }));
+        }
+    }
+}
+/**
+ * Disk-backed attachment store with sharp normalization + request-image cache.
+ */
+export function createLocalAttachmentStore(options = {}) {
+    const root = resolveAttachmentsRoot(options.xrkHome);
+    const imageLimits = {
+        maxImageBytes: options.maxImageBytes ?? DEFAULT_MAX_IMAGE_BYTES,
+        maxImagesPerMessage: options.maxImagesPerMessage ?? DEFAULT_MAX_IMAGES_PER_MESSAGE,
+        maxMessageImageBytes: options.maxMessageImageBytes ?? DEFAULT_MAX_MESSAGE_IMAGE_BYTES,
+        maxImagePixels: options.maxImagePixels ?? DEFAULT_MAX_IMAGE_PIXELS,
+        maxImageDimension: options.maxImageDimension ?? DEFAULT_MAX_IMAGE_DIMENSION,
+        mediaTypes: [
+            "image/png",
+            "image/jpeg",
+            "image/webp",
+            "image/gif",
+        ],
+    };
+    const normalizationPolicy = {
+        maxDimension: options.normalizedImageMaxDimension ??
+            DEFAULT_NORMALIZED_IMAGE_MAX_DIMENSION,
+        maxBytes: options.normalizedImageMaxBytes ?? DEFAULT_NORMALIZED_IMAGE_MAX_BYTES,
+    };
+    const compressionConcurrency = options.imageCompressionConcurrency ?? DEFAULT_IMAGE_COMPRESSION_CONCURRENCY;
+    if (!Number.isSafeInteger(compressionConcurrency) ||
+        compressionConcurrency < 1 ||
+        compressionConcurrency > MAX_IMAGE_COMPRESSION_CONCURRENCY) {
+        throw new Error(`attachment-local: imageCompressionConcurrency must be 1..${MAX_IMAGE_COMPRESSION_CONCURRENCY}`);
+    }
+    const compression = new CompressionLimiter(compressionConcurrency);
+    const requestInflight = new Map();
+    function validateImageBatch(inputs) {
+        if (inputs.length > imageLimits.maxImagesPerMessage) {
+            throw new AttachmentError("Image batch exceeds the configured image-count limit.", "TOO_MANY_IMAGES");
+        }
+        const totalBytes = inputs.reduce((sum, input) => sum + input.data.byteLength, 0);
+        if (totalBytes > imageLimits.maxMessageImageBytes) {
+            throw new AttachmentError("Image batch exceeds the configured aggregate image-byte limit.", "IMAGES_TOO_LARGE");
+        }
+        for (const input of inputs) {
+            if (!imageLimits.mediaTypes.includes(input.mediaType)) {
+                throw new AttachmentError(`Image type ${input.mediaType} is not accepted.`, "UNSUPPORTED_IMAGE_TYPE");
+            }
+        }
+    }
+    async function readImageById(attachmentId, signal) {
+        try {
+            return await readImageByAttachmentId(root, attachmentId, signal);
+        }
+        catch (err) {
+            if (err instanceof AttachmentError &&
+                err.code === "ATTACHMENT_NOT_FOUND") {
+                throw new AttachmentError(`Attachment not found: ${attachmentId}`, "NOT_FOUND");
+            }
+            throw err;
+        }
+    }
+    return {
+        imageLimits,
+        async validateImage(input) {
+            await compression.run(() => validateImageFile(input, imageLimits, normalizationPolicy));
+        },
+        async saveImages(inputs) {
+            validateImageBatch(inputs);
+            const prepared = await Promise.all(inputs.map((input) => compression.run(() => prepareImageFile(input, imageLimits, normalizationPolicy))));
+            const refs = [];
+            for (const image of prepared) {
+                refs.push(await commitPreparedImageFile(root, image));
+            }
+            return refs;
+        },
+        async saveImage(input) {
+            const prepared = await compression.run(() => prepareImageFile(input, imageLimits, normalizationPolicy));
+            return commitPreparedImageFile(root, prepared);
+        },
+        readImage: readImageById,
+        async readImageRequest(ref, policy, signal) {
+            signal?.throwIfAborted();
+            const variantId = requestImageVariantId(ref, policy);
+            const key = variantId;
+            let operation = requestInflight.get(key);
+            if (operation?.controller.signal.aborted) {
+                requestInflight.delete(key);
+                operation = undefined;
+            }
+            if (operation === undefined) {
+                const shared = new SharedRequest((sharedSignal) => compression.run(async () => readRequestImageFile(root, await readImageFile(root, ref, sharedSignal), policy, sharedSignal)));
+                operation = shared;
+                requestInflight.set(key, shared);
+                void shared.promise
+                    .finally(() => {
+                    if (requestInflight.get(key) === shared)
+                        requestInflight.delete(key);
+                })
+                    .catch(() => { });
+            }
+            return operation.wait(signal);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/node_modules/@xrkseek/attachment-local/dist/index.js.map

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

package/node_modules/@xrkseek/attachment-local/dist/normalization.d.ts

@@ -0,0 +1,44 @@
+/** Deterministic provider-independent image normalization. */
+import { type Sharp } from 'sharp';
+import type { ImageMediaType } from '@xrkseek/attachment';
+import type { DetectedImage } from './image.js';
+/** Deployment-resolved policy for the persisted normalized attachment. */
+export interface NormalizationPolicy {
+    /** Long-edge cap in pixels; larger sources are downscaled proportionally. */
+    maxDimension: number;
+    /** Independent safety cap for encoded normalized image bytes. */
+    maxBytes: number;
+}
+/** Normalized bytes beside the facts recorded by a durable reference. */
+export interface NormalizedImage {
+    data: Uint8Array;
+    mediaType: ImageMediaType;
+    width: number;
+    height: number;
+}
+/**
+ * Whether bytes already satisfy the normalization requirements.
+ * @param detected - fully decoded source facts.
+ * @param bytes - encoded source length.
+ * @param policy - resolved normalization limits.
+ * @returns whether the source can pass through byte-identically.
+ */
+export declare function canPassThroughNormalization(detected: DetectedImage, bytes: number, policy: NormalizationPolicy): boolean;
+/**
+ * Classify a bounded pixel sample without assuming that a PNG source is a screenshot.
+ * @param pipeline - oriented sRGB source pipeline before output resizing.
+ * @returns whether the nearest-neighbour sample stays within the low-color threshold.
+ */
+export declare function hasLowColourCount(pipeline: Sharp): Promise<boolean>;
+/**
+ * Produce the persisted provider-independent normalized version of one fully decoded source.
+ * The source is passed through only when it is already clean, single-frame, 8-bit sRGB/sRGBA,
+ * and inside both normalization limits. Re-encoding never removes transparency. After the fixed
+ * quality floor is reached, dimensions continue shrinking until the independent byte cap holds.
+ * @param data - complete admitted source bytes.
+ * @param detected - fully decoded source facts.
+ * @param policy - resolved independent normalization limits.
+ * @returns verified provider-independent normalized bytes and metadata.
+ */
+export declare function normalizeImage(data: Uint8Array, detected: DetectedImage, policy: NormalizationPolicy): Promise<NormalizedImage>;
+//# sourceMappingURL=normalization.d.ts.map

package/node_modules/@xrkseek/attachment-local/dist/normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../src/normalization.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAE9D,OAAc,EAAE,KAAK,KAAK,EAAE,MAAM,OAAO,CAAA;AAEzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C,0EAA0E;AAC1E,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,YAAY,EAAE,MAAM,CAAA;IACpB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yEAAyE;AACzE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,CAAA;IAChB,SAAS,EAAE,cAAc,CAAA;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,MAAM,CAAA;CACf;AAuBD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAQT;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBzE;AA8DD;;;;;;;;;GASG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,aAAa,EACvB,MAAM,EAAE,mBAAmB,GAC1B,OAAO,CAAC,eAAe,CAAC,CAsC1B"}

package/node_modules/@xrkseek/attachment-local/dist/normalization.js

@@ -0,0 +1,148 @@
+/** Deterministic provider-independent image normalization. */
+import sharp, {} from 'sharp';
+import { AttachmentError } from '@xrkseek/attachment';
+import { encodeFirstWithinLimit, isExhaustedEncoding } from './encoding.js';
+import { detectImage, encodedAlphaIsCompatible } from './image.js';
+const NORMALIZATION_QUALITIES = [85, 80, 75];
+const LOW_COLOUR_SAMPLE_EDGE = 128;
+const LOW_COLOUR_LIMIT = 256;
+const MIN_SCALE_STEP = 0.9;
+/** Encode one prepared pipeline and report exact output facts. */
+async function encode(pipeline, mediaType, quality, palette = true) {
+    const encoded = mediaType === 'image/png'
+        ? pipeline.png({ compressionLevel: 9, palette })
+        : mediaType === 'image/webp'
+            ? pipeline.webp({ quality })
+            : pipeline.jpeg({ quality });
+    const { data, info } = await encoded.toBuffer({ resolveWithObject: true });
+    return { data: new Uint8Array(data), mediaType, width: info.width, height: info.height };
+}
+/**
+ * Whether bytes already satisfy the normalization requirements.
+ * @param detected - fully decoded source facts.
+ * @param bytes - encoded source length.
+ * @param policy - resolved normalization limits.
+ * @returns whether the source can pass through byte-identically.
+ */
+export function canPassThroughNormalization(detected, bytes, policy) {
+    return detected.mediaType !== 'image/gif'
+        && !detected.animated
+        && !detected.carriesMetadata
+        && detected.depth === 'uchar'
+        && detected.space === 'srgb'
+        && bytes <= policy.maxBytes
+        && Math.max(detected.width, detected.height) <= policy.maxDimension;
+}
+/**
+ * Classify a bounded pixel sample without assuming that a PNG source is a screenshot.
+ * @param pipeline - oriented sRGB source pipeline before output resizing.
+ * @returns whether the nearest-neighbour sample stays within the low-color threshold.
+ */
+export async function hasLowColourCount(pipeline) {
+    const { data, info } = await pipeline.clone().resize({
+        width: LOW_COLOUR_SAMPLE_EDGE,
+        height: LOW_COLOUR_SAMPLE_EDGE,
+        fit: 'inside',
+        withoutEnlargement: true,
+        kernel: sharp.kernel.nearest,
+        fastShrinkOnLoad: false,
+    }).raw().toBuffer({ resolveWithObject: true });
+    const colours = new Set();
+    for (let offset = 0; offset < data.length; offset += info.channels) {
+        const red = data.readUInt8(offset);
+        const green = data.readUInt8(offset + 1);
+        const blue = data.readUInt8(offset + 2);
+        const alpha = info.channels === 4 ? data.readUInt8(offset + 3) : 255;
+        colours.add(((red >> 3) << 15) | ((green >> 3) << 10) | ((blue >> 3) << 5) | (alpha >> 3));
+        if (colours.size > LOW_COLOUR_LIMIT)
+            return false;
+    }
+    return true;
+}
+/** Assert that a normalized output is an 8-bit sRGB/sRGBA single-frame image with matching facts. */
+async function verifyNormalizedImage(image, expectedAlpha) {
+    const detected = await detectImage(image.data);
+    if (detected.mediaType !== image.mediaType
+        || detected.width !== image.width
+        || detected.height !== image.height
+        || detected.animated
+        || detected.carriesMetadata
+        || detected.depth !== 'uchar'
+        || detected.space !== 'srgb'
+        || !encodedAlphaIsCompatible(expectedAlpha, detected)) {
+        throw new AttachmentError('Image normalization did not produce a single-frame 8-bit sRGB image with matching metadata.', 'ATTACHMENT_WRITE_FAILED');
+    }
+    return image;
+}
+/** Build one fixed-size, oriented, metadata-free sRGB pipeline from submitted bytes. */
+function preparedPipeline(data, width, height) {
+    return sharp(data, { failOn: 'error', limitInputPixels: false })
+        .rotate()
+        .toColourspace('srgb')
+        .resize({ width, height, fit: 'inside', withoutEnlargement: true });
+}
+/** Dimensions after the long edge is capped without changing aspect ratio. */
+function initialDimensions(detected, maxDimension) {
+    const scale = Math.min(1, maxDimension / Math.max(detected.width, detected.height));
+    return {
+        width: Math.max(1, Math.round(detected.width * scale)),
+        height: Math.max(1, Math.round(detected.height * scale)),
+    };
+}
+/** Lazy encoding order for one size, separated by sampled colour complexity and alpha. */
+function encodingAttemptsAtSize(data, width, height, hasAlpha, lowColour) {
+    const prepared = preparedPipeline(data, width, height);
+    const webp = NORMALIZATION_QUALITIES.map(quality => (() => encode(prepared.clone(), 'image/webp', quality)));
+    if (lowColour) {
+        return [() => encode(prepared.clone(), 'image/png', undefined, !hasAlpha), ...webp];
+    }
+    if (hasAlpha)
+        return webp;
+    return NORMALIZATION_QUALITIES.map(quality => (() => encode(prepared.clone(), 'image/jpeg', quality)));
+}
+/**
+ * Produce the persisted provider-independent normalized version of one fully decoded source.
+ * The source is passed through only when it is already clean, single-frame, 8-bit sRGB/sRGBA,
+ * and inside both normalization limits. Re-encoding never removes transparency. After the fixed
+ * quality floor is reached, dimensions continue shrinking until the independent byte cap holds.
+ * @param data - complete admitted source bytes.
+ * @param detected - fully decoded source facts.
+ * @param policy - resolved independent normalization limits.
+ * @returns verified provider-independent normalized bytes and metadata.
+ */
+export async function normalizeImage(data, detected, policy) {
+    if (canPassThroughNormalization(detected, data.byteLength, policy)) {
+        return { data, mediaType: detected.mediaType, width: detected.width, height: detected.height };
+    }
+    try {
+        let { width, height } = initialDimensions(detected, policy.maxDimension);
+        const classificationPipeline = sharp(data, { failOn: 'error', limitInputPixels: false })
+            .rotate()
+            .toColourspace('srgb');
+        const lowColour = await hasLowColourCount(classificationPipeline);
+        for (;;) {
+            const encoded = await encodeFirstWithinLimit(encodingAttemptsAtSize(data, width, height, detected.hasAlpha, lowColour), policy.maxBytes);
+            if (!isExhaustedEncoding(encoded)) {
+                return await verifyNormalizedImage(encoded, detected.mediaType === 'image/gif' ? undefined : detected.hasAlpha);
+            }
+            if (width === 1 && height === 1)
+                break;
+            const sizeScale = Math.sqrt(policy.maxBytes / encoded.smallest.data.byteLength) * 0.95;
+            const scale = Math.min(MIN_SCALE_STEP, sizeScale);
+            const nextWidth = Math.max(1, Math.floor(width * scale));
+            const nextHeight = Math.max(1, Math.floor(height * scale));
+            width = nextWidth;
+            height = nextHeight;
+        }
+    }
+    catch (error) {
+        if (error instanceof AttachmentError)
+            throw error;
+        const source = detected.mediaType === 'image/png' && detected.depth !== 'uchar'
+            ? `${detected.depth === 'ushort' ? '16-bit' : detected.depth} PNG`
+            : `${detected.depth} ${detected.mediaType.slice('image/'.length).toUpperCase()}`;
+        throw new AttachmentError(`The ${source} could not be converted to the normalized 8-bit sRGB form.`, 'ATTACHMENT_WRITE_FAILED', { cause: error });
+    }
+    throw new AttachmentError('Image cannot be encoded within the configured normalized-image byte cap.', 'IMAGE_TOO_LARGE');
+}
+//# sourceMappingURL=normalization.js.map

package/node_modules/@xrkseek/attachment-local/dist/normalization.js.map

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

package/node_modules/@xrkseek/attachment-local/dist/request-image.d.ts

@@ -0,0 +1,34 @@
+/** Deterministic cached image versions for model requests. */
+import type { ImageAttachmentRef, ImageRequestPolicy, RequestImageAttachment, StoredImageAttachment } from '@xrkseek/attachment';
+/** Transform version included in every cache and upload-index identity. */
+export declare const REQUEST_IMAGE_TRANSFORM_VERSION = "request-image-v4";
+/** DeepSeek request versions normally fit at these two preferred qualities. */
+export declare const REQUEST_IMAGE_QUALITIES: readonly [85, 80];
+/**
+ * Compute aspect-preserving integer dimensions within a hard total-pixel budget.
+ * @param width - positive source width.
+ * @param height - positive source height.
+ * @param maxPixels - positive width-times-height cap.
+ * @returns inward-rounded dimensions; small images are not enlarged.
+ */
+export declare function requestImageDimensions(width: number, height: number, maxPixels: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Complete deterministic identity for one attachment and route-owned request policy.
+ * @param attachment - provider-independent durable normalized attachment reference.
+ * @param policy - route-owned pixel and byte policy.
+ * @returns branded digest over every request transform input.
+ */
+export declare function requestImageVariantId(attachment: ImageAttachmentRef, policy: ImageRequestPolicy): string;
+/**
+ * Generate or reuse one request image below the local attachment root.
+ * @param root - absolute versioned attachment storage root.
+ * @param attachment - verified normalized attachment bytes and reference.
+ * @param policy - exact route request-image policy.
+ * @param signal - optional cancellation for cache I/O and image transformation.
+ * @returns verified request bytes and deterministic variant identity.
+ */
+export declare function readRequestImageFile(root: string, attachment: StoredImageAttachment, policy: ImageRequestPolicy, signal?: AbortSignal): Promise<RequestImageAttachment>;
+//# sourceMappingURL=request-image.d.ts.map

package/node_modules/@xrkseek/attachment-local/dist/request-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-image.d.ts","sourceRoot":"","sources":["../src/request-image.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAO9D,OAAO,KAAK,EAEV,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,qBAAqB,CAAA;AAK5B,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,qBAAqB,CAAA;AACjE,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,mBAAoB,CAAA;AAiBxD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,GAChB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAmBnC;AA8BD;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,kBAAkB,EAC9B,MAAM,EAAE,kBAAkB,GACzB,MAAM,CAER;AAkID;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,qBAAqB,EACjC,MAAM,EAAE,kBAAkB,EAC1B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sBAAsB,CAAC,CA0BjC"}