Skip to main content

ModelList

objectObject (string)
Constant value: list
Default value: list
data object[]required
  • Array [
  • idId (string)required
    objectObject (string)
    Default value: model
    createdCreated (integer)
    owned_byOwned By (string)
    Default value: skulk
    hugging_face_idHugging Face Id (string)
    Default value:
    nameName (string)
    Default value:
    descriptionDescription (string)
    Default value:
    context_lengthContext Length (integer)
    Default value: 0
    tagsstring[]
    Default value: []
    storage_size_megabytesStorage Size Megabytes (integer)
    Default value: 0
    supports_tensorSupports Tensor (boolean)
    Default value: false
    tasksstring[]
    Default value: []
    is_customIs Custom (boolean)
    Default value: false
    system_role object

    Set for fabric-managed system entries ("steward" = the intelligent-fabric resident, addressable as a chat model but not user-placeable). Model pickers should badge or separate these rather than listing them as ordinary models.

    anyOf
    string
    Constant value: steward
    familyFamily (string)
    Default value:
    quantizationQuantization (string)
    Default value:
    base_modelBase Model (string)
    Default value:
    artifact_repositoryArtifact Repository (string)

    Upstream repository containing the exact artifact; distinct from id when multiple registry cards select files from one repository.

    Default value:
    artifact_file object

    Exact selected repository file for file-addressed artifacts.

    anyOf
    string
    registry_card_id object

    Immutable signed-registry card id, or null for local cards.

    anyOf
    string

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

    registry_snapshot_id object

    Signed snapshot that supplied this card, or null for local cards.

    anyOf
    string
    registry_provenance object

    Audited signed-registry origin, or null for bundled and custom cards.

    anyOf
    string

    Possible values: [foxlight, agent, community]

    registry_architecture object

    Trusted open architecture identity from signed metadata.

    anyOf
    string
    capability_claims object[]

    Open signed model/artifact capabilities independent of engines.

  • Array [
  • capability_idCapability Id (string)required

    Open namespaced intrinsic capability identifier.

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

    scopeScope (string)required

    Whether the claim describes the model or selected artifact.

    Possible values: [model, artifact]

    statusStatus (string)required

    Evidence state without an engine-support implication.

    Possible values: [claimed, observed, complete, incomplete, unknown]

    sourceSource (string)required

    Evidence channel that produced the claim.

    Possible values: [upstream_structured, artifact_manifest, agent_analysis]

    confidenceConfidence (number)required

    Source confidence from zero through one.

    Possible values: >= 0 and <= 1

    evidence_urlsstring[]

    Bounded evidence references.

    Possible values: <= 20

    Default value: []
    reviewer_model object

    Agent reviewer identity, if any.

    anyOf
    string

    Possible values: <= 300 characters

    input_modalitiesstring[]

    Declared input modalities.

    Possible values: <= 20

    Default value: []
    output_modalitiesstring[]

    Declared output modalities.

    Possible values: <= 20

    Default value: []
    details object

    Open capability-specific evidence details.

    property name*any

    Open capability-specific evidence details.

  • ]
  • engine_support object[]

    Active signed engine/build claims matching this exact artifact.

  • 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.

  • ]
  • installedInstalled (boolean)

    Whether this node has an active complete installed generation.

    Default value: false
    active_installed_identity object

    Durable identity of the generation this node will launch.

    anyOf
    string
    installed_verification object

    Evidence level binding the active card to local artifact bytes.

    anyOf
    string

    Possible values: [registry_verified, local_legacy, custom, unresolved]

    current_registry_identity object

    Current signed card identity for this alias, when available.

    anyOf
    string
    update_availableUpdate Available (boolean)

    Whether registry truth names a newer generation than the active installation.

    Default value: false
    advisories object[]

    Active signed warnings affecting this installed or current card.

  • Array [
  • schema_versionSchema Version (integer)required
    Constant value: 1
    advisory_idAdvisory Id (string)required

    Possible values: Value must match regular expression ^FLA-[0-9]{4}-[0-9]{4,}$

    severitySeverity (string)required

    Possible values: [low, moderate, high, critical]

    titleTitle (string)required

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

    descriptionDescription (string)required

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

    affected_card_idsstring[]
    Default value: []
    affected_model_aliasesstring[]
    Default value: []
    reference_url object
    anyOf
    string

    Possible values: <= 2048 characters

    activeActive (boolean)required
    created_atstring<date-time>required
    updated_atstring<date-time>required
    enforcementEnforcement (string)required
    Constant value: warn
  • ]
  • catalog_sourceCatalog Source (string)

    Trust and precedence source for this catalog entry.

    Possible values: [registry, bundled, custom]

    Default value: bundled
    remote_code_approval_requiredRemote Code Approval Required (boolean)

    Whether this card or its selected platform loader can execute repository Python and is not automatically trusted by immutable Foxlight provenance, requiring a cluster operator decision.

    Default value: false
    remote_code_trust_identity object

    Exact identity the operator approves for repository-code execution, or null when the model needs no explicit decision.

    anyOf
    string

    Possible values: Value must match regular expression ^(?:card|local)_[a-z2-7]{52}$

    remote_code_approved_for_clusterRemote Code Approved For Cluster (boolean)

    Whether the operator approved this exact immutable model-card identity for repository-code execution across the cluster.

    Default value: false
    remote_code_approved_on_this_nodeRemote Code Approved On This Node (boolean)deprecated

    Deprecated compatibility alias for remote_code_approved_for_cluster; model trust is no longer node-local.

    Default value: false
    remote_code_automatically_trustedRemote Code Automatically Trusted (boolean)

    Whether signed Foxlight provenance authorizes repository code for this exact pinned registry card without a second operator decision.

    Default value: false
    source_revision object

    Immutable Hugging Face source commit used for this model's qualified artifacts, or null when the card follows mutable main.

    anyOf
    string

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

    capabilitiesstring[]

    Coarse catalog capability labels such as text, vision, thinking, or embedding.

    reasoning object

    Optional declarative reasoning controls from the model card.

    anyOf
    supports_toggle object
    anyOf
    boolean
    supports_budget object
    anyOf
    boolean
    format object
    anyOf
    string
    default_effort object
    anyOf
    string

    Possible values: [none, minimal, low, medium, high, xhigh]

    disabled_effort object
    anyOf
    string

    Possible values: [none, minimal, low, medium, high, xhigh]

    modalities object

    Optional declarative modality support details from the model card.

    anyOf
    supports_audio_input object
    anyOf
    boolean
    supports_native_multimodal object
    anyOf
    boolean
    audio object

    Optional declarative speech-serving metadata from the model card.

    anyOf
    kind object

    Speech serving kind declared by the card: tts or stt.

    anyOf
    string
    default_response_format object

    Default encoded audio response format for TTS requests.

    anyOf
    string
    response_formatsstring[]

    Encoded audio response formats declared for TTS requests.

    supports_streaming object

    Whether the card declares streaming speech support after runtime validation.

    anyOf
    boolean
    supports_realtime object

    Whether the model declares realtime audio session support.

    anyOf
    boolean
    supports_voice_listing object

    Whether the model declares voice-listing support.

    anyOf
    boolean
    default_voice object

    Stable voice used when a request omits an explicit voice.

    anyOf
    string
    voicesstring[]

    Stable built-in or bundled-reference voice identifiers.

    supports_reference_audio object

    Whether the model accepts managed reference audio.

    anyOf
    boolean
    supports_translation object

    Whether the model declares speech translation support.

    anyOf
    boolean
    sample_ratesinteger[]

    Declared input or output sample rates in hertz.

    tooling object

    Optional declarative tool-calling metadata from the model card.

    anyOf
    supports_tool_calling object
    anyOf
    boolean
    builtin_tools object
    anyOf
  • Array [
  • string
  • ]
  • tool_call_format object
    anyOf
    string
    runtime object

    Optional declarative runtime integration hints from the model card.

    anyOf
    prompt_renderer object
    anyOf
    string
    output_parser object
    anyOf
    string
    mtp_sidecar_repo object

    Repo of this model's MTP sidecar (prediction heads), when it declares one. The sidecar is a companion loaded alongside the base model, not an independently placeable model. Lets clients mark the sidecar repo as a companion rather than a launchable entry.

    anyOf
    string
    mtp_sidecar_revision object

    Immutable commit of the MTP sidecar repository.

    anyOf
    string
    assistant_model_repo object

    Repo of this model's speculative-decoding assistant (drafter), when it declares one. A companion loaded with the base model, not independently placeable.

    anyOf
    string
    assistant_model_revision object

    Immutable commit of the assistant-model repository.

    anyOf
    string
    served_spec_draft_repo object

    Repo of this model's served-engine draft GGUF, when it declares a separate one. A companion loaded with the base model, not independently placeable.

    anyOf
    string
    served_spec_draft_revision object

    Immutable commit of the served-engine draft repository.

    anyOf
    string
    vllm_spec_draft_repo object

    Repo of this model's vLLM speculative-decoding drafter, when it declares one. A companion loaded with the base model, not independently placeable.

    anyOf
    string
    vllm_spec_draft_revision object

    Immutable commit of the vLLM drafter repository.

    anyOf
    string
    resolved_capabilities object

    Normalized runtime capabilities resolved from the model card and model-family defaults for the default tool-free request path. Request-specific options such as tools may change some resolved values.

    anyOf
    familyFamily (string)

    Resolved model family used for runtime behavior decisions.

    Default value:
    supports_thinkingSupports Thinking (boolean)

    Whether the runtime expects the model to expose a reasoning or thinking mode.

    Default value: false
    supports_thinking_toggleSupports Thinking Toggle (boolean)

    Whether thinking can be explicitly enabled or disabled for requests.

    Default value: false
    supports_thinking_budgetSupports Thinking Budget (boolean)

    Whether the runtime expects the model to accept a thinking or reasoning budget control.

    Default value: false
    default_reasoning_effortDefault Reasoning Effort (string)

    Reasoning effort used when thinking is enabled without an explicit effort override.

    Possible values: [none, minimal, low, medium, high, xhigh]

    Default value: medium
    disabled_reasoning_effortDisabled Reasoning Effort (string)

    Reasoning effort used when thinking is explicitly disabled.

    Possible values: [none, minimal, low, medium, high, xhigh]

    Default value: none
    thinking_formatThinking Format (string)

    Resolved reasoning marker format expected from this model family.

    Default value: none
    supports_image_inputSupports Image Input (boolean)

    Whether the runtime should treat the model as accepting image inputs.

    Default value: false
    supports_audio_inputSupports Audio Input (boolean)

    Whether the runtime should treat the model as accepting audio inputs.

    Default value: false
    supports_speech_synthesisSupports Speech Synthesis (boolean)

    Whether the runtime should treat the model as a text-to-speech model.

    Default value: false
    supports_transcriptionSupports Transcription (boolean)

    Whether the runtime should treat the model as a speech-to-text model.

    Default value: false
    supports_speech_translationSupports Speech Translation (boolean)

    Whether the runtime should treat the model as supporting speech translation.

    Default value: false
    supports_audio_outputSupports Audio Output (boolean)

    Whether the runtime should expect this model to produce audio output.

    Default value: false
    supports_realtime_audioSupports Realtime Audio (boolean)

    Whether the runtime should expect this model to expose realtime audio sessions.

    Default value: false
    default_audio_response_format object

    Default encoded audio response format for speech synthesis, when declared.

    anyOf
    string
    audio_response_formatsstring[]

    Encoded audio response formats the model can produce.

    supports_tool_callingSupports Tool Calling (boolean)

    Whether the runtime expects the model to support structured tool calling.

    Default value: false
    builtin_toolsstring[]

    Builtin platform tool contracts that Skulk may expose to this model family.

    tool_call_formatTool Call Format (string)

    Resolved tool-call output format family used for parsing.

    Default value: generic
    prompt_rendererPrompt Renderer (string)

    Resolved prompt renderer strategy used to prepare requests for this model.

    Default value: tokenizer
    output_parserOutput Parser (string)

    Resolved output parser strategy used to interpret model responses.

    Default value: generic
    supports_native_multimodalSupports Native Multimodal (boolean)

    Whether the runtime can use a native multimodal execution path for the model.

    Default value: false
  • ]
  • ModelList
    {
    "object": "list",
    "data": [
    {
    "id": "string",
    "object": "model",
    "created": 0,
    "owned_by": "skulk",
    "hugging_face_id": "",
    "name": "",
    "description": "",
    "context_length": 0,
    "tags": [
    "string"
    ],
    "storage_size_megabytes": 0,
    "supports_tensor": false,
    "tasks": [
    "string"
    ],
    "is_custom": false,
    "system_role": "steward",
    "family": "",
    "quantization": "",
    "base_model": "",
    "artifact_repository": "",
    "artifact_file": "string",
    "registry_card_id": "string",
    "registry_snapshot_id": "string",
    "registry_provenance": "foxlight",
    "registry_architecture": "string",
    "capability_claims": [
    {
    "capability_id": "string",
    "scope": "model",
    "status": "claimed",
    "source": "upstream_structured",
    "confidence": 0,
    "evidence_urls": [
    "string"
    ],
    "reviewer_model": "string",
    "input_modalities": [
    "string"
    ],
    "output_modalities": [
    "string"
    ],
    "details": {}
    }
    ],
    "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"
    }
    ],
    "installed": false,
    "active_installed_identity": "string",
    "installed_verification": "registry_verified",
    "current_registry_identity": "string",
    "update_available": false,
    "advisories": [
    {
    "schema_version": 1,
    "advisory_id": "string",
    "severity": "low",
    "title": "string",
    "description": "string",
    "affected_card_ids": [
    "string"
    ],
    "affected_model_aliases": [
    "string"
    ],
    "reference_url": "string",
    "active": true,
    "created_at": "2024-07-29T15:51:28.071Z",
    "updated_at": "2024-07-29T15:51:28.071Z",
    "enforcement": "warn"
    }
    ],
    "catalog_source": "bundled",
    "remote_code_approval_required": false,
    "remote_code_trust_identity": "string",
    "remote_code_approved_for_cluster": false,
    "remote_code_automatically_trusted": false,
    "source_revision": "string",
    "capabilities": [
    "string"
    ],
    "reasoning": {
    "supports_toggle": true,
    "supports_budget": true,
    "format": "string",
    "default_effort": "none",
    "disabled_effort": "none"
    },
    "modalities": {
    "supports_audio_input": true,
    "supports_native_multimodal": true
    },
    "audio": {
    "kind": "string",
    "default_response_format": "string",
    "response_formats": [
    "string"
    ],
    "supports_streaming": true,
    "supports_realtime": true,
    "supports_voice_listing": true,
    "default_voice": "string",
    "voices": [
    "string"
    ],
    "supports_reference_audio": true,
    "supports_translation": true,
    "sample_rates": [
    0
    ]
    },
    "tooling": {
    "supports_tool_calling": true,
    "builtin_tools": [
    "string"
    ],
    "tool_call_format": "string"
    },
    "runtime": {
    "prompt_renderer": "string",
    "output_parser": "string",
    "mtp_sidecar_repo": "string",
    "mtp_sidecar_revision": "string",
    "assistant_model_repo": "string",
    "assistant_model_revision": "string",
    "served_spec_draft_repo": "string",
    "served_spec_draft_revision": "string",
    "vllm_spec_draft_repo": "string",
    "vllm_spec_draft_revision": "string"
    },
    "resolved_capabilities": {
    "family": "",
    "supports_thinking": false,
    "supports_thinking_toggle": false,
    "supports_thinking_budget": false,
    "default_reasoning_effort": "medium",
    "disabled_reasoning_effort": "none",
    "thinking_format": "none",
    "supports_image_input": false,
    "supports_audio_input": false,
    "supports_speech_synthesis": false,
    "supports_transcription": false,
    "supports_speech_translation": false,
    "supports_audio_output": false,
    "supports_realtime_audio": false,
    "default_audio_response_format": "string",
    "audio_response_formats": [
    "string"
    ],
    "supports_tool_calling": false,
    "builtin_tools": [
    "string"
    ],
    "tool_call_format": "generic",
    "prompt_renderer": "tokenizer",
    "output_parser": "generic",
    "supports_native_multimodal": false
    }
    }
    ]
    }