@miller-tech/uap 2.21.3 → 2.36.1

package/dist/placement/registry.d.ts

@@ -0,0 +1,1038 @@
+import { z } from 'zod';
+import type { CapacityPolicy } from '../capacity/policy.js';
+export declare const REGISTRY_VERSION = 1;
+export declare const DeviceSchema: z.ZodObject<{
+    kind: z.ZodEnum<["gpu", "cpu"]>;
+    name: z.ZodOptional<z.ZodString>;
+    total_mib: z.ZodOptional<z.ZodNumber>;
+    reserved_mib: z.ZodOptional<z.ZodNumber>;
+    reserve_reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    kind: "cpu" | "gpu";
+    name?: string | undefined;
+    total_mib?: number | undefined;
+    reserved_mib?: number | undefined;
+    reserve_reason?: string | undefined;
+}, {
+    kind: "cpu" | "gpu";
+    name?: string | undefined;
+    total_mib?: number | undefined;
+    reserved_mib?: number | undefined;
+    reserve_reason?: string | undefined;
+}>;
+export type RegistryDevice = z.infer<typeof DeviceSchema>;
+export declare function validUnitName(unit: string): boolean;
+/** A measured footprint. `measured_at` is the discriminator in practice: it
+ * is present iff the config has a measurement. `measured_on` gates reuse —
+ * a footprint measured on one device class is not valid for another. */
+export declare const MeasuredConfigSchema: z.ZodObject<{
+    resident_gpu_mib: z.ZodNumber;
+    host_rss_mib: z.ZodNumber;
+    context_pool_cells: z.ZodNumber;
+    per_session_cap_cells: z.ZodOptional<z.ZodNumber>;
+    kv_resident_cells: z.ZodNumber;
+    kv_kind: z.ZodOptional<z.ZodString>;
+    /** Marginal KV cost above the resident pool. Absent = unknown, and cost
+     * above the pool fails closed rather than extrapolating. */
+    kv_mib_per_1k_cells: z.ZodOptional<z.ZodNumber>;
+    measured_at: z.ZodString;
+    measured_on: z.ZodString;
+    engine: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    profile: z.ZodOptional<z.ZodString>;
+    /** Capacity-policy service name this config is cross-checked against
+     * (overrides the model-level `service`). The policy's `services` is a
+     * LIST keyed by `name` — never assume a map. */
+    service: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rails: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    resident_gpu_mib: number;
+    host_rss_mib: number;
+    context_pool_cells: number;
+    kv_resident_cells: number;
+    measured_at: string;
+    measured_on: string;
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    per_session_cap_cells?: number | undefined;
+    kv_kind?: string | undefined;
+    kv_mib_per_1k_cells?: number | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}, {
+    resident_gpu_mib: number;
+    host_rss_mib: number;
+    context_pool_cells: number;
+    kv_resident_cells: number;
+    measured_at: string;
+    measured_on: string;
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    per_session_cap_cells?: number | undefined;
+    kv_kind?: string | undefined;
+    kv_mib_per_1k_cells?: number | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}>;
+export type MeasuredConfigEntry = z.infer<typeof MeasuredConfigSchema>;
+export declare const UnmeasuredConfigSchema: z.ZodObject<{
+    status: z.ZodLiteral<"unmeasured">;
+    engine: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    profile: z.ZodOptional<z.ZodString>;
+    /** Capacity-policy service name this config is cross-checked against
+     * (overrides the model-level `service`). The policy's `services` is a
+     * LIST keyed by `name` — never assume a map. */
+    service: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rails: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "unmeasured";
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}, {
+    status: "unmeasured";
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}>;
+export type UnmeasuredConfigEntry = z.infer<typeof UnmeasuredConfigSchema>;
+export declare const ConfigEntrySchema: z.ZodUnion<[z.ZodObject<{
+    resident_gpu_mib: z.ZodNumber;
+    host_rss_mib: z.ZodNumber;
+    context_pool_cells: z.ZodNumber;
+    per_session_cap_cells: z.ZodOptional<z.ZodNumber>;
+    kv_resident_cells: z.ZodNumber;
+    kv_kind: z.ZodOptional<z.ZodString>;
+    /** Marginal KV cost above the resident pool. Absent = unknown, and cost
+     * above the pool fails closed rather than extrapolating. */
+    kv_mib_per_1k_cells: z.ZodOptional<z.ZodNumber>;
+    measured_at: z.ZodString;
+    measured_on: z.ZodString;
+    engine: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    profile: z.ZodOptional<z.ZodString>;
+    /** Capacity-policy service name this config is cross-checked against
+     * (overrides the model-level `service`). The policy's `services` is a
+     * LIST keyed by `name` — never assume a map. */
+    service: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rails: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    resident_gpu_mib: number;
+    host_rss_mib: number;
+    context_pool_cells: number;
+    kv_resident_cells: number;
+    measured_at: string;
+    measured_on: string;
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    per_session_cap_cells?: number | undefined;
+    kv_kind?: string | undefined;
+    kv_mib_per_1k_cells?: number | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}, {
+    resident_gpu_mib: number;
+    host_rss_mib: number;
+    context_pool_cells: number;
+    kv_resident_cells: number;
+    measured_at: string;
+    measured_on: string;
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    per_session_cap_cells?: number | undefined;
+    kv_kind?: string | undefined;
+    kv_mib_per_1k_cells?: number | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}>, z.ZodObject<{
+    status: z.ZodLiteral<"unmeasured">;
+    engine: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    profile: z.ZodOptional<z.ZodString>;
+    /** Capacity-policy service name this config is cross-checked against
+     * (overrides the model-level `service`). The policy's `services` is a
+     * LIST keyed by `name` — never assume a map. */
+    service: z.ZodOptional<z.ZodString>;
+    note: z.ZodOptional<z.ZodString>;
+    flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    rails: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: "unmeasured";
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}, {
+    status: "unmeasured";
+    note?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    unit?: string | undefined;
+    profile?: string | undefined;
+    flags?: string[] | undefined;
+    rails?: number | undefined;
+}>]>;
+export type ConfigEntry = z.infer<typeof ConfigEntrySchema>;
+export declare const ModelEntrySchema: z.ZodObject<{
+    display: z.ZodString;
+    engine: z.ZodOptional<z.ZodString>;
+    unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+    service: z.ZodOptional<z.ZodString>;
+    launch: z.ZodOptional<z.ZodString>;
+    endpoint: z.ZodOptional<z.ZodString>;
+    task_affinity: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    affinity: z.ZodOptional<z.ZodObject<{
+        device: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        device: string[];
+    }, {
+        device: string[];
+    }>>;
+    advertises: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    configs: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+        resident_gpu_mib: z.ZodNumber;
+        host_rss_mib: z.ZodNumber;
+        context_pool_cells: z.ZodNumber;
+        per_session_cap_cells: z.ZodOptional<z.ZodNumber>;
+        kv_resident_cells: z.ZodNumber;
+        kv_kind: z.ZodOptional<z.ZodString>;
+        /** Marginal KV cost above the resident pool. Absent = unknown, and cost
+         * above the pool fails closed rather than extrapolating. */
+        kv_mib_per_1k_cells: z.ZodOptional<z.ZodNumber>;
+        measured_at: z.ZodString;
+        measured_on: z.ZodString;
+        engine: z.ZodOptional<z.ZodString>;
+        unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        profile: z.ZodOptional<z.ZodString>;
+        /** Capacity-policy service name this config is cross-checked against
+         * (overrides the model-level `service`). The policy's `services` is a
+         * LIST keyed by `name` — never assume a map. */
+        service: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rails: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        resident_gpu_mib: number;
+        host_rss_mib: number;
+        context_pool_cells: number;
+        kv_resident_cells: number;
+        measured_at: string;
+        measured_on: string;
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        per_session_cap_cells?: number | undefined;
+        kv_kind?: string | undefined;
+        kv_mib_per_1k_cells?: number | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    }, {
+        resident_gpu_mib: number;
+        host_rss_mib: number;
+        context_pool_cells: number;
+        kv_resident_cells: number;
+        measured_at: string;
+        measured_on: string;
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        per_session_cap_cells?: number | undefined;
+        kv_kind?: string | undefined;
+        kv_mib_per_1k_cells?: number | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    }>, z.ZodObject<{
+        status: z.ZodLiteral<"unmeasured">;
+        engine: z.ZodOptional<z.ZodString>;
+        unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        profile: z.ZodOptional<z.ZodString>;
+        /** Capacity-policy service name this config is cross-checked against
+         * (overrides the model-level `service`). The policy's `services` is a
+         * LIST keyed by `name` — never assume a map. */
+        service: z.ZodOptional<z.ZodString>;
+        note: z.ZodOptional<z.ZodString>;
+        flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        rails: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: "unmeasured";
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    }, {
+        status: "unmeasured";
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    }>]>>;
+}, "strip", z.ZodTypeAny, {
+    display: string;
+    configs: Record<string, {
+        resident_gpu_mib: number;
+        host_rss_mib: number;
+        context_pool_cells: number;
+        kv_resident_cells: number;
+        measured_at: string;
+        measured_on: string;
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        per_session_cap_cells?: number | undefined;
+        kv_kind?: string | undefined;
+        kv_mib_per_1k_cells?: number | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    } | {
+        status: "unmeasured";
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    }>;
+    endpoint?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    launch?: string | undefined;
+    unit?: string | undefined;
+    task_affinity?: string[] | undefined;
+    affinity?: {
+        device: string[];
+    } | undefined;
+    advertises?: string[] | undefined;
+}, {
+    display: string;
+    configs: Record<string, {
+        resident_gpu_mib: number;
+        host_rss_mib: number;
+        context_pool_cells: number;
+        kv_resident_cells: number;
+        measured_at: string;
+        measured_on: string;
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        per_session_cap_cells?: number | undefined;
+        kv_kind?: string | undefined;
+        kv_mib_per_1k_cells?: number | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    } | {
+        status: "unmeasured";
+        note?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        unit?: string | undefined;
+        profile?: string | undefined;
+        flags?: string[] | undefined;
+        rails?: number | undefined;
+    }>;
+    endpoint?: string | undefined;
+    service?: string | undefined;
+    engine?: string | undefined;
+    launch?: string | undefined;
+    unit?: string | undefined;
+    task_affinity?: string[] | undefined;
+    affinity?: {
+        device: string[];
+    } | undefined;
+    advertises?: string[] | undefined;
+}>;
+export type ModelEntry = z.infer<typeof ModelEntrySchema>;
+export declare const ModelRegistrySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    devices: z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<["gpu", "cpu"]>;
+        name: z.ZodOptional<z.ZodString>;
+        total_mib: z.ZodOptional<z.ZodNumber>;
+        reserved_mib: z.ZodOptional<z.ZodNumber>;
+        reserve_reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }>>;
+    models: z.ZodRecord<z.ZodString, z.ZodObject<{
+        display: z.ZodString;
+        engine: z.ZodOptional<z.ZodString>;
+        unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        service: z.ZodOptional<z.ZodString>;
+        launch: z.ZodOptional<z.ZodString>;
+        endpoint: z.ZodOptional<z.ZodString>;
+        task_affinity: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        affinity: z.ZodOptional<z.ZodObject<{
+            device: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            device: string[];
+        }, {
+            device: string[];
+        }>>;
+        advertises: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        configs: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+            resident_gpu_mib: z.ZodNumber;
+            host_rss_mib: z.ZodNumber;
+            context_pool_cells: z.ZodNumber;
+            per_session_cap_cells: z.ZodOptional<z.ZodNumber>;
+            kv_resident_cells: z.ZodNumber;
+            kv_kind: z.ZodOptional<z.ZodString>;
+            /** Marginal KV cost above the resident pool. Absent = unknown, and cost
+             * above the pool fails closed rather than extrapolating. */
+            kv_mib_per_1k_cells: z.ZodOptional<z.ZodNumber>;
+            measured_at: z.ZodString;
+            measured_on: z.ZodString;
+            engine: z.ZodOptional<z.ZodString>;
+            unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            profile: z.ZodOptional<z.ZodString>;
+            /** Capacity-policy service name this config is cross-checked against
+             * (overrides the model-level `service`). The policy's `services` is a
+             * LIST keyed by `name` — never assume a map. */
+            service: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            rails: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"unmeasured">;
+            engine: z.ZodOptional<z.ZodString>;
+            unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            profile: z.ZodOptional<z.ZodString>;
+            /** Capacity-policy service name this config is cross-checked against
+             * (overrides the model-level `service`). The policy's `services` is a
+             * LIST keyed by `name` — never assume a map. */
+            service: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            rails: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }, {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    models: Record<string, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }>;
+    version: 1;
+    devices: Record<string, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }>;
+}, {
+    models: Record<string, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }>;
+    version: 1;
+    devices: Record<string, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }>;
+}>;
+export type ModelRegistry = z.infer<typeof ModelRegistrySchema>;
+/** The machine-local file is an overlay, not a full document: it may carry
+ * only models (or only devices). `measure` writes exactly this shape. */
+export declare const RegistryOverlaySchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    devices: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        kind: z.ZodEnum<["gpu", "cpu"]>;
+        name: z.ZodOptional<z.ZodString>;
+        total_mib: z.ZodOptional<z.ZodNumber>;
+        reserved_mib: z.ZodOptional<z.ZodNumber>;
+        reserve_reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }>>>;
+    models: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        display: z.ZodString;
+        engine: z.ZodOptional<z.ZodString>;
+        unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+        service: z.ZodOptional<z.ZodString>;
+        launch: z.ZodOptional<z.ZodString>;
+        endpoint: z.ZodOptional<z.ZodString>;
+        task_affinity: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        affinity: z.ZodOptional<z.ZodObject<{
+            device: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            device: string[];
+        }, {
+            device: string[];
+        }>>;
+        advertises: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        configs: z.ZodRecord<z.ZodString, z.ZodUnion<[z.ZodObject<{
+            resident_gpu_mib: z.ZodNumber;
+            host_rss_mib: z.ZodNumber;
+            context_pool_cells: z.ZodNumber;
+            per_session_cap_cells: z.ZodOptional<z.ZodNumber>;
+            kv_resident_cells: z.ZodNumber;
+            kv_kind: z.ZodOptional<z.ZodString>;
+            /** Marginal KV cost above the resident pool. Absent = unknown, and cost
+             * above the pool fails closed rather than extrapolating. */
+            kv_mib_per_1k_cells: z.ZodOptional<z.ZodNumber>;
+            measured_at: z.ZodString;
+            measured_on: z.ZodString;
+            engine: z.ZodOptional<z.ZodString>;
+            unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            profile: z.ZodOptional<z.ZodString>;
+            /** Capacity-policy service name this config is cross-checked against
+             * (overrides the model-level `service`). The policy's `services` is a
+             * LIST keyed by `name` — never assume a map. */
+            service: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            rails: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"unmeasured">;
+            engine: z.ZodOptional<z.ZodString>;
+            unit: z.ZodOptional<z.ZodEffects<z.ZodString, string, string>>;
+            profile: z.ZodOptional<z.ZodString>;
+            /** Capacity-policy service name this config is cross-checked against
+             * (overrides the model-level `service`). The policy's `services` is a
+             * LIST keyed by `name` — never assume a map. */
+            service: z.ZodOptional<z.ZodString>;
+            note: z.ZodOptional<z.ZodString>;
+            flags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            rails: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }, {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>]>>;
+    }, "strip", z.ZodTypeAny, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    models?: Record<string, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }> | undefined;
+    devices?: Record<string, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }> | undefined;
+}, {
+    version: 1;
+    models?: Record<string, {
+        display: string;
+        configs: Record<string, {
+            resident_gpu_mib: number;
+            host_rss_mib: number;
+            context_pool_cells: number;
+            kv_resident_cells: number;
+            measured_at: string;
+            measured_on: string;
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            per_session_cap_cells?: number | undefined;
+            kv_kind?: string | undefined;
+            kv_mib_per_1k_cells?: number | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        } | {
+            status: "unmeasured";
+            note?: string | undefined;
+            service?: string | undefined;
+            engine?: string | undefined;
+            unit?: string | undefined;
+            profile?: string | undefined;
+            flags?: string[] | undefined;
+            rails?: number | undefined;
+        }>;
+        endpoint?: string | undefined;
+        service?: string | undefined;
+        engine?: string | undefined;
+        launch?: string | undefined;
+        unit?: string | undefined;
+        task_affinity?: string[] | undefined;
+        affinity?: {
+            device: string[];
+        } | undefined;
+        advertises?: string[] | undefined;
+    }> | undefined;
+    devices?: Record<string, {
+        kind: "cpu" | "gpu";
+        name?: string | undefined;
+        total_mib?: number | undefined;
+        reserved_mib?: number | undefined;
+        reserve_reason?: string | undefined;
+    }> | undefined;
+}>;
+export declare function isMeasuredConfig(cfg: ConfigEntry): cfg is MeasuredConfigEntry;
+/** A config is placeable only with a measurement. This is the fail-closed
+ * gate: `unmeasured` never becomes a load or eviction candidate. */
+export declare function isPlaceable(cfg: ConfigEntry): boolean;
+/** Admission cost (MiB) of serving `cells` context on a measured config:
+ * whole-config resident figure, plus marginal KV beyond the pool the config
+ * already paid for at startup. Returns null when the answer is unknown —
+ * `cells` beyond the resident pool with no `kv_mib_per_1k_cells`. Null is
+ * "refuse", never "free". */
+export declare function configCostMiB(cfg: MeasuredConfigEntry, cells: number): number | null;
+export interface RegistryLoadResult {
+    registry: ModelRegistry;
+    /** Where each file lives (or would live); existence is checked by the
+     * caller via existsSync — a missing file is not an error, it is "no
+     * measured footprints on this machine". */
+    repoPath: string;
+    localPath: string;
+    /** Which file supplied each measured config, keyed `${model}/${config}`.
+     * Absent = the config is unmeasured. */
+    measuredFrom: Map<string, 'repo' | 'local'>;
+    /** Parse/merge errors. Non-empty means fail closed on everything that
+     * depends on the registry. */
+    errors: string[];
+}
+export declare function repoRegistryPath(projectDir: string): string;
+export declare function localRegistryPath(): string;
+export declare function loadModelRegistry(projectDir: string, opts?: {
+    repoPath?: string;
+    localPath?: string;
+}): RegistryLoadResult;
+export interface RegistryFinding {
+    severity: 'error' | 'warning';
+    scope: string;
+    message: string;
+}
+/** The capacity policy service a model/config is cross-checked against
+ * (config-level overrides model-level). */
+export declare function crossCheckService(model: ModelEntry, cfg: ConfigEntry): string | undefined;
+/** Cross-check the registry against the capacity policy and its own internal
+ * consistency. One source of truth per number: a registry entry that
+ * contradicts the policy it should agree with is an error, not a warning. */
+export declare function validateRegistry(registry: ModelRegistry, policy: CapacityPolicy): RegistryFinding[];
+//# sourceMappingURL=registry.d.ts.map