huggingbay-xyz · Schema

RunCard

AIOpen-SourceModelsPlatformMachine-Learning

Properties

Name Type Description
schema object
contractVersion object
id string
decisionId string
agentHandoffId string
publisherReferralId string
signingKeyId string
task string
constraints object
rig object
representation object
runtime object
fit object
smoke object
recovery object
policy object
evidenceCutoff string
executableState string
authority object
authorization object
use object
runCardDigest string
signature object
note object
noteMessage string Original route note, when a public qualification occupies note.
View JSON Schema on GitHub

JSON Schema

huggingbay-xyz-run-card-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-run-card-schema.json",
  "title": "RunCard",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/huggingbay-xyz-openapi.json#/components/schemas/RunCard",
  "type": "object",
  "required": [
    "schema",
    "contractVersion",
    "id",
    "decisionId",
    "agentHandoffId",
    "signingKeyId",
    "task",
    "constraints",
    "rig",
    "representation",
    "runtime",
    "fit",
    "smoke",
    "recovery",
    "policy",
    "evidenceCutoff",
    "executableState",
    "authority",
    "authorization",
    "use",
    "runCardDigest",
    "signature"
  ],
  "properties": {
    "schema": {
      "const": "hugging-bay.run-card.v1"
    },
    "contractVersion": {
      "const": "1.1.0"
    },
    "id": {
      "type": "string",
      "pattern": "^hbrc_[a-f0-9]{32}([a-f0-9]{32})?$"
    },
    "decisionId": {
      "type": "string",
      "pattern": "^hbd_[a-f0-9]{32}([a-f0-9]{32})?$"
    },
    "agentHandoffId": {
      "type": "string",
      "pattern": "^hbah_[a-f0-9]{32}([a-f0-9]{32})?$"
    },
    "publisherReferralId": {
      "type": "string",
      "maxLength": 160
    },
    "signingKeyId": {
      "type": "string",
      "pattern": "^ed25519:[a-f0-9]{24}$"
    },
    "task": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120
    },
    "constraints": {
      "type": "object",
      "maxProperties": 8,
      "properties": {
        "contextTokens": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4194304
        },
        "maxDownloadBytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10995116277760
        },
        "maxDiskBytes": {
          "type": "integer",
          "minimum": 0,
          "maximum": 10995116277760
        },
        "commercialSafe": {
          "type": "boolean"
        },
        "privacy": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "bandwidthClass": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "qualityFloor": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "language": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      },
      "additionalProperties": false
    },
    "rig": {
      "type": "object",
      "required": [
        "id",
        "profileDigest"
      ],
      "properties": {
        "id": {
          "type": "string",
          "minLength": 1,
          "maxLength": 120
        },
        "profileDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      },
      "additionalProperties": false
    },
    "representation": {
      "type": "object",
      "required": [
        "artifactId",
        "representationId",
        "source",
        "selectedFilesDigest",
        "representationDigest",
        "evidenceSnapshotDigest",
        "files"
      ],
      "properties": {
        "artifactId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "representationId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "source": {
          "type": "object",
          "required": [
            "provider",
            "identity",
            "revision"
          ],
          "properties": {
            "provider": {
              "type": "string",
              "minLength": 1,
              "maxLength": 40
            },
            "identity": {
              "type": "string",
              "minLength": 1,
              "maxLength": 240
            },
            "revision": {
              "type": "string",
              "pattern": "^[a-f0-9]{40}([a-f0-9]{24})?$"
            },
            "note": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "object",
                  "required": [
                    "summary"
                  ],
                  "properties": {
                    "summary": {
                      "type": "string"
                    },
                    "downloadable": {
                      "type": "boolean"
                    }
                  },
                  "additionalProperties": false
                }
              ]
            },
            "noteMessage": {
              "type": "string",
              "description": "Original route note, when a public qualification occupies note."
            }
          },
          "additionalProperties": false
        },
        "selectedFilesDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "representationDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "evidenceSnapshotDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "files": {
          "type": "array",
          "minItems": 1,
          "maxItems": 256,
          "items": {
            "type": "object",
            "required": [
              "path",
              "role",
              "sizeBytes",
              "sha256"
            ],
            "properties": {
              "path": {
                "type": "string",
                "minLength": 1,
                "maxLength": 500
              },
              "role": {
                "type": "string",
                "minLength": 1,
                "maxLength": 40
              },
              "sizeBytes": {
                "type": "integer",
                "minimum": 1
              },
              "sha256": {
                "type": "string",
                "pattern": "^sha256:[a-f0-9]{64}$"
              },
              "note": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "object",
                    "required": [
                      "summary"
                    ],
                    "properties": {
                      "summary": {
                        "type": "string"
                      },
                      "downloadable": {
                        "type": "boolean"
                      }
                    },
                    "additionalProperties": false
                  }
                ]
              },
              "noteMessage": {
                "type": "string",
                "description": "Original route note, when a public qualification occupies note."
              }
            },
            "additionalProperties": false
          }
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      },
      "additionalProperties": false
    },
    "runtime": {
      "type": "object",
      "required": [
        "adapterId",
        "engineVersion",
        "adapterVersion",
        "adapterAbiVersion",
        "executable",
        "contractDigest",
        "commandEvidenceDigest",
        "argv"
      ],
      "properties": {
        "adapterId": {
          "type": "string",
          "enum": [
            "llama.cpp",
            "sentence-transformers",
            "transformers"
          ]
        },
        "engineVersion": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "adapterVersion": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "adapterAbiVersion": {
          "type": "string",
          "minLength": 1,
          "maxLength": 80
        },
        "executable": {
          "const": "hbay-runtime"
        },
        "contractDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "commandEvidenceDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "argv": {
          "type": "array",
          "minItems": 1,
          "maxItems": 64,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 512
          }
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      },
      "additionalProperties": false
    },
    "fit": {
      "type": "object",
      "required": [
        "verdict",
        "evidenceLevel",
        "requiredBytes",
        "headroomBytes",
        "evidenceDigest"
      ],
      "additionalProperties": false,
      "properties": {
        "verdict": {
          "const": "fits"
        },
        "evidenceLevel": {
          "type": "string",
          "enum": [
            "measured",
            "conservative-estimate"
          ]
        },
        "requiredBytes": {
          "type": "integer",
          "minimum": 1
        },
        "headroomBytes": {
          "type": "integer",
          "minimum": 0
        },
        "evidenceDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "smoke": {
      "type": "object",
      "required": [
        "suiteId",
        "expectedBoundary",
        "passed",
        "passedAt",
        "evidenceDigest"
      ],
      "additionalProperties": false,
      "properties": {
        "suiteId": {
          "type": "string"
        },
        "expectedBoundary": {
          "type": "string"
        },
        "passed": {
          "const": true
        },
        "passedAt": {
          "type": "string",
          "format": "date-time"
        },
        "evidenceDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "recovery": {
      "type": "object",
      "required": [
        "code",
        "path"
      ],
      "additionalProperties": false,
      "properties": {
        "code": {
          "type": "string"
        },
        "path": {
          "type": "string",
          "pattern": "^/[^/].*"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "policy": {
      "type": "object",
      "required": [
        "decision",
        "policyDigest",
        "reasonCodes",
        "expiresAt"
      ],
      "additionalProperties": false,
      "properties": {
        "decision": {
          "const": "allow"
        },
        "policyDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "reasonCodes": {
          "type": "array",
          "maxItems": 64,
          "items": {
            "type": "string"
          }
        },
        "expiresAt": {
          "type": "string",
          "format": "date-time"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "evidenceCutoff": {
      "type": "string",
      "format": "date-time"
    },
    "executableState": {
      "type": "string",
      "enum": [
        "complete-runnable",
        "complete-verified"
      ]
    },
    "authority": {
      "type": "object",
      "required": [
        "automationPreflightId",
        "decisionDigest",
        "policyEvidenceId",
        "policyEvidenceDigest"
      ],
      "additionalProperties": false,
      "properties": {
        "automationPreflightId": {
          "type": "string",
          "pattern": "^hbap_[a-f0-9]{64}$"
        },
        "decisionDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "policyEvidenceId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "policyEvidenceDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "authorization": {
      "type": "object",
      "required": [
        "principalId",
        "owner"
      ],
      "additionalProperties": false,
      "properties": {
        "principalId": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "owner": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "use": {
      "type": "object",
      "required": [
        "argv"
      ],
      "additionalProperties": false,
      "properties": {
        "argv": {
          "type": "array",
          "minItems": 3,
          "maxItems": 3,
          "prefixItems": [
            {
              "const": "hbay"
            },
            {
              "const": "use"
            },
            {
              "type": "string",
              "pattern": "^hbrc_[a-f0-9]{32}([a-f0-9]{32})?$"
            }
          ]
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "runCardDigest": {
      "type": "string",
      "pattern": "^sha256:[a-f0-9]{64}$"
    },
    "signature": {
      "type": "object",
      "required": [
        "algorithm",
        "keyId",
        "canonicalDigest",
        "value"
      ],
      "additionalProperties": false,
      "properties": {
        "algorithm": {
          "const": "Ed25519"
        },
        "keyId": {
          "type": "string",
          "pattern": "^ed25519:[a-f0-9]{24}$"
        },
        "canonicalDigest": {
          "type": "string",
          "pattern": "^sha256:[a-f0-9]{64}$"
        },
        "value": {
          "type": "string",
          "minLength": 1
        },
        "note": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "object",
              "required": [
                "summary"
              ],
              "properties": {
                "summary": {
                  "type": "string"
                },
                "downloadable": {
                  "type": "boolean"
                }
              },
              "additionalProperties": false
            }
          ]
        },
        "noteMessage": {
          "type": "string",
          "description": "Original route note, when a public qualification occupies note."
        }
      }
    },
    "note": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "required": [
            "summary"
          ],
          "properties": {
            "summary": {
              "type": "string"
            },
            "downloadable": {
              "type": "boolean"
            }
          },
          "additionalProperties": false
        }
      ]
    },
    "noteMessage": {
      "type": "string",
      "description": "Original route note, when a public qualification occupies note."
    }
  },
  "additionalProperties": false
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/huggingbay-xyz-run-card"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.