huggingbay-xyz · Schema

SdkFindRunnable

Artificial IntelligenceOpen SourceModelsPlatformMachine Learning

Properties

Name Type Description
oneAnswer object
local object
fallback object
schemaVersion string
generatedAt string
summary string
recommendation object
alternatives array
next_call object
deploymentPlan object
executionAvailable boolean
commandsAvailable boolean
runTested boolean
runReady boolean
runReadyReasonCodes array
freshness object
degraded boolean
stale boolean
View JSON Schema on GitHub

JSON Schema

huggingbay-xyz-sdk-find-runnable-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-sdk-find-runnable-schema.json",
  "title": "SdkFindRunnable",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/huggingbay-xyz-agents-api-openapi.yml#/components/schemas/SdkFindRunnable",
  "type": "object",
  "properties": {
    "oneAnswer": {
      "$ref": "#/$defs/OneAnswer"
    },
    "local": {
      "enum": [
        "found",
        "none_found",
        "checking"
      ]
    },
    "fallback": {
      "type": "object",
      "properties": {
        "kind": {
          "const": "bay-run"
        },
        "labelled": {
          "const": true
        },
        "reason": {
          "type": "string"
        }
      },
      "required": [],
      "additionalProperties": true
    },
    "schemaVersion": {
      "type": "string"
    },
    "generatedAt": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "recommendation": {
      "anyOf": [
        {
          "$ref": "#/$defs/SdkRunnableCandidate"
        },
        {
          "type": "null"
        }
      ]
    },
    "alternatives": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/SdkRunnableCandidate"
      }
    },
    "next_call": {
      "anyOf": [
        {
          "type": "object",
          "properties": {},
          "required": [],
          "additionalProperties": true
        },
        {
          "type": "null"
        }
      ]
    },
    "deploymentPlan": {
      "anyOf": [
        {
          "$ref": "#/$defs/SdkDeploymentPlan"
        },
        {
          "type": "null"
        }
      ]
    },
    "executionAvailable": {
      "type": "boolean"
    },
    "commandsAvailable": {
      "type": "boolean"
    },
    "runTested": {
      "type": "boolean"
    },
    "runReady": {
      "type": "boolean"
    },
    "runReadyReasonCodes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "freshness": {
      "type": "object",
      "properties": {
        "degraded": {
          "type": "boolean"
        },
        "stale": {
          "type": "boolean"
        }
      },
      "required": [],
      "additionalProperties": true
    },
    "degraded": {
      "type": "boolean"
    },
    "stale": {
      "type": "boolean"
    }
  },
  "required": [
    "schemaVersion",
    "generatedAt"
  ],
  "additionalProperties": true,
  "$defs": {
    "OneAnswer": {
      "type": "object",
      "properties": {
        "schemaVersion": {
          "const": "hugging-bay.one-answer.v1"
        },
        "question": {
          "type": "object",
          "properties": {
            "task": {
              "type": "string"
            },
            "hardware": {
              "type": "object",
              "properties": {
                "memoryGb": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "deviceFamily": {
                  "type": "string"
                },
                "hardwareClass": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "os": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "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."
                }
              },
              "required": [
                "memoryGb",
                "deviceFamily",
                "hardwareClass",
                "os"
              ],
              "additionalProperties": false
            },
            "contextTokens": {
              "type": "number"
            },
            "commercial": {
              "type": "boolean"
            },
            "model": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "provenOnly": {
              "type": "boolean"
            },
            "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."
            }
          },
          "required": [
            "task",
            "hardware",
            "contextTokens",
            "commercial",
            "model",
            "provenOnly"
          ],
          "additionalProperties": false
        },
        "snapshot": {
          "type": "object",
          "properties": {
            "at": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "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."
            }
          },
          "required": [
            "at"
          ],
          "additionalProperties": false
        },
        "state": {
          "enum": [
            "ready",
            "checking",
            "unavailable",
            "no_fit",
            "blocked"
          ]
        },
        "exactFile": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "artifactId": {
                  "type": "string"
                },
                "repo": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "path": {
                  "type": "string"
                },
                "sha256": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "sizeBytes": {
                  "type": "integer",
                  "minimum": 1000000
                },
                "downloadUrl": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "fit": {
                  "type": "object",
                  "properties": {
                    "verdict": {
                      "enum": [
                        "fits",
                        "too_large",
                        "unknown"
                      ]
                    },
                    "basis": {
                      "const": "file-size-estimate"
                    },
                    "memoryGb": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "sizeBytes": {
                      "type": "number"
                    },
                    "maxFileSizeBytes": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "contextTokens": {
                      "type": "number"
                    },
                    "runtimeVerified": {
                      "const": 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."
                    }
                  },
                  "required": [
                    "verdict",
                    "basis",
                    "memoryGb",
                    "sizeBytes",
                    "maxFileSizeBytes",
                    "contextTokens",
                    "runtimeVerified"
                  ],
                  "additionalProperties": false
                },
                "serve": {
                  "type": "object",
                  "properties": {
                    "verdict": {
                      "enum": [
                        "ready",
                        "blocked",
                        "checking"
                      ]
                    },
                    "canDownload": {
                      "type": "boolean"
                    },
                    "checkedAt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "evidenceUrl": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "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."
                    }
                  },
                  "required": [
                    "verdict",
                    "canDownload",
                    "checkedAt",
                    "evidenceUrl"
                  ],
                  "additionalProperties": false
                },
                "freshness": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "enum": [
                        "current",
                        "stale",
                        "unknown"
                      ]
                    },
                    "checkedAt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "ageMs": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "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."
                    }
                  },
                  "required": [
                    "state",
                    "checkedAt",
                    "ageMs"
                  ],
                  "additionalProperties": false
                },
                "signature": {
                  "enum": [
                    "signed",
                    "unsigned",
                    "pending"
                  ]
                },
                "runReceipt": {
                  "anyOf": [
                    {
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "license": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "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."
                }
              },
              "required": [
                "artifactId",
                "repo",
                "path",
                "sha256",
                "sizeBytes",
                "downloadUrl",
                "fit",
                "serve",
                "freshness",
                "signature",
                "runReceipt",
                "license"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "sha256": {
          "anyOf": [
            {
              "type": "string",
              "pattern": "^[a-f0-9]{64}$"
            },
            {
              "type": "null"
            }
          ]
        },
        "fit": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "verdict": {
                  "enum": [
                    "fits",
                    "too_large",
                    "unknown"
                  ]
                },
                "basis": {
                  "const": "file-size-estimate"
                },
                "memoryGb": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "sizeBytes": {
                  "type": "number"
                },
                "maxFileSizeBytes": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "contextTokens": {
                  "type": "number"
                },
                "runtimeVerified": {
                  "const": 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."
                }
              },
              "required": [
                "verdict",
                "basis",
                "memoryGb",
                "sizeBytes",
                "maxFileSizeBytes",
                "contextTokens",
                "runtimeVerified"
              ],
              "additionalProperties": false
            },
            {
              "type": "null"
            }
          ]
        },
        "serve": {
          "type": "object",
          "properties": {
            "verdict": {
              "enum": [
                "ready",
                "blocked",
                "checking"
              ]
            },
            "canDownload": {
              "type": "boolean"
            },
            "checkedAt": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "evidenceUrl": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "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."
            }
          },
          "required": [
            "verdict",
            "canDownload",
            "checkedAt",
            "evidenceUrl"
          ],
          "additionalProperties": false
        },
        "freshness": {
          "type": "object",
          "properties": {
            "state": {
              "enum": [
                "current",
                "stale",
                "unknown"
              ]
            },
            "checkedAt": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "ageMs": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ]
            },
            "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."
            }
          },
          "required": [
            "state",
            "checkedAt",
            "ageMs"
          ],
          "additionalProperties": false
        },
        "fallback": {
          "anyOf": [
            {
              "type": "object",
              "properties": {
                "artifactId": {
                  "type": "string"
                },
                "repo": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "path": {
                  "type": "string"
                },
                "sha256": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                },
                "sizeBytes": {
                  "type": "integer",
                  "minimum": 1000000
                },
                "downloadUrl": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "fit": {
                  "type": "object",
                  "properties": {
                    "verdict": {
                      "enum": [
                        "fits",
                        "too_large",
                        "unknown"
                      ]
                    },
                    "basis": {
                      "const": "file-size-estimate"
                    },
                    "memoryGb": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "sizeBytes": {
                      "type": "number"
                    },
                    "maxFileSizeBytes": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "contextTokens": {
                      "type": "number"
                    },
                    "runtimeVerified": {
                      "const": 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."
                    }
                  },
                  "required": [
                    "verdict",
                    "basis",
                    "memoryGb",
                    "sizeBytes",
                    "maxFileSizeBytes",
                    "contextTokens",
                    "runtimeVerified"
                  ],
                  "additionalProperties": false
                },
                "serve": {
                  "type": "object",
                  "properties": {
                    "verdict": {
                      "enum": [
                        "ready",
                        "blocked",
                        "checking"
                      ]
                    },
                    "canDownload": {
                      "type": "boolean"
                    },
                    "checkedAt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "evidenceUrl": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "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."
                    }
                  },
                  "required": [
                    "verdict",
                    "canDownload",
                    "checkedAt",
                    "evidenceUrl"
                  ],
                  "additionalProperties": false
                },
                "freshness": {
                  "type": "object",
                  "properties": {
                    "state": {
                      "enum": [
                        "current",
                        "stale",
                        "unknown"
                      ]
                    },
                    "checkedAt": {
                      "anyOf": [
                        {
                          "type": "string"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "ageMs": {
                      "anyOf": [
                        {
                          "type": "number"
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "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."
                    }
                  },
                  "required": [
                    "state",
                    "checkedAt",
                    "ageMs"
                  ],
                  "additionalProperties": false
                },
                "signature": {
                  "enum": [
                    "signed",
                    "unsigned",
                    "pending"
                  ]
                },
                "runReceipt": {
                  "anyOf": [
                    {
                      "type": "object"
                    },
                    {
                      "type": "null"
                    }
                  ]
    

# --- truncated at 32 KB (49 KB total) ---
# Full source: https://artifacts.apis.io/huggingbay-xyz/json-schema/huggingbay-xyz-sdk-find-runnable-schema.json

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-sdk-find-runnable"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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.