Architecture
Understand the current open-source components and their runtime boundaries.
Ciele is a TypeScript monorepo with one Next.js product application, shared packages, Postgres, and optional workers.
Main boundaries
Optional workers run beside the runtime for crawling and graph builds. They read the same database and stay off by default. See Background workers.
The Flow router remains authoritative. A model can classify intent, generate selected actions, and call registered tools.
The model cannot replace Flow order, objective conditions, action configuration, Organization authorization, or network egress checks.
Read the architecture
- Repository map locates code ownership.
- Request flows traces console, API, and widget requests.
- Chat runtime explains triggers, routing, and actions.
- Agentic model explains model and tool execution.
- Knowledge pipeline explains ingestion and retrieval.
- Data model explains tenant and Conversation relationships.