{"openapi":"3.1.0","info":{"title":"Agentic Systems Gateway","description":"Governed model access and an evidence-qualified evaluation registry for Ahmad Bukhari and AiXCEL Solutions agentic systems.","version":"1.0.0"},"paths":{"/api/v1/health":{"get":{"tags":["service"],"summary":"Health","operationId":"health_api_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/capabilities":{"get":{"tags":["service"],"summary":"Capabilities","operationId":"capabilities_api_v1_capabilities_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CapabilitiesResponse"}}}}}}},"/api/v1/systems":{"get":{"tags":["registry"],"summary":"List Systems","operationId":"list_systems_api_v1_systems_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SystemRecord"},"type":"array","title":"Response List Systems Api V1 Systems Get"}}}}}}},"/api/v1/systems/{system_id}":{"get":{"tags":["registry"],"summary":"Read System","operationId":"read_system_api_v1_systems__system_id__get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SystemRecord"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/evaluations":{"get":{"tags":["evaluation registry"],"summary":"List Evaluations","operationId":"list_evaluations_api_v1_evaluations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EvaluationRecord"},"type":"array","title":"Response List Evaluations Api V1 Evaluations Get"}}}}}}},"/api/v1/evaluations/{system_id}":{"get":{"tags":["evaluation registry"],"summary":"Read Evaluations","operationId":"read_evaluations_api_v1_evaluations__system_id__get","parameters":[{"name":"system_id","in":"path","required":true,"schema":{"type":"string","title":"System Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/EvaluationRecord"},"title":"Response Read Evaluations Api V1 Evaluations  System Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/inference":{"post":{"tags":["gateway"],"summary":"Inference","operationId":"inference_api_v1_inference_post","parameters":[{"name":"X-Provider-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Provider-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/InferenceResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"CapabilitiesResponse":{"properties":{"systems":{"type":"integer","title":"Systems"},"evaluation_records":{"type":"integer","title":"Evaluation Records"},"providers":{"items":{"$ref":"#/components/schemas/ProviderCapability"},"type":"array","title":"Providers"},"limits":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"string"},{"type":"boolean"}]},"type":"object","title":"Limits"},"data_policy":{"items":{"type":"string"},"type":"array","title":"Data Policy"}},"additionalProperties":false,"type":"object","required":["systems","evaluation_records","providers","limits","data_policy"],"title":"CapabilitiesResponse"},"EvaluationRecord":{"properties":{"system_id":{"type":"string","title":"System Id"},"suite":{"type":"string","title":"Suite"},"status":{"type":"string","title":"Status"},"evaluated_at":{"type":"string","format":"date-time","title":"Evaluated At"},"measures_total":{"type":"integer","minimum":1.0,"title":"Measures Total"},"measures_at_target":{"type":"integer","minimum":0.0,"title":"Measures At Target"},"score":{"type":"number","maximum":1.0,"minimum":0.0,"title":"Score"},"evidence_path":{"type":"string","title":"Evidence Path"},"notes":{"type":"string","title":"Notes"}},"additionalProperties":false,"type":"object","required":["system_id","suite","status","evaluated_at","measures_total","measures_at_target","score","evidence_path","notes"],"title":"EvaluationRecord"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"service":{"type":"string","title":"Service"},"version":{"type":"string","title":"Version"},"environment":{"type":"string","title":"Environment"}},"additionalProperties":false,"type":"object","required":["status","service","version","environment"],"title":"HealthResponse"},"InferenceMode":{"type":"string","enum":["replay","live"],"title":"InferenceMode"},"InferenceRequest":{"properties":{"system_id":{"type":"string","title":"System Id"},"task":{"$ref":"#/components/schemas/TaskName"},"mode":{"$ref":"#/components/schemas/InferenceMode","default":"replay"},"provider":{"$ref":"#/components/schemas/ProviderName","default":"replay"},"model":{"anyOf":[{"type":"string","maxLength":160},{"type":"null"}],"title":"Model"},"prompt":{"type":"string","maxLength":4000,"minLength":3,"title":"Prompt"},"scenario":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Scenario"},"max_tokens":{"type":"integer","maximum":768.0,"minimum":64.0,"title":"Max Tokens","default":512}},"additionalProperties":false,"type":"object","required":["system_id","task","prompt"],"title":"InferenceRequest"},"InferenceResponse":{"properties":{"request_id":{"type":"string","title":"Request Id"},"trace_id":{"type":"string","title":"Trace Id"},"system_id":{"type":"string","title":"System Id"},"task":{"$ref":"#/components/schemas/TaskName"},"mode":{"$ref":"#/components/schemas/InferenceMode"},"provider":{"$ref":"#/components/schemas/ProviderName"},"model":{"type":"string","title":"Model"},"key_source":{"type":"string","title":"Key Source"},"output":{"type":"string","title":"Output"},"replay_disclosure":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Replay Disclosure"},"usage":{"$ref":"#/components/schemas/UsageRecord"},"latency_ms":{"type":"integer","minimum":0.0,"title":"Latency Ms"},"receipt":{"type":"string","title":"Receipt"},"external_actions":{"type":"integer","minimum":0.0,"title":"External Actions","default":0}},"additionalProperties":false,"type":"object","required":["request_id","trace_id","system_id","task","mode","provider","model","key_source","output","usage","latency_ms","receipt"],"title":"InferenceResponse"},"ProviderCapability":{"properties":{"id":{"$ref":"#/components/schemas/ProviderName"},"label":{"type":"string","title":"Label"},"key_mode":{"type":"string","title":"Key Mode"},"default_model":{"type":"string","title":"Default Model"},"allowed_models":{"items":{"type":"string"},"type":"array","title":"Allowed Models"},"shared_available":{"type":"boolean","title":"Shared Available"},"cost_owner":{"type":"string","title":"Cost Owner"},"endpoint":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Endpoint"},"privacy_note":{"type":"string","title":"Privacy Note"},"availability_note":{"type":"string","title":"Availability Note"}},"additionalProperties":false,"type":"object","required":["id","label","key_mode","default_model","allowed_models","shared_available","cost_owner","privacy_note","availability_note"],"title":"ProviderCapability"},"ProviderName":{"type":"string","enum":["replay","nvidia_nim","openrouter"],"title":"ProviderName"},"ReleaseProof":{"properties":{"tests":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Tests"},"coverage_percent":{"anyOf":[{"type":"number","maximum":100.0,"minimum":0.0},{"type":"null"}],"title":"Coverage Percent"},"golden_scenarios":{"type":"string","title":"Golden Scenarios"},"evaluation_measures":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Evaluation Measures"},"postman_assertions":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Postman Assertions"},"durable_restart":{"type":"boolean","title":"Durable Restart","default":false},"observed_external_writes":{"type":"integer","minimum":0.0,"title":"Observed External Writes","default":0}},"additionalProperties":false,"type":"object","required":["golden_scenarios"],"title":"ReleaseProof"},"SystemRecord":{"properties":{"id":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$","title":"Id"},"name":{"type":"string","title":"Name"},"category":{"type":"string","title":"Category"},"description":{"type":"string","title":"Description"},"live_url":{"type":"string","maxLength":2083,"minLength":1,"format":"uri","title":"Live Url"},"docs_url":{"anyOf":[{"type":"string","maxLength":2083,"minLength":1,"format":"uri"},{"type":"null"}],"title":"Docs Url"},"repository_visibility":{"type":"string","title":"Repository Visibility"},"integration_status":{"type":"string","title":"Integration Status"},"graph_nodes":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Graph Nodes"},"specialist_agents":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Specialist Agents"},"release_proof":{"$ref":"#/components/schemas/ReleaseProof"},"supported_tasks":{"items":{"$ref":"#/components/schemas/TaskName"},"type":"array","title":"Supported Tasks"},"replay_scenarios":{"items":{"type":"string"},"type":"array","title":"Replay Scenarios"},"data_boundary":{"type":"string","title":"Data Boundary"},"mutation_boundary":{"type":"string","title":"Mutation Boundary"}},"additionalProperties":false,"type":"object","required":["id","name","category","description","live_url","repository_visibility","integration_status","release_proof","supported_tasks","replay_scenarios","data_boundary","mutation_boundary"],"title":"SystemRecord"},"TaskName":{"type":"string","enum":["explain_decision","critique_evidence","draft_stakeholder_summary"],"title":"TaskName"},"UsageRecord":{"properties":{"input_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Input Tokens"},"output_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Output Tokens"},"total_tokens":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Total Tokens"},"estimated_cost_usd":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Estimated Cost Usd"},"provider_reported":{"type":"boolean","title":"Provider Reported","default":false}},"additionalProperties":false,"type":"object","title":"UsageRecord"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}