Skip to content

Self-improving AI Employees for everyone

refactor(D5): declare tool_name + tool_description ClassVars on 65 plugin classes

trohitg07906f0a75cd
diff --git a/server/nodes/agent/ai_agent/__init__.py b/server/nodes/agent/ai_agent/__init__.py
index f4fc9b1c..4d2262b3 100644
--- a/server/nodes/agent/ai_agent/__init__.py
+++ b/server/nodes/agent/ai_agent/__init__.py
@@ -102,6 +102,7 @@ class AIAgentNode(ActionNode):
group = ("agent",)
description = "AI agent with tool calling, memory, and iterative reasoning"
component_kind = "agent"
+ tool_name = "delegate_to_ai_agent"
handles = std_agent_handles()
ui_hints = STD_AGENT_HINTS
annotations = {"destructive": False, "readonly": False, "open_world": True}
diff --git a/server/nodes/agent/ai_employee/__init__.py b/server/nodes/agent/ai_employee/__init__.py
index 653fc423..f35fa0d9 100644
--- a/server/nodes/agent/ai_employee/__init__.py
+++ b/server/nodes/agent/ai_employee/__init__.py
@@ -9,3 +9,4 @@ class AIEmployeeNode(SpecializedAgentBase):
group = ("agent",)
description = "Team lead for multi-agent coordination"
handles = team_lead_agent_handles()
+ tool_description = "ONE-SHOT delegation to AI Employee. Call ONCE per task, returns task_id. Coordinates multiple agents - do NOT re-call."
diff --git a/server/nodes/agent/autonomous_agent/__init__.py b/server/nodes/agent/autonomous_agent/__init__.py
index 86a2a0ac..4241c870 100644
--- a/server/nodes/agent/autonomous_agent/__init__.py
+++ b/server/nodes/agent/autonomous_agent/__init__.py
@@ -7,3 +7,4 @@ class AutonomousAgentNode(SpecializedAgentBase):
subtitle = "Autonomous Ops"
group = ("agent",)
description = "Autonomous agent using Code Mode patterns"
+ tool_description = "ONE-SHOT delegation to Autonomous Agent. Call ONCE per task, returns task_id. Agent works in background using Code Mode patterns - do NOT re-call."
diff --git a/server/nodes/agent/chat_agent/__init__.py b/server/nodes/agent/chat_agent/__init__.py
index 440537da..4786b736 100644
--- a/server/nodes/agent/chat_agent/__init__.py
+++ b/server/nodes/agent/chat_agent/__init__.py
@@ -92,6 +92,7 @@ class ChatAgentNode(ActionNode):
group = ("agent",)
description = "Conversational AI agent with skills and memory"
component_kind = "agent"
+ tool_name = "delegate_to_chat_agent"
handles = std_agent_handles()
ui_hints = STD_AGENT_HINTS
annotations = {"destructive": False, "readonly": False, "open_world": True}
diff --git a/server/nodes/agent/claude_code_agent/__init__.py b/server/nodes/agent/claude_code_agent/__init__.py
index 5d9333eb..3e9b3286 100644
--- a/server/nodes/agent/claude_code_agent/__init__.py
+++ b/server/nodes/agent/claude_code_agent/__init__.py
@@ -240,6 +240,7 @@ class ClaudeCodeAgentNode(ActionNode):
"Each task is isolated in its own git worktree."
)
component_kind = "agent"
+ tool_description = "ONE-SHOT delegation to Claude Code Agent. Call ONCE per task, returns task_id. Agentic coding with file reading, editing, and command execution - do NOT re-call."
handles = std_agent_handles()
ui_hints = STD_AGENT_HINTS
annotations = {"destructive": True, "readonly": False, "open_world": True}
diff --git a/server/nodes/agent/orchestrator_agent/__init__.py b/server/nodes/agent/orchestrator_agent/__init__.py
index 326c4c8d..03524e9f 100644
--- a/server/nodes/agent/orchestrator_agent/__init__.py
+++ b/server/nodes/agent/orchestrator_agent/__init__.py
@@ -9,3 +9,4 @@ class OrchestratorAgentNode(SpecializedAgentBase):
group = ("agent",)
description = "Team lead that delegates to connected specialized agents"
handles = team_lead_agent_handles()
+ tool_description = "ONE-SHOT delegation to Orchestrator Agent. Call ONCE per task, returns task_id. Coordinates multiple agents - do NOT re-call."
diff --git a/server/nodes/agent/rlm_agent/__init__.py b/server/nodes/agent/rlm_agent/__init__.py
index dfc657f4..eacc848c 100644
--- a/server/nodes/agent/rlm_agent/__init__.py
+++ b/server/nodes/agent/rlm_agent/__init__.py
@@ -28,6 +28,7 @@ class RLMAgentNode(ActionNode):
group = ("agent",)
description = "Recursive Language Model agent (REPL-based)"
component_kind = "agent"
+ tool_description = "ONE-SHOT delegation to RLM Agent. Call ONCE per task, returns task_id. Uses recursive REPL-based reasoning with code execution - do NOT re-call."
handles = std_agent_handles()
ui_hints = STD_AGENT_HINTS
annotations = {"destructive": True, "readonly": False, "open_world": True}
diff --git a/server/nodes/android/airplane_mode_control/__init__.py b/server/nodes/android/airplane_mode_control/__init__.py
index 3ae26ce9..df965c51 100644
--- a/server/nodes/android/airplane_mode_control/__init__.py
+++ b/server/nodes/android/airplane_mode_control/__init__.py
@@ -5,3 +5,4 @@ class AirplaneModeControlNode(AndroidServiceBase):
type = "airplaneModeControl"
display_name = "Airplane Mode"
description = "Airplane mode status monitoring and control"
+ tool_name = "android_airplane_mode"
diff --git a/server/nodes/android/app_launcher/__init__.py b/server/nodes/android/app_launcher/__init__.py
index d47cd2d6..b25fd887 100644
--- a/server/nodes/android/app_launcher/__init__.py
+++ b/server/nodes/android/app_launcher/__init__.py
@@ -25,5 +25,6 @@ class AppLauncherNode(AndroidServiceBase):
type = "appLauncher"
display_name = "App Launcher"
description = "Launch applications by package name"
+ tool_name = "android_app_launcher"
Params = AppLauncherParams
diff --git a/server/nodes/android/app_list/__init__.py b/server/nodes/android/app_list/__init__.py
index 99b8e451..2a6ddd33 100644
--- a/server/nodes/android/app_list/__init__.py
+++ b/server/nodes/android/app_list/__init__.py
@@ -5,3 +5,4 @@ class AppListNode(AndroidServiceBase):
type = "appList"
display_name = "App List"
description = "Get list of installed applications"
+ tool_name = "android_app_list"
diff --git a/server/nodes/android/audio_automation/__init__.py b/server/nodes/android/audio_automation/__init__.py
index 11b56365..9df729c9 100644
--- a/server/nodes/android/audio_automation/__init__.py
+++ b/server/nodes/android/audio_automation/__init__.py
@@ -5,3 +5,4 @@ class AudioAutomationNode(AndroidServiceBase):
type = "audioAutomation"
display_name = "Audio Automation"
description = "Volume and audio control - get/set volume, mute, unmute"
+ tool_name = "android_audio"
diff --git a/server/nodes/android/battery_monitor/__init__.py b/server/nodes/android/battery_monitor/__init__.py
index 3c9cf28c..b2228d29 100644
--- a/server/nodes/android/battery_monitor/__init__.py
+++ b/server/nodes/android/battery_monitor/__init__.py
@@ -5,3 +5,4 @@ class BatteryMonitorNode(AndroidServiceBase):
type = "batteryMonitor"
display_name = "Battery Monitor"
description = "Monitor battery status, level, charging state, temperature, and health"
+ tool_name = "android_battery"
diff --git a/server/nodes/android/bluetooth_automation/__init__.py b/server/nodes/android/bluetooth_automation/__init__.py
index e514a025..a6b9f7aa 100644
--- a/server/nodes/android/bluetooth_automation/__init__.py
+++ b/server/nodes/android/bluetooth_automation/__init__.py
@@ -5,3 +5,4 @@ class BluetoothAutomationNode(AndroidServiceBase):
type = "bluetoothAutomation"
display_name = "Bluetooth Automation"
description = "Bluetooth control - enable, disable, get status, paired devices"
+ tool_name = "android_bluetooth"
diff --git a/server/nodes/android/camera_control/__init__.py b/server/nodes/android/camera_control/__init__.py
index cbadd798..9aa9a44f 100644
--- a/server/nodes/android/camera_control/__init__.py
+++ b/server/nodes/android/camera_control/__init__.py
@@ -5,3 +5,4 @@ class CameraControlNode(AndroidServiceBase):
type = "cameraControl"
display_name = "Camera"
description = "Camera control - get info, take photos, capabilities"
+ tool_name = "android_camera"
diff --git a/server/nodes/android/device_state_automation/__init__.py b/server/nodes/android/device_state_automation/__init__.py
index 338d354f..1ece7999 100644
--- a/server/nodes/android/device_state_automation/__init__.py
+++ b/server/nodes/android/device_state_automation/__init__.py
@@ -5,3 +5,4 @@ class DeviceStateAutomationNode(AndroidServiceBase):
type = "deviceStateAutomation"
display_name = "Device State"
description = "Device state control - airplane mode, screen on/off, brightness"
+ tool_name = "android_device_state"
diff --git a/server/nodes/android/environmental_sensors/__init__.py b/server/nodes/android/environmental_sensors/__init__.py
index d5184bb6..32fd7a03 100644
--- a/server/nodes/android/environmental_sensors/__init__.py
+++ b/server/nodes/android/environmental_sensors/__init__.py
@@ -5,3 +5,4 @@ class EnvironmentalSensorsNode(AndroidServiceBase):
type = "environmentalSensors"
display_name = "Environmental Sensors"
description = "Temperature, humidity, pressure, light level"
+ tool_name = "android_environmental_sensors"
diff --git a/server/nodes/android/location/__init__.py b/server/nodes/android/location/__init__.py
index 56750973..e84dbcfd 100644
--- a/server/nodes/android/location/__init__.py
+++ b/server/nodes/android/location/__init__.py
@@ -5,3 +5,4 @@ class LocationNode(AndroidServiceBase):
type = "location"
display_name = "Location"
description = "GPS location tracking with latitude, longitude, accuracy, and provider"
+ tool_name = "android_location"
diff --git a/server/nodes/android/media_control/__init__.py b/server/nodes/android/media_control/__init__.py
index 4c883703..89cf61c1 100644
--- a/server/nodes/android/media_control/__init__.py
+++ b/server/nodes/android/media_control/__init__.py
@@ -5,3 +5,4 @@ class MediaControlNode(AndroidServiceBase):
type = "mediaControl"
display_name = "Media Control"
description = "Media playback - volume, playback, play files"
+ tool_name = "android_media"
diff --git a/server/nodes/android/motion_detection/__init__.py b/server/nodes/android/motion_detection/__init__.py
index da7fbe55..f72d60e2 100644
--- a/server/nodes/android/motion_detection/__init__.py
+++ b/server/nodes/android/motion_detection/__init__.py
@@ -5,3 +5,4 @@ class MotionDetectionNode(AndroidServiceBase):
type = "motionDetection"
display_name = "Motion Detection"
description = "Accelerometer + gyroscope - motion, shake, orientation"
+ tool_name = "android_motion_detection"
diff --git a/server/nodes/android/network_monitor/__init__.py b/server/nodes/android/network_monitor/__init__.py
index 67f50ac3..db3c2b3b 100644
--- a/server/nodes/android/network_monitor/__init__.py
+++ b/server/nodes/android/network_monitor/__init__.py
@@ -5,3 +5,4 @@ class NetworkMonitorNode(AndroidServiceBase):
type = "networkMonitor"
display_name = "Network Monitor"
description = "Monitor network connectivity, type, and internet availability"
+ tool_name = "android_network"
diff --git a/server/nodes/android/screen_control_automation/__init__.py b/server/nodes/android/screen_control_automation/__init__.py
index f0aff02d..0d364d3a 100644
--- a/server/nodes/android/screen_control_automation/__init__.py
+++ b/server/nodes/android/screen_control_automation/__init__.py
@@ -5,3 +5,4 @@ class ScreenControlAutomationNode(AndroidServiceBase):
type = "screenControlAutomation"
display_name = "Screen Control"
description = "Screen control - brightness, wake screen, auto-brightness"
+ tool_name = "android_screen_control"
diff --git a/server/nodes/android/system_info/__init__.py b/server/nodes/android/system_info/__init__.py
index a61b5746..a48a1f3b 100644
--- a/server/nodes/android/system_info/__init__.py
+++ b/server/nodes/android/system_info/__init__.py
@@ -5,3 +5,4 @@ class SystemInfoNode(AndroidServiceBase):
type = "systemInfo"
display_name = "System Info"
description = "Get device and OS information"
+ tool_name = "android_system_info"
diff --git a/server/nodes/android/wifi_automation/__init__.py b/server/nodes/android/wifi_automation/__init__.py
index 6bfbcacb..079c1440 100644
--- a/server/nodes/android/wifi_automation/__init__.py
+++ b/server/nodes/android/wifi_automation/__init__.py
@@ -5,3 +5,4 @@ class WifiAutomationNode(AndroidServiceBase):
type = "wifiAutomation"
display_name = "WiFi Automation"
description = "WiFi control and scanning"
+ tool_name = "android_wifi"
diff --git a/server/nodes/browser/browser/__init__.py b/server/nodes/browser/browser/__init__.py
index 71de5efd..0e13c6c9 100644
--- a/server/nodes/browser/browser/__init__.py
+++ b/server/nodes/browser/browser/__init__.py
@@ -305,6 +305,8 @@ class BrowserNode(ActionNode):
group = ("browser", "tool")
description = "Interactive browser automation via agent-browser CLI"
component_kind = "square"
+ tool_name = "browser"
+ tool_description = "Control a web browser interactively. Use snapshot to see the page (returns accessibility tree with @eN refs). Then click/type/fill with those refs. Workflow: navigate -> snapshot -> interact -> snapshot. Operations: navigate, click, type, fill, screenshot, snapshot, get_text, get_html, eval, wait, scroll, select, batch."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/code/javascript_executor/__init__.py b/server/nodes/code/javascript_executor/__init__.py
index d008eb47..32d16104 100644
--- a/server/nodes/code/javascript_executor/__init__.py
+++ b/server/nodes/code/javascript_executor/__init__.py
@@ -14,6 +14,8 @@ class JavaScriptExecutorNode(CodeExecutorBase):
display_name = "JavaScript Executor"
subtitle = "Run JS"
description = "Execute JavaScript code via persistent Node.js server"
+ tool_name = "javascript_code"
+ tool_description = "Execute JavaScript code for calculations, data processing, and JSON manipulation. Set output variable with result."
@Operation("execute")
async def execute_op(self, ctx: NodeContext, params: CodeExecutorParams) -> Any:
diff --git a/server/nodes/code/python_executor/__init__.py b/server/nodes/code/python_executor/__init__.py
index cba565ec..5146fe9c 100644
--- a/server/nodes/code/python_executor/__init__.py
+++ b/server/nodes/code/python_executor/__init__.py
@@ -22,6 +22,8 @@ class PythonExecutorNode(CodeExecutorBase):
display_name = "Python Executor"
subtitle = "Run Python"
description = "Execute Python code for calculations, data processing, and automation"
+ tool_name = "python_code"
+ tool_description = "Execute Python code for calculations, data processing, and automation. Available: math, json, datetime, Counter, defaultdict. Set output variable with result."
@Operation("execute")
async def execute_op(self, ctx: NodeContext, params: CodeExecutorParams) -> Any:
diff --git a/server/nodes/code/typescript_executor/__init__.py b/server/nodes/code/typescript_executor/__init__.py
index 3a1a7e69..f6f79189 100644
--- a/server/nodes/code/typescript_executor/__init__.py
+++ b/server/nodes/code/typescript_executor/__init__.py
@@ -14,6 +14,8 @@ class TypeScriptExecutorNode(CodeExecutorBase):
display_name = "TypeScript Executor"
subtitle = "Run TS"
description = "Execute TypeScript code via persistent Node.js server with type safety"
+ tool_name = "typescript_code"
+ tool_description = "Execute TypeScript code via persistent Node.js server with type safety. Set output variable with result."
@Operation("execute")
async def execute_op(self, ctx: NodeContext, params: CodeExecutorParams) -> Any:
diff --git a/server/nodes/email/email_read/__init__.py b/server/nodes/email/email_read/__init__.py
index 2b66c605..f8b617df 100644
--- a/server/nodes/email/email_read/__init__.py
+++ b/server/nodes/email/email_read/__init__.py
@@ -104,6 +104,8 @@ class EmailReadNode(ActionNode):
group = ("email", "tool")
description = "Read and manage emails via IMAP - list, search, read, move, delete, flag"
component_kind = "square"
+ tool_name = "email_read"
+ tool_description = "Read and manage emails via IMAP. Operations: list (envelopes), search (query), read (message by ID), folders (list), move, delete, flag."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/email/email_send/__init__.py b/server/nodes/email/email_send/__init__.py
index 62ad3fcd..e542c6bc 100644
--- a/server/nodes/email/email_send/__init__.py
+++ b/server/nodes/email/email_send/__init__.py
@@ -38,6 +38,8 @@ class EmailSendNode(ActionNode):
group = ("email", "tool")
description = "Send emails via SMTP (Gmail, Outlook, Yahoo, iCloud, ProtonMail, Fastmail, custom)"
component_kind = "square"
+ tool_name = "email_send"
+ tool_description = "Send email via SMTP. Specify to, subject, body. Optional: cc, bcc, body_type (text/html)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/filesystem/file_modify/__init__.py b/server/nodes/filesystem/file_modify/__init__.py
index 3754b8d6..3a878e4c 100644
--- a/server/nodes/filesystem/file_modify/__init__.py
+++ b/server/nodes/filesystem/file_modify/__init__.py
@@ -37,6 +37,8 @@ class FileModifyNode(ActionNode):
subtitle = "Write/Edit"
group = ("filesystem", "tool")
description = "Write new files or edit existing files"
+ tool_name = "file_modify"
+ tool_description = "Write a new file or edit an existing file with string replacement. Operations: write (create/overwrite), edit (find and replace)."
component_kind = "square"
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
diff --git a/server/nodes/filesystem/file_read/__init__.py b/server/nodes/filesystem/file_read/__init__.py
index c3d41e27..960e0794 100644
--- a/server/nodes/filesystem/file_read/__init__.py
+++ b/server/nodes/filesystem/file_read/__init__.py
@@ -30,6 +30,8 @@ class FileReadNode(ActionNode):
subtitle = "Read Contents"
group = ("filesystem", "tool")
description = "Read file contents with line numbers and pagination"
+ tool_name = "file_read"
+ tool_description = "Read file contents with pagination. Returns line-numbered text."
component_kind = "square"
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
diff --git a/server/nodes/filesystem/fs_search/__init__.py b/server/nodes/filesystem/fs_search/__init__.py
index 197242a3..457a9d94 100644
--- a/server/nodes/filesystem/fs_search/__init__.py
+++ b/server/nodes/filesystem/fs_search/__init__.py
@@ -30,6 +30,8 @@ class FsSearchNode(ActionNode):
subtitle = "ls/glob/grep"
group = ("filesystem", "tool")
description = "Search the filesystem (ls, glob, grep)"
+ tool_name = "fs_search"
+ tool_description = "Search the filesystem. Modes: ls (list directory), glob (pattern match files), grep (search file contents for text)."
component_kind = "square"
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
diff --git a/server/nodes/filesystem/shell/__init__.py b/server/nodes/filesystem/shell/__init__.py
index 291d8324..9ba7d512 100644
--- a/server/nodes/filesystem/shell/__init__.py
+++ b/server/nodes/filesystem/shell/__init__.py
@@ -41,6 +41,8 @@ class ShellNode(ActionNode):
subtitle = "Run Command"
group = ("filesystem", "tool")
description = "Execute shell commands (sandboxed; no system PATH)"
+ tool_name = "shell_execute"
+ tool_description = "Execute a shell command. Returns stdout, stderr, and exit code."
component_kind = "square"
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
diff --git a/server/nodes/google/calendar/__init__.py b/server/nodes/google/calendar/__init__.py
index b642a0d9..f50afa5c 100644
--- a/server/nodes/google/calendar/__init__.py
+++ b/server/nodes/google/calendar/__init__.py
@@ -96,6 +96,8 @@ class CalendarNode(ActionNode):
group = ("google", "tool")
description = "Google Calendar create / list / update / delete events"
component_kind = "square"
+ tool_name = "google_calendar"
+ tool_description = "Manage Google Calendar events. Operations: create (new event), list (events in date range), update (modify event), delete (remove event)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/google/contacts/__init__.py b/server/nodes/google/contacts/__init__.py
index c10e2500..ad3009ef 100644
--- a/server/nodes/google/contacts/__init__.py
+++ b/server/nodes/google/contacts/__init__.py
@@ -104,6 +104,8 @@ class ContactsNode(ActionNode):
group = ("google", "tool")
description = "Google Contacts create / list / search / get / update / delete"
component_kind = "square"
+ tool_name = "google_contacts"
+ tool_description = "Manage Google Contacts. Operations: create (new contact), list (browse), search (find by name/email/phone), get (details by resource name), update (modify), delete (remove)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/google/drive/__init__.py b/server/nodes/google/drive/__init__.py
index 0c804785..bff98351 100644
--- a/server/nodes/google/drive/__init__.py
+++ b/server/nodes/google/drive/__init__.py
@@ -100,6 +100,8 @@ class DriveNode(ActionNode):
group = ("google", "tool")
description = "Google Drive upload / download / list / share files"
component_kind = "square"
+ tool_name = "google_drive"
+ tool_description = "Manage Google Drive files. Operations: upload (add file from URL), download (get file by ID), list (find files), share (share with user)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/google/gmail/__init__.py b/server/nodes/google/gmail/__init__.py
index 29cf127c..4a72e3f6 100644
--- a/server/nodes/google/gmail/__init__.py
+++ b/server/nodes/google/gmail/__init__.py
@@ -99,6 +99,8 @@ class GmailNode(ActionNode):
group = ("google", "tool")
description = "Google Gmail send / search / read (dual-purpose workflow + AI tool)"
component_kind = "square"
+ tool_name = "google_gmail"
+ tool_description = "Send, search, and read emails via Gmail. Operations: send (compose email), search (find emails by query), read (get email by ID)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/google/sheets/__init__.py b/server/nodes/google/sheets/__init__.py
index 28f1cd57..6eb9f79d 100644
--- a/server/nodes/google/sheets/__init__.py
+++ b/server/nodes/google/sheets/__init__.py
@@ -83,6 +83,8 @@ class SheetsNode(ActionNode):
group = ("google", "tool")
description = "Google Sheets read / write / append spreadsheet data"
component_kind = "square"
+ tool_name = "google_sheets"
+ tool_description = "Read and write Google Sheets data. Operations: read (get range), write (set range), append (add rows)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/google/tasks/__init__.py b/server/nodes/google/tasks/__init__.py
index 995a6384..7241687f 100644
--- a/server/nodes/google/tasks/__init__.py
+++ b/server/nodes/google/tasks/__init__.py
@@ -74,6 +74,8 @@ class TasksNode(ActionNode):
group = ("google", "tool")
description = "Google Tasks create / list / complete / update / delete"
component_kind = "square"
+ tool_name = "google_tasks"
+ tool_description = "Manage Google Tasks. Operations: create (new task), list (find tasks), complete (mark done), update (modify task), delete (remove task)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/location/gmaps_locations/__init__.py b/server/nodes/location/gmaps_locations/__init__.py
index 8ce6ad55..1db8ec6e 100644
--- a/server/nodes/location/gmaps_locations/__init__.py
+++ b/server/nodes/location/gmaps_locations/__init__.py
@@ -56,6 +56,8 @@ class GmapsLocationsNode(ActionNode):
group = ("location", "service", "tool")
description = "Google Maps Geocoding service"
component_kind = "square"
+ tool_name = "geocode"
+ tool_description = "Geocode addresses to coordinates or reverse geocode coordinates to addresses using Google Maps."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/location/gmaps_nearby_places/__init__.py b/server/nodes/location/gmaps_nearby_places/__init__.py
index d07bb295..5ea66dfa 100644
--- a/server/nodes/location/gmaps_nearby_places/__init__.py
+++ b/server/nodes/location/gmaps_nearby_places/__init__.py
@@ -35,6 +35,8 @@ class GmapsNearbyPlacesNode(ActionNode):
group = ("location", "service", "tool")
description = "Google Places API nearbySearch"
component_kind = "square"
+ tool_name = "nearby_places"
+ tool_description = "Search for nearby places (restaurants, hospitals, banks, etc.) using Google Maps Places API."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/proxy/proxy_config/__init__.py b/server/nodes/proxy/proxy_config/__init__.py
index 1b37ad48..eb9f9edf 100644
--- a/server/nodes/proxy/proxy_config/__init__.py
+++ b/server/nodes/proxy/proxy_config/__init__.py
@@ -369,6 +369,8 @@ class ProxyConfigNode(ActionNode):
group = ("proxy", "tool")
description = "Configure proxy providers and routing rules"
component_kind = "square"
+ tool_name = "proxy_config"
+ tool_description = "Manage proxy providers and routing rules. Operations: list_providers, add_provider, update_provider, remove_provider, set_credentials, test_provider, get_stats, add_routing_rule, list_routing_rules, remove_routing_rule."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/proxy/proxy_request/__init__.py b/server/nodes/proxy/proxy_request/__init__.py
index 15ee046a..3ecaba86 100644
--- a/server/nodes/proxy/proxy_request/__init__.py
+++ b/server/nodes/proxy/proxy_request/__init__.py
@@ -46,6 +46,8 @@ class ProxyRequestNode(ActionNode):
group = ("proxy", "tool")
description = "Make HTTP requests through residential proxy providers"
component_kind = "square"
+ tool_name = "proxy_request"
+ tool_description = "Make HTTP requests through residential proxy providers with geo-targeting, session control, and automatic failover. Supports GET, POST, PUT, DELETE, PATCH methods."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/proxy/proxy_status/__init__.py b/server/nodes/proxy/proxy_status/__init__.py
index 832bf0c0..3d0c6b36 100644
--- a/server/nodes/proxy/proxy_status/__init__.py
+++ b/server/nodes/proxy/proxy_status/__init__.py
@@ -29,6 +29,8 @@ class ProxyStatusNode(ActionNode):
group = ("proxy", "tool")
description = "View proxy provider health, scores, and usage statistics"
component_kind = "square"
+ tool_name = "proxy_status"
+ tool_description = "Get proxy provider health stats, scores, and usage statistics. Returns enabled status, provider list with health scores, and aggregated stats."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/scheduler/cron_scheduler/__init__.py b/server/nodes/scheduler/cron_scheduler/__init__.py
index 1a3bc9a8..fb430d54 100644
--- a/server/nodes/scheduler/cron_scheduler/__init__.py
+++ b/server/nodes/scheduler/cron_scheduler/__init__.py
@@ -196,6 +196,8 @@ class CronSchedulerNode(ActionNode):
group = ("scheduler", "trigger", "tool")
description = "Cron expression-based scheduling trigger"
component_kind = "trigger"
+ tool_name = "cron_scheduler"
+ tool_description = "Schedule a delayed or recurring execution. Supports seconds, minutes, hours, daily, weekly, monthly frequencies with timezone. Use frequency to set schedule type, then set the relevant interval/time parameters."
handles = (
{"name": "output-main", "kind": "output", "position": "right",
"label": "Output", "role": "main"},
diff --git a/server/nodes/scheduler/timer/__init__.py b/server/nodes/scheduler/timer/__init__.py
index 268a0c19..648cdc84 100644
--- a/server/nodes/scheduler/timer/__init__.py
+++ b/server/nodes/scheduler/timer/__init__.py
@@ -34,6 +34,8 @@ class TimerNode(ActionNode):
group = ("scheduler",)
description = "Timer-based trigger with configurable delay"
component_kind = "square" # has input handle
+ tool_name = "timer"
+ tool_description = "Wait/sleep for a specified duration. Specify duration (1-3600) and unit (seconds, minutes, or hours). Returns timestamp and elapsed time after waiting."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/scraper/apify_actor/__init__.py b/server/nodes/scraper/apify_actor/__init__.py
index 400634af..ee42072b 100644
--- a/server/nodes/scraper/apify_actor/__init__.py
+++ b/server/nodes/scraper/apify_actor/__init__.py
@@ -240,6 +240,8 @@ class ApifyActorNode(ActionNode):
group = ("api", "scraper", "tool")
description = "Run Apify actors for Instagram, TikTok, Twitter, LinkedIn, etc."
component_kind = "square"
+ tool_name = "apify_actor"
+ tool_description = "Run Apify actors (pre-built web scrapers) for Instagram, TikTok, Twitter, LinkedIn, Facebook, YouTube, Google Search, Google Maps, and websites. Specify actor_id and actor_input (JSON)."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/scraper/crawlee_scraper/__init__.py b/server/nodes/scraper/crawlee_scraper/__init__.py
index 78c5a2a9..eafb79e6 100644
--- a/server/nodes/scraper/crawlee_scraper/__init__.py
+++ b/server/nodes/scraper/crawlee_scraper/__init__.py
@@ -281,6 +281,8 @@ class CrawleeScraperNode(ActionNode):
group = ("scraper", "tool")
description = "Web scraper supporting static HTML (BeautifulSoup) and JS-rendered (Playwright)"
component_kind = "square"
+ tool_name = "web_reader"
+ tool_description = "Read and extract content from web pages. Fetches page text, links, and data. Use beautifulsoup for static pages or playwright for JS-rendered pages. You MUST use this tool when the user asks to read, fetch, or get content from any URL."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/search/brave_search/__init__.py b/server/nodes/search/brave_search/__init__.py
index 3c326d3f..d095e8bf 100644
--- a/server/nodes/search/brave_search/__init__.py
+++ b/server/nodes/search/brave_search/__init__.py
@@ -82,6 +82,8 @@ class BraveSearchNode(ActionNode):
group = ("search", "tool")
description = "Search the web using Brave Search API"
component_kind = "square"
+ tool_name = "brave_search"
+ tool_description = "Search the web using Brave Search. Returns web results with titles, snippets, and URLs."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/search/duckduckgo_search/__init__.py b/server/nodes/search/duckduckgo_search/__init__.py
index a10f0b8c..5dbf052f 100644
--- a/server/nodes/search/duckduckgo_search/__init__.py
+++ b/server/nodes/search/duckduckgo_search/__init__.py
@@ -43,6 +43,8 @@ class DuckDuckGoSearchNode(ToolNode):
group = ("tool", "ai", "search")
description = "DuckDuckGo web search (free, no API key required)"
component_kind = "tool"
+ tool_name = "web_search"
+ tool_description = "Search the web for information using DuckDuckGo. Returns relevant search results. Free, no API key required."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/search/perplexity_search/__init__.py b/server/nodes/search/perplexity_search/__init__.py
index ae3655e6..dd00c206 100644
--- a/server/nodes/search/perplexity_search/__init__.py
+++ b/server/nodes/search/perplexity_search/__init__.py
@@ -83,6 +83,8 @@ class PerplexitySearchNode(ActionNode):
group = ("search", "tool")
description = "AI-powered search using Perplexity Sonar with citations"
component_kind = "square"
+ tool_name = "perplexity_search"
+ tool_description = "Search the web using Perplexity Sonar AI. Returns an AI-generated answer with citations and source URLs."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/search/serper_search/__init__.py b/server/nodes/search/serper_search/__init__.py
index bfda1a46..9e6e2649 100644
--- a/server/nodes/search/serper_search/__init__.py
+++ b/server/nodes/search/serper_search/__init__.py
@@ -79,6 +79,8 @@ class SerperSearchNode(ActionNode):
group = ("search", "tool")
description = "Search the web using Google via Serper API (web/news/images/places)"
component_kind = "square"
+ tool_name = "serper_search"
+ tool_description = "Search the web using Google via Serper API. Returns web results with titles, snippets, and URLs."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/stripe/stripe_action.py b/server/nodes/stripe/stripe_action.py
index e0203d53..14546713 100644
--- a/server/nodes/stripe/stripe_action.py
+++ b/server/nodes/stripe/stripe_action.py
@@ -43,6 +43,8 @@ class StripeActionNode(ActionNode):
group = ("payments", "tool")
description = "Run any Stripe CLI command (customers, charges, payment_intents, refunds, invoices, trigger, …)"
component_kind = "square"
+ tool_name = "stripe_action"
+ tool_description = "Run any Stripe CLI command and return the parsed JSON response. Pass a 'command' field exactly as you would type after 'stripe ' (e.g. 'customers create --email [email protected]', 'charges list --limit 10', 'payment_intents create --amount 2000 --currency usd', 'refunds create --payment-intent pi_xxx', 'trigger charge.succeeded'). Covers every Stripe resource: customers, charges, payment_intents, refunds, invoices, products, prices, subscriptions, payment_methods, setup_intents, transfers, payouts, plus 'trigger <event>' for synthetic test events."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/tool/agent_builder/__init__.py b/server/nodes/tool/agent_builder/__init__.py
index 0f392a9c..8d381e3b 100644
--- a/server/nodes/tool/agent_builder/__init__.py
+++ b/server/nodes/tool/agent_builder/__init__.py
@@ -300,6 +300,8 @@ class AgentBuilderNode(ToolNode):
"agent calls operations through the standard tool path."
)
component_kind = "tool"
+ tool_name = "agent_builder"
+ tool_description = "Inspect and modify the workflow canvas at runtime. Operations: inspect_canvas (read current nodes/edges), spawn_tool (add a tool node + wire it), enable_skill (add a skill folder to a connected masterSkill), add_delegate_agent (add a specialized agent), create_workflow (spawn a brand-new workflow)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/tool/calculator_tool/__init__.py b/server/nodes/tool/calculator_tool/__init__.py
index fe83824e..c405557e 100644
--- a/server/nodes/tool/calculator_tool/__init__.py
+++ b/server/nodes/tool/calculator_tool/__init__.py
@@ -61,6 +61,8 @@ class CalculatorToolNode(ToolNode):
group = ("tool", "ai")
description = "Add, subtract, multiply, divide, power, sqrt, mod, abs"
component_kind = "tool"
+ tool_name = "calculator"
+ tool_description = "Perform mathematical calculations. Operations: add, subtract, multiply, divide, power, sqrt, mod, abs"
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/tool/current_time_tool/__init__.py b/server/nodes/tool/current_time_tool/__init__.py
index d6f127fd..43552b4f 100644
--- a/server/nodes/tool/current_time_tool/__init__.py
+++ b/server/nodes/tool/current_time_tool/__init__.py
@@ -30,6 +30,8 @@ class CurrentTimeToolNode(ToolNode):
group = ("tool", "ai")
description = "Get current date/time with timezone support"
component_kind = "tool"
+ tool_name = "get_current_time"
+ tool_description = "Get the current date and time. Optionally specify timezone."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/tool/task_manager/__init__.py b/server/nodes/tool/task_manager/__init__.py
index 6f45e81c..9bebd770 100644
--- a/server/nodes/tool/task_manager/__init__.py
+++ b/server/nodes/tool/task_manager/__init__.py
@@ -46,6 +46,8 @@ class TaskManagerNode(ToolNode):
group = ("tool", "ai")
description = "Task management tool for AI agents to create, track, and manage tasks"
component_kind = "tool"
+ tool_name = "task_manager"
+ tool_description = "Track delegated sub-agent tasks. Operations: list_tasks (see all tasks), get_task (check specific task status/result), mark_done (cleanup completed tasks)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/tool/write_todos/__init__.py b/server/nodes/tool/write_todos/__init__.py
index ad922220..f2460f44 100644
--- a/server/nodes/tool/write_todos/__init__.py
+++ b/server/nodes/tool/write_todos/__init__.py
@@ -35,6 +35,19 @@ class WriteTodosNode(ToolNode):
group = ("tool", "ai")
description = "Structured task list planning for complex multi-step operations"
component_kind = "tool"
+ tool_name = "write_todos"
+ tool_description = (
+ "Create and manage a structured task list for your current work session. "
+ "This helps you track progress, organize complex tasks, and demonstrate "
+ "thoroughness to the user. Only use this tool if you think it will be "
+ "helpful in staying organized. If the user's request is trivial and takes "
+ "less than 3 steps, it is better to NOT use this tool and just do the task "
+ "directly. Use for complex multi-step tasks (3+ steps), non-trivial planning, "
+ "or when user explicitly requests a todo list. Task states: pending, "
+ "in_progress, completed. Mark tasks as in_progress BEFORE beginning work, "
+ "completed IMMEDIATELY after finishing. Remove irrelevant tasks. Break "
+ "complex tasks into smaller steps."
+ )
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/twitter/twitter_search/__init__.py b/server/nodes/twitter/twitter_search/__init__.py
index d66612e1..1f82109a 100644
--- a/server/nodes/twitter/twitter_search/__init__.py
+++ b/server/nodes/twitter/twitter_search/__init__.py
@@ -87,6 +87,8 @@ class TwitterSearchNode(ActionNode):
group = ("social", "tool")
description = "Search recent tweets on Twitter/X using the Search API"
component_kind = "square"
+ tool_name = "twitter_search"
+ tool_description = "Search recent tweets on Twitter/X. Returns enriched tweets with expanded URLs, author profile, public_metrics, media, referenced_tweets, note_tweet. Supports query operators: keywords, #hashtags, @mentions, from:user, to:user, -exclude, OR, lang:, has:links/media/images/videos, is:retweet/reply/quote, url:."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/twitter/twitter_send/__init__.py b/server/nodes/twitter/twitter_send/__init__.py
index e2b42741..6205b77c 100644
--- a/server/nodes/twitter/twitter_send/__init__.py
+++ b/server/nodes/twitter/twitter_send/__init__.py
@@ -172,6 +172,8 @@ class TwitterSendNode(ActionNode):
group = ("social", "tool")
description = "Post tweets, reply, retweet, like, or delete tweets on Twitter/X"
component_kind = "square"
+ tool_name = "twitter_send"
+ tool_description = "Post, reply, retweet, like, unlike, or delete tweets on Twitter/X. Actions: tweet, reply, retweet, like, unlike, delete. Specify text (280 char max), tweet_id, reply_to_id as needed."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/twitter/twitter_user/__init__.py b/server/nodes/twitter/twitter_user/__init__.py
index e58355ab..82fc4ae5 100644
--- a/server/nodes/twitter/twitter_user/__init__.py
+++ b/server/nodes/twitter/twitter_user/__init__.py
@@ -130,6 +130,8 @@ class TwitterUserNode(ActionNode):
group = ("social", "tool")
description = "Look up Twitter/X user profiles, followers, and following"
component_kind = "square"
+ tool_name = "twitter_user"
+ tool_description = "Look up Twitter/X user profiles with description and created_at. Operations: me (authenticated user), by_username, by_id, followers (max_results 1-1000), following (max_results 1-1000)."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/utility/http_request/__init__.py b/server/nodes/utility/http_request/__init__.py
index 833c7f73..ddda4c23 100644
--- a/server/nodes/utility/http_request/__init__.py
+++ b/server/nodes/utility/http_request/__init__.py
@@ -72,6 +72,8 @@ class HttpRequestNode(ActionNode):
group = ("utility", "tool")
description = "Make HTTP requests to external APIs (GET, POST, PUT, DELETE, PATCH)"
component_kind = "square"
+ tool_name = "http_request"
+ tool_description = "Make HTTP requests to external APIs. Specify method (GET/POST/PUT/DELETE/PATCH), url, headers (JSON object), body (JSON or string). Optional: use_proxy to route through a residential proxy with geo-targeting."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/utility/process_manager/__init__.py b/server/nodes/utility/process_manager/__init__.py
index 9cb6b879..5c9cd057 100644
--- a/server/nodes/utility/process_manager/__init__.py
+++ b/server/nodes/utility/process_manager/__init__.py
@@ -44,6 +44,8 @@ class ProcessManagerNode(ActionNode):
group = ("utility", "tool")
description = "Start, stop, restart, and manage long-running processes"
component_kind = "square"
+ tool_name = "process_manager"
+ tool_description = "Start, stop, and manage long-running processes (dev servers, watchers, build tools). Operations: start (spawn a process), stop (kill process tree), restart, list (show all running), send_input (write to stdin), get_output (read recent output lines). Output streams to Terminal tab. Use get_output to check what a process printed."
handles = (
{"name": "input-main", "kind": "input", "position": "left", "label": "Input", "role": "main"},
{"name": "output-main", "kind": "output", "position": "right", "label": "Output", "role": "main"},
diff --git a/server/nodes/whatsapp/whatsapp_db.py b/server/nodes/whatsapp/whatsapp_db.py
index 35fb1a72..7f3f8934 100644
--- a/server/nodes/whatsapp/whatsapp_db.py
+++ b/server/nodes/whatsapp/whatsapp_db.py
@@ -323,6 +323,8 @@ class WhatsAppDbNode(ActionNode):
group = ("whatsapp", "tool")
description = "Query WhatsApp database (chat history, contacts, groups, channels)"
component_kind = "square"
+ tool_name = "whatsapp_db"
+ tool_description = "Query WhatsApp database - list contacts, search groups, get contact/group info, retrieve chat history."
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},
diff --git a/server/nodes/whatsapp/whatsapp_send.py b/server/nodes/whatsapp/whatsapp_send.py
index a33863a4..9eff20f3 100644
--- a/server/nodes/whatsapp/whatsapp_send.py
+++ b/server/nodes/whatsapp/whatsapp_send.py
@@ -245,6 +245,7 @@ class WhatsAppSendNode(ActionNode):
group = ("whatsapp", "tool")
description = "Send WhatsApp messages (text, media, location, contact, sticker)"
component_kind = "square"
+ tool_name = "whatsapp_send"
handles = (
{"name": "input-main", "kind": "input", "position": "left",
"label": "Input", "role": "main"},