Enum CompletionKey 

pub enum CompletionKey {
    HfFile {
        repo_id: String,
        revision: String,
        filename_canon: String,
        quantization: Option<String>,
    },
    UrlFile {
        url: String,
        filename: String,
    },
    LocalFile {
        path: String,
    },
}

Stable artifact identity for completion tracking.

This key is computed at enqueue time (before download starts) and remains stable across retries, failures, and sharded downloads. It represents “what the user thinks they downloaded” from an artifact perspective, not a request perspective.

Identity Semantics

• Same artifact downloaded twice → same key (deduplication)
• All shards in a group → same key (one entry)
• Failures before metadata available → key still valid
• Survives cancellations and retries

Variants

HfFile

HuggingFace model file.

Fields

repo_id: String

Repository ID (e.g., “unsloth/Llama-3-GGUF”).

revision: String

Git revision (branch, tag, or commit SHA). Stores exactly what the user requested (e.g., “main”, “v1.0”, or a SHA). Use “unspecified” if no revision was provided.

filename_canon: String

Canonical filename (normalized for sharded models). Shard suffixes are stripped: “model-00001-of-00008.gguf” → “model.gguf”

quantization: Option<String>

Quantization type (e.g., “Q4_K_M”). Optional since some downloads may not have a meaningful quantization.

UrlFile

File downloaded from URL.

Fields

url: String

Source URL.

filename: String

Target filename.

LocalFile

Local file operation.

Fields

path: String

Absolute path to the file.

Trait Implementations

impl Clone for CompletionKey

fn clone(&self) -> CompletionKey

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CompletionKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CompletionKey

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for CompletionKey

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Hash for CompletionKey

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CompletionKey

fn eq(&self, other: &CompletionKey) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for CompletionKey

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for CompletionKey

impl StructuralPartialEq for CompletionKey