Skip to main content

ModelRequirements

Advisory whole-model requirements from effective catalog metadata.

A result reserves no resources and grants no execution authority. Joined node compatibility, current artifact identity and placement admission must still be checked before loading a runner.

model_idModel Id (string)required

Exact selectable model alias.

card_digestCard Digest (string)required

SHA-256 of canonical card JSON excluding registry_snapshot_id.

Possible values: Value must match regular expression ^[a-f0-9]{64}$

registry_card_id objectrequired

Signed card identity, when present.

anyOf
string
context_tokensContext Tokens (integer)required

Requested per-sequence context budget.

Possible values: >= 1

context_limit objectrequired

Advertised card context limit; null when unknown.

anyOf
integer
storage_bytesStorage Bytes (integer)required

Card weight bytes plus a declared GGUF vision projector; excludes runtime image, staging and caches.

Possible values: >= 0

estimated_memory_bytes objectrequired

Whole-model core footprint at the requested context; null when text KV geometry is unavailable or the task is not text generation.

anyOf
integer

Possible values: >= 0

discrete_gpu_memory_fractionDiscrete Gpu Memory Fraction (number)required

Core fraction of discrete VRAM usable for the estimated footprint; do not sum GPU memory without supported sharding.

Possible values: > 0 and <= 1

unified_memory_fractionUnified Memory Fraction (number)required

Core Apple unified-memory working-set fraction of total RAM.

Possible values: > 0 and <= 1

compatible_backendsstring[]required

Declared backend tags; live platform and runner constraints still apply.

required_capabilitiesstring[]required

Complete positively evidenced capability set required for signed engine support; an empty set cannot authorize matrix-only admission.

engine_support object[]required

Matching signed engine claims; status, exact build and hardware constraints remain authoritative.

  • Array [
    • engineEngine (string)required

    Open inference-engine identifier.

    Possible values: Value must match regular expression ^[a-z0-9][a-z0-9._:-]{0,119}$

    engine_buildEngine Build (string)required

    Exact engine build qualified by this decision.

    Possible values: non-empty and <= 300 characters

    architectureArchitecture (string)required

    Trusted open architecture identifier.

    Possible values: Value must match regular expression ^[A-Za-z0-9][A-Za-z0-9._:-]{0,299}$

    artifact_formatArtifact Format (string)required

    Exact selected artifact format.

    Possible values: Value must match regular expression ^[a-z0-9][a-z0-9._+-]{0,79}$

    artifact_card_id object

    Exact card qualified by load or feature evidence; null is permitted only for architecture-level upstream compatibility.

    anyOf
    string

    Possible values: Value must match regular expression ^card_[a-z2-7]{52}$

    quantization object

    Exact quantization or null as a format-wide wildcard.

    anyOf
    string

    Possible values: <= 120 characters

    capability_idCapability Id (string)required

    Intrinsic capability this engine decision covers.

    Possible values: Value must match regular expression ^[a-z0-9][a-z0-9._:-]{0,199}$

    statusStatus (string)required

    Decision status; only supported can expand placement.

    Possible values: [supported, experimental, unsupported]

    evidence_kindEvidence Kind (string)required

    Kind of compatibility evidence reviewed.

    Possible values: [upstream_compatibility, load_qualification, feature_qualification]

    evidence_trustEvidence Trust (string)required

    Trust tier assigned to the evidence.

    Possible values: [self_attested, third_party_reported, reproducible, independently_reproduced, foxlight_observed]

    source_urlSource Url (string)required

    Stable evidence location.

    Possible values: >= 8 characters and <= 2048 characters

    source_sha256Source Sha256 (string)required

    Evidence bundle SHA-256 digest.

    Possible values: Value must match regular expression ^[0-9a-f]{64}$

    rationaleRationale (string)required

    Auditable decision rationale.

    Possible values: >= 3 characters and <= 4000 characters

    hardware_classesstring[]

    Optional open hardware constraints; empty is neutral.

    Possible values: <= 50

    Default value: []
    supersedes_claim_id object

    Prior active claim for the same exact key being replaced.

    anyOf
    string

    Possible values: Value must match regular expression ^support_[a-z2-7]{52}$

    claim_idClaim Id (string)required

    Content-derived immutable support-claim identity.

    Possible values: Value must match regular expression ^support_[a-z2-7]{52}$

    recorded_byRecorded By (string)required

    Audited publishing actor.

    Possible values: non-empty and <= 320 characters

    created_atstring<date-time>required

    UTC claim publication time.

  • ]
    • incomplete_capabilitiesstring[]required

    Artifact capabilities explicitly marked incomplete; these block admission.

    estimate_onlyEstimate Only (boolean)

    Estimates are neither measured fit nor a placement or spending authorization.

    Constant value: true
    Default value: true
    ModelRequirements
    {
      "model_id": "string",
      "card_digest": "string",
      "registry_card_id": "string",
      "context_tokens": 0,
      "context_limit": 0,
      "storage_bytes": 0,
      "estimated_memory_bytes": 0,
      "discrete_gpu_memory_fraction": 0,
      "unified_memory_fraction": 0,
      "compatible_backends": [
        "string"
      ],
      "required_capabilities": [
        "string"
      ],
      "engine_support": [
        {
          "engine": "string",
          "engine_build": "string",
          "architecture": "string",
          "artifact_format": "string",
          "artifact_card_id": "string",
          "quantization": "string",
          "capability_id": "string",
          "status": "supported",
          "evidence_kind": "upstream_compatibility",
          "evidence_trust": "self_attested",
          "source_url": "string",
          "source_sha256": "string",
          "rationale": "string",
          "hardware_classes": [
            "string"
          ],
          "supersedes_claim_id": "string",
          "claim_id": "string",
          "recorded_by": "string",
          "created_at": "2024-07-29T15:51:28.071Z"
        }
      ],
      "incomplete_capabilities": [
        "string"
      ],
      "estimate_only": true
    }