How rishikgrandhi/tripmind works
TripMind turns a natural-language travel request into a constraint-checked itinerary, repairs violations within configured bounds, scores feasible plans, explains the result, and retains completed or infeasible plans in SQLite. The frontend submits requests and presents the itinerary, validation, agent trace, replanning history, and saved plans. The README documents the main planning stages and optional integrations; the detailed internal call graph is limited to relationships visible in the provided excerpts and SOURCE INDEX.
Main entry points: coordinator.py Planning coordinator · App.tsx Trip planner UI · registry.py Tool registry · trips.py Trip endpoints
Components 26
Planning UI
- Trip planner UI
frontend/src/App.tsx - Request form
frontend/src/components/RequestForm.tsx - Plan and trace views
frontend/src/components/PlanningPipeline.tsx - Recent plans view
frontend/src/components/RecentPlans.tsx - Trip API client
frontend/src/api/tripmind.ts
Request handling
- Trip endpoints
backend/app/api/trips.py - Intent extraction
backend/app/extraction/service.py - Extraction models
backend/app/extraction/models.py - LLM providers
backend/app/llm/base.py
Planning engine
- Planning coordinator
backend/app/planning/coordinator.py - Agent action loop
backend/app/planning/agent_loop.py - Candidate builder
backend/app/planning/candidate_builder.py - Constraint validation
backend/app/planning/validation/rules.py - Cost breakdown
backend/app/planning/cost_engine.py - Bounded replanning
backend/app/planning/replanning/replanner.py - Preference scoring
backend/app/planning/scoring/scorer.py - Plan explanation
backend/app/planning/explanation/generator.py
Travel tools
- Tool registry
backend/app/tools/registry.py - Local travel tools
backend/app/tools/local.py - Local travel catalog
backend/app/tools/local_data.py - Live travel adapters
backend/app/tools/external/adapters.py
State and history
- Trip state and models
backend/app/domain/models.py - Planning history store
backend/app/persistence/models.py - Session repository
backend/app/persistence/repository.py - Runtime settings
backend/app/core/config.py
Other components
- Traveler
Connections 31
- Traveler → Trip planner UI: enters request
- Trip planner UI → Request form: renders
frontend/src/App.tsx - Trip planner UI → Trip API client: submits and loads
frontend/src/App.tsx - Trip API client → Trip endpoints: calls API
- Trip endpoints → Intent extraction: plans natural language
backend/app/api/trips.py - Intent extraction → Extraction models: validates intent
backend/app/extraction/service.py - Intent extraction → LLM providers: selects provider
backend/app/extraction/service.py - Intent extraction → Planning coordinator: plans request
backend/app/extraction/service.py - Planning coordinator → Agent action loop: runs agent loop
backend/app/planning/coordinator.py - Planning coordinator → Candidate builder: builds candidate
backend/app/planning/coordinator.py - Planning coordinator → Constraint validation: checks constraints
backend/app/planning/coordinator.py - Planning coordinator → Bounded replanning: repairs violations
backend/app/planning/coordinator.py - Planning coordinator → Preference scoring: scores feasible plan
backend/app/planning/coordinator.py - Planning coordinator → Plan explanation: explains outcome
backend/app/planning/coordinator.py - Agent action loop → Candidate builder: uses builder
backend/app/planning/agent_loop.py - Agent action loop → Tool registry: dispatches tools
backend/app/planning/agent_loop.py - Candidate builder → Tool registry: searches options
- Tool registry → Local travel tools: selects local tools
backend/app/tools/registry.py - Tool registry → Live travel adapters: selects live adapters
backend/app/tools/registry.py - Local travel tools → Local travel catalog: reads records
backend/app/tools/local.py - Constraint validation → Cost breakdown: calculates costs
backend/app/planning/validation/rules.py - Constraint validation → Local travel catalog: checks travel data
backend/app/planning/validation/rules.py - Planning coordinator → Trip state and models: maintains trip state
backend/app/planning/coordinator.py - Trip endpoints → Session repository: persists plan history
- Session repository → Planning history store: reads and writes
backend/app/persistence/repository.py - Session repository → Trip state and models: serializes trip state
backend/app/persistence/repository.py - Runtime settings → Tool registry: configures providers
backend/app/tools/registry.py - Runtime settings → Planning coordinator: sets planning limits
backend/app/planning/coordinator.py - Trip planner UI → Plan and trace views: renders result trace
frontend/src/App.tsx - Trip planner UI → Recent plans view: renders saved plans
frontend/src/App.tsx - Trip endpoints → Trip planner UI: returns plan response