dashboard-react
    Preparing search index...

    Interface PlacementPreview

    Placement preview returned by the Skulk placement preview endpoint.

    interface PlacementPreview {
        model_id: string;
        sharding: "Pipeline" | "Tensor";
        instance_meta: "MlxRing" | "MlxJaccl" | "LlamaRpc";
        instance: unknown;
        memory_delta_by_node: Record<string, number> | null;
        error: string | null;
        error_code?:
            | "no_valid_placement"
            | "placement_info_pending"
            | "model_code_approval_required"
            | null;
        trust_requirement?: string
        | null;
        compatibility_source?: "card" | "signed_engine_support" | null;
        support_claim_ids?: string[];
        compatibility_detail?: string | null;
        engine_install?: PlacementEngineInstall | null;
        alternative?: boolean;
        max_context_tokens?: number | null;
        default_context_tokens?: number | null;
        reserves_context_at_load?: boolean;
        kv_bytes_per_token?: number | null;
    }
    Index

    Properties

    model_id sharding instance_meta instance memory_delta_by_node error error_code? trust_requirement? compatibility_source? support_claim_ids? compatibility_detail? engine_install? alternative? max_context_tokens? default_context_tokens? reserves_context_at_load? kv_bytes_per_token?

    Properties

    model_id: string
    sharding: "Pipeline" | "Tensor"
    instance_meta: "MlxRing" | "MlxJaccl" | "LlamaRpc"
    instance: unknown
    memory_delta_by_node: Record<string, number> | null
    error: string | null
    error_code?:
        | "no_valid_placement"
        | "placement_info_pending"
        | "model_code_approval_required"
        | null

    Stable failure category for an unavailable preview.

    trust_requirement?: string | null

    Compatibility detail emitted only by older Skulk nodes.

    compatibility_source?: "card" | "signed_engine_support" | null

    Whether card compatibility or the signed engine matrix admitted the backend.

    support_claim_ids?: string[]

    Signed claims applicable when the matrix admitted the placement.

    compatibility_detail?: string | null

    Operator-readable missing artifact, engine/build, or platform detail.

    engine_install?: PlacementEngineInstall | null

    Set when this placement first installs an on-demand engine (the video engine), so placing it takes longer than usual.

    alternative?: boolean

    Per-host alternative to the ranked pick: a single-node placement on a host that passes admission but lost the planner ranking (#557).

    max_context_tokens?: number | null

    Largest context window this placement holds; a larger request is refused.

    default_context_tokens?: number | null

    Window an unspecified launch gets: the fleet default for engines that reserve at load, otherwise the maximum.

    reserves_context_at_load?: boolean

    Whether the engine reserves the whole window's KV memory at load.

    kv_bytes_per_token?: number | null

    Estimated KV bytes per token of window across the placement.

    Settings

    Member Visibility

    On This Page

    Properties