How synergycodes/workflowbuilder works
Workflow Builder is a white-label workflow editor and durable orchestration stack. A user edits a diagram in the SDK or AI Studio, saves it through the backend, starts a run, and observes its events; human-decision steps can suspend execution until a person responds. The backend coordinates versions, runs, and decisions with Temporal, while a worker executes node types and records run state. The repository also includes an MCP documentation and API-symbol service. Unsampled subsystem links are included only where the README documents them; paths identify the supported implementation areas.
Main entry points: src/server.ts Backend HTTP API · app.tsx AI Studio app · src/server.ts MCP tool server · worker.ts Execution worker
Components 20
Workflow editing and observation
- Editor SDK
packages/sdk/src/features - AI Studio app
apps/ai-studio/src/app/app.tsx - Open workflow or run
apps/ai-studio/src/app/open-from-url.ts - Live run view
apps/ai-studio/src/components/execution/log-panel.tsx - Decision controls
apps/ai-studio/src/components/human-decision
Execution backend
- Backend HTTP API
apps/backend/src/server.ts - Workflow routes
apps/backend/src/routes/workflows.ts - Execution and decision routes
apps/backend/src/routes/executions.ts - Visualization routes
apps/backend/src/routes/visualize.ts - Postgres state
apps/backend/src/db/schema.ts
Temporal runtime
- Temporal plugin engine
packages/temporal/src/plugin.ts - Temporal service
- Execution worker
apps/execution-worker/src/engines/temporal/worker.ts - Node executors
apps/execution-worker/src/executors - Run event persistence
apps/execution-worker/src/database.ts
MCP documentation service
- MCP tool server
packages/mcp-server/src/server.ts - Documentation tools
packages/mcp-server/src/tools - Symbol tools
packages/mcp-server/src/symbols - Docs and symbol corpus
packages/mcp-server/src/corpus/build-corpus.ts
Other components
- Workflow user
Connections 25
- Workflow user → AI Studio app: edits workflows
- Workflow user → Editor SDK: uses editor
- AI Studio app → Editor SDK: embeds
apps/ai-studio/src/app/app.tsx - AI Studio app → Live run view: shows run state
apps/ai-studio/src/app/app.tsx - AI Studio app → Decision controls: renders decisions
apps/ai-studio/src/app/app.tsx - Open workflow or run → Backend HTTP API: fetches snapshots
apps/ai-studio/src/app/open-from-url.ts - Workflow user → Decision controls: submits verdict
- Editor SDK → Backend HTTP API: sends workflow JSON
- Backend HTTP API → Workflow routes: routes requests
apps/backend/src/server.ts - Backend HTTP API → Execution and decision routes: routes requests
apps/backend/src/server.ts - Backend HTTP API → Visualization routes: routes requests
apps/backend/src/server.ts - Backend HTTP API → Postgres state: persists state
- Backend HTTP API → Temporal plugin engine: starts and controls runs
- Backend HTTP API → Temporal service: delivers decisions
- Temporal service → Execution worker: dispatches activities
- Execution worker → Node executors: registers node handlers
apps/execution-worker/src/engines/temporal/worker.ts - Execution worker → Run event persistence: writes events
apps/execution-worker/src/engines/temporal/worker.ts - Run event persistence → Live run view: streams run events
- Backend HTTP API → Decision controls: accepts decisions
- Backend HTTP API → Visualization routes: adapts visualizations
apps/backend/src/server.ts - MCP tool server → Documentation tools: registers handlers
packages/mcp-server/src/server.ts - MCP tool server → Symbol tools: registers handlers
packages/mcp-server/src/server.ts - MCP tool server → Docs and symbol corpus: serves corpus
packages/mcp-server/src/server.ts - Documentation tools → Docs and symbol corpus: searches docs
packages/mcp-server/src/tools/get-doc/handler.ts - Symbol tools → Docs and symbol corpus: resolves symbols