How svihijayasinghe15-sudo/kapi-kapruka-ai-agent works
Kapi Shopping Agent is a web-based Kapruka shopping assistant. A shopper starts in the chat UI, sends a message to the chat API, and receives an AI-generated reply with live product results; the API also has a separate order-tracking path. The UI presents product cards and cart controls. The sampled API route calls Kapruka and Gemini directly; a separate chat-service/conversation-engine path is also present, but the excerpts do not show it being invoked by that route. Several UI and API details are inferred only from the tree or partial excerpts.
Main entry points: page.tsx Shopping page · route.ts Chat endpoint · conversation-engine.ts Conversation engine · kapruka-mcp.ts Kapruka MCP
Components 16
Shopping interface
- Shopping page
app/page.tsx - Chat interface
components/chat/ChatWindow.tsx - Welcome screen
components/chat/WelcomeScreen.tsx - Product display
components/products/ProductCard.tsx - Cart panels
components/cart/CartPanel.tsx - Cart drawer
components/cart/CartDrawer.tsx
Chat API
- Chat endpoint
app/api/chat/route.ts - Order tracking
app/api/chat/route.ts - Product search
app/api/chat/route.ts
Conversation engine
- Chat service
lib/ai/chat-service.ts - Conversation engine
lib/conversation-engine.ts - Result parsing
lib/kapruka-parser.ts - Query extraction
lib/product-search.ts
External services
- Kapruka MCP
lib/kapruka-mcp.ts - Gemini AI
Other components
- Shopper
Connections 18
- Shopper → Shopping page: uses
- Shopping page → Welcome screen: shows
- Shopping page → Chat interface: renders
- Shopping page → Chat endpoint: posts message
- Chat endpoint → Order tracking: routes tracking
- Chat endpoint → Product search: extracts search
- Order tracking → Kapruka MCP: tracks order
- Product search → Kapruka MCP: searches products
- Chat endpoint → Gemini AI: generates reply
- Chat endpoint → Shopping page: returns response
- Shopping page → Product display: renders results
- Shopping page → Cart panels: updates cart
- Shopping page → Cart drawer: opens cart
- Chat service → Conversation engine: processes chat
- Conversation engine → Query extraction: extracts query
- Conversation engine → Kapruka MCP: searches products
- Conversation engine → Result parsing: parses results
- Conversation engine → Gemini AI: generates response