How duongnguyen321/manus-js works
Project Type and Purpose
• Manus JS is a CLI-based, AI-powered web research “agent.”
• Purpose: automate web research by driving a real browser, scraping page content, and using LLMs (OpenAI/OpenRouter via LangChain or direct API) to plan tasks, gather information, synthesize findings, and present results.
File Structure
Top-level files and folders:
• configs/
– configs.ts (env/config loader)
– puppeteer.ts (browser connection settings)
• index.ts – entry point and CLI handler
• src/
– agent/
· initializeAgent.ts & initializeAgentLangChain.ts (agent bootstrap + task planning + synthesis)
· tools/
‑ browserTools.ts (Puppeteer Real Browser wrapper)
‑ performResearch.ts (orchestrates page visits and text extraction)
– utils/
· logger.ts (console logging)
· puppeteer.ts (low-level Puppeteer helpers)
– test.ts (local test harness)
• package.json, tsconfig.json, Bun-oriented scripts
README for Architecture Insights
• Two modes for agent initialization: direct OpenAI or via LangChain + OpenRouter.
• Runtime flow:
1. Choose provider (index.ts)
2. Task analysis & plan (initializeAgent*.ts)
3. Perform research (browserTools + performResearch)
4. Synthesize & generate response (initializeAgent*.ts)
Sketch the Main Components
a. CLI Interface
– index.ts + test.ts
b. Configuration Loader
– configs/configs.ts (reads .env)
– configs/puppeteer.ts
c. Agent Orchestrator
– initializeAgent.ts
– initializeAgentLangChain.ts
d. Research Tools
– browserTools.ts (connects to real browser)
– performResearch.ts (page navigation + scraping)
e. Browser Engine (external)
– Google Chrome driven by puppeteer-real-browser
f. LLM Provider (external)
– OpenAI / OpenRouter APIs (via LangChain or direct HTTP)
g. Utilities
– logger.ts, puppeteer.ts
Architectural Patterns and Principles
• Agent-tool pattern: agent orchestrates “tools” (browserScraper, LLM)
• Separation of concerns: config loading, agent logic, I/O, browser control, LLM calls
• Extensibility: easily swap provider (OpenAI vs OpenRouter via LangChain)
• Resilience: retry logic in browserTools (recursive connect)
Technologies, Frameworks, Libraries
• Bun (runtime) + TypeScript
• puppeteer-real-browser + Puppeteer
• LangChain or custom OpenAI/OpenRouter API calls