How conductor-oss/conductor works
Conductor is a durable workflow and agent execution platform. Users define or update a workflow, start an execution, and inspect or recover its persisted progress; workers and built-in tasks perform the work. The map also preserves the documented agent, scheduling, API, and UI capabilities. Several relationships are documented in the README; source-level edges are limited to relationships visible in sampled excerpts or the SOURCE INDEX, so unsampled wiring is omitted.
Main entry points: AgentService.java Agent lifecycle · ExecutionService.java Execution service · ChatCompleteTaskMapper.java AI workflow tasks · Workflow.java Workflow state
Components 21
Workflow Runtime
- Workflow definitions
common/src/main/java/com/netflix/conductor/common/metadata/workflow/WorkflowDef.java - Execution service
core/src/main/java/com/netflix/conductor/service/ExecutionService.java - Workflow decider
core/src/main/java/com/netflix/conductor/core/execution/DeciderService.java - Workflow state
common/src/main/java/com/netflix/conductor/common/run/Workflow.java - Task state
common/src/main/java/com/netflix/conductor/common/metadata/tasks/Task.java - Workers and tasks
ai/src/main/java/org/conductoross/conductor/ai/tasks/worker/LLMWorkers.java
Agent and AI
- Agent API
agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/controller/AgentController.java - Agent lifecycle
agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/AgentService.java - SDK normalizers
agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/normalizer/NormalizerRegistry.java - Agent compilers
agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/compiler/AgentCompiler.java - AI workflow tasks
ai/src/main/java/org/conductoross/conductor/ai/tasks/mapper/ChatCompleteTaskMapper.java - LLM providers
ai/src/main/java/org/conductoross/conductor/ai/providers/openai/OpenAI.java - MCP tools
ai/src/main/java/org/conductoross/conductor/ai/mcp/MCPService.java - A2A integration
ai/src/main/java/org/conductoross/conductor/ai/a2a/A2AService.java
Operations
- Workflow scheduler
scheduler/core/src/main/java/io/orkes/conductor/scheduler/service/SchedulerService.java - Execution recovery
core/src/main/java/com/netflix/conductor/core/reconciliation/WorkflowRepairService.java - Web UI
ui-next/src/pages/execution/RightPanel/useFullWorkflowQuery.ts
Storage
- External payload storage
common/src/main/java/com/netflix/conductor/common/utils/ExternalPayloadStorage.java - File service
core/src/main/java/org/conductoross/conductor/core/storage/FileStorageService.java - File backend
file-storage/src/main/java/org/conductoross/conductor/filestorage/storage/ConductorFileStorage.java
Other components
- Developer / API user
Connections 18
- Developer / API user → Workflow definitions: defines workflows
README.md - Developer / API user → Execution service: starts executions
README.md - Execution service → Workflow state: runs workflow
core/src/main/java/com/netflix/conductor/service/ExecutionService.java - Workflow decider → Task state: orchestrates tasks
core/src/main/java/com/netflix/conductor/core/execution/DeciderService.java - Workers and tasks → Task state: executes tasks
README.md - Workflow scheduler → Execution service: starts schedules
- Developer / API user → Execution recovery: recovers execution
README.md - Developer / API user → Web UI: inspects execution
README.md - Agent API → Agent lifecycle: routes requests
- Agent lifecycle → SDK normalizers: normalizes configs
agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/AgentService.java - Agent lifecycle → Agent compilers: compiles agents
agentspan/src/main/java/org/conductoross/conductor/ai/agentspan/runtime/service/AgentService.java - Agent compilers → Workflow definitions: creates definitions
- AI workflow tasks → LLM providers: calls providers
- AI workflow tasks → MCP tools: calls tools
README.md - Developer / API user → A2A integration: connects agents
- Workflow state → External payload storage: externalizes payloads
common/src/main/java/com/netflix/conductor/common/utils/ExternalPayloadStorage.java - Developer / API user → File service: uploads files
- File service → File backend: stores content
core/src/main/java/org/conductoross/conductor/core/storage/FileStorageService.java