How hexabot-ai/hexabot works
Hexabot is an AI-enabled automation platform for authoring and running workflows across conversational channels. The principal path is workflow authoring in the visual/YAML editor, workflow management through the API, then agentic execution using actions and bindings; channel events and integrations provide conversational inputs and outputs. Major documented capabilities also include memory, MCP, and RAG. Source excerpts show selected API, editor, and RAG calls; README statements support the broader product relationships, while unsampled runtime details are not expanded.
Main entry points: workflow-runner.ts Workflow runner · workflow.controller.ts Workflow API · step-executors Step executors · Handler.ts Channel ingress and dispatch
Components 24
Workflow authoring
- Visual workflow editor
packages/frontend/src/components/visual-editor/v4/components/main/ActionDrawer/ActionFormDrawer/useActionFormDrawerController.ts - YAML editor
packages/frontend/src/components/visual-editor/v4/components/yaml-editor/useYamlEditorController.ts - Workflow graph
packages/graph/src/workflow/types/workflow-node.types.ts - Workflow API
packages/api/src/workflow/controllers/workflow.controller.ts - Workflow definitions
packages/api/src/workflow
Workflow runtime
- Workflow runner
packages/agentic/src/workflow-runner.ts - Workflow compiler
packages/agentic/src/workflow-compiler.ts - Step executors
packages/agentic/src/step-executors - Execution context
packages/agentic/src/context.ts - Action registry
packages/api/src/actions/actions.service.ts - Runtime bindings
packages/api/src/bindings/runtime-bindings.service.ts
Conversation channels
- Channel ingress and dispatch
packages/api/src/channel/lib/Handler.ts - Channel event decoding
packages/api/src/channel/lib/inbound-events/channel-inbound-event-decoder.ts - Web channel
packages/api/src/extensions/channels/web/index.channel.ts - Messaging actions
packages/api/src/extensions/actions/messaging/message-action.base.ts
AI and integrations
- AI actions
packages/api/src/extensions/actions/ai/ai-base.action.ts - Memory integration
packages/api/src/extensions/actions/memory/update-memory.action.ts - MCP tools
packages/api/src/mcp/tools/hexabot-mcp.tools.ts - RAG content retrieval
packages/api/src/cms/services/rag.service.ts
Platform services
- CMS content
packages/api/src/cms/services/content.service.ts - Content records
packages/api/src/cms/entities/content.entity.ts - Users and permissions
packages/api/src/user/services/user.service.ts - Integration health
packages/api/src/health/health.service.ts
Other components
- Workflow operator
Connections 26
- Workflow operator → Visual workflow editor: authors
- Workflow operator → YAML editor: edits definitions
- Visual workflow editor → Workflow graph: visualizes
- YAML editor → Visual workflow editor: updates definition
packages/frontend/src/components/visual-editor/v4/components/yaml-editor/useYamlEditorController.ts - Visual workflow editor → Workflow API: manages workflows
- Workflow API → Workflow definitions: manages
packages/api/src/workflow/controllers/workflow.controller.ts - Workflow API → Runtime bindings: resolves bindings
packages/api/src/workflow/controllers/workflow.controller.ts - Workflow API → Workflow runner: starts execution
- Workflow runner → Workflow compiler: compiles definition
- Workflow runner → Step executors: dispatches steps
- Step executors → Execution context: uses context
- Step executors → Action registry: runs actions
- Step executors → Runtime bindings: uses bindings
- Workflow operator → Channel ingress and dispatch: sends messages
- Channel ingress and dispatch → Channel event decoding: decodes events
- Channel ingress and dispatch → Web channel: supports channel
- Channel ingress and dispatch → Workflow runner: triggers workflows
- Workflow runner → Messaging actions: dispatches actions
- Workflow runner → AI actions: dispatches actions
- Workflow runner → Memory integration: uses memory
- Workflow runner → MCP tools: uses MCP tools
- Workflow runner → RAG content retrieval: retrieves content
- RAG content retrieval → CMS content: uses content service
packages/api/src/cms/services/rag.service.ts - RAG content retrieval → Content records: indexes content
packages/api/src/cms/services/rag.service.ts - Workflow API → Users and permissions: checks access
- Workflow operator → Integration health: checks integrations