@atomic-chat/core 0.5.1 → 0.13.2

package/dist/runtime/vllm/memory.js

@@ -0,0 +1,123 @@
+import { freeMemoryBytes, isUnifiedMemory, kvCacheQuantAlgo, readKvCacheShape, totalMemoryBytes, } from '../managed-models/index.js';
+const GiB = 1024 ** 3;
+const MiB = 1024 ** 2;
+/** What vLLM holds beyond weights and KV cache: CUDA context, activations, sampler, graphs. */
+export const VLLM_ENGINE_OVERHEAD_BYTES = 2 * GiB;
+/** Counted as needed in the memory check: what other processes may still take meanwhile. */
+export const VLLM_FREE_MEMORY_MARGIN_BYTES = 512 * MiB;
+/**
+ * Left out of the share vLLM is given: more than vLLM's own CUDA context, which already holds memory
+ * when vLLM checks the share at start (0.87 GiB under WSL on an RTX 4070 Laptop, 2026-10-06).
+ */
+export const VLLM_START_CHECK_MARGIN_BYTES = 1536 * MiB;
+/** The highest share of a card vLLM is ever given. */
+export const VLLM_MAX_GPU_MEMORY_UTILIZATION = 0.95;
+/** On a card with the host's memory: contexts the KV cache holds, as for TensorRT-LLM (design D9). */
+export const VLLM_UNIFIED_KV_CONTEXTS = 2;
+/** Without the model's KV shape: a quarter of the weights, at least 1 GiB. */
+const FALLBACK_KV_WEIGHT_SHARE = 0.25;
+const FALLBACK_KV_MIN_BYTES = GiB;
+/** Compute capability 8.9 (Ada) and newer. */
+function supportsFp8Kv(computeCapability) {
+    const [major, minor] = computeCapability.split('.').map((part) => Number.parseInt(part, 10));
+    if (major === undefined || Number.isNaN(major))
+        return false;
+    return major > 8 || (major === 8 && (minor ?? 0) >= 9);
+}
+/** The tokens the KV cache estimate covers: context × requests (two contexts on unified memory). */
+export function vllmKvTokens(settings, unifiedMemory) {
+    return unifiedMemory
+        ? settings.context_length * VLLM_UNIFIED_KV_CONTEXTS
+        : settings.context_length * settings.max_num_seqs;
+}
+/**
+ * The KV cache the memory check counts: the KV cache size setting when set, else an estimate from the
+ * model's attention layers — and whether the model's shape sized it. vLLM sizes its own KV cache
+ * unless the setting fixes it, so this only feeds the check's verdict.
+ */
+export function vllmKvCacheBytes(checkpoint, settings, gpu, unifiedMemory) {
+    if (settings.kv_cache_memory_gib !== null) {
+        return { bytes: Math.round(settings.kv_cache_memory_gib * GiB), basis: 'config' };
+    }
+    const shape = readKvCacheShape(checkpoint.configJson);
+    if (shape === undefined) {
+        const weights = checkpoint.weightBytesTotal ?? 0;
+        return {
+            bytes: Math.max(FALLBACK_KV_MIN_BYTES, Math.ceil(weights * FALLBACK_KV_WEIGHT_SHARE)),
+            basis: 'weight_fraction',
+        };
+    }
+    const fp8 = (settings.kv_cache_dtype === 'fp8' && supportsFp8Kv(gpu.compute_capability)) ||
+        kvCacheQuantAlgo(checkpoint.configJson, checkpoint.hfQuantConfigJson)?.toUpperCase() === 'FP8';
+    const perToken = 2 * shape.numHiddenLayers * shape.numKeyValueHeads * shape.headDim * (fp8 ? 1 : 2);
+    return { bytes: perToken * vllmKvTokens(settings, unifiedMemory), basis: 'config' };
+}
+/**
+ * The weights vLLM puts on the card: weights offloaded to the CPU (`cpu_offload_gb`, GiB as vLLM counts
+ * them) leave it, except on a card with the host's memory, where they stay in the same memory.
+ */
+function vllmWeightsOnCard(checkpoint, settings, unified) {
+    const offloadedBytes = unified
+        ? 0
+        : Math.min(checkpoint.weightBytesTotal, Math.round(settings.cpu_offload_gb * 1024 ** 3));
+    return { weightsOnCard: checkpoint.weightBytesTotal - offloadedBytes, offloadedBytes };
+}
+/**
+ * vLLM's memory rule on `gpu`: weights on the card + KV cache in bytes + its own overhead (CUDA context
+ * included) + a margin for what other processes may take meanwhile; on a card with the host's memory,
+ * whatever of `MemAvailable` lies beyond half the host's memory counts as needed too.
+ */
+export function vllmMemoryNeed(gpu, checkpoint, settings, host) {
+    const unified = isUnifiedMemory(gpu);
+    const kv = vllmKvCacheBytes(checkpoint, settings, gpu, unified);
+    const systemReserve = unified
+        ? Math.max(0, freeMemoryBytes(gpu, host) - totalMemoryBytes(gpu, host) / 2)
+        : 0;
+    const { weightsOnCard, offloadedBytes } = vllmWeightsOnCard(checkpoint, settings, unified);
+    const neededBytes = weightsOnCard + kv.bytes + VLLM_ENGINE_OVERHEAD_BYTES + VLLM_FREE_MEMORY_MARGIN_BYTES + systemReserve;
+    return {
+        neededBytes,
+        kvReserveBasis: kv.basis,
+        details: `weight_bytes=${checkpoint.weightBytesTotal}` +
+            (offloadedBytes > 0 ? ` cpu_offload_bytes=${offloadedBytes}` : '') +
+            ` kv_cache_bytes=${kv.bytes} kv_reserve_basis=${kv.basis} ` +
+            `engine_overhead_bytes=${VLLM_ENGINE_OVERHEAD_BYTES} free_margin_bytes=${VLLM_FREE_MEMORY_MARGIN_BYTES}` +
+            (unified ? ` system_reserve_bytes=${systemReserve}` : '') +
+            ` needed_bytes=${neededBytes}`,
+    };
+}
+/** A vision or audio part in the checkpoint: a multimodal architecture, or its encoder's config. */
+function isMultimodal(configJson) {
+    const architectures = Array.isArray(configJson['architectures']) ? configJson['architectures'] : [];
+    return (architectures.some((name) => typeof name === 'string' && name.endsWith('ForConditionalGeneration')) ||
+        ['vision_config', 'audio_config', 'vision_tower'].some((key) => key in configJson));
+}
+/** `--gpu-memory-utilization` from the card as it stands now (see the file banner). */
+export function vllmGpuMemoryUtilization(gpu, host) {
+    const total = totalMemoryBytes(gpu, host);
+    if (total <= 0)
+        return VLLM_MAX_GPU_MEMORY_UTILIZATION;
+    let available = freeMemoryBytes(gpu, host) - VLLM_START_CHECK_MARGIN_BYTES;
+    // On the host's memory, half of it stays the system's (the same rule as TensorRT-LLM's).
+    if (isUnifiedMemory(gpu))
+        available = Math.min(available, total / 2);
+    const share = Math.min(VLLM_MAX_GPU_MEMORY_UTILIZATION, available / total);
+    return Math.max(0.01, Math.floor(share * 10_000) / 10_000);
+}
+/** The launch plan `beforeCreate` hands the adapter, from the card re-probed right before the container. */
+export function vllmLaunchPlan(settings, checkpoint, gpu, host) {
+    return {
+        kvCacheMemoryBytes: settings.kv_cache_memory_gib === null ? null : Math.round(settings.kv_cache_memory_gib * GiB),
+        gpuMemoryUtilization: settings.gpu_memory_utilization ?? vllmGpuMemoryUtilization(gpu, host),
+        multimodal: isMultimodal(checkpoint.configJson),
+    };
+}
+/** The check skeleton's hooks for vLLM: its memory rule, and no checkpoint quirks of its own. */
+export function vllmCheckEngine(settings) {
+    return {
+        engineId: 'vllm',
+        checkpointProblems: () => null,
+        memoryNeed: (gpu, checkpoint, host) => vllmMemoryNeed(gpu, checkpoint, settings, host),
+    };
+}
+//# sourceMappingURL=memory.js.map

package/dist/runtime/vllm/memory.js.map

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

package/dist/runtime/vllm/settings.d.ts

@@ -0,0 +1,52 @@
+import { type GenerationDefaults } from '../managed-text/generation-defaults.js';
+export interface VllmSettings {
+    /** `GPU-<uuid>`/`MIG-<uuid>`, or `null` to let the load pick the card with the most free memory. */
+    gpu_id: string | null;
+    context_length: number;
+    max_output_tokens: number;
+    /** `--max-num-seqs`. */
+    max_num_seqs: number;
+    /**
+     * `--kv-cache-memory-bytes`, in GiB; `null` passes nothing, and vLLM sizes the KV cache itself from
+     * the memory its share of the card leaves after the weights (it knows every model's KV shape,
+     * hybrid ones included).
+     */
+    kv_cache_memory_gib: number | null;
+    /**
+     * `--gpu-memory-utilization`: the share of the card vLLM may take; `null` (auto) lets core compute it
+     * from the card's free memory right before the container (`vllmGpuMemoryUtilization`).
+     */
+    gpu_memory_utilization: number | null;
+    cuda_graphs: 'auto' | 'on' | 'off';
+    kv_cache_dtype: 'auto' | 'fp8';
+    /** Seconds. `null` leaves the adapter's own weight-based estimate in force. */
+    load_timeout_seconds: number | null;
+    /** `--max-num-batched-tokens`; `null` leaves vLLM's own. */
+    max_num_batched_tokens: number | null;
+    /** `false` passes `--no-enable-prefix-caching`; vLLM's own default is on. */
+    enable_prefix_caching: boolean;
+    /** `--cpu-offload-gb`, GiB of weights kept in host memory; counted off the card by the check. */
+    cpu_offload_gb: number;
+    /** `--dtype` of unquantized weights and activations; `auto` passes nothing. */
+    dtype: 'auto' | 'float16' | 'bfloat16' | 'float32';
+    /** `--seed`; `null` leaves vLLM's own. */
+    seed: number | null;
+    /** `--async-scheduling`. */
+    async_scheduling: boolean;
+    /**
+     * Sampling defaults for a request that sets none, in vLLM's generation-config names: they join
+     * `max_new_tokens` in `--override-generation-config`. A key is present only when the person set it;
+     * otherwise the model's own `generation_config.json` stands.
+     */
+    generation: VllmGenerationDefaults;
+}
+export type VllmGenerationDefaults = GenerationDefaults;
+/** Validates already-merged values; anything absent takes the schema's default. */
+export declare function validateVllmSettings(raw: Record<string, unknown>): VllmSettings;
+/**
+ * Stored values, overlaid by a load's own overrides (the control API's `overrides`), reduced to this
+ * provider's keys and validated. Anything else in either object — another provider's key, a stray
+ * field a client sent — is ignored rather than passed to the engine. `''` and `0` are the stored
+ * spelling of "not set" (`''` for a generation default, whose `0` can be a real value).
+ */
+export declare function vllmSettings(stored: Record<string, unknown>, overrides?: Record<string, unknown>): VllmSettings;

package/dist/runtime/vllm/settings.js

@@ -0,0 +1,151 @@
+/**
+ * The `vllm` provider's settings (change `add-vllm-runtime`, task 3.1; spec `vllm-runtime`, "Выбор
+ * карты и настройки провайдера vllm"): stored values, overlaid by a load's own overrides, reduced to
+ * this provider's keys and validated before anything is asked of the machine — `INVALID_ARGUMENT` for
+ * anything the schema (`src/settings/schema/vllm.json`) would refuse. What the engine is never told
+ * by a setting: `trust_remote_code`, request logging, an API key — no key here reaches it.
+ */
+import { AtomicCoreError } from '../../contracts/index.js';
+import { GENERATION_DEFAULT_KEYS, readGenerationDefaults, } from '../managed-text/generation-defaults.js';
+const KEYS = [
+    'gpu_id',
+    'context_length',
+    'max_output_tokens',
+    'max_num_seqs',
+    'kv_cache_memory_gib',
+    'gpu_memory_utilization',
+    'cuda_graphs',
+    'kv_cache_dtype',
+    'load_timeout_seconds',
+    'max_num_batched_tokens',
+    'enable_prefix_caching',
+    'cpu_offload_gb',
+    'dtype',
+    'seed',
+    'async_scheduling',
+    ...Object.values(GENERATION_DEFAULT_KEYS),
+];
+const DEFAULTS = {
+    gpu_id: null,
+    context_length: 8192,
+    max_output_tokens: 4096,
+    // One request at a time (owner's decision).
+    max_num_seqs: 1,
+    kv_cache_memory_gib: null,
+    gpu_memory_utilization: null,
+    cuda_graphs: 'auto',
+    kv_cache_dtype: 'auto',
+    load_timeout_seconds: null,
+    max_num_batched_tokens: null,
+    enable_prefix_caching: true,
+    cpu_offload_gb: 0,
+    dtype: 'auto',
+    seed: null,
+    async_scheduling: false,
+    generation: {},
+};
+const GPU_UUID = /^(GPU|MIG)-[0-9A-Za-z-]+$/;
+const invalid = (key, value, why) => {
+    throw new AtomicCoreError('INVALID_ARGUMENT', `vllm setting ${key} ${why}.`, `${key}=${JSON.stringify(value)}`);
+};
+function integer(key, value, min, max) {
+    const number = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+    if (typeof number !== 'number' || !Number.isInteger(number) || number < min || number > max) {
+        return invalid(key, value, `must be a whole number from ${min} to ${max}`);
+    }
+    return number;
+}
+function decimal(key, value, inRange, range) {
+    const number = typeof value === 'string' && value.trim() !== '' ? Number(value) : value;
+    if (typeof number !== 'number' || !Number.isFinite(number) || !inRange(number)) {
+        return invalid(key, value, `must be a number ${range}`);
+    }
+    return number;
+}
+function yesNo(key, value) {
+    if (value === true || value === 'true')
+        return true;
+    if (value === false || value === 'false')
+        return false;
+    return invalid(key, value, 'must be true or false');
+}
+function oneOf(key, value, allowed) {
+    return allowed.includes(value)
+        ? value
+        : invalid(key, value, `must be one of ${allowed.join(', ')}`);
+}
+/** Validates already-merged values; anything absent takes the schema's default. */
+export function validateVllmSettings(raw) {
+    const settings = { ...DEFAULTS };
+    if (raw['gpu_id'] !== undefined && raw['gpu_id'] !== null) {
+        if (typeof raw['gpu_id'] !== 'string' || !GPU_UUID.test(raw['gpu_id'])) {
+            invalid('gpu_id', raw['gpu_id'], 'must be an NVIDIA GPU or MIG UUID');
+        }
+        settings.gpu_id = raw['gpu_id'];
+    }
+    if (raw['context_length'] !== undefined)
+        settings.context_length = integer('context_length', raw['context_length'], 512, 1_048_576);
+    if (raw['max_output_tokens'] !== undefined)
+        settings.max_output_tokens = integer('max_output_tokens', raw['max_output_tokens'], 1, 1_048_576);
+    if (raw['max_num_seqs'] !== undefined)
+        settings.max_num_seqs = integer('max_num_seqs', raw['max_num_seqs'], 1, 256);
+    if (raw['kv_cache_memory_gib'] !== undefined && raw['kv_cache_memory_gib'] !== null)
+        settings.kv_cache_memory_gib = decimal('kv_cache_memory_gib', raw['kv_cache_memory_gib'], (n) => n > 0 && n <= 1024, 'above 0 and at most 1024');
+    if (raw['gpu_memory_utilization'] !== undefined && raw['gpu_memory_utilization'] !== null)
+        settings.gpu_memory_utilization = decimal('gpu_memory_utilization', raw['gpu_memory_utilization'], (n) => n > 0 && n <= 1, 'above 0 and at most 1');
+    if (raw['cuda_graphs'] !== undefined)
+        settings.cuda_graphs = oneOf('cuda_graphs', raw['cuda_graphs'], ['auto', 'on', 'off']);
+    if (raw['kv_cache_dtype'] !== undefined)
+        settings.kv_cache_dtype = oneOf('kv_cache_dtype', raw['kv_cache_dtype'], ['auto', 'fp8']);
+    if (raw['load_timeout_seconds'] !== undefined && raw['load_timeout_seconds'] !== null)
+        settings.load_timeout_seconds = integer('load_timeout_seconds', raw['load_timeout_seconds'], 1, 3600);
+    if (raw['max_num_batched_tokens'] !== undefined && raw['max_num_batched_tokens'] !== null)
+        settings.max_num_batched_tokens = integer('max_num_batched_tokens', raw['max_num_batched_tokens'], 1, 1_048_576);
+    if (raw['enable_prefix_caching'] !== undefined)
+        settings.enable_prefix_caching = yesNo('enable_prefix_caching', raw['enable_prefix_caching']);
+    if (raw['cpu_offload_gb'] !== undefined)
+        settings.cpu_offload_gb = decimal('cpu_offload_gb', raw['cpu_offload_gb'], (n) => n >= 0 && n <= 1024, 'from 0 to 1024');
+    if (raw['dtype'] !== undefined)
+        settings.dtype = oneOf('dtype', raw['dtype'], ['auto', 'float16', 'bfloat16', 'float32']);
+    if (raw['seed'] !== undefined && raw['seed'] !== null)
+        settings.seed = integer('seed', raw['seed'], 1, 2_147_483_647);
+    if (raw['async_scheduling'] !== undefined)
+        settings.async_scheduling = yesNo('async_scheduling', raw['async_scheduling']);
+    settings.generation = readGenerationDefaults('vllm', raw);
+    if (settings.max_output_tokens >= settings.context_length) {
+        invalid('max_output_tokens', settings.max_output_tokens, `must be less than the context length (${settings.context_length})`);
+    }
+    return settings;
+}
+/**
+ * Stored values, overlaid by a load's own overrides (the control API's `overrides`), reduced to this
+ * provider's keys and validated. Anything else in either object — another provider's key, a stray
+ * field a client sent — is ignored rather than passed to the engine. `''` and `0` are the stored
+ * spelling of "not set" (`''` for a generation default, whose `0` can be a real value).
+ */
+export function vllmSettings(stored, overrides = {}) {
+    const merged = {};
+    for (const key of KEYS) {
+        const value = key in overrides ? overrides[key] : stored[key];
+        if (value !== undefined)
+            merged[key] = value;
+    }
+    if (typeof merged['gpu_id'] === 'string' && merged['gpu_id'].trim() === '')
+        merged['gpu_id'] = null;
+    if (merged['load_timeout_seconds'] === 0)
+        merged['load_timeout_seconds'] = null;
+    if (merged['kv_cache_memory_gib'] === 0)
+        merged['kv_cache_memory_gib'] = null;
+    if (merged['gpu_memory_utilization'] === 0)
+        merged['gpu_memory_utilization'] = null;
+    if (merged['max_num_batched_tokens'] === 0)
+        merged['max_num_batched_tokens'] = null;
+    if (merged['seed'] === 0)
+        merged['seed'] = null;
+    for (const key of Object.values(GENERATION_DEFAULT_KEYS)) {
+        if (typeof merged[key] === 'string' && merged[key].trim() === '')
+            merged[key] = null;
+    }
+    return validateVllmSettings(merged);
+}
+//# sourceMappingURL=settings.js.map

package/dist/runtime/vllm/settings.js.map

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

package/dist/runtime/wsl/guest-paths.d.ts

@@ -0,0 +1,33 @@
+import type { ManagedScopePaths } from '../../config/index.js';
+/** Every scope's guest root lives under this. */
+export declare const GUEST_SCOPES_ROOT = "/var/lib/atomic-chat/scopes";
+/** `/var/lib/atomic-chat/scopes/<key>`; the key is core's own random id, never a path segment it was given. */
+export declare function guestScopeRoot(scopeKey: string): string;
+/** A guest path as Windows opens it: `\\wsl.localhost\<distro>\…`. */
+export declare function uncPathFor(distribution: string, guestPath: string): string;
+/**
+ * The guest path behind a `\\wsl.localhost\<distro>\…` (or `\\wsl$\…`) path of this distribution.
+ * Throws `INVALID_ARGUMENT` for anything else, a `..` segment included.
+ */
+export declare function guestPathFor(distribution: string, uncPath: string): string;
+/**
+ * How this process reaches a distribution's files: `\\wsl.localhost\<distribution>\…` in production
+ * (`WSL_LOCALHOST_MOUNT`); a plain folder standing in for the guest's file system under the managed
+ * e2e test hook (`directoryGuestMount`). Everything that turns a guest path into one core opens, or
+ * back, goes through one of these, so the test hook changes nothing else.
+ */
+export interface GuestMount {
+    /** A guest path as this process opens it. */
+    hostPath(distribution: string, guestPath: string): string;
+    /** The guest path behind one of this process's paths; `INVALID_ARGUMENT` for anything outside it. */
+    guestPath(distribution: string, hostPath: string): string;
+}
+export declare const WSL_LOCALHOST_MOUNT: GuestMount;
+/** Tests only: `<root>/<distribution>/<guest path>` stands in for `\\wsl.localhost\<distribution>\<guest path>`. */
+export declare function directoryGuestMount(root: string): GuestMount;
+/**
+ * This scope's managed paths on Windows: heartbeats, engine caches and the watchdog script in the
+ * guest (as core reaches them, through `mount`), the journal and docker config where they were. Same
+ * layout below the root as Linux's (`config/paths.ts`), so nothing above it changes.
+ */
+export declare function guestScopePaths(windows: ManagedScopePaths, distribution: string, scopeKey: string, mount?: GuestMount): ManagedScopePaths;

package/dist/runtime/wsl/guest-paths.js

@@ -0,0 +1,83 @@
+/**
+ * Where a Windows scope's managed files live, and how each side names them (change
+ * `add-tensorrt-llm-windows`, task 2.6, design D5). Everything a model container sees — the model,
+ * its engine cache, the heartbeat, the watchdog script — is in the guest's ext4, under one root per
+ * scope: `/var/lib/atomic-chat/scopes/<scope_key>/`. Loading weights over the VM boundary (9p) is
+ * several times slower, so nothing the engine reads is left on NTFS.
+ *
+ * Core (on Windows) reaches the same files as `\\wsl.localhost\<distro>\var\lib\atomic-chat\…`;
+ * Docker (in the guest) mounts them as `/var/lib/atomic-chat/…`. `uncPathFor` and `guestPathFor` are
+ * the one translation between the two, and `guestPathFor` refuses anything that is not inside the
+ * named distribution — a Windows path, another distribution, a `..` climbing out — so a guest mount can
+ * never be pointed at the Windows disk or at someone else's files. The execution journal and the
+ * docker config stay on Windows: they are core's own state, not the container's.
+ */
+import { isAbsolute, join, relative, sep } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+/** Every scope's guest root lives under this. */
+export const GUEST_SCOPES_ROOT = '/var/lib/atomic-chat/scopes';
+const SCOPE_KEY = /^[A-Za-z0-9-]{1,64}$/;
+const UNC_PREFIX = /^[\\/]{2}(wsl\.localhost|wsl\$)[\\/]([^\\/]+)(?:[\\/](.*))?$/i;
+const outside = (path) => new AtomicCoreError('INVALID_ARGUMENT', 'The path is not inside the Atomic Chat distribution.', path);
+/** `/var/lib/atomic-chat/scopes/<key>`; the key is core's own random id, never a path segment it was given. */
+export function guestScopeRoot(scopeKey) {
+    if (!SCOPE_KEY.test(scopeKey))
+        throw new AtomicCoreError('INVALID_ARGUMENT', 'Not a scope key.', scopeKey);
+    return `${GUEST_SCOPES_ROOT}/${scopeKey}`;
+}
+/** A guest path as Windows opens it: `\\wsl.localhost\<distro>\…`. */
+export function uncPathFor(distribution, guestPath) {
+    const relative = guestPath.replace(/^\/+/, '').split('/').filter(Boolean).join('\\');
+    return `\\\\wsl.localhost\\${distribution}${relative === '' ? '' : `\\${relative}`}`;
+}
+/**
+ * The guest path behind a `\\wsl.localhost\<distro>\…` (or `\\wsl$\…`) path of this distribution.
+ * Throws `INVALID_ARGUMENT` for anything else, a `..` segment included.
+ */
+export function guestPathFor(distribution, uncPath) {
+    const match = UNC_PREFIX.exec(uncPath);
+    if (match === null || match[2].toLowerCase() !== distribution.toLowerCase())
+        throw outside(uncPath);
+    const segments = (match[3] ?? '').split(/[\\/]+/).filter(Boolean);
+    if (segments.some((segment) => segment === '..' || segment === '.'))
+        throw outside(uncPath);
+    return `/${segments.join('/')}`;
+}
+export const WSL_LOCALHOST_MOUNT = { hostPath: uncPathFor, guestPath: guestPathFor };
+/** Tests only: `<root>/<distribution>/<guest path>` stands in for `\\wsl.localhost\<distribution>\<guest path>`. */
+export function directoryGuestMount(root) {
+    return {
+        hostPath: (distribution, guestPath) => join(root, distribution, ...guestPath.split('/').filter(Boolean)),
+        guestPath: (distribution, hostPath) => {
+            const inside = relative(join(root, distribution), hostPath);
+            if (inside === '' || inside.startsWith('..') || isAbsolute(inside))
+                throw outside(hostPath);
+            return `/${inside.split(sep).join('/')}`;
+        },
+    };
+}
+/**
+ * This scope's managed paths on Windows: heartbeats, engine caches and the watchdog script in the
+ * guest (as core reaches them, through `mount`), the journal and docker config where they were. Same
+ * layout below the root as Linux's (`config/paths.ts`), so nothing above it changes.
+ */
+export function guestScopePaths(windows, distribution, scopeKey, mount = WSL_LOCALHOST_MOUNT) {
+    const guestRoot = guestScopeRoot(scopeKey);
+    const inGuest = (path) => {
+        const segments = relative(windows.root, path)
+            .split(/[\\/]+/)
+            .filter(Boolean);
+        return mount.hostPath(distribution, [guestRoot, ...segments].join('/'));
+    };
+    return {
+        ...windows,
+        root: mount.hostPath(distribution, guestRoot),
+        heartbeatsDir: inGuest(windows.heartbeatsDir),
+        heartbeatDir: (generation) => inGuest(windows.heartbeatDir(generation)),
+        cachesDir: inGuest(windows.cachesDir),
+        descriptorCachesDir: (descriptorId) => inGuest(windows.descriptorCachesDir(descriptorId)),
+        engineCacheDir: (descriptorId, modelId) => inGuest(windows.engineCacheDir(descriptorId, modelId)),
+        watchdogScript: inGuest(windows.watchdogScript),
+    };
+}
+//# sourceMappingURL=guest-paths.js.map

package/dist/runtime/wsl/guest-paths.js.map

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

package/dist/runtime/wsl/guest-scope.d.ts

@@ -0,0 +1,14 @@
+import type { WslDistributionTransport } from './transport.js';
+/** The account in the guest that owns a scope's files (design D5). */
+export declare const GUEST_SCOPE_OWNER = "1000:1000";
+/** The scope's key, made on first use. A file that does not hold a valid key is an error, never replaced. */
+export declare function readOrCreateGuestScopeKey(file: string, newKey?: () => string): Promise<string>;
+/** One read (or creation) of the key shared by every caller: two first callers racing would each create one. */
+export declare function guestScopeKeyReader(file: string, newKey?: () => string): () => Promise<string>;
+/**
+ * `managed-models`, `models/tensorrt-llm`, `caches`, `heartbeats`, `watchdog` under the scope's guest root,
+ * owned by uid 1000 — and the folders directly in `managed-models` too: the store migration creates a
+ * moved model's parent (`managed-models/<org>`) as root, and a folder root owns there refuses every
+ * later download into it through `\\wsl.localhost` (`EACCES`, Windows `os error 5`).
+ */
+export declare function ensureGuestScope(transport: WslDistributionTransport, scopeKey: string): Promise<void>;

package/dist/runtime/wsl/guest-scope.js

@@ -0,0 +1,98 @@
+/**
+ * A Windows scope's own folder in the guest (change `add-tensorrt-llm-windows`, task 2.6, design D5):
+ * `scope_key` — a random id core makes once and keeps in the scope's data
+ * (`ManagedScopePaths.guestScopeFile`), so that copying the data folder elsewhere keeps pointing at the
+ * same guest folder and its models (spec "Перенос папки данных не перемещает модели") — and the folders
+ * under it, created as the guest's root and handed to uid 1000: the account the app writes models as
+ * through `\\wsl.localhost` and the model container runs as, so the files of both belong to one user.
+ */
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { AtomicCoreError } from '../../contracts/index.js';
+import { guestScopeRoot } from './guest-paths.js';
+const SCOPE_KEY = /^[A-Za-z0-9-]{1,64}$/;
+/** The account in the guest that owns a scope's files (design D5). */
+export const GUEST_SCOPE_OWNER = '1000:1000';
+/** The scope's key, made on first use. A file that does not hold a valid key is an error, never replaced. */
+export async function readOrCreateGuestScopeKey(file, newKey = randomUUID) {
+    let text = null;
+    try {
+        text = await readFile(file, 'utf8');
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT')
+            throw error;
+    }
+    if (text !== null) {
+        const parsed = JSON.parse(text);
+        if (parsed.schema_version !== 1 ||
+            typeof parsed.scope_key !== 'string' ||
+            !SCOPE_KEY.test(parsed.scope_key)) {
+            throw new AtomicCoreError('MANAGED_METADATA_INVALID', 'The guest scope key file is not valid.', file);
+        }
+        return parsed.scope_key;
+    }
+    const key = newKey();
+    await mkdir(dirname(file), { recursive: true });
+    const temp = `${file}.tmp`;
+    await writeFile(temp, `${JSON.stringify({ schema_version: 1, scope_key: key })}\n`, 'utf8');
+    await rename(temp, file);
+    return key;
+}
+/** One read (or creation) of the key shared by every caller: two first callers racing would each create one. */
+export function guestScopeKeyReader(file, newKey = randomUUID) {
+    let read = null;
+    return () => {
+        read ??= readOrCreateGuestScopeKey(file, newKey).catch((error) => {
+            read = null;
+            throw error;
+        });
+        return read;
+    };
+}
+/**
+ * `managed-models`, `models/tensorrt-llm`, `caches`, `heartbeats`, `watchdog` under the scope's guest root,
+ * owned by uid 1000 — and the folders directly in `managed-models` too: the store migration creates a
+ * moved model's parent (`managed-models/<org>`) as root, and a folder root owns there refuses every
+ * later download into it through `\\wsl.localhost` (`EACCES`, Windows `os error 5`).
+ */
+export async function ensureGuestScope(transport, scopeKey) {
+    const root = guestScopeRoot(scopeKey);
+    const store = `${root}/managed-models`;
+    const leaves = [
+        store,
+        `${root}/models/tensorrt-llm`,
+        `${root}/caches`,
+        `${root}/heartbeats`,
+        `${root}/watchdog`,
+    ];
+    const run = async (argv) => {
+        const output = await transport.exec(argv, { user: 'root', timeoutMs: 120_000 });
+        if (output.code !== 0) {
+            throw new AtomicCoreError('IO_ERROR', `The model folders could not be prepared in the distribution "${transport.name}".`, `${argv.join(' ')}: ${output.stderr.trim()}`);
+        }
+    };
+    await run(['mkdir', '-p', ...leaves]);
+    // Not recursive: the folders, never every file of every model under them.
+    await run(['chown', GUEST_SCOPE_OWNER, root, `${root}/models`, ...leaves]);
+    // Only folders root owns, one level down: the model folders below them already belong to uid 1000.
+    await run([
+        'find',
+        store,
+        '-mindepth',
+        '1',
+        '-maxdepth',
+        '1',
+        '-type',
+        'd',
+        '-user',
+        'root',
+        '-exec',
+        'chown',
+        GUEST_SCOPE_OWNER,
+        '{}',
+        '+',
+    ]);
+}
+//# sourceMappingURL=guest-scope.js.map

package/dist/runtime/wsl/guest-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guest-scope.js","sourceRoot":"","sources":["../../../src/runtime/wsl/guest-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGjD,MAAM,SAAS,GAAG,sBAAsB,CAAA;AACxC,sEAAsE;AACtE,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAE5C,6GAA6G;AAC7G,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,IAAY,EACZ,SAAuB,UAAU;IAEjC,IAAI,IAAI,GAAkB,IAAI,CAAA;IAC9B,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,KAAK,CAAA;IACrE,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAsD,CAAA;QACpF,IACE,MAAM,CAAC,cAAc,KAAK,CAAC;YAC3B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;YACpC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EACjC,CAAC;YACD,MAAM,IAAI,eAAe,CAAC,0BAA0B,EAAE,wCAAwC,EAAE,IAAI,CAAC,CAAA;QACvG,CAAC;QACD,OAAO,MAAM,CAAC,SAAS,CAAA;IACzB,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAA;IACpB,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/C,MAAM,IAAI,GAAG,GAAG,IAAI,MAAM,CAAA;IAC1B,MAAM,SAAS,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;IAC3F,MAAM,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACxB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,gHAAgH;AAChH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,SAAuB,UAAU;IACjF,IAAI,IAAI,GAA2B,IAAI,CAAA;IACvC,OAAO,GAAG,EAAE;QACV,IAAI,KAAK,yBAAyB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACxE,IAAI,GAAG,IAAI,CAAA;YACX,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAmC,EAAE,QAAgB;IAC1F,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,GAAG,IAAI,iBAAiB,CAAA;IACtC,MAAM,MAAM,GAAG;QACb,KAAK;QACL,GAAG,IAAI,sBAAsB;QAC7B,GAAG,IAAI,SAAS;QAChB,GAAG,IAAI,aAAa;QACpB,GAAG,IAAI,WAAW;KACnB,CAAA;IACD,MAAM,GAAG,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;QAClD,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;QAC/E,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,eAAe,CACvB,UAAU,EACV,gEAAgE,SAAS,CAAC,IAAI,IAAI,EAClF,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,CAC7C,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IACD,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC,CAAA;IACrC,0EAA0E;IAC1E,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,GAAG,IAAI,SAAS,EAAE,GAAG,MAAM,CAAC,CAAC,CAAA;IAC1E,mGAAmG;IACnG,MAAM,GAAG,CAAC;QACR,MAAM;QACN,KAAK;QACL,WAAW;QACX,GAAG;QACH,WAAW;QACX,GAAG;QACH,OAAO;QACP,GAAG;QACH,OAAO;QACP,MAAM;QACN,OAAO;QACP,OAAO;QACP,iBAAiB;QACjB,IAAI;QACJ,GAAG;KACJ,CAAC,CAAA;AACJ,CAAC"}

package/dist/runtime/wsl/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * WSL from Windows (openspec change `add-tensorrt-llm-windows`): the transport every piece of the
+ * Windows managed environment reaches Atomic Chat's own distribution through — `wsl.exe` argv with no
+ * shell, its UTF-16 output decoded, deadlines, an injectable executable, and the attached process
+ * that keeps the distribution running (design D1, D8, D16).
+ *
+ * Public API of this module is exported from this file only.
+ */
+export * from './transport.js';
+export * from './guest-paths.js';
+export * from './guest-scope.js';
+export * from './keeper.js';

package/dist/runtime/wsl/index.js

@@ -0,0 +1,13 @@
+/**
+ * WSL from Windows (openspec change `add-tensorrt-llm-windows`): the transport every piece of the
+ * Windows managed environment reaches Atomic Chat's own distribution through — `wsl.exe` argv with no
+ * shell, its UTF-16 output decoded, deadlines, an injectable executable, and the attached process
+ * that keeps the distribution running (design D1, D8, D16).
+ *
+ * Public API of this module is exported from this file only.
+ */
+export * from './transport.js';
+export * from './guest-paths.js';
+export * from './guest-scope.js';
+export * from './keeper.js';
+//# sourceMappingURL=index.js.map

package/dist/runtime/wsl/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/runtime/wsl/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA"}