# stasedward/enactive architecture

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

- Interactive diagram: https://gitdiagram.com/stasedward/enactive
- Repository: https://github.com/stasedward/enactive

## Overview

Enactive is a desktop workspace for delegating project work to AI agents, with a console host and optional remote access. The main workflow starts with a user request, builds context, plans steps, selects a worker and model, checks permissions, and executes tools against the workspace. Results, artifacts, and evidence feed configured review and success checks before the run outcome is recorded. The graph also includes templates, scheduling, model providers, persistence, and remote control. Unsampled subsystem links are included only where the README documents them; source-level wiring is cited where shown.

Main entry points: [`src/Enactive.Agents/Orchestrator.cs`](https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/Orchestrator.cs) (Run orchestrator), [`src/Enactive.Remote.Gateway/Program.cs`](https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Gateway/Program.cs) (Remote gateway), [`src/Enactive.App.Console/Program.cs`](https://github.com/stasedward/enactive/blob/master/src/Enactive.App.Console/Program.cs) (Console host), [`src/Enactive.Core/Context.cs`](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Context.cs) (Workspace context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interaction["User interaction"]
  node_desktop["Desktop UI"]
  node_console["Console host<br/>[Program.cs]"]
  node_templates["Task templates<br/>[Templates.cs]"]
  node_scheduler["Schedules<br/>[Schedules.cs]"]
end

subgraph group_execution["Agent execution"]
  node_context["Workspace context<br/>[Context.cs]"]
  node_planner["Plan creation<br/>[Planner.cs]"]
  node_orchestrator["Run orchestrator<br/>[Orchestrator.cs]"]
  node_workers["Worker roles<br/>[Workers.cs]"]
  node_permissions["Permission policy<br/>[Permissions.cs]"]
  node_review["Review and criteria"]
  node_runhistory[("Run history<br/>[History.cs]")]
end

subgraph group_models["Models and tools"]
  node_providerconfig["Provider config<br/>[Providers.cs]"]
  node_providerimpl["Model providers"]
  node_tools["Tool registry<br/>[Tools.cs]"]
  node_workspaceops["Workspace tools<br/>[BuiltInTools.cs]"]
end

subgraph group_workspace["Workspace and history"]
  node_artifacts["Artifacts<br/>[Artifacts.cs]"]
  node_stores[("Workspace stores<br/>[RunStoreFactory.cs]")]
end

subgraph group_remote["Remote access"]
  node_gateway["Remote gateway<br/>[Program.cs]"]
  node_remotehost["Remote host<br/>[RemoteRunner.cs]"]
  node_remotecontracts["Remote contracts<br/>[Messages.cs]"]
  node_browser["Browser panel<br/>[app.js]"]
end

node_user(("User"))

node_user -->|"assigns task"| node_desktop
node_user -->|"assigns task"| node_console
node_desktop -.->|"supplies focus"| node_context
node_console -->|"builds context"| node_context
node_templates -.->|"provides task"| node_planner
node_scheduler -.->|"starts runs"| node_console
node_context -->|"informs plan"| node_planner
node_planner -->|"returns plan"| node_orchestrator
node_orchestrator -->|"selects worker"| node_workers
node_orchestrator -->|"routes model"| node_providerconfig
node_providerconfig -->|"configures providers"| node_providerimpl
node_orchestrator -->|"checks access"| node_permissions
node_orchestrator -->|"invokes tools"| node_tools
node_tools -.->|"dispatches calls"| node_workspaceops
node_orchestrator -->|"evaluates result"| node_review
node_review -.->|"assesses evidence"| node_artifacts
node_orchestrator -->|"records outcome"| node_runhistory
node_runhistory -.->|"persists runs"| node_stores
node_browser -->|"sends requests"| node_gateway
node_gateway -.->|"exchanges messages"| node_remotecontracts
node_gateway -->|"forwards tasks"| node_remotehost
node_remotehost -.->|"runs locally"| node_orchestrator

click node_desktop "https://github.com/stasedward/enactive/blob/master/src/Enactive.App.Ui/MainWindow.axaml.cs"
click node_console "https://github.com/stasedward/enactive/blob/master/src/Enactive.App.Console/Program.cs"
click node_templates "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Templates.cs"
click node_scheduler "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Schedules.cs"
click node_context "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Context.cs"
click node_planner "https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/Planner.cs"
click node_orchestrator "https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/Orchestrator.cs"
click node_workers "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Workers.cs"
click node_permissions "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Permissions.cs"
click node_review "https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/EngineCriteriaReview.cs"
click node_runhistory "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/History.cs"
click node_providerconfig "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Providers.cs"
click node_providerimpl "https://github.com/stasedward/enactive/blob/master/src/Enactive.Providers/ChatProviderFactory.cs"
click node_tools "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Tools.cs"
click node_workspaceops "https://github.com/stasedward/enactive/blob/master/src/Enactive.Tools/BuiltInTools.cs"
click node_artifacts "https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Artifacts.cs"
click node_stores "https://github.com/stasedward/enactive/blob/master/src/Enactive.Workspace/RunStoreFactory.cs"
click node_gateway "https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Gateway/Program.cs"
click node_remotehost "https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Host/RemoteRunner.cs"
click node_remotecontracts "https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Contracts/Messages.cs"
click node_browser "https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Gateway/wwwroot/app.js"

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_desktop,node_console,node_templates,node_scheduler,node_user toneBlue
class node_context,node_planner,node_orchestrator,node_workers,node_permissions,node_review,node_runhistory toneAmber
class node_providerconfig,node_providerimpl,node_tools,node_workspaceops toneMint
class node_artifacts,node_stores toneRose
class node_gateway,node_remotehost,node_remotecontracts,node_browser toneIndigo
```

## Components

### User interaction

- [Desktop UI](https://github.com/stasedward/enactive/blob/master/src/Enactive.App.Ui/MainWindow.axaml.cs): `src/Enactive.App.Ui/MainWindow.axaml.cs`
- [Console host](https://github.com/stasedward/enactive/blob/master/src/Enactive.App.Console/Program.cs): `src/Enactive.App.Console/Program.cs`
- [Task templates](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Templates.cs): `src/Enactive.Core/Templates.cs`
- [Schedules](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Schedules.cs): `src/Enactive.Core/Schedules.cs`

### Agent execution

- [Workspace context](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Context.cs): `src/Enactive.Core/Context.cs`
- [Plan creation](https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/Planner.cs): `src/Enactive.Agents/Planner.cs`
- [Run orchestrator](https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/Orchestrator.cs): `src/Enactive.Agents/Orchestrator.cs`
- [Worker roles](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Workers.cs): `src/Enactive.Core/Workers.cs`
- [Permission policy](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Permissions.cs): `src/Enactive.Core/Permissions.cs`
- [Review and criteria](https://github.com/stasedward/enactive/blob/master/src/Enactive.Agents/EngineCriteriaReview.cs): `src/Enactive.Agents/EngineCriteriaReview.cs`
- [Run history](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/History.cs): `src/Enactive.Core/History.cs`

### Models and tools

- [Provider config](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Providers.cs): `src/Enactive.Core/Providers.cs`
- [Model providers](https://github.com/stasedward/enactive/blob/master/src/Enactive.Providers/ChatProviderFactory.cs): `src/Enactive.Providers/ChatProviderFactory.cs`
- [Tool registry](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Tools.cs): `src/Enactive.Core/Tools.cs`
- [Workspace tools](https://github.com/stasedward/enactive/blob/master/src/Enactive.Tools/BuiltInTools.cs): `src/Enactive.Tools/BuiltInTools.cs`

### Workspace and history

- [Artifacts](https://github.com/stasedward/enactive/blob/master/src/Enactive.Core/Artifacts.cs): `src/Enactive.Core/Artifacts.cs`
- [Workspace stores](https://github.com/stasedward/enactive/blob/master/src/Enactive.Workspace/RunStoreFactory.cs): `src/Enactive.Workspace/RunStoreFactory.cs`

### Remote access

- [Remote gateway](https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Gateway/Program.cs): `src/Enactive.Remote.Gateway/Program.cs`
- [Remote host](https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Host/RemoteRunner.cs): `src/Enactive.Remote.Host/RemoteRunner.cs`
- [Remote contracts](https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Contracts/Messages.cs): `src/Enactive.Remote.Contracts/Messages.cs`
- [Browser panel](https://github.com/stasedward/enactive/blob/master/src/Enactive.Remote.Gateway/wwwroot/app.js): `src/Enactive.Remote.Gateway/wwwroot/app.js`

### Other components

- **User**

## Connections

- User → Desktop UI: assigns task
- User → Console host: assigns task
- Desktop UI → Workspace context: supplies focus
- Console host → Workspace context: builds context (evidence: `src/Enactive.App.Console/Program.cs`)
- Task templates → Plan creation: provides task (evidence: `src/Enactive.Agents/Planner.cs`)
- Schedules → Console host: starts runs (evidence: `src/Enactive.App.Console/Program.cs`)
- Workspace context → Plan creation: informs plan (evidence: `src/Enactive.Agents/Planner.cs`)
- Plan creation → Run orchestrator: returns plan (evidence: `src/Enactive.Agents/Orchestrator.cs`)
- Run orchestrator → Worker roles: selects worker (evidence: `src/Enactive.Agents/Orchestrator.cs`)
- Run orchestrator → Provider config: routes model (evidence: `src/Enactive.Agents/Orchestrator.cs`)
- Provider config → Model providers: configures providers (evidence: `src/Enactive.Settings/EngineComposition.cs`)
- Run orchestrator → Permission policy: checks access (evidence: `src/Enactive.Agents/Orchestrator.cs`)
- Run orchestrator → Tool registry: invokes tools (evidence: `src/Enactive.Agents/Orchestrator.cs`)
- Tool registry → Workspace tools: dispatches calls
- Run orchestrator → Review and criteria: evaluates result
- Review and criteria → Artifacts: assesses evidence
- Run orchestrator → Run history: records outcome (evidence: `src/Enactive.Agents/Orchestrator.cs`)
- Run history → Workspace stores: persists runs
- Browser panel → Remote gateway: sends requests (evidence: `src/Enactive.Remote.Gateway/wwwroot/app.js`)
- Remote gateway → Remote contracts: exchanges messages
- Remote gateway → Remote host: forwards tasks
- Remote host → Run orchestrator: runs locally
