vector-framework 1.2.2 → 1.2.3

package/dist/checkpoint/ipc.js

@@ -0,0 +1,96 @@
+const MAX_PENDING_STDOUT_CHARS = 1_048_576; // 1 MiB guard against unbounded startup log lines.
+export function parseIpcLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return null;
+    if (trimmed === 'READY')
+        return { type: 'ready' };
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        return null;
+    }
+}
+export async function waitForReady(stdout, timeoutMs = 10_000) {
+    return new Promise((resolve, reject) => {
+        let settled = false;
+        const reader = stdout.getReader();
+        const decoder = new TextDecoder();
+        let buffer = '';
+        function settle(fn) {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            try {
+                reader.releaseLock();
+            }
+            catch {
+                // Ignore release failures when the reader is already detached.
+            }
+            fn();
+        }
+        const timer = setTimeout(() => {
+            settle(() => reject(new Error(`Checkpoint process did not become ready within ${timeoutMs}ms`)));
+        }, timeoutMs);
+        const processLine = (line) => {
+            const msg = parseIpcLine(line);
+            if (msg?.type === 'ready') {
+                settle(() => resolve());
+                return 'ready';
+            }
+            if (msg?.type === 'error') {
+                settle(() => reject(new Error(`Checkpoint process error: ${msg.message}`)));
+                return 'error';
+            }
+            return 'continue';
+        };
+        const processBufferLines = () => {
+            let lineEnd = buffer.indexOf('\n');
+            while (lineEnd !== -1) {
+                const line = buffer.slice(0, lineEnd);
+                buffer = buffer.slice(lineEnd + 1);
+                const result = processLine(line);
+                if (result !== 'continue') {
+                    return result;
+                }
+                lineEnd = buffer.indexOf('\n');
+            }
+            return 'continue';
+        };
+        // Iterative read loop (not recursive) to avoid stack overflow on large stdout
+        (async () => {
+            try {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) {
+                        buffer += decoder.decode();
+                        const lastLine = buffer.trim();
+                        if (lastLine.length > 0) {
+                            const result = processLine(lastLine);
+                            if (result !== 'continue') {
+                                return;
+                            }
+                        }
+                        settle(() => reject(new Error('Checkpoint process stdout closed before READY signal')));
+                        return;
+                    }
+                    buffer += decoder.decode(value, { stream: true });
+                    if (buffer.length > MAX_PENDING_STDOUT_CHARS) {
+                        settle(() => reject(new Error(`Checkpoint process stdout exceeded ${MAX_PENDING_STDOUT_CHARS} chars before READY`)));
+                        return;
+                    }
+                    const result = processBufferLines();
+                    if (result !== 'continue') {
+                        return;
+                    }
+                }
+            }
+            catch (err) {
+                settle(() => reject(err));
+            }
+        })();
+    });
+}
+//# sourceMappingURL=ipc.js.map

package/dist/checkpoint/ipc.js.map

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

package/dist/checkpoint/manager.d.ts

@@ -0,0 +1,20 @@
+import type { ActivePointer, CheckpointConfig, CheckpointManifest, CheckpointPublishOptions } from './types';
+export declare class CheckpointManager {
+    private storageDir;
+    private maxCheckpoints;
+    constructor(config?: CheckpointConfig);
+    getStorageDir(): string;
+    versionDir(version: string): string;
+    socketPath(version: string): string;
+    ensureStorageDir(): Promise<void>;
+    publish(options: CheckpointPublishOptions): Promise<CheckpointManifest>;
+    readManifest(version: string): Promise<CheckpointManifest>;
+    writeManifest(version: string, manifest: CheckpointManifest): Promise<void>;
+    listVersions(): Promise<CheckpointManifest[]>;
+    getActive(): Promise<ActivePointer | null>;
+    setActive(version: string): Promise<void>;
+    remove(version: string): Promise<void>;
+    pruneOld(): Promise<void>;
+    private normalizeManifest;
+}
+//# sourceMappingURL=manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/checkpoint/manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAwB7G,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;gBAEnB,MAAM,GAAE,gBAAqB;IAKzC,aAAa,IAAI,MAAM;IAIvB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAInC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAI7B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIjC,OAAO,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAkEvE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAM1D,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK3E,YAAY,IAAI,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAyB7C,SAAS,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAc1C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuBzC,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAetC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB/B,OAAO,CAAC,iBAAiB;CA0B1B"}

package/dist/checkpoint/manager.js

@@ -0,0 +1,214 @@
+import { existsSync, promises as fs } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { CHECKPOINT_FORMAT_VERSION } from './types';
+import { AssetStore } from './asset-store';
+import { CheckpointBundler } from './bundler';
+import { CheckpointEntrypointGenerator } from './entrypoint-generator';
+import { CheckpointPackager } from './artifacts/packager';
+import { resolveCheckpointSocketPath } from './socket-path';
+const DEFAULT_STORAGE_DIR = '.vector/checkpoints';
+const ACTIVE_POINTER_FILE = 'active.json';
+function inferLegacyAssetCodec(asset) {
+    if (asset.codec) {
+        return asset.codec;
+    }
+    const rawPath = (asset.blobPath ?? asset.storedPath ?? '').trim().toLowerCase();
+    return rawPath.endsWith('.gz') ? 'gzip' : 'none';
+}
+export class CheckpointManager {
+    storageDir;
+    maxCheckpoints;
+    constructor(config = {}) {
+        this.storageDir = resolve(process.cwd(), config.storageDir ?? DEFAULT_STORAGE_DIR);
+        this.maxCheckpoints = config.maxCheckpoints ?? 10;
+    }
+    getStorageDir() {
+        return this.storageDir;
+    }
+    versionDir(version) {
+        return join(this.storageDir, version);
+    }
+    socketPath(version) {
+        return resolveCheckpointSocketPath(this.storageDir, version);
+    }
+    async ensureStorageDir() {
+        await fs.mkdir(this.storageDir, { recursive: true });
+    }
+    async publish(options) {
+        await this.ensureStorageDir();
+        const versionDir = this.versionDir(options.version);
+        await fs.mkdir(versionDir, { recursive: true });
+        // Generate entrypoint
+        const generator = new CheckpointEntrypointGenerator();
+        const entrypointPath = await generator.generate({
+            version: options.version,
+            outputDir: versionDir,
+            routesDir: resolve(process.cwd(), options.routesDir),
+            socketPath: this.socketPath(options.version),
+        });
+        // Bundle
+        const bundler = new CheckpointBundler();
+        const bundleResult = await bundler.bundle({
+            entrypointPath,
+            outputDir: versionDir,
+        });
+        // Collect assets
+        const assetStore = new AssetStore(this.storageDir);
+        const assets = await assetStore.collect(options.embeddedAssetPaths ?? [], options.sidecarAssetPaths ?? []);
+        assetStore.validateBudgets(assets);
+        // Build manifest
+        const manifest = {
+            formatVersion: CHECKPOINT_FORMAT_VERSION,
+            version: options.version,
+            createdAt: new Date().toISOString(),
+            entrypoint: 'checkpoint.js',
+            routes: generator.getDiscoveredRoutes(),
+            assets,
+            bundleHash: bundleResult.hash,
+            bundleSize: bundleResult.size,
+            checkpointArchivePath: undefined,
+            checkpointArchiveHash: undefined,
+            checkpointArchiveSize: undefined,
+            checkpointArchiveCodec: undefined,
+        };
+        await this.writeManifest(options.version, manifest);
+        // Clean up entrypoint source (keep only the bundle)
+        try {
+            await fs.unlink(entrypointPath);
+        }
+        catch {
+            // Ignore cleanup failures
+        }
+        // Package checkpoint folder with compression for local transport workflows.
+        const packager = new CheckpointPackager(this.storageDir);
+        const archive = await packager.packageVersion(options.version);
+        manifest.checkpointArchivePath = archive.archivePath;
+        manifest.checkpointArchiveHash = archive.archiveHash;
+        manifest.checkpointArchiveSize = archive.archiveSize;
+        manifest.checkpointArchiveCodec = archive.codec;
+        await this.writeManifest(options.version, manifest);
+        await this.pruneOld();
+        return manifest;
+    }
+    async readManifest(version) {
+        const manifestPath = join(this.versionDir(version), 'manifest.json');
+        const content = await fs.readFile(manifestPath, 'utf-8');
+        return this.normalizeManifest(JSON.parse(content));
+    }
+    async writeManifest(version, manifest) {
+        const manifestPath = join(this.versionDir(version), 'manifest.json');
+        await fs.writeFile(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+    }
+    async listVersions() {
+        if (!existsSync(this.storageDir)) {
+            return [];
+        }
+        const entries = await fs.readdir(this.storageDir);
+        const manifests = [];
+        for (const entry of entries) {
+            const manifestPath = join(this.storageDir, entry, 'manifest.json');
+            if (existsSync(manifestPath)) {
+                try {
+                    const content = await fs.readFile(manifestPath, 'utf-8');
+                    manifests.push(this.normalizeManifest(JSON.parse(content)));
+                }
+                catch {
+                    // Skip corrupted manifests
+                }
+            }
+        }
+        // Sort by createdAt descending (newest first)
+        manifests.sort((a, b) => new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime());
+        return manifests;
+    }
+    async getActive() {
+        const pointerPath = join(this.storageDir, ACTIVE_POINTER_FILE);
+        if (!existsSync(pointerPath)) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(pointerPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+    async setActive(version) {
+        // Verify version exists
+        const versionDir = this.versionDir(version);
+        if (!existsSync(versionDir)) {
+            throw new Error(`Checkpoint version ${version} does not exist`);
+        }
+        const manifestPath = join(versionDir, 'manifest.json');
+        if (!existsSync(manifestPath)) {
+            throw new Error(`Checkpoint version ${version} has no manifest`);
+        }
+        await this.ensureStorageDir();
+        const pointer = {
+            version,
+            activatedAt: new Date().toISOString(),
+        };
+        const pointerPath = join(this.storageDir, ACTIVE_POINTER_FILE);
+        await fs.writeFile(pointerPath, JSON.stringify(pointer, null, 2), 'utf-8');
+    }
+    async remove(version) {
+        // Check if this is the active version
+        const active = await this.getActive();
+        if (active?.version === version) {
+            throw new Error(`Cannot remove active checkpoint version ${version}. Rollback to a different version first.`);
+        }
+        const versionDir = this.versionDir(version);
+        if (!existsSync(versionDir)) {
+            throw new Error(`Checkpoint version ${version} does not exist`);
+        }
+        await fs.rm(versionDir, { recursive: true, force: true });
+    }
+    async pruneOld() {
+        if (this.maxCheckpoints <= 0)
+            return;
+        const manifests = await this.listVersions();
+        if (manifests.length <= this.maxCheckpoints)
+            return;
+        const active = await this.getActive();
+        const toRemove = manifests.slice(this.maxCheckpoints);
+        for (const manifest of toRemove) {
+            // Never remove the active version
+            if (active?.version === manifest.version)
+                continue;
+            try {
+                const versionDir = this.versionDir(manifest.version);
+                await fs.rm(versionDir, { recursive: true, force: true });
+            }
+            catch {
+                // Ignore removal failures during pruning
+            }
+        }
+    }
+    normalizeManifest(manifest) {
+        const normalizedAssets = (manifest.assets ?? []).map((asset) => ({
+            ...asset,
+            contentHash: asset.contentHash ?? asset.hash,
+            contentSize: asset.contentSize ?? asset.size,
+            blobPath: asset.blobPath ?? asset.storedPath,
+            blobHash: asset.blobHash,
+            blobSize: asset.blobSize,
+            codec: inferLegacyAssetCodec(asset),
+        }));
+        return {
+            formatVersion: manifest.formatVersion ?? CHECKPOINT_FORMAT_VERSION,
+            version: manifest.version ?? 'unknown',
+            createdAt: manifest.createdAt ?? new Date(0).toISOString(),
+            entrypoint: manifest.entrypoint ?? 'checkpoint.js',
+            routes: manifest.routes ?? [],
+            assets: normalizedAssets,
+            bundleHash: manifest.bundleHash ?? '',
+            bundleSize: manifest.bundleSize ?? 0,
+            checkpointArchivePath: manifest.checkpointArchivePath,
+            checkpointArchiveHash: manifest.checkpointArchiveHash,
+            checkpointArchiveSize: manifest.checkpointArchiveSize,
+            checkpointArchiveCodec: manifest.checkpointArchiveCodec,
+        };
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/checkpoint/manager.js.map

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

package/dist/checkpoint/process-manager.d.ts

@@ -0,0 +1,35 @@
+import type { CheckpointManifest } from './types';
+export interface SpawnedCheckpoint {
+    version: string;
+    socketPath: string;
+    process: ReturnType<typeof Bun.spawn>;
+    pid: number;
+}
+export interface CheckpointProcessManagerOptions {
+    readyTimeoutMs?: number;
+    idleTimeoutMs?: number;
+}
+export declare class CheckpointProcessManager {
+    private running;
+    private pending;
+    private readyTimeoutMs;
+    private idleTimeoutMs;
+    private idleTimers;
+    private lastUsedAt;
+    private materializer;
+    constructor(options?: number | CheckpointProcessManagerOptions);
+    spawn(manifest: CheckpointManifest, storageDir: string): Promise<SpawnedCheckpoint>;
+    private doSpawn;
+    markUsed(version: string): void;
+    stop(version: string): Promise<void>;
+    stopAll(): Promise<void>;
+    isRunning(version: string): boolean;
+    getRunning(version: string): SpawnedCheckpoint | undefined;
+    health(version: string): Promise<boolean>;
+    getRunningVersions(): string[];
+    private scheduleIdleCheck;
+    private handleIdleCheck;
+    private clearIdleTimer;
+    private tryUnlinkSocket;
+}
+//# sourceMappingURL=process-manager.d.ts.map

package/dist/checkpoint/process-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-manager.d.ts","sourceRoot":"","sources":["../../src/checkpoint/process-manager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAKlD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACtC,GAAG,EAAE,MAAM,CAAC;CACb;AAMD,MAAM,WAAW,+BAA+B;IAC9C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,qBAAa,wBAAwB;IACnC,OAAO,CAAC,OAAO,CAA6C;IAC5D,OAAO,CAAC,OAAO,CAAsD;IACrE,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAyD;IAC3E,OAAO,CAAC,UAAU,CAAkC;IACpD,OAAO,CAAC,YAAY,CAAiC;gBAEzC,OAAO,GAAE,MAAM,GAAG,+BAA0D;IAYlF,KAAK,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAsB3E,OAAO;IAsDrB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAOzB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BpC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAInC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIpD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe/C,kBAAkB,IAAI,MAAM,EAAE;IAI9B,OAAO,CAAC,iBAAiB;YAoBX,eAAe;IAqB7B,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,eAAe;CASxB"}

package/dist/checkpoint/process-manager.js

@@ -0,0 +1,203 @@
+import { existsSync, promises as fs, unlinkSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { waitForReady } from './ipc';
+import { CheckpointArtifactMaterializer } from './artifacts/materializer';
+import { resolveCheckpointSocketPath } from './socket-path';
+const DEFAULT_READY_TIMEOUT_MS = 10_000;
+const DEFAULT_IDLE_TIMEOUT_MS = 10 * 60 * 1000;
+const STOP_TIMEOUT_MS = 5_000;
+export class CheckpointProcessManager {
+    running = new Map();
+    pending = new Map();
+    readyTimeoutMs;
+    idleTimeoutMs;
+    idleTimers = new Map();
+    lastUsedAt = new Map();
+    materializer;
+    constructor(options = DEFAULT_READY_TIMEOUT_MS) {
+        if (typeof options === 'number') {
+            this.readyTimeoutMs = options;
+            this.idleTimeoutMs = DEFAULT_IDLE_TIMEOUT_MS;
+        }
+        else {
+            this.readyTimeoutMs = options.readyTimeoutMs ?? DEFAULT_READY_TIMEOUT_MS;
+            this.idleTimeoutMs = options.idleTimeoutMs ?? DEFAULT_IDLE_TIMEOUT_MS;
+        }
+        this.materializer = new CheckpointArtifactMaterializer();
+    }
+    async spawn(manifest, storageDir) {
+        // Return already-running checkpoint
+        if (this.running.has(manifest.version)) {
+            return this.running.get(manifest.version);
+        }
+        // Return in-flight spawn to prevent duplicate processes for same version
+        if (this.pending.has(manifest.version)) {
+            return this.pending.get(manifest.version);
+        }
+        const promise = this.doSpawn(manifest, storageDir);
+        this.pending.set(manifest.version, promise);
+        try {
+            const result = await promise;
+            return result;
+        }
+        finally {
+            this.pending.delete(manifest.version);
+        }
+    }
+    async doSpawn(manifest, storageDir) {
+        const versionDir = join(storageDir, manifest.version);
+        const bundlePath = join(versionDir, manifest.entrypoint);
+        const socketPath = resolveCheckpointSocketPath(storageDir, manifest.version);
+        if (!existsSync(bundlePath)) {
+            throw new Error(`Checkpoint bundle not found: ${bundlePath}`);
+        }
+        // Materialize declared assets into the checkpoint version directory before boot.
+        await this.materializer.materialize(manifest, storageDir);
+        // Ensure socket parent exists when fallback roots are used.
+        await fs.mkdir(dirname(socketPath), { recursive: true });
+        // Clean up stale socket file if it exists
+        this.tryUnlinkSocket(socketPath);
+        const proc = Bun.spawn(['bun', 'run', bundlePath], {
+            env: {
+                ...process.env,
+                VECTOR_CHECKPOINT_SOCKET: socketPath,
+                VECTOR_CHECKPOINT_VERSION: manifest.version,
+            },
+            stdout: 'pipe',
+            stderr: 'inherit',
+        });
+        // Guard against null stdout (shouldn't happen with stdout: 'pipe' but be safe)
+        if (!proc.stdout) {
+            proc.kill('SIGTERM');
+            throw new Error(`Checkpoint process for ${manifest.version} did not provide stdout`);
+        }
+        try {
+            await waitForReady(proc.stdout, this.readyTimeoutMs);
+        }
+        catch (err) {
+            proc.kill('SIGTERM');
+            throw err;
+        }
+        const spawned = {
+            version: manifest.version,
+            socketPath,
+            process: proc,
+            pid: proc.pid,
+        };
+        this.running.set(manifest.version, spawned);
+        this.lastUsedAt.set(manifest.version, Date.now());
+        this.scheduleIdleCheck(manifest.version);
+        return spawned;
+    }
+    markUsed(version) {
+        if (!this.running.has(version)) {
+            return;
+        }
+        this.lastUsedAt.set(version, Date.now());
+    }
+    async stop(version) {
+        const snap = this.running.get(version);
+        if (!snap)
+            return;
+        this.running.delete(version);
+        this.clearIdleTimer(version);
+        this.lastUsedAt.delete(version);
+        snap.process.kill('SIGTERM');
+        // Wait for exit with a timeout
+        const exited = await Promise.race([
+            snap.process.exited.then(() => true),
+            new Promise((resolve) => setTimeout(() => resolve(false), STOP_TIMEOUT_MS)),
+        ]);
+        // Force kill if SIGTERM didn't work
+        if (!exited) {
+            try {
+                snap.process.kill('SIGKILL');
+                await snap.process.exited;
+            }
+            catch {
+                // Process may have already exited between the check and SIGKILL
+            }
+        }
+        this.tryUnlinkSocket(snap.socketPath);
+    }
+    async stopAll() {
+        const versions = [...this.running.keys()];
+        for (const version of versions) {
+            await this.stop(version);
+        }
+    }
+    isRunning(version) {
+        return this.running.has(version);
+    }
+    getRunning(version) {
+        return this.running.get(version);
+    }
+    async health(version) {
+        const snap = this.running.get(version);
+        if (!snap)
+            return false;
+        try {
+            const response = await fetch('http://localhost/_vector/health', {
+                unix: snap.socketPath,
+                signal: AbortSignal.timeout(2000),
+            });
+            return response.ok;
+        }
+        catch {
+            return false;
+        }
+    }
+    getRunningVersions() {
+        return [...this.running.keys()];
+    }
+    scheduleIdleCheck(version, delayMs = this.idleTimeoutMs) {
+        this.clearIdleTimer(version);
+        if (this.idleTimeoutMs <= 0) {
+            return;
+        }
+        const timer = setTimeout(() => {
+            void this.handleIdleCheck(version);
+        }, Math.max(1, delayMs));
+        if (typeof timer.unref === 'function') {
+            timer.unref();
+        }
+        this.idleTimers.set(version, timer);
+    }
+    async handleIdleCheck(version) {
+        if (!this.running.has(version)) {
+            return;
+        }
+        const lastUsedAt = this.lastUsedAt.get(version) ?? 0;
+        const idleForMs = Date.now() - lastUsedAt;
+        const remainingMs = this.idleTimeoutMs - idleForMs;
+        if (remainingMs > 0) {
+            this.scheduleIdleCheck(version, remainingMs);
+            return;
+        }
+        try {
+            await this.stop(version);
+        }
+        catch (error) {
+            console.error(`[CheckpointProcessManager] Failed to stop idle checkpoint ${version}:`, error);
+        }
+    }
+    clearIdleTimer(version) {
+        const timer = this.idleTimers.get(version);
+        if (!timer) {
+            return;
+        }
+        clearTimeout(timer);
+        this.idleTimers.delete(version);
+    }
+    tryUnlinkSocket(socketPath) {
+        try {
+            if (existsSync(socketPath)) {
+                unlinkSync(socketPath);
+            }
+        }
+        catch {
+            // Ignore cleanup failures
+        }
+    }
+}
+//# sourceMappingURL=process-manager.js.map

package/dist/checkpoint/process-manager.js.map

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

package/dist/checkpoint/resolver.d.ts

@@ -0,0 +1,25 @@
+import type { CheckpointManager } from './manager';
+import type { CheckpointProcessManager } from './process-manager';
+export interface CheckpointResolverOptions {
+    versionHeader?: string;
+    cacheKeyOverride?: boolean;
+}
+export declare class CheckpointResolver {
+    private manager;
+    private processManager;
+    private versionHeader;
+    private cacheKeyOverride;
+    private allowFallbackVersionHeader;
+    private pendingVersionResolves;
+    constructor(manager: CheckpointManager, processManager: CheckpointProcessManager, options?: CheckpointResolverOptions);
+    resolve(request: Request): Promise<string | null>;
+    getRequestedVersion(request: Request): string | null;
+    getCacheKeyOverrideValue(request: Request): string | null;
+    private getRequestedHeader;
+    private resolveVersion;
+    /**
+     * Legacy no-op retained for compatibility with tests and existing integrations.
+     */
+    invalidateCache(): void;
+}
+//# sourceMappingURL=resolver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/checkpoint/resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAKlE,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,gBAAgB,CAAU;IAClC,OAAO,CAAC,0BAA0B,CAAU;IAC5C,OAAO,CAAC,sBAAsB,CAAkD;gBAG9E,OAAO,EAAE,iBAAiB,EAC1B,cAAc,EAAE,wBAAwB,EACxC,OAAO,GAAE,yBAA8B;IASnC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQvD,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAIpD,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI;IAazD,OAAO,CAAC,kBAAkB;YAgBZ,cAAc;IAwC5B;;OAEG;IACH,eAAe,IAAI,IAAI;CAGxB"}