Project Logic Overview

Current Downcity can be understood through these nouns:

• studio: the overall runtime and CLI surface
• console: global control plane
• agent: one project runtime
• session: one execution thread
• plugin: one capability boundary

The shortest model

• console manages
• agent hosts
• session executes
• plugins expose capability

Plugin families

Local plugins

• attached directly to one SDK Agent
• usually action-first or hook-oriented

Managed plugins

• owned by one target agent runtime
• may hold lifecycle-owned runtime state

Why this matters

When reading current code or docs, start with:

• if you need execution ownership, look at session
• if you need capability ownership, look at plugin
• if you need process and registry ownership, look at console and agent