Skip to main content
Zeus’s Agent mode is built on the DeepAgents framework, supporting autonomous task planning, tool invocation, and execution. The runtime manages the Agent’s lifecycle — from workspace initialization, tool assembly, and prompt construction to session isolation and state persistence.

​
Core Modules

Bootstrapping

Startup bootstrapping — System Prompt assembly, mode selection, dynamic context injection

HITL

Auto-Run modes and tool approval mechanism, ensuring human confirmation before sensitive operations

Middleware

DeepAgents middleware pipeline — auto-summarization, filesystem, task management, prompt caching

Models

Model configuration & management — custom API Keys, Zeus preset models, 200+ model profiles

Context

Agent context assembly, Token management & optimization strategies

Tools

Four-layer tool system — Built-in Tools, MCP Tools, OAuth Tools, Connector Tools

Skills

Dynamic instruction packages — code review, data analysis, writing assistant, and other extensible skills

System Prompt

System prompt — CORE, SOUL, TOOLS, WORKFLOW, MEMORY, dynamic injection

Artifacts

Structured tool return format — HTML, code, charts, and other rich content rendering

​
Workspace

Each user has an independent cloud workspace managed by CloudDriveBackend, backed by Supabase Storage for persistence and Redis for caching.

File System Detailed Design

Learn about the complete design of CloudDriveBackend, Checkpoint, and other storage architecture

​
Sessions

Each conversation creates an independent Session for state isolation:
  • Session ID: Format is session_{hex12}, provided by the frontend or auto-generated
  • Thread ID: Same as Session ID, used for Checkpointer state isolation
  • Context Cache: Stores tool list, system prompt, and interrupt configuration per session_id, reused during HITL recovery

​
Checkpointer

State persistence is implemented via LangGraph’s Checkpointer mechanism: The Checkpointer automatically saves the complete state after each Agent call (messages, tool calls, Agent internal state), enabling recovery after HITL interrupts and page refreshes.

Checkpoint Storage

Learn about PostgresSaver detailed configuration and HITL recovery flow

​
Modes

Zeus supports three interaction modes, each constraining the Agent’s tool set and behavioral boundaries:

​
Mode Comparison

Modes take effect immediately at the invoke() entry point, implemented through disable flags and tool filtering. Ask mode disables sandbox, memory writes, and HITL; Plan mode disables sandbox and HITL but retains memory read access for context.