How anirudhpi/multi-provider-food-agent works
This is a read-only restaurant-discovery agent with a React browser UI and modular Spring Boot backend. A user can optionally approve location access, submit a natural-language request, watch streamed progress, and receive restaurant results or clarification/errors. The backend agent loops through model decisions and allow-listed tools; discovery results are normalized through provider adapters. The graph also includes the documented direct discovery and model APIs. Unsampled modules are represented only where the README or source index supports their role; some integration links are therefore dashed.
Main entry points: App.tsx Conversation UI · RestaurantDiscoveryService.java Discovery service · AgentOrchestrator.java Turn orchestrator · AgentController.java Agent endpoints
Components 20
Browser experience
- Conversation UI
frontend/src/App.tsx - Location control
frontend/src/components/LocationControl.tsx - Restaurant cards
frontend/src/components/RestaurantCard.tsx - Trace progress
frontend/src/components/TraceProgress.tsx - Agent API client
frontend/src/api/agentClient.ts
HTTP interface
- Agent endpoints
backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java - Discovery endpoint
backend/food-agent-api/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryController.java - Model endpoint
backend/food-agent-api/src/main/java/com/learning/foodagent/model/ModelController.java - Application runtime
backend/food-agent-boot/src/main/java/com/learning/foodagent/MultiProviderFoodAgentApplication.java
Agent application
- Turn orchestrator
backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java - Restaurant search tool
backend/food-agent-application/src/main/java/com/learning/foodagent/agent/RestaurantSearchAgentTool.java - Discovery service
backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java - Search criteria
backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchCriteria.java - Normalized results
backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchResult.java
Model and providers
- Local model gateway
backend/food-agent-application/src/main/java/com/learning/foodagent/model/LocalModelGateway.java - Swiggy gateway
backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SwiggyRestaurantDiscoveryGateway.java - Swiggy MCP client
backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SpringAiSwiggyMcpToolClient.java
Other components
- Food seeker
- Ollama model
- Swiggy MCP
Connections 19
- Food seeker → Conversation UI: submits request
frontend/src/App.tsx - Conversation UI → Location control: requests location
frontend/src/App.tsx - Conversation UI → Agent API client: streams turn
frontend/src/App.tsx - Conversation UI → Trace progress: renders trace
frontend/src/App.tsx - Conversation UI → Restaurant cards: renders results
frontend/src/App.tsx - Agent API client → Agent endpoints: posts SSE turn
README.md - Agent endpoints → Turn orchestrator: handles turn
backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java - Turn orchestrator → Local model gateway: requests decisions
backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java - Turn orchestrator → Restaurant search tool: dispatches tool
backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java - Restaurant search tool → Discovery service: searches restaurants
backend/food-agent-application/src/main/java/com/learning/foodagent/agent/RestaurantSearchAgentTool.java - Discovery service → Search criteria: accepts criteria
backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java - Discovery service → Normalized results: returns results
backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java - Local model gateway → Ollama model: generates locally
README.md - Discovery service → Swiggy gateway: dispatches provider
- Swiggy gateway → Swiggy MCP client: calls MCP tool
- Swiggy MCP client → Swiggy MCP: searches restaurants
README.md - Discovery endpoint → Discovery service: searches directly
backend/food-agent-api/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryController.java - Model endpoint → Local model gateway: generates directly
backend/food-agent-api/src/main/java/com/learning/foodagent/model/ModelController.java - Application runtime → Agent endpoints: assembles runtime
README.md