Files
kebab/docs/wire-schema/v1/schema.schema.json
th-kim0823 c25f4f89e3 📝 docs(wire-schema): schema.v1 + error.v1 JSON Schema (fb-27)
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>
2026-05-07 12:35:15 +09:00

62 lines
2.1 KiB
JSON

{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://kebab.local/wire-schema/v1/schema.schema.json",
"title": "schema.v1",
"description": "kebab introspection report — wire schemas, capabilities, model versions, and index stats.",
"type": "object",
"required": ["schema_version", "kebab_version", "wire", "capabilities", "models", "stats"],
"properties": {
"schema_version": { "const": "schema.v1" },
"kebab_version": { "type": "string" },
"wire": {
"type": "object",
"required": ["schemas"],
"properties": {
"schemas": {
"type": "array",
"items": { "type": "string", "pattern": "^[a-z_]+\\.v[0-9]+$" }
}
}
},
"capabilities": {
"type": "object",
"additionalProperties": { "type": "boolean" },
"required": [
"json_mode", "ingest_progress", "ingest_cancellation",
"rag_multi_turn", "search_cache", "incremental_ingest",
"streaming_ask", "http_daemon", "mcp_server", "single_file_ingest"
]
},
"models": {
"type": "object",
"required": [
"parser_version", "chunker_version", "embedding_version",
"prompt_template_version", "index_version", "corpus_revision"
],
"properties": {
"parser_version": { "type": "string" },
"chunker_version": { "type": "string" },
"embedding_version": { "type": "string" },
"prompt_template_version": { "type": "string" },
"index_version": { "type": "string" },
"corpus_revision": { "type": "integer", "minimum": 0 }
}
},
"stats": {
"type": "object",
"required": ["doc_count", "chunk_count", "asset_count", "last_ingest_at"],
"properties": {
"doc_count": { "type": "integer", "minimum": 0 },
"chunk_count": { "type": "integer", "minimum": 0 },
"asset_count": { "type": "integer", "minimum": 0 },
"last_ingest_at": {
"anyOf": [
{ "type": "string", "format": "date-time" },
{ "type": "null" }
]
}
}
}
}
}