Self-improving AI Employees for everyone
Node Logic Flow Documentation
Behavioural contract for every workflow node. One file per node, grouped by category. Keep each card aligned with its plugin and execution path; historical diagrams do not override the current shared execution contract.
How to use
- Adding a node: copy
_TEMPLATE.mdinto the right category folder and name it<type>.md-- the filename stem must equal the registeredtypestring exactly (camelCase or snake_case, whatever the plugin declares) as set on the backend plugin atserver/nodes/<group>/<plugin>/__init__.py. - Refactoring a node: update the matching contract test in
server/tests/nodes/test_<category>.pyfirst, then change the handler, then update this doc. - The index below is generated. Run
company docs nodesafter adding, renaming or removing a card;company docs nodes --checkfails when a registered node has no card. Do not hand-edit between theAUTO-GENERATED-INDEXmarkers.
Conventions
- Mermaid for flow diagrams (renders natively in GitHub & VS Code).
- Tables for inputs/outputs/parameters - greppable, diffable in PRs.
- Cross-link to the existing skill at
server/skills/.../SKILL.mdrather than duplicating tool-mode behaviour. - Keep "Side Effects" honest: every DB write, broadcast, subprocess, and HTTP call must be listed.
Shared execution contract
Cards describe a node's operation. The workflow layer owns cooperative
admission and continuation for new controlled generations
(execution_control_version=1): Stop allows admitted work and result
bookkeeping to finish, then waits; Resume begins the next pending action in
the same execution. Already-admitted parallel tools drain concurrently.
An operation's sleep or approval wait is part of its admitted Activity when
the node runs as an Activity; it is not automatically a control checkpoint.
Legacy cancellation branches in a card describe explicit cancellation or
older execution paths, not the new generation's Stop behavior.
Controlled push triggers are definitions and Signal queues in
WorkflowControlWorkflow; controller polling uses provider fetch Activities,
and cron uses Temporal Schedules plus CronTriggerWorkflow. Separate
listener/poller workflows remain legacy compatibility paths. Stable event
IDs, durable pending-key protection, and Continue-As-New fences apply to the
versioned controller; interactive canvas waiters remain process-local.
Signal acceptance acknowledges receipt into Temporal history, while completed
Updates acknowledge transitions and read-only Queries return status.
Read Workflow control, Node creation, and Event Waiter System for topology, Activity policies, compatibility, producer delivery gaps, and known naming limits. This shared contract applies to all cards below; individual cards call out provider identities and operation-specific stopping boundaries.
Index
For the current browser architecture, see Browser runtime
and Browser workspace. The registered node is
browser; the browserHarness card is retained only as historical migration
documentation. Inclusion in this generated document index does not establish
that a retired node remains registered.
ai_agents
- AI Agent (
aiAgent) - Zeenie (
chatAgent) - Context (
context) - Master Skill (
masterSkill) - Memory (
simpleMemory)
ai_chat_models
- Anthropic Chat Model (
anthropicChatModel) - Cerebras Chat Model (
cerebrasChatModel) - DeepSeek Chat Model (
deepseekChatModel) - Gemini Chat Model (
geminiChatModel) - Groq Chat Model (
groqChatModel) - Kimi Chat Model (
kimiChatModel) - LM Studio Chat Model (
lmstudioChatModel) - Mistral Chat Model (
mistralChatModel) - Ollama Chat Model (
ollamaChatModel) - OpenAI Chat Model (
openaiChatModel) - OpenAI-compatible Chat Model (
openaiCompatibleChatModel) - OpenRouter Chat Model (
openrouterChatModel) - Sarvam AI Chat Model (
sarvamChatModel)
ai_tools
- Agent Builder (
agentBuilder) - Calculator Tool (
calculatorTool) - Canvas (
canvas) - Current Time Tool (
currentTimeTool) - Data (
dataSource) - DuckDuckGo Search (
duckduckgoSearch) - Task Manager (
taskManager) - Vision Analyze (
visionAnalyze) - Write Todos (
writeTodos)
android
- Airplane Mode Control (
airplaneModeControl) - App Launcher (
appLauncher) - App List (
appList) - Audio Automation (
audioAutomation) - Battery Monitor (
batteryMonitor) - Bluetooth Automation (
bluetoothAutomation) - Camera Control (
cameraControl) - Device State (
deviceStateAutomation) - Environmental Sensors (
environmentalSensors) - Location (
location) - Media Control (
mediaControl) - Motion Detection (
motionDetection) - Network Monitor (
networkMonitor) - Screen Control (
screenControlAutomation) - System Info (
systemInfo) - WiFi Automation (
wifiAutomation)
chat_utility
- Chat History (
chatHistory) - Reply in Chat (
chatReply) - Chat Send (
chatSend) - Show UI (
chatUi) - Console (
console) - File Handler (
fileHandler) - Create Map (
gmaps_create) - Geocoding (
gmaps_locations) - Nearby Places (
gmaps_nearby_places) - Team Monitor (
teamMonitor) - Text Generator (
textGenerator)
cli_integrations
- AWS (
awsAction) - Cloudflare (
cloudflareAction) - Google Cloud (
gcloudAction) - GitHub (
githubAction) - Vercel (
vercelAction)
code_fs_process
- File Modify (
fileModify) - File Read (
fileRead) - FS Search (
fsSearch) - Gallery (
gallery) - JavaScript Executor (
javascriptExecutor) - Monty Executor (
montyExecutor) - Process Manager (
processManager) - Python Executor (
pythonExecutor) - Shell (
shell) - TypeScript Executor (
typescriptExecutor)
discord
- Discord API (
discordAction) - Discord Interaction (
discordInteraction) - Discord Receive (
discordReceive) - Discord Send (
discordSend)
document
- Document Parser (
documentParser) - Embedding Generator (
embeddingGenerator) - File Downloader (
fileDownloader) - HTTP Scraper (
httpScraper) - Text Chunker (
textChunker) - Vector Store (
vectorStore)
dodo_payments
google_workspace
- Calendar (
googleCalendar) - Contacts (
googleContacts) - Drive (
googleDrive) - Gmail (
googleGmail) - Gmail Receive (
googleGmailReceive) - Sheets (
googleSheets) - Tasks (
googleTasks)
http_proxy
- HTTP Request (
httpRequest) - Proxy Config (
proxyConfig) - Proxy Request (
proxyRequest) - Proxy Status (
proxyStatus)
language
- Detect Language (
detectLanguage) - Speech to Text (
speechToText) - Text to Speech (
textToSpeech) - Translate (
translateText) - Transliterate (
transliterateText)
microsoft
mobile
search
specialized_agents
- AI Employee (
ai_employee) - Android Control Agent (
android_agent) - Autonomous Agent (
autonomous_agent) - Claude Code Agent (
claude_code_agent) - Codex (
codex_agent) - Coding Agent (
coding_agent) - Consumer Agent (
consumer_agent) - Orchestrator Agent (
orchestrator_agent) - Payments Agent (
payments_agent) - Productivity Agent (
productivity_agent) - RLM Agent (
rlm_agent) - Social Media Agent (
social_agent) - Task Management Agent (
task_agent) - Tool Agent (
tool_agent) - Travel Agent (
travel_agent) - Web Control Agent (
web_agent)
stripe
telegram_social
- Social Receive (
socialReceive) - Social Send (
socialSend) - Telegram Receive (
telegramReceive) - Telegram Send (
telegramSend)
- Twitter Receive (
twitterReceive) - Twitter Search (
twitterSearch) - Twitter Send (
twitterSend) - Twitter User (
twitterUser)
web_automation
- Apify Actor (
apifyActor) - Browser (
browser) - Browser Harness (
browserHarness) — retired - Crawlee Scraper (
crawleeScraper) - TikHub (
tikhubAction)
whatsapp_business
- WhatsApp Business Media (
whatsappBusinessMedia) - WhatsApp Business Receive (
whatsappBusinessReceive) - WhatsApp Business Send (
whatsappBusinessSend) - WhatsApp Business Status (
whatsappBusinessStatus)