How lovingocean/nova-ai works
Nova is a browser-based multi-agent business-task assistant. A user submits a request through the app; the hook delegates it to the master agent, which analyzes intent, plans work, executes specialized agents, verifies results, and exposes progress and output in the UI. The repository also contains a standalone payment-oriented variant; its payment screen is included, but the sampled evidence does not establish how it is routed or backed. The graph focuses on the root application; unsampled tools and integration wiring are not inferred.
Main entry points: App.tsx Nova app · NovaMasterAgent.ts Master agent · executor.ts Plan executor · planner.ts Plan creation
Components 21
User experience
- Nova app
src/App.tsx - Landing page
src/Landing.tsx - Chat panel
src/nova/ui/ChatPanel.tsx - Agent list
src/nova/ui/AgentList.tsx - Execution view
src/nova/ui/ExecutionPanel.tsx - Result panel
src/nova/ui/ResultPanel.tsx - Standalone auth and payment
nova-ai-with-payments/nova-standalone/src/AuthPayment.tsx
Task orchestration
- Nova hook
src/nova/useNova.ts - Master agent
src/nova/NovaMasterAgent.ts - Intent analysis
src/nova/engine/intentAnalyzer.ts - Plan creation
src/nova/engine/planner.ts - Output verification
src/nova/engine/verifier.ts - Core contracts
src/nova/types.ts
Agent execution
- Plan executor
src/nova/engine/executor.ts - Specialized agents
src/nova/agents.ts - Agent tools
src/nova/tools.ts
Providers and persistence
- LLM providers
src/nova/providers.ts - Task persistence
src/nova/persistence.ts - Database adapter
src/nova/db.ts
Other components
- User
- External LLM
Connections 19
- User → Nova app: submits task
src/App.tsx - Nova app → Landing page: renders
src/App.tsx - Nova app → Nova hook: uses
src/App.tsx - Nova app → Chat panel: renders
src/App.tsx - Nova app → Agent list: renders
src/App.tsx - Nova app → Execution view: renders
src/App.tsx - Nova app → Result panel: renders
src/App.tsx - Nova hook → Master agent: delegates to
src/nova/useNova.ts - Master agent → Task persistence: records tasks
src/nova/NovaMasterAgent.ts - Master agent → Intent analysis: analyzes intent
src/nova/NovaMasterAgent.ts - Master agent → Plan creation: creates plan
src/nova/NovaMasterAgent.ts - Master agent → Plan executor: executes plan
src/nova/NovaMasterAgent.ts - Master agent → Output verification: verifies results
src/nova/NovaMasterAgent.ts - Plan executor → Specialized agents: looks up agents
src/nova/engine/executor.ts - Plan executor → LLM providers: runs agent
src/nova/engine/executor.ts - Plan executor → Plan creation: resolves order
src/nova/engine/executor.ts - Plan creation → Specialized agents: selects from registry
src/nova/engine/planner.ts - Task persistence → Database adapter: uses adapter
src/nova/persistence.ts - LLM providers → External LLM: calls when configured
src/nova/providers.ts