c25f4f89e3
schema.v1: full introspection report shape with required fields for wire / capabilities / models / stats. capabilities object enumerates all 10 flag names (current 6 true + future 4 false) as required keys. error.v1: 7-code enum + permissive details object. Real emitted details shapes documented in description (per-code context varies and some fields are interim until IoFailure / OpTimeout typed signals land in follow-up). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
36 lines
1.2 KiB
JSON
36 lines
1.2 KiB
JSON
{
|
|
"$schema": "https://json-schema.org/draft/2020-12/schema",
|
|
"$id": "https://kebab.local/wire-schema/v1/error.schema.json",
|
|
"title": "error.v1",
|
|
"description": "Structured fatal error emitted on stderr in --json mode. The `details` shape varies per `code`; consumers should branch on `code` and treat `details` as best-effort context.",
|
|
"type": "object",
|
|
"required": ["schema_version", "code", "message", "details"],
|
|
"properties": {
|
|
"schema_version": { "const": "error.v1" },
|
|
"code": {
|
|
"type": "string",
|
|
"enum": [
|
|
"config_invalid",
|
|
"not_indexed",
|
|
"model_unreachable",
|
|
"model_not_pulled",
|
|
"timeout",
|
|
"io_error",
|
|
"generic"
|
|
]
|
|
},
|
|
"message": { "type": "string" },
|
|
"details": {
|
|
"type": "object",
|
|
"additionalProperties": true,
|
|
"description": "Per-code free-form context. config_invalid: { path, cause }. not_indexed: { expected, found }. model_unreachable: { endpoint, source }. model_not_pulled: { model }. timeout: { source }. io_error: { kind }. generic: { chain (when --verbose) }."
|
|
},
|
|
"hint": {
|
|
"anyOf": [
|
|
{ "type": "string" },
|
|
{ "type": "null" }
|
|
]
|
|
}
|
|
}
|
|
}
|