{"$schema":"https://json-schema.org/draft/2020-12/schema","schema_version":"lius-llm-schemas-v1","title":"LIUS LLM Public Contract Schemas","description":"Machine-readable schemas for LIUS RAG, generation, benchmark, leaderboard, governance, and evaluation gate public contracts.","components":{"schemas":{"ErrorEnvelope":{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"}},"required":["error"],"additionalProperties":true},"RagRequest":{"type":"object","required":["q"],"properties":{"q":{"type":"string","minLength":1,"maxLength":300},"n":{"type":"integer","minimum":1,"maximum":8},"types":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"string","description":"Comma-separated LIUS node types."}]}},"additionalProperties":true},"RagHit":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"type":{"type":"string"},"slug":{"type":"string"},"url":{"type":"string","format":"uri"},"summary":{"type":"string"},"content":{"type":"string"},"score":{"type":"number"},"citation":{"type":"string"},"source_type":{"type":"string"},"source_label":{"type":"string"}},"required":["id","name","type","url"],"additionalProperties":true},"ContextBlock":{"type":"object","properties":{"ref":{"type":"string","example":"[1]"},"title":{"type":"string"},"type":{"type":"string"},"url":{"type":"string","format":"uri"},"text":{"type":"string"}},"required":["ref","title","type","url","text"],"additionalProperties":true},"RagResponse":{"type":"object","properties":{"api_version":{"type":"string","example":"llm-rag-v2"},"mode":{"type":"string","example":"node_search_trigram"},"q":{"type":"string"},"terms":{"type":"array","items":{"type":"string"}},"expanded_terms":{"type":"array","items":{"type":"string"}},"types":{"type":"array","items":{"type":"string"}},"count":{"type":"integer"},"hits":{"type":"array","items":{"$ref":"#/components/schemas/RagHit"}},"context_blocks":{"type":"array","items":{"$ref":"#/components/schemas/ContextBlock"}},"query_analysis":{"type":"object"},"suggested_queries":{"type":"array","items":{"type":"string"}},"failure_kind":{"type":"string","enum":["none","empty_query","too_short","unsupported_language","not_found","timeout","db_error"]},"not_found":{"type":"boolean"},"message":{"type":"string"},"answerability":{"type":"object"},"retrieval_policy":{"type":"object"}},"required":["api_version","mode","q","count","hits","context_blocks","failure_kind","not_found","answerability","retrieval_policy"],"additionalProperties":true},"AnswerResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"api_version":{"type":"string"},"q":{"type":"string"},"request_id":{"type":"string"},"grounded":{"type":"boolean"},"answer":{"type":"string"},"citations":{"type":"array","items":{"type":"object"}},"evidence":{"type":"array","items":{"type":"object"}},"limitations":{"type":"array","items":{"type":"string"}},"confidence":{"type":"string"},"retrieve":{"type":"object"}},"additionalProperties":true},"GenerateRequest":{"type":"object","required":["task"],"properties":{"task":{"type":"string","enum":["narrative","publishing","grant","tag"]},"topic":{"type":"string","maxLength":200},"transcript":{"type":"string","maxLength":5000}},"additionalProperties":false},"GenerateResponse":{"type":"object","properties":{"ok":{"type":"boolean"},"api_version":{"type":"string","example":"llm-generate-v2"},"task":{"type":"string"},"topic":{"type":"string"},"transcript_chars":{"type":"integer"},"request_id":{"type":"string"},"output":{"type":"string"},"provider":{"type":"string"},"hits":{"type":"array","items":{"type":"object"}},"citations":{"type":"array","items":{"type":"object"}},"context_blocks":{"type":"array","items":{"$ref":"#/components/schemas/ContextBlock"}},"retrieval_policy":{"type":"object"},"retrieve":{"type":"object"},"latency_ms":{"type":"integer"}},"additionalProperties":true},"BenchmarkQuestion":{"type":"object","properties":{"schema_version":{"type":"string"},"benchmark_version":{"type":"string"},"qid":{"type":"string"},"suite":{"type":"string"},"layer":{"type":"string"},"category":{"type":"string"},"question":{"type":"string"},"expected_answer":{"type":"string"},"answer_aliases":{"type":"array","items":{"type":"string"}},"source_refs":{"type":"array","items":{}},"rubric":{},"license":{"type":"string"}},"required":["schema_version","qid","suite","layer","question","expected_answer","license"],"additionalProperties":true},"Leaderboard":{"type":"object","properties":{"schema_version":{"type":"string"},"api_version":{"type":"string"},"status":{"type":"string"},"count_policy":{"type":"object"},"score_formula":{"type":"string"},"gates":{"type":"object"},"runs":{"type":"object"},"target_models":{"type":"array","items":{"type":"object"}}},"required":["schema_version","status","gates","runs"],"additionalProperties":true},"EvaluationGate":{"type":"object","properties":{"schema_version":{"type":"string"},"official_promotion_allowed":{"type":"boolean"},"gates":{"type":"array","items":{"type":"object"}},"unlock_sequence":{"type":"array","items":{"type":"string"}},"artifacts":{"type":"object"}},"required":["schema_version","official_promotion_allowed","gates"],"additionalProperties":true},"CitationGraph":{"type":"object","properties":{"schema_version":{"type":"string"},"version":{"type":"string"},"as_of":{"type":"string"},"counts":{"type":"object"},"citation_status_legend":{"type":"object"},"claim_nodes":{"type":"array","items":{"type":"object"}},"source_nodes":{"type":"array","items":{"type":"object"}},"edges":{"type":"array","items":{"type":"object"}}},"required":["schema_version","counts","claim_nodes","source_nodes","edges"],"additionalProperties":true},"Provenance":{"type":"object","properties":{"schema_version":{"type":"string"},"version":{"type":"string"},"canonical_home":{"type":"string","format":"uri"},"public_lineage":{"type":"array","items":{"type":"object"}},"reproducibility":{"type":"object"},"current_counts":{"type":"object"},"leaderboard_status":{"type":"object"}},"required":["schema_version","version","public_lineage","reproducibility"],"additionalProperties":true},"Changelog":{"type":"object","properties":{"schema_version":{"type":"string"},"version":{"type":"string"},"as_of":{"type":"string"},"policy":{"type":"object"},"entries":{"type":"array","items":{"type":"object"}},"errata":{"type":"array","items":{"type":"object"}}},"required":["schema_version","entries","errata"],"additionalProperties":true},"SelfHostGuide":{"type":"object","properties":{"schema_version":{"type":"string"},"version":{"type":"string"},"goal":{"type":"string"},"public_artifacts":{"type":"object"},"minimal_offline_commands":{"type":"array","items":{"type":"string"}},"local_model_runtime":{"type":"array","items":{"type":"string"}},"no_network_boundary":{"type":"object"}},"required":["schema_version","public_artifacts","minimal_offline_commands","no_network_boundary"],"additionalProperties":true},"OfflineScoreSummary":{"type":"object","properties":{"schema_version":{"type":"string"},"benchmark_run_id":{"type":"string"},"scorer":{"type":"object"},"counts":{"type":"object"},"metrics":{"type":"object"},"verification_status":{"type":"string"}},"required":["schema_version","scorer","counts","metrics","verification_status"],"additionalProperties":true},"LlmCapabilityMap":{"type":"object","properties":{"schema_version":{"type":"string"},"version":{"type":"string"},"service":{"type":"object"},"status":{"type":"object"},"counts":{"type":"object"},"capabilities":{"type":"array","items":{"type":"object"}},"artifacts":{"type":"object"}},"required":["schema_version","version","service","status","capabilities","artifacts"],"additionalProperties":true}}}}