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.
Python agentagent-osaiai-agentsai-partnerchatopsclaudeclaude-codecodexdevtoolsdiscord-botlark-botllmlocal-firstlong-term-memoryopencodeslack-botvibe-codingvibeywechat
{
"$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"}
}
}
}
}