# anirudhpi/multi-provider-food-agent architecture

> Architecture diagram of the GitHub repository anirudhpi/multi-provider-food-agent, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anirudhpi/multi-provider-food-agent
- Repository: https://github.com/anirudhpi/multi-provider-food-agent

## Overview

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: [`frontend/src/App.tsx`](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/App.tsx) (Conversation UI), [`backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java`](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java) (Discovery service), [`backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java`](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java) (Turn orchestrator), [`backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java`](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java) (Agent endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Browser experience"]
  node_app["Conversation UI<br/>[App.tsx]"]
  node_location["Location control"]
  node_cards["Restaurant cards<br/>[RestaurantCard.tsx]"]
  node_progress["Trace progress<br/>[TraceProgress.tsx]"]
  node_client["Agent API client<br/>[agentClient.ts]"]
end

subgraph group_api["HTTP interface"]
  node_agentapi["Agent endpoints"]
  node_discoveryapi["Discovery endpoint"]
  node_modelapi["Model endpoint"]
  node_boot["Application runtime"]
end

subgraph group_agent["Agent application"]
  node_orchestrator["Turn orchestrator"]
  node_tool["Restaurant search tool"]
  node_discovery["Discovery service"]
  node_criteria["Search criteria"]
  node_results["Normalized results"]
end

subgraph group_integration["Model and providers"]
  node_modelgateway["Local model gateway"]
  node_swiggygateway["Swiggy gateway"]
  node_mcpclient["Swiggy MCP client"]
end

node_user(("Food seeker"))
node_ollama(("Ollama model"))
node_swiggy(("Swiggy MCP"))

node_user -->|"submits request"| node_app
node_app -->|"requests location"| node_location
node_app -->|"streams turn"| node_client
node_app -->|"renders trace"| node_progress
node_app -->|"renders results"| node_cards
node_client -->|"posts SSE turn"| node_agentapi
node_agentapi -->|"handles turn"| node_orchestrator
node_orchestrator -->|"requests decisions"| node_modelgateway
node_orchestrator -->|"dispatches tool"| node_tool
node_tool -.->|"searches restaurants"| node_discovery
node_discovery -->|"accepts criteria"| node_criteria
node_discovery -->|"returns results"| node_results
node_modelgateway -.->|"generates locally"| node_ollama
node_discovery -.->|"dispatches provider"| node_swiggygateway
node_swiggygateway -.->|"calls MCP tool"| node_mcpclient
node_mcpclient -->|"searches restaurants"| node_swiggy
node_discoveryapi -->|"searches directly"| node_discovery
node_modelapi -->|"generates directly"| node_modelgateway
node_boot -.->|"assembles runtime"| node_agentapi

click node_app "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/App.tsx"
click node_location "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/components/LocationControl.tsx"
click node_cards "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/components/RestaurantCard.tsx"
click node_progress "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/components/TraceProgress.tsx"
click node_client "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/api/agentClient.ts"
click node_agentapi "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java"
click node_discoveryapi "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryController.java"
click node_modelapi "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/model/ModelController.java"
click node_orchestrator "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java"
click node_tool "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/agent/RestaurantSearchAgentTool.java"
click node_discovery "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java"
click node_criteria "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchCriteria.java"
click node_results "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchResult.java"
click node_modelgateway "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/model/LocalModelGateway.java"
click node_swiggygateway "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SwiggyRestaurantDiscoveryGateway.java"
click node_mcpclient "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SpringAiSwiggyMcpToolClient.java"
click node_boot "https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-boot/src/main/java/com/learning/foodagent/MultiProviderFoodAgentApplication.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_location,node_cards,node_progress,node_client toneBlue
class node_agentapi,node_discoveryapi,node_modelapi,node_boot toneAmber
class node_orchestrator,node_tool,node_discovery,node_criteria,node_results toneMint
class node_modelgateway,node_swiggygateway,node_mcpclient toneRose
class node_user,node_ollama,node_swiggy toneIndigo
```

## Components

### Browser experience

- [Conversation UI](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Location control](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/components/LocationControl.tsx): `frontend/src/components/LocationControl.tsx`
- [Restaurant cards](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/components/RestaurantCard.tsx): `frontend/src/components/RestaurantCard.tsx`
- [Trace progress](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/components/TraceProgress.tsx): `frontend/src/components/TraceProgress.tsx`
- [Agent API client](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/frontend/src/api/agentClient.ts): `frontend/src/api/agentClient.ts`

### HTTP interface

- [Agent endpoints](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java): `backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java`
- [Discovery endpoint](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryController.java): `backend/food-agent-api/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryController.java`
- [Model endpoint](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-api/src/main/java/com/learning/foodagent/model/ModelController.java): `backend/food-agent-api/src/main/java/com/learning/foodagent/model/ModelController.java`
- [Application runtime](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-boot/src/main/java/com/learning/foodagent/MultiProviderFoodAgentApplication.java): `backend/food-agent-boot/src/main/java/com/learning/foodagent/MultiProviderFoodAgentApplication.java`

### Agent application

- [Turn orchestrator](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java): `backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java`
- [Restaurant search tool](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/agent/RestaurantSearchAgentTool.java): `backend/food-agent-application/src/main/java/com/learning/foodagent/agent/RestaurantSearchAgentTool.java`
- [Discovery service](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java): `backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java`
- [Search criteria](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchCriteria.java): `backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchCriteria.java`
- [Normalized results](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchResult.java): `backend/food-agent-domain/src/main/java/com/learning/foodagent/domain/discovery/RestaurantSearchResult.java`

### Model and providers

- [Local model gateway](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-application/src/main/java/com/learning/foodagent/model/LocalModelGateway.java): `backend/food-agent-application/src/main/java/com/learning/foodagent/model/LocalModelGateway.java`
- [Swiggy gateway](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SwiggyRestaurantDiscoveryGateway.java): `backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SwiggyRestaurantDiscoveryGateway.java`
- [Swiggy MCP client](https://github.com/anirudhpi/multi-provider-food-agent/blob/development/backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SpringAiSwiggyMcpToolClient.java): `backend/food-agent-infrastructure/src/main/java/com/learning/foodagent/swiggy/SpringAiSwiggyMcpToolClient.java`

### Other components

- **Food seeker**
- **Ollama model**
- **Swiggy MCP**

## Connections

- Food seeker → Conversation UI: submits request (evidence: `frontend/src/App.tsx`)
- Conversation UI → Location control: requests location (evidence: `frontend/src/App.tsx`)
- Conversation UI → Agent API client: streams turn (evidence: `frontend/src/App.tsx`)
- Conversation UI → Trace progress: renders trace (evidence: `frontend/src/App.tsx`)
- Conversation UI → Restaurant cards: renders results (evidence: `frontend/src/App.tsx`)
- Agent API client → Agent endpoints: posts SSE turn (evidence: `README.md`)
- Agent endpoints → Turn orchestrator: handles turn (evidence: `backend/food-agent-api/src/main/java/com/learning/foodagent/agent/AgentController.java`)
- Turn orchestrator → Local model gateway: requests decisions (evidence: `backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java`)
- Turn orchestrator → Restaurant search tool: dispatches tool (evidence: `backend/food-agent-application/src/main/java/com/learning/foodagent/agent/AgentOrchestrator.java`)
- Restaurant search tool → Discovery service: searches restaurants (evidence: `backend/food-agent-application/src/main/java/com/learning/foodagent/agent/RestaurantSearchAgentTool.java`)
- Discovery service → Search criteria: accepts criteria (evidence: `backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java`)
- Discovery service → Normalized results: returns results (evidence: `backend/food-agent-application/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryService.java`)
- Local model gateway → Ollama model: generates locally (evidence: `README.md`)
- Discovery service → Swiggy gateway: dispatches provider
- Swiggy gateway → Swiggy MCP client: calls MCP tool
- Swiggy MCP client → Swiggy MCP: searches restaurants (evidence: `README.md`)
- Discovery endpoint → Discovery service: searches directly (evidence: `backend/food-agent-api/src/main/java/com/learning/foodagent/discovery/RestaurantDiscoveryController.java`)
- Model endpoint → Local model gateway: generates directly (evidence: `backend/food-agent-api/src/main/java/com/learning/foodagent/model/ModelController.java`)
- Application runtime → Agent endpoints: assembles runtime (evidence: `README.md`)
