How stasedward/enactive works
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: Orchestrator.cs Run orchestrator · Enactive.Remote.Gateway/Program.cs Remote gateway · Enactive.App.Console/Program.cs Console host · Context.cs Workspace context
Components 22
User interaction
- Desktop UI
src/Enactive.App.Ui/MainWindow.axaml.cs - Console host
src/Enactive.App.Console/Program.cs - Task templates
src/Enactive.Core/Templates.cs - Schedules
src/Enactive.Core/Schedules.cs
Agent execution
- Workspace context
src/Enactive.Core/Context.cs - Plan creation
src/Enactive.Agents/Planner.cs - Run orchestrator
src/Enactive.Agents/Orchestrator.cs - Worker roles
src/Enactive.Core/Workers.cs - Permission policy
src/Enactive.Core/Permissions.cs - Review and criteria
src/Enactive.Agents/EngineCriteriaReview.cs - Run history
src/Enactive.Core/History.cs
Models and tools
- Provider config
src/Enactive.Core/Providers.cs - Model providers
src/Enactive.Providers/ChatProviderFactory.cs - Tool registry
src/Enactive.Core/Tools.cs - Workspace tools
src/Enactive.Tools/BuiltInTools.cs
Workspace and history
- Artifacts
src/Enactive.Core/Artifacts.cs - Workspace stores
src/Enactive.Workspace/RunStoreFactory.cs
Remote access
- Remote gateway
src/Enactive.Remote.Gateway/Program.cs - Remote host
src/Enactive.Remote.Host/RemoteRunner.cs - Remote contracts
src/Enactive.Remote.Contracts/Messages.cs - Browser panel
src/Enactive.Remote.Gateway/wwwroot/app.js
Other components
- User
Connections 22
- User → Desktop UI: assigns task
- User → Console host: assigns task
- Desktop UI → Workspace context: supplies focus
- Console host → Workspace context: builds context
src/Enactive.App.Console/Program.cs - Task templates → Plan creation: provides task
src/Enactive.Agents/Planner.cs - Schedules → Console host: starts runs
src/Enactive.App.Console/Program.cs - Workspace context → Plan creation: informs plan
src/Enactive.Agents/Planner.cs - Plan creation → Run orchestrator: returns plan
src/Enactive.Agents/Orchestrator.cs - Run orchestrator → Worker roles: selects worker
src/Enactive.Agents/Orchestrator.cs - Run orchestrator → Provider config: routes model
src/Enactive.Agents/Orchestrator.cs - Provider config → Model providers: configures providers
src/Enactive.Settings/EngineComposition.cs - Run orchestrator → Permission policy: checks access
src/Enactive.Agents/Orchestrator.cs - Run orchestrator → Tool registry: invokes tools
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
src/Enactive.Agents/Orchestrator.cs - Run history → Workspace stores: persists runs
- Browser panel → Remote gateway: sends requests
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