Concepts¶

This section explains how Vandelay works under the hood. Read these to understand the "why" behind the platform.

Core Concepts¶

Concept	What It Covers
Architecture	System diagram, request flow, component overview
Agents	Agent lifecycle, workspace files, system prompt assembly
Teams	Supervisor model, specialist delegation, team modes
Memory	Session history, agentic memory, workspace files, DB storage
Knowledge	RAG pipeline, embedders, vector store, document ingestion
Channels	Channel-agnostic design, Terminal/Telegram/WhatsApp/WebSocket
Safety	Safety modes, blocked patterns, sandboxing

How They Fit Together¶

Channels → ChatService → Agent/Team → Tools
                ↕              ↕
            Sessions      Memory + Knowledge
                ↕
            SQLite DB

Messages arrive from any channel, get processed by the agent (or team supervisor), which uses tools, memory, and knowledge to respond. Everything persists through the unified SQLite database.