Architecture Diagrams

Architecture Diagrams

This section contains canonical visual architecture diagrams illustrating Dewee’s internal workflows, progressive memory loops, and multi-tenant isolation boundaries.

8-Stage Agent Pipeline

The core execution loop inside internal/pipeline/ processes each incoming message through eight deterministic stages: Context resolution, History retrieval, Prompt compilation, Model reasoning, Tool execution, Observation capture, Memory consolidation, and Session compaction.

flowchart LR
  In[Inbound Message] --> Ctx[Context Resolution]
  Ctx --> His[History Buffer]
  His --> Pr[Prompt Compiler]
  Pr --> Th[Model Reasoning]
  Th --> Act[Tool Execution]
  Act --> Obs[Observation Capture]
  Obs --> Mem[Memory Consolidation]
  Mem --> Sum[Session Compaction]
  Sum --> Out[Response Delivery]

3-Tier Progressive Memory Model

The progressive memory hierarchy spans three persistent tiers:

• L0 Working Memory: Ephemeral conversation buffer maintained in turn context.
• L1 Episodic Memory: Vectorized session summaries stored in PostgreSQL with pgvector embeddings.
• L2 Semantic Memory: Knowledge Graph entities and semantic relations extracted across conversations.

flowchart TB
  Turn[Conversation Turn] --> L0[Working Memory L0: Active Context Buffer]
  L0 --> Compaction[Session Summarization]
  Compaction --> L1[Episodic Memory L1: PostgreSQL pgvector Embeddings]
  L1 --> KGExtraction[Knowledge Graph Extraction]
  KGExtraction --> L2[Semantic Memory L2: Entities & Relations Graph]

Multi-Tenant Gateway Architecture

The multi-tenant gateway guarantees strict tenant isolation across database queries, workspace context directories, and encrypted provider credentials.

flowchart TB
  Client[Client / Webapp / CLI] --> Gateway[Dewee Go 1.26 Gateway Core]
  Gateway --> Auth[Auth & Tenant Resolver]
  Auth --> TenantDB[(Tenant PostgreSQL DB)]
  Auth --> WorkspaceFS[Workspace Isolated Context Files]
  Gateway --> ProviderAdapter[Provider Adapter: 20+ LLMs]