{"openapi":"3.0.3","info":{"title":"ROOTE AI","version":"0.1.0"},"paths":{"/health":{"get":{"responses":{"200":{"description":"Healthy"}}}},"/v1/query":{"get":{"summary":"Browser friendly query shortcut","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":2000}},{"name":"lat","in":"query","required":false,"schema":{"type":"number","minimum":-90,"maximum":90}},{"name":"lon","in":"query","required":false,"schema":{"type":"number","minimum":-180,"maximum":180}},{"name":"locale","in":"query","required":false,"schema":{"type":"string","maxLength":16}},{"name":"conversation_id","in":"query","required":false,"schema":{"type":"string","pattern":"^conv_[A-Za-z0-9_-]{8,128}$"}}],"responses":{"200":{"description":"Same response contract as POST"},"400":{"description":"Invalid query"}}},"post":{"summary":"Recommended integration endpoint","requestBody":{"required":true,"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["message"],"properties":{"message":{"type":"string","minLength":1,"maxLength":2000},"conversation_id":{"type":"string","pattern":"^conv_[A-Za-z0-9_-]{8,128}$"},"locale":{"type":"string","maxLength":16},"context":{"type":"object","description":"Canonical Map Context Snapshot. Legacy flat context fields remain accepted during migration.","properties":{"conversation_state":{"type":"object","properties":{"conversation_summary":{"type":"string","nullable":true,"maxLength":2000},"modes":{"type":"array","items":{"type":"string"}},"search_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}}}},"map_state":{"type":"object","properties":{"user_location":{"type":"object","additionalProperties":false,"required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180}}},"map_center":{"type":"object","additionalProperties":false,"required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180}}},"viewport":{"type":"object","required":["north","south","east","west"],"properties":{"north":{"type":"number"},"south":{"type":"number"},"east":{"type":"number"},"west":{"type":"number"},"zoom":{"type":"number","minimum":0,"maximum":22}}},"active_layers":{"type":"array","items":{"type":"string"}},"query_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}},"search_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}},"display_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}}}},"dataset_state":{"type":"object","properties":{"current_dataset":{"nullable":true,"type":"object","required":["id","version","scope","entities","provenance","freshness","received_at"],"properties":{"id":{"type":"string"},"version":{"type":"string"},"scope":{"type":"string"},"entities":{"type":"array","maxItems":100,"items":{"type":"object"}},"provenance":{"type":"array","items":{"type":"string"}},"freshness":{"enum":["live","fresh","stale","unknown"]},"received_at":{"type":"string","format":"date-time"}}}}},"selection_state":{"type":"object","properties":{"selected_entity_id":{"type":"string","nullable":true}}},"execution_state":{"type":"object","properties":{"last_successful_request":{"nullable":true,"type":"object","required":["capability","args"],"properties":{"capability":{"enum":["search_mobility","place_search","geocode","reverse_geocode"]},"args":{"type":"object"}}},"last_capabilities_used":{"type":"array","items":{"type":"string"}}}}}},"command":{"type":"object","additionalProperties":false,"required":["intent","modes","operation","location_reference"],"properties":{"intent":{"enum":["nearby_search"]},"modes":{"type":"array","minItems":1,"maxItems":4,"uniqueItems":true,"items":{"enum":["bicycle","scooter","moped","car"]}},"operation":{"enum":["replace_modes"]},"location_reference":{"enum":["inherit"]}}}}},{"type":"object","additionalProperties":false,"required":["contract_version","correlation","input","context_snapshot"],"properties":{"contract_version":{"const":"1.0.0"},"correlation":{"type":"object","additionalProperties":false,"required":["conversation_id","interaction_id","request_id","parent_request_id","turn_id"],"properties":{"conversation_id":{"type":"string"},"interaction_id":{"type":"string"},"request_id":{"type":"string","nullable":true},"parent_request_id":{"type":"string","nullable":true},"turn_id":{"type":"string","nullable":true}}},"input":{"type":"object","additionalProperties":false,"required":["message","command"],"properties":{"message":{"type":"string","nullable":true,"maxLength":2000},"command":{"type":"object","nullable":true}}},"context_snapshot":{"type":"object","additionalProperties":false,"required":["contract_version","revision","conversation_state","map_state","dataset_state","selection_state","execution_state"],"properties":{"contract_version":{"const":"1.0.0"},"revision":{"type":"integer","minimum":0},"conversation_state":{"type":"object"},"map_state":{"type":"object"},"dataset_state":{"type":"object"},"selection_state":{"type":"object"},"execution_state":{"type":"object"}}}}}]}}}},"responses":{"200":{"description":"Legacy QueryResponse or Contract 1.0.0 TurnResult"},"400":{"description":"Invalid input"},"429":{"description":"Rate limited"}}}},"/v1/query/stream":{"post":{"summary":"Progress stream followed by the unchanged final query response","description":"SSE events are transport metadata and are separate from the final response contract.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","minLength":1,"maxLength":2000},"conversation_id":{"type":"string","pattern":"^conv_[A-Za-z0-9_-]{8,128}$"},"locale":{"type":"string","maxLength":16},"context":{"type":"object","description":"Canonical Map Context Snapshot. Legacy flat context fields remain accepted during migration.","properties":{"conversation_state":{"type":"object","properties":{"conversation_summary":{"type":"string","nullable":true,"maxLength":2000},"modes":{"type":"array","items":{"type":"string"}},"search_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}}}},"map_state":{"type":"object","properties":{"user_location":{"type":"object","additionalProperties":false,"required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180}}},"map_center":{"type":"object","additionalProperties":false,"required":["lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180}}},"viewport":{"type":"object","required":["north","south","east","west"],"properties":{"north":{"type":"number"},"south":{"type":"number"},"east":{"type":"number"},"west":{"type":"number"},"zoom":{"type":"number","minimum":0,"maximum":22}}},"active_layers":{"type":"array","items":{"type":"string"}},"query_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}},"search_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}},"display_origin":{"type":"object","additionalProperties":false,"required":["type","label","lat","lon"],"properties":{"lat":{"type":"number","minimum":-90,"maximum":90},"lon":{"type":"number","minimum":-180,"maximum":180},"type":{"enum":["user_location","named_place","map_center","address"]},"label":{"type":"string","nullable":true,"maxLength":500}}}}},"dataset_state":{"type":"object","properties":{"current_dataset":{"nullable":true,"type":"object","required":["id","version","scope","entities","provenance","freshness","received_at"],"properties":{"id":{"type":"string"},"version":{"type":"string"},"scope":{"type":"string"},"entities":{"type":"array","maxItems":100,"items":{"type":"object"}},"provenance":{"type":"array","items":{"type":"string"}},"freshness":{"enum":["live","fresh","stale","unknown"]},"received_at":{"type":"string","format":"date-time"}}}}},"selection_state":{"type":"object","properties":{"selected_entity_id":{"type":"string","nullable":true}}},"execution_state":{"type":"object","properties":{"last_successful_request":{"nullable":true,"type":"object","required":["capability","args"],"properties":{"capability":{"enum":["search_mobility","place_search","geocode","reverse_geocode"]},"args":{"type":"object"}}},"last_capabilities_used":{"type":"array","items":{"type":"string"}}}}}},"command":{"type":"object","additionalProperties":false,"required":["intent","modes","operation","location_reference"],"properties":{"intent":{"enum":["nearby_search"]},"modes":{"type":"array","minItems":1,"maxItems":4,"uniqueItems":true,"items":{"enum":["bicycle","scooter","moped","car"]}},"operation":{"enum":["replace_modes"]},"location_reference":{"enum":["inherit"]}}}}}}}},"responses":{"200":{"description":"text/event-stream containing progress and result events"},"400":{"description":"Invalid input"},"429":{"description":"Rate limited"}}}}}}