How alikon-art/determinflow works
DeterminFlow is a production AI workflow runtime with a web console. A user or API caller configures a versioned workflow, starts a task, and the runtime executes nodes with isolated agent sessions, validation, retries, and recovery while reporting state and usage. The README also documents chat, scheduled automation, extensions, skills/rules, memory, and marketplace/account capabilities, so these remain visible as distinct branches. Some subsystem connections are documented only at product level; edges use README evidence where source wiring was not sampled.
Main entry points: engine.py Execution Engine · session_manager.py Agent Sessions · manager.py Task Manager · workflow_routes.py Workflow API
Components 24
Workflow Runtime
- Workflow Definition
src/workflow/definition.py - Task Manager
src/workflow/manager.py - Execution Engine
src/workflow/engine.py - Node Types
src/workflow/nodes - Output Validation
src/workflow/output_validation.py - Task Checkpoints
src/workflow/task_persistence.py - Executor Processes
src/workflow
Agent Runtime
- Agent Sessions
src/agent/session_manager.py - Agent Definitions
src/agent/definition.py - LLM Client
src/core/llm_client.py - Model Providers
src/core/model_manager.py - Prompt Manager
src/prompts/manager.py
Console and Events
- Workflow Editor
web/src/components/workflow/WorkflowCanvas.tsx - Workflow API
src/web/workflow_routes.py - REST API
src/web/api_routes.py - WebSocket Events
src/web/event_bus.py
Extensions and Resources
- Extension Host
src/extension_host/manager.py - Skills
src/skills/manager.py - Rules
src/rules/manager.py - Memory
src/memory/service.py - Skill Marketplace
src/skill_marketplace/routes.py
Automation and Accounts
- Cron Automation
src/cron - Unified Account
src/account/routes.py
Other components
- User / API
Connections 25
- User / API → Workflow Editor: configures
- Workflow Editor → Workflow API: submits workflow
- User / API → Workflow API: starts task
- Workflow API → Workflow Definition: loads definition
src/web/workflow_routes.py - Task Manager → Workflow Definition: uses definition
src/workflow/manager.py - Task Manager → Execution Engine: dispatches task
src/workflow/manager.py - Execution Engine → Workflow Definition: reads definition
src/workflow/engine.py - Execution Engine → Node Types: dispatches nodes
src/workflow/engine.py - Execution Engine → Agent Sessions: runs agent nodes
src/workflow/engine.py - Execution Engine → Output Validation: validates output
- Execution Engine → Task Checkpoints: saves checkpoints
src/workflow/engine.py - Execution Engine → WebSocket Events: publishes status
src/workflow/engine.py - Agent Sessions → Agent Definitions: applies permissions
src/agent/session_manager.py - Agent Sessions → LLM Client: requests completions
src/agent/session_manager.py - LLM Client → Model Providers: resolves provider
src/core/llm_client.py - Agent Sessions → Prompt Manager: builds prompts
src/agent/session_manager.py - User / API → REST API: uses console API
- REST API → WebSocket Events: streams events
src/web/api_routes.py - Extension Host → Skills: registers resources
src/extension_host/manager.py - Extension Host → Rules: registers resources
src/extension_host/manager.py - User / API → Skill Marketplace: browses resources
- Skill Marketplace → Unified Account: uses account portal
src/skill_marketplace/routes.py - Agent Sessions → Memory: uses memory
- User / API → Cron Automation: schedules automation
- Task Manager → Executor Processes: dispatches detached tasks
src/workflow/manager.py