{"openapi":"3.0.3","info":{"title":"haiven-orchestrator","version":"1.1.0","description":"Central orchestration service for the Haiven AI platform.\n\nDeployed runtime note:\n- current compose/runtime classifier: `gemma4-26b`\n- source fallback in `app/config.py`: `qwen3.5-27b`\n"},"servers":[{"url":"http://localhost:8500","description":"Host direct"},{"url":"https://orchestrator.haiven.site","description":"Traefik route"},{"url":"http://haiven-orchestrator:8000","description":"Docker internal"}],"paths":{"/orchestrate":{"post":{"summary":"Classify intent and dispatch to a backend","operationId":"orchestrate","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrateRequest"},"example":{"message":"What does my day look like?","input_modality":"text","output_format":"markdown"}}}},"responses":{"200":{"description":"Dispatch result or clarification response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OrchestrateResponse"},"example":{"request_id":"a3f1b2c4-5d6e-7f8a-9b0c-1d2e3f4a5b6c","intent":"briefing.daily","confidence":0.95,"response":{"content":"Here's your day for Friday...","sources":[],"actions_taken":[],"confidence":1.0,"model_used":"glm-4-7-flash","latency_ms":450},"session_id":"e7d2a1f9-3b4c-5d6e-7f8a-9b0c1d2e3f4a","clarification_needed":false,"clarification_message":null}}}}}}},"/health":{"get":{"summary":"Liveness check","operationId":"getHealth","responses":{"200":{"description":"Service is healthy","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"},"example":{"status":"ok","service":"haiven-orchestrator"}}}}}}},"/metrics":{"get":{"summary":"Prometheus metrics","operationId":"getMetrics","responses":{"200":{"description":"Metrics payload","content":{"text/plain":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"OrchestrateRequest":{"type":"object","required":["message"],"properties":{"message":{"type":"string","minLength":1},"session_id":{"type":"string","format":"uuid","nullable":true},"input_modality":{"type":"string","enum":["text","voice"],"default":"text"},"output_format":{"type":"string","enum":["markdown","plain"],"default":"markdown"},"task_id":{"type":"string","nullable":true}}},"AgentResponse":{"type":"object","properties":{"content":{"type":"string"},"sources":{"type":"array","items":{"type":"object"},"default":[]},"actions_taken":{"type":"array","items":{"type":"string"},"default":[]},"confidence":{"type":"number","format":"float"},"model_used":{"type":"string","description":"Model used by the downstream agent response, not the classifier."},"latency_ms":{"type":"number","format":"float"}}},"OrchestrateResponse":{"type":"object","required":["request_id","intent","confidence","response","session_id","clarification_needed"],"properties":{"request_id":{"type":"string","format":"uuid"},"intent":{"type":"string","enum":["briefing.daily","briefing.weekly","draft","email.compose","scheduling.query","scheduling.create","scheduling.confirm","research.topic","task.create","task.query","approve","voice_note","review_feedback","opportunity.scan","content.publish","publish","system.status","unknown"]},"confidence":{"type":"number","format":"float","description":"Confidence score from the deployed classifier model (`gemma4-26b` in current runtime)."},"response":{"$ref":"#/components/schemas/AgentResponse"},"session_id":{"type":"string","format":"uuid"},"clarification_needed":{"type":"boolean"},"clarification_message":{"type":"string","nullable":true}}},"HealthResponse":{"type":"object","required":["status","service"],"properties":{"status":{"type":"string"},"service":{"type":"string"}}}}}}