# esengine/deepseek-reasonix architecture

> Architecture diagram of the GitHub repository esengine/deepseek-reasonix, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/esengine/deepseek-reasonix
- Repository: https://github.com/esengine/deepseek-reasonix

## Overview

Reasonix is a local coding-agent engine exposed through terminal, desktop, browser, and editor/ACP interfaces. The main workflow is a user request entering an interface, reaching the shared session controller, then running an agent turn that uses configured models and tools and streams events back. The README also documents planning, permissions, sandboxing, checkpoints, plugins, extensions, and context maintenance; these are represented as runtime branches. The tree and excerpts establish some subsystem boundaries but not all call wiring, so uncertain links are omitted.

Main entry points: [`internal/assembly/boot`](https://github.com/esengine/deepseek-reasonix/tree/studio/internal/assembly/boot) (Runtime assembly), [`internal/runtime/agent`](https://github.com/esengine/deepseek-reasonix/tree/studio/internal/runtime/agent) (Agent turn loop), [`internal/session/control/controller.go`](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/session/control/controller.go) (Session controller), [`cmd/reasonix/main.go`](https://github.com/esengine/deepseek-reasonix/blob/studio/cmd/reasonix/main.go) (CLI entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interfaces["User interfaces"]
  node_cli["CLI entry<br/>[main.go]"]
  node_desktop["Studio UI<br/>[main.tsx]"]
  node_web["Browser UI"]
  node_editor["Editor ACP<br/>[main.go]"]
  node_storage_api["Storage controls<br/>[storage.go]"]
end

subgraph group_runtime["Agent runtime"]
  node_boot["Runtime assembly"]
  node_controller["Session controller<br/>[controller.go]"]
  node_agent["Agent turn loop"]
  node_providers["Model providers<br/>[provider_config.go]"]
  node_planner["Planner models<br/>[side_models.go]"]
end

subgraph group_execution["Tools and integrations"]
  node_tools["Agent tools"]
  node_sandbox["Workspace sandbox<br/>[isolation.go]"]
  node_browser["Browser engine<br/>[engine.go]"]
  node_mcp{{"MCP servers"}}
  node_extensions{{"Extensions<br/>[extension_stage.go]"}}
end

subgraph group_state["Context and state"]
  node_context["Context maintenance<br/>[context_manager.go]"]
  node_sessions[("Session state<br/>[controller.go]")]
  node_temp["Session temp<br/>[manager.go]"]
  node_storage[("Storage roots<br/>[storage_roots.go]")]
end

node_user(("User"))

node_user -->|"requests"| node_cli
node_user -->|"requests"| node_desktop
node_user -->|"requests"| node_web
node_user -->|"requests"| node_editor
node_cli -->|"starts engine"| node_boot
node_desktop -->|"uses shared engine"| node_boot
node_web -->|"uses shared engine"| node_boot
node_editor -->|"uses shared engine"| node_boot
node_boot -->|"assembles"| node_controller
node_controller -->|"drives turns"| node_agent
node_agent -->|"samples model"| node_providers
node_agent -.->|"uses optionally"| node_planner
node_agent -->|"invokes"| node_tools
node_tools -->|"executes within"| node_sandbox
node_tools -.->|"uses optionally"| node_browser
node_boot -->|"registers"| node_mcp
node_boot -->|"loads"| node_extensions
node_agent -->|"prepares context"| node_context
node_controller -->|"manages lifecycle"| node_sessions
node_controller -->|"shares session temp"| node_temp
node_storage_api -->|"surveys and plans moves"| node_storage

click node_cli "https://github.com/esengine/deepseek-reasonix/blob/studio/cmd/reasonix/main.go"
click node_desktop "https://github.com/esengine/deepseek-reasonix/blob/studio/desktop/frontend-next/src/main.tsx"
click node_web "https://github.com/esengine/deepseek-reasonix/tree/studio/internal/frontend/serve"
click node_editor "https://github.com/esengine/deepseek-reasonix/blob/studio/cmd/reasonix/main.go"
click node_boot "https://github.com/esengine/deepseek-reasonix/tree/studio/internal/assembly/boot"
click node_controller "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/session/control/controller.go"
click node_agent "https://github.com/esengine/deepseek-reasonix/tree/studio/internal/runtime/agent"
click node_providers "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/provider_config.go"
click node_planner "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/side_models.go"
click node_tools "https://github.com/esengine/deepseek-reasonix/tree/studio/internal/assembly/boot"
click node_sandbox "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/isolation.go"
click node_browser "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/platform/browser/engine.go"
click node_mcp "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/mcp_registration.go"
click node_extensions "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/extension_stage.go"
click node_context "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/runtime/agent/context_manager.go"
click node_sessions "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/session/control/controller.go"
click node_temp "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/state/sessiontemp/manager.go"
click node_storage "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/contract/config/storage_roots.go"
click node_storage_api "https://github.com/esengine/deepseek-reasonix/blob/studio/internal/frontend/serve/storage.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli,node_desktop,node_web,node_editor,node_storage_api,node_user toneBlue
class node_boot,node_controller,node_agent,node_providers,node_planner toneAmber
class node_tools,node_sandbox,node_browser,node_mcp,node_extensions toneMint
class node_context,node_sessions,node_temp,node_storage toneRose
```

## Components

### User interfaces

- [CLI entry](https://github.com/esengine/deepseek-reasonix/blob/studio/cmd/reasonix/main.go): `cmd/reasonix/main.go`
- [Studio UI](https://github.com/esengine/deepseek-reasonix/blob/studio/desktop/frontend-next/src/main.tsx): `desktop/frontend-next/src/main.tsx`
- [Browser UI](https://github.com/esengine/deepseek-reasonix/tree/studio/internal/frontend/serve): `internal/frontend/serve`
- [Editor ACP](https://github.com/esengine/deepseek-reasonix/blob/studio/cmd/reasonix/main.go): `cmd/reasonix/main.go`
- [Storage controls](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/frontend/serve/storage.go): `internal/frontend/serve/storage.go`

### Agent runtime

- [Runtime assembly](https://github.com/esengine/deepseek-reasonix/tree/studio/internal/assembly/boot): `internal/assembly/boot`
- [Session controller](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/session/control/controller.go): `internal/session/control/controller.go`
- [Agent turn loop](https://github.com/esengine/deepseek-reasonix/tree/studio/internal/runtime/agent): `internal/runtime/agent`
- [Model providers](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/provider_config.go): `internal/assembly/boot/provider_config.go`
- [Planner models](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/side_models.go): `internal/assembly/boot/side_models.go`

### Tools and integrations

- [Agent tools](https://github.com/esengine/deepseek-reasonix/tree/studio/internal/assembly/boot): `internal/assembly/boot`
- [Workspace sandbox](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/isolation.go): `internal/assembly/boot/isolation.go`
- [Browser engine](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/platform/browser/engine.go): `internal/platform/browser/engine.go`
- [MCP servers](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/mcp_registration.go): `internal/assembly/boot/mcp_registration.go`
- [Extensions](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/assembly/boot/extension_stage.go): `internal/assembly/boot/extension_stage.go`

### Context and state

- [Context maintenance](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/runtime/agent/context_manager.go): `internal/runtime/agent/context_manager.go`
- [Session state](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/session/control/controller.go): `internal/session/control/controller.go`
- [Session temp](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/state/sessiontemp/manager.go): `internal/state/sessiontemp/manager.go`
- [Storage roots](https://github.com/esengine/deepseek-reasonix/blob/studio/internal/contract/config/storage_roots.go): `internal/contract/config/storage_roots.go`

### Other components

- **User**

## Connections

- User → CLI entry: requests
- User → Studio UI: requests
- User → Browser UI: requests
- User → Editor ACP: requests
- CLI entry → Runtime assembly: starts engine
- Studio UI → Runtime assembly: uses shared engine
- Browser UI → Runtime assembly: uses shared engine
- Editor ACP → Runtime assembly: uses shared engine
- Runtime assembly → Session controller: assembles
- Session controller → Agent turn loop: drives turns
- Agent turn loop → Model providers: samples model
- Agent turn loop → Planner models: uses optionally
- Agent turn loop → Agent tools: invokes
- Agent tools → Workspace sandbox: executes within
- Agent tools → Browser engine: uses optionally
- Runtime assembly → MCP servers: registers
- Runtime assembly → Extensions: loads
- Agent turn loop → Context maintenance: prepares context
- Session controller → Session state: manages lifecycle
- Session controller → Session temp: shares session temp
- Storage controls → Storage roots: surveys and plans moves
