Skip to content

README.md

Latest commit

 

History

History
82 lines (63 loc) · 2.17 KB

README.md

File metadata and controls

82 lines (63 loc) · 2.17 KB

Lifecycle Documentation

Visual flowcharts and detailed explanations of how each system component works end-to-end.

Overview

This directory contains lifecycle documentation showing complete user journeys through the Agents Backend system. Each document includes:

  • Mermaid flowcharts - Visual representation of the flow
  • Database tables - What data is affected
  • API endpoints - What to call and when
  • Code references - Links to source files
  • Examples - Practical request/response examples

Lifecycle Documents

Lifecycle Description
Authentication Login, JWT, OAuth, session management
User Management Account creation, credits, API keys
Agent Chat Chat request → LangGraph → streaming response
Sandbox Create → tools → credentials → delete
MCP Registry Built-in 44 tools, registration, execution
MCP User Settings Codex, Claude Code, custom MCP configs
Frontend Integration How frontend connects to all APIs

Quick Reference: What Calls What

flowchart TD
    subgraph Frontend
        A[React App]
    end
    
    subgraph Backend API
        B[Auth Endpoints]
        C[Agent Endpoints]
        D[Sandbox Endpoints]
    end
    
    subgraph Services
        E[LangGraph Agent]
        F[Sandbox Service]
        G[MCP Settings Service]
    end
    
    subgraph External
        H[E2B/Daytona]
        I[MCP Tool Server]
        J[LLM Providers]
    end
    
    A --> B
    A --> C
    A --> D
    
    B --> |JWT| A
    C --> E
    D --> F
    
    E --> J
    E --> I
    F --> H
    H --> I
    G --> |Credentials| H
Loading

Related Documentation

Document Description
API Endpoints Complete endpoint reference
Database Schema All tables and columns
MCP Configuration Tool server architecture
Sandbox Tools All 44+ tools