{"openapi":"3.1.0","info":{"title":"AOPX","description":"Agent operating for procurement eXecution","version":"v0"},"paths":{"/v1/health":{"get":{"tags":["AOPX Recommend v0"],"summary":"Recommend Health","operationId":"recommend_health_v1_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/recommend":{"post":{"tags":["AOPX Recommend v0"],"summary":"Recommend","operationId":"recommend_v1_recommend_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecommendResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/outcome":{"post":{"tags":["AOPX Recommend v0"],"summary":"Outcome","operationId":"outcome_v1_outcome_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutcomeResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/outcomes":{"get":{"tags":["AOPX Recommend v0"],"summary":"Public Outcomes","operationId":"public_outcomes_v1_public_outcomes_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Limit"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/public/stats":{"get":{"tags":["AOPX Recommend v0"],"summary":"Public Stats","operationId":"public_stats_v1_public_stats_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"OutcomeRequest":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"attempts":{"items":{"$ref":"#/components/schemas/ProviderAttempt"},"type":"array","maxItems":2,"minItems":1,"title":"Attempts"}},"type":"object","required":["recommendation_id","attempts"],"title":"OutcomeRequest"},"OutcomeResponse":{"properties":{"accepted":{"type":"boolean","title":"Accepted"},"recommendation_id":{"type":"string","title":"Recommendation Id"},"source":{"type":"string","const":"PRODUCTION","title":"Source"},"final_success":{"type":"boolean","title":"Final Success"},"attempts_recorded":{"type":"integer","title":"Attempts Recorded"}},"type":"object","required":["accepted","recommendation_id","source","final_success","attempts_recorded"],"title":"OutcomeResponse"},"ProviderAttempt":{"properties":{"provider_id":{"type":"string","title":"Provider Id"},"success":{"type":"boolean","title":"Success"},"quality_score":{"anyOf":[{"type":"number","maximum":1.0,"minimum":0.0},{"type":"null"}],"title":"Quality Score"},"cost_eur":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Cost Eur"},"latency_ms":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Latency Ms"},"error_type":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Error Type"}},"type":"object","required":["provider_id","success"],"title":"ProviderAttempt"},"RecommendRequest":{"properties":{"category":{"type":"string","const":"SEARCH","title":"Category","default":"SEARCH"},"mode":{"type":"string","enum":["ECONOMY","BALANCED","CRITICAL"],"title":"Mode"},"client_id":{"anyOf":[{"type":"string","maxLength":120},{"type":"null"}],"title":"Client Id"},"max_cost_eur":{"anyOf":[{"type":"number","maximum":30.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Cost Eur"},"max_latency_ms":{"anyOf":[{"type":"integer","maximum":60000.0,"exclusiveMinimum":0.0},{"type":"null"}],"title":"Max Latency Ms"}},"type":"object","required":["mode"],"title":"RecommendRequest"},"RecommendResponse":{"properties":{"recommendation_id":{"type":"string","title":"Recommendation Id"},"source":{"type":"string","const":"PRODUCTION","title":"Source"},"category":{"type":"string","const":"SEARCH","title":"Category"},"mode":{"type":"string","enum":["ECONOMY","BALANCED","CRITICAL"],"title":"Mode"},"status":{"type":"string","enum":["OK","DISABLED"],"title":"Status"},"provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Id"},"fallback_provider_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fallback Provider Id"},"policy_version":{"type":"string","title":"Policy Version"},"evidence_run_id":{"type":"string","title":"Evidence Run Id"},"reason":{"type":"string","title":"Reason"},"experimental":{"type":"boolean","title":"Experimental"}},"type":"object","required":["recommendation_id","source","category","mode","status","provider_id","fallback_provider_id","policy_version","evidence_run_id","reason","experimental"],"title":"RecommendResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}