How arun18-lang/agent-platform works
Nexus is an authenticated AI automation workspace. A user signs in, opens chat, submits a prompt (optionally with files or voice), and receives an answer with live tool progress; the agent routes intent, runs an OpenAI tool loop through MCP and web search, then streams results to the UI. The README documents multiple MCP integrations; local Google Workspace, WhatsApp Cloud and PowerPoint servers are shown, while several external MCP servers are configured by the manager. Voice, uploads, exports and session persistence are distinct product capabilities. Some links reflect README documentation because those implementations were not sampled.
Main entry points: index.js Express app · manager.js MCP client manager · orchestrator.js Agent tool loop · ChatWorkspace.jsx Chat workspace
Components 34
Workspace UI
- App routing
frontend/src/App.jsx - Sign-in page
frontend/src/pages/AuthPage.jsx - Chat workspace
frontend/src/ChatWorkspace.jsx - Chat and streaming UI
frontend/src/components/ChatPanel.jsx - Workspace header
frontend/src/components/WorkspaceHeader.jsx - Tool sidebar
frontend/src/components/Sidebar.jsx - API client
frontend/src/api.js
Backend API
- Express app
backend/src/index.js - Authentication API
backend/src/routes/auth.js - Chat API
backend/src/routes/agent.js - Tools catalog API
backend/src/routes/tools.js - Sessions API
backend/src/routes/sessions.js - Voice API
backend/src/routes/voice.js - Generated downloads
backend/src/routes/exports.js - Upload parsing
backend/src/services/uploadParsing.js - Chat attachment storage
backend/src/services/chatAttachmentStore.js
Agent Runtime
- Agent tool loop
backend/src/agents/orchestrator.js - Intent routing
backend/src/agents/intentRouter.js - Attachment analysis planner
backend/src/agents/analysisPlanner.js - Uploaded data context
backend/src/services/uploadedDataContext.js - Download registration
backend/src/services/generatedFileDownloads.js
Tools and Integrations
- MCP client manager
backend/src/mcp/manager.js - Web search
backend/src/tools/webSearch.js - Google Workspace MCP
backend/src/mcp/google-workspace-mcp/index.js - WhatsApp Cloud MCP
backend/src/mcp/whatsapp-cloud-mcp/index.js - PowerPoint MCP
backend/src/mcp/rich-ppt-mcp/index.js
Persistence and Voice
- MongoDB
backend/src/db/mongo.js - Voice input processing
backend/src/services/voiceInputs.js - Speech service
backend/src/services/sarvamSpeech.js - Voice WebSocket
backend/src/voice/attachVoiceWebSocket.js - Voice subscribers
backend/src/voice/voiceSubscribers.js
Other components
- User
- Configured MCP services
- Speech provider
Connections 42
- User → App routing: opens
frontend/src/App.jsx - App routing → Sign-in page: routes
frontend/src/App.jsx - App routing → Chat workspace: protects
frontend/src/App.jsx - User → Sign-in page: signs in
frontend/src/pages/AuthPage.jsx - Sign-in page → Authentication API: submits credentials
frontend/src/pages/AuthPage.jsx - Authentication API → MongoDB: stores accounts
backend/src/routes/auth.js - Chat workspace → Chat and streaming UI: renders
frontend/src/ChatWorkspace.jsx - Chat workspace → Workspace header: renders
frontend/src/ChatWorkspace.jsx - Chat workspace → Tool sidebar: renders
- Chat and streaming UI → API client: builds requests
frontend/src/components/ChatPanel.jsx - API client → Express app: calls API
- Workspace header → Tool sidebar: shows integrations
- Express app → Chat API: routes requests
backend/src/index.js - Express app → Authentication API: routes requests
backend/src/index.js - Express app → Tools catalog API: routes requests
backend/src/index.js - Express app → Sessions API: routes requests
backend/src/index.js - Express app → Voice API: routes requests
backend/src/index.js - Express app → Generated downloads: routes requests
backend/src/index.js - Express app → MongoDB: connects
backend/src/index.js - Chat API → Agent tool loop: runs agent
backend/src/routes/agent.js - Chat API → Chat attachment storage: stores uploads
backend/src/routes/agent.js - Chat API → Upload parsing: parses uploads
backend/src/routes/agent.js - Agent tool loop → Intent routing: classifies intent
backend/src/agents/orchestrator.js - Agent tool loop → Attachment analysis planner: plans analysis
backend/src/agents/orchestrator.js - Agent tool loop → Uploaded data context: builds context
backend/src/agents/orchestrator.js - Agent tool loop → MCP client manager: invokes tools
backend/src/agents/orchestrator.js - Agent tool loop → Download registration: registers files
backend/src/agents/orchestrator.js - MCP client manager → Web search: dispatches web calls
backend/src/mcp/manager.js - MCP client manager → Configured MCP services: connects stdio
README.md - MCP client manager → Google Workspace MCP: connects server
README.md - MCP client manager → WhatsApp Cloud MCP: connects server
README.md - MCP client manager → PowerPoint MCP: connects server
README.md - Tools catalog API → MCP client manager: lists tools
backend/src/routes/tools.js - Sessions API → MongoDB: reads and writes
backend/src/routes/sessions.js - Generated downloads → Download registration: serves files
backend/src/routes/exports.js - Express app → Voice WebSocket: attaches socket
backend/src/index.js - Voice API → Voice input processing: processes voice
backend/src/routes/voice.js - Voice WebSocket → Voice input processing: processes segments
backend/src/voice/attachVoiceWebSocket.js - Voice WebSocket → Voice subscribers: notifies listeners
backend/src/voice/attachVoiceWebSocket.js - Voice input processing → Speech service: transcribes speech
backend/src/services/voiceInputs.js - Voice input processing → MongoDB: stores inputs
backend/src/services/voiceInputs.js - Speech service → Speech provider: requests transcription