How mokshamehta06/embedded-voice-assistant works
This repository provides a web dashboard for configuring an embeddable voice/browser assistant, with a Node/Express API for accounts, assistant sessions, and paid plans. The main workflow is dashboard setup, visitor interaction through the widget, server-side Gemini reasoning and browser-tool steps, then plan-based usage and billing. The graph includes documented dashboard pages and server subsystems; several runtime integrations are represented only where sampled source or the source index supports their connections.
Main entry points: app.js Express application · App.jsx Dashboard router · assistant.controller.js Assistant controller · agentService.js Agent reasoning
Components 29
Dashboard
- Dashboard router
client/vite-project/src/App.jsx - Home page
client/vite-project/src/pages/Home.jsx - Service showcase
client/vite-project/src/components/AccordionServices.jsx - Assistant preview
client/vite-project/src/components/AssistantPreview.jsx - Assistant builder
client/vite-project/src/pages/Buider.jsx - Login page
client/vite-project/src/pages/Login.jsx
Assistant Runtime
- Embeddable widget
server/public/assistant.js - Assistant routes
server/Routes/assistant.route.js - Assistant controller
server/Controllers/assistant.controller.js - Agent reasoning
server/Services/agentService.js - Gemini integration
server/Config/gemini.js - Browser tool catalog
server/mcp/tools.js - Browser session bridge
server/mcp/browserBridge.js - MCP server
server/mcp/mcpServer.js - Key encryption
server/Utils/encryption.js
API and Accounts
- Express application
server/app.js - Auth routes
server/Routes/auth.routes.js - Account auth
server/Controllers/auth.controller.js - User routes
server/Routes/user.routes.js - User settings
server/Controllers/user.controller.js - Session guard
server/Middleware/isAuth.js - User records
server/Models/user.model.js
Billing
- Billing page
client/vite-project/src/pages/Billing.jsx - Billing routes
server/Routes/billing.route.js - Billing operations
server/Controllers/billing.controller.js - Billing records
server/Models/billing.model.js
Other components
- Dashboard user
- Visitor website
- Razorpay gateway
Connections 34
- Dashboard user → Dashboard router: uses
- Dashboard router → Home page: routes to
client/vite-project/src/App.jsx - Dashboard router → Login page: routes to
client/vite-project/src/App.jsx - Dashboard router → Assistant builder: routes to
client/vite-project/src/App.jsx - Dashboard router → Billing page: routes to
client/vite-project/src/App.jsx - Home page → Service showcase: renders
client/vite-project/src/pages/Home.jsx - Home page → Assistant preview: renders
client/vite-project/src/pages/Home.jsx - Visitor website → Embeddable widget: loads
- Express application → Embeddable widget: serves static
server/app.js - Express application → Auth routes: mounts
server/app.js - Express application → User routes: mounts
server/app.js - Express application → Assistant routes: mounts
server/app.js - Express application → Billing routes: mounts
server/app.js - Auth routes → Account auth: dispatches
server/Routes/auth.routes.js - Account auth → User records: reads and writes
server/Controllers/auth.controller.js - User routes → Session guard: guards requests
server/Routes/user.routes.js - User routes → User settings: dispatches
server/Routes/user.routes.js - User settings → User records: reads and writes
server/Controllers/user.controller.js - Assistant routes → Assistant controller: dispatches
server/Routes/assistant.route.js - Assistant controller → User records: reads and updates
server/Controllers/assistant.controller.js - Assistant controller → Key encryption: decrypts key
server/Controllers/assistant.controller.js - Assistant controller → Agent reasoning: delegates turns
server/Controllers/assistant.controller.js - Assistant controller → MCP server: handles MCP
server/Controllers/assistant.controller.js - Agent reasoning → Gemini integration: requests model turns
server/Services/agentService.js - Agent reasoning → Browser tool catalog: loads tools
server/Services/agentService.js - Agent reasoning → Browser session bridge: manages sessions
server/Services/agentService.js - Agent reasoning → Key encryption: decrypts key
server/Services/agentService.js - MCP server → Browser tool catalog: uses tools
server/mcp/mcpServer.js - MCP server → Browser session bridge: uses bridge
server/mcp/mcpServer.js - Billing routes → Session guard: guards requests
server/Routes/billing.route.js - Billing routes → Billing operations: dispatches
server/Routes/billing.route.js - Billing operations → Razorpay gateway: creates orders
server/Controllers/billing.controller.js - Billing operations → Billing records: reads and writes
server/Controllers/billing.controller.js - Billing operations → User records: updates plan
server/Controllers/billing.controller.js