Skip to content

armgit / avibe

Public Imported from GitHub
0

Make your computer a home for your AI partner. Avibe is the local-first Agent OS: Vibey, its built-in AI partner, works out of the box, and Claude Code, Codex & OpenCode run unchanged beside it — reach them from your browser, phone, or any chat app.

6.1 KB
Raw Blame
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "model-hub/backend-model.schema.json",
  "title": "BackendModel",
  "description": "One model exposed by a backend Agent. This is backend menu metadata, not upstream inventory and not a Route.",
  "definitions": {
    "OpenCodeOverlayProviderId": {
      "enum": ["avibe-openai", "avibe-anthropic"]
    }
  },
  "type": "object",
  "required": [
    "id",
    "display_name",
    "origin",
    "models_dev_id",
    "context_window",
    "max_output_tokens",
    "input_modalities",
    "output_modalities",
    "supports_tools",
    "supports_reasoning",
    "reasoning_efforts",
    "locked",
    "routeable"
  ],
  "additionalProperties": false,
  "properties": {
    "id": {
      "type": "string",
      "minLength": 1,
      "description": "The exact canonical identifier shown to and emitted by the backend Agent. OpenCode stores this bare id without an overlay provider prefix. New identifiers must be nonblank, credential-free Unicode representable as UTF-8; no model-ID length ceiling applies."
    },
    "display_name": {
      "type": ["string", "null"],
      "description": "Optional human-readable label. The backend id remains the routing identity."
    },
    "origin": {
      "enum": ["builtin", "provider", "models_dev", "manual"],
      "description": "How this row was first created. User edits remain authoritative regardless of origin."
    },
    "models_dev_id": {
      "type": ["string", "null"],
      "description": "The provider/model identity selected from models.dev, or null when no match has been selected. Filling metadata later does not change an existing row's origin."
    },
    "context_window": {
      "type": ["integer", "null"],
      "minimum": 1,
      "description": "Maximum context tokens used by the backend for context budgeting."
    },
    "max_output_tokens": {
      "type": ["integer", "null"],
      "minimum": 1,
      "description": "Maximum output tokens advertised to the backend."
    },
    "input_modalities": {
      "type": "array",
      "items": { "enum": ["text", "image", "audio", "video", "pdf"] },
      "uniqueItems": true,
      "description": "Explicitly supported input modalities. An empty array leaves native metadata in place when the backend has it and otherwise uses that backend adapter's safe default."
    },
    "output_modalities": {
      "type": "array",
      "items": { "enum": ["text", "image", "audio", "video"] },
      "uniqueItems": true,
      "description": "Explicitly supported output modalities. An empty array leaves native metadata in place when the backend has it and otherwise uses that backend adapter's safe default."
    },
    "supports_tools": {
      "type": ["boolean", "null"],
      "description": "True or false explicitly overrides tool support in the backend projection. Null omits that override and preserves the backend's own default."
    },
    "supports_reasoning": {
      "type": ["boolean", "null"],
      "description": "True or false explicitly overrides reasoning support in the backend projection. Null omits that override and preserves the backend's own default."
    },
    "reasoning_efforts": {
      "type": "array",
      "items": { "type": "string", "minLength": 1, "maxLength": 64 },
      "uniqueItems": true,
      "description": "Effort values are sent verbatim unless supports_reasoning is false. False suppresses their runtime projection without deleting the list, so returning the capability to null is lossless. An empty array means the backend omits the effort parameter."
    },
    "native_protocol": {
      "enum": ["openai_responses", "anthropic"],
      "description": "OpenCode only. The frontend protocol used by its generated provider; containing catalog arrays require it for OpenCode and forbid it for other backends."
    },
    "locked": {
      "type": "boolean",
      "description": "Server-derived. A locked system row is visible but cannot be edited, removed, or reordered."
    },
    "routeable": {
      "type": "boolean",
      "description": "Server-derived. False only for a backend-owned selector such as Claude Code Default that never names a Route key."
    },
    "effort_menu": {
      "type": "object",
      "description": "Server-derived on Agent reads, accepted and dropped on write like locked and routeable. Which of reasoning_efforts routing refuses now, in the values the menu offers (capability model §3.4): omitted when every hop the route would try or wait for has negative evidence for the token the backend sends for it, so a request there would end in effort_unsupported; not_on names the Sources of the hops that refuse a tier the others accept. Empty for an Agent in Direct mode.",
      "required": ["omitted", "not_on"],
      "additionalProperties": false,
      "properties": {
        "omitted": { "type": "array", "items": { "type": "string" }, "uniqueItems": true },
        "not_on": {
          "type": "object",
          "additionalProperties": {
            "type": "array",
            "items": { "type": "string", "pattern": "^src_[a-z0-9]{8,}$" },
            "minItems": 1,
            "uniqueItems": true
          }
        }
      }
    },
    "fast_mode": {
      "type": "boolean",
      "description": "Server-derived on Agent reads, accepted and dropped on write like effort_menu. Whether a fast turn on this model asks for its vendor's fast tier on the hop that normally serves it (docs/plans/fast-mode.md): that hop's Source is a Hub API key or subscription speaking the model's first-party vendor's protocol, and the vendor's models.dev entry names the tier's request field. False for an Agent in Direct mode and for OpenCode, whose requests name no turn."
    },
    "fast_mode_confirmed": {
      "type": ["boolean", "null"],
      "description": "Server-derived on Agent reads, accepted and dropped on write like effort_menu. What the last fast response on that hop reported since the service started: true when it named the vendor's fast tier, false when it named another tier or none (as a relay that drops the field answers), null when no fast request has been served there, or when fast_mode is false."
    }
  }
}