vector-framework 1.2.2 → 1.2.3

package/dist/checkpoint/artifacts/packager.js

@@ -0,0 +1,82 @@
+import { promises as fs } from 'node:fs';
+import { join, relative } from 'node:path';
+import { sha256Hex } from './hasher';
+const ARCHIVE_DIR = '_archives';
+export class CheckpointPackager {
+    storageDir;
+    codec;
+    constructor(storageDir, codec = 'gzip') {
+        this.storageDir = storageDir;
+        this.codec = codec;
+    }
+    async packageVersion(version) {
+        const versionDir = join(this.storageDir, version);
+        const archiveRelPath = join(ARCHIVE_DIR, `${version}${this.archiveSuffix()}`).replace(/\\/g, '/');
+        const archivePath = join(this.storageDir, archiveRelPath);
+        await fs.mkdir(join(this.storageDir, ARCHIVE_DIR), { recursive: true });
+        const files = await collectFiles(versionDir);
+        const archiveBytes = await this.buildArchiveBytes(versionDir, archivePath, files);
+        return {
+            archivePath: archiveRelPath,
+            archiveHash: sha256Hex(archiveBytes),
+            archiveSize: archiveBytes.byteLength,
+            codec: this.codec,
+        };
+    }
+    async buildArchiveBytes(versionDir, archivePath, files) {
+        const ArchiveCtor = Bun.Archive;
+        if (typeof ArchiveCtor === 'function') {
+            const archiveEntries = Object.fromEntries(files.map((filePath) => {
+                const rel = relative(versionDir, filePath).replace(/\\/g, '/');
+                return [rel, Bun.file(filePath)];
+            }));
+            const archive = new ArchiveCtor(archiveEntries);
+            const tarBytes = new Uint8Array(await archive.bytes());
+            const archiveBytes = this.codec === 'gzip' ? Bun.gzipSync(tarBytes) : tarBytes;
+            await Bun.write(archivePath, archiveBytes);
+            return archiveBytes;
+        }
+        await this.buildArchiveWithTar(versionDir, archivePath, files);
+        const bytes = await fs.readFile(archivePath);
+        return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    async buildArchiveWithTar(versionDir, archivePath, files) {
+        const relFiles = files.map((filePath) => relative(versionDir, filePath));
+        if (relFiles.length === 0) {
+            throw new Error(`Cannot package checkpoint: no files found in "${versionDir}"`);
+        }
+        const tarArgs = this.codec === 'gzip' ? ['-czf', archivePath] : ['-cf', archivePath];
+        const proc = Bun.spawn(['tar', ...tarArgs, '-C', versionDir, ...relFiles], {
+            stdout: 'pipe',
+            stderr: 'pipe',
+        });
+        const exitCode = await proc.exited;
+        if (exitCode === 0) {
+            return;
+        }
+        const stderr = await new Response(proc.stderr).text();
+        throw new Error(`Failed to package checkpoint archive with tar (exit ${exitCode}): ${stderr.trim()}`);
+    }
+    archiveSuffix() {
+        return this.codec === 'gzip' ? '.tar.gz' : '.tar';
+    }
+}
+async function collectFiles(root) {
+    const files = [];
+    await walk(root, files);
+    return files.filter((filePath) => relative(root, filePath).replace(/\\/g, '/') !== 'manifest.json');
+}
+async function walk(dir, files) {
+    const entries = await fs.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            await walk(fullPath, files);
+            continue;
+        }
+        if (entry.isFile()) {
+            files.push(fullPath);
+        }
+    }
+}
+//# sourceMappingURL=packager.js.map

package/dist/checkpoint/artifacts/packager.js.map

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

package/dist/checkpoint/artifacts/repository.d.ts

@@ -0,0 +1,11 @@
+import type { CheckpointAssetRecord } from '../types';
+import type { CheckpointArtifactRepository } from './types';
+export declare class LocalCheckpointArtifactRepository implements CheckpointArtifactRepository {
+    private storageDir;
+    constructor(storageDir: string);
+    writeBlob(record: CheckpointAssetRecord, bytes: Uint8Array): Promise<void>;
+    hasBlob(record: CheckpointAssetRecord): Promise<boolean>;
+    readBlob(record: CheckpointAssetRecord): Promise<Uint8Array>;
+    resolveBlobPath(record: CheckpointAssetRecord): string;
+}
+//# sourceMappingURL=repository.d.ts.map

package/dist/checkpoint/artifacts/repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/artifacts/repository.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,SAAS,CAAC;AAE5D,qBAAa,iCAAkC,YAAW,4BAA4B;IACpF,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,EAAE,MAAM;IAIxB,SAAS,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1E,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIxD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC;IAMlE,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM;CAIvD"}

package/dist/checkpoint/artifacts/repository.js

@@ -0,0 +1,29 @@
+import { existsSync, promises as fs } from 'node:fs';
+import { dirname, join } from 'node:path';
+export class LocalCheckpointArtifactRepository {
+    storageDir;
+    constructor(storageDir) {
+        this.storageDir = storageDir;
+    }
+    async writeBlob(record, bytes) {
+        const targetPath = this.resolveBlobPath(record);
+        await fs.mkdir(dirname(targetPath), { recursive: true });
+        if (existsSync(targetPath)) {
+            return;
+        }
+        await fs.writeFile(targetPath, bytes);
+    }
+    async hasBlob(record) {
+        return existsSync(this.resolveBlobPath(record));
+    }
+    async readBlob(record) {
+        const targetPath = this.resolveBlobPath(record);
+        const bytes = await fs.readFile(targetPath);
+        return new Uint8Array(bytes.buffer, bytes.byteOffset, bytes.byteLength);
+    }
+    resolveBlobPath(record) {
+        const rawPath = record.blobPath ?? record.storedPath;
+        return rawPath.startsWith('/') ? rawPath : join(this.storageDir, rawPath);
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/checkpoint/artifacts/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../../../src/checkpoint/artifacts/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAI1C,MAAM,OAAO,iCAAiC;IACpC,UAAU,CAAS;IAE3B,YAAY,UAAkB;QAC5B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAA6B,EAAE,KAAiB;QAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,OAAO;QACT,CAAC;QACD,MAAM,EAAE,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,MAA6B;QACzC,OAAO,UAAU,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAA6B;QAC1C,MAAM,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC5C,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1E,CAAC;IAED,eAAe,CAAC,MAA6B;QAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC;QACrD,OAAO,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAC5E,CAAC;CACF"}

package/dist/checkpoint/artifacts/store.d.ts

@@ -0,0 +1,13 @@
+import type { CheckpointAssetRecord } from '../types';
+import type { CheckpointArtifactStoreOptions } from './types';
+export declare class CheckpointArtifactStore {
+    private storageDir;
+    private codec;
+    constructor(storageDir: string, options?: CheckpointArtifactStoreOptions);
+    addEmbedded(logicalPath: string, sourcePath: string): Promise<CheckpointAssetRecord>;
+    addSidecar(logicalPath: string, sourcePath: string): Promise<CheckpointAssetRecord>;
+    collect(embeddedPaths: string[], sidecarPaths: string[]): Promise<CheckpointAssetRecord[]>;
+    private addAsset;
+    private writeAtomically;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/checkpoint/artifacts/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/artifacts/store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAA8B,MAAM,UAAU,CAAC;AAIlF,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAI9D,qBAAa,uBAAuB;IAClC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAA6B;gBAE9B,UAAU,EAAE,MAAM,EAAE,OAAO,GAAE,8BAAmC;IAKtE,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIpF,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAInF,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;YAclF,QAAQ;YAuCR,eAAe;CAa9B"}

package/dist/checkpoint/artifacts/store.js

@@ -0,0 +1,85 @@
+import { existsSync, promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { compressBytes, DEFAULT_ASSET_CODEC } from './compressor';
+import { sha256Hex } from './hasher';
+import { normalizeLogicalPath, normalizeRelativePath } from './manifest';
+const BLOB_DIR = '_assets/blobs';
+export class CheckpointArtifactStore {
+    storageDir;
+    codec;
+    constructor(storageDir, options = {}) {
+        this.storageDir = storageDir;
+        this.codec = options.assetCodec ?? DEFAULT_ASSET_CODEC;
+    }
+    async addEmbedded(logicalPath, sourcePath) {
+        return this.addAsset('embedded', logicalPath, sourcePath);
+    }
+    async addSidecar(logicalPath, sourcePath) {
+        return this.addAsset('sidecar', logicalPath, sourcePath);
+    }
+    async collect(embeddedPaths, sidecarPaths) {
+        const records = [];
+        for (const sourcePath of embeddedPaths) {
+            records.push(await this.addEmbedded(sourcePath, sourcePath));
+        }
+        for (const sourcePath of sidecarPaths) {
+            records.push(await this.addSidecar(sourcePath, sourcePath));
+        }
+        return records;
+    }
+    async addAsset(type, logicalPath, sourcePath) {
+        const content = await fs.readFile(sourcePath);
+        const contentBytes = new Uint8Array(content.buffer, content.byteOffset, content.byteLength);
+        const contentHash = sha256Hex(contentBytes);
+        const compressed = compressBytes(contentBytes, this.codec);
+        const blobHash = sha256Hex(compressed);
+        const blobPath = normalizeRelativePath(join(BLOB_DIR, `${blobHash}${this.codec === 'gzip' ? '.gz' : ''}`));
+        const storedPath = join(this.storageDir, blobPath);
+        await fs.mkdir(join(this.storageDir, BLOB_DIR), { recursive: true });
+        if (!existsSync(storedPath)) {
+            await this.writeAtomically(storedPath, compressed);
+        }
+        else {
+            const existing = await fs.readFile(storedPath);
+            const existingBytes = new Uint8Array(existing.buffer, existing.byteOffset, existing.byteLength);
+            if (sha256Hex(existingBytes) !== blobHash) {
+                await this.writeAtomically(storedPath, compressed);
+            }
+        }
+        return {
+            type,
+            logicalPath: normalizeLogicalPath(logicalPath),
+            storedPath,
+            hash: contentHash,
+            size: content.byteLength,
+            contentHash,
+            contentSize: content.byteLength,
+            blobHash,
+            blobSize: compressed.byteLength,
+            blobPath,
+            codec: this.codec,
+        };
+    }
+    async writeAtomically(path, bytes) {
+        const tempPath = `${path}.tmp.${process.pid}.${Date.now()}`;
+        await fs.writeFile(tempPath, bytes);
+        try {
+            await fs.rename(tempPath, path);
+        }
+        catch (error) {
+            if (!isAlreadyExists(error)) {
+                throw error;
+            }
+            await fs.rm(path, { force: true });
+            await fs.rename(tempPath, path);
+        }
+    }
+}
+function isAlreadyExists(error) {
+    if (typeof error !== 'object' || error === null || !('code' in error)) {
+        return false;
+    }
+    const code = error.code;
+    return code === 'EEXIST' || code === 'EPERM';
+}
+//# sourceMappingURL=store.js.map

package/dist/checkpoint/artifacts/store.js.map

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

package/dist/checkpoint/artifacts/types.d.ts

@@ -0,0 +1,21 @@
+import type { CheckpointAssetRecord, CheckpointCompressionCodec } from '../types';
+export interface CheckpointArtifactStoreOptions {
+    assetCodec?: CheckpointCompressionCodec;
+}
+export interface CheckpointArtifactMaterializerOptions {
+    verifyChecksums?: boolean;
+    materializedDirName?: string;
+    lockTimeoutMs?: number;
+}
+export interface CheckpointArtifactPackageRecord {
+    archivePath: string;
+    archiveHash: string;
+    archiveSize: number;
+    codec: CheckpointCompressionCodec;
+}
+export interface CheckpointArtifactRepository {
+    writeBlob(record: CheckpointAssetRecord, bytes: Uint8Array): Promise<void>;
+    hasBlob(record: CheckpointAssetRecord): Promise<boolean>;
+    readBlob(record: CheckpointAssetRecord): Promise<Uint8Array>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/checkpoint/artifacts/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/artifacts/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAElF,MAAM,WAAW,8BAA8B;IAC7C,UAAU,CAAC,EAAE,0BAA0B,CAAC;CACzC;AAED,MAAM,WAAW,qCAAqC;IACpD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,+BAA+B;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,0BAA0B,CAAC;CACnC;AAED,MAAM,WAAW,4BAA4B;IAC3C,SAAS,CAAC,MAAM,EAAE,qBAAqB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,OAAO,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzD,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC9D"}

package/dist/checkpoint/artifacts/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/checkpoint/artifacts/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/checkpoint/artifacts/types.ts"],"names":[],"mappings":""}

package/dist/checkpoint/artifacts/worker-decompressor.d.ts

@@ -0,0 +1,17 @@
+import type { CheckpointCompressionCodec } from '../types';
+export declare class CheckpointWorkerDecompressor {
+    private workers;
+    private idleWorkers;
+    private queue;
+    private activeJobsByWorker;
+    private nextJobId;
+    private disposed;
+    constructor(workerCount?: number);
+    decompress(input: Uint8Array, codec: CheckpointCompressionCodec): Promise<Uint8Array>;
+    dispose(): Promise<void>;
+    private pump;
+    private handleWorkerMessage;
+    private handleWorkerError;
+    private failAll;
+}
+//# sourceMappingURL=worker-decompressor.d.ts.map

package/dist/checkpoint/artifacts/worker-decompressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-decompressor.d.ts","sourceRoot":"","sources":["../../../src/checkpoint/artifacts/worker-decompressor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,UAAU,CAAC;AAuB3D,qBAAa,4BAA4B;IACvC,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,KAAK,CAAuB;IACpC,OAAO,CAAC,kBAAkB,CAAyC;IACnE,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAS;gBAEb,WAAW,GAAE,MAAoC;IAavD,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,UAAU,CAAC;IA2BrF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB9B,OAAO,CAAC,IAAI;IASZ,OAAO,CAAC,mBAAmB;IAyB3B,OAAO,CAAC,iBAAiB;IAkBzB,OAAO,CAAC,OAAO;CAWhB"}

package/dist/checkpoint/artifacts/worker-decompressor.js

@@ -0,0 +1,148 @@
+import { availableParallelism, cpus } from 'node:os';
+const DEFAULT_MAX_WORKERS = 4;
+export class CheckpointWorkerDecompressor {
+    workers = [];
+    idleWorkers = [];
+    queue = [];
+    activeJobsByWorker = new Map();
+    nextJobId = 1;
+    disposed = false;
+    constructor(workerCount = resolveDefaultWorkerCount()) {
+        const normalizedCount = normalizeWorkerCount(workerCount);
+        const workerUrl = resolveWorkerModuleUrl();
+        for (let i = 0; i < normalizedCount; i++) {
+            const worker = new Worker(workerUrl.href);
+            worker.onmessage = (event) => this.handleWorkerMessage(worker, event);
+            worker.onerror = (event) => this.handleWorkerError(worker, event);
+            this.workers.push(worker);
+            this.idleWorkers.push(worker);
+        }
+    }
+    async decompress(input, codec) {
+        if (codec === 'none') {
+            return new Uint8Array(input);
+        }
+        if (this.disposed) {
+            throw new Error('Checkpoint worker decompressor is disposed');
+        }
+        const copied = new Uint8Array(input);
+        return await new Promise((resolve, reject) => {
+            const id = this.nextJobId++;
+            this.queue.push({
+                id,
+                request: {
+                    id,
+                    codec,
+                    input: copied.buffer,
+                },
+                resolve,
+                reject,
+            });
+            this.pump();
+        });
+    }
+    async dispose() {
+        if (this.disposed) {
+            return;
+        }
+        this.disposed = true;
+        const error = new Error('Checkpoint worker decompressor disposed');
+        this.failAll(error);
+        for (const worker of this.workers) {
+            try {
+                worker.terminate();
+            }
+            catch {
+                // Ignore termination failures.
+            }
+        }
+        this.workers = [];
+        this.idleWorkers = [];
+        this.activeJobsByWorker.clear();
+    }
+    pump() {
+        while (this.idleWorkers.length > 0 && this.queue.length > 0) {
+            const worker = this.idleWorkers.pop();
+            const job = this.queue.shift();
+            this.activeJobsByWorker.set(worker, job);
+            worker.postMessage(job.request, [job.request.input]);
+        }
+    }
+    handleWorkerMessage(worker, event) {
+        const job = this.activeJobsByWorker.get(worker);
+        this.activeJobsByWorker.delete(worker);
+        if (!this.disposed) {
+            this.idleWorkers.push(worker);
+        }
+        if (!job) {
+            this.pump();
+            return;
+        }
+        const message = event.data;
+        if (message.error) {
+            job.reject(new Error(message.error));
+        }
+        else if (message.output instanceof ArrayBuffer) {
+            job.resolve(new Uint8Array(message.output));
+        }
+        else {
+            job.reject(new Error('Worker returned no output'));
+        }
+        this.pump();
+    }
+    handleWorkerError(worker, event) {
+        const job = this.activeJobsByWorker.get(worker);
+        this.activeJobsByWorker.delete(worker);
+        this.idleWorkers = this.idleWorkers.filter((candidate) => candidate !== worker);
+        const message = event.message?.trim() || 'Checkpoint decompression worker crashed';
+        const error = new Error(message);
+        if (job) {
+            job.reject(error);
+        }
+        this.failAll(error);
+        this.dispose().catch(() => {
+            // Ignore cleanup failures after worker error.
+        });
+    }
+    failAll(error) {
+        const queued = this.queue.splice(0, this.queue.length);
+        for (const job of queued) {
+            job.reject(error);
+        }
+        for (const job of this.activeJobsByWorker.values()) {
+            job.reject(error);
+        }
+        this.activeJobsByWorker.clear();
+    }
+}
+function resolveDefaultWorkerCount() {
+    const cores = resolveCoreCount();
+    const reserveForMainThread = Math.max(1, cores - 1);
+    return Math.max(1, Math.min(DEFAULT_MAX_WORKERS, reserveForMainThread));
+}
+function resolveCoreCount() {
+    try {
+        const parallelism = availableParallelism();
+        if (Number.isFinite(parallelism) && parallelism > 0) {
+            return parallelism;
+        }
+    }
+    catch {
+        // Fall through to cpus().
+    }
+    const cpuCount = cpus().length;
+    return Number.isFinite(cpuCount) && cpuCount > 0 ? cpuCount : 1;
+}
+function normalizeWorkerCount(value) {
+    if (!Number.isFinite(value) || value <= 0) {
+        return 1;
+    }
+    return Math.max(1, Math.floor(value));
+}
+function resolveWorkerModuleUrl() {
+    if (import.meta.url.endsWith('.ts')) {
+        return new URL('./decompress-worker.ts', import.meta.url);
+    }
+    return new URL('./decompress-worker.js', import.meta.url);
+}
+//# sourceMappingURL=worker-decompressor.js.map

package/dist/checkpoint/artifacts/worker-decompressor.js.map

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

package/dist/checkpoint/asset-store.d.ts

@@ -0,0 +1,10 @@
+import type { CheckpointAssetRecord } from './types';
+export declare class AssetStore {
+    private artifactStore;
+    constructor(storageDir: string);
+    addEmbedded(logicalPath: string, sourcePath: string): Promise<CheckpointAssetRecord>;
+    addSidecar(logicalPath: string, sourcePath: string): Promise<CheckpointAssetRecord>;
+    collect(embeddedPaths: string[], sidecarPaths: string[]): Promise<CheckpointAssetRecord[]>;
+    validateBudgets(records: CheckpointAssetRecord[]): void;
+}
+//# sourceMappingURL=asset-store.d.ts.map

package/dist/checkpoint/asset-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-store.d.ts","sourceRoot":"","sources":["../../src/checkpoint/asset-store.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAMrD,qBAAa,UAAU;IACrB,OAAO,CAAC,aAAa,CAA0B;gBAEnC,UAAU,EAAE,MAAM;IAIxB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAWpF,UAAU,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAInF,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAchG,eAAe,CAAC,OAAO,EAAE,qBAAqB,EAAE,GAAG,IAAI;CAWxD"}

package/dist/checkpoint/asset-store.js

@@ -0,0 +1,46 @@
+import { promises as fs } from 'node:fs';
+import { CheckpointArtifactStore } from './artifacts/store';
+const EMBEDDED_PER_FILE_BUDGET = 64 * 1024; // 64 KB per file
+const EMBEDDED_TOTAL_BUDGET = 512 * 1024; // 512 KB total
+export class AssetStore {
+    artifactStore;
+    constructor(storageDir) {
+        this.artifactStore = new CheckpointArtifactStore(storageDir);
+    }
+    async addEmbedded(logicalPath, sourcePath) {
+        const content = await fs.readFile(sourcePath);
+        if (content.byteLength > EMBEDDED_PER_FILE_BUDGET) {
+            throw new Error(`Embedded asset "${logicalPath}" is ${formatBytes(content.byteLength)} — exceeds ${formatBytes(EMBEDDED_PER_FILE_BUDGET)} per-file budget. Use sidecar instead.`);
+        }
+        return await this.artifactStore.addEmbedded(logicalPath, sourcePath);
+    }
+    async addSidecar(logicalPath, sourcePath) {
+        return await this.artifactStore.addSidecar(logicalPath, sourcePath);
+    }
+    async collect(embeddedPaths, sidecarPaths) {
+        const records = [];
+        for (const p of embeddedPaths) {
+            records.push(await this.addEmbedded(p, p));
+        }
+        for (const p of sidecarPaths) {
+            records.push(await this.addSidecar(p, p));
+        }
+        return records;
+    }
+    validateBudgets(records) {
+        const embeddedTotal = records
+            .filter((r) => r.type === 'embedded')
+            .reduce((acc, r) => acc + (r.contentSize ?? r.size), 0);
+        if (embeddedTotal > EMBEDDED_TOTAL_BUDGET) {
+            throw new Error(`Total embedded asset size ${formatBytes(embeddedTotal)} exceeds ${formatBytes(EMBEDDED_TOTAL_BUDGET)} budget.`);
+        }
+    }
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+//# sourceMappingURL=asset-store.js.map

package/dist/checkpoint/asset-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-store.js","sourceRoot":"","sources":["../../src/checkpoint/asset-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,MAAM,wBAAwB,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,iBAAiB;AAC7D,MAAM,qBAAqB,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,eAAe;AAEzD,MAAM,OAAO,UAAU;IACb,aAAa,CAA0B;IAE/C,YAAY,UAAkB;QAC5B,IAAI,CAAC,aAAa,GAAG,IAAI,uBAAuB,CAAC,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,WAAmB,EAAE,UAAkB;QACvD,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QAC9C,IAAI,OAAO,CAAC,UAAU,GAAG,wBAAwB,EAAE,CAAC;YAClD,MAAM,IAAI,KAAK,CACb,mBAAmB,WAAW,QAAQ,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,cAAc,WAAW,CAAC,wBAAwB,CAAC,wCAAwC,CACjK,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACvE,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,WAAmB,EAAE,UAAkB;QACtD,OAAO,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,aAAuB,EAAE,YAAsB;QAC3D,MAAM,OAAO,GAA4B,EAAE,CAAC;QAE5C,KAAK,MAAM,CAAC,IAAI,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;QAED,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5C,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,eAAe,CAAC,OAAgC;QAC9C,MAAM,aAAa,GAAG,OAAO;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;aACpC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;QAE1D,IAAI,aAAa,GAAG,qBAAqB,EAAE,CAAC;YAC1C,MAAM,IAAI,KAAK,CACb,6BAA6B,WAAW,CAAC,aAAa,CAAC,YAAY,WAAW,CAAC,qBAAqB,CAAC,UAAU,CAChH,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;IAClE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC"}

package/dist/checkpoint/bundler.d.ts

@@ -0,0 +1,15 @@
+export interface BundleOptions {
+    entrypointPath: string;
+    outputDir: string;
+    outputFile?: string;
+}
+export interface BundleResult {
+    outputPath: string;
+    hash: string;
+    size: number;
+}
+export declare class CheckpointBundler {
+    bundle(options: BundleOptions): Promise<BundleResult>;
+    private hashFile;
+}
+//# sourceMappingURL=bundler.d.ts.map

package/dist/checkpoint/bundler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.d.ts","sourceRoot":"","sources":["../../src/checkpoint/bundler.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,aAAa;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,qBAAa,iBAAiB;IACtB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;YAkC7C,QAAQ;CAavB"}

package/dist/checkpoint/bundler.js

@@ -0,0 +1,45 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+export class CheckpointBundler {
+    async bundle(options) {
+        const outfile = options.outputFile ?? 'checkpoint.js';
+        const result = await Bun.build({
+            entrypoints: [options.entrypointPath],
+            outdir: options.outputDir,
+            target: 'bun',
+            format: 'esm',
+            minify: true,
+            naming: { entry: outfile },
+        });
+        if (!result.success) {
+            const messages = result.logs.map((l) => l.message ?? String(l)).join('\n');
+            throw new Error(`Checkpoint bundle failed:\n${messages}`);
+        }
+        const outputPath = join(options.outputDir, outfile);
+        if (!existsSync(outputPath)) {
+            // Bun.build may output with a different name; find the actual output
+            const actualOutput = result.outputs.find((o) => o.kind === 'entry-point');
+            if (actualOutput) {
+                const actualPath = actualOutput.path;
+                if (existsSync(actualPath)) {
+                    return this.hashFile(actualPath);
+                }
+            }
+            throw new Error(`Bundle output not found at expected path: ${outputPath}`);
+        }
+        return this.hashFile(outputPath);
+    }
+    async hashFile(path) {
+        const file = Bun.file(path);
+        const content = await file.arrayBuffer();
+        const hashBuffer = Bun.SHA256.hash(new Uint8Array(content));
+        const hashBytes = new Uint8Array(hashBuffer.buffer, hashBuffer.byteOffset, hashBuffer.byteLength);
+        const hash = Buffer.from(hashBytes).toString('hex');
+        return {
+            outputPath: path,
+            hash,
+            size: content.byteLength,
+        };
+    }
+}
+//# sourceMappingURL=bundler.js.map

package/dist/checkpoint/bundler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundler.js","sourceRoot":"","sources":["../../src/checkpoint/bundler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAcjC,MAAM,OAAO,iBAAiB;IAC5B,KAAK,CAAC,MAAM,CAAC,OAAsB;QACjC,MAAM,OAAO,GAAG,OAAO,CAAC,UAAU,IAAI,eAAe,CAAC;QAEtD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC;YAC7B,WAAW,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC;YACrC,MAAM,EAAE,OAAO,CAAC,SAAS;YACzB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE;SAC3B,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC3E,MAAM,IAAI,KAAK,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAEpD,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,qEAAqE;YACrE,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,aAAa,CAAC,CAAC;YAC1E,IAAI,YAAY,EAAE,CAAC;gBACjB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC;gBACrC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;oBAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,6CAA6C,UAAU,EAAE,CAAC,CAAC;QAC7E,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAY;QACjC,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,UAAU,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,UAAU,CAAC,CAAC;QAClG,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO;YACL,UAAU,EAAE,IAAI;YAChB,IAAI;YACJ,IAAI,EAAE,OAAO,CAAC,UAAU;SACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/checkpoint/cli.d.ts

@@ -0,0 +1,2 @@
+export declare function runCheckpointCli(argv: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/checkpoint/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/checkpoint/cli.ts"],"names":[],"mappings":"AAGA,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBpE"}