prefer-inference-core 0.0.0-g0be6ef9

package/dist/releases.d.ts

@@ -0,0 +1,33 @@
+import type { PreferReleaseManifest, PreferReleaseRecord } from "./types.js";
+export interface GitHubReleaseOptions {
+    token?: string | undefined;
+    fetch?: typeof fetch | undefined;
+    apiBaseUrl?: string | undefined;
+    timeoutMs?: number | undefined;
+    cacheDir?: string | undefined;
+}
+export interface ResolveReleaseOptions extends GitHubReleaseOptions {
+    repository: string;
+    channel?: "stable" | "preview" | undefined;
+    revision?: string | undefined;
+}
+export interface DownloadedPreferRelease {
+    release: PreferReleaseRecord;
+    manifest: PreferReleaseManifest;
+}
+export declare function listPreferReleases(repositoryInput: string, options?: GitHubReleaseOptions & {
+    channel?: "stable" | "preview";
+    limit?: number;
+}): Promise<PreferReleaseRecord[]>;
+export declare function resolvePreferRelease(options: ResolveReleaseOptions): Promise<DownloadedPreferRelease>;
+export declare function downloadReleaseAsset(release: PreferReleaseRecord, name: string, options?: GitHubReleaseOptions & {
+    expectedSha256?: string | undefined;
+    maxBytes?: number | undefined;
+}): Promise<Uint8Array>;
+export declare function downloadPreferTooling(options: ResolveReleaseOptions & {
+    outputDir: string;
+}): Promise<DownloadedPreferRelease & {
+    files: Record<string, string>;
+}>;
+export declare function validatePreferReleaseManifest(value: unknown, release?: PreferReleaseRecord, repositoryInput?: string): PreferReleaseManifest;
+//# sourceMappingURL=releases.d.ts.map

package/dist/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../src/releases.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAsB,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAOjG,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,KAAK,CAAC,EAAE,OAAO,KAAK,GAAG,SAAS,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAsB,SAAQ,oBAAoB;IACjE,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,EAAE,qBAAqB,CAAC;CACjC;AAED,wBAAsB,kBAAkB,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAoB,GAAG;IAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAyCzL;AAED,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAuB3G;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,mBAAmB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAoB,GAAG;IAAE,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAO,GAC1G,OAAO,CAAC,UAAU,CAAC,CAsBrB;AAED,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,qBAAqB,GAAG;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC,uBAAuB,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CAgCtE;AAED,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAmB5I"}

package/dist/releases.js

@@ -0,0 +1,288 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { isObject, requireString, sha256, validateRepository } from "./utils.js";
+const MAX_RELEASE_HISTORY_BYTES = 10 * 1024 * 1024;
+const MAX_MANIFEST_BYTES = 2 * 1024 * 1024;
+const MAX_TOOLING_ASSET_BYTES = 100 * 1024 * 1024;
+export async function listPreferReleases(repositoryInput, options = {}) {
+    const repository = validateRepository(repositoryInput);
+    const limit = options.limit ?? 20;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 30)
+        throw new Error("release limit must be between 1 and 30");
+    const base = (options.apiBaseUrl ?? "https://api.github.com").replace(/\/+$/u, "");
+    const response = await githubFetch(`${base}/repos/${repository}/releases?per_page=30`, options);
+    const raw = await responseJson(response, MAX_RELEASE_HISTORY_BYTES, "GitHub release history");
+    if (!Array.isArray(raw))
+        throw new Error("GitHub release history is not an array");
+    const releases = raw.flatMap((entry) => {
+        if (!isObject(entry) || entry.draft !== false || typeof entry.prerelease !== "boolean")
+            return [];
+        const id = typeof entry.tag_name === "string" ? entry.tag_name : "";
+        const revision = typeof entry.target_commitish === "string" ? entry.target_commitish.toLowerCase() : "";
+        if (!/^sha-[0-9a-f]{7}$/u.test(id) || !/^[0-9a-f]{40}$/u.test(revision) || id !== `sha-${revision.slice(0, 7)}`)
+            return [];
+        const channel = entry.prerelease ? "preview" : "stable";
+        if (options.channel && channel !== options.channel)
+            return [];
+        const published = typeof entry.published_at === "string" ? new Date(entry.published_at) : new Date(Number.NaN);
+        if (!Number.isFinite(published.getTime()))
+            return [];
+        const assets = {};
+        if (Array.isArray(entry.assets)) {
+            for (const rawAsset of entry.assets) {
+                if (!isObject(rawAsset) || (rawAsset.state !== undefined && rawAsset.state !== "uploaded"))
+                    continue;
+                const name = typeof rawAsset.name === "string" ? rawAsset.name : "";
+                const url = typeof rawAsset.browser_download_url === "string" ? rawAsset.browser_download_url : "";
+                if (!/^[a-z0-9][a-z0-9._-]{0,199}$/iu.test(name) || !validAssetUrl(url, repository, id, name))
+                    continue;
+                const size = typeof rawAsset.size === "number" && Number.isSafeInteger(rawAsset.size) && rawAsset.size >= 0 ? rawAsset.size : undefined;
+                const digest = typeof rawAsset.digest === "string" && /^sha256:[0-9a-f]{64}$/u.test(rawAsset.digest) ? rawAsset.digest : undefined;
+                assets[name] = { name, url, ...(size !== undefined ? { size } : {}), ...(digest ? { digest } : {}) };
+            }
+        }
+        if (!assets["prefer-release.json"])
+            return [];
+        return [{
+                id,
+                revision,
+                channel,
+                published_at: published.toISOString(),
+                title: typeof entry.name === "string" && entry.name ? entry.name.slice(0, 160) : id,
+                url: `https://github.com/${repository}/releases/tag/${id}`,
+                assets
+            }];
+    });
+    return releases.sort((left, right) => right.published_at.localeCompare(left.published_at)).slice(0, limit);
+}
+export async function resolvePreferRelease(options) {
+    const repository = validateRepository(options.repository);
+    let release;
+    if (options.revision) {
+        const revision = options.revision.trim().toLowerCase();
+        if (!/^[0-9a-f]{40}$/u.test(revision))
+            throw new Error("PreFer release revision must be a full commit SHA");
+        const tag = `sha-${revision.slice(0, 7)}`;
+        const base = (options.apiBaseUrl ?? "https://api.github.com").replace(/\/+$/u, "");
+        const response = await githubFetch(`${base}/repos/${repository}/releases/tags/${tag}`, options);
+        const entry = await responseJson(response, MAX_RELEASE_HISTORY_BYTES, `GitHub release ${tag}`);
+        release = parseSingleRelease(entry, repository);
+        if (release.revision !== revision)
+            throw new Error(`PreFer release ${tag} does not match the requested revision`);
+    }
+    else {
+        [release] = await listPreferReleases(repository, { ...options, channel: options.channel ?? "stable", limit: 1 });
+    }
+    if (!release)
+        throw new Error(`no completed ${options.channel ?? "stable"} PreFer release was found`);
+    const manifestAsset = release.assets["prefer-release.json"];
+    const manifestBytes = await downloadReleaseAsset(release, manifestAsset.name, { ...options, expectedSha256: digestHex(manifestAsset.digest), maxBytes: MAX_MANIFEST_BYTES });
+    let manifestValue;
+    try {
+        manifestValue = JSON.parse(new TextDecoder().decode(manifestBytes));
+    }
+    catch {
+        throw new Error("PreFer release manifest is not valid JSON");
+    }
+    const manifest = validatePreferReleaseManifest(manifestValue, release, repository);
+    return { release, manifest };
+}
+export async function downloadReleaseAsset(release, name, options = {}) {
+    requireAssetName(name);
+    const asset = release.assets[name];
+    if (!asset)
+        throw new Error(`PreFer release ${release.id} is missing ${name}`);
+    const expected = options.expectedSha256 ?? digestHex(asset.digest);
+    const cachePath = options.cacheDir ? resolve(options.cacheDir, release.revision, name) : undefined;
+    if (cachePath) {
+        try {
+            const cached = new Uint8Array(await readFile(cachePath));
+            if (!expected || sha256(cached) === expected)
+                return cached;
+        }
+        catch (error) {
+            if (!(error instanceof Error && "code" in error && error.code === "ENOENT"))
+                throw error;
+        }
+    }
+    const response = await githubFetch(asset.url, options, "application/octet-stream");
+    const bytes = await responseBytes(response, options.maxBytes ?? MAX_TOOLING_ASSET_BYTES, name);
+    if (expected && sha256(bytes) !== expected)
+        throw new Error(`${name} does not match its expected SHA-256`);
+    if (cachePath) {
+        await mkdir(dirname(cachePath), { recursive: true });
+        await writeFile(cachePath, bytes);
+    }
+    return bytes;
+}
+export async function downloadPreferTooling(options) {
+    const resolvedRelease = await resolvePreferRelease(options);
+    const tooling = objectValue(resolvedRelease.manifest.tooling, "PreFer release tooling");
+    if (tooling.schema_version !== "prefer.release-tooling.v1")
+        throw new Error("PreFer release tooling schema is incompatible");
+    const packageVersion = requireString(tooling.package_version, "PreFer release tooling package version");
+    if (packageVersion !== `0.0.0-g${resolvedRelease.release.revision.slice(0, 7)}`) {
+        throw new Error("PreFer release tooling package version does not match its release");
+    }
+    requireSha256(tooling.catalog_fingerprint, "PreFer release tooling catalog fingerprint");
+    requireSha256(tooling.source_fingerprint, "PreFer release tooling source fingerprint");
+    const files = {};
+    for (const key of [
+        "package",
+        "cli",
+        "model_catalog",
+        "model_catalog_schema",
+        "model_catalog_extension_schema",
+        "resource_profile_schema",
+        "model_plan_schema"
+    ]) {
+        const binding = objectValue(tooling[key], `PreFer release tooling ${key}`);
+        const asset = requireAssetName(requireString(binding.asset, `PreFer release tooling ${key} asset`));
+        const expectedBytes = requireNonnegativeInteger(binding.bytes, `PreFer release tooling ${key} bytes`);
+        const expectedSha256 = requireSha256(binding.sha256, `PreFer release tooling ${key} SHA-256`);
+        const bytes = await downloadReleaseAsset(resolvedRelease.release, asset, { ...options, expectedSha256 });
+        if (bytes.byteLength !== expectedBytes)
+            throw new Error(`${asset} does not match its expected size`);
+        const path = resolve(options.outputDir, asset);
+        await mkdir(dirname(path), { recursive: true });
+        await writeFile(path, bytes);
+        files[key] = path;
+    }
+    return { ...resolvedRelease, files };
+}
+export function validatePreferReleaseManifest(value, release, repositoryInput) {
+    const manifest = objectValue(value, "PreFer release manifest");
+    if (manifest.schema_version !== "prefer.release.v1")
+        throw new Error("PreFer release manifest schema is incompatible");
+    const revision = requireString(manifest.release?.source_revision, "PreFer release source revision").toLowerCase();
+    const id = requireString(manifest.release?.id, "PreFer release id");
+    if (!/^[0-9a-f]{40}$/u.test(revision) || id !== `sha-${revision.slice(0, 7)}`)
+        throw new Error("PreFer release manifest identity is invalid");
+    if (release && (release.id !== id || release.revision !== revision))
+        throw new Error("PreFer release manifest does not match its GitHub release");
+    if (repositoryInput) {
+        const repository = validateRepository(repositoryInput);
+        const source = manifest.release.source_repository.replace(/^https:\/\/github\.com\//u, "").replace(/\/$/u, "");
+        if (source.toLowerCase() !== repository.toLowerCase())
+            throw new Error("PreFer release source repository is invalid");
+    }
+    if (manifest.distribution?.model_weights_embedded !== false
+        || manifest.distribution.models_stage_at_runtime !== true
+        || manifest.distribution.all_engine_images_share_release_revision !== true) {
+        throw new Error("PreFer release distribution contract is incompatible");
+    }
+    objectValue(manifest.engines, "PreFer release engines");
+    return manifest;
+}
+async function githubFetch(url, options, accept = "application/vnd.github+json") {
+    const headers = { accept, "user-agent": "prefer-inference-core", "x-github-api-version": "2022-11-28" };
+    if (options.token?.trim())
+        headers.authorization = `Bearer ${options.token.trim()}`;
+    const response = await (options.fetch ?? fetch)(url, { headers, signal: AbortSignal.timeout(options.timeoutMs ?? 30_000) });
+    if (!response.ok) {
+        const reset = response.headers.get("x-ratelimit-reset");
+        const retry = response.headers.get("retry-after");
+        const rateLimit = response.status === 429 || (response.status === 403 && response.headers.get("x-ratelimit-remaining") === "0")
+            ? `; rate limited${retry ? `, retry after ${retry}s` : reset ? `, reset at ${new Date(Number(reset) * 1000).toISOString()}` : ""}`
+            : "";
+        throw new Error(`${url} returned HTTP ${response.status}${rateLimit}`);
+    }
+    return response;
+}
+async function responseJson(response, maxBytes, label) {
+    const bytes = await responseBytes(response, maxBytes, label);
+    try {
+        return JSON.parse(new TextDecoder().decode(bytes));
+    }
+    catch {
+        throw new Error(`${label} returned invalid JSON`);
+    }
+}
+async function responseBytes(response, maxBytes, label) {
+    const declared = Number(response.headers.get("content-length") ?? "0");
+    if (declared > maxBytes)
+        throw new Error(`${label} exceeds the response size limit`);
+    const bytes = new Uint8Array(await response.arrayBuffer());
+    if (bytes.byteLength > maxBytes)
+        throw new Error(`${label} exceeds the response size limit`);
+    return bytes;
+}
+function parseSingleRelease(value, repository) {
+    const entry = objectValue(value, "GitHub release");
+    const id = requireString(entry.tag_name, "GitHub release tag");
+    const revision = requireString(entry.target_commitish, "GitHub release target").toLowerCase();
+    if (entry.draft !== false || typeof entry.prerelease !== "boolean" || !/^sha-[0-9a-f]{7}$/u.test(id) || !/^[0-9a-f]{40}$/u.test(revision)) {
+        throw new Error("GitHub release is not a completed immutable PreFer release");
+    }
+    const published = new Date(requireString(entry.published_at, "GitHub release publication time"));
+    if (!Number.isFinite(published.getTime()))
+        throw new Error("GitHub release publication time is invalid");
+    const assets = {};
+    if (!Array.isArray(entry.assets))
+        throw new Error("GitHub release assets are invalid");
+    for (const rawAsset of entry.assets) {
+        if (!isObject(rawAsset))
+            continue;
+        const name = typeof rawAsset.name === "string" ? rawAsset.name : "";
+        const url = typeof rawAsset.browser_download_url === "string" ? rawAsset.browser_download_url : "";
+        if (!validAssetName(name) || !validAssetUrl(url, repository, id, name))
+            continue;
+        assets[name] = {
+            name,
+            url,
+            ...(typeof rawAsset.size === "number" ? { size: rawAsset.size } : {}),
+            ...(typeof rawAsset.digest === "string" ? { digest: rawAsset.digest } : {})
+        };
+    }
+    if (!assets["prefer-release.json"])
+        throw new Error("GitHub release is missing prefer-release.json");
+    return {
+        id,
+        revision,
+        channel: entry.prerelease ? "preview" : "stable",
+        published_at: published.toISOString(),
+        title: typeof entry.name === "string" && entry.name ? entry.name : id,
+        url: `https://github.com/${repository}/releases/tag/${id}`,
+        assets
+    };
+}
+function validAssetUrl(value, repository, tag, name) {
+    try {
+        const url = new URL(value);
+        return url.protocol === "https:"
+            && url.hostname.toLowerCase() === "github.com"
+            && !url.username && !url.password && !url.search && !url.hash
+            && decodeURIComponent(url.pathname).toLowerCase() === `/${repository}/releases/download/${tag}/${name}`.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+}
+function digestHex(value) {
+    return value?.startsWith("sha256:") ? value.slice(7) : undefined;
+}
+function requireSha256(value, label) {
+    const result = requireString(value, label).toLowerCase();
+    if (!/^[0-9a-f]{64}$/u.test(result))
+        throw new Error(`${label} is invalid`);
+    return result;
+}
+function requireNonnegativeInteger(value, label) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+        throw new Error(`${label} is invalid`);
+    return value;
+}
+function validAssetName(value) {
+    return /^[a-z0-9][a-z0-9._-]{0,199}$/iu.test(value);
+}
+function requireAssetName(value) {
+    if (!validAssetName(value))
+        throw new Error(`invalid PreFer release asset name ${value}`);
+    return value;
+}
+function objectValue(value, label) {
+    if (!isObject(value))
+        throw new Error(`${label} must be an object`);
+    return value;
+}
+//# sourceMappingURL=releases.js.map

package/dist/releases.js.map

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

package/dist/resources.d.ts

@@ -0,0 +1,10 @@
+import type { AcceleratorResource, ResourceProfile, RuntimeResourceObservation } from "./types.js";
+export interface DetectRuntimeResourcesOptions {
+    base?: ResourceProfile;
+    runNvidiaSmi?: (() => Promise<string>) | undefined;
+}
+export declare function normalizeDeploymentResources(value: unknown, observation?: RuntimeResourceObservation): ResourceProfile;
+export declare function mergeRuntimeResources(base: ResourceProfile, observation: RuntimeResourceObservation): ResourceProfile;
+export declare function detectRuntimeResources(options?: DetectRuntimeResourcesOptions): Promise<ResourceProfile>;
+export declare function parseNvidiaSmi(output: string): AcceleratorResource[];
+//# sourceMappingURL=resources.d.ts.map

package/dist/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../src/resources.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,mBAAmB,EAGnB,eAAe,EACf,0BAA0B,EAC3B,MAAM,YAAY,CAAC;AAWpB,MAAM,WAAW,6BAA6B;IAC5C,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;CACpD;AAED,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,0BAA0B,GACvC,eAAe,CAgDjB;AAED,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,eAAe,EACrB,WAAW,EAAE,0BAA0B,GACtC,eAAe,CA0CjB;AAED,wBAAsB,sBAAsB,CAC1C,OAAO,GAAE,6BAAkC,GAC1C,OAAO,CAAC,eAAe,CAAC,CAiC1B;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,EAAE,CAuBpE"}

package/dist/resources.js

@@ -0,0 +1,250 @@
+import { arch, cpus, freemem, totalmem } from "node:os";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { isObject } from "./utils.js";
+const GIB = 1024 ** 3;
+const MIB = 1024 ** 2;
+const execFileAsync = promisify(execFile);
+const DERIVED_RESOURCE_CAPABILITIES = new Set([
+    "gpu", "cpu", "multi-gpu", "unified-memory", "discrete-vram", "host-memory",
+    "cuda", "bf16", "fp8", "nvfp4"
+]);
+export function normalizeDeploymentResources(value, observation) {
+    const deployment = isObject(value) ? value : {};
+    if (deployment.schema_version === "prefer.resources.v1") {
+        return observation
+            ? mergeRuntimeResources(deployment, observation)
+            : structuredClone(deployment);
+    }
+    const hardware = isObject(deployment.hardware) ? deployment.hardware : deployment;
+    const compatibility = isObject(deployment.compatibility) ? deployment.compatibility : {};
+    const provider = stringValue(deployment.provider) ?? stringValue(hardware.provider);
+    const providerSku = stringValue(hardware.provider_sku) ?? stringValue(hardware.host_shape);
+    const count = positiveInteger(hardware.gpu_count) ?? 0;
+    const totalEach = bytesFromGiB(hardware.vram_gb_each) ?? bytesFromGiB(hardware.vram_gb);
+    const topology = memoryTopology(hardware, count);
+    const acceleratorCapabilities = deriveAcceleratorCapabilities(hardware, compatibility);
+    const accelerators = Array.from({ length: count }, (_, index) => ({
+        ...(count > 1 ? { id: `deployment-gpu-${index}` } : {}),
+        ...(stringValue(hardware.gpu_slug) ? { slug: stringValue(hardware.gpu_slug) } : {}),
+        ...(stringValue(hardware.gpu_id) ? { canonical_id: stringValue(hardware.gpu_id) } : {}),
+        ...(stringValue(hardware.provider_gpu_type_id) ? { provider_id: stringValue(hardware.provider_gpu_type_id) } : {}),
+        ...(stringValue(hardware.gpu_name) ?? stringValue(hardware.gpu_type_id)
+            ? { name: (stringValue(hardware.gpu_name) ?? stringValue(hardware.gpu_type_id)) }
+            : {}),
+        ...(stringValue(hardware.architecture) ? { architecture: stringValue(hardware.architecture) } : {}),
+        ...(stringValue(hardware.compute_capability) ?? stringValue(compatibility.minimum_compute_capability)
+            ? { compute_capability: (stringValue(hardware.compute_capability) ?? stringValue(compatibility.minimum_compute_capability)) }
+            : {}),
+        ...(totalEach !== undefined ? { total_bytes: totalEach } : {}),
+        capabilities: [...acceleratorCapabilities]
+    }));
+    const unifiedTotal = bytesFromGiB(hardware.unified_memory_gb) ?? (topology === "unified" ? totalEach : undefined);
+    const hostTotal = bytesFromGiB(hardware.host_ram_gb) ?? bytesFromGiB(hardware.observed_host_ram_gb);
+    const storageTotal = bytesFromGiB(hardware.local_nvme_gb);
+    const logicalCores = positiveInteger(hardware.vcpu) ?? positiveInteger(hardware.observed_vcpu);
+    const profile = {
+        schema_version: "prefer.resources.v1",
+        source: "deployment",
+        ...(provider ? { provider } : {}),
+        ...(providerSku ? { provider_sku: providerSku } : {}),
+        memory_topology: topology,
+        accelerators,
+        ...(unifiedTotal !== undefined ? { unified_memory: { total_bytes: unifiedTotal } } : {}),
+        ...(hostTotal !== undefined ? { host_memory: { total_bytes: hostTotal } } : {}),
+        ...(logicalCores !== undefined ? { cpu: { logical_cores: logicalCores } } : {}),
+        ...(storageTotal !== undefined ? { storage: { total_bytes: storageTotal, kind: "local" } } : {}),
+        capabilities: deriveProfileCapabilities(topology, accelerators, hardware, compatibility)
+    };
+    return observation ? mergeRuntimeResources(profile, observation) : profile;
+}
+export function mergeRuntimeResources(base, observation) {
+    const acceleratorObservationSupplied = observation.accelerators !== undefined;
+    const observedAccelerators = observation.accelerators?.map(normalizeAccelerator);
+    const accelerators = acceleratorObservationSupplied
+        ? (observedAccelerators ?? []).map((observed, index) => mergeAccelerator(base.accelerators[index], observed))
+        : base.accelerators.map((entry) => structuredClone(entry));
+    const topology = observation.unified_memory
+        ? "unified"
+        : acceleratorObservationSupplied
+            ? accelerators.length
+                ? base.memory_topology === "unified" ? "unified" : "discrete"
+                : "host"
+            : base.memory_topology;
+    const unifiedMemory = mergeMemory(base.unified_memory, observation.unified_memory);
+    const hostMemory = mergeMemory(base.host_memory, observation.host_memory);
+    const baseCapabilities = acceleratorObservationSupplied
+        ? base.capabilities.filter((capability) => !DERIVED_RESOURCE_CAPABILITIES.has(capability))
+        : base.capabilities;
+    const structuralCapabilities = [
+        accelerators.length ? "gpu" : "cpu",
+        ...(accelerators.length > 1 ? ["multi-gpu"] : []),
+        topology === "unified" ? "unified-memory" : topology === "discrete" ? "discrete-vram" : "host-memory"
+    ];
+    const result = {
+        ...structuredClone(base),
+        source: "merged",
+        memory_topology: topology,
+        accelerators,
+        ...(unifiedMemory ? { unified_memory: unifiedMemory } : {}),
+        ...(hostMemory ? { host_memory: hostMemory } : {}),
+        ...(observation.cpu ? { cpu: { ...base.cpu, ...observation.cpu } } : {}),
+        ...(observation.storage ? { storage: { ...base.storage, ...observation.storage } } : {}),
+        capabilities: [...new Set([
+                ...baseCapabilities,
+                ...structuralCapabilities,
+                ...(observation.capabilities ?? []),
+                ...accelerators.flatMap((entry) => entry.capabilities)
+            ])].sort()
+    };
+    if (!unifiedMemory)
+        delete result.unified_memory;
+    if (!hostMemory)
+        delete result.host_memory;
+    return result;
+}
+export async function detectRuntimeResources(options = {}) {
+    const run = options.runNvidiaSmi ?? defaultNvidiaSmi;
+    let accelerators = [];
+    let acceleratorProbeSucceeded = false;
+    try {
+        accelerators = parseNvidiaSmi(await run());
+        acceleratorProbeSucceeded = true;
+    }
+    catch { /* CPU-only and restricted containers are valid resource probes. */ }
+    const observation = {
+        ...(acceleratorProbeSucceeded ? { accelerators } : {}),
+        host_memory: { total_bytes: totalmem(), available_bytes: freemem() },
+        cpu: {
+            architecture: arch(),
+            logical_cores: cpus().length,
+            ...(cpus()[0]?.model ? { model: cpus()[0].model } : {})
+        },
+        ...(acceleratorProbeSucceeded ? { capabilities: accelerators.length ? ["gpu"] : ["cpu"] } : {})
+    };
+    if (options.base)
+        return mergeRuntimeResources(options.base, observation);
+    return {
+        schema_version: "prefer.resources.v1",
+        source: "runtime",
+        memory_topology: accelerators.length ? "discrete" : "host",
+        accelerators,
+        host_memory: observation.host_memory,
+        cpu: observation.cpu,
+        capabilities: [...new Set([
+                accelerators.length ? "gpu" : "cpu",
+                ...(observation.capabilities ?? []),
+                ...accelerators.flatMap((entry) => entry.capabilities)
+            ])].sort()
+    };
+}
+export function parseNvidiaSmi(output) {
+    return output.split(/\r?\n/u).map((line) => line.trim()).filter(Boolean).map((line, index) => {
+        const fields = line.split(",").map((field) => field.trim());
+        if (fields.length < 4)
+            throw new Error(`invalid nvidia-smi row ${index + 1}`);
+        const [name, id, totalMiB, freeMiB, computeCapability] = fields;
+        const total = Number(totalMiB);
+        const available = Number(freeMiB);
+        if (!name || !Number.isFinite(total) || !Number.isFinite(available)) {
+            throw new Error(`invalid nvidia-smi memory row ${index + 1}`);
+        }
+        const hardware = {
+            gpu_name: name,
+            ...(computeCapability ? { compute_capability: `sm_${computeCapability.replace(".", "")}` } : {})
+        };
+        return {
+            ...(id ? { id } : {}),
+            name,
+            total_bytes: Math.round(total * MIB),
+            available_bytes: Math.round(available * MIB),
+            ...(computeCapability ? { compute_capability: `sm_${computeCapability.replace(".", "")}` } : {}),
+            capabilities: [...deriveAcceleratorCapabilities(hardware, {})]
+        };
+    });
+}
+function memoryTopology(hardware, count) {
+    const explicit = stringValue(hardware.memory_topology) ?? stringValue(hardware.memory_model);
+    if (explicit === "unified" || explicit === "discrete" || explicit === "host")
+        return explicit;
+    if (hardware.unified_memory === true || hardware.unified_memory_gb !== undefined)
+        return "unified";
+    return count > 0 ? "discrete" : "host";
+}
+function deriveProfileCapabilities(topology, accelerators, hardware, compatibility) {
+    return [...new Set([
+            ...(accelerators.length ? ["gpu"] : ["cpu"]),
+            ...(accelerators.length > 1 ? ["multi-gpu"] : []),
+            topology === "unified" ? "unified-memory" : topology === "discrete" ? "discrete-vram" : "host-memory",
+            ...stringArray(hardware.capabilities),
+            ...stringArray(compatibility.capabilities),
+            ...accelerators.flatMap((entry) => entry.capabilities)
+        ])].sort();
+}
+function deriveAcceleratorCapabilities(hardware, compatibility) {
+    const result = new Set([...stringArray(hardware.capabilities), ...stringArray(compatibility.capabilities)]);
+    const architecture = (stringValue(hardware.architecture) ?? stringValue(hardware.gpu_name) ?? "").toLowerCase();
+    const compute = stringValue(hardware.compute_capability) ?? stringValue(compatibility.minimum_compute_capability) ?? "";
+    const computeNumber = Number(compute.toLowerCase().replace(/^sm_/u, ""));
+    if (architecture.includes("blackwell") || computeNumber >= 100) {
+        result.add("bf16");
+        result.add("fp8");
+        result.add("nvfp4");
+    }
+    else if (architecture.includes("hopper") || (computeNumber >= 89 && computeNumber < 100)) {
+        result.add("bf16");
+        result.add("fp8");
+    }
+    else if (architecture.includes("ampere") || (computeNumber >= 80 && computeNumber < 89)) {
+        result.add("bf16");
+    }
+    if (compute || architecture)
+        result.add("cuda");
+    return result;
+}
+function mergeAccelerator(base, observed) {
+    const preserveBase = base !== undefined && acceleratorIdentityMatches(base, observed);
+    return {
+        ...(preserveBase ? base : {}),
+        ...observed,
+        capabilities: [...new Set([...(preserveBase ? base.capabilities : []), ...observed.capabilities])].sort()
+    };
+}
+function acceleratorIdentityMatches(base, observed) {
+    if (base.compute_capability && observed.compute_capability)
+        return base.compute_capability === observed.compute_capability;
+    if (base.name && observed.name) {
+        const left = base.name.toLowerCase().replaceAll(/[^a-z0-9]/gu, "");
+        const right = observed.name.toLowerCase().replaceAll(/[^a-z0-9]/gu, "");
+        return left.includes(right) || right.includes(left);
+    }
+    return true;
+}
+function normalizeAccelerator(value) {
+    return { ...structuredClone(value), capabilities: [...new Set(value.capabilities ?? [])].sort() };
+}
+function mergeMemory(base, observed) {
+    if (!base && !observed)
+        return undefined;
+    return { ...base, ...observed };
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : undefined;
+}
+function positiveInteger(value) {
+    return typeof value === "number" && Number.isInteger(value) && value > 0 ? value : undefined;
+}
+function bytesFromGiB(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? Math.round(value * GIB) : undefined;
+}
+function stringArray(value) {
+    return Array.isArray(value) ? value.filter((entry) => typeof entry === "string") : [];
+}
+async function defaultNvidiaSmi() {
+    const { stdout } = await execFileAsync("nvidia-smi", [
+        "--query-gpu=name,uuid,memory.total,memory.free,compute_cap",
+        "--format=csv,noheader,nounits"
+    ], { encoding: "utf8", timeout: 10_000 });
+    return stdout;
+}
+//# sourceMappingURL=resources.js.map