Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
feat(schema): Wave 10.G.2 — backfill Pydantic UX hints lost in Wave 8 slim
trohitgf048e810da16
diff --git a/server/models/nodes.py b/server/models/nodes.pyindex 6492dbda..4e92a644 100644--- a/server/models/nodes.py+++ b/server/models/nodes.py@@ -43,9 +43,15 @@ class BaseNodeParams(BaseModel):# =============================================================================class AIChatModelParams(BaseNodeParams):- """Parameters for AI chat model nodes."""+ """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})+ 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,@@ -54,13 +60,71 @@ class AIChatModelParams(BaseNodeParams):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},+ 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."""@@ -173,8 +237,11 @@ class CreateMapParams(BaseNodeParams):class GmapsLocationsParams(BaseNodeParams):"""Parameters for GMaps Locations (geocoding) node."""type: Literal["gmaps_locations"]- address: str = ""- api_key: Optional[str] = Field(default=None, alias="apiKey")+ 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):@@ -184,7 +251,10 @@ class GmapsNearbyPlacesParams(BaseNodeParams):longitude: float = 0.0radius: 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")+ api_key: Optional[str] = Field(+ default=None, alias="apiKey",+ json_schema_extra={"password": True},+ )# =============================================================================@@ -247,10 +317,34 @@ class WhatsAppReceiveParams(BaseNodeParams):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")- group_id: str = Field(default="", alias="group_id")- sender_number: str = Field(default="", alias="senderNumber")- keywords: str = Field(default="")+ 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")@@ -279,14 +373,20 @@ class WhatsAppDbParams(BaseNodeParams):class PythonExecutorParams(BaseNodeParams):"""Parameters for Python code executor node."""type: Literal["pythonExecutor"]- code: str = ""+ 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 = ""+ code: str = Field(+ default="",+ json_schema_extra={"editor": "code", "editorLanguage": "javascript", "rows": 8},+ )timeout: int = Field(default=30, ge=1, le=300)@@ -294,7 +394,10 @@ class TypeScriptExecutorParams(BaseNodeParams):"""Parameters for TypeScript code executor node (compiles to JSvia the Node.js server with tsx)."""type: Literal["typescriptExecutor"]- code: str = ""+ code: str = Field(+ default="",+ json_schema_extra={"editor": "code", "editorLanguage": "typescript", "rows": 8},+ )timeout: int = Field(default=30, ge=1, le=300)@@ -302,7 +405,10 @@ 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")+ 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="",@@ -906,7 +1012,7 @@ class SocialSendParams(BaseNodeParams):class BraveSearchParams(BaseNodeParams):type: Literal["braveSearch"]- query: str = ""+ 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")@@ -915,7 +1021,7 @@ class BraveSearchParams(BaseNodeParams):class SerperSearchParams(BaseNodeParams):type: Literal["serperSearch"]- query: str = ""+ 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 = ""@@ -924,7 +1030,7 @@ class SerperSearchParams(BaseNodeParams):class PerplexitySearchParams(BaseNodeParams):type: Literal["perplexitySearch"]- query: str = ""+ 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")@@ -975,9 +1081,9 @@ class ApifyActorParams(BaseNodeParams):class EmailSendParams(BaseNodeParams):type: Literal["emailSend"]provider: str = ""- to: str = ""- subject: str = ""- body: 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")@@ -1025,11 +1131,18 @@ class GmailParams(BaseNodeParams):)body: str = Field(default="",- json_schema_extra={"displayOptions": {"show": {"operation": ["send"]}}},+ json_schema_extra={+ "rows": 4,+ "placeholder": "Write your message...",+ "displayOptions": {"show": {"operation": ["send"]}},+ },)query: str = Field(default="",- json_schema_extra={"displayOptions": {"show": {"operation": ["search"]}}},+ json_schema_extra={+ "placeholder": "from:jane subject:meeting",+ "displayOptions": {"show": {"operation": ["search"]}},+ },)message_id: str = Field(default="",@@ -1070,42 +1183,82 @@ class CalendarParams(BaseNodeParams):class DriveParams(BaseNodeParams):type: Literal["drive"]operation: Literal["upload", "download", "list", "share"] = "list"- file_id: str = Field(default="", alias="fileId")- file_name: str = Field(default="", alias="fileName")- file_path: str = Field(default="", alias="filePath")+ 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"},+ 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")- range_: str = Field(default="", alias="range")- values: str = "[]"+ 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",+ default="@default", alias="tasklistId",json_schema_extra={"loadOptionsMethod": "googleTasklists"},)- task_id: str = Field(default="", alias="taskId")- title: str = ""- notes: str = ""+ 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")- query: str = ""+ 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 --------------------------------------------------------------@@ -1127,7 +1280,10 @@ 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")+ api_key: Optional[str] = Field(+ default=None, alias="apiKey",+ json_schema_extra={"password": True},+ )class VectorStoreParams(BaseNodeParams):@@ -1279,15 +1435,24 @@ class GmailReceiveParams(BaseNodeParams):class TextGeneratorParams(BaseNodeParams):"""Parameters for text generator node."""type: Literal["textGenerator"]- template: str = ""+ 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")- content: str = ""+ 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"]}},+ },+ )# =============================================================================