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.

35.3 KB
Raw Blame
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "model-hub/api-response.schema.json",
  "title": "Model Hub API response registry",
  "description": "Machine-readable response contracts and real-response exercises for every route in api.md. The conformance guard requires exact route-table parity; entries may not be omitted or left without an exercise.",
  "type": "object",
  "x-model-hub-routes": [
    {"method": "GET", "path": "/api/models/sources", "response_schema": "SourceListResponse", "exercise": {"path": "/api/models/sources", "status": 200}},
    {"method": "POST", "path": "/api/models/sources/observe", "response_schema": "ObservationResponse", "exercise": {"path": "/api/models/sources/observe", "status": 200, "json": {"vendor": "anthropic", "key": "sk-contract-test", "protocol": "anthropic"}}},
    {"method": "POST", "path": "/api/models/sources", "response_schema": "SourceCreateResponse", "exercise": {"path": "/api/models/sources", "status": 201, "json": {"kind": "api_key", "vendor": "anthropic", "display_name": "Contract source", "key": "sk-contract-test", "protocol": "anthropic"}}},
    {"method": "PATCH", "path": "/api/models/sources/<id>", "response_schema": "SourceMutationResponse", "exercise": {"path": "/api/models/sources/src_conform001", "status": 200, "json": {"display_name": "Renamed contract source"}}},
    {"method": "PUT", "path": "/api/models/sources/<id>/credential", "response_schema": "SourceMutationResponse", "exercise": {"path": "/api/models/sources/src_conform001/credential", "status": 200, "json": {"key": "sk-replacement-contract-test"}}},
    {"method": "POST", "path": "/api/models/sources/<id>/reauth", "response_schema": "OAuthFlowResponse", "exercise": {"path": "/api/models/sources/src_subscribe01/reauth", "status": 200, "json": {"acknowledge_irreversible": true}}},
    {"method": "DELETE", "path": "/api/models/sources/<id>?force=<bool>", "response_schema": "SourceDeleteResponse", "exercise": {"path": "/api/models/sources/src_delete0001?force=false", "status": 200, "json": {}}},
    {"method": "POST", "path": "/api/models/sources/<id>/refresh", "response_schema": "SourceMutationResponse", "exercise": {"path": "/api/models/sources/src_conform001/refresh", "status": 200, "json": {}}},
    {"method": "POST", "path": "/api/models/sources/<id>/reenable", "response_schema": "SourceReenableResponse", "exercise": {"path": "/api/models/sources/src_searchbalance/reenable", "status": 200, "json": {}}},
    {"method": "POST", "path": "/api/models/sources/<id>/probe", "response_schema": "SourceProbeResponse", "exercise": {"path": "/api/models/sources/src_conform001/probe", "status": 200, "json": {"model": "claude-opus-4-6"}}},
    {"method": "POST", "path": "/api/models/sources/<source_id>/models", "response_schema": "SourceResponse", "exercise": {"path": "/api/models/sources/src_conform001/models", "status": 201, "json": {"model_id": "manual-contract-model", "reasoning_efforts": []}}},
    {"method": "PATCH", "path": "/api/models/sources/<source_id>/models/<model_id>", "response_schema": "SourceResponse", "exercise": {"path": "/api/models/sources/src_conform001/models/retire-model", "status": 200, "json": {"reasoning_efforts": ["high"]}}},
    {"method": "DELETE", "path": "/api/models/sources/<source_id>/models/<model_id>", "response_schema": "SourceMutationResponse", "exercise": {"path": "/api/models/sources/src_conform001/models/retire-model", "status": 200, "json": {}}},
    {"method": "GET", "path": "/api/models/agents", "response_schema": "AgentListResponse", "exercise": {"path": "/api/models/agents", "status": 200}},
    {"method": "GET", "path": "/api/models/agents/<backend>/sources", "response_schema": "AgentResponse", "exercise": {"path": "/api/models/agents/claude/sources", "status": 200}},
    {"method": "PUT", "path": "/api/models/agents/<backend>/sources", "response_schema": "AgentResponse", "exercise": {"path": "/api/models/agents/claude/sources", "status": 200, "json": {"order": ["src_conform001"]}}},
    {"method": "POST", "path": "/api/models/agents/<backend>/chains/reorder", "response_schema": "AgentResponse", "exercise": {"path": "/api/models/agents/claude/chains/reorder", "status": 200}},
    {"method": "PATCH", "path": "/api/models/agents/<backend>/mode", "response_schema": "AgentResponse", "exercise": {"path": "/api/models/agents/claude/mode", "status": 200, "json": {"mode": "hub"}}},
    {"method": "GET", "path": "/api/models/agents/<backend>/models", "response_schema": "AgentCatalogResponse", "exercise": {"path": "/api/models/agents/claude/models", "status": 200}},
    {"method": "GET", "path": "/api/models/agents/<backend>/models/candidates", "response_schema": "AgentModelCandidatesResponse", "exercise": {"path": "/api/models/agents/claude/models/candidates", "status": 200}},
    {"method":"PUT","path":"/api/models/agents/<backend>/models","response_schema":"AgentModelsResponse","exercises":[{"path":"/api/models/agents/claude/models","status":200,"json":{"baseline":[],"models":[]}},{"path":"/api/models/agents/claude/models","status":409,"setup":"backend_model_guard"},{"path":"/api/models/agents/claude/models","status":200,"setup":"backend_model_forced_removal"},{"path":"/api/models/agents/claude/models","status":409,"setup":"candidate_suppliers_guard"}]},
    {"method": "GET", "path": "/api/models/catalog/models-dev?query=<text>", "response_schema": "ModelsDevResponse", "exercise": {"path": "/api/models/catalog/models-dev?query=contract-model", "status": 200}},
    {"method": "GET", "path": "/api/models/agents/<backend>/chains", "response_schema": "ChainListResponse", "exercise": {"path": "/api/models/agents/claude/chains", "status": 200}},
    {"method": "GET", "path": "/api/models/agents/<backend>/chain?model=<id>", "response_schema": "ChainResponse", "exercise": {"path": "/api/models/agents/claude/chain?model=claude-opus-4-6", "status": 200}},
    {"method": "PUT", "path": "/api/models/agents/<backend>/chain?model=<id>", "response_schema": "ChainMutationResponse", "exercises": [{"path": "/api/models/agents/claude/chain?model=claude-opus-4-6", "status": 200, "json": {"hops": [{"source_id": "src_conform001", "model_id": "claude-opus-4-6"}]}}, {"path": "/api/models/agents/claude/chain?model=claude-opus-4-6", "status": 200, "json": {"hops": []}}]},
    {"method": "DELETE", "path": "/api/models/agents/<backend>/chain?model=<id>", "response_schema": "ChainMutationResponse", "exercise": {"path": "/api/models/agents/claude/chain?model=claude-opus-4-6", "status": 200, "json": {}}},
    {"method": "POST", "path": "/api/models/agents/<backend>/chain/preview?model=<id>", "response_schema": "ChainResponse", "exercises": [{"path": "/api/models/agents/claude/chain/preview?model=claude-opus-4-6", "status": 200, "json": {"manual_override": null}}, {"path": "/api/models/agents/claude/chain/preview?model=claude-opus-4-6", "status": 200, "json": {"manual_override": {"hops": []}}}]},
    {"method": "POST", "path": "/api/models/agents/<backend>/probe", "response_schema": "ProbeResponse", "exercise": {"path": "/api/models/agents/claude/probe", "status": 200, "json": {"model": "claude-opus-4-6"}}},
    {"method": "GET", "path": "/api/models/agents/<backend>/provenance?model=<id>", "response_schema": "LatestProvenanceResponse", "exercises": [{"path": "/api/models/agents/claude/provenance?model=claude-opus-4-6", "status": 200}, {"path": "/api/models/agents/claude/provenance?model=claude-sonnet-4-6", "status": 200}]},
    {"method": "GET", "path": "/api/models/events?limit=<n>&before=<id>", "response_schema": "EventsResponse", "exercise": {"path": "/api/models/events?limit=20", "status": 200}},
    {"method": "GET", "path": "/api/models/usage?days=<n>", "response_schema": "UsageResponse", "exercises": [{"path": "/api/models/usage?days=30", "status": 200}, {"path": "/api/models/usage?window=24h", "status": 200}]},
    {"method": "GET", "path": "/api/models/quota", "response_schema": "QuotaResponse", "exercise": {"path": "/api/models/quota", "status": 200}},
    {"method": "POST", "path": "/api/models/quota/refresh", "response_schema": "QuotaResponse", "exercise": {"path": "/api/models/quota/refresh", "status": 200}},
    {"method": "GET", "path": "/api/models/hosted-tools", "response_schema": "HostedToolsResponse", "exercise": {"path": "/api/models/hosted-tools", "status": 200}},
    {"method": "PUT", "path": "/api/models/hosted-tools/<tool>", "response_schema": "HostedToolsResponse", "exercise": {"path": "/api/models/hosted-tools/web_search", "status": 200, "json": {"enabled": true, "executor_order": null}}},
    {"method": "POST", "path": "/api/models/hosted-tools/<tool>/clear", "response_schema": "HostedToolsResponse", "exercise": {"path": "/api/models/hosted-tools/web_search/clear", "status": 200, "json": {"source_id": "src_conform001"}}},
    {"method": "POST", "path": "/api/models/hosted-tools/web_fetch/services/<source_id>/retry", "response_schema": "EmptyResponse", "exercise": {"path": "/api/models/hosted-tools/web_fetch/services/src_jinakeyless/retry", "status": 200, "json": {}}},
    {"method": "POST", "path": "/api/models/hosted-tools/web_search/services/<source_id>/retry", "response_schema": "EmptyResponse", "exercise": {"path": "/api/models/hosted-tools/web_search/services/src_searchbalance/retry", "status": 200, "json": {}}},
    {"method": "POST", "path": "/api/models/sources/<source_id>/evidence/clear", "response_schema": "SourceResponse", "exercise": {"path": "/api/models/sources/src_conform001/evidence/clear", "status": 200, "json": {"model_id": "claude-opus-4-6", "feature": {"kind": "effort", "name": "max"}}}},
    {"method": "POST", "path": "/api/models/oauth/start", "response_schema": "OAuthFlowResponse", "exercise": {"path": "/api/models/oauth/start", "status": 200, "json": {"vendor": "anthropic", "channel": "hub"}}},
    {"method": "GET", "path": "/api/models/oauth/status/<flow_id>", "response_schema": "OAuthResultResponse", "exercise": {"path": "/api/models/oauth/status/oaf_00000001", "status": 200}},
    {"method": "POST", "path": "/api/models/oauth/submit", "response_schema": "OAuthResultResponse", "exercise": {"path": "/api/models/oauth/submit", "status": 200, "json": {"flow_id": "oaf_00000001", "value": "contract-code"}}},
    {"method": "POST", "path": "/api/models/oauth/cancel", "response_schema": "EmptyResponse", "exercise": {"path": "/api/models/oauth/cancel", "status": 200, "json": {"flow_id": "oaf_00000001"}}},
    {"method": "POST", "path": "/api/models/migration/scan", "response_schema": "MigrationScanResponse", "exercise": {"path": "/api/models/migration/scan", "status": 200}},
    {"method": "POST", "path": "/api/models/migration/apply", "response_schema": "MigrationApplyResponse", "exercise": {"path": "/api/models/migration/apply", "status": 200, "json": {"item_ids": []}}},
    {"method": "GET", "path": "/api/models/turns/<turn_id>/provenance", "response_schema": "ProvenanceResponse", "exercise": {"path": "/api/models/turns/turn_contract01/provenance", "status": 200}},
    {"method": "GET", "path": "/api/models/runtime/status", "response_schema": "RuntimeResponse", "exercise": {"path": "/api/models/runtime/status", "status": 200}},
    {"method": "POST", "path": "/api/models/runtime/install", "response_schema": "RuntimeResponse", "exercise": {"path": "/api/models/runtime/install", "status": 200}},
    {"method": "POST", "path": "/api/models/runtime/start", "response_schema": "RuntimeResponse", "exercise": {"path": "/api/models/runtime/start", "status": 200}},
    {"method": "POST", "path": "/api/models/runtime/stop", "response_schema": "RuntimeResponse", "exercise": {"path": "/api/models/runtime/stop", "status": 200}}
  ],
  "definitions": {
    "SourceProbeResponse": {
      "type": "object",
      "additionalProperties": false,
      "required": ["ok", "contract_version", "probe"],
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "probe": {"$ref": "model-hub/source-probe-result.schema.json"}
      }
    },
    "SourceApi": {
      "allOf": [
        {"$ref": "model-hub/source.schema.json"},
        {
          "required": ["adopted_by"],
          "properties": {
            "models": {
              "items": {"required": ["retired"]}
            }
          }
        }
      ]
    },
    "AgentSupplyApi": {
      "allOf": [
        {"$ref": "model-hub/agent-supply.schema.json"},
        {
          "required": ["backend", "cli_present", "mode", "menu_kind", "catalog_models", "selected_by_agent", "selected_model_id", "selected_model_explicit", "sources", "routes", "supply_status", "menu", "model_supply", "named_agents", "builtin_models"],
          "properties": {
            "sources": {
              "oneOf": [
                {"type": "null"},
                {
                  "type": "object",
                  "required": ["order", "eligibility"],
                  "properties": {
                    "eligibility": {
                      "type": "array",
                      "items": {
                        "required": ["source_id", "eligible", "reason_key", "in_current_model_chain", "process_availability_reason"]
                      }
                    }
                  }
                }
              ]
            },
            "model_supply": {
              "oneOf": [
                {"type": "null"},
                {
                  "type": "array",
                  "items": {"required": ["model_id", "chain_length", "has_runnable_hop", "route_origin"]}
                }
              ]
            }
          }
        }
      ]
    },
    "AddedTo": {
      "type": "object",
      "required": ["backend", "menu_model", "source_id", "model_id", "position"],
      "additionalProperties": false,
      "properties": {
        "backend": {"enum": ["claude", "codex", "opencode", "vibey"]},
        "menu_model": {"type": "string", "minLength": 1},
        "source_id": {"type": "string", "pattern": "^src_[a-z0-9]{8,}$"},
        "model_id": {"type": "string", "minLength": 1},
        "position": {"type": "integer", "minimum": 1}
      }
    },
    "AdoptedBy": {
      "type": "object",
      "required": ["backend", "menu_model"],
      "additionalProperties": false,
      "properties": {
        "backend": {"enum": ["claude", "codex", "opencode", "vibey"]},
        "menu_model": {"type": "string", "minLength": 1}
      }
    },
    "RouteHopRef": {
      "type": "object",
      "required": ["backend", "menu_model", "source_id", "model_id", "position"],
      "additionalProperties": false,
      "properties": {
        "backend": {"enum": ["claude", "codex", "opencode", "vibey"]},
        "menu_model": {"type": "string", "minLength": 1},
        "source_id": {"type": "string", "pattern": "^src_[a-z0-9]{8,}$"},
        "model_id": {"type": "string", "minLength": 1},
        "position": {"type": "integer", "minimum": 1}
      }
    },
    "SupplyGap": {
      "type": "object",
      "required": ["backend", "model_id", "agents"],
      "additionalProperties": false,
      "properties": {
        "backend": {"enum": ["claude", "codex", "opencode", "vibey"]},
        "model_id": {"type": "string", "minLength": 1},
        "agents": {"type": "array", "items": {"type": "string", "minLength": 1}, "uniqueItems": true}
      }
    },
    "SuccessCore": {
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23}
      }
    },
    "SourceListResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "sources"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "sources": {"type": "array", "items": {"$ref": "#/definitions/SourceApi"}}
      }
    },
    "ObservationResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "observation"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "observation": {"$ref": "model-hub/observation-result.schema.json"}
      }
    },
    "SourceCreateResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "source", "added_to", "adopted_by"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "source": {"$ref": "#/definitions/SourceApi"},
        "added_to": {"type": "array", "items": {"$ref": "#/definitions/AddedTo"}},
        "adopted_by": {"type": "array", "items": {"$ref": "#/definitions/AdoptedBy"}, "uniqueItems": true}
      }
    },
    "SourceResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "source"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "source": {"$ref": "#/definitions/SourceApi"}
      }
    },
    "SourceMutationResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "source", "removed_hops", "interrupted"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "source": {"$ref": "#/definitions/SourceApi"},
        "removed_hops": {"type": "array", "items": {"$ref": "#/definitions/RouteHopRef"}},
        "interrupted": {"type": "array", "items": {"$ref": "#/definitions/SupplyGap"}}
      }
    },
    "SourceReenableResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "source", "removed_hops", "interrupted"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "source": {
          "allOf": [
            {"$ref": "#/definitions/SourceApi"},
            {"properties": {"protocol": {"const": "search"}}}
          ]
        },
        "removed_hops": {"type": "array", "maxItems": 0},
        "interrupted": {"type": "array", "maxItems": 0},
        "trial_armed": {"type": "boolean"}
      }
    },
    "SourceDeleteResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "removed_hops", "interrupted"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "removed_hops": {"type": "array", "items": {"$ref": "#/definitions/RouteHopRef"}},
        "interrupted": {"type": "array", "items": {"$ref": "#/definitions/SupplyGap"}}
      }
    },
    "AgentListResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "agents"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "agents": {"type": "array", "items": {"$ref": "#/definitions/AgentSupplyApi"}}
      }
    },
    "AgentResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "agent"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "agent": {"$ref": "#/definitions/AgentSupplyApi"}
      }
    },
    "AgentModelsResponse": {
      "oneOf": [
        {"$ref": "#/definitions/AgentResponse"},
        {
          "type": "object",
          "required": ["ok", "contract_version", "agent", "removed_hops", "interrupted"],
          "additionalProperties": false,
          "anyOf": [
            {"properties": {"removed_hops": {"minItems": 1}}},
            {"properties": {"interrupted": {"minItems": 1}}}
          ],
          "properties": {
            "ok": {"const": true},
            "contract_version": {"const": 23},
            "agent": {"$ref": "#/definitions/AgentSupplyApi"},
            "removed_hops": {"type": "array", "items": {"$ref": "#/definitions/RouteHopRef"}, "uniqueItems": true},
            "interrupted": {"type": "array", "items": {"$ref": "#/definitions/SupplyGap"}, "uniqueItems": true}
          }
        },
        {"$ref": "model-hub/guard-refusal.schema.json"},
        {"$ref": "#/definitions/CandidateSuppliersChangedResponse"}
      ]
    },
    "ExpectedSupplier": {
      "type": "object",
      "required": ["source_id", "model_id"],
      "additionalProperties": false,
      "properties": {
        "source_id": {"type": "string", "pattern": "^src_[a-z0-9]{8,}$"},
        "model_id": {"type": "string", "minLength": 1}
      }
    },
    "CandidateSuppliersChangedResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "error", "detail", "changed"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": false},
        "contract_version": {"const": 23},
        "error": {"const": "candidate_suppliers_changed"},
        "detail": {"type": "string", "minLength": 1},
        "changed": {
          "type": "object",
          "minProperties": 1,
          "additionalProperties": {
            "type": "array",
            "items": {"$ref": "#/definitions/ExpectedSupplier"},
            "uniqueItems": true
          }
        }
      }
    },
    "AgentCatalogResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "agent"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "agent": {
          "type": "object",
          "required": ["backend", "mode", "catalog_models"],
          "additionalProperties": false,
          "allOf": [
            {
              "if": { "properties": { "backend": { "const": "vibey" } }, "required": ["backend"] },
              "then": { "properties": { "mode": { "const": "hub" } } }
            },
            {
              "if": { "properties": { "backend": { "const": "opencode" } }, "required": ["backend"] },
              "then": {
                "properties": {
                  "catalog_models": {
                    "items": {
                      "allOf": [
                        { "$ref": "model-hub/backend-model.schema.json" },
                        { "required": ["native_protocol"] }
                      ]
                    }
                  }
                }
              },
              "else": {
                "properties": {
                  "catalog_models": {
                    "items": {
                      "allOf": [
                        { "$ref": "model-hub/backend-model.schema.json" },
                        { "not": { "required": ["native_protocol"] } }
                      ]
                    }
                  }
                }
              }
            }
          ],
          "properties": {
            "backend": {"enum": ["claude", "codex", "opencode", "vibey"]},
            "mode": {"enum": ["hub", "direct"]},
            "catalog_models": {
              "type": "array",
              "items": {"$ref": "model-hub/backend-model.schema.json"}
            }
          }
        }
      }
    },
    "CandidateSupplier": {
      "type": "object",
      "required": ["source_id", "source_name", "model_id"],
      "additionalProperties": false,
      "properties": {
        "source_id": {"type": "string", "pattern": "^src_[a-z0-9]{8,}$"},
        "source_name": {"type": "string", "minLength": 1},
        "model_id": {"type": "string", "minLength": 1}
      }
    },
    "ModelCandidate": {
      "type": "object",
      "required": ["id", "display_name", "reasoning_efforts", "suppliers", "origin"],
      "additionalProperties": false,
      "properties": {
        "id": {"type": "string", "minLength": 1},
        "display_name": {"type": ["string", "null"]},
        "reasoning_efforts": {"type": "array", "items": {"type": "string", "minLength": 1, "maxLength": 64}, "uniqueItems": true},
        "suppliers": {"type": "array", "items": {"$ref": "#/definitions/CandidateSupplier"}, "uniqueItems": true},
        "origin": {"enum": ["builtin", "provider", "models_dev", "manual"]},
        "models_dev_id": {"type": "string", "minLength": 3},
        "context_window": {"type": ["integer", "null"], "minimum": 1},
        "max_output_tokens": {"type": ["integer", "null"], "minimum": 1},
        "input_modalities": {"type": "array", "items": {"enum": ["text", "image", "audio", "video", "pdf"]}, "uniqueItems": true},
        "output_modalities": {"type": "array", "items": {"enum": ["text", "image", "audio", "video"]}, "uniqueItems": true},
        "supports_tools": {"type": ["boolean", "null"]},
        "supports_reasoning": {"type": ["boolean", "null"]},
        "native_protocol": {"enum": ["openai_responses", "anthropic"]},
        "group_if_removed": {"anyOf": [{"enum": ["builtin", "providers"]}, {"type": "null"}]}
      },
      "dependencies": {
        "models_dev_id": ["context_window", "max_output_tokens", "input_modalities", "output_modalities", "supports_tools", "supports_reasoning"],
        "context_window": ["models_dev_id"],
        "max_output_tokens": ["models_dev_id"],
        "input_modalities": ["models_dev_id"],
        "output_modalities": ["models_dev_id"],
        "supports_tools": ["models_dev_id"],
        "supports_reasoning": ["models_dev_id"]
      }
    },
    "AddableModelCandidate": {
      "allOf": [
        {"$ref": "#/definitions/ModelCandidate"},
        {"not": {"required": ["group_if_removed"]}}
      ]
    },
    "AgentModelCandidatesResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "candidates"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "candidates": {
          "type": "object",
          "required": ["builtin", "providers", "in_list"],
          "additionalProperties": false,
          "properties": {
            "builtin": {"type": "array", "items": {"$ref": "#/definitions/AddableModelCandidate"}},
            "providers": {"type": "array", "items": {"$ref": "#/definitions/AddableModelCandidate"}},
            "in_list": {"type": "array", "items": {"$ref": "#/definitions/ModelCandidate"}}
          }
        }
      }
    },
    "ModelsDevResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "matches"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "matches": {
          "type": "array",
          "maxItems": 8,
          "items": {
            "type": "object",
            "required": ["provider_id", "provider_name", "first_party", "model_id", "models_dev_id", "display_name", "context_window", "max_output_tokens", "input_modalities", "output_modalities", "supports_tools", "supports_reasoning", "reasoning_efforts", "native_protocol"],
            "additionalProperties": false,
            "properties": {
              "provider_id": {"type": "string", "minLength": 1},
              "provider_name": {"type": "string", "minLength": 1},
              "first_party": {"type": "boolean"},
              "model_id": {"type": "string", "minLength": 1},
              "models_dev_id": {"type": "string", "minLength": 3},
              "display_name": {"type": "string", "minLength": 1},
              "context_window": {"type": ["integer", "null"], "minimum": 1},
              "max_output_tokens": {"type": ["integer", "null"], "minimum": 1},
              "input_modalities": {"type": "array", "items": {"enum": ["text", "image", "audio", "video", "pdf"]}, "uniqueItems": true},
              "output_modalities": {"type": "array", "items": {"enum": ["text", "image", "audio", "video"]}, "uniqueItems": true},
              "supports_tools": {"type": ["boolean", "null"]},
              "supports_reasoning": {"type": ["boolean", "null"]},
              "reasoning_efforts": {"type": "array", "items": {"type": "string", "minLength": 1, "maxLength": 64}, "uniqueItems": true},
              "native_protocol": {"enum": ["openai_responses", "anthropic"]}
            }
          }
        }
      }
    },
    "ChainResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "chain"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "chain": {"$ref": "model-hub/agent-chain.schema.json"}
      }
    },
    "ChainListResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "chains"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "chains": {"type": "array", "items": {"$ref": "model-hub/agent-chain.schema.json"}}
      }
    },
    "ChainMutationResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "chain", "removed_hops", "interrupted"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "chain": {"$ref": "model-hub/agent-chain.schema.json"},
        "removed_hops": {"type": "array", "items": {"$ref": "#/definitions/RouteHopRef"}},
        "interrupted": {"type": "array", "items": {"$ref": "#/definitions/SupplyGap"}}
      }
    },
    "ProbeResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "probe"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "probe": {"$ref": "model-hub/probe-result.schema.json"}
      }
    },
    "EventsResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "events"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "events": {"type": "array", "items": {"$ref": "model-hub/resolution-event.schema.json"}}
      }
    },
    "UsageResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "usage"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "usage": {"$ref": "model-hub/usage-summary.schema.json"}
      }
    },
    "QuotaResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "quota"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "quota": {"$ref": "model-hub/quota-summary.schema.json"}
      }
    },
    "HostedToolsResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "hosted_tools"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "hosted_tools": {"$ref": "model-hub/hosted-tools-status.schema.json"}
      }
    },
    "OAuthFlowResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "flow"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "flow": {
          "allOf": [
            {"$ref": "model-hub/oauth-flow.schema.json"},
            {
              "properties": {
                "state": {"enum": ["starting", "awaiting_action", "verifying", "failed", "cancelled"]}
              }
            }
          ]
        }
      }
    },
    "OAuthResultResponse": {
      "oneOf": [
        {"$ref": "#/definitions/OAuthFlowResponse"},
        {
          "type": "object",
          "required": ["ok", "contract_version", "flow", "source", "added_to", "adopted_by"],
          "additionalProperties": false,
          "properties": {
            "ok": {"const": true},
            "contract_version": {"const": 23},
            "flow": {
              "allOf": [
                {"$ref": "model-hub/oauth-flow.schema.json"},
                {
                  "properties": {
                    "state": {"const": "success"},
                    "intent": {"const": "create"}
                  }
                }
              ]
            },
            "source": {"$ref": "#/definitions/SourceApi"},
            "added_to": {"type": "array", "items": {"$ref": "#/definitions/AddedTo"}},
            "adopted_by": {"type": "array", "items": {"$ref": "#/definitions/AdoptedBy"}, "uniqueItems": true}
          }
        },
        {
          "type": "object",
          "required": ["ok", "contract_version", "flow", "source", "recovered", "interrupted_pairs"],
          "additionalProperties": false,
          "properties": {
            "ok": {"const": true},
            "contract_version": {"const": 23},
            "flow": {
              "allOf": [
                {"$ref": "model-hub/oauth-flow.schema.json"},
                {
                  "properties": {
                    "state": {"const": "success"},
                    "intent": {"const": "reauth"}
                  }
                }
              ]
            },
            "source": {"$ref": "#/definitions/SourceApi"},
            "recovered": {"type": "boolean"},
            "interrupted_pairs": {"type": "array", "items": {"$ref": "#/definitions/SupplyGap"}}
          }
        }
      ]
    },
    "EmptyResponse": {
      "type": "object",
      "required": ["ok", "contract_version"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23}
      }
    },
    "RuntimeApi": {
      "allOf": [
        {"$ref": "model-hub/runtime-dependency.schema.json"},
        {
          "required": ["contract_version", "enabled", "host_platform", "manifest", "status"],
          "properties": {
            "status": {
              "required": ["installed_version", "verified", "listening", "health", "last_check", "error_key"]
            }
          }
        }
      ]
    },
    "MigrationScanResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "scan"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "scan": {"$ref": "model-hub/migration-scan.schema.json"}
      }
    },
    "MigrationApplyResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "applied", "sources", "added_to"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "applied": {"type": "integer", "minimum": 0},
        "sources": {"type": "array", "items": {"$ref": "#/definitions/SourceApi"}},
        "added_to": {"type": "array", "items": {"$ref": "#/definitions/AddedTo"}}
      }
    },
    "ProvenanceResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "provenance"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "provenance": {"$ref": "model-hub/turn-provenance.schema.json"}
      }
    },
    "LatestProvenanceResponse": {
      "description": "On-demand latest persisted retained turn for the exact backend and requested catalog model, regardless of outcome. Null means no retained match. The existing turn-id response remains non-nullable.",
      "type": "object",
      "required": ["ok", "contract_version", "provenance"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "provenance": {
          "anyOf": [
            {"$ref": "model-hub/turn-provenance.schema.json"},
            {"type": "null"}
          ]
        }
      }
    },
    "RuntimeResponse": {
      "type": "object",
      "required": ["ok", "contract_version", "runtime"],
      "additionalProperties": false,
      "properties": {
        "ok": {"const": true},
        "contract_version": {"const": 23},
        "runtime": {"$ref": "#/definitions/RuntimeApi"}
      }
    }
  }
}