Technical FAQ

How does the WASM sandbox work?

Agents are compiled to WebAssembly and run in a sandboxed environment with zero default capabilities. Permissions (network, file, env) must be explicitly granted.

How does state persistence work?

Agent state is stored in a SQLite database. Each agent has a JSON state blob that persists across restarts.

Can agents communicate with each other?

Not directly. Agents communicate through the orchestration layer (supervisors, sagas, workflows, pools).

How does the broker decide which handler to use?

The broker uses pattern matching with confidence scoring. It checks skills first, then WASM handlers, then falls back to LLM. The confidence threshold is configurable (default: 0.90).

What happens when the database gets large?

SQLite handles databases up to 281 TB. For most use cases, performance remains excellent. Enable WAL mode for better concurrent access.

Can I run multiple projects?

Each project has its own directory and database. You can run multiple projects simultaneously.