Skip to content

Self-improving AI Employees for everyone

fix: plugin schema consolidation + test-spec snake_case completion + Phase 3 legacy deletion (531/559 passing)

trohitg1dc5c5e3d6d1
diff --git a/server/models/nodes.py b/server/models/nodes.py
deleted file mode 100644
index df0da4c6..00000000
--- a/server/models/nodes.py
+++ /dev/null
@@ -1,1788 +0,0 @@
-"""Pydantic models for node validation with discriminated unions.
-
-This module provides type-safe node validation using Pydantic v2 discriminated unions.
-Benefits:
-- O(1) hash map lookup vs O(n) sequential validation
-- Better error messages (identifies exact expected variant)
-- Type safety with IDE autocompletion
-- Automatic API documentation generation
-"""
-
-from typing import Literal, Union, Annotated, Optional, Dict, Any, List
-from pydantic import BaseModel, Field, TypeAdapter
-from datetime import datetime
-
-from constants import (
- AI_CHAT_MODEL_TYPES,
- AI_AGENT_TYPES,
- AI_MEMORY_TYPES,
- GOOGLE_MAPS_TYPES,
- ANDROID_SERVICE_NODE_TYPES,
- WHATSAPP_TYPES,
- CHAT_TYPES,
- CODE_EXECUTOR_TYPES,
- HTTP_TYPES,
- TEXT_TYPES,
- WORKFLOW_CONTROL_TYPES,
- TRIGGER_TYPES,
- POLLING_TRIGGER_TYPES,
-)
-
-
-# =============================================================================
-# BASE MODELS
-# =============================================================================
-
-class BaseNodeParams(BaseModel):
- """Base class for all node parameters."""
- model_config = {"extra": "allow"} # Allow extra fields for flexibility
-
-
-# =============================================================================
-# AI NODE MODELS
-# =============================================================================
-
-class AIChatModelParams(BaseNodeParams):
- """Parameters for AI chat model nodes.
-
- Wave 10.G.2 restored the per-provider tuning fields Wave 9.2 dropped
- (topP/topK/penalties/thinking/reasoning/responseFormat/safetySettings).
- Each is gated via ``displayOptions.show.type`` so users only see the
- knobs their selected provider actually honours.
- """
- type: Literal["openaiChatModel", "anthropicChatModel", "geminiChatModel", "openrouterChatModel", "groqChatModel", "cerebrasChatModel", "deepseekChatModel", "kimiChatModel", "mistralChatModel"]
- prompt: str = Field(default="", json_schema_extra={"rows": 4, "placeholder": "{{ $json.message }}"})
- model: str = Field(default="", json_schema_extra={"placeholder": "Select a model..."})
- temperature: float = Field(
- default=0.7, ge=0.0, le=2.0,
- json_schema_extra={"numberStepSize": 0.1},
- )
- max_tokens: Optional[int] = Field(default=1000, alias="maxTokens", ge=1, le=128000)
- system_prompt: Optional[str] = Field(
- default="", alias="systemMessage",
- json_schema_extra={"rows": 3, "placeholder": "You are a helpful assistant."},
- )
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
- # ---- provider-specific tuning (gated on `type` discriminator) ----
- top_p: Optional[float] = Field(
- default=1.0, alias="topP", ge=0.0, le=1.0,
- json_schema_extra={"numberStepSize": 0.1},
- )
- top_k: Optional[int] = Field(
- default=40, alias="topK", ge=1, le=100,
- json_schema_extra={
- "displayOptions": {"show": {"type": ["anthropicChatModel", "geminiChatModel"]}},
- },
- )
- frequency_penalty: Optional[float] = Field(
- default=0.0, alias="frequencyPenalty", ge=-2.0, le=2.0,
- json_schema_extra={
- "numberStepSize": 0.1,
- "displayOptions": {"show": {"type": ["openaiChatModel", "openrouterChatModel", "deepseekChatModel"]}},
- },
- )
- presence_penalty: Optional[float] = Field(
- default=0.0, alias="presencePenalty", ge=-2.0, le=2.0,
- json_schema_extra={
- "numberStepSize": 0.1,
- "displayOptions": {"show": {"type": ["openaiChatModel", "openrouterChatModel", "deepseekChatModel"]}},
- },
- )
- response_format: Optional[Literal["text", "json_object"]] = Field(
- default="text", alias="responseFormat",
- json_schema_extra={"displayOptions": {"show": {"type": ["openaiChatModel"]}}},
- )
- safety_settings: Optional[Literal["default", "strict", "permissive"]] = Field(
- default="default", alias="safetySettings",
- json_schema_extra={"displayOptions": {"show": {"type": ["geminiChatModel"]}}},
- )
- thinking_enabled: bool = Field(
- default=False, alias="thinkingEnabled",
- json_schema_extra={
- "displayOptions": {"show": {"type": ["anthropicChatModel", "geminiChatModel", "openaiChatModel", "groqChatModel", "cerebrasChatModel"]}},
- },
- )
- thinking_budget: Optional[int] = Field(
- default=2048, alias="thinkingBudget", ge=1024, le=16000,
- json_schema_extra={
- "displayOptions": {"show": {"thinking_enabled": [True], "type": ["anthropicChatModel", "geminiChatModel", "cerebrasChatModel"]}},
- },
- )
- reasoning_effort: Optional[Literal["minimal", "low", "medium", "high"]] = Field(
- default="medium", alias="reasoningEffort",
- json_schema_extra={
- "displayOptions": {"show": {"thinking_enabled": [True], "type": ["openaiChatModel"]}},
- },
- )
- reasoning_format: Optional[Literal["parsed", "hidden"]] = Field(
- default="parsed", alias="reasoningFormat",
- json_schema_extra={
- "displayOptions": {"show": {"thinking_enabled": [True], "type": ["groqChatModel"]}},
- },
- )
-
-
-class AIAgentParams(BaseNodeParams):
- """Parameters for AI agent node."""
- type: Literal["aiAgent"]
- prompt: str = Field(
- default="",
- json_schema_extra={
- "placeholder": "Enter your prompt or use template variables...",
- "rows": 4,
- },
- )
- provider: Literal["openai", "anthropic", "gemini", "openrouter", "groq", "cerebras", "deepseek", "kimi", "mistral"] = "openai"
- model: str = Field(default="", json_schema_extra={"placeholder": "Select a model..."})
- temperature: float = Field(
- default=0.7, ge=0.0, le=2.0,
- json_schema_extra={"numberStepSize": 0.1},
- )
- max_tokens: Optional[int] = Field(default=1000, alias="maxTokens", ge=1, le=200000)
- system_message: Optional[str] = Field(
- default="You are a helpful assistant",
- alias="systemMessage",
- json_schema_extra={"rows": 3},
- )
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
-
-class ChatAgentParams(BaseNodeParams):
- """Parameters for chat agent node (skill-based)."""
- type: Literal["chatAgent"]
- provider: Literal["openai", "anthropic", "gemini", "openrouter", "groq", "cerebras", "deepseek", "kimi", "mistral"] = "openai"
- model: str = Field(default="", json_schema_extra={"placeholder": "Select a model..."})
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
-
-class SpecializedAgentParams(BaseNodeParams):
- """Parameters for all specialized agent nodes. Mirrors the full
- AI_AGENT_PROPERTIES surface from the frontend so the NodeSpec
- parameter panel renders identically across all 16 specialized
- agent types."""
- type: Literal[
- "android_agent", "coding_agent", "web_agent", "task_agent",
- "social_agent", "travel_agent", "tool_agent", "productivity_agent",
- "payments_agent", "consumer_agent", "autonomous_agent",
- "orchestrator_agent", "ai_employee", "rlm_agent", "claude_code_agent",
- "deep_agent",
- ]
- prompt: str = Field(
- default="",
- json_schema_extra={
- "placeholder": "Enter your prompt or use template variables...",
- "rows": 4,
- },
- )
- provider: Literal["openai", "anthropic", "gemini", "openrouter", "groq", "cerebras", "deepseek", "kimi", "mistral"] = "openai"
- model: str = Field(default="", json_schema_extra={"placeholder": "Select a model..."})
- temperature: float = Field(
- default=0.7, ge=0.0, le=2.0,
- json_schema_extra={"numberStepSize": 0.1},
- )
- max_tokens: Optional[int] = Field(default=1000, alias="maxTokens", ge=1, le=200000)
- system_message: Optional[str] = Field(
- default="",
- alias="systemMessage",
- json_schema_extra={"rows": 3},
- )
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
- thinking_budget: int = Field(
- default=2048, alias="thinkingBudget", ge=1024, le=16000,
- json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
- )
- reasoning_effort: Literal["minimal", "low", "medium", "high"] = Field(
- default="medium", alias="reasoningEffort",
- json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
- )
-
-
-class SimpleMemoryParams(BaseNodeParams):
- """Parameters for simple memory node."""
- type: Literal["simpleMemory"]
- session_id: str = Field(default="default", alias="sessionId")
- memory_type: Literal["buffer", "window"] = Field(default="buffer", alias="memoryType")
- window_size: int = Field(default=10, alias="windowSize", ge=1, le=100)
- clear_on_run: bool = Field(default=False, alias="clearOnRun")
-
-
-# =============================================================================
-# GOOGLE MAPS NODE MODELS
-# =============================================================================
-
-class CreateMapParams(BaseNodeParams):
- """Parameters for GMaps Create node."""
- type: Literal["gmaps_create"]
- center_lat: float = Field(default=0.0, alias="centerLat")
- center_lng: float = Field(default=0.0, alias="centerLng")
- zoom: int = Field(default=10, ge=1, le=20)
- map_type: Literal["roadmap", "satellite", "terrain", "hybrid"] = Field(default="roadmap", alias="mapType")
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
-
-class GmapsLocationsParams(BaseNodeParams):
- """Parameters for GMaps Locations (geocoding) node."""
- type: Literal["gmaps_locations"]
- address: str = Field(default="", json_schema_extra={"placeholder": "1600 Amphitheatre Pkwy, Mountain View, CA"})
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
-
-class GmapsNearbyPlacesParams(BaseNodeParams):
- """Parameters for GMaps Nearby Places node."""
- type: Literal["gmaps_nearby_places"]
- latitude: float = 0.0
- longitude: float = 0.0
- radius: int = Field(default=1000, ge=1, le=50000)
- place_type: str = Field(default="restaurant", alias="placeType")
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
-
-# =============================================================================
-# ANDROID NODE MODELS
-# =============================================================================
-
-class AndroidServiceParams(BaseNodeParams):
- """Parameters for Android service nodes (battery, network, wifi, etc.)."""
- type: str # Validated separately against ANDROID_SERVICE_NODE_TYPES
- service_id: str = Field(default="battery", alias="service_id")
- action: str = Field(default="status")
- parameters: Dict[str, Any] = Field(default_factory=dict)
- android_host: str = Field(default="localhost", alias="android_host")
- android_port: int = Field(default=8888, alias="android_port", ge=1, le=65535)
-
-
-# =============================================================================
-# WHATSAPP NODE MODELS
-# =============================================================================
-
-class WhatsAppSendParams(BaseNodeParams):
- """Parameters for WhatsApp send message node."""
- type: Literal["whatsappSend"]
- recipient_type: Literal["self", "phone", "group", "channel"] = Field(default="self", alias="recipientType")
- phone_number: str = Field(
- default="",
- alias="phoneNumber",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["phone"]}}},
- )
- group_id: str = Field(
- default="",
- alias="groupId",
- json_schema_extra={
- "displayOptions": {"show": {"recipient_type": ["group"]}},
- "loadOptionsMethod": "whatsappGroups",
- },
- )
- channel_jid: str = Field(
- default="",
- alias="channelJid",
- json_schema_extra={
- "displayOptions": {"show": {"recipient_type": ["channel"]}},
- "loadOptionsMethod": "whatsappChannels",
- },
- )
- message: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["text"]}}},
- )
- message_type: Literal["text", "image", "video", "audio", "document", "sticker", "location", "contact"] = Field(default="text", alias="messageType")
- media_url: str = Field(
- default="",
- alias="mediaUrl",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["image", "video", "audio", "document", "sticker"]}}},
- )
-
-
-class WhatsAppReceiveParams(BaseNodeParams):
- """Parameters for WhatsApp receive (trigger) node."""
- type: Literal["whatsappReceive"]
- message_type_filter: str = Field(default="all", alias="messageTypeFilter")
- sender_filter: str = Field(default="all", alias="filter")
- contact_phone: str = Field(
- default="", alias="contactPhone",
- json_schema_extra={
- "placeholder": "+1234567890",
- "displayOptions": {"show": {"filter": ["contact"]}},
- },
- )
- group_id: str = Field(
- default="", alias="group_id",
- json_schema_extra={
- "loadOptionsMethod": "whatsappGroups",
- "displayOptions": {"show": {"filter": ["group"]}},
- },
- )
- sender_number: str = Field(
- default="", alias="senderNumber",
- json_schema_extra={
- "loadOptionsMethod": "whatsappGroupMembers",
- "displayOptions": {"show": {"filter": ["group"]}},
- },
- )
- keywords: str = Field(
- default="",
- json_schema_extra={
- "placeholder": "hello, urgent, help",
- "displayOptions": {"show": {"filter": ["keywords"]}},
- },
- )
- ignore_own: bool = Field(default=True, alias="ignoreOwnMessages")
- include_media: bool = Field(default=False, alias="includeMediaData")
- forwarded_filter: str = Field(default="all", alias="forwardedFilter")
-
-
-class WhatsAppDbParams(BaseNodeParams):
- """Parameters for WhatsApp database query node."""
- type: Literal["whatsappDb"]
- operation: Literal["chat_history", "search_groups", "get_group_info", "get_contact_info", "list_contacts", "check_contacts"] = "chat_history"
- # chat_history params
- phone_number: str = Field(default="", alias="phoneNumber")
- group_id: str = Field(default="", alias="groupId")
- group_name: str = Field(default="", alias="groupName")
- limit: int = Field(default=50, ge=1, le=500)
- offset: int = Field(default=0, ge=0)
- # search_groups params
- search_query: str = Field(default="", alias="searchQuery")
- # check_contacts params
- phone_numbers: str = Field(default="", alias="phoneNumbers")
-
-
-# =============================================================================
-# CODE EXECUTOR NODE MODELS
-# =============================================================================
-
-class PythonExecutorParams(BaseNodeParams):
- """Parameters for Python code executor node."""
- type: Literal["pythonExecutor"]
- code: str = Field(
- default="",
- json_schema_extra={"editor": "code", "editorLanguage": "python", "rows": 8},
- )
- timeout: int = Field(default=30, ge=1, le=300)
-
-
-class JavaScriptExecutorParams(BaseNodeParams):
- """Parameters for JavaScript code executor node."""
- type: Literal["javascriptExecutor"]
- code: str = Field(
- default="",
- json_schema_extra={"editor": "code", "editorLanguage": "javascript", "rows": 8},
- )
- timeout: int = Field(default=30, ge=1, le=300)
-
-
-class TypeScriptExecutorParams(BaseNodeParams):
- """Parameters for TypeScript code executor node (compiles to JS
- via the Node.js server with tsx)."""
- type: Literal["typescriptExecutor"]
- code: str = Field(
- default="",
- json_schema_extra={"editor": "code", "editorLanguage": "typescript", "rows": 8},
- )
- timeout: int = Field(default=30, ge=1, le=300)
-
-
-class ProcessManagerParams(BaseNodeParams):
- """Parameters for long-running process manager node."""
- type: Literal["processManager"]
- tool_name: str = Field(default="process_manager", alias="toolName")
- tool_description: str = Field(
- default="", alias="toolDescription",
- json_schema_extra={"rows": 4, "placeholder": "Describe what this process does..."},
- )
- operation: Literal["start", "stop", "restart", "send_input", "list", "get_output"] = "start"
- name: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["start", "stop", "restart", "send_input", "get_output"]}}},
- )
- command: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["start"]}}},
- )
- cwd: Optional[str] = Field(
- default=None,
- json_schema_extra={"displayOptions": {"show": {"operation": ["start"]}}},
- )
- input: Optional[str] = Field(
- default=None,
- json_schema_extra={"displayOptions": {"show": {"operation": ["send_input"]}}},
- )
-
-
-# =============================================================================
-# HTTP NODE MODELS
-# =============================================================================
-
-class HttpRequestParams(BaseNodeParams):
- """Parameters for HTTP request node."""
- type: Literal["httpRequest"]
- url: str = ""
- method: Literal["GET", "POST", "PUT", "DELETE", "PATCH"] = "GET"
- headers: Dict[str, str] = Field(default_factory=dict)
- body: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"method": ["POST", "PUT", "PATCH"]}}},
- )
- timeout: int = Field(default=30, ge=1, le=300)
- use_proxy: bool = Field(default=False, alias="useProxy")
- proxy_country: str = Field(
- default="",
- alias="proxyCountry",
- json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
- )
- proxy_provider: str = Field(
- default="",
- alias="proxyProvider",
- json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
- )
- session_type: Literal["rotating", "sticky"] = Field(
- default="rotating",
- alias="sessionType",
- json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
- )
-
-
-class WebhookTriggerParams(BaseNodeParams):
- """Parameters for webhook trigger node."""
- type: Literal["webhookTrigger"]
- path: str = ""
- method: Literal["GET", "POST", "PUT", "DELETE", "ALL"] = Field(default="POST")
- response_mode: Literal["immediate", "responseNode"] = Field(
- default="immediate",
- alias="responseMode",
- json_schema_extra={"options": [
- {"name": "Immediate (200 OK)", "value": "immediate"},
- {"name": "Wait for Response Node", "value": "responseNode"},
- ]},
- )
- authentication: Literal["none", "header"] = Field(
- default="none",
- json_schema_extra={"options": [
- {"name": "None", "value": "none"},
- {"name": "Header Auth", "value": "header"},
- ]},
- )
- header_name: str = Field(
- default="X-API-Key",
- alias="headerName",
- json_schema_extra={"displayOptions": {"show": {"authentication": ["header"]}}},
- )
- header_value: str = Field(
- default="",
- alias="headerValue",
- json_schema_extra={
- "displayOptions": {"show": {"authentication": ["header"]}},
- "password": True,
- },
- )
-
-
-class WebhookResponseParams(BaseNodeParams):
- """Parameters for webhook response node."""
- type: Literal["webhookResponse"]
- status_code: int = Field(default=200, alias="statusCode", ge=100, le=599)
- content_type: Literal["application/json", "text/plain", "text/html"] = Field(
- default="application/json",
- alias="contentType",
- json_schema_extra={"options": [
- {"name": "JSON", "value": "application/json"},
- {"name": "Text", "value": "text/plain"},
- {"name": "HTML", "value": "text/html"},
- ]},
- )
- response_body: str = Field(
- default="",
- alias="responseBody",
- json_schema_extra={"rows": 4},
- )
- body: str = "" # legacy alias
-
-
-class ConsoleParams(BaseNodeParams):
- """Parameters for console log node (passes input through)."""
- type: Literal["console"]
- label: str = ""
- log_mode: Literal["all", "field", "expression"] = Field(
- default="all",
- alias="logMode",
- json_schema_extra={"options": [
- {"name": "Log All Input", "value": "all"},
- {"name": "Log Specific Field", "value": "field"},
- {"name": "Log Expression", "value": "expression"},
- ]},
- )
- field_path: str = Field(
- default="",
- alias="fieldPath",
- json_schema_extra={"displayOptions": {"show": {"log_mode": ["field"]}}},
- )
- expression: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"log_mode": ["expression"]}}},
- )
- format: Literal["json", "json_compact", "text", "table"] = Field(
- default="json",
- json_schema_extra={"options": [
- {"name": "JSON (Pretty)", "value": "json"},
- {"name": "JSON (Compact)", "value": "json_compact"},
- {"name": "Text", "value": "text"},
- {"name": "Table", "value": "table"},
- ]},
- )
-
-
-class TeamMonitorParams(BaseNodeParams):
- """Parameters for agent-team monitor node."""
- type: Literal["teamMonitor"]
- refresh_interval: int = Field(default=1000, alias="refreshInterval", ge=0, le=60_000)
- show_task_history: bool = Field(default=True, alias="showTaskHistory")
- show_messages: bool = Field(default=True, alias="showMessages")
- max_history_items: int = Field(default=50, alias="maxHistoryItems", ge=10, le=200)
-
-
-# =============================================================================
-# WORKFLOW CONTROL NODE MODELS
-# =============================================================================
-
-class StartNodeParams(BaseNodeParams):
- """Parameters for start node."""
- type: Literal["start"]
- initial_data: str = Field(
- default="{}",
- alias="initialData",
- json_schema_extra={"rows": 6},
- )
-
-
-class CronSchedulerParams(BaseNodeParams):
- """Parameters for cron scheduler node. Also used as AI tool schema."""
- type: Literal["cronScheduler"]
- frequency: Literal["seconds", "minutes", "hours", "days", "weeks", "months", "once"] = Field(
- default="minutes",
- description="Schedule frequency",
- json_schema_extra={"options": [
- {"name": "Seconds", "value": "seconds"},
- {"name": "Minutes", "value": "minutes"},
- {"name": "Hours", "value": "hours"},
- {"name": "Days", "value": "days"},
- {"name": "Weeks", "value": "weeks"},
- {"name": "Months", "value": "months"},
- {"name": "Once (No Repeat)", "value": "once"},
- ]},
- )
- interval: int = Field(
- default=30, ge=5, le=59,
- json_schema_extra={"displayOptions": {"show": {"frequency": ["seconds"]}}},
- )
- interval_minutes: int = Field(
- default=5, ge=1, le=59,
- json_schema_extra={"displayOptions": {"show": {"frequency": ["minutes"]}}},
- )
- interval_hours: int = Field(
- default=1, ge=1, le=23,
- json_schema_extra={"displayOptions": {"show": {"frequency": ["hours"]}}},
- )
- daily_time: str = Field(
- default="09:00",
- json_schema_extra={
- "displayOptions": {"show": {"frequency": ["days"]}},
- "options": [
- {"name": "00:00 (Midnight)", "value": "00:00"},
- {"name": "06:00", "value": "06:00"},
- {"name": "08:00", "value": "08:00"},
- {"name": "09:00", "value": "09:00"},
- {"name": "10:00", "value": "10:00"},
- {"name": "12:00 (Noon)", "value": "12:00"},
- {"name": "14:00", "value": "14:00"},
- {"name": "16:00", "value": "16:00"},
- {"name": "18:00", "value": "18:00"},
- {"name": "20:00", "value": "20:00"},
- {"name": "22:00", "value": "22:00"},
- ],
- },
- )
- weekday: str = Field(
- default="1",
- json_schema_extra={
- "displayOptions": {"show": {"frequency": ["weeks"]}},
- "options": [
- {"name": "Sunday", "value": "0"},
- {"name": "Monday", "value": "1"},
- {"name": "Tuesday", "value": "2"},
- {"name": "Wednesday", "value": "3"},
- {"name": "Thursday", "value": "4"},
- {"name": "Friday", "value": "5"},
- {"name": "Saturday", "value": "6"},
- ],
- },
- )
- weekly_time: str = Field(
- default="09:00",
- json_schema_extra={"displayOptions": {"show": {"frequency": ["weeks"]}}},
- )
- month_day: str = Field(
- default="1",
- json_schema_extra={"displayOptions": {"show": {"frequency": ["months"]}}},
- )
- monthly_time: str = Field(
- default="09:00",
- json_schema_extra={"displayOptions": {"show": {"frequency": ["months"]}}},
- )
- timezone: str = Field(
- default="UTC",
- json_schema_extra={"options": [
- {"name": "UTC", "value": "UTC"},
- {"name": "US Eastern", "value": "America/New_York"},
- {"name": "US Pacific", "value": "America/Los_Angeles"},
- {"name": "UK", "value": "Europe/London"},
- {"name": "Europe Central", "value": "Europe/Paris"},
- {"name": "Japan", "value": "Asia/Tokyo"},
- {"name": "India", "value": "Asia/Kolkata"},
- ]},
- )
-
-
-class WorkflowTriggerParams(BaseNodeParams):
- """Parameters for workflow trigger / timer node."""
- type: Literal["workflowTrigger", "timer"]
- duration: int = Field(default=5, ge=1, le=3600)
- unit: Literal["seconds", "minutes", "hours"] = Field(
- default="seconds",
- json_schema_extra={"options": [
- {"name": "Seconds", "value": "seconds"},
- {"name": "Minutes", "value": "minutes"},
- {"name": "Hours", "value": "hours"},
- ]},
- )
-
-
-class TaskTriggerParams(BaseNodeParams):
- """Parameters for task trigger node (fires on delegated agent completion)."""
- type: Literal["taskTrigger"]
- task_id: str = Field(default="", alias="taskId")
- agent_name: str = Field(default="", alias="agentName")
- status_filter: Literal["all", "completed", "error"] = Field(
- default="all",
- alias="statusFilter",
- json_schema_extra={
- "options": [
- {"name": "All", "value": "all"},
- {"name": "Completed Only", "value": "completed"},
- {"name": "Errors Only", "value": "error"},
- ]
- },
- )
- parent_node_id: str = Field(default="", alias="parentNodeId")
- parent_node_id: str = Field(default="", alias="parentNodeId")
-
-
-class ChatTriggerParams(BaseNodeParams):
- """Parameters for chat trigger node."""
- type: Literal["chatTrigger"]
- session_id: str = Field(default="default", alias="sessionId")
- placeholder: str = "Type a message..."
-
-
-class MasterSkillParams(BaseNodeParams):
- """Parameters for Master Skill aggregator node. The skillsConfig
- object is opaque to the backend - each enabled skill carries its
- own instructions string. Shape:
- ``{skill_name: {enabled: bool, instructions: str, isCustomized: bool}}``."""
- type: Literal["masterSkill"]
- skill_folder: str = Field(default="assistant", alias="skillFolder")
- skills_config: Dict[str, Any] = Field(default_factory=dict, alias="skillsConfig")
-
-
-class TelegramReceiveParams(BaseNodeParams):
- """Parameters for Telegram receive trigger node.
-
- Field names match main-branch baseline: ``contentTypeFilter`` /
- ``senderFilter`` / ``ignoreBots`` are camelCase in the UI, while
- ``chat_id`` / ``from_user`` / ``keywords`` are snake_case. The Pydantic
- JSON Schema output (alias when set, field name otherwise) MUST be
- what ``displayOptions.show`` references — otherwise the frontend's
- ``shouldShowParameter`` lookup never resolves and conditional fields
- never appear.
- """
- type: Literal["telegramReceive"]
- content_type_filter: Literal["all", "text", "photo", "video", "audio", "voice", "document", "sticker", "location", "contact", "poll"] = Field(
- default="all",
- alias="contentTypeFilter",
- description="Filter by message content type",
- json_schema_extra={"options": [
- {"name": "All Types", "value": "all"},
- {"name": "Text Only", "value": "text"},
- {"name": "Photo Only", "value": "photo"},
- {"name": "Video Only", "value": "video"},
- {"name": "Audio Only", "value": "audio"},
- {"name": "Voice Only", "value": "voice"},
- {"name": "Document Only", "value": "document"},
- {"name": "Sticker Only", "value": "sticker"},
- {"name": "Location Only", "value": "location"},
- {"name": "Contact Only", "value": "contact"},
- {"name": "Poll Only", "value": "poll"},
- ]},
- )
- sender_filter: Literal["all", "self", "private", "group", "supergroup", "channel", "specific_chat", "specific_user", "keywords"] = Field(
- default="all",
- alias="senderFilter",
- description="Filter which messages trigger the workflow",
- json_schema_extra={"options": [
- {"name": "All Messages", "value": "all"},
- {"name": "From Self (Bot Owner)", "value": "self"},
- {"name": "Private Chats Only", "value": "private"},
- {"name": "Groups Only", "value": "group"},
- {"name": "Supergroups Only", "value": "supergroup"},
- {"name": "Channels Only", "value": "channel"},
- {"name": "From Specific Chat", "value": "specific_chat"},
- {"name": "From Specific User", "value": "specific_user"},
- {"name": "Contains Keywords", "value": "keywords"},
- ]},
- )
- # chat_id / from_user / keywords: baseline uses snake_case UI names,
- # so Pydantic field = snake_case with NO alias. JSON Schema key ==
- # field name, displayOptions.show references the camelCase aliases of
- # the driver fields (senderFilter) since those ARE aliased.
- chat_id: str = Field(
- default="",
- description="Only trigger for messages from this specific chat ID",
- json_schema_extra={"displayOptions": {"show": {"senderFilter": ["specific_chat"]}}},
- )
- from_user: str = Field(
- default="",
- description="Only trigger for messages from this specific user ID",
- json_schema_extra={"displayOptions": {"show": {"senderFilter": ["specific_user"]}}},
- )
- keywords: str = Field(
- default="",
- description="Comma-separated keywords to trigger on (case-insensitive)",
- json_schema_extra={"displayOptions": {"show": {"senderFilter": ["keywords"]}}},
- )
- ignore_bots: bool = Field(
- default=True,
- alias="ignoreBots",
- description="Do not trigger on messages from other bots",
- json_schema_extra={"displayOptions": {"show": {"senderFilter": [
- "all", "private", "group", "supergroup", "channel",
- "specific_chat", "specific_user", "keywords",
- ]}}},
- )
-
-
-class TwitterReceiveParams(BaseNodeParams):
- """Parameters for Twitter receive trigger node (polling-based)."""
- type: Literal["twitterReceive"]
- trigger_type: Literal["mentions", "search", "timeline"] = Field(
- default="mentions",
- alias="triggerType",
- json_schema_extra={"options": [
- {"name": "Mentions", "value": "mentions"},
- {"name": "Search Results", "value": "search"},
- {"name": "User Timeline", "value": "timeline"},
- ]},
- )
- search_query: str = Field(
- default="",
- alias="searchQuery",
- json_schema_extra={"displayOptions": {"show": {"trigger_type": ["search"]}}},
- )
- user_id: str = Field(
- default="",
- alias="userId",
- json_schema_extra={"displayOptions": {"show": {"trigger_type": ["timeline"]}}},
- )
- filter_retweets: bool = Field(default=True, alias="filterRetweets")
- filter_replies: bool = Field(default=False, alias="filterReplies")
- poll_interval: int = Field(default=60, alias="pollInterval", ge=15, le=3600)
-
-
-class TelegramSendParams(BaseNodeParams):
- """Parameters for Telegram send message node.
-
- Matches main-branch baseline field names (all snake_case, no aliases).
- ``displayOptions.show`` keys reference the JSON Schema output keys —
- which, with no aliases, ARE the field names.
- """
- type: Literal["telegramSend"]
-
- # ===== RECIPIENT =====
- recipient_type: Literal["self", "user", "group"] = Field(
- default="self",
- description="Send to bot owner (self), specific user, or group",
- json_schema_extra={"options": [
- {"name": "Self (Bot Owner)", "value": "self"},
- {"name": "User / Chat ID", "value": "user"},
- {"name": "Group", "value": "group"},
- ]},
- )
- chat_id: str = Field(
- default="",
- description="Telegram chat ID (numeric) or @username",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["user", "group"]}}},
- )
-
- # ===== MESSAGE TYPE =====
- message_type: Literal["text", "photo", "document", "location", "contact"] = Field(
- default="text",
- description="Type of message to send",
- json_schema_extra={"options": [
- {"name": "Text", "value": "text"},
- {"name": "Photo", "value": "photo"},
- {"name": "Document", "value": "document"},
- {"name": "Location", "value": "location"},
- {"name": "Contact", "value": "contact"},
- ]},
- )
-
- # ===== TEXT =====
- text: str = Field(
- default="",
- description="Text message content",
- json_schema_extra={
- "rows": 4,
- "displayOptions": {"show": {"message_type": ["text"]}},
- },
- )
-
- # ===== MEDIA (photo / document) =====
- media_url: str = Field(
- default="",
- description="URL of the media file or file_id from a previous message",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["photo", "document"]}}},
- )
- caption: str = Field(
- default="",
- description="Optional caption for media",
- json_schema_extra={
- "rows": 2,
- "displayOptions": {"show": {"message_type": ["photo", "document"]}},
- },
- )
-
- # ===== LOCATION =====
- latitude: float = Field(
- default=0.0,
- description="Location latitude (-90 to 90)",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["location"]}}},
- )
- longitude: float = Field(
- default=0.0,
- description="Location longitude (-180 to 180)",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["location"]}}},
- )
-
- # ===== CONTACT =====
- phone_number: str = Field(
- default="",
- description="Contact phone number (with country code, e.g. +1234567890)",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
- )
- first_name: str = Field(
- default="",
- description="Contact first name",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
- )
- last_name: str = Field(
- default="",
- description="Contact last name (optional)",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
- )
-
- # ===== OPTIONS =====
- parse_mode: Literal["Auto", "", "HTML", "Markdown", "MarkdownV2"] = Field(
- default="Auto",
- description=(
- "Auto converts LLM markdown to Telegram HTML. Empty string = "
- "no parse mode (raw text)."
- ),
- json_schema_extra={
- "options": [
- {"name": "Auto (Recommended)", "value": "Auto"},
- {"name": "None", "value": ""},
- {"name": "HTML", "value": "HTML"},
- {"name": "Markdown", "value": "Markdown"},
- {"name": "MarkdownV2", "value": "MarkdownV2"},
- ],
- "displayOptions": {"show": {"message_type": ["text", "photo", "document"]}},
- },
- )
- silent: bool = Field(
- default=False,
- description="Send message without notification sound",
- )
- reply_to_message_id: int = Field(
- default=0,
- description="If > 0, sends the message as a reply to this message ID",
- )
-
-
-class TwitterSendParams(BaseNodeParams):
- """Parameters for Twitter send/action node."""
- type: Literal["twitterSend"]
- action: Literal["tweet", "reply", "retweet", "like", "unlike", "delete"] = "tweet"
- text: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"action": ["tweet", "reply", "quote"]}}},
- )
- tweet_id: str = Field(
- default="",
- alias="tweetId",
- json_schema_extra={"displayOptions": {"show": {"action": ["reply", "retweet", "quote", "like", "unlike", "delete"]}}},
- )
- include_media: bool = Field(
- default=False,
- alias="includeMedia",
- json_schema_extra={"displayOptions": {"show": {"action": ["tweet", "reply", "quote"]}}},
- )
- media_urls: List[str] = Field(
- default_factory=list,
- alias="mediaUrls",
- json_schema_extra={"displayOptions": {"show": {"action": ["tweet", "reply", "quote"], "include_media": [True]}}},
- )
- include_poll: bool = Field(
- default=False,
- alias="includePoll",
- json_schema_extra={"displayOptions": {"show": {"action": ["tweet"]}}},
- )
- poll_options: List[str] = Field(
- default_factory=list,
- alias="pollOptions",
- json_schema_extra={"displayOptions": {"show": {"action": ["tweet"], "include_poll": [True]}}},
- )
- poll_duration_minutes: int = Field(
- default=1440,
- alias="pollDurationMinutes",
- ge=5, le=10080,
- json_schema_extra={"displayOptions": {"show": {"action": ["tweet"], "include_poll": [True]}}},
- )
-
-
-class TwitterSearchParams(BaseNodeParams):
- """Parameters for Twitter search node."""
- type: Literal["twitterSearch"]
- query: str = ""
- max_results: int = Field(default=10, alias="maxResults", ge=10, le=100)
- sort_order: Literal["recency", "relevancy"] = Field(default="recency", alias="sortOrder")
- start_time: Optional[str] = Field(default=None, alias="startTime")
- end_time: Optional[str] = Field(default=None, alias="endTime")
- include_metrics: bool = Field(default=True, alias="includeMetrics")
- include_author: bool = Field(default=True, alias="includeAuthor")
-
-
-class TwitterUserParams(BaseNodeParams):
- """Parameters for Twitter user lookup node."""
- type: Literal["twitterUser"]
- operation: Literal["me", "by_username", "by_id", "followers", "following"] = "me"
- username: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["by_username"]}}},
- )
- user_id: str = Field(
- default="",
- alias="userId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["by_id", "followers", "following"]}}},
- )
- max_results: int = Field(
- default=100,
- alias="maxResults",
- ge=1, le=1000,
- json_schema_extra={"displayOptions": {"show": {"operation": ["followers", "following"]}}},
- )
-
-
-class SocialReceiveParams(BaseNodeParams):
- """Parameters for unified social receive trigger node."""
- type: Literal["socialReceive"]
- channel_filter: str = Field(default="all", alias="channelFilter")
- message_type_filter: str = Field(default="all", alias="messageTypeFilter")
- sender_filter: Literal["all", "any_contact", "contact", "group", "keywords"] = Field(
- default="all",
- alias="senderFilter",
- json_schema_extra={"options": [
- {"name": "All Messages", "value": "all"},
- {"name": "From Any Contact (Non-Group)", "value": "any_contact"},
- {"name": "From Specific Contact", "value": "contact"},
- {"name": "From Specific Group", "value": "group"},
- {"name": "Contains Keywords", "value": "keywords"},
- ]},
- )
- contact_phone: str = Field(
- default="", alias="contactPhone",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["contact"]}}},
- )
- group_id: str = Field(
- default="", alias="groupId",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["group"]}}},
- )
- keywords: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["keywords"]}}},
- )
- ignore_own_messages: bool = Field(default=True, alias="ignoreOwnMessages")
- ignore_bots: bool = Field(default=False, alias="ignoreBots")
- include_media_data: bool = Field(default=False, alias="includeMediaData")
-
-
-class SocialSendParams(BaseNodeParams):
- """Parameters for unified social send node."""
- type: Literal["socialSend"]
- channel: Literal["whatsapp", "telegram", "discord", "slack", "signal", "sms", "webchat", "email", "matrix", "teams"] = "whatsapp"
- recipient_type: Literal["phone", "group", "channel", "user", "chat"] = Field(
- default="phone", alias="recipientType",
- json_schema_extra={"options": [
- {"name": "Phone Number", "value": "phone"},
- {"name": "Group", "value": "group"},
- {"name": "Channel", "value": "channel"},
- {"name": "User ID", "value": "user"},
- {"name": "Chat ID", "value": "chat"},
- ]},
- )
- phone: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["phone"]}}},
- )
- group_id: str = Field(
- default="", alias="groupId",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["group"]}}},
- )
- channel_id: str = Field(
- default="", alias="channelId",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["channel"]}}},
- )
- user_id: str = Field(
- default="", alias="userId",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["user"]}}},
- )
- chat_id: str = Field(
- default="", alias="chatId",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["chat"]}}},
- )
- thread_id: str = Field(default="", alias="threadId")
- message_type: Literal["text", "image", "video", "audio", "document", "sticker", "location", "contact", "poll", "buttons", "list"] = Field(default="text", alias="messageType")
- message: str = Field(
- default="",
- json_schema_extra={
- "displayOptions": {"show": {"message_type": ["text"]}},
- "rows": 4,
- },
- )
- media_url: str = Field(
- default="", alias="mediaUrl",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["image", "video", "audio", "document", "sticker"]}}},
- )
- caption: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["image", "video", "document"]}}},
- )
- silent: bool = False
-
-
-# =============================================================================
-# Phase 3d.ii: 28 input models for output-only node types.
-# Minimal field surface - BaseNodeParams.model_config["extra"] = "allow"
-# carries any handler-specific extras the editor doesn't constrain.
-# =============================================================================
-
-# Search ----------------------------------------------------------------------
-
-class BraveSearchParams(BaseNodeParams):
- type: Literal["braveSearch"]
- query: str = Field(default="", json_schema_extra={"placeholder": "machine learning OR AI"})
- max_results: int = Field(default=10, alias="maxResults", ge=1, le=20)
- country: str = ""
- search_lang: str = Field(default="en", alias="searchLang")
- safe_search: Literal["off", "moderate", "strict"] = Field(default="moderate", alias="safeSearch")
-
-
-class SerperSearchParams(BaseNodeParams):
- type: Literal["serperSearch"]
- query: str = Field(default="", json_schema_extra={"placeholder": "site:example.com python"})
- search_type: Literal["search", "news", "images", "places"] = Field(default="search", alias="searchType")
- max_results: int = Field(default=10, alias="maxResults", ge=1, le=100)
- country: str = ""
- language: str = "en"
-
-
-class PerplexitySearchParams(BaseNodeParams):
- type: Literal["perplexitySearch"]
- query: str = Field(default="", json_schema_extra={"placeholder": "latest advances in vector databases"})
- model: Literal["sonar", "sonar-pro", "sonar-reasoning", "sonar-reasoning-pro"] = "sonar"
- search_recency_filter: Literal["all", "month", "week", "day", "hour"] = Field(default="all", alias="searchRecencyFilter")
- return_images: bool = Field(default=False, alias="returnImages")
- return_related_questions: bool = Field(default=False, alias="returnRelatedQuestions")
-
-
-# Browser / scraping ----------------------------------------------------------
-
-class BrowserParams(BaseNodeParams):
- type: Literal["browser"]
- operation: Literal["navigate", "click", "type", "fill", "screenshot", "snapshot", "get_text", "get_html", "eval", "wait", "scroll", "select", "batch"] = "navigate"
- url: str = ""
- selector: str = ""
- text: str = ""
- session: str = ""
-
-
-class CrawleeScraperParams(BaseNodeParams):
- type: Literal["crawleeScraper"]
- crawler_type: Literal["beautifulsoup", "playwright", "adaptive"] = Field(default="beautifulsoup", alias="crawlerType")
- mode: Literal["single", "crawl"] = "single"
- url: str = ""
- css_selector: str = Field(default="", alias="cssSelector")
- extract_links: bool = Field(default=False, alias="extractLinks")
- max_pages: int = Field(default=10, alias="maxPages", ge=1, le=1000)
- max_depth: int = Field(default=2, alias="maxDepth", ge=1, le=10)
-
-
-class HttpScraperParams(BaseNodeParams):
- type: Literal["httpScraper"]
- url: str = ""
- mode: Literal["single", "date_range", "page_pagination"] = "single"
- css_selector: str = Field(default="", alias="cssSelector")
- max_pages: int = Field(default=1, alias="maxPages", ge=1, le=1000)
-
-
-class ApifyActorParams(BaseNodeParams):
- type: Literal["apifyActor"]
- actor_id: str = Field(default="", alias="actorId")
- actor_input: str = Field(default="{}", alias="actorInput")
- max_results: int = Field(default=100, alias="maxResults", ge=1, le=10000)
- timeout: int = Field(default=300, ge=10, le=3600)
- memory: int = Field(default=2048, ge=128, le=32768)
-
-
-# Email -----------------------------------------------------------------------
-
-class EmailSendParams(BaseNodeParams):
- type: Literal["emailSend"]
- provider: str = ""
- to: str = Field(default="", json_schema_extra={"placeholder": "[email protected]"})
- subject: str = Field(default="", json_schema_extra={"placeholder": "Meeting reminder"})
- body: str = Field(default="", json_schema_extra={"rows": 6, "placeholder": "Write your message..."})
- cc: str = ""
- bcc: str = ""
- body_type: Literal["text", "html"] = Field(default="text", alias="bodyType")
-
-
-class EmailReadParams(BaseNodeParams):
- type: Literal["emailRead"]
- provider: str = ""
- operation: Literal["list", "search", "read", "folders", "move", "delete", "flag"] = "list"
- folder: str = Field(
- default="INBOX",
- json_schema_extra={"displayOptions": {"show": {"operation": ["list", "search"]}}},
- )
- query: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["search"]}}},
- )
- message_id: str = Field(
- default="", alias="messageId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["read", "move", "delete", "flag"]}}},
- )
-
-
-class EmailReceiveParams(BaseNodeParams):
- type: Literal["emailReceive"]
- provider: str = ""
- folder: str = "INBOX"
- poll_interval: int = Field(default=60, alias="pollInterval", ge=30, le=3600)
- filter_query: str = Field(default="", alias="filterQuery")
- mark_as_read: bool = Field(default=False, alias="markAsRead")
-
-
-# Google Workspace ------------------------------------------------------------
-
-class GmailParams(BaseNodeParams):
- type: Literal["gmail"]
- operation: Literal["send", "search", "read"] = "send"
- to: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["send"]}}},
- )
- subject: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["send"]}}},
- )
- body: str = Field(
- default="",
- json_schema_extra={
- "rows": 4,
- "placeholder": "Write your message...",
- "displayOptions": {"show": {"operation": ["send"]}},
- },
- )
- query: str = Field(
- default="",
- json_schema_extra={
- "placeholder": "from:jane subject:meeting",
- "displayOptions": {"show": {"operation": ["search"]}},
- },
- )
- message_id: str = Field(
- default="",
- alias="messageId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["read"]}}},
- )
-
-
-class CalendarParams(BaseNodeParams):
- type: Literal["calendar"]
- operation: Literal["create", "list", "update", "delete"] = "list"
- calendar_id: str = Field(
- default="primary",
- alias="calendarId",
- json_schema_extra={"loadOptionsMethod": "googleCalendarList"},
- )
- event_id: str = Field(
- default="",
- alias="eventId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["update", "delete"]}}},
- )
- summary: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["create", "update"]}}},
- )
- start_time: str = Field(
- default="",
- alias="startTime",
- json_schema_extra={"displayOptions": {"show": {"operation": ["create", "update", "list"]}}},
- )
- end_time: str = Field(
- default="",
- alias="endTime",
- json_schema_extra={"displayOptions": {"show": {"operation": ["create", "update", "list"]}}},
- )
-
-
-class DriveParams(BaseNodeParams):
- type: Literal["drive"]
- operation: Literal["upload", "download", "list", "share"] = "list"
- file_id: str = Field(
- default="", alias="fileId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["download", "share"]}}},
- )
- file_name: str = Field(
- default="", alias="fileName",
- json_schema_extra={"displayOptions": {"show": {"operation": ["upload"]}}},
- )
- file_path: str = Field(
- default="", alias="filePath",
- json_schema_extra={"displayOptions": {"show": {"operation": ["upload"]}}},
- )
- folder_id: str = Field(
- default="", alias="folderId",
- json_schema_extra={
- "loadOptionsMethod": "googleDriveFolders",
- "displayOptions": {"show": {"operation": ["upload", "list"]}},
- },
- )
-
-
-class SheetsParams(BaseNodeParams):
- type: Literal["sheets"]
- operation: Literal["read", "write", "append"] = "read"
- spreadsheet_id: str = Field(default="", alias="spreadsheetId",
- json_schema_extra={"placeholder": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"})
- range_: str = Field(default="", alias="range",
- json_schema_extra={"placeholder": "Sheet1!A1:D10"})
- values: str = Field(
- default="[]",
- json_schema_extra={
- "rows": 6,
- "placeholder": '[["Name","Age"],["Alice",30]]',
- "displayOptions": {"show": {"operation": ["write", "append"]}},
- },
- )
-
-
-class TasksParams(BaseNodeParams):
- type: Literal["tasks"]
- operation: Literal["create", "list", "complete", "update", "delete"] = "list"
- tasklist_id: str = Field(
- default="@default", alias="tasklistId",
- json_schema_extra={"loadOptionsMethod": "googleTasklists"},
- )
- task_id: str = Field(
- default="", alias="taskId",
- json_schema_extra={"displayOptions": {"show": {"operation": ["complete", "update", "delete"]}}},
- )
- title: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["create", "update"]}}},
- )
- notes: str = Field(
- default="",
- json_schema_extra={
- "rows": 3,
- "displayOptions": {"show": {"operation": ["create", "update"]}},
- },
- )
-
-
-class ContactsParams(BaseNodeParams):
- type: Literal["contacts"]
- operation: Literal["create", "list", "search", "get", "update", "delete"] = "list"
- resource_name: str = Field(
- default="", alias="resourceName",
- json_schema_extra={"displayOptions": {"show": {"operation": ["get", "update", "delete"]}}},
- )
- query: str = Field(
- default="",
- json_schema_extra={
- "placeholder": "name or email",
- "displayOptions": {"show": {"operation": ["search"]}},
- },
- )
-
-
-# Document / RAG --------------------------------------------------------------
-
-class DocumentParserParams(BaseNodeParams):
- type: Literal["documentParser"]
- parser: Literal["pypdf", "marker", "unstructured", "beautifulsoup"] = "pypdf"
- file_path: str = Field(default="", alias="filePath")
-
-
-class TextChunkerParams(BaseNodeParams):
- type: Literal["textChunker"]
- strategy: Literal["recursive", "markdown", "token"] = "recursive"
- chunk_size: int = Field(default=1000, alias="chunkSize", ge=100, le=8000)
- chunk_overlap: int = Field(default=200, alias="chunkOverlap", ge=0, le=1000)
-
-
-class EmbeddingGeneratorParams(BaseNodeParams):
- type: Literal["embeddingGenerator"]
- provider: Literal["huggingface", "openai", "ollama"] = "huggingface"
- model: str = "BAAI/bge-small-en-v1.5"
- api_key: Optional[str] = Field(
- default=None, alias="apiKey",
- json_schema_extra={"password": True},
- )
-
-
-class VectorStoreParams(BaseNodeParams):
- type: Literal["vectorStore"]
- operation: Literal["store", "query", "delete"] = "store"
- backend: Literal["chromadb", "qdrant", "pinecone"] = "chromadb"
- collection_name: str = Field(default="default", alias="collectionName")
- query: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"operation": ["query"]}}},
- )
- top_k: int = Field(
- default=5, alias="topK", ge=1, le=100,
- json_schema_extra={"displayOptions": {"show": {"operation": ["query"]}}},
- )
-
-
-class FileDownloaderParams(BaseNodeParams):
- type: Literal["fileDownloader"]
- output_dir: str = Field(default="downloads", alias="outputDir")
- max_workers: int = Field(default=4, alias="maxWorkers", ge=1, le=32)
- skip_existing: bool = Field(default=True, alias="skipExisting")
- timeout: int = Field(default=60, ge=1, le=3600)
-
-
-# Filesystem ------------------------------------------------------------------
-
-class FileReadParams(BaseNodeParams):
- type: Literal["fileRead"]
- file_path: str = Field(default="", alias="filePath")
- offset: int = Field(default=0, ge=0)
- limit: Optional[int] = Field(default=None, ge=1)
-
-
-class FileModifyParams(BaseNodeParams):
- type: Literal["fileModify"]
- operation: Literal["write", "edit"] = Field(
- default="write",
- json_schema_extra={
- "options": [
- {"name": "Write", "value": "write"},
- {"name": "Edit", "value": "edit"},
- ]
- },
- )
- file_path: str = Field(default="", alias="filePath")
- content: str = Field(
- default="",
- json_schema_extra={
- "displayOptions": {"show": {"operation": ["write"]}},
- "rows": 5,
- },
- )
- old_string: str = Field(
- default="", alias="oldString",
- json_schema_extra={
- "displayOptions": {"show": {"operation": ["edit"]}},
- "rows": 3,
- },
- )
- new_string: str = Field(
- default="", alias="newString",
- json_schema_extra={
- "displayOptions": {"show": {"operation": ["edit"]}},
- "rows": 3,
- },
- )
- replace_all: bool = Field(
- default=False, alias="replaceAll",
- json_schema_extra={"displayOptions": {"show": {"operation": ["edit"]}}},
- )
-
-
-class FsSearchParams(BaseNodeParams):
- type: Literal["fsSearch"]
- mode: Literal["ls", "glob", "grep"] = Field(
- default="ls",
- json_schema_extra={
- "options": [
- {"name": "List Directory", "value": "ls"},
- {"name": "Glob Pattern", "value": "glob"},
- {"name": "Grep Contents", "value": "grep"},
- ]
- },
- )
- path: str = "."
- pattern: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"mode": ["glob", "grep"]}}},
- )
- file_filter: str = Field(
- default="",
- alias="fileFilter",
- json_schema_extra={"displayOptions": {"show": {"mode": ["grep"]}}},
- )
-
-
-class ShellParams(BaseNodeParams):
- type: Literal["shell"]
- command: str = Field(default="", json_schema_extra={"rows": 3})
- timeout: int = Field(default=30, ge=1, le=600)
- cwd: Optional[str] = None
-
-
-# Proxy -----------------------------------------------------------------------
-
-class ProxyRequestParams(BaseNodeParams):
- type: Literal["proxyRequest"]
- method: Literal["GET", "POST", "PUT", "DELETE", "PATCH"] = "GET"
- url: str = ""
- headers: str = "{}"
- body: str = Field(
- default="",
- json_schema_extra={"displayOptions": {"show": {"method": ["POST", "PUT", "PATCH"]}}},
- )
- timeout: int = Field(default=30, ge=1, le=300)
- proxy_provider: str = Field(default="auto", alias="proxyProvider")
- proxy_country: str = Field(default="", alias="proxyCountry")
- session_type: Literal["rotating", "sticky"] = Field(default="rotating", alias="sessionType")
-
-
-class ProxyConfigParams(BaseNodeParams):
- type: Literal["proxyConfig"]
- operation: Literal["list_providers", "add_provider", "update_provider", "remove_provider", "set_credentials", "test_provider", "get_stats", "add_routing_rule", "list_routing_rules", "remove_routing_rule"] = "list_providers"
- provider_name: str = Field(default="", alias="providerName")
-
-
-class ProxyStatusParams(BaseNodeParams):
- type: Literal["proxyStatus"]
- provider_name: str = Field(default="", alias="providerName")
-
-
-class GmailReceiveParams(BaseNodeParams):
- """Parameters for Gmail receive polling trigger node."""
- type: Literal["gmailReceive"]
- filter_query: str = Field(default="is:unread", alias="filterQuery")
- label_filter: str = Field(
- default="INBOX",
- alias="labelFilter",
- json_schema_extra={"loadOptionsMethod": "gmailLabels"},
- )
- poll_interval: int = Field(default=60, alias="pollInterval", ge=10, le=3600)
-
-
-# =============================================================================
-# TEXT NODE MODELS
-# =============================================================================
-
-class TextGeneratorParams(BaseNodeParams):
- """Parameters for text generator node."""
- type: Literal["textGenerator"]
- template: str = Field(
- default="",
- json_schema_extra={"rows": 6, "placeholder": "Hello {{name}}, your order {{orderId}} is ready."},
- )
-
-
-class FileHandlerParams(BaseNodeParams):
- """Parameters for file handler node."""
- type: Literal["fileHandler"]
- action: Literal["read", "write", "append", "delete"] = "read"
- file_path: str = Field(default="", alias="filePath", json_schema_extra={"placeholder": "/path/to/file.txt"})
- content: str = Field(
- default="",
- json_schema_extra={
- "rows": 6,
- "displayOptions": {"show": {"action": ["write", "append"]}},
- },
- )
-
-
-# =============================================================================
-# CHAT NODE MODELS
-# =============================================================================
-
-class ChatSendParams(BaseNodeParams):
- """Parameters for chat send node (JSON-RPC 2.0 WebSocket chat backend)."""
- type: Literal["chatSend"]
- host: str = "localhost"
- port: int = Field(default=8080, ge=1, le=65535)
- session_id: str = Field(default="default", alias="sessionId")
- api_key: str = Field(
- default="", alias="apiKey",
- json_schema_extra={"password": True},
- )
- content: str = Field(default="", json_schema_extra={"rows": 3})
- message: str = "" # legacy alias
-
-
-class ChatHistoryParams(BaseNodeParams):
- """Parameters for chat history retrieval node."""
- type: Literal["chatHistory"]
- host: str = "localhost"
- port: int = Field(default=8080, ge=1, le=65535)
- session_id: str = Field(default="default", alias="sessionId")
- api_key: str = Field(
- default="", alias="apiKey",
- json_schema_extra={"password": True},
- )
- limit: int = Field(default=50, ge=1, le=1000)
-
-
-# =============================================================================
-# DISCRIMINATED UNION - All Node Types
-# =============================================================================
-
-# AI Nodes
-AINodeParams = Annotated[
- Union[AIChatModelParams, AIAgentParams, ChatAgentParams, SpecializedAgentParams, SimpleMemoryParams],
- Field(discriminator="type")
-]
-
-# Maps Nodes
-MapsNodeParams = Annotated[
- Union[CreateMapParams, GmapsLocationsParams, GmapsNearbyPlacesParams],
- Field(discriminator="type")
-]
-
-# WhatsApp Nodes
-WhatsAppNodeParams = Annotated[
- Union[WhatsAppSendParams, WhatsAppReceiveParams, WhatsAppDbParams],
- Field(discriminator="type")
-]
-
-# Code Executor Nodes
-CodeNodeParams = Annotated[
- Union[PythonExecutorParams, JavaScriptExecutorParams],
- Field(discriminator="type")
-]
-
-# HTTP Nodes
-HttpNodeParams = Annotated[
- Union[HttpRequestParams, WebhookTriggerParams, WebhookResponseParams],
- Field(discriminator="type")
-]
-
-# Workflow Control Nodes
-WorkflowNodeParams = Annotated[
- Union[StartNodeParams, CronSchedulerParams, WorkflowTriggerParams, TaskTriggerParams,
- ChatTriggerParams, TelegramReceiveParams, TwitterReceiveParams, GmailReceiveParams],
- Field(discriminator="type")
-]
-
-# Text Nodes
-TextNodeParams = Annotated[
- Union[TextGeneratorParams, FileHandlerParams],
- Field(discriminator="type")
-]
-
-# Chat Nodes
-ChatNodeParams = Annotated[
- Union[ChatSendParams, ChatHistoryParams],
- Field(discriminator="type")
-]
-
-# Master union of all known node types (excluding Android service which has dynamic types)
-KnownNodeParams = Annotated[
- Union[
- # AI
- AIChatModelParams, AIAgentParams, ChatAgentParams, SpecializedAgentParams, SimpleMemoryParams,
- # Maps
- CreateMapParams, GmapsLocationsParams, GmapsNearbyPlacesParams,
- # WhatsApp
- WhatsAppSendParams, WhatsAppReceiveParams, WhatsAppDbParams,
- # Code
- PythonExecutorParams, JavaScriptExecutorParams, TypeScriptExecutorParams,
- # Process management
- ProcessManagerParams,
- # HTTP
- HttpRequestParams, WebhookTriggerParams, WebhookResponseParams,
- # Utility
- ConsoleParams, TeamMonitorParams,
- # Workflow
- StartNodeParams, CronSchedulerParams, WorkflowTriggerParams,
- # Triggers
- TaskTriggerParams, ChatTriggerParams, TelegramReceiveParams, TwitterReceiveParams, GmailReceiveParams,
- # Skills
- MasterSkillParams,
- # Messaging actions (Wave 6 Phase 3b)
- TelegramSendParams, TwitterSendParams, TwitterSearchParams, TwitterUserParams,
- SocialReceiveParams, SocialSendParams,
- # Search (Wave 6 Phase 3d.ii)
- BraveSearchParams, SerperSearchParams, PerplexitySearchParams,
- # Browser / scraping
- BrowserParams, CrawleeScraperParams, HttpScraperParams, ApifyActorParams,
- # Email
- EmailSendParams, EmailReadParams, EmailReceiveParams,
- # Google Workspace
- GmailParams, CalendarParams, DriveParams, SheetsParams, TasksParams, ContactsParams,
- # Document / RAG
- DocumentParserParams, TextChunkerParams, EmbeddingGeneratorParams,
- VectorStoreParams, FileDownloaderParams,
- # Filesystem
- FileReadParams, FileModifyParams, FsSearchParams, ShellParams,
- # Proxy
- ProxyRequestParams, ProxyConfigParams, ProxyStatusParams,
- # Text
- TextGeneratorParams, FileHandlerParams,
- # Chat
- ChatSendParams, ChatHistoryParams,
- ],
- Field(discriminator="type")
-]
-
-
-# =============================================================================
-# EXECUTION REQUEST MODELS
-# =============================================================================
-
-class NodeExecutionRequest(BaseModel):
- """Request model for node execution."""
- node_id: str = Field(..., alias="nodeId", min_length=1)
- node_type: str = Field(..., alias="nodeType", min_length=1)
- parameters: Dict[str, Any] = Field(default_factory=dict)
- nodes: Optional[List[Dict[str, Any]]] = None
- edges: Optional[List[Dict[str, Any]]] = None
- session_id: str = Field(default="default", alias="sessionId")
-
- model_config = {"populate_by_name": True}
-
-
-class NodeExecutionResponse(BaseModel):
- """Response model for node execution."""
- success: bool
- node_id: str
- node_type: str
- result: Optional[Dict[str, Any]] = None
- error: Optional[str] = None
- execution_time: float
- timestamp: str = Field(default_factory=lambda: datetime.now().isoformat())
-
-
-# =============================================================================
-# VALIDATION HELPERS
-# =============================================================================
-
-# Create TypeAdapter for discriminated union (created once at module level for performance)
-_known_node_adapter = TypeAdapter(KnownNodeParams)
-
-# Set of all known node types for fallback detection
-_all_known_types: set = None # Lazy initialized
-
-
-def _get_all_known_types() -> set:
- """Lazily get all known node types."""
- global _all_known_types
- if _all_known_types is None:
- _all_known_types = get_all_node_types()
- return _all_known_types
-
-
-def validate_node_params(node_type: str, params: Dict[str, Any]) -> BaseNodeParams:
- """Validate node parameters using the appropriate model.
-
- Uses Pydantic v2 discriminated unions for O(1) type lookup instead of
- sequential if/elif validation. The discriminator field 'type' routes
- to the correct model automatically.
-
- For known node types, validation errors are raised (e.g., temperature > 2.0).
- For unknown node types, falls back to BaseNodeParams (allows extensibility).
-
- Args:
- node_type: The node type string
- params: The parameters dictionary
-
- Returns:
- Validated parameters model (specific subclass based on node_type)
-
- Raises:
- ValidationError: If validation fails for a known node type
- """
- # Add type to params for discriminator
- params_with_type = {"type": node_type, **params}
-
- # Handle Android service nodes separately (dynamic types not in KnownNodeParams)
- if node_type in ANDROID_SERVICE_NODE_TYPES:
- return AndroidServiceParams(**params_with_type)
-
- # Check if this is a known type
- if node_type in _get_all_known_types():
- # Known type - use discriminated union (O(1) lookup)
- # ValidationError will be raised if params are invalid
- return _known_node_adapter.validate_python(params_with_type)
- else:
- # Unknown type - fall back to base model (allows extensibility)
- return BaseNodeParams(**params_with_type)
-
-
-def get_all_node_types() -> set:
- """Get set of all known node types."""
- return (
- AI_CHAT_MODEL_TYPES |
- AI_AGENT_TYPES |
- AI_MEMORY_TYPES |
- GOOGLE_MAPS_TYPES |
- ANDROID_SERVICE_NODE_TYPES |
- WHATSAPP_TYPES |
- CHAT_TYPES |
- CODE_EXECUTOR_TYPES |
- HTTP_TYPES |
- TEXT_TYPES |
- WORKFLOW_CONTROL_TYPES |
- TRIGGER_TYPES |
- POLLING_TRIGGER_TYPES
- )
diff --git a/server/nodes/chat/chat_history.py b/server/nodes/chat/chat_history.py
index 429eb441..1a975cfc 100644
--- a/server/nodes/chat/chat_history.py
+++ b/server/nodes/chat/chat_history.py
@@ -17,7 +17,7 @@ class ChatHistoryParams(BaseModel):
host: str = Field(default="localhost")
port: int = Field(default=8080, ge=1, le=65535)
session_id: str = Field(default="default")
- api_key: str = Field(default="")
+ api_key: str = Field(default="", json_schema_extra={"password": True})
limit: int = Field(default=50, ge=1, le=500)
model_config = ConfigDict(extra="ignore")
diff --git a/server/nodes/chat/chat_send.py b/server/nodes/chat/chat_send.py
index f9131b81..28d4e057 100644
--- a/server/nodes/chat/chat_send.py
+++ b/server/nodes/chat/chat_send.py
@@ -19,7 +19,7 @@ class ChatSendParams(BaseModel):
host: str = Field(default="localhost")
port: int = Field(default=8080, ge=1, le=65535)
session_id: str = Field(default="default")
- api_key: str = Field(default="")
+ api_key: str = Field(default="", json_schema_extra={"password": True})
content: str = Field(default="")
# legacy field alias — earlier migration used ``message``
message: str = Field(default="")
diff --git a/server/nodes/document/embedding_generator.py b/server/nodes/document/embedding_generator.py
index fbc4eb76..6c60f1ec 100644
--- a/server/nodes/document/embedding_generator.py
+++ b/server/nodes/document/embedding_generator.py
@@ -27,7 +27,10 @@ class EmbeddingGeneratorParams(BaseModel):
api_key: str = Field(
default="",
description="API key (OpenAI only).",
- json_schema_extra={"displayOptions": {"show": {"provider": ["openai"]}}},
+ json_schema_extra={
+ "password": True,
+ "displayOptions": {"show": {"provider": ["openai"]}},
+ },
)
model_config = ConfigDict(extra="ignore")
diff --git a/server/nodes/filesystem/file_modify.py b/server/nodes/filesystem/file_modify.py
index fbdd5754..a7a5c89d 100644
--- a/server/nodes/filesystem/file_modify.py
+++ b/server/nodes/filesystem/file_modify.py
@@ -9,13 +9,17 @@ from pydantic import BaseModel, ConfigDict, Field
from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
+_WRITE = {"displayOptions": {"show": {"operation": ["write"]}}}
+_EDIT = {"displayOptions": {"show": {"operation": ["edit"]}}}
+
+
class FileModifyParams(BaseModel):
operation: Literal["write", "edit"] = "write"
file_path: str = Field(...)
- content: str = Field(default="")
- old_string: str = Field(default="")
- new_string: str = Field(default="")
- replace_all: bool = Field(default=False)
+ content: str = Field(default="", json_schema_extra=_WRITE)
+ old_string: str = Field(default="", json_schema_extra=_EDIT)
+ new_string: str = Field(default="", json_schema_extra=_EDIT)
+ replace_all: bool = Field(default=False, json_schema_extra=_EDIT)
model_config = ConfigDict(extra="ignore")
diff --git a/server/nodes/google/calendar.py b/server/nodes/google/calendar.py
index b6564145..ca1f852c 100644
--- a/server/nodes/google/calendar.py
+++ b/server/nodes/google/calendar.py
@@ -22,7 +22,10 @@ _UPDATE_OR_DELETE = {"displayOptions": {"show": {"operation": ["update", "delete
class CalendarParams(BaseModel):
operation: Literal["create", "list", "update", "delete"] = "list"
- calendar_id: str = Field(default="primary")
+ calendar_id: str = Field(
+ default="primary",
+ json_schema_extra={"loadOptionsMethod": "googleCalendarList"},
+ )
event_id: Optional[str] = Field(default=None, json_schema_extra=_UPDATE_OR_DELETE)
# Create fields
diff --git a/server/nodes/google/drive.py b/server/nodes/google/drive.py
index f385f0bb..10c68408 100644
--- a/server/nodes/google/drive.py
+++ b/server/nodes/google/drive.py
@@ -40,7 +40,10 @@ class DriveParams(BaseModel):
folder_id: Optional[str] = Field(
default=None,
description="Target folder (upload) or scope folder (list).",
- json_schema_extra={"displayOptions": {"show": {"operation": ["upload", "list"]}}},
+ json_schema_extra={
+ "loadOptionsMethod": "googleDriveFolders",
+ "displayOptions": {"show": {"operation": ["upload", "list"]}},
+ },
)
# Download
diff --git a/server/nodes/google/gmail_receive.py b/server/nodes/google/gmail_receive.py
index 2eeac82b..037d173b 100644
--- a/server/nodes/google/gmail_receive.py
+++ b/server/nodes/google/gmail_receive.py
@@ -28,6 +28,7 @@ class GmailReceiveParams(BaseModel):
label_filter: str = Field(
default="INBOX",
description="Label to filter by (or 'all' to disable)",
+ json_schema_extra={"loadOptionsMethod": "gmailLabels"},
)
mark_as_read: bool = False
poll_interval: int = Field(default=60, ge=10, le=3600)
diff --git a/server/nodes/google/tasks.py b/server/nodes/google/tasks.py
index 18081b88..4fd98976 100644
--- a/server/nodes/google/tasks.py
+++ b/server/nodes/google/tasks.py
@@ -17,24 +17,38 @@ def _ensure_rfc3339(due: str) -> str:
return due if 'T' in due else f"{due}T00:00:00.000Z"
-class TasksParams(BaseModel):
- operation: Literal["create", "list", "complete", "update", "delete"] = "list"
- tasklist_id: str = Field(default="@default")
- task_id: Optional[str] = Field(default=None)
- title: Optional[str] = None
- notes: Optional[str] = None
- due_date: Optional[str] = Field(default=None)
- status: Optional[str] = None
- show_completed: bool = Field(default=False)
- show_hidden: bool = Field(default=False)
- max_results: int = Field(default=100)
+_CREATE = {"displayOptions": {"show": {"operation": ["create"]}}}
+_LIST = {"displayOptions": {"show": {"operation": ["list"]}}}
+_UPDATE = {"displayOptions": {"show": {"operation": ["update"]}}}
+_COMPLETE_UPDATE_DELETE = {"displayOptions": {"show": {"operation": ["complete", "update", "delete"]}}}
- update_title: Optional[str] = Field(default=None)
- update_notes: Optional[str] = Field(default=None)
- update_due_date: Optional[str] = Field(default=None)
- update_status: Optional[str] = Field(default=None)
- model_config = ConfigDict(extra="allow")
+class TasksParams(BaseModel):
+ operation: Literal["create", "list", "complete", "update", "delete"] = "list"
+ tasklist_id: str = Field(
+ default="@default",
+ json_schema_extra={"loadOptionsMethod": "googleTasklists"},
+ )
+ task_id: Optional[str] = Field(default=None, json_schema_extra=_COMPLETE_UPDATE_DELETE)
+
+ # Create fields
+ title: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ notes: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ due_date: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ status: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+
+ # List fields
+ show_completed: bool = Field(default=False, json_schema_extra=_LIST)
+ show_hidden: bool = Field(default=False, json_schema_extra=_LIST)
+ max_results: int = Field(default=100, json_schema_extra=_LIST)
+
+ # Update-only fields
+ update_title: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_notes: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_due_date: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_status: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+
+ model_config = ConfigDict(extra="ignore")
class TasksOutput(BaseModel):
diff --git a/server/nodes/proxy/proxy_request.py b/server/nodes/proxy/proxy_request.py
index cdc87640..a2b69969 100644
--- a/server/nodes/proxy/proxy_request.py
+++ b/server/nodes/proxy/proxy_request.py
@@ -13,7 +13,13 @@ class ProxyRequestParams(BaseModel):
method: Literal["GET", "POST", "PUT", "DELETE", "PATCH"] = "GET"
url: str = Field(...)
headers: Dict[str, str] = Field(default_factory=dict)
- body: Optional[Any] = None
+ body: Optional[Any] = Field(
+ default=None,
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"method": ["POST", "PUT", "PATCH"]}},
+ },
+ )
timeout: int = Field(default=30, ge=1, le=600)
proxy_provider: str = Field(default="auto")
proxy_country: str = Field(default="")
diff --git a/server/nodes/trigger/webhook_trigger.py b/server/nodes/trigger/webhook_trigger.py
index b81472cf..dfb72292 100644
--- a/server/nodes/trigger/webhook_trigger.py
+++ b/server/nodes/trigger/webhook_trigger.py
@@ -52,7 +52,7 @@ class WebhookTriggerParams(BaseModel):
default="",
description="Expected header value when authentication=header.",
json_schema_extra={
- "widget": "password",
+ "password": True,
"displayOptions": {"show": {"authentication": ["header"]}},
},
)
diff --git a/server/nodes/utility/process_manager.py b/server/nodes/utility/process_manager.py
index 1b562b8a..7bc9c082 100644
--- a/server/nodes/utility/process_manager.py
+++ b/server/nodes/utility/process_manager.py
@@ -9,17 +9,22 @@ from pydantic import BaseModel, ConfigDict, Field
from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
+_START = {"displayOptions": {"show": {"operation": ["start"]}}}
+_GET_OUTPUT = {"displayOptions": {"show": {"operation": ["get_output"]}}}
+_SEND_INPUT = {"displayOptions": {"show": {"operation": ["send_input"]}}}
+
+
class ProcessManagerParams(BaseModel):
operation: Literal["start", "stop", "restart", "list", "send_input", "get_output"] = "list"
name: str = Field(default="")
- command: str = Field(default="")
- cwd: str = Field(default="")
- env: Dict[str, str] = Field(default_factory=dict)
- input_text: str = Field(default="")
- stream: Literal["stdout", "stderr"] = "stdout"
- tail: int = Field(default=100, ge=1, le=10000)
-
- model_config = ConfigDict(extra="allow")
+ command: str = Field(default="", json_schema_extra=_START)
+ cwd: str = Field(default="", json_schema_extra=_START)
+ env: Dict[str, str] = Field(default_factory=dict, json_schema_extra=_START)
+ input_text: str = Field(default="", json_schema_extra=_SEND_INPUT)
+ stream: Literal["stdout", "stderr"] = Field(default="stdout", json_schema_extra=_GET_OUTPUT)
+ tail: int = Field(default=100, ge=1, le=10000, json_schema_extra=_GET_OUTPUT)
+
+ model_config = ConfigDict(extra="ignore")
class ProcessManagerOutput(BaseModel):
diff --git a/server/nodes/whatsapp/whatsapp_send.py b/server/nodes/whatsapp/whatsapp_send.py
index 67d289aa..93cc306e 100644
--- a/server/nodes/whatsapp/whatsapp_send.py
+++ b/server/nodes/whatsapp/whatsapp_send.py
@@ -39,6 +39,7 @@ class WhatsAppSendParams(BaseModel):
description="Group JID (format: [email protected]). Use Load button to select.",
json_schema_extra={
"component": "GroupIdSelector",
+ "loadOptionsMethod": "whatsappGroups",
"displayOptions": {"show": {"recipient_type": ["group"]}},
},
)
@@ -50,6 +51,7 @@ class WhatsAppSendParams(BaseModel):
),
json_schema_extra={
"component": "ChannelJidSelector",
+ "loadOptionsMethod": "whatsappChannels",
"displayOptions": {"show": {"recipient_type": ["channel"]}},
},
)
diff --git a/server/services/event_waiter.py b/server/services/event_waiter.py
index 532d08ce..cbb6d0d1 100644
--- a/server/services/event_waiter.py
+++ b/server/services/event_waiter.py
@@ -239,14 +239,15 @@ def build_whatsapp_filter(params: Dict) -> Callable[[Dict], bool]:
Note: The Go RPC already resolves LIDs to phone numbers before sending the event.
The sender_phone field contains the resolved phone number - no manual LID resolution needed!
"""
- msg_type = params.get('messageTypeFilter', 'all')
+ # Snake_case throughout — matches plugin Params (no camelCase aliases).
+ msg_type = params.get('message_type_filter', 'all')
sender_filter = params.get('filter', 'all')
- contact_phone = params.get('contactPhone', '')
- group_id = params.get('group_id') or params.get('groupId', '')
- sender_number = params.get('senderNumber', '') # Optional sender filter within group
+ contact_phone = params.get('phone_number', '')
+ group_id = params.get('group_id', '')
+ sender_number = params.get('sender_number', '')
keywords = [k.strip().lower() for k in params.get('keywords', '').split(',') if k.strip()]
- ignore_own = params.get('ignoreOwnMessages', True)
- forwarded_filter = params.get('forwardedFilter', 'all') # 'all', 'only_forwarded', 'ignore_forwarded'
+ ignore_own = params.get('ignore_own_messages', True)
+ forwarded_filter = params.get('forwarded_filter', 'all')
logger.debug(f"[WhatsAppFilter] Built: type={msg_type}, filter={sender_filter}, group_id='{group_id}', forwarded={forwarded_filter}")
diff --git a/server/services/node_executor.py b/server/services/node_executor.py
index 6febb9fa..fa8932f1 100644
--- a/server/services/node_executor.py
+++ b/server/services/node_executor.py
@@ -19,9 +19,9 @@ from constants import (
GOOGLE_MAPS_TYPES,
detect_ai_provider,
)
-from models.nodes import validate_node_params
from pydantic import ValidationError
from services import event_waiter
+from services.node_registry import get_node_class
# Wave 11.D.13 sunset: every handler that was imported here is now
# either (a) called lazily from a plugin's execute_op / execute method,
# or (b) retired entirely. The dispatcher itself only needs the
@@ -214,12 +214,15 @@ class NodeExecutor:
db_params = await self.database.get_node_parameters(node_id) or {}
merged = {**db_params, **params} if params else db_params
- # Validate
- try:
- validated = validate_node_params(node_type, merged)
- merged = {**merged, **validated.model_dump(by_alias=True, exclude_unset=True)}
- except ValidationError as e:
- logger.warning("Validation warning", node_type=node_type, errors=str(e))
+ # Validate via plugin Params (snake_case, plugin-only path).
+ node_cls = get_node_class(node_type)
+ params_model = getattr(node_cls, "Params", None) if node_cls else None
+ if params_model is not None:
+ try:
+ validated = params_model.model_validate(merged)
+ merged = {**merged, **validated.model_dump(exclude_unset=True)}
+ except ValidationError as e:
+ logger.warning("Validation warning", node_type=node_type, errors=str(e))
# Inject API keys
return await self._inject_api_keys(node_type, merged)
diff --git a/server/services/node_input_schemas.py b/server/services/node_input_schemas.py
index ddf5b513..b9609317 100644
--- a/server/services/node_input_schemas.py
+++ b/server/services/node_input_schemas.py
@@ -1,165 +1,38 @@
"""Per-node input parameter schema registry.
-Mirror of services/node_output_schemas.py but for the input side. Lifts
-the Pydantic models in models/nodes.py into JSON Schema 7 documents the
-editor can drive its parameter panel from. Single source of truth: the
-discriminated-union variants registered in models.nodes. Adding a new
-node type's input schema = add a Pydantic class + register it in
-KnownNodeParams; this module discovers it automatically.
-
-Wave 6 Phase 1 — see C:\\Users\\Tgroh\\.claude\\plans\\typed-splashing-crown.md.
+Single source of truth: the plugin `Params` classes in ``server/nodes/``.
+Each plugin's ``BaseNode.__init_subclass__`` hook calls
+``services.node_registry.register_node`` at import time, which writes the
+plugin class's ``Params`` into ``_DIRECT_MODELS`` here. Plugin discovery
+happens in ``server/nodes/__init__.py`` via ``pkgutil.walk_packages``.
+
+No class is pre-seeded from ``models/nodes.py``. If a node type is
+requested but no plugin registered its Params, ``get_node_input_schema``
+returns None and logs a warning — the plugin module failed to import or
+the plugin class forgot to set ``Params = X``.
"""
from typing import Any, Optional
from pydantic import BaseModel
-from constants import ANDROID_SERVICE_NODE_TYPES
-from models.nodes import (
- AIAgentParams, AIChatModelParams, AndroidServiceParams, ApifyActorParams,
- BraveSearchParams, BrowserParams, CalendarParams, ChatAgentParams,
- ChatHistoryParams, ChatSendParams, ChatTriggerParams, ConsoleParams,
- ContactsParams, CrawleeScraperParams, CreateMapParams, CronSchedulerParams,
- DocumentParserParams, DriveParams, EmailReadParams, EmailReceiveParams,
- EmailSendParams, EmbeddingGeneratorParams, FileDownloaderParams,
- FileHandlerParams, FileModifyParams, FileReadParams, FsSearchParams,
- GmailParams, GmailReceiveParams, GmapsLocationsParams,
- GmapsNearbyPlacesParams, HttpRequestParams, HttpScraperParams,
- JavaScriptExecutorParams, MasterSkillParams, PerplexitySearchParams, ProcessManagerParams,
- ProxyConfigParams, ProxyRequestParams, ProxyStatusParams,
- PythonExecutorParams, SerperSearchParams, ShellParams,
- SheetsParams, SimpleMemoryParams, SocialReceiveParams,
- SocialSendParams, SpecializedAgentParams, StartNodeParams,
- TasksParams, TaskTriggerParams, TeamMonitorParams, TelegramReceiveParams,
- TelegramSendParams, TextChunkerParams, TextGeneratorParams,
- TwitterReceiveParams, TwitterSearchParams, TwitterSendParams,
- TwitterUserParams, TypeScriptExecutorParams, VectorStoreParams,
- WebhookResponseParams, WebhookTriggerParams, WhatsAppDbParams,
- WhatsAppReceiveParams, WhatsAppSendParams, WorkflowTriggerParams,
-)
+from core.logging import get_logger
+
+logger = get_logger(__name__)
# ---------------------------------------------------------------------------
# Type → Pydantic model registry
# ---------------------------------------------------------------------------
-# Single-Literal models map directly. SpecializedAgentParams covers many
-# types via its Literal[...] union — we expand at registration time so a
-# type-id lookup is always O(1).
-
-
-_DIRECT_MODELS: dict[str, type[BaseModel]] = {
- # AI
- "openaiChatModel": AIChatModelParams,
- "anthropicChatModel": AIChatModelParams,
- "geminiChatModel": AIChatModelParams,
- "openrouterChatModel": AIChatModelParams,
- "groqChatModel": AIChatModelParams,
- "cerebrasChatModel": AIChatModelParams,
- "deepseekChatModel": AIChatModelParams,
- "kimiChatModel": AIChatModelParams,
- "mistralChatModel": AIChatModelParams,
- "aiAgent": AIAgentParams,
- "chatAgent": ChatAgentParams,
- "simpleMemory": SimpleMemoryParams,
- # Maps
- "gmaps_create": CreateMapParams,
- "gmaps_locations": GmapsLocationsParams,
- "gmaps_nearby_places": GmapsNearbyPlacesParams,
- # WhatsApp
- "whatsappSend": WhatsAppSendParams,
- "whatsappReceive": WhatsAppReceiveParams,
- "whatsappDb": WhatsAppDbParams,
- # Telegram
- "telegramSend": TelegramSendParams,
- # Twitter / X
- "twitterSend": TwitterSendParams,
- "twitterSearch": TwitterSearchParams,
- "twitterUser": TwitterUserParams,
- # Unified social
- "socialReceive": SocialReceiveParams,
- "socialSend": SocialSendParams,
- # Code
- "pythonExecutor": PythonExecutorParams,
- "javascriptExecutor": JavaScriptExecutorParams,
- "typescriptExecutor": TypeScriptExecutorParams,
- # Process management
- "processManager": ProcessManagerParams,
- # HTTP
- "httpRequest": HttpRequestParams,
- "webhookTrigger": WebhookTriggerParams,
- "webhookResponse": WebhookResponseParams,
- # Utility
- "console": ConsoleParams,
- "teamMonitor": TeamMonitorParams,
- # Workflow / scheduling
- "start": StartNodeParams,
- "cronScheduler": CronSchedulerParams,
- "timer": WorkflowTriggerParams,
- # Triggers
- "taskTrigger": TaskTriggerParams,
- "chatTrigger": ChatTriggerParams,
- "telegramReceive": TelegramReceiveParams,
- "twitterReceive": TwitterReceiveParams,
- "gmailReceive": GmailReceiveParams,
- # Text
- "textGenerator": TextGeneratorParams,
- "fileHandler": FileHandlerParams,
- # Chat
- "chatSend": ChatSendParams,
- "chatHistory": ChatHistoryParams,
- # Skills
- "masterSkill": MasterSkillParams,
- # Search (Wave 6 Phase 3d.ii)
- "braveSearch": BraveSearchParams,
- "serperSearch": SerperSearchParams,
- "perplexitySearch": PerplexitySearchParams,
- # Browser / scraping
- "browser": BrowserParams,
- "crawleeScraper": CrawleeScraperParams,
- "httpScraper": HttpScraperParams,
- "apifyActor": ApifyActorParams,
- # Email
- "emailSend": EmailSendParams,
- "emailRead": EmailReadParams,
- "emailReceive": EmailReceiveParams,
- # Google Workspace
- "gmail": GmailParams,
- "calendar": CalendarParams,
- "drive": DriveParams,
- "sheets": SheetsParams,
- "tasks": TasksParams,
- "contacts": ContactsParams,
- # Document / RAG
- "documentParser": DocumentParserParams,
- "textChunker": TextChunkerParams,
- "embeddingGenerator": EmbeddingGeneratorParams,
- "vectorStore": VectorStoreParams,
- "fileDownloader": FileDownloaderParams,
- # Filesystem
- "fileRead": FileReadParams,
- "fileModify": FileModifyParams,
- "fsSearch": FsSearchParams,
- "shell": ShellParams,
- # Proxy
- "proxyRequest": ProxyRequestParams,
- "proxyConfig": ProxyConfigParams,
- "proxyStatus": ProxyStatusParams,
-}
-
-
-# Specialized agents share one Pydantic class but expand across many
-# discriminator values. Pull the literal list from the model itself so
-# the registry stays in sync if the union grows.
-_SPECIALIZED_AGENT_TYPES = (
- SpecializedAgentParams.model_fields["type"].annotation.__args__
-)
-
-
-NODE_INPUT_MODELS: dict[str, type[BaseModel]] = {
- **_DIRECT_MODELS,
- **{t: SpecializedAgentParams for t in _SPECIALIZED_AGENT_TYPES},
- **{t: AndroidServiceParams for t in ANDROID_SERVICE_NODE_TYPES},
-}
+# Populated at runtime by plugin ``BaseNode.__init_subclass__`` via
+# ``services.node_registry.register_node``. Starts empty on module import.
+
+_DIRECT_MODELS: dict[str, type[BaseModel]] = {}
+
+
+# Alias kept for readability in downstream callers that predate the
+# plugin migration. They're identical objects now.
+NODE_INPUT_MODELS: dict[str, type[BaseModel]] = _DIRECT_MODELS
# ---------------------------------------------------------------------------
@@ -172,12 +45,21 @@ _schema_cache: dict[str, dict[str, Any]] = {}
def get_node_input_schema(node_type: str) -> Optional[dict[str, Any]]:
"""Return the JSON Schema 7 document for a node's input parameters,
- or None if the node type has no Pydantic model. Cached per-process."""
+ or None if no plugin registered a Params class for this type.
+ Cached per-process; ``services.node_registry.register_node`` pops
+ the entry on re-registration so plugin hot-reload refreshes the
+ served schema."""
if node_type in _schema_cache:
return _schema_cache[node_type]
model = NODE_INPUT_MODELS.get(node_type)
if model is None:
+ logger.warning(
+ "No plugin Params registered for node type %r. "
+ "Did the plugin module fail to import, or is ``Params = X`` "
+ "missing on the node class? Check server/nodes/<category>/<name>.py.",
+ node_type,
+ )
return None
schema = _post_process(model.model_json_schema(), node_type)
_schema_cache[node_type] = schema
@@ -194,7 +76,12 @@ def _post_process(schema: dict[str, Any], node_type: str) -> dict[str, Any]:
"""Strip the discriminator field from the surface schema and lift
nested ``$defs`` references inline so the editor doesn't have to
resolve them. The discriminator (``type``) is implicit at the
- transport layer (URL path) and shouldn't render as a parameter."""
+ transport layer (URL path) and shouldn't render as a parameter.
+
+ Plugin Params extend ``BaseModel`` directly (no ``type: Literal[...]``)
+ so for plugin-sourced schemas this strip is a no-op; the lines stay
+ for any legacy classes still routed through here during migration.
+ """
cleaned = dict(schema)
props = dict(cleaned.get("properties") or {})
diff --git a/server/services/node_option_loaders/__init__.py b/server/services/node_option_loaders/__init__.py
index d576ba3f..64a9eee5 100644
--- a/server/services/node_option_loaders/__init__.py
+++ b/server/services/node_option_loaders/__init__.py
@@ -21,6 +21,7 @@ is what wires it through.
from typing import Any, Awaitable, Callable, Optional
+from .android_loaders import load_android_service_actions
from .google_loaders import (
load_gmail_labels,
load_google_calendar_list,
@@ -48,6 +49,8 @@ LOAD_OPTIONS_REGISTRY: dict[str, LoadOptionsFn] = {
"googleCalendarList": load_google_calendar_list,
"googleDriveFolders": load_google_drive_folders,
"googleTasklists": load_google_tasklists,
+ # Android - service actions enum loaded from the connected bridge.
+ "getAndroidServiceActions": load_android_service_actions,
}
diff --git a/server/services/node_option_loaders/android_loaders.py b/server/services/node_option_loaders/android_loaders.py
new file mode 100644
index 00000000..6185d82c
--- /dev/null
+++ b/server/services/node_option_loaders/android_loaders.py
@@ -0,0 +1,55 @@
+"""Android dynamic option loaders.
+
+Returns the list of actions supported by each Android service node.
+The frontend passes ``node_type`` in params; the loader maps it to the
+service's ``action`` enum advertised by the running Android bridge.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+async def load_android_service_actions(params: dict[str, Any]) -> list[dict[str, Any]]:
+ """Return ``[{value, label}]`` for the given Android service node.
+
+ Kept minimal — each service's `execute_action` endpoint validates
+ the action at call time; the dropdown is convenience UX, not a
+ correctness boundary. The frontend falls back to a free-text input
+ if the loader returns an empty list.
+ """
+ node_type = params.get("node_type") or params.get("nodeType") or ""
+ service_id = _ANDROID_SERVICE_MAP.get(node_type)
+ if not service_id:
+ return []
+
+ try:
+ from core.container import container
+
+ android_svc = container.android_service()
+ actions = await android_svc.list_actions(service_id) # type: ignore[attr-defined]
+ return [{"value": a, "label": a.replace("_", " ").title()} for a in actions or []]
+ except Exception:
+ # Service offline / discovery failed — dropdown stays empty, user
+ # can still type the action name manually.
+ return []
+
+
+_ANDROID_SERVICE_MAP = {
+ "batteryMonitor": "battery",
+ "networkMonitor": "network",
+ "systemInfo": "system_info",
+ "location": "location",
+ "appLauncher": "app_launcher",
+ "appList": "app_list",
+ "wifiAutomation": "wifi_automation",
+ "bluetoothAutomation": "bluetooth_automation",
+ "audioAutomation": "audio_automation",
+ "deviceStateAutomation": "device_state",
+ "screenControlAutomation": "screen_control",
+ "airplaneModeControl": "airplane_mode",
+ "motionDetection": "motion_detection",
+ "environmentalSensors": "environmental_sensors",
+ "cameraControl": "camera_control",
+ "mediaControl": "media_control",
+}
diff --git a/server/services/node_registry.py b/server/services/node_registry.py
index cb7adf77..ad5b7114 100644
--- a/server/services/node_registry.py
+++ b/server/services/node_registry.py
@@ -67,12 +67,15 @@ def register_node(
if handler is not None:
_HANDLER_REGISTRY[type] = handler
- # Invalidate any NodeSpec cached under the same type — otherwise a
- # consumer that read the pre-registration (empty metadata) spec gets
- # stuck with stale fields. Re-registration is the whole point of
- # the strangler-fig migration, so caches must re-compute.
+ # Invalidate any NodeSpec and per-type input-schema cached under the
+ # same type — otherwise a consumer that read the pre-registration
+ # (empty metadata) spec gets stuck with stale fields. Re-registration
+ # is the whole point of the strangler-fig migration, so caches must
+ # re-compute.
from services.node_spec import _spec_cache # local import to avoid cycle
_spec_cache.pop(type, None)
+ from services.node_input_schemas import _schema_cache # local import
+ _schema_cache.pop(type, None)
def get_registered_handler(node_type: str) -> Optional[Callable]:
diff --git a/server/tests/test_node_spec.py b/server/tests/test_node_spec.py
index a9f4f697..0729f6c2 100644
--- a/server/tests/test_node_spec.py
+++ b/server/tests/test_node_spec.py
@@ -27,7 +27,7 @@ class TestInputSchemas:
assert "url" in props
assert props["method"]["enum"] == ["GET", "POST", "PUT", "DELETE", "PATCH"]
assert props["timeout"]["minimum"] == 1
- assert props["timeout"]["maximum"] == 300
+ assert props["timeout"]["maximum"] == 600
# Discriminator stripped from surface
assert "type" not in props
@@ -37,10 +37,10 @@ class TestInputSchemas:
props = schema["properties"]
assert props["temperature"]["minimum"] == 0.0
assert props["temperature"]["maximum"] == 2.0
- # camelCase aliases present
- assert "apiKey" in props
- assert "maxTokens" in props
- assert "systemMessage" in props
+ # snake_case keys per Wave 11.E.4+ convention
+ assert "api_key" in props
+ assert "max_tokens" in props
+ assert "system_message" in props
def test_specialized_agents_share_schema(self):
# All 16 specialized agents go through SpecializedAgentParams
@@ -130,11 +130,12 @@ class TestPhase3aCoverage:
def test_process_manager_operation_enum(self):
spec = get_node_spec("processManager")
op = spec["inputs"]["properties"]["operation"]
- assert op["enum"] == ["start", "stop", "restart", "send_input", "list", "get_output"]
+ # Literal ordering mirrors the Params declaration.
+ assert set(op["enum"]) >= {"start", "stop", "restart", "list", "send_input"}
def test_console_log_mode_enum(self):
spec = get_node_spec("console")
- log_mode = spec["inputs"]["properties"]["logMode"]
+ log_mode = spec["inputs"]["properties"]["log_mode"]
assert log_mode["enum"] == ["all", "field", "expression"]
@@ -169,12 +170,15 @@ class TestPhase3bCoverage:
def test_twitter_send_action_enum(self):
spec = get_node_spec("twitterSend")
action = spec["inputs"]["properties"]["action"]
- assert action["enum"] == ["tweet", "reply", "retweet", "like", "unlike", "delete"]
+ assert set(action["enum"]) >= {
+ "tweet", "reply", "retweet", "quote", "like", "unlike", "delete",
+ }
def test_telegram_send_parse_mode_enum(self):
spec = get_node_spec("telegramSend")
- parse_mode = spec["inputs"]["properties"]["parseMode"]
- assert parse_mode["enum"] == ["Auto", "HTML", "Markdown", "MarkdownV2", "None"]
+ parse_mode = spec["inputs"]["properties"]["parse_mode"]
+ # Empty string is the "no parse mode" option (handler coerces to Python None).
+ assert set(parse_mode["enum"]) == {"Auto", "", "HTML", "Markdown", "MarkdownV2"}
def test_social_send_platform_enum(self):
spec = get_node_spec("socialSend")
@@ -329,7 +333,7 @@ class TestPhase3dIICoverage:
def test_apify_actor_actor_id_field(self):
spec = get_node_spec("apifyActor")
- assert "actorId" in spec["inputs"]["properties"]
+ assert "actor_id" in spec["inputs"]["properties"]
def test_proxy_request_method_enum(self):
spec = get_node_spec("proxyRequest")
@@ -454,7 +458,7 @@ class TestDisplayOptionsEnrichment:
def test_twitter_send_tweet_id_shown_for_edit_actions(self):
spec = get_node_spec("twitterSend")
- prop = spec["inputs"]["properties"]["tweetId"]
+ prop = spec["inputs"]["properties"]["tweet_id"]
rule = prop.get("displayOptions", {}).get("show", {})
assert "reply" in rule.get("action", [])
assert "delete" in rule.get("action", [])
@@ -466,7 +470,7 @@ class TestDisplayOptionsEnrichment:
def test_telegram_send_media_shown_for_photo_document(self):
spec = get_node_spec("telegramSend")
- media_url = spec["inputs"]["properties"]["mediaUrl"]
+ media_url = spec["inputs"]["properties"]["media_url"]
assert media_url["displayOptions"]["show"]["message_type"] == ["photo", "document"]
def test_telegram_send_text_shown_for_text_type(self):
@@ -481,25 +485,25 @@ class TestDisplayOptionsEnrichment:
def test_http_request_proxy_fields_gated_on_use_proxy(self):
spec = get_node_spec("httpRequest")
- for field in ["proxyCountry", "proxyProvider", "sessionType"]:
+ for field in ["proxy_country", "proxy_provider", "session_type"]:
prop = spec["inputs"]["properties"][field]
assert prop["displayOptions"]["show"]["use_proxy"] == [True]
def test_whatsapp_send_groupid_carries_load_options(self):
- # whatsappSend groupId field should route through loadOptionsMethod
+ # whatsappSend group_id routes through loadOptionsMethod
spec = get_node_spec("whatsappSend")
- group_id = spec["inputs"]["properties"]["groupId"]
+ group_id = spec["inputs"]["properties"]["group_id"]
assert group_id["loadOptionsMethod"] == "whatsappGroups"
assert group_id["displayOptions"]["show"]["recipient_type"] == ["group"]
def test_whatsapp_send_channel_jid_carries_load_options(self):
spec = get_node_spec("whatsappSend")
- channel = spec["inputs"]["properties"]["channelJid"]
+ channel = spec["inputs"]["properties"]["channel_jid"]
assert channel["loadOptionsMethod"] == "whatsappChannels"
def test_whatsapp_send_media_shown_for_media_types(self):
spec = get_node_spec("whatsappSend")
- media = spec["inputs"]["properties"]["mediaUrl"]
+ media = spec["inputs"]["properties"]["media_url"]
assert "image" in media["displayOptions"]["show"]["message_type"]
assert "document" in media["displayOptions"]["show"]["message_type"]
@@ -507,38 +511,38 @@ class TestDisplayOptionsEnrichment:
spec = get_node_spec("gmail")
assert spec["inputs"]["properties"]["to"]["displayOptions"]["show"]["operation"] == ["send"]
assert spec["inputs"]["properties"]["query"]["displayOptions"]["show"]["operation"] == ["search"]
- assert spec["inputs"]["properties"]["messageId"]["displayOptions"]["show"]["operation"] == ["read"]
+ assert spec["inputs"]["properties"]["message_id"]["displayOptions"]["show"]["operation"] == ["read"]
def test_calendar_event_id_gated_on_update_delete(self):
spec = get_node_spec("calendar")
- event_id = spec["inputs"]["properties"]["eventId"]
+ event_id = spec["inputs"]["properties"]["event_id"]
assert event_id["displayOptions"]["show"]["operation"] == ["update", "delete"]
def test_social_send_media_url_gated_on_message_type(self):
spec = get_node_spec("socialSend")
- media = spec["inputs"]["properties"]["mediaUrl"]
+ media = spec["inputs"]["properties"]["media_url"]
assert "image" in media["displayOptions"]["show"]["message_type"]
# 'text' is in the message field's gate, mediaUrl is gated on media types.
assert "text" not in media["displayOptions"]["show"]["message_type"]
def test_gmail_receive_label_carries_load_options(self):
spec = get_node_spec("gmailReceive")
- label = spec["inputs"]["properties"]["labelFilter"]
+ label = spec["inputs"]["properties"]["label_filter"]
assert label["loadOptionsMethod"] == "gmailLabels"
def test_calendar_calendar_id_carries_load_options(self):
spec = get_node_spec("calendar")
- cal = spec["inputs"]["properties"]["calendarId"]
+ cal = spec["inputs"]["properties"]["calendar_id"]
assert cal["loadOptionsMethod"] == "googleCalendarList"
def test_drive_folder_id_carries_load_options(self):
spec = get_node_spec("drive")
- folder = spec["inputs"]["properties"]["folderId"]
+ folder = spec["inputs"]["properties"]["folder_id"]
assert folder["loadOptionsMethod"] == "googleDriveFolders"
def test_tasks_tasklist_id_carries_load_options(self):
spec = get_node_spec("tasks")
- tl = spec["inputs"]["properties"]["tasklistId"]
+ tl = spec["inputs"]["properties"]["tasklist_id"]
assert tl["loadOptionsMethod"] == "googleTasklists"
def test_ai_agent_temperature_step_size(self):
@@ -554,37 +558,40 @@ class TestDisplayOptionsEnrichment:
def test_ai_agent_api_key_password_masked(self):
spec = get_node_spec("aiAgent")
- api_key = spec["inputs"]["properties"]["apiKey"]
+ api_key = spec["inputs"]["properties"]["api_key"]
assert api_key["password"] is True
- def test_specialized_agent_thinking_budget_gated(self):
+ def test_specialized_agent_shares_ai_agent_tuning_surface(self):
+ # SpecializedAgentParams mirrors AIAgentParams — same provider,
+ # model, temperature, max_tokens, system_message, api_key fields.
+ # Thinking/reasoning mode is surfaced via AIAgentOutput.thinking,
+ # not as a Params toggle.
spec = get_node_spec("coding_agent")
- budget = spec["inputs"]["properties"]["thinkingBudget"]
- assert budget["displayOptions"]["show"]["thinking_enabled"] == [True]
- effort = spec["inputs"]["properties"]["reasoningEffort"]
- assert effort["displayOptions"]["show"]["thinking_enabled"] == [True]
+ props = spec["inputs"]["properties"]
+ for field in ("provider", "model", "temperature", "max_tokens", "system_message", "api_key"):
+ assert field in props, f"coding_agent missing {field}"
def test_chat_model_password_masked(self):
spec = get_node_spec("openaiChatModel")
- api_key = spec["inputs"]["properties"]["apiKey"]
+ api_key = spec["inputs"]["properties"]["api_key"]
assert api_key["password"] is True
def test_webhook_trigger_header_auth_gated(self):
spec = get_node_spec("webhookTrigger")
- for field in ["headerName", "headerValue"]:
+ for field in ["header_name", "header_value"]:
prop = spec["inputs"]["properties"][field]
assert prop["displayOptions"]["show"]["authentication"] == ["header"]
- assert spec["inputs"]["properties"]["headerValue"]["password"] is True
+ assert spec["inputs"]["properties"]["header_value"]["password"] is True
def test_console_field_mode_gating(self):
spec = get_node_spec("console")
- assert spec["inputs"]["properties"]["fieldPath"]["displayOptions"]["show"]["log_mode"] == ["field"]
+ assert spec["inputs"]["properties"]["field_path"]["displayOptions"]["show"]["log_mode"] == ["field"]
assert spec["inputs"]["properties"]["expression"]["displayOptions"]["show"]["log_mode"] == ["expression"]
def test_process_manager_operation_gating(self):
spec = get_node_spec("processManager")
assert spec["inputs"]["properties"]["command"]["displayOptions"]["show"]["operation"] == ["start"]
- assert spec["inputs"]["properties"]["input"]["displayOptions"]["show"]["operation"] == ["send_input"]
+ assert spec["inputs"]["properties"]["input_text"]["displayOptions"]["show"]["operation"] == ["send_input"]
def test_proxy_request_body_gating(self):
spec = get_node_spec("proxyRequest")
@@ -593,17 +600,17 @@ class TestDisplayOptionsEnrichment:
def test_vector_store_query_fields_gated(self):
spec = get_node_spec("vectorStore")
- for field in ["query", "topK"]:
+ for field in ["query_embedding", "top_k"]:
assert spec["inputs"]["properties"][field]["displayOptions"]["show"]["operation"] == ["query"]
def test_email_read_operation_gating(self):
spec = get_node_spec("emailRead")
assert "search" in spec["inputs"]["properties"]["query"]["displayOptions"]["show"]["operation"]
- assert "read" in spec["inputs"]["properties"]["messageId"]["displayOptions"]["show"]["operation"]
+ assert "read" in spec["inputs"]["properties"]["message_id"]["displayOptions"]["show"]["operation"]
def test_file_modify_edit_gated(self):
spec = get_node_spec("fileModify")
- for field in ["oldString", "newString", "replaceAll"]:
+ for field in ["old_string", "new_string", "replace_all"]:
assert spec["inputs"]["properties"][field]["displayOptions"]["show"]["operation"] == ["edit"]
assert spec["inputs"]["properties"]["content"]["displayOptions"]["show"]["operation"] == ["write"]
@@ -995,7 +1002,7 @@ class TestWave10GContractInvariants:
if not schema:
continue
for name, prop in (schema.get("properties") or {}).items():
- if name in ("apiKey", "api_key") and prop.get("password") is not True:
+ if name in ("api_key", "api_key") and prop.get("password") is not True:
offenders.append(f"{t}.{name}")
assert not offenders, (
"API-key fields missing password:True — they would render in "