Skip to content

Self-improving AI Employees for everyone

docs: cross-corpus consistency sweep (provider/agent/node counts, CONTRIBUTING refresh)

trohitg5b384b7498a7
diff --git a/CLAUDE.md b/CLAUDE.md
index 15adf1f0..ebdfec73 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -41,7 +41,7 @@ This is a React Flow-based workflow automation platform implementing n8n-inspire
| **[Onboarding Service](./docs-internal/onboarding.md)** | First-launch welcome wizard with 5 steps, database persistence, and replay from Settings |
| **[CLI Services Integration](./docs-internal/cli_services_integration.md)** | Guide for integrating CLI-based services (Temporal, etc.) with proper lifecycle management |
| **[Temporal Architecture](./docs-internal/TEMPORAL_ARCHITECTURE.md)** | Distributed workflow execution: activities, FIRST_COMPLETED scheduling, horizontal scaling |
-| **[Native LLM SDK](./docs-internal/native_llm_sdk.md)** | Native SDK layer in services/llm/: Protocol-based providers, config-driven base URLs, 10 providers, native vs LangChain path routing |
+| **[Native LLM SDK](./docs-internal/native_llm_sdk.md)** | Native SDK layer in services/llm/: Protocol-based providers, config-driven base URLs, 12 providers (xai native-chat-only; ollama/lmstudio local servers), native vs LangChain path routing |
| **[Event Waiter System](./docs-internal/event_waiter_system.md)** | Generic asyncio.Future/Redis-Streams waiter for push-based trigger nodes (WhatsApp, Telegram, Webhook, Chat, Task completion) |
| **[Credentials Encryption](./docs-internal/credentials_encryption.md)** | Fernet + PBKDF2 encryption pipeline, separate credentials.db, two credential systems (OAuth vs API keys), multi-backend abstraction |
| **[Status Broadcaster](./docs-internal/status_broadcaster.md)** | WebSocket-first communication: StatusBroadcaster singleton, live count via `len(MESSAGE_HANDLERS) + len(get_ws_handlers())`, broadcast message types, Android two-state model |
@@ -610,7 +610,7 @@ The project uses WebSocket as the primary communication method between frontend
### Node Catalogue (collapsed)
-> The authoritative, per-node reference is the backend plugin registry plus the per-node "logic-flow" cards under [docs-internal/node-logic-flows/](./docs-internal/node-logic-flows/) (one card per node, grouped by category, with handles / params / outputs / side-effects / edge-cases). Live node list = glob `server/nodes/**/__init__.py` (~138 today); live total via `pytest --collect-only`. Do NOT maintain a per-node catalogue here — it drifts on every plugin add.
+> The authoritative, per-node reference is the backend plugin registry plus the per-node "logic-flow" cards under [docs-internal/node-logic-flows/](./docs-internal/node-logic-flows/) (one card per node, grouped by category, with handles / params / outputs / side-effects / edge-cases). Live node list = the plugin registry (one folder per node under `server/nodes/<group>/`, ~118 node types today; a bare `__init__.py` glob also counts the 26 group packages); live total via `pytest --collect-only`. Do NOT maintain a per-node catalogue here — it drifts on every plugin add.
Node groups (palette categories): agent, model, skill, tool, trigger, workflow, search, google, android, whatsapp, telegram, twitter, social, email, proxy, chat, scheduler, text, code, document, location, utility, browser, scraper, filesystem, stripe. See [docs-internal/node-logic-flows/](./docs-internal/node-logic-flows/) for the card index.
@@ -646,7 +646,7 @@ Node groups (palette categories): agent, model, skill, tool, trigger, workflow,
- `GET /webhook/` - Webhook endpoint info and usage documentation
#### Workflow Services (`server/services/workflow.py`)
-- Node execution dispatches every registered plugin via the `BaseNode` registry (authoritative count = glob `server/nodes/**/__init__.py`, ~138 node files today; live total via `pytest --collect-only`)
+- Node execution dispatches every registered plugin via the `BaseNode` registry (one self-contained folder per node under `server/nodes/<group>/`; ~118 node types today — a bare `__init__.py` glob overcounts by also matching the 26 group packages; live total via `pytest --collect-only`)
- Parameter resolution and template variable substitution
- Result formatting and error handling
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 0069b066..d74127db 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -17,11 +17,11 @@ See [SETUP.md](docs-internal/SETUP.md) for environment setup and [SCRIPTS.md](do
At a glance:
-- **106 workflow nodes** across 25 categories (AI, agents, social, Android, Google Workspace, email, browser, documents, code, proxies, utilities)
-- **10 LLM providers** via a hybrid native SDK + LangChain architecture
+- **~118 workflow nodes** across 26 categories (AI, agents, social, Android, Google Workspace, email, browser, documents, code, proxies, utilities; one self-contained plugin folder per node under `server/nodes/<group>/`)
+- **12 LLM providers** via a hybrid native SDK + LangChain architecture (11 chat-model nodes; xAI native-chat-only)
- **16 specialized AI agents** with the Agent Teams delegation pattern
-- **127 WebSocket handlers** replacing most REST endpoints
-- **55 built-in skills** across 10 categories, editable in-UI with SKILL.md defaults on disk
+- **WebSocket-first API** replacing most REST endpoints (live handler count = `MESSAGE_HANDLERS` + plugin registries)
+- **63 built-in skills** across 12 categories, editable in-UI with SKILL.md defaults on disk
- **Three execution modes** with automatic fallback: Temporal distributed, Redis parallel, sequential
## How Workflows Execute
@@ -36,7 +36,7 @@ Deep dives: [DESIGN.md](docs-internal/DESIGN.md) - [TEMPORAL_ARCHITECTURE.md](do
[![AI Agent Routing](docs/diagrams/ai-agent-routing.svg)](https://raw.githubusercontent.com/zeenie-ai/MachinaOS/main/docs/diagrams/ai-agent-routing.svg)
-AI execution splits into two paths. `execute_chat()` for direct chat completions prefers the native SDK layer in [services/llm/](server/services/llm/) (10 providers, lazy imports, normalized `LLMResponse`), falling back to LangChain for Groq and Cerebras. `execute_agent()` and `execute_chat_agent()` build a LangChain chat model (`ChatOpenAI` / `ChatAnthropic` / etc.) and drive it through `_run_agent_loop` — a plain async `for iteration in range(max):` that calls `chat_model.ainvoke`, dispatches any `tool_calls`, appends `ToolMessage` results, and loops. Team leads (`orchestrator_agent`, `ai_employee`) auto-inject `delegate_to_<type>` tools for every agent connected to their `input-teammates` handle. The RLM Agent uses a REPL-based recursive language model pattern. Long-running activities (browser automation, claude_code_agent) stay alive across Temporal's 2-minute heartbeat window via per-message `activity.heartbeat()` calls in the WebSocket read loop.
+AI execution splits into two paths. `execute_chat()` for direct chat completions prefers the native SDK layer in [services/llm/](server/services/llm/) (12 providers, lazy imports, normalized `LLMResponse`), falling back to LangChain for Groq and Cerebras. `execute_agent()` and `execute_chat_agent()` build a LangChain chat model (`ChatOpenAI` / `ChatAnthropic` / etc.) and drive it through `_run_agent_loop` — a plain async `for iteration in range(max):` that calls `chat_model.ainvoke`, dispatches any `tool_calls`, appends `ToolMessage` results, and loops. Team leads (`orchestrator_agent`, `ai_employee`) auto-inject `delegate_to_<type>` tools for every agent connected to their `input-teammates` handle. The RLM Agent uses a REPL-based recursive language model pattern. Long-running activities (browser automation, claude_code_agent) stay alive across Temporal's 2-minute heartbeat window via per-message `activity.heartbeat()` calls in the WebSocket read loop.
Deep dives: [agent_architecture.md](docs-internal/agent_architecture.md) - [native_llm_sdk.md](docs-internal/native_llm_sdk.md) - [agent_teams.md](docs-internal/agent_teams.md) - [memory_compaction.md](docs-internal/memory_compaction.md)
@@ -44,18 +44,18 @@ Deep dives: [agent_architecture.md](docs-internal/agent_architecture.md) - [nati
| Directory | What lives here | Start reading |
|---|---|---|
-| `server/nodes/<category>/<node>.py` | Workflow node plugins (NodeSpec + execute) — backend SSOT since Wave 11 | [plugin_system.md](docs-internal/plugin_system.md), [server/nodes/README.md](server/nodes/README.md) |
+| `server/nodes/<category>/<node>/__init__.py` | Workflow node plugins (self-contained folders, NodeSpec + execute) — backend SSOT since Wave 11 | [plugin_system.md](docs-internal/plugin_system.md), [server/nodes/README.md](server/nodes/README.md) |
| `client/src/components/` | React Flow canvas, parameter panel, modals | [CLAUDE.md](CLAUDE.md) |
| `server/services/` | WorkflowService, NodeExecutor, AI service | [DESIGN.md](docs-internal/DESIGN.md) |
-| `server/services/handlers/` | One handler per node type (dispatch targets) | [node_creation.md](docs-internal/node_creation.md) |
-| `server/services/llm/` | Native LLM SDK layer (10 providers) | [native_llm_sdk.md](docs-internal/native_llm_sdk.md) |
+| `server/services/handlers/` | Cross-cutting orchestration only (`tools.py` AI-tool dispatch + delegation, `triggers.py`, `todo.py`) — per-node handlers live inside the plugins since Wave 11 | [node_creation.md](docs-internal/node_creation.md) |
+| `server/services/llm/` | Native LLM SDK layer (12 providers) | [native_llm_sdk.md](docs-internal/native_llm_sdk.md) |
| `server/services/execution/` | Decide pattern, DLQ, recovery, conditions | [DESIGN.md](docs-internal/DESIGN.md) |
| `server/services/temporal/` | Distributed execution via Temporal | [TEMPORAL_ARCHITECTURE.md](docs-internal/TEMPORAL_ARCHITECTURE.md) |
-| `server/routers/websocket.py` | 127 WebSocket handlers | [status_broadcaster.md](docs-internal/status_broadcaster.md) |
+| `server/routers/websocket.py` | WebSocket endpoint + core `MESSAGE_HANDLERS` (plugins register more via `ws_handler_registry`) | [status_broadcaster.md](docs-internal/status_broadcaster.md) |
| `server/core/` | Cache, encryption, DI container, config | [credentials_encryption.md](docs-internal/credentials_encryption.md) |
-| `server/skills/` | 55 skill SKILL.md files across 10 folders | [GUIDE.md](server/skills/GUIDE.md) |
+| `server/skills/` | 63 skill SKILL.md files across 12 folders | [GUIDE.md](server/skills/GUIDE.md) |
| `server/config/` | llm_defaults.json, pricing.json, model_registry.json, email_providers.json, google_apis.json | [pricing_service.md](docs-internal/pricing_service.md) |
-| `docs-internal/` | In-repo architecture deep dives (30 files) | Index below |
+| `docs-internal/` | In-repo architecture deep dives (50+ files) | Index below |
## How to Contribute Features
@@ -64,14 +64,14 @@ Deep dives: [agent_architecture.md](docs-internal/agent_architecture.md) - [nati
The diagram above shows the full lifecycle of a workflow node from TypeScript definition to Python handler. Use these recipes as a starting point:
**Add a workflow node**
-- Author a plugin: `server/nodes/<category>/<node>.py` — subclasses `BaseNode`, declares `NodeSpec` + `execute`
+- Author a plugin folder: `server/nodes/<category>/<node>/__init__.py` — subclasses `BaseNode` (or `ActionNode` / `TriggerNode` / `ToolNode`), declares Pydantic `Params`/`Output` + `@Operation` methods; auto-registers on import
- Add a contract test: `server/tests/nodes/test_<category>.py`
- Guide: [plugin_system.md](docs-internal/plugin_system.md) + [server/nodes/README.md](server/nodes/README.md)
**Add an LLM provider**
- OpenAI-compatible (DeepSeek, Kimi, Mistral pattern): config-only in `server/config/llm_defaults.json`
- Custom-SDK provider: new file in `server/services/llm/providers/`, branch in `factory.py`
-- Backend plugin: `server/nodes/model/<provider>_chat_model.py`
+- Backend plugin: `server/nodes/model/<provider>_chat_model/__init__.py`
- Guide: [native_llm_sdk.md](docs-internal/native_llm_sdk.md)
**Add a dual-purpose tool (workflow node + AI tool)**
@@ -81,7 +81,7 @@ The diagram above shows the full lifecycle of a workflow node from TypeScript de
**Add a specialized AI agent**
- Add the plugin under `server/nodes/agent/<name>/` (extends `SpecializedAgentBase` from `server/nodes/agent/_specialized.py`)
-- Add to `SPECIALIZED_AGENT_TYPES` in `server/constants.py`
+- Add the agent's `type` string to `AI_AGENT_TYPES` in `server/constants.py` and to the delegation-check tuple in `server/services/handlers/tools.py::execute_tool()` so parent agents' `delegate_to_*` tools find it (both flagged as tech debt)
- Guide: [node_creation.md](docs-internal/node_creation.md)
**Add a skill**
@@ -90,10 +90,10 @@ The diagram above shows the full lifecycle of a workflow node from TypeScript de
- Guide: [GUIDE.md](server/skills/GUIDE.md)
**Add an event-based trigger**
-- Register in `TRIGGER_REGISTRY` in `server/services/event_waiter.py`
-- Add a filter builder in the same file
-- Frontend node with `group: ['category', 'trigger']`
-- Guide: [event_waiter_system.md](docs-internal/event_waiter_system.md)
+- Author a `TriggerNode` plugin under `server/nodes/<category>/<name>/`
+- Canary path (Wave 12, preferred): `register_canary_trigger_type(node_type, cloudevent_type)` + emit `WorkflowEvent`s via `dispatch.emit` from the plugin's `_events.py`
+- Legacy path (non-canary types only): register in `TRIGGER_REGISTRY` + add a filter builder in `server/services/event_waiter.py`
+- Guides: [event_framework.md](docs-internal/event_framework.md), [node_creation.md](docs-internal/node_creation.md), [event_waiter_system.md](docs-internal/event_waiter_system.md) (legacy)
**Integrate a new external service with OAuth**
- Reference implementation: Google Workspace (7 nodes sharing one OAuth connection)
@@ -109,7 +109,7 @@ pnpm run dev # start frontend + backend + Temporal + WhatsApp
pnpm run stop # stop everything
pnpm run build # production build
pnpm exec tsc --noEmit # typecheck client (from client/)
-python -m pytest # run backend tests (from server/)
+uv run pytest # run backend tests (from server/, uv-managed venv)
```
Full setup and scripts reference: [SETUP.md](docs-internal/SETUP.md) - [SCRIPTS.md](docs-internal/SCRIPTS.md)
@@ -120,7 +120,7 @@ Full setup and scripts reference: [SETUP.md](docs-internal/SETUP.md) - [SCRIPTS.
|---|---|
| [DESIGN.md](docs-internal/DESIGN.md) | Execution engine architecture, design patterns, execution modes |
| [TEMPORAL_ARCHITECTURE.md](docs-internal/TEMPORAL_ARCHITECTURE.md) | Distributed execution via Temporal activities |
-| [workflow-schema.md](docs-internal/workflow-schema.md) | Workflow JSON schema and full node catalog (106 nodes) |
+| [workflow-schema.md](docs-internal/workflow-schema.md) | Workflow JSON schema and node catalog (live count = glob `server/nodes/**/__init__.py`) |
| [ROADMAP.md](docs-internal/ROADMAP.md) | Implementation status and completed phases |
| [SETUP.md](docs-internal/SETUP.md) | Development environment setup |
| [SCRIPTS.md](docs-internal/SCRIPTS.md) | npm/shell scripts reference |
diff --git a/docs-internal/TEMPORAL_ARCHITECTURE.md b/docs-internal/TEMPORAL_ARCHITECTURE.md
index 2f19017a..86e5140a 100644
--- a/docs-internal/TEMPORAL_ARCHITECTURE.md
+++ b/docs-internal/TEMPORAL_ARCHITECTURE.md
@@ -307,7 +307,7 @@ Per-queue defaults (concurrency caps in `services/temporal/worker.py:TemporalWor
### Agent-as-child-workflow (F4.B)
-When `TEMPORAL_AGENT_WORKFLOW_ENABLED=true` and the node type is in the migrating set (`aiAgent` / `chatAgent` / 12 specialized agents / 2 team leads), the orchestrator schedules `AgentWorkflow` as a child workflow instead of an activity. Inside the workflow:
+When `TEMPORAL_AGENT_WORKFLOW_ENABLED=true` and the node type is in the migrating set (`aiAgent` / `chatAgent` / 11 specialized agents / 2 team leads), the orchestrator schedules `AgentWorkflow` as a child workflow instead of an activity. Inside the workflow:
```
AgentWorkflow.run(context):
diff --git a/docs-internal/native_llm_sdk.md b/docs-internal/native_llm_sdk.md
index cfc61f91..5df3c19c 100644
--- a/docs-internal/native_llm_sdk.md
+++ b/docs-internal/native_llm_sdk.md
@@ -54,7 +54,7 @@ Source of truth for this list: `server/config/llm_defaults.json` (the `providers
### Native chat path vs agent dropdown — two different counts
-- **Native chat path (`execute_chat` / `fetch_models`) supports 12 providers** (the 10 OpenAI-compat + Anthropic/Gemini natives above; Groq/Cerebras fall back to LangChain inside `execute_chat`). `xai` lives here.
+- **Native chat path (`execute_chat` / `fetch_models`) supports 12 providers** — 10 truly native (8 via the shared OpenAI-compatible client: openai, openrouter, xai, deepseek, kimi, mistral, ollama, lmstudio; plus the Anthropic/Gemini native SDKs); Groq/Cerebras fall back to LangChain inside `execute_chat`. `xai` lives here.
- **The agent dropdown exposes 11 providers** for `aiAgent`, `chatAgent` (Zeenie), and all specialized agents — the `provider` Literal in [`nodes/agent/ai_agent/__init__.py`](../server/nodes/agent/ai_agent/__init__.py), [`chat_agent.py`](../server/nodes/agent/chat_agent/__init__.py), and [`_specialized.py`](../server/nodes/agent/_specialized.py): `openai`, `anthropic`, `gemini`, `openrouter`, `groq`, `cerebras`, `deepseek`, `kimi`, `mistral`, `ollama`, `lmstudio`. **`xai` is native-chat-only and is NOT in the agent Literal** (no agent dropdown entry).
- Groq and Cerebras are available as standalone chat-model nodes AND in the agent dropdown, but use the LangChain path for both chat and agent execution.
diff --git a/docs-internal/node-logic-flows/ai_agents/chatAgent.md b/docs-internal/node-logic-flows/ai_agents/chatAgent.md
index 99e8a85b..34b4bbc5 100644
--- a/docs-internal/node-logic-flows/ai_agents/chatAgent.md
+++ b/docs-internal/node-logic-flows/ai_agents/chatAgent.md
@@ -118,7 +118,7 @@ flowchart TD
- **Specialized agents inherit every quirk**: any bug in `prepare_agent_call`
or `execute_chat_agent` (e.g. the blanket tool-strip on task completion)
- affects all 13 specialized node types plus the two team leads.
+ affects all 13 `SpecializedAgentBase` subclasses (11 domain agents + the 2 team leads).
- **Team-lead teammates are appended after existing tools**: if a parent
wires both regular tool nodes and teammates, tool order depends on edge
scan order (not stable across clients).
diff --git a/docs-internal/node-logic-flows/ai_chat_models/openrouterChatModel.md b/docs-internal/node-logic-flows/ai_chat_models/openrouterChatModel.md
index 6eb02bef..83e7731d 100644
--- a/docs-internal/node-logic-flows/ai_chat_models/openrouterChatModel.md
+++ b/docs-internal/node-logic-flows/ai_chat_models/openrouterChatModel.md
@@ -103,7 +103,7 @@ flowchart TD
- **200+ models, varying capabilities**: thinking support, context windows, temperature ranges, and pricing all vary per routed model. The handler applies generic clamps; mismatches surface as envelope errors from the downstream provider (e.g. "This model does not support the reasoning parameter").
- **`[FREE] ` models are OpenRouter-free but may still cost latency**: routing can queue against capacity.
-- **`owner/model` prefix is load-bearing**: removing it breaks routing. Unique among the 9 chat models.
+- **`owner/model` prefix is load-bearing**: removing it breaks routing. Unique among the 11 chat-model nodes.
- **Errors swallowed into envelope**.
## Related
diff --git a/docs-internal/plugin_system.md b/docs-internal/plugin_system.md
index 261b17d1..76822e89 100644
--- a/docs-internal/plugin_system.md
+++ b/docs-internal/plugin_system.md
@@ -358,22 +358,22 @@ on a plugin resolves to a registered class.
| `nodes/twitter/_credentials.py` | `TwitterCredential` | oauth2 | twitterSend / twitterSearch / twitterUser / twitterReceive |
| `nodes/telegram/_credentials.py` | `TelegramCredential` | api_key | telegramSend / telegramReceive |
| `nodes/scraper/_credentials.py` | `ApifyCredential` | api_key (bearer) | apifyActor |
-| `nodes/model/_credentials.py` | `OpenAI / Anthropic / Gemini / OpenRouter / Groq / Cerebras / DeepSeek / Kimi / Mistral / Xai` | api_key | 9 chat models (xAI reserved) |
+| `nodes/model/_credentials.py` | `OpenAI / Anthropic / Gemini / OpenRouter / Groq / Cerebras / DeepSeek / Kimi / Mistral / Xai / Ollama / LMStudio` | api_key | 11 chat-model nodes (Ollama / LM Studio store a local server URL; the Xai credential is native-chat-only — no node) |
| `nodes/search/*.py` (inline) | `BraveSearch / Serper / Perplexity` | api_key | single-use search nodes |
`GoogleCredential` exposes a `build_credentials()` classmethod that
returns a `google.oauth2.credentials.Credentials` — hand-off to
`googleapiclient.discovery.build(...)` is unchanged from Wave 11.D.4.
-Agents (aiAgent / chatAgent / 13 specialized) stay `credentials = ()`
+Agents (aiAgent / chatAgent / the 13 `SpecializedAgentBase` subclasses) stay `credentials = ()`
because they are poly-provider — the user picks the provider at
runtime via `params.provider`, so declaring any single credential
would be misleading.
### Shared agent helpers
-Every agent plugin (ai_agent, chat_agent, 13 specialized agents, team
-leads) calls one helper:
+Every agent plugin (ai_agent, chat_agent, and the 13 `SpecializedAgentBase`
+subclasses — 11 domain agents + 2 team leads) calls one helper:
```python
from ._inline import prepare_agent_call
@@ -451,7 +451,7 @@ Three new activities (`agent.execute_llm_step.v1`,
`agent.persist_turn.v1`, `agent.compact_memory.v1`) registered
alongside the per-type activities.
-**Agents that migrate** (15): `aiAgent`, `chatAgent`, 12 specialized
+**Agents that migrate** (15): `aiAgent`, `chatAgent`, 11 specialized
agents (`android_agent`, `coding_agent`, `web_agent`, `task_agent`,
`social_agent`, `travel_agent`, `tool_agent`, `productivity_agent`,
`payments_agent`, `consumer_agent`, `autonomous_agent`), 2 team
diff --git a/docs-internal/workflow-schema.md b/docs-internal/workflow-schema.md
index 246c9495..2118ca24 100644
--- a/docs-internal/workflow-schema.md
+++ b/docs-internal/workflow-schema.md
@@ -68,19 +68,23 @@ A workflow JSON document contains:
## Supported Node Types
-> Authoritative count = glob `server/nodes/**/__init__.py` (live total via `pytest --collect-only`). The breakdown below is illustrative and grouped by category; do not rely on a hand-maintained total.
+> Authoritative count = the plugin registry: one self-contained folder (or file) per node under `server/nodes/<group>/` — ~118 node types today; live total via `pytest --collect-only`. (A bare `server/nodes/**/__init__.py` glob overcounts — it also matches the 26 group packages.) The breakdown below is illustrative and grouped by category; do not rely on a hand-maintained total.
-> The canonical list of nodes lives in the backend plugin tree at `server/nodes/<category>/<node>.py`; this section is a human-readable index.
+> The canonical list of nodes lives in the backend plugin tree at `server/nodes/<category>/<node>/__init__.py`; this section is a human-readable index.
-### Workflow Nodes (2 nodes)
+### Workflow Nodes (1 node)
- `start` - Workflow entry point with initial data
+
+### Trigger Nodes (3 nodes)
+- `webhookTrigger` - Incoming HTTP webhook trigger at `/webhook/{path}`
+- `chatTrigger` - Console message input trigger
- `taskTrigger` - Event-driven trigger for delegated child agent completion
### Scheduler Nodes (2 nodes)
- `timer` - Delay/wait before continuing (seconds, minutes, hours)
- `cronScheduler` - Recurring scheduled execution (seconds to months, timezone support)
-### AI Chat Model Nodes (9 nodes)
+### AI Chat Model Nodes (11 nodes)
- `openaiChatModel` - OpenAI GPT 4.x/5.x + reasoning models (o1/o3/o4 series)
- `anthropicChatModel` - Anthropic Claude 4.x with extended thinking
- `geminiChatModel` - Google Gemini 2.5/3 with thinking support
@@ -90,6 +94,8 @@ A workflow JSON document contains:
- `deepseekChatModel` - DeepSeek V4 (deepseek-v4-flash / deepseek-v4-pro; chat/reasoner legacy aliases)
- `kimiChatModel` - Moonshot Kimi K2.6 / K2.5 / K2.7-code
- `mistralChatModel` - Mistral Large / Small / Codestral
+- `ollamaChatModel` - Local Ollama server (OpenAI-compat via `{provider}_proxy` URL)
+- `lmstudioChatModel` - Local LM Studio server (OpenAI-compat via `{provider}_proxy` URL)
### AI Agents and Memory (3 nodes)
- `aiAgent` - Tool-calling agent loop
@@ -199,24 +205,24 @@ Unified multi-platform messaging (WhatsApp, Telegram, Discord, Slack, SMS, Email
- `cameraControl` - Camera info, take photos
- `mediaControl` - Media playback, volume
-### Utility Nodes (6 nodes)
+### Utility Nodes (5 nodes)
- `httpRequest` - HTTP requests (GET, POST, PUT, DELETE, PATCH) with optional proxy support (`useProxy: true`)
-- `webhookTrigger` - Incoming HTTP webhook trigger at `/webhook/{path}`
- `webhookResponse` - Custom response to webhook caller
-- `chatTrigger` - Console message input trigger
- `console` - Debug logging output
- `teamMonitor` - Real-time monitoring of Agent Team operations
+- `processManager` - Start/stop/manage long-running processes
### Proxy Nodes (3 nodes)
- `proxyRequest` - HTTP requests through residential proxy providers with geo-targeting and failover
- `proxyConfig` - Dual-purpose: configure providers, credentials, routing rules
- `proxyStatus` - View proxy provider health, scores, and usage statistics
-### Code Nodes (3 nodes)
+### Code Nodes (4 nodes)
All dual-purpose (workflow node + AI tool):
- `pythonExecutor` - Python code execution (in-process)
- `javascriptExecutor` - JavaScript execution via persistent Node.js server
- `typescriptExecutor` - TypeScript execution via persistent Node.js server (tsx)
+- `montyExecutor` - Sandboxed Python via the Monty interpreter
### Chat Nodes (2 nodes)
- `chatSend` - Send via JSON-RPC 2.0 WebSocket
diff --git a/server/nodes/README.md b/server/nodes/README.md
index 3455ca8d..9f7f9f18 100644
--- a/server/nodes/README.md
+++ b/server/nodes/README.md
@@ -100,7 +100,7 @@ Match the palette group. Current folders (see
[`groups.py`](./groups.py) for the canonical list):
```
-agent/ — AI agents (ai_agent, chat_agent, 13 specialized, team leads)
+agent/ — AI agents (ai_agent, chat_agent + 16 specialized/variant incl. 2 team leads)
model/ — LLM chat models (openai, anthropic, gemini, …)
android/ — Android device services
google/ — Google Workspace (gmail / calendar / drive / sheets / …)