Skip to content

Self-improving AI Employees for everyone

chore: adapt tests to snake_case-everywhere plugin convention (415 -> 422)

trohitg7b416cbf9d4f
diff --git a/docs-internal/plugin_system.md b/docs-internal/plugin_system.md
index f274247c..b085ed98 100644
--- a/docs-internal/plugin_system.md
+++ b/docs-internal/plugin_system.md
@@ -128,6 +128,55 @@ class SpecializedAgentBase(ActionNode, abstract=True):
| `retry_policy` | `RetryPolicy` dataclass (mirrors `temporalio.common.RetryPolicy`). |
| `start_to_close_timeout` / `heartbeat_timeout` | Per-node Temporal knobs. |
+### Params schema conventions
+
+**snake_case everywhere.** Field names are the JSON Schema keys, the UI
+parameter keys, and the `displayOptions.show` reference keys. Keeping
+a single naming convention makes cross-references trivially correct.
+
+- No `alias="camelName"` on `Field(...)`.
+- No `populate_by_name=True` in `model_config`.
+- No `model_dump(by_alias=True)` in handlers — call `model_dump()` or
+ read typed attributes off the validated `params` object.
+- `displayOptions.show["driver_field"]` must match a Pydantic field
+ name in the same `Params` class. The frontend's visibility evaluator
+ looks up that exact key.
+
+Example:
+
+```python
+class ExampleParams(BaseModel):
+ operation: Literal["send", "search"] = Field(default="send")
+ recipient: str = Field(
+ default="",
+ description="Email recipient",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["send"]}}},
+ )
+ query: str = Field(
+ default="",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["search"]}}},
+ )
+ model_config = ConfigDict(extra="ignore")
+```
+
+Option labels (the `name` shown in dropdowns) ride on `json_schema_extra`:
+
+```python
+operation: Literal["send", "search"] = Field(
+ default="send",
+ json_schema_extra={"options": [
+ {"name": "Send", "value": "send"},
+ {"name": "Search", "value": "search"},
+ ]},
+)
+```
+
+If a user-facing input needs multi-line, a password mask, or a code
+editor, set those via `json_schema_extra` keys the adapter lifts into
+`typeOptions`: `rows`, `password`, `editor`, `editorLanguage`,
+`dynamicOptions`, `loadOptionsMethod`, `numberStepSize`, `widget`,
+`accept`.
+
### Operations (`@Operation`)
A multi-op node declares multiple methods, each decorated with
@@ -237,7 +286,7 @@ from ._inline import prepare_agent_call
kwargs = await prepare_agent_call(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True),
+ parameters=params.model_dump(),
context=ctx.raw, database=database,
log_prefix=f"[{self.type}]",
)
diff --git a/server/models/nodes.py b/server/models/nodes.py
index 8478febc..df0da4c6 100644
--- a/server/models/nodes.py
+++ b/server/models/nodes.py
@@ -716,11 +716,21 @@ class MasterSkillParams(BaseNodeParams):
class TelegramReceiveParams(BaseNodeParams):
- """Parameters for Telegram receive trigger node."""
+ """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"},
@@ -738,6 +748,7 @@ class TelegramReceiveParams(BaseNodeParams):
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"},
@@ -750,21 +761,34 @@ class TelegramReceiveParams(BaseNodeParams):
{"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="",
- alias="chatId",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["specific_chat"]}}},
+ description="Only trigger for messages from this specific chat ID",
+ json_schema_extra={"displayOptions": {"show": {"senderFilter": ["specific_chat"]}}},
)
from_user: str = Field(
default="",
- alias="fromUser",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["specific_user"]}}},
+ description="Only trigger for messages from this specific user ID",
+ json_schema_extra={"displayOptions": {"show": {"senderFilter": ["specific_user"]}}},
)
keywords: str = Field(
default="",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["keywords"]}}},
+ 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",
+ ]}}},
)
- ignore_bots: bool = Field(default=True, alias="ignoreBots")
class TwitterReceiveParams(BaseNodeParams):
@@ -795,53 +819,123 @@ class TwitterReceiveParams(BaseNodeParams):
class TelegramSendParams(BaseNodeParams):
- """Parameters for Telegram send message node."""
+ """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_type: Literal["self", "chat_id"] = Field(default="self", alias="recipientType")
+
+ # ===== 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="",
- alias="chatId",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["chat_id"]}}},
+ description="Telegram chat ID (numeric) or @username",
+ json_schema_extra={"displayOptions": {"show": {"recipient_type": ["user", "group"]}}},
)
- message_type: Literal["text", "photo", "document", "location", "contact"] = Field(default="text", alias="messageType")
+
+ # ===== 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="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["text"]}}},
+ description="Text message content",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
)
+
+ # ===== MEDIA (photo / document) =====
media_url: str = Field(
default="",
- alias="mediaUrl",
+ 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="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["photo", "document"]}}},
+ description="Optional caption for media",
+ json_schema_extra={
+ "rows": 2,
+ "displayOptions": {"show": {"message_type": ["photo", "document"]}},
+ },
)
- latitude: Optional[float] = Field(
- default=None,
+
+ # ===== LOCATION =====
+ latitude: float = Field(
+ default=0.0,
+ description="Location latitude (-90 to 90)",
json_schema_extra={"displayOptions": {"show": {"message_type": ["location"]}}},
)
- longitude: Optional[float] = Field(
- default=None,
+ longitude: float = Field(
+ default=0.0,
+ description="Location longitude (-180 to 180)",
json_schema_extra={"displayOptions": {"show": {"message_type": ["location"]}}},
)
- phone: str = Field(
+
+ # ===== 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="",
- alias="firstName",
+ description="Contact first name",
json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
)
last_name: str = Field(
default="",
- alias="lastName",
+ description="Contact last name (optional)",
json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
)
- parse_mode: Literal["Auto", "HTML", "Markdown", "MarkdownV2", "None"] = Field(default="Auto", alias="parseMode")
- silent: bool = False
- reply_to_message_id: Optional[int] = Field(default=None, alias="replyToMessageId")
+
+ # ===== 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):
diff --git a/server/nodes/README.md b/server/nodes/README.md
index 69c92888..a18ec7d6 100644
--- a/server/nodes/README.md
+++ b/server/nodes/README.md
@@ -30,10 +30,11 @@ class AcmeCredential(ApiKeyCredential):
# 2. Params — user-visible config (UI + LLM tool schema).
+# snake_case throughout — field names = JSON Schema keys = UI param keys.
class AcmeParams(BaseModel):
query: str = Field(..., min_length=1)
- max_results: int = Field(default=10, ge=1, le=100, alias="maxResults")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ max_results: int = Field(default=10, ge=1, le=100)
+ model_config = ConfigDict(extra="ignore")
# 3. Output — runtime result shape.
@@ -221,8 +222,12 @@ Run: `pytest server/tests/test_plugin_contract.py -q`.
- **Pydantic `extra="ignore"` is the default for Params** — extra fields
silently drop. Use `extra="allow"` if the node passes unknown fields
through to a handler.
-- **Alias camelCase fields** via `Field(..., alias="camelName")` +
- `ConfigDict(populate_by_name=True)`. Frontend sends camelCase.
+- **snake_case everywhere.** Field names, JSON Schema keys,
+ `displayOptions.show` keys, and handler dict access all use snake_case.
+ No `alias="camelName"`, no `populate_by_name=True`, no
+ `model_dump(by_alias=True)`. `displayOptions.show["driver_field"]` must
+ match a property name in the same `Params` class — the frontend's
+ visibility evaluator looks up that exact key.
- **LLM tool schemas must be flat.** If your Params uses nested
Pydantic models or `Union`, the LLM-schema emission will add `$defs`
and fail the invariant. Keep tool-facing Params flat; move nested
diff --git a/server/nodes/agent/_specialized.py b/server/nodes/agent/_specialized.py
index 4f6c1c8e..781a1c95 100644
--- a/server/nodes/agent/_specialized.py
+++ b/server/nodes/agent/_specialized.py
@@ -38,17 +38,17 @@ class SpecializedAgentParams(BaseModel):
default="", json_schema_extra={"placeholder": "Select a model..."},
)
temperature: float = Field(default=0.7, ge=0.0, le=2.0)
- max_tokens: Optional[int] = Field(default=1000, alias="maxTokens", ge=1, le=200000)
+ max_tokens: Optional[int] = Field(default=1000, ge=1, le=200000)
system_message: Optional[str] = Field(
default="You are a helpful assistant",
- alias="systemMessage", json_schema_extra={"rows": 3},
+ json_schema_extra={"rows": 3},
)
api_key: Optional[str] = Field(
- default=None, alias="apiKey",
+ default=None,
json_schema_extra={"password": True},
)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class SpecializedAgentOutput(BaseModel):
@@ -91,7 +91,7 @@ class SpecializedAgentBase(ActionNode, abstract=True):
database = container.database()
kwargs = await prepare_agent_call(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True),
+ parameters=params.model_dump(),
context=ctx.raw, database=database,
log_prefix=f"[{self.type}]",
)
diff --git a/server/nodes/agent/ai_agent.py b/server/nodes/agent/ai_agent.py
index af4fbbe0..a927c721 100644
--- a/server/nodes/agent/ai_agent.py
+++ b/server/nodes/agent/ai_agent.py
@@ -36,18 +36,17 @@ class AIAgentParams(BaseModel):
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)
+ max_tokens: Optional[int] = Field(default=1000, 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",
+ default=None,
json_schema_extra={"password": True},
)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class AIAgentOutput(BaseModel):
@@ -96,7 +95,7 @@ class AIAgentNode(ActionNode):
database = container.database()
kwargs = await prepare_agent_call(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True),
+ parameters=params.model_dump(),
context=ctx.raw, database=database,
log_prefix="[AI Agent]",
)
diff --git a/server/nodes/agent/chat_agent.py b/server/nodes/agent/chat_agent.py
index 3e8d053c..a02f535a 100644
--- a/server/nodes/agent/chat_agent.py
+++ b/server/nodes/agent/chat_agent.py
@@ -32,16 +32,16 @@ class ChatAgentParams(BaseModel):
},
)
system_message: Optional[str] = Field(
- default="", alias="systemMessage", json_schema_extra={"rows": 3},
+ default="", json_schema_extra={"rows": 3},
)
temperature: float = Field(default=0.7, ge=0.0, le=2.0)
- max_tokens: Optional[int] = Field(default=1000, alias="maxTokens", ge=1, le=200000)
+ max_tokens: Optional[int] = Field(default=1000, ge=1, le=200000)
api_key: Optional[str] = Field(
- default=None, alias="apiKey",
+ default=None,
json_schema_extra={"password": True},
)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ChatAgentOutput(BaseModel):
@@ -83,7 +83,7 @@ class ChatAgentNode(ActionNode):
database = container.database()
kwargs = await prepare_agent_call(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True),
+ parameters=params.model_dump(),
context=ctx.raw, database=database,
log_prefix="[Chat Agent]",
)
diff --git a/server/nodes/agent/claude_code_agent.py b/server/nodes/agent/claude_code_agent.py
index 294a1be6..c24e463a 100644
--- a/server/nodes/agent/claude_code_agent.py
+++ b/server/nodes/agent/claude_code_agent.py
@@ -26,16 +26,15 @@ logger = get_logger(__name__)
class ClaudeCodeAgentParams(SpecializedAgentParams):
"""Adds CLI-specific flags the handler body reads from payload."""
- max_turns: int = Field(default=10, alias="maxTurns", ge=1)
- max_budget_usd: float = Field(default=5.0, alias="maxBudgetUsd", ge=0.0)
- system_prompt: Optional[str] = Field(default=None, alias="systemPrompt")
- working_directory: Optional[str] = Field(default=None, alias="workingDirectory")
+ max_turns: int = Field(default=10, ge=1)
+ max_budget_usd: float = Field(default=5.0, ge=0.0)
+ system_prompt: Optional[str] = Field(default=None)
+ working_directory: Optional[str] = Field(default=None)
allowed_tools: str = Field(
default="Read,Edit,Bash,Glob,Grep,Write",
- alias="allowedTools",
- )
+ )
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ClaudeCodeAgentNode(ActionNode):
@@ -65,7 +64,7 @@ class ClaudeCodeAgentNode(ActionNode):
broadcaster = get_status_broadcaster()
workflow_id = ctx.workflow_id
node_id = ctx.node_id
- payload = params.model_dump(by_alias=True)
+ payload = params.model_dump()
await broadcaster.update_node_status(
node_id, "executing",
@@ -93,8 +92,8 @@ class ClaudeCodeAgentNode(ActionNode):
_, skill_data, _, _, _ = await collect_agent_connections(node_id, ctx.raw, database)
system_parts = []
- if payload.get("systemPrompt"):
- system_parts.append(payload["systemPrompt"])
+ if payload.get("system_prompt"):
+ system_parts.append(payload["system_prompt"])
for skill in skill_data:
instr = skill.get("parameters", {}).get("instructions", "")
if instr:
@@ -112,10 +111,10 @@ class ClaudeCodeAgentNode(ActionNode):
prompt=prompt,
node_id=node_id,
model=model,
- cwd=payload.get("workingDirectory") or None,
- allowed_tools=payload.get("allowedTools", "Read,Edit,Bash,Glob,Grep,Write"),
- max_turns=int(payload.get("maxTurns", 10)),
- max_budget_usd=float(payload.get("maxBudgetUsd", 5.0)),
+ cwd=payload.get("working_directory") or None,
+ allowed_tools=payload.get("allowed_tools", "Read,Edit,Bash,Glob,Grep,Write"),
+ max_turns=int(payload.get("max_turns", 10)),
+ max_budget_usd=float(payload.get("max_budget_usd", 5.0)),
system_prompt="\n\n".join(system_parts) if system_parts else None,
)
diff --git a/server/nodes/agent/deep_agent.py b/server/nodes/agent/deep_agent.py
index 5db94d3c..ed649aaa 100644
--- a/server/nodes/agent/deep_agent.py
+++ b/server/nodes/agent/deep_agent.py
@@ -48,7 +48,7 @@ class DeepAgentNode(ActionNode):
database = container.database()
node_id = ctx.node_id
workflow_id = ctx.workflow_id
- payload = params.model_dump(by_alias=True)
+ payload = params.model_dump()
# 1. Edge-walk for memory / skill / tool / input / task connections.
memory_data, skill_data, tool_data, input_data, task_data = await collect_agent_connections(
diff --git a/server/nodes/agent/rlm_agent.py b/server/nodes/agent/rlm_agent.py
index d01bc710..5ed878c1 100644
--- a/server/nodes/agent/rlm_agent.py
+++ b/server/nodes/agent/rlm_agent.py
@@ -47,7 +47,7 @@ class RLMAgentNode(ActionNode):
database = container.database()
node_id = ctx.node_id
workflow_id = ctx.workflow_id
- payload = params.model_dump(by_alias=True)
+ payload = params.model_dump()
# 1. Edge-walk for memory / skill / tool / input / task connections.
memory_data, skill_data, tool_data, input_data, task_data = await collect_agent_connections(
diff --git a/server/nodes/android/_base.py b/server/nodes/android/_base.py
index dcd552c6..d9ee0efd 100644
--- a/server/nodes/android/_base.py
+++ b/server/nodes/android/_base.py
@@ -43,7 +43,14 @@ SERVICE_ID_MAP: Dict[str, str] = {
class AndroidServiceParams(BaseModel):
- action: str = Field(default="status", description="Service action to invoke")
+ action: str = Field(
+ default="status",
+ description="Service action to invoke (populated dynamically from backend)",
+ json_schema_extra={
+ "dynamicOptions": True,
+ "loadOptionsMethod": "getAndroidServiceActions",
+ },
+ )
parameters: Dict[str, Any] = Field(default_factory=dict)
model_config = ConfigDict(extra="allow")
diff --git a/server/nodes/android/app_launcher.py b/server/nodes/android/app_launcher.py
index ae74d5dd..e50c3538 100644
--- a/server/nodes/android/app_launcher.py
+++ b/server/nodes/android/app_launcher.py
@@ -1,4 +1,24 @@
-from ._base import AndroidServiceBase
+from typing import Optional
+
+from pydantic import ConfigDict, Field
+
+from ._base import AndroidServiceBase, AndroidServiceParams
+
+
+class AppLauncherParams(AndroidServiceParams):
+ """Extends the shared Android Params with a conditional package_name
+ field, required when action='launch'.
+ """
+
+ package_name: Optional[str] = Field(
+ default=None,
+ description="Android application package name (e.g. com.whatsapp)",
+ json_schema_extra={
+ "displayOptions": {"show": {"action": ["launch"]}},
+ },
+ )
+
+ model_config = ConfigDict(extra="allow")
class AppLauncherNode(AndroidServiceBase):
@@ -6,3 +26,5 @@ class AppLauncherNode(AndroidServiceBase):
display_name = "App Launcher"
icon = "🚀"
description = "Launch applications by package name"
+
+ Params = AppLauncherParams
diff --git a/server/nodes/browser/browser.py b/server/nodes/browser/browser.py
index b278c407..00e32854 100644
--- a/server/nodes/browser/browser.py
+++ b/server/nodes/browser/browser.py
@@ -109,14 +109,14 @@ def _build_args(op: str, p: Dict[str, Any]) -> List[str]:
return ["fill", _req_sel(s), p.get("value") or ""]
case "screenshot":
args = ["screenshot"]
- if p.get("fullPage"):
+ if p.get("full_page"):
args.append("--full")
if p.get("annotate"):
args.append("--annotate")
- fmt = p.get("screenshotFormat", "png")
+ fmt = p.get("screenshot_format", "png")
if fmt and fmt != "png":
args.extend(["--screenshot-format", fmt])
- quality = p.get("screenshotQuality")
+ quality = p.get("screenshot_quality")
if quality and fmt == "jpeg":
args.extend(["--screenshot-quality", str(quality)])
return args
@@ -143,14 +143,11 @@ def _build_args(op: str, p: Dict[str, Any]) -> List[str]:
class BrowserParams(BaseModel):
- """Browser automation parameters.
-
- Mirrors the operation-facing surface of the agent-browser CLI. Fields
- are scoped to what the LLM needs to drive each operation; stealth and
- runtime config (headed, browser, chromeProfile, proxy, timeout, ...)
- flow through as node_params via the plugin's {**node_params, **tool_args}
- merge and are consumed by dispatch() with sensible defaults, without
- being exposed to the LLM tool schema.
+ """Browser automation parameters — full baseline schema.
+
+ Organized into operation-scoped fields (drive the LLM tool schema) and
+ runtime/stealth config (always visible in the workflow panel, used for
+ browser binary selection, profiles, proxy, user agent, etc.).
"""
operation: Literal[
@@ -160,38 +157,136 @@ class BrowserParams(BaseModel):
] = Field(
default="navigate",
description=(
- "Operation: navigate, click, type, fill, screenshot, snapshot, "
- "get_text, get_html, eval, wait, scroll, select, console, errors, batch. "
- "Typical flow: navigate -> snapshot -> interact using @eN refs -> snapshot."
+ "Browser operation. Typical flow: navigate -> snapshot -> "
+ "interact using @eN refs -> snapshot."
),
)
- url: Optional[str] = Field(default=None, description="[navigate] URL to open")
- selector: Optional[str] = Field(
- default=None,
- description="[click/type/fill/get_text/get_html/wait/select] CSS selector or @eN ref from snapshot",
+ # Operation-scoped fields
+ url: str = Field(
+ default="",
+ description="URL to open.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["navigate"]}}},
+ )
+ selector: str = Field(
+ default="",
+ description="CSS selector or @eN ref from snapshot.",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": [
+ "click", "type", "fill", "get_text", "get_html", "wait", "select",
+ ]}},
+ },
+ )
+ text: str = Field(
+ default="",
+ description="Text to type keystroke-by-keystroke.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["type"]}}},
+ )
+ value: str = Field(
+ default="",
+ description="Value to fill (fill) or option value to select (select).",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["fill", "select"]}}},
)
- text: Optional[str] = Field(default=None, description="[type] Text to type")
- value: Optional[str] = Field(
- default=None,
- description="[fill/select] Value to fill or option to select",
+ expression: str = Field(
+ default="",
+ description="JavaScript to execute in page context.",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"operation": ["eval"]}},
+ },
)
- expression: Optional[str] = Field(default=None, description="[eval] JavaScript to execute")
- direction: Optional[str] = Field(default="down", description="[scroll] up, down, left, right")
- amount: Optional[int] = Field(default=500, description="[scroll] Pixels to scroll")
- fullPage: Optional[bool] = Field(default=False, description="[screenshot] Capture full scrollable page")
-
- session: Optional[str] = Field(
- default=None,
- description="Browser session name for state sharing across chained nodes (auto-derived when empty)",
+ direction: Literal["up", "down", "left", "right"] = Field(
+ default="down",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["scroll"]}}},
+ )
+ amount: int = Field(
+ default=500, ge=1, le=20000,
+ description="Pixels to scroll.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["scroll"]}}},
+ )
+ commands: str = Field(
+ default="[]",
+ description="JSON array of batch commands (see agent-browser batch docs).",
+ json_schema_extra={
+ "rows": 6,
+ "displayOptions": {"show": {"operation": ["batch"]}},
+ },
)
- # extra="allow" lets stealth and runtime config (headed, browser,
- # chromeProfile, proxy, timeout, newWindow, userAgent, autoConnect,
- # executablePath, actionDelay, annotate, screenshotFormat,
- # screenshotQuality, commands) flow through from node_params without
- # surfacing in the LLM tool schema. dispatch() reads them with defaults.
- model_config = ConfigDict(extra="allow")
+ # Screenshot options
+ full_page: bool = Field(
+ default=False,
+ description="Capture full scrollable page.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["screenshot"]}}},
+ )
+ annotate: bool = Field(
+ default=False,
+ description="Overlay element boxes on screenshot.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["screenshot"]}}},
+ )
+ screenshot_format: Literal["png", "jpeg"] = Field(
+ default="png",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["screenshot"]}}},
+ )
+ screenshot_quality: int = Field(
+ default=85, ge=1, le=100,
+ description="JPEG quality (1-100).",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "operation": ["screenshot"], "screenshot_format": ["jpeg"],
+ }},
+ },
+ )
+
+ # Session
+ session: str = Field(
+ default="",
+ description="Browser session name for state sharing across chained nodes (auto-derived when empty).",
+ )
+
+ # Browser binary selection
+ browser: Literal["chrome", "edge", "chromium", "bundled_explicit", "custom"] = Field(
+ default="chrome",
+ description="Which browser binary to drive.",
+ )
+ executable_path: str = Field(
+ default="",
+ description="Full path to browser executable.",
+ json_schema_extra={"displayOptions": {"show": {"browser": ["custom"]}}},
+ )
+
+ # Runtime config
+ headed: bool = Field(default=True, description="Show browser window (false = headless).")
+ new_window: bool = Field(
+ default=True,
+ description="Open a new browser window for this run.",
+ )
+ auto_connect: bool = Field(
+ default=False,
+ description="Reuse an already-running browser with CDP enabled.",
+ )
+ chrome_profile: str = Field(
+ default="",
+ description="Chrome user-profile name (e.g. 'Default').",
+ )
+ user_agent: str = Field(
+ default="",
+ description="Custom User-Agent string.",
+ )
+ proxy: str = Field(
+ default="",
+ description="Proxy URL (e.g. http://user:pass@host:port).",
+ )
+ action_delay: int = Field(
+ default=0, ge=0, le=60000,
+ description="Delay before each action in milliseconds (for stealth).",
+ )
+ timeout: int = Field(
+ default=30, ge=1, le=600,
+ description="Per-action timeout in seconds.",
+ )
+
+ model_config = ConfigDict(extra="ignore")
class BrowserOutput(BaseModel):
@@ -232,38 +327,34 @@ class BrowserNode(ActionNode):
"agent-browser not installed. Run: pnpm install && npx agent-browser install",
)
- p = params.model_dump(by_alias=True)
- op = p.get("operation") or "navigate"
+ op = params.operation
session = (
- (p.get("session") or "").strip()
+ params.session.strip()
or f"machina_{ctx.raw.get('execution_id', 'default')}"
)
- timeout = int(p.get("timeout") or 30)
- headed = bool(p.get("headed", True))
- auto_connect = bool(p.get("autoConnect", False))
- browser_sel = p.get("browser", "chrome")
- if not browser_sel or browser_sel == "bundled":
+ timeout = params.timeout
+ browser_sel = params.browser or "chrome"
+ if browser_sel == "bundled":
browser_sel = "chrome"
- custom_path = (p.get("executablePath") or "").strip()
- executable_path = _resolve_browser(browser_sel, custom_path)
+ executable_path = _resolve_browser(browser_sel, params.executable_path.strip())
logger.info("[Browser] browser=%s executable=%s", browser_sel, executable_path)
- new_window = bool(p.get("newWindow", True)) and executable_path is not None
- chrome_profile = (p.get("chromeProfile") or "").strip() or None
- user_agent = (p.get("userAgent") or "").strip() or None
- proxy = (p.get("proxy") or "").strip() or None
- action_delay = int(p.get("actionDelay") or 0)
run_kw = dict(
- headed=headed, user_agent=user_agent, proxy=proxy,
- executable_path=executable_path, auto_connect=auto_connect,
- chrome_profile=chrome_profile, new_window=new_window,
+ headed=params.headed,
+ user_agent=params.user_agent.strip() or None,
+ proxy=params.proxy.strip() or None,
+ executable_path=executable_path,
+ auto_connect=params.auto_connect,
+ chrome_profile=params.chrome_profile.strip() or None,
+ new_window=params.new_window and executable_path is not None,
)
- if action_delay > 0:
- await svc.run(["wait", str(action_delay)], session, timeout, **run_kw)
+ if params.action_delay > 0:
+ await svc.run(["wait", str(params.action_delay)], session, timeout, **run_kw)
+ p = params.model_dump()
if op == "batch":
- cmds = json.loads(p.get("commands", "[]"))
+ cmds = json.loads(params.commands or "[]")
data = await svc.run(
["batch", "--json"], session, timeout,
stdin=json.dumps(cmds).encode(),
diff --git a/server/nodes/chat/chat_history.py b/server/nodes/chat/chat_history.py
index 5fc1a055..429eb441 100644
--- a/server/nodes/chat/chat_history.py
+++ b/server/nodes/chat/chat_history.py
@@ -16,11 +16,11 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class ChatHistoryParams(BaseModel):
host: str = Field(default="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")
+ session_id: str = Field(default="default")
+ api_key: str = Field(default="")
limit: int = Field(default=50, ge=1, le=500)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ChatHistoryOutput(BaseModel):
diff --git a/server/nodes/chat/chat_send.py b/server/nodes/chat/chat_send.py
index 636c4521..f9131b81 100644
--- a/server/nodes/chat/chat_send.py
+++ b/server/nodes/chat/chat_send.py
@@ -18,13 +18,13 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class ChatSendParams(BaseModel):
host: str = Field(default="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")
+ session_id: str = Field(default="default")
+ api_key: str = Field(default="")
content: str = Field(default="")
# legacy field alias — earlier migration used ``message``
message: str = Field(default="")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ChatSendOutput(BaseModel):
diff --git a/server/nodes/document/document_parser.py b/server/nodes/document/document_parser.py
index 50edc7ce..22111917 100644
--- a/server/nodes/document/document_parser.py
+++ b/server/nodes/document/document_parser.py
@@ -38,10 +38,24 @@ def _parse_file_sync(path: Path, parser: str) -> str:
class DocumentParserParams(BaseModel):
- file_path: str = Field(default="", alias="filePath")
- parser: Literal["pypdf", "marker", "unstructured", "beautifulsoup"] = "pypdf"
+ parser: Literal["pypdf", "marker", "unstructured", "beautifulsoup"] = Field(
+ default="pypdf",
+ description="Parser backend. pypdf is fast; marker uses GPU OCR; unstructured handles multi-format; beautifulsoup for HTML.",
+ )
+ file_path: str = Field(
+ default="",
+ description="Single file path (takes precedence over input_dir).",
+ )
+ input_dir: str = Field(
+ default="",
+ description="Directory to scan for files matching file_pattern.",
+ )
+ file_pattern: str = Field(
+ default="*.pdf",
+ description="Glob pattern for input_dir scan (e.g. *.pdf, *.html).",
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class DocumentParserOutput(BaseModel):
@@ -73,20 +87,14 @@ class DocumentParserNode(ActionNode):
@Operation("parse")
async def parse(self, ctx: NodeContext, params: DocumentParserParams) -> DocumentParserOutput:
- p = params.model_dump(by_alias=True)
- files = p.get('files', [])
- input_dir = p.get('inputDir', '')
- parser = p.get('parser', 'pypdf')
- file_pattern = p.get('filePattern', '*.pdf')
- explicit_path = p.get('filePath') or p.get('file_path')
+ parser = params.parser
+ explicit_path = params.file_path
+ input_dir = params.input_dir
+ file_pattern = params.file_pattern or '*.pdf'
paths: list[Path] = []
if explicit_path:
paths.append(Path(explicit_path))
- for f in files:
- path = f.get('path', '') if isinstance(f, dict) else str(f)
- if path:
- paths.append(Path(path))
if input_dir and Path(input_dir).exists():
paths.extend(Path(input_dir).glob(file_pattern))
diff --git a/server/nodes/document/embedding_generator.py b/server/nodes/document/embedding_generator.py
index a99a9f7f..fbc4eb76 100644
--- a/server/nodes/document/embedding_generator.py
+++ b/server/nodes/document/embedding_generator.py
@@ -12,11 +12,25 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class EmbeddingGeneratorParams(BaseModel):
chunks: List[Optional[dict]] = Field(default_factory=list)
- provider: Literal["huggingface", "openai", "ollama"] = "huggingface"
- model: str = Field(default="BAAI/bge-small-en-v1.5")
- api_key: str = Field(default="", alias="apiKey")
+ provider: Literal["huggingface", "openai", "ollama"] = Field(
+ default="huggingface",
+ description="Embedding provider. HuggingFace runs locally; OpenAI needs API key; Ollama connects to local server.",
+ )
+ model: str = Field(
+ default="BAAI/bge-small-en-v1.5",
+ description="Model name (provider-specific). HuggingFace: BAAI/bge-*. OpenAI: text-embedding-3-small.",
+ )
+ batch_size: int = Field(
+ default=32, ge=1, le=256,
+ description="Number of texts per embedding batch.",
+ )
+ api_key: str = Field(
+ default="",
+ description="API key (OpenAI only).",
+ json_schema_extra={"displayOptions": {"show": {"provider": ["openai"]}}},
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class EmbeddingGeneratorOutput(BaseModel):
@@ -51,11 +65,10 @@ class EmbeddingGeneratorNode(ActionNode):
@Operation("embed")
async def embed(self, ctx: NodeContext, params: EmbeddingGeneratorParams) -> EmbeddingGeneratorOutput:
- p = params.model_dump(by_alias=True)
- chunks = p.get('chunks', [])
- provider = p.get('provider', 'huggingface')
- model = p.get('model', 'BAAI/bge-small-en-v1.5')
- api_key = p.get('apiKey', '')
+ chunks = params.chunks
+ provider = params.provider
+ model = params.model
+ api_key = params.api_key
if not chunks:
return EmbeddingGeneratorOutput(
diff --git a/server/nodes/document/file_downloader.py b/server/nodes/document/file_downloader.py
index 988449b8..0cb62c42 100644
--- a/server/nodes/document/file_downloader.py
+++ b/server/nodes/document/file_downloader.py
@@ -18,12 +18,12 @@ logger = get_logger(__name__)
class FileDownloaderParams(BaseModel):
urls: List[str] = Field(default_factory=list)
- 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")
+ output_dir: str = Field(default="downloads")
+ max_workers: int = Field(default=4, ge=1, le=32)
+ skip_existing: bool = Field(default=True)
timeout: int = Field(default=60, ge=1, le=600)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class FileDownloaderOutput(BaseModel):
@@ -57,7 +57,7 @@ class FileDownloaderNode(ActionNode):
@Operation("download")
async def download(self, ctx: NodeContext, params: FileDownloaderParams) -> FileDownloaderOutput:
- p = params.model_dump(by_alias=True)
+ p = params.model_dump()
items = p.get('items') or [{'url': u} for u in p.get('urls', [])]
workspace_dir = ctx.raw.get('workspace_dir', '')
default_dir = str(Path(workspace_dir) / 'downloads') if workspace_dir else p.get('outputDir', 'downloads')
diff --git a/server/nodes/document/http_scraper.py b/server/nodes/document/http_scraper.py
index ddc0215b..ad846137 100644
--- a/server/nodes/document/http_scraper.py
+++ b/server/nodes/document/http_scraper.py
@@ -7,7 +7,7 @@ from __future__ import annotations
import json
from datetime import datetime, timedelta
-from typing import Any, Optional
+from typing import Any, Literal, Optional
from urllib.parse import urljoin
import httpx
@@ -21,12 +21,84 @@ logger = get_logger(__name__)
class HttpScraperParams(BaseModel):
- url: str = Field(default="")
- pagination_mode: str = Field(default="single", alias="paginationMode")
- max_pages: int = Field(default=10, alias="maxPages", ge=1, le=1000)
- use_proxy: bool = Field(default=False, alias="useProxy")
+ url: str = Field(
+ default="",
+ description="URL template. Use {date} for date mode, {page} for page mode.",
+ )
+ iteration_mode: Literal["single", "date", "page"] = Field(
+ default="single",
+ description="single: one URL. date: iterate dates. page: iterate page numbers.",
+ )
+ link_selector: str = Field(
+ default='a[href$=".pdf"]',
+ description="CSS selector for links to extract from each fetched page.",
+ )
+ headers: str = Field(
+ default="{}",
+ description="JSON string of request headers.",
+ json_schema_extra={"rows": 3},
+ )
+
+ # Date-mode fields
+ start_date: str = Field(
+ default="",
+ description="Start date (YYYY-MM-DD).",
+ json_schema_extra={"displayOptions": {"show": {"iteration_mode": ["date"]}}},
+ )
+ end_date: str = Field(
+ default="",
+ description="End date (YYYY-MM-DD).",
+ json_schema_extra={"displayOptions": {"show": {"iteration_mode": ["date"]}}},
+ )
+ date_placeholder: str = Field(
+ default="{date}",
+ description="Placeholder token in URL that gets replaced with each date.",
+ json_schema_extra={"displayOptions": {"show": {"iteration_mode": ["date"]}}},
+ )
+
+ # Page-mode fields
+ start_page: int = Field(
+ default=1, ge=1,
+ description="First page number.",
+ json_schema_extra={"displayOptions": {"show": {"iteration_mode": ["page"]}}},
+ )
+ end_page: int = Field(
+ default=10, ge=1,
+ description="Last page number (inclusive).",
+ json_schema_extra={"displayOptions": {"show": {"iteration_mode": ["page"]}}},
+ )
+ max_pages: int = Field(
+ default=10, ge=1, le=1000,
+ description="Safety cap on pages fetched.",
+ )
+
+ # Proxy
+ use_proxy: bool = Field(
+ default=False,
+ description="Route through residential proxy provider.",
+ )
+ proxy_provider: str = Field(
+ default="auto",
+ description="Provider name ('auto' selects by health score).",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ proxy_country: str = Field(
+ default="",
+ description="ISO country code for geo-targeting.",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ session_type: Literal["rotating", "sticky"] = Field(
+ default="rotating",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ sticky_duration: int = Field(
+ default=600, ge=1,
+ json_schema_extra={
+ "displayOptions": {"show": {"use_proxy": [True], "session_type": ["sticky"]}},
+ },
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class HttpScraperOutput(BaseModel):
@@ -58,25 +130,22 @@ class HttpScraperNode(ActionNode):
@Operation("scrape")
async def scrape(self, ctx: NodeContext, params: HttpScraperParams) -> HttpScraperOutput:
- p = params.model_dump(by_alias=True)
- url = p.get('url', '')
+ url = params.url
if not url:
raise RuntimeError("URL is required")
- iteration_mode = p.get('iterationMode') or p.get('paginationMode', 'single')
- link_selector = p.get('linkSelector', 'a[href$=".pdf"]')
- headers_str = p.get('headers', '{}')
+ iteration_mode = params.iteration_mode
+ link_selector = params.link_selector or 'a[href$=".pdf"]'
+ headers_str = params.headers or '{}'
headers = json.loads(headers_str) if isinstance(headers_str, str) and headers_str else {}
urls_to_fetch = []
if iteration_mode == 'date':
- start_date = p.get('startDate', '')
- end_date = p.get('endDate', '')
- placeholder = p.get('datePlaceholder', '{date}')
- if not start_date or not end_date:
- raise RuntimeError("Start/end dates required for date mode")
- start = datetime.strptime(start_date, "%Y-%m-%d")
- end = datetime.strptime(end_date, "%Y-%m-%d")
+ if not params.start_date or not params.end_date:
+ raise RuntimeError("start_date/end_date required for date mode")
+ placeholder = params.date_placeholder or '{date}'
+ start = datetime.strptime(params.start_date, "%Y-%m-%d")
+ end = datetime.strptime(params.end_date, "%Y-%m-%d")
current = start
while current <= end:
urls_to_fetch.append((
@@ -85,20 +154,18 @@ class HttpScraperNode(ActionNode):
))
current += timedelta(days=1)
elif iteration_mode == 'page':
- start_page = int(p.get('startPage', 1))
- end_page = int(p.get('endPage', 10))
- for page in range(start_page, end_page + 1):
+ for page in range(params.start_page, params.end_page + 1):
urls_to_fetch.append((url.replace('{page}', str(page)), {'page': page}))
else:
urls_to_fetch.append((url, {}))
proxy_url = None
- if p.get('useProxy', False):
+ if params.use_proxy:
try:
from services.proxy.service import get_proxy_service
proxy_svc = get_proxy_service()
if proxy_svc and proxy_svc.is_enabled():
- proxy_url = await proxy_svc.get_proxy_url(url, p)
+ proxy_url = await proxy_svc.get_proxy_url(url, params.model_dump())
except Exception as e:
logger.warning("[httpScraper] Proxy lookup failed", error=str(e))
diff --git a/server/nodes/document/text_chunker.py b/server/nodes/document/text_chunker.py
index 511b58af..63e1493f 100644
--- a/server/nodes/document/text_chunker.py
+++ b/server/nodes/document/text_chunker.py
@@ -12,10 +12,10 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class TextChunkerParams(BaseModel):
text: str = Field(default="")
strategy: Literal["recursive", "markdown", "token"] = "recursive"
- chunk_size: int = Field(default=1000, alias="chunkSize", ge=100, le=8000)
- overlap: int = Field(default=200, alias="chunkOverlap", ge=0, le=1000)
+ chunk_size: int = Field(default=1000, ge=100, le=8000)
+ overlap: int = Field(default=200, ge=0, le=1000)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class TextChunkerOutput(BaseModel):
@@ -50,7 +50,7 @@ class TextChunkerNode(ActionNode):
MarkdownTextSplitter, RecursiveCharacterTextSplitter,
)
- p = params.model_dump(by_alias=True)
+ p = params.model_dump()
documents = p.get('documents') or ([{'content': p.get('text', '')}] if p.get('text') else [])
chunk_size = int(p.get('chunkSize', 1000))
chunk_overlap = int(p.get('chunkOverlap') or p.get('overlap', 200))
diff --git a/server/nodes/document/vector_store.py b/server/nodes/document/vector_store.py
index 4156261b..1711cfd5 100644
--- a/server/nodes/document/vector_store.py
+++ b/server/nodes/document/vector_store.py
@@ -19,17 +19,38 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class VectorStoreParams(BaseModel):
operation: Literal["store", "query", "delete"] = "store"
backend: Literal["chroma", "chromadb", "qdrant", "pinecone"] = "chroma"
- collection_name: str = Field(default="documents", alias="collectionName")
+ collection_name: str = Field(default="documents")
embeddings: Optional[list] = None
- chunks: Optional[list] = None
- query_embedding: Optional[list] = Field(default=None, alias="queryEmbedding")
- top_k: int = Field(default=5, alias="topK", ge=1, le=100)
- ids: Optional[list] = None
- persist_dir: str = Field(default="./data/vectors", alias="persistDir")
- qdrant_url: str = Field(default="http://localhost:6333", alias="qdrantUrl")
- pinecone_api_key: str = Field(default="", alias="pineconeApiKey")
+ chunks: Optional[list] = Field(
+ default=None,
+ json_schema_extra={"displayOptions": {"show": {"operation": ["store"]}}},
+ )
+ query_embedding: Optional[list] = Field(
+ default=None,
+ json_schema_extra={"displayOptions": {"show": {"operation": ["query"]}}},
+ )
+ top_k: int = Field(
+ default=5, ge=1, le=100,
+ json_schema_extra={"displayOptions": {"show": {"operation": ["query"]}}},
+ )
+ ids: Optional[list] = Field(
+ default=None,
+ json_schema_extra={"displayOptions": {"show": {"operation": ["delete"]}}},
+ )
+ persist_dir: str = Field(
+ default="./data/vectors",
+ json_schema_extra={"displayOptions": {"show": {"backend": ["chroma", "chromadb"]}}},
+ )
+ qdrant_url: str = Field(
+ default="http://localhost:6333",
+ json_schema_extra={"displayOptions": {"show": {"backend": ["qdrant"]}}},
+ )
+ pinecone_api_key: str = Field(
+ default="",
+ json_schema_extra={"displayOptions": {"show": {"backend": ["pinecone"]}}},
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class VectorStoreOutput(BaseModel):
@@ -51,7 +72,7 @@ async def _chroma_op(operation: str, params: Dict[str, Any], collection: str) ->
except ImportError:
raise RuntimeError("ChromaDB unavailable. pip install chromadb")
- persist_dir = params.get('persistDir', './data/vectors')
+ persist_dir = params.get('persist_dir', './data/vectors')
client = chromadb.PersistentClient(path=persist_dir)
coll = client.get_or_create_collection(name=collection)
@@ -75,8 +96,8 @@ async def _chroma_op(operation: str, params: Dict[str, Any], collection: str) ->
return {"stored_count": len(embeddings), "collection_count": coll.count()}
if operation == 'query':
- query_emb = params.get('queryEmbedding', [])
- top_k = int(params.get('topK', 5))
+ query_emb = params.get('query_embedding', [])
+ top_k = int(params.get('top_k', 5))
if not query_emb:
return {"matches": []}
results = coll.query(query_embeddings=[query_emb], n_results=top_k)
@@ -107,7 +128,7 @@ async def _qdrant_op(operation: str, params: Dict[str, Any], collection: str) ->
except ImportError:
raise RuntimeError("Qdrant client unavailable. pip install qdrant-client")
- url = params.get('qdrantUrl', 'http://localhost:6333')
+ url = params.get('qdrant_url', 'http://localhost:6333')
client = QdrantClient(url=url)
if operation == 'store':
@@ -140,8 +161,8 @@ async def _qdrant_op(operation: str, params: Dict[str, Any], collection: str) ->
return {"stored_count": len(embeddings)}
if operation == 'query':
- query_emb = params.get('queryEmbedding', [])
- top_k = int(params.get('topK', 5))
+ query_emb = params.get('query_embedding', [])
+ top_k = int(params.get('top_k', 5))
if not query_emb:
return {"matches": []}
results = await asyncio.to_thread(
@@ -165,7 +186,7 @@ async def _qdrant_op(operation: str, params: Dict[str, Any], collection: str) ->
async def _pinecone_op(operation: str, params: Dict[str, Any], collection: str) -> Dict[str, Any]:
from pinecone import Pinecone
- api_key = params.get('pineconeApiKey', '')
+ api_key = params.get('pinecone_api_key', '')
if not api_key:
raise RuntimeError("Pinecone API key required")
@@ -239,11 +260,11 @@ class VectorStoreNode(ActionNode):
@Operation("dispatch")
async def dispatch(self, ctx: NodeContext, params: VectorStoreParams) -> VectorStoreOutput:
- p = params.model_dump(by_alias=True)
- operation = p.get('operation', 'store')
- backend_raw = p.get('backend', 'chroma')
+ p = params.model_dump()
+ operation = params.operation
+ backend_raw = params.backend
backend = 'chroma' if backend_raw in ('chroma', 'chromadb') else backend_raw
- collection = p.get('collectionName', 'documents')
+ collection = params.collection_name
if backend == 'chroma':
result = await _chroma_op(operation, p, collection)
diff --git a/server/nodes/email/email_read.py b/server/nodes/email/email_read.py
index 488a74b0..6ed76715 100644
--- a/server/nodes/email/email_read.py
+++ b/server/nodes/email/email_read.py
@@ -13,16 +13,79 @@ class EmailReadParams(BaseModel):
provider: Literal[
"gmail", "outlook", "yahoo", "icloud",
"protonmail", "fastmail", "custom",
- ] = "gmail"
- operation: Literal["list", "search", "read", "folders", "move", "delete", "flag"] = "list"
- folder: str = Field(default="INBOX")
- query: str = Field(default="")
- message_id: str = Field(default="", alias="messageId")
- target_folder: str = Field(default="", alias="targetFolder")
- flag: str = Field(default="")
- limit: int = Field(default=20, ge=1, le=500)
+ ] = Field(default="gmail", description="IMAP provider preset.")
+ operation: Literal["list", "search", "read", "folders", "move", "delete", "flag"] = Field(
+ default="list",
+ description="IMAP action. folders lists all mailbox folders (no other params needed).",
+ )
+
+ # folder (used by list/search and move source; optional for others)
+ folder: str = Field(
+ default="INBOX",
+ description="Mailbox folder to query.",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["list", "search"]}},
+ },
+ )
+ query: str = Field(
+ default="",
+ description="IMAP search query (e.g. from:alice subject:meeting).",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["search"]}}},
+ )
+ message_id: str = Field(
+ default="",
+ description="Message ID (required for read/move/delete/flag).",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["read", "move", "delete", "flag"]}},
+ },
+ )
+ target_folder: str = Field(
+ default="",
+ description="Destination folder for move.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["move"]}}},
+ )
+ flag: Literal["", "Seen", "Answered", "Flagged", "Draft", "Deleted"] = Field(
+ default="",
+ description="Flag to toggle.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["flag"]}}},
+ )
+ flag_action: Literal["add", "remove"] = Field(
+ default="add",
+ description="add applies the flag; remove clears it.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["flag"]}}},
+ )
+
+ # Pagination (list / search)
+ limit: int = Field(
+ default=20, ge=1, le=500,
+ description="Max envelopes per page.",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["list", "search"]}},
+ },
+ )
+ page: int = Field(
+ default=1, ge=1,
+ description="Page number (1-indexed).",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["list", "search"]}},
+ },
+ )
+ page_size: int = Field(
+ default=20, ge=1, le=500,
+ description="Items per page (overrides limit when paginating).",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["list", "search"]}},
+ },
+ )
+ offset: int = Field(
+ default=0, ge=0,
+ description="Alternative to page-based pagination — skip this many messages.",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["list", "search"]}},
+ },
+ )
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class EmailReadOutput(BaseModel):
@@ -60,4 +123,4 @@ class EmailReadNode(ActionNode):
async def query(self, ctx: NodeContext, params: EmailReadParams) -> Any:
# Body inlined from handlers/email.py (Wave 11.D.1).
from services.email_service import get_email_service
- return await get_email_service().read(params.model_dump(by_alias=True))
+ return await get_email_service().read(params.model_dump())
diff --git a/server/nodes/email/email_receive.py b/server/nodes/email/email_receive.py
index 0fa3de7e..d4006434 100644
--- a/server/nodes/email/email_receive.py
+++ b/server/nodes/email/email_receive.py
@@ -29,10 +29,10 @@ class EmailReceiveParams(BaseModel):
class EmailReceiveOutput(BaseModel):
message_id: Optional[str] = None
subject: Optional[str] = None
- from_: Optional[str] = Field(default=None, alias="from")
+ from_: Optional[str] = Field(default=None)
body: Optional[str] = None
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class EmailReceiveNode(TriggerNode):
diff --git a/server/nodes/email/email_send.py b/server/nodes/email/email_send.py
index 933a6ef2..ebc4fc8c 100644
--- a/server/nodes/email/email_send.py
+++ b/server/nodes/email/email_send.py
@@ -19,9 +19,9 @@ class EmailSendParams(BaseModel):
body: str = Field(default="", json_schema_extra={"rows": 6})
cc: str = Field(default="")
bcc: str = Field(default="")
- body_type: Literal["text", "html"] = Field(default="text", alias="bodyType")
+ body_type: Literal["text", "html"] = Field(default="text")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class EmailSendOutput(BaseModel):
diff --git a/server/nodes/filesystem/file_modify.py b/server/nodes/filesystem/file_modify.py
index 10a46c84..fbdd5754 100644
--- a/server/nodes/filesystem/file_modify.py
+++ b/server/nodes/filesystem/file_modify.py
@@ -11,13 +11,13 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class FileModifyParams(BaseModel):
operation: Literal["write", "edit"] = "write"
- file_path: str = Field(..., alias="filePath")
+ file_path: str = Field(...)
content: str = Field(default="")
- old_string: str = Field(default="", alias="oldString")
- new_string: str = Field(default="", alias="newString")
- replace_all: bool = Field(default=False, alias="replaceAll")
+ old_string: str = Field(default="")
+ new_string: str = Field(default="")
+ replace_all: bool = Field(default=False)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class FileModifyOutput(BaseModel):
@@ -55,7 +55,7 @@ class FileModifyNode(ActionNode):
if not params.file_path:
raise RuntimeError("file_path is required")
- backend = get_backend(params.model_dump(by_alias=True), ctx.raw)
+ backend = get_backend(params.model_dump(), ctx.raw)
if params.operation == "write":
result = await asyncio.to_thread(backend.write, params.file_path, params.content)
diff --git a/server/nodes/filesystem/file_read.py b/server/nodes/filesystem/file_read.py
index 2dd4f265..4f6ecd7e 100644
--- a/server/nodes/filesystem/file_read.py
+++ b/server/nodes/filesystem/file_read.py
@@ -10,11 +10,11 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class FileReadParams(BaseModel):
- file_path: str = Field(..., alias="filePath")
+ file_path: str = Field(...)
offset: int = Field(default=0, ge=0)
limit: int = Field(default=2000, ge=1, le=10000)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class FileReadOutput(BaseModel):
@@ -52,7 +52,7 @@ class FileReadNode(ActionNode):
if not params.file_path:
raise RuntimeError("file_path is required")
- backend = get_backend(params.model_dump(by_alias=True), ctx.raw)
+ backend = get_backend(params.model_dump(), ctx.raw)
content = await asyncio.to_thread(
backend.read, params.file_path,
offset=params.offset, limit=params.limit,
diff --git a/server/nodes/filesystem/fs_search.py b/server/nodes/filesystem/fs_search.py
index 5f91a1f6..9a7a8e8b 100644
--- a/server/nodes/filesystem/fs_search.py
+++ b/server/nodes/filesystem/fs_search.py
@@ -50,7 +50,7 @@ class FsSearchNode(ActionNode):
import asyncio
from ._backend import get_backend
- backend = get_backend(params.model_dump(by_alias=True), ctx.raw)
+ backend = get_backend(params.model_dump(), ctx.raw)
if params.mode == "ls":
entries = await asyncio.to_thread(backend.ls_info, params.path)
diff --git a/server/nodes/filesystem/shell.py b/server/nodes/filesystem/shell.py
index 35ed5a54..35b1cfb4 100644
--- a/server/nodes/filesystem/shell.py
+++ b/server/nodes/filesystem/shell.py
@@ -53,7 +53,7 @@ class ShellNode(ActionNode):
from ._backend import get_backend
log = get_logger(__name__)
- backend = get_backend(params.model_dump(by_alias=True), ctx.raw)
+ backend = get_backend(params.model_dump(), ctx.raw)
log.info(
"[Shell] Executing (non-blocking): %s (timeout=%ds)",
params.command[:200], params.timeout,
diff --git a/server/nodes/google/calendar.py b/server/nodes/google/calendar.py
index e8e62948..b6564145 100644
--- a/server/nodes/google/calendar.py
+++ b/server/nodes/google/calendar.py
@@ -14,32 +14,47 @@ from ._credentials import GoogleCredential
from ._base import build_google_service, run_sync, track_google_usage
+_CREATE = {"displayOptions": {"show": {"operation": ["create"]}}}
+_LIST = {"displayOptions": {"show": {"operation": ["list"]}}}
+_UPDATE = {"displayOptions": {"show": {"operation": ["update"]}}}
+_UPDATE_OR_DELETE = {"displayOptions": {"show": {"operation": ["update", "delete"]}}}
+
+
class CalendarParams(BaseModel):
operation: Literal["create", "list", "update", "delete"] = "list"
- calendar_id: str = Field(default="primary", alias="calendarId")
- event_id: Optional[str] = Field(default=None, alias="eventId")
- title: Optional[str] = None
- description: Optional[str] = None
- start_time: Optional[str] = Field(default=None, alias="startTime")
- end_time: Optional[str] = Field(default=None, alias="endTime")
- location: Optional[str] = None
- attendees: Optional[str] = None
- timezone: str = "UTC"
- reminder_minutes: int = Field(default=30, alias="reminderMinutes")
- start_date: Optional[str] = Field(default=None, alias="startDate")
- end_date: Optional[str] = Field(default=None, alias="endDate")
- max_results: int = Field(default=10, alias="maxResults", ge=1, le=250)
- single_events: bool = Field(default=True, alias="singleEvents")
- order_by: str = Field(default="startTime", alias="orderBy")
- send_updates: str = Field(default="all", alias="sendUpdates")
-
- update_title: Optional[str] = Field(default=None, alias="updateTitle")
- update_start_time: Optional[str] = Field(default=None, alias="updateStartTime")
- update_end_time: Optional[str] = Field(default=None, alias="updateEndTime")
- update_description: Optional[str] = Field(default=None, alias="updateDescription")
- update_location: Optional[str] = Field(default=None, alias="updateLocation")
-
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ calendar_id: str = Field(default="primary")
+ event_id: Optional[str] = Field(default=None, json_schema_extra=_UPDATE_OR_DELETE)
+
+ # Create fields
+ title: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ description: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ start_time: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ end_time: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ location: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ attendees: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ timezone: str = Field(default="UTC", json_schema_extra=_CREATE)
+ reminder_minutes: int = Field(default=30, json_schema_extra=_CREATE)
+
+ # List fields
+ start_date: Optional[str] = Field(default=None, json_schema_extra=_LIST)
+ end_date: Optional[str] = Field(default=None, json_schema_extra=_LIST)
+ max_results: int = Field(default=10, ge=1, le=250, json_schema_extra=_LIST)
+ single_events: bool = Field(default=True, json_schema_extra=_LIST)
+ order_by: str = Field(default="startTime", json_schema_extra=_LIST)
+
+ # Update + delete
+ send_updates: Literal["all", "externalOnly", "none"] = Field(
+ default="all", json_schema_extra=_UPDATE_OR_DELETE,
+ )
+
+ # Update-only fields
+ update_title: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_start_time: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_end_time: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_description: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_location: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+
+ model_config = ConfigDict(extra="ignore")
class CalendarOutput(BaseModel):
@@ -96,7 +111,7 @@ class CalendarNode(ActionNode):
@Operation("dispatch", cost={"service": "calendar", "action": "op", "count": 1})
async def dispatch(self, ctx: NodeContext, params: CalendarParams) -> CalendarOutput:
- svc = await build_google_service("calendar", "v3", params.model_dump(by_alias=True), ctx.raw)
+ svc = await build_google_service("calendar", "v3", params.model_dump(), ctx.raw)
events_svc = svc.events()
op = params.operation
cal_id = params.calendar_id
diff --git a/server/nodes/google/contacts.py b/server/nodes/google/contacts.py
index a6ddbabe..c7e5711a 100644
--- a/server/nodes/google/contacts.py
+++ b/server/nodes/google/contacts.py
@@ -13,29 +13,47 @@ from ._credentials import GoogleCredential
from ._base import build_google_service, run_sync, track_google_usage
+_CREATE = {"displayOptions": {"show": {"operation": ["create"]}}}
+_LIST = {"displayOptions": {"show": {"operation": ["list"]}}}
+_SEARCH = {"displayOptions": {"show": {"operation": ["search"]}}}
+_LIST_OR_SEARCH = {"displayOptions": {"show": {"operation": ["list", "search"]}}}
+_GET_UPDATE_DELETE = {"displayOptions": {"show": {"operation": ["get", "update", "delete"]}}}
+_UPDATE = {"displayOptions": {"show": {"operation": ["update"]}}}
+
+
class ContactsParams(BaseModel):
operation: Literal["create", "list", "search", "get", "update", "delete"] = "list"
- resource_name: Optional[str] = Field(default=None, alias="resourceName")
- first_name: Optional[str] = Field(default=None, alias="firstName")
- last_name: Optional[str] = Field(default=None, alias="lastName")
- email: Optional[str] = None
- phone: Optional[str] = None
- company: Optional[str] = None
- job_title: Optional[str] = Field(default=None, alias="jobTitle")
- notes: Optional[str] = None
- query: Optional[str] = None
- page_size: int = Field(default=100, alias="pageSize")
- page_token: Optional[str] = Field(default=None, alias="pageToken")
- sort_order: str = Field(default="LAST_MODIFIED_DESCENDING", alias="sortOrder")
-
- update_first_name: Optional[str] = Field(default=None, alias="updateFirstName")
- update_last_name: Optional[str] = Field(default=None, alias="updateLastName")
- update_email: Optional[str] = Field(default=None, alias="updateEmail")
- update_phone: Optional[str] = Field(default=None, alias="updatePhone")
- update_company: Optional[str] = Field(default=None, alias="updateCompany")
- update_job_title: Optional[str] = Field(default=None, alias="updateJobTitle")
-
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ resource_name: Optional[str] = Field(default=None, json_schema_extra=_GET_UPDATE_DELETE)
+
+ # Create fields
+ first_name: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ last_name: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ email: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ phone: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ company: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ job_title: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+ notes: Optional[str] = Field(default=None, json_schema_extra=_CREATE)
+
+ # Search
+ query: Optional[str] = Field(default=None, json_schema_extra=_SEARCH)
+
+ # List + search pagination
+ page_size: int = Field(default=100, ge=1, le=1000, json_schema_extra=_LIST_OR_SEARCH)
+ page_token: Optional[str] = Field(default=None, json_schema_extra=_LIST)
+ sort_order: Literal[
+ "LAST_MODIFIED_ASCENDING", "LAST_MODIFIED_DESCENDING",
+ "FIRST_NAME_ASCENDING", "LAST_NAME_ASCENDING",
+ ] = Field(default="LAST_MODIFIED_DESCENDING", json_schema_extra=_LIST)
+
+ # Update-only
+ update_first_name: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_last_name: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_email: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_phone: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_company: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+ update_job_title: Optional[str] = Field(default=None, json_schema_extra=_UPDATE)
+
+ model_config = ConfigDict(extra="ignore")
class ContactsOutput(BaseModel):
@@ -104,7 +122,7 @@ class ContactsNode(ActionNode):
@Operation("dispatch", cost={"service": "contacts", "action": "op", "count": 1})
async def dispatch(self, ctx: NodeContext, params: ContactsParams) -> ContactsOutput:
- svc = await build_google_service("people", "v1", params.model_dump(by_alias=True), ctx.raw)
+ svc = await build_google_service("people", "v1", params.model_dump(), ctx.raw)
people_svc = svc.people()
op = params.operation
diff --git a/server/nodes/google/drive.py b/server/nodes/google/drive.py
index 7f4c6d24..f385f0bb 100644
--- a/server/nodes/google/drive.py
+++ b/server/nodes/google/drive.py
@@ -17,26 +17,48 @@ from ._credentials import GoogleCredential
from ._base import build_google_service, run_sync, track_google_usage
+_UPLOAD = {"displayOptions": {"show": {"operation": ["upload"]}}}
+_DOWNLOAD = {"displayOptions": {"show": {"operation": ["download"]}}}
+_LIST = {"displayOptions": {"show": {"operation": ["list"]}}}
+_SHARE = {"displayOptions": {"show": {"operation": ["share"]}}}
+_DOWNLOAD_OR_SHARE = {"displayOptions": {"show": {"operation": ["download", "share"]}}}
+
+
class DriveParams(BaseModel):
operation: Literal["upload", "download", "list", "share"] = "list"
- file_id: Optional[str] = Field(default=None, alias="fileId")
- filename: Optional[str] = None
- file_url: Optional[str] = Field(default=None, alias="fileUrl")
- file_content: Optional[str] = Field(default=None, alias="fileContent")
- folder_id: Optional[str] = Field(default=None, alias="folderId")
- mime_type: str = Field(default="application/octet-stream", alias="mimeType")
- description: Optional[str] = None
- output_format: Literal["base64", "url"] = Field(default="base64", alias="outputFormat")
- query: Optional[str] = None
- file_types: str = Field(default="all", alias="fileTypes")
- order_by: str = Field(default="modifiedTime desc", alias="orderBy")
- max_results: int = Field(default=20, alias="maxResults", ge=1, le=1000)
- email: Optional[str] = None
- role: str = "reader"
- send_notification: bool = Field(default=True, alias="sendNotification")
- message: Optional[str] = None
-
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+
+ file_id: Optional[str] = Field(default=None, json_schema_extra=_DOWNLOAD_OR_SHARE)
+
+ # Upload
+ filename: Optional[str] = Field(default=None, json_schema_extra=_UPLOAD)
+ file_url: Optional[str] = Field(default=None, json_schema_extra=_UPLOAD)
+ file_content: Optional[str] = Field(default=None, json_schema_extra=_UPLOAD)
+ mime_type: str = Field(default="application/octet-stream", json_schema_extra=_UPLOAD)
+ description: Optional[str] = Field(default=None, json_schema_extra=_UPLOAD)
+
+ # List + Upload share folder_id
+ folder_id: Optional[str] = Field(
+ default=None,
+ description="Target folder (upload) or scope folder (list).",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["upload", "list"]}}},
+ )
+
+ # Download
+ output_format: Literal["base64", "url"] = Field(default="base64", json_schema_extra=_DOWNLOAD)
+
+ # List
+ query: Optional[str] = Field(default=None, json_schema_extra=_LIST)
+ file_types: str = Field(default="all", json_schema_extra=_LIST)
+ order_by: str = Field(default="modifiedTime desc", json_schema_extra=_LIST)
+ max_results: int = Field(default=20, ge=1, le=1000, json_schema_extra=_LIST)
+
+ # Share
+ email: Optional[str] = Field(default=None, json_schema_extra=_SHARE)
+ role: Literal["reader", "commenter", "writer"] = Field(default="reader", json_schema_extra=_SHARE)
+ send_notification: bool = Field(default=True, json_schema_extra=_SHARE)
+ message: Optional[str] = Field(default=None, json_schema_extra=_SHARE)
+
+ model_config = ConfigDict(extra="ignore")
class DriveOutput(BaseModel):
@@ -93,7 +115,7 @@ class DriveNode(ActionNode):
@Operation("dispatch", cost={"service": "drive", "action": "op", "count": 1})
async def dispatch(self, ctx: NodeContext, params: DriveParams) -> DriveOutput:
- svc = await build_google_service("drive", "v3", params.model_dump(by_alias=True), ctx.raw)
+ svc = await build_google_service("drive", "v3", params.model_dump(), ctx.raw)
files_svc = svc.files()
op = params.operation
diff --git a/server/nodes/google/gmail.py b/server/nodes/google/gmail.py
index acd21bf2..e9539637 100644
--- a/server/nodes/google/gmail.py
+++ b/server/nodes/google/gmail.py
@@ -38,7 +38,10 @@ class GmailParams(BaseModel):
"displayOptions": {"show": {"operation": ["send"]}},
},
)
- body_type: Literal["text", "html"] = Field(default="text", alias="bodyType")
+ body_type: Literal["text", "html"] = Field(
+ default="text",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["send"]}}},
+ )
query: str = Field(
default="",
@@ -47,17 +50,25 @@ class GmailParams(BaseModel):
"displayOptions": {"show": {"operation": ["search"]}},
},
)
- max_results: int = Field(default=10, alias="maxResults", ge=1, le=100)
- include_body: bool = Field(default=False, alias="includeBody")
+ max_results: int = Field(
+ default=10, ge=1, le=100,
+ json_schema_extra={"displayOptions": {"show": {"operation": ["search"]}}},
+ )
+ include_body: bool = Field(
+ default=False,
+ json_schema_extra={"displayOptions": {"show": {"operation": ["search"]}}},
+ )
message_id: str = Field(
default="",
- alias="messageId",
json_schema_extra={"displayOptions": {"show": {"operation": ["read"]}}},
)
- format: Literal["full", "minimal", "raw", "metadata"] = "full"
+ format: Literal["full", "minimal", "raw", "metadata"] = Field(
+ default="full",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["read"]}}},
+ )
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class GmailOutput(BaseModel):
@@ -71,14 +82,14 @@ class GmailOutput(BaseModel):
count: Optional[int] = None
query: Optional[str] = None
result_size_estimate: Optional[int] = None
- from_: Optional[str] = Field(default=None, alias="from")
+ from_: Optional[str] = Field(default=None)
date: Optional[str] = None
body: Optional[str] = None
snippet: Optional[str] = None
labels: Optional[List[str]] = None
attachments: Optional[List[dict]] = None
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class GmailNode(ActionNode):
@@ -106,7 +117,7 @@ class GmailNode(ActionNode):
async def _service(self, ctx: NodeContext, params: GmailParams):
return await build_google_service(
- "gmail", "v1", params.model_dump(by_alias=True), ctx.raw,
+ "gmail", "v1", params.model_dump(), ctx.raw,
)
@Operation("send", cost={"service": "gmail", "action": "send", "count": 1})
diff --git a/server/nodes/google/gmail_receive.py b/server/nodes/google/gmail_receive.py
index 62dda283..2eeac82b 100644
--- a/server/nodes/google/gmail_receive.py
+++ b/server/nodes/google/gmail_receive.py
@@ -38,7 +38,7 @@ class GmailReceiveParams(BaseModel):
class GmailReceiveOutput(BaseModel):
message_id: Optional[str] = None
thread_id: Optional[str] = None
- from_: Optional[str] = Field(default=None, alias="from")
+ from_: Optional[str] = Field(default=None)
to: Optional[str] = None
subject: Optional[str] = None
body: Optional[str] = None
@@ -48,7 +48,7 @@ class GmailReceiveOutput(BaseModel):
attachments: Optional[list] = None
is_unread: Optional[bool] = None
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class GmailReceiveNode(TriggerNode):
diff --git a/server/nodes/google/sheets.py b/server/nodes/google/sheets.py
index 250f320d..ed01bd42 100644
--- a/server/nodes/google/sheets.py
+++ b/server/nodes/google/sheets.py
@@ -19,15 +19,37 @@ from ._base import build_google_service, run_sync, track_google_usage
class SheetsParams(BaseModel):
operation: Literal["read", "write", "append"] = "read"
- spreadsheet_id: str = Field(default="", alias="spreadsheetId")
- range: str = Field(default="A1:Z1000")
- values: Any = Field(default_factory=list)
- value_input_option: str = Field(default="USER_ENTERED", alias="valueInputOption")
- value_render_option: str = Field(default="FORMATTED_VALUE", alias="valueRenderOption")
- major_dimension: str = Field(default="ROWS", alias="majorDimension")
- insert_data_option: str = Field(default="INSERT_ROWS", alias="insertDataOption")
+ spreadsheet_id: str = Field(default="", description="Spreadsheet ID from the Sheets URL.")
+ range: str = Field(default="A1:Z1000", description="A1 notation range (e.g. Sheet1!A1:C10).")
+
+ values: Any = Field(
+ default_factory=list,
+ description="2D array of cells to write.",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"operation": ["write", "append"]}},
+ },
+ )
+ value_input_option: Literal["RAW", "USER_ENTERED"] = Field(
+ default="USER_ENTERED",
+ description="RAW writes literal strings; USER_ENTERED evaluates formulas.",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["write", "append"]}}},
+ )
+ insert_data_option: Literal["INSERT_ROWS", "OVERWRITE"] = Field(
+ default="INSERT_ROWS",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["append"]}}},
+ )
+
+ value_render_option: Literal["FORMATTED_VALUE", "UNFORMATTED_VALUE", "FORMULA"] = Field(
+ default="FORMATTED_VALUE",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["read"]}}},
+ )
+ major_dimension: Literal["ROWS", "COLUMNS"] = Field(
+ default="ROWS",
+ json_schema_extra={"displayOptions": {"show": {"operation": ["read"]}}},
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class SheetsOutput(BaseModel):
@@ -84,7 +106,7 @@ class SheetsNode(ActionNode):
if not params.range:
raise RuntimeError("Range is required (e.g., 'Sheet1!A1:D10')")
- svc = await build_google_service("sheets", "v4", params.model_dump(by_alias=True), ctx.raw)
+ svc = await build_google_service("sheets", "v4", params.model_dump(), ctx.raw)
values_svc = svc.spreadsheets().values()
op = params.operation
diff --git a/server/nodes/google/tasks.py b/server/nodes/google/tasks.py
index 2dc7e274..18081b88 100644
--- a/server/nodes/google/tasks.py
+++ b/server/nodes/google/tasks.py
@@ -19,22 +19,22 @@ def _ensure_rfc3339(due: str) -> str:
class TasksParams(BaseModel):
operation: Literal["create", "list", "complete", "update", "delete"] = "list"
- tasklist_id: str = Field(default="@default", alias="tasklistId")
- task_id: Optional[str] = Field(default=None, alias="taskId")
+ 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, alias="dueDate")
+ due_date: Optional[str] = Field(default=None)
status: Optional[str] = None
- show_completed: bool = Field(default=False, alias="showCompleted")
- show_hidden: bool = Field(default=False, alias="showHidden")
- max_results: int = Field(default=100, alias="maxResults")
+ show_completed: bool = Field(default=False)
+ show_hidden: bool = Field(default=False)
+ max_results: int = Field(default=100)
- update_title: Optional[str] = Field(default=None, alias="updateTitle")
- update_notes: Optional[str] = Field(default=None, alias="updateNotes")
- update_due_date: Optional[str] = Field(default=None, alias="updateDueDate")
- update_status: Optional[str] = Field(default=None, alias="updateStatus")
+ 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(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class TasksOutput(BaseModel):
@@ -78,7 +78,7 @@ class TasksNode(ActionNode):
@Operation("dispatch", cost={"service": "tasks", "action": "op", "count": 1})
async def dispatch(self, ctx: NodeContext, params: TasksParams) -> TasksOutput:
- svc = await build_google_service("tasks", "v1", params.model_dump(by_alias=True), ctx.raw)
+ svc = await build_google_service("tasks", "v1", params.model_dump(), ctx.raw)
tasks_svc = svc.tasks()
op = params.operation
tasklist = params.tasklist_id
diff --git a/server/nodes/location/gmaps_create.py b/server/nodes/location/gmaps_create.py
index 2708851c..21d6f8a8 100644
--- a/server/nodes/location/gmaps_create.py
+++ b/server/nodes/location/gmaps_create.py
@@ -2,7 +2,7 @@
from __future__ import annotations
-from typing import Any, Literal, Optional
+from typing import Any, Dict, Literal, Optional
from pydantic import BaseModel, ConfigDict, Field
@@ -12,14 +12,23 @@ from ._credentials import GoogleMapsCredential
class GmapsCreateParams(BaseModel):
- 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)
+ center_lat: float = Field(default=0.0, description="Map center latitude.")
+ center_lng: float = Field(default=0.0, description="Map center longitude.")
+ zoom: int = Field(default=10, ge=1, le=20, description="Zoom level (1=world, 20=street).")
map_type: Literal["roadmap", "satellite", "hybrid", "terrain"] = Field(
- default="roadmap", alias="mapType",
+ default="roadmap",
+ )
+ options: Dict[str, Any] = Field(
+ default_factory=dict,
+ description=(
+ "Map customization options. Supported keys: disable_default_ui (bool), "
+ "zoom_control (bool), street_view_control (bool), map_type_control (bool), "
+ "fullscreen_control (bool)."
+ ),
+ json_schema_extra={"rows": 4},
)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class GmapsCreateOutput(BaseModel):
@@ -58,7 +67,7 @@ class GmapsCreateNode(ActionNode):
maps_service = container.maps_service()
response = await maps_service.create_map(
- ctx.node_id, params.model_dump(by_alias=True), ctx.raw,
+ ctx.node_id, params.model_dump(), ctx.raw,
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/location/gmaps_locations.py b/server/nodes/location/gmaps_locations.py
index 0f30caee..3a2c2293 100644
--- a/server/nodes/location/gmaps_locations.py
+++ b/server/nodes/location/gmaps_locations.py
@@ -2,7 +2,7 @@
from __future__ import annotations
-from typing import Any, Optional
+from typing import Any, Literal, Optional
from pydantic import BaseModel, ConfigDict, Field
@@ -12,8 +12,30 @@ from ._credentials import GoogleMapsCredential
class GmapsLocationsParams(BaseModel):
- address: str = Field(..., min_length=1)
- region: str = Field(default="")
+ service_type: Literal["geocode", "reverse_geocode"] = Field(
+ default="geocode",
+ description="geocode: address -> lat/lng. reverse_geocode: lat/lng -> address.",
+ )
+ address: str = Field(
+ default="",
+ description="Street address or place name.",
+ json_schema_extra={"displayOptions": {"show": {"service_type": ["geocode"]}}},
+ )
+ region: str = Field(
+ default="",
+ description="ISO country code bias (e.g. US, GB).",
+ json_schema_extra={"displayOptions": {"show": {"service_type": ["geocode"]}}},
+ )
+ lat: float = Field(
+ default=0.0,
+ description="Latitude (-90 to 90).",
+ json_schema_extra={"displayOptions": {"show": {"service_type": ["reverse_geocode"]}}},
+ )
+ lng: float = Field(
+ default=0.0,
+ description="Longitude (-180 to 180).",
+ json_schema_extra={"displayOptions": {"show": {"service_type": ["reverse_geocode"]}}},
+ )
model_config = ConfigDict(extra="ignore")
@@ -56,7 +78,7 @@ class GmapsLocationsNode(ActionNode):
maps_service = container.maps_service()
response = await maps_service.geocode_location(
- ctx.node_id, params.model_dump(by_alias=True), ctx.raw,
+ ctx.node_id, params.model_dump(), ctx.raw,
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/location/gmaps_nearby_places.py b/server/nodes/location/gmaps_nearby_places.py
index 8e612772..c26bc9b1 100644
--- a/server/nodes/location/gmaps_nearby_places.py
+++ b/server/nodes/location/gmaps_nearby_places.py
@@ -15,10 +15,10 @@ class GmapsNearbyPlacesParams(BaseModel):
latitude: float = Field(..., ge=-90.0, le=90.0)
longitude: float = Field(..., ge=-180.0, le=180.0)
radius: int = Field(default=1000, ge=1, le=50000)
- place_type: str = Field(default="", alias="placeType")
+ place_type: str = Field(default="")
keyword: str = Field(default="")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class GmapsNearbyPlacesOutput(BaseModel):
@@ -57,7 +57,7 @@ class GmapsNearbyPlacesNode(ActionNode):
maps_service = container.maps_service()
response = await maps_service.find_nearby_places(
- ctx.node_id, params.model_dump(by_alias=True), ctx.raw,
+ ctx.node_id, params.model_dump(), ctx.raw,
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/model/_base.py b/server/nodes/model/_base.py
index 42074811..5195e283 100644
--- a/server/nodes/model/_base.py
+++ b/server/nodes/model/_base.py
@@ -24,7 +24,12 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class ChatModelParams(BaseModel):
"""Shared params surface — providers override fields where their
capabilities differ (e.g. fixed temperature for o-series, no
- thinking for openrouter passthrough)."""
+ thinking for openrouter passthrough).
+
+ Snake_case field names throughout; JSON Schema keys match field
+ names exactly. ``displayOptions.show`` references resolve because
+ no alias/field-name divergence can occur.
+ """
prompt: str = Field(
default="",
@@ -38,31 +43,25 @@ class ChatModelParams(BaseModel):
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)
+ max_tokens: Optional[int] = Field(default=1000, ge=1, le=200000)
system_prompt: Optional[str] = Field(
- default="", alias="systemMessage",
+ default="",
json_schema_extra={"rows": 3, "placeholder": "You are a helpful assistant."},
)
api_key: Optional[str] = Field(
- default=None, alias="apiKey",
+ default=None,
json_schema_extra={"password": True},
)
top_p: Optional[float] = Field(
- default=1.0, alias="topP", ge=0.0, le=1.0,
+ default=1.0, ge=0.0, le=1.0,
json_schema_extra={"numberStepSize": 0.1},
)
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
- thinking_budget: Optional[int] = Field(
- default=None, alias="thinkingBudget", ge=1,
- )
- reasoning_effort: Optional[Literal["low", "medium", "high"]] = Field(
- default=None, alias="reasoningEffort",
- )
- reasoning_format: Optional[Literal["parsed", "hidden"]] = Field(
- default=None, alias="reasoningFormat",
- )
+ thinking_enabled: bool = Field(default=False)
+ thinking_budget: Optional[int] = Field(default=None, ge=1)
+ reasoning_effort: Optional[Literal["low", "medium", "high"]] = Field(default=None)
+ reasoning_format: Optional[Literal["parsed", "hidden"]] = Field(default=None)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ChatModelOutput(BaseModel):
@@ -97,7 +96,7 @@ class ChatModelBase(ActionNode, abstract=True):
ai_service = container.ai_service()
response = await ai_service.execute_chat(
- ctx.node_id, self.type, params.model_dump(by_alias=True),
+ ctx.node_id, self.type, params.model_dump(),
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/model/anthropic_chat_model.py b/server/nodes/model/anthropic_chat_model.py
index 10b63131..af54ab0e 100644
--- a/server/nodes/model/anthropic_chat_model.py
+++ b/server/nodes/model/anthropic_chat_model.py
@@ -8,10 +8,10 @@ from ._credentials import AnthropicCredential
class AnthropicChatModelParams(ChatModelParams):
- top_k: Optional[int] = Field(default=40, alias="topK", ge=1, le=100)
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
+ top_k: Optional[int] = Field(default=40, ge=1, le=100)
+ thinking_enabled: bool = Field(default=False)
thinking_budget: Optional[int] = Field(
- default=2048, alias="thinkingBudget", ge=1024, le=16000,
+ default=2048, ge=1024, le=16000,
json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
)
diff --git a/server/nodes/model/cerebras_chat_model.py b/server/nodes/model/cerebras_chat_model.py
index 4164ccc6..b37a9ef8 100644
--- a/server/nodes/model/cerebras_chat_model.py
+++ b/server/nodes/model/cerebras_chat_model.py
@@ -8,9 +8,9 @@ from ._credentials import CerebrasCredential
class CerebrasChatModelParams(ChatModelParams):
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
+ thinking_enabled: bool = Field(default=False)
thinking_budget: Optional[int] = Field(
- default=2048, alias="thinkingBudget", ge=1024, le=16000,
+ default=2048, ge=1024, le=16000,
json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
)
diff --git a/server/nodes/model/deepseek_chat_model.py b/server/nodes/model/deepseek_chat_model.py
index 1b09219f..4ba01388 100644
--- a/server/nodes/model/deepseek_chat_model.py
+++ b/server/nodes/model/deepseek_chat_model.py
@@ -9,10 +9,10 @@ from ._credentials import DeepSeekCredential
class DeepseekChatModelParams(ChatModelParams):
frequency_penalty: Optional[float] = Field(
- default=0.0, alias="frequencyPenalty", ge=-2.0, le=2.0,
+ default=0.0, ge=-2.0, le=2.0,
)
presence_penalty: Optional[float] = Field(
- default=0.0, alias="presencePenalty", ge=-2.0, le=2.0,
+ default=0.0, ge=-2.0, le=2.0,
)
diff --git a/server/nodes/model/gemini_chat_model.py b/server/nodes/model/gemini_chat_model.py
index 50f75c7b..2ea2ba09 100644
--- a/server/nodes/model/gemini_chat_model.py
+++ b/server/nodes/model/gemini_chat_model.py
@@ -8,13 +8,11 @@ from ._credentials import GeminiCredential
class GeminiChatModelParams(ChatModelParams):
- top_k: Optional[int] = Field(default=40, alias="topK", ge=1, le=100)
- safety_settings: Literal["default", "strict", "permissive"] = Field(
- default="default", alias="safetySettings",
- )
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
+ top_k: Optional[int] = Field(default=40, ge=1, le=100)
+ safety_settings: Literal["default", "strict", "permissive"] = Field(default="default")
+ thinking_enabled: bool = Field(default=False)
thinking_budget: Optional[int] = Field(
- default=2048, alias="thinkingBudget", ge=1024, le=16000,
+ default=2048, ge=1024, le=16000,
json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
)
diff --git a/server/nodes/model/groq_chat_model.py b/server/nodes/model/groq_chat_model.py
index 78ecb130..9f144e30 100644
--- a/server/nodes/model/groq_chat_model.py
+++ b/server/nodes/model/groq_chat_model.py
@@ -8,9 +8,9 @@ from ._credentials import GroqCredential
class GroqChatModelParams(ChatModelParams):
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
+ thinking_enabled: bool = Field(default=False)
reasoning_format: Optional[Literal["parsed", "hidden"]] = Field(
- default="parsed", alias="reasoningFormat",
+ default="parsed",
json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
)
diff --git a/server/nodes/model/openai_chat_model.py b/server/nodes/model/openai_chat_model.py
index 71f6018c..7323c730 100644
--- a/server/nodes/model/openai_chat_model.py
+++ b/server/nodes/model/openai_chat_model.py
@@ -9,19 +9,17 @@ from ._credentials import OpenAICredential
class OpenAIChatModelParams(ChatModelParams):
frequency_penalty: Optional[float] = Field(
- default=0.0, alias="frequencyPenalty", ge=-2.0, le=2.0,
+ default=0.0, ge=-2.0, le=2.0,
json_schema_extra={"numberStepSize": 0.1},
)
presence_penalty: Optional[float] = Field(
- default=0.0, alias="presencePenalty", ge=-2.0, le=2.0,
+ default=0.0, ge=-2.0, le=2.0,
json_schema_extra={"numberStepSize": 0.1},
)
- response_format: Optional[Literal["text", "json_object"]] = Field(
- default="text", alias="responseFormat",
- )
- thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
+ response_format: Optional[Literal["text", "json_object"]] = Field(default="text")
+ thinking_enabled: bool = Field(default=False)
reasoning_effort: Optional[Literal["minimal", "low", "medium", "high"]] = Field(
- default="medium", alias="reasoningEffort",
+ default="medium",
json_schema_extra={"displayOptions": {"show": {"thinking_enabled": [True]}}},
)
diff --git a/server/nodes/model/openrouter_chat_model.py b/server/nodes/model/openrouter_chat_model.py
index 17bda812..bf138739 100644
--- a/server/nodes/model/openrouter_chat_model.py
+++ b/server/nodes/model/openrouter_chat_model.py
@@ -9,10 +9,10 @@ from ._credentials import OpenRouterCredential
class OpenRouterChatModelParams(ChatModelParams):
frequency_penalty: Optional[float] = Field(
- default=0.0, alias="frequencyPenalty", ge=-2.0, le=2.0,
+ default=0.0, ge=-2.0, le=2.0,
)
presence_penalty: Optional[float] = Field(
- default=0.0, alias="presencePenalty", ge=-2.0, le=2.0,
+ default=0.0, ge=-2.0, le=2.0,
)
diff --git a/server/nodes/proxy/proxy_config.py b/server/nodes/proxy/proxy_config.py
index 9e928d5b..3c9e36c5 100644
--- a/server/nodes/proxy/proxy_config.py
+++ b/server/nodes/proxy/proxy_config.py
@@ -20,29 +20,114 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
logger = get_logger(__name__)
+_PROVIDER_OPS = ["add_provider", "update_provider", "remove_provider", "set_credentials", "test_provider"]
+_PROVIDER_EDIT_OPS = ["add_provider", "update_provider"]
+_CREDENTIAL_OPS = ["set_credentials"]
+_ROUTING_EDIT_OPS = ["add_routing_rule"]
+_ROUTING_REMOVE_OPS = ["remove_routing_rule"]
+
+
class ProxyConfigParams(BaseModel):
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"
- name: str = Field(default="")
- provider_name: str = Field(default="", alias="providerName")
- gateway_host: str = Field(default="", alias="gateway_host")
- gateway_port: int = Field(default=0, alias="gateway_port")
- url_template: Any = Field(default="{}", alias="url_template")
- cost_per_gb: float = Field(default=0.0, alias="cost_per_gb")
- enabled: Optional[bool] = None
- priority: int = Field(default=50)
- username: str = Field(default="")
- password: str = Field(default="")
- domain_pattern: str = Field(default="", alias="domain_pattern")
- preferred_providers: Any = Field(default="[]", alias="preferred_providers")
- required_country: str = Field(default="", alias="required_country")
- session_type: str = Field(default="rotating", alias="session_type")
- rule_id: Optional[int] = None
+ ] = Field(
+ default="list_providers",
+ description="Proxy management operation. list_providers / get_stats / list_routing_rules need no extra params.",
+ )
+
+ # Provider identity (all provider-scoped ops)
+ name: str = Field(
+ default="",
+ description="Provider name (unique ID).",
+ json_schema_extra={"displayOptions": {"show": {"operation": _PROVIDER_OPS}}},
+ )
+
+ # Provider definition (add/update only)
+ gateway_host: str = Field(
+ default="",
+ description="Proxy gateway hostname.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _PROVIDER_EDIT_OPS}}},
+ )
+ gateway_port: int = Field(
+ default=0,
+ description="Proxy gateway port.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _PROVIDER_EDIT_OPS}}},
+ )
+ url_template: Any = Field(
+ default="{}",
+ description="JSON template for proxy URL formatting (e.g. {\"username\": \"{user}-country-{country}\"}).",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"operation": _PROVIDER_EDIT_OPS}},
+ },
+ )
+ cost_per_gb: float = Field(
+ default=0.0,
+ description="Cost in USD per GB of traffic (for ranking).",
+ json_schema_extra={"displayOptions": {"show": {"operation": _PROVIDER_EDIT_OPS}}},
+ )
+ enabled: Optional[bool] = Field(
+ default=None,
+ description="Whether the provider is active.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _PROVIDER_EDIT_OPS}}},
+ )
+ priority: int = Field(
+ default=50,
+ ge=0, le=100,
+ description="Selection priority (higher ranks first).",
+ json_schema_extra={"displayOptions": {"show": {"operation": _PROVIDER_EDIT_OPS}}},
+ )
+
+ # Credentials (set_credentials only)
+ username: str = Field(
+ default="",
+ description="Proxy account username.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _CREDENTIAL_OPS}}},
+ )
+ password: str = Field(
+ default="",
+ description="Proxy account password.",
+ json_schema_extra={
+ "widget": "password",
+ "displayOptions": {"show": {"operation": _CREDENTIAL_OPS}},
+ },
+ )
+
+ # Routing rule definition (add_routing_rule)
+ domain_pattern: str = Field(
+ default="",
+ description="Domain glob pattern (e.g. *.example.com).",
+ json_schema_extra={"displayOptions": {"show": {"operation": _ROUTING_EDIT_OPS}}},
+ )
+ preferred_providers: Any = Field(
+ default="[]",
+ description="JSON array of preferred provider names.",
+ json_schema_extra={
+ "rows": 2,
+ "displayOptions": {"show": {"operation": _ROUTING_EDIT_OPS}},
+ },
+ )
+ required_country: str = Field(
+ default="",
+ description="ISO country code required for this route.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _ROUTING_EDIT_OPS}}},
+ )
+ session_type: Literal["rotating", "sticky"] = Field(
+ default="rotating",
+ description="Rotating rotates IPs each request; sticky holds one IP per session.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _ROUTING_EDIT_OPS}}},
+ )
+
+ # Routing rule removal (remove_routing_rule)
+ rule_id: Optional[int] = Field(
+ default=None,
+ description="Routing rule ID to remove.",
+ json_schema_extra={"displayOptions": {"show": {"operation": _ROUTING_REMOVE_OPS}}},
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class ProxyConfigOutput(BaseModel):
@@ -79,7 +164,7 @@ async def _list_routing_rules(proxy_svc) -> Dict[str, Any]:
async def _add_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
from core.container import container
- name = p.get("name") or p.get("providerName")
+ name = p.get("name", "")
if not name:
return {"success": False, "error": "Provider name is required"}
@@ -109,7 +194,7 @@ async def _add_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
async def _update_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
from core.container import container
- name = p.get("name") or p.get("providerName")
+ name = p.get("name", "")
if not name:
return {"success": False, "error": "Provider name is required"}
db = container.database()
@@ -142,7 +227,7 @@ async def _update_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
async def _remove_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
from core.container import container
- name = p.get("name") or p.get("providerName")
+ name = p.get("name", "")
if not name:
return {"success": False, "error": "Provider name is required"}
db = container.database()
@@ -155,7 +240,7 @@ async def _remove_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
async def _set_credentials(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
from core.container import container
- name = p.get("name") or p.get("providerName")
+ name = p.get("name", "")
if not name:
return {"success": False, "error": "Provider name is required"}
username, password = p.get("username", ""), p.get("password", "")
@@ -171,7 +256,7 @@ async def _set_credentials(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
async def _test_provider(p: Dict[str, Any], proxy_svc) -> Dict[str, Any]:
- name = p.get("name") or p.get("providerName")
+ name = p.get("name", "")
if not name:
return {"success": False, "error": "Provider name is required"}
if not proxy_svc:
@@ -299,7 +384,7 @@ class ProxyConfigNode(ActionNode):
@Operation("dispatch")
async def dispatch(self, ctx: NodeContext, params: ProxyConfigParams) -> Any:
- result = await execute_proxy_config(params.model_dump(by_alias=True))
+ result = await execute_proxy_config(params.model_dump())
if not result.get("success"):
raise RuntimeError(result.get("error") or "Proxy config failed")
return result
diff --git a/server/nodes/proxy/proxy_request.py b/server/nodes/proxy/proxy_request.py
index 5fcd0a39..cdc87640 100644
--- a/server/nodes/proxy/proxy_request.py
+++ b/server/nodes/proxy/proxy_request.py
@@ -15,14 +15,14 @@ class ProxyRequestParams(BaseModel):
headers: Dict[str, str] = Field(default_factory=dict)
body: Optional[Any] = None
timeout: int = Field(default=30, ge=1, le=600)
- 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")
- sticky_duration: int = Field(default=600, alias="stickyDuration", ge=1)
- max_retries: int = Field(default=3, alias="maxRetries", ge=0, le=10)
- follow_redirects: bool = Field(default=True, alias="followRedirects")
+ proxy_provider: str = Field(default="auto")
+ proxy_country: str = Field(default="")
+ session_type: Literal["rotating", "sticky"] = Field(default="rotating")
+ sticky_duration: int = Field(default=600, ge=1)
+ max_retries: int = Field(default=3, ge=0, le=10)
+ follow_redirects: bool = Field(default=True)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class ProxyRequestOutput(BaseModel):
@@ -39,7 +39,7 @@ class ProxyRequestNode(ActionNode):
subtitle = "Routed HTTP"
icon = "🛡"
color = "#ffb86c"
- group = ("proxy",)
+ group = ("proxy", "tool")
description = "Make HTTP requests through residential proxy providers"
component_kind = "square"
handles = (
@@ -48,6 +48,7 @@ class ProxyRequestNode(ActionNode):
)
annotations = {"destructive": False, "readonly": False, "open_world": True}
task_queue = TaskQueue.REST_API
+ usable_as_tool = True
Params = ProxyRequestParams
Output = ProxyRequestOutput
@@ -78,13 +79,13 @@ class ProxyRequestNode(ActionNode):
"provider first.",
)
- raw = params.model_dump(by_alias=True)
+ raw = params.model_dump()
proxy_url = await svc.get_proxy_url(params.url, raw)
if not proxy_url:
raise RuntimeError("No proxy provider available")
max_retries = params.max_retries
- failover = raw.get("proxyFailover", True)
+ failover = raw.get("proxy_failover", True)
provider_name = params.proxy_provider or ""
last_error: str = ""
diff --git a/server/nodes/proxy/proxy_status.py b/server/nodes/proxy/proxy_status.py
index 3ec46c4d..6094b37f 100644
--- a/server/nodes/proxy/proxy_status.py
+++ b/server/nodes/proxy/proxy_status.py
@@ -10,9 +10,9 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class ProxyStatusParams(BaseModel):
- provider_name: str = Field(default="", alias="providerName")
+ provider_name: str = Field(default="")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ProxyStatusOutput(BaseModel):
@@ -28,7 +28,7 @@ class ProxyStatusNode(ActionNode):
subtitle = "Health Stats"
icon = "📊"
color = "#ffb86c"
- group = ("proxy",)
+ group = ("proxy", "tool")
description = "View proxy provider health, scores, and usage statistics"
component_kind = "square"
handles = (
@@ -37,6 +37,7 @@ class ProxyStatusNode(ActionNode):
)
annotations = {"destructive": False, "readonly": True, "open_world": False}
task_queue = TaskQueue.DEFAULT
+ usable_as_tool = True
Params = ProxyStatusParams
Output = ProxyStatusOutput
diff --git a/server/nodes/scheduler/cron_scheduler.py b/server/nodes/scheduler/cron_scheduler.py
index 5149d462..1b1db6c6 100644
--- a/server/nodes/scheduler/cron_scheduler.py
+++ b/server/nodes/scheduler/cron_scheduler.py
@@ -10,7 +10,7 @@ from __future__ import annotations
import asyncio
import time
from datetime import datetime, timedelta
-from typing import Any, Dict, Optional
+from typing import Any, Dict, Literal, Optional
from pydantic import BaseModel, ConfigDict, Field
@@ -79,19 +79,74 @@ def _get_schedule_description(p: Dict[str, Any]) -> str:
class CronSchedulerParams(BaseModel):
- cron_expression: str = Field(default="0 * * * *", alias="cronExpression")
- timezone: str = Field(default="UTC")
- frequency: str = Field(default="minutes")
- interval: int = Field(default=30)
- interval_minutes: int = Field(default=5, alias="intervalMinutes")
- interval_hours: int = Field(default=1, alias="intervalHours")
- daily_time: str = Field(default="09:00", alias="dailyTime")
- weekly_time: str = Field(default="09:00", alias="weeklyTime")
- weekday: str = Field(default="1")
- monthly_time: str = Field(default="09:00", alias="monthlyTime")
- month_day: str = Field(default="1", alias="monthDay")
+ frequency: Literal[
+ "seconds", "minutes", "hours", "days", "weeks", "months", "once"
+ ] = Field(
+ default="minutes",
+ description="How often the schedule fires",
+ )
+ interval: int = Field(
+ default=30, ge=5, le=59,
+ description="Seconds between fires (5-59)",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["seconds"]}}},
+ )
+ interval_minutes: int = Field(
+ default=5, ge=1, le=59,
+ description="Minutes between fires (1-59)",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["minutes"]}}},
+ )
+ interval_hours: int = Field(
+ default=1, ge=1, le=23,
+ description="Hours between fires (1-23)",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["hours"]}}},
+ )
+ daily_time: Literal[
+ "00:00", "02:00", "04:00", "06:00", "08:00", "09:00",
+ "10:00", "12:00", "14:00", "16:00", "18:00", "20:00", "22:00",
+ ] = Field(
+ default="09:00",
+ description="Time of day (HH:MM) for daily schedule",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["days"]}}},
+ )
+ weekday: Literal["0", "1", "2", "3", "4", "5", "6"] = Field(
+ default="1",
+ description="Day of week for weekly schedule (0=Sunday … 6=Saturday)",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["weeks"]}}},
+ )
+ weekly_time: Literal[
+ "00:00", "02:00", "04:00", "06:00", "08:00", "09:00",
+ "10:00", "12:00", "14:00", "16:00", "18:00", "20:00", "22:00",
+ ] = Field(
+ default="09:00",
+ description="Time of day for weekly schedule",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["weeks"]}}},
+ )
+ month_day: Literal[
+ "1", "2", "3", "4", "5", "6", "7", "8", "9", "10",
+ "11", "12", "13", "14", "15", "16", "17", "18", "19", "20",
+ "21", "22", "23", "24", "25", "26", "27", "28", "L",
+ ] = Field(
+ default="1",
+ description="Day of month (1-28, or 'L' for last day)",
+ json_schema_extra={"displayOptions": {"show": {"frequency": ["months"]}}},
+ )
+ timezone: Literal[
+ "UTC",
+ "America/New_York",
+ "America/Los_Angeles",
+ "Europe/London",
+ "Europe/Berlin",
+ "Asia/Tokyo",
+ "Asia/Kolkata",
+ ] = Field(
+ default="UTC",
+ description="IANA timezone identifier",
+ )
+ # Vestigial fields kept for backward compatibility with older workflows.
+ cron_expression: str = Field(default="0 * * * *")
+ monthly_time: str = Field(default="09:00")
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class CronSchedulerOutput(BaseModel):
@@ -115,7 +170,7 @@ class CronSchedulerNode(ActionNode):
subtitle = "Time-Based Trigger"
icon = "⏱"
color = "#ffb86c"
- group = ("scheduler", "trigger")
+ group = ("scheduler", "trigger", "tool")
description = "Cron expression-based scheduling trigger"
component_kind = "trigger"
handles = (
@@ -124,6 +179,7 @@ class CronSchedulerNode(ActionNode):
)
annotations = {"destructive": False, "readonly": True, "open_world": False}
task_queue = TaskQueue.TRIGGERS_POLL
+ usable_as_tool = True
Params = CronSchedulerParams
Output = CronSchedulerOutput
diff --git a/server/nodes/scraper/apify_actor.py b/server/nodes/scraper/apify_actor.py
index ce4c6d3f..430be9f3 100644
--- a/server/nodes/scraper/apify_actor.py
+++ b/server/nodes/scraper/apify_actor.py
@@ -8,7 +8,7 @@ raw ``actorInput`` JSON for common actors.
from __future__ import annotations
import json
-from typing import Any, Dict, List, Optional
+from typing import Any, Dict, List, Literal, Optional
from pydantic import BaseModel, ConfigDict, Field
@@ -32,12 +32,16 @@ async def _get_apify_client():
def _build_actor_input(parameters: Dict[str, Any]) -> Dict[str, Any]:
- """Merge actor quick-input helpers into the raw ``actorInput`` JSON."""
- actor_id = parameters.get('actorId', '')
+ """Merge actor quick-input helpers into the raw ``actor_input`` JSON.
+
+ Apify actors expect camelCase keys in their run input (that's the
+ SDK contract). The plugin Params are snake_case; we translate here.
+ """
+ actor_id = parameters.get('actor_id', '')
if actor_id == 'custom':
- actor_id = parameters.get('customActorId', '')
+ actor_id = parameters.get('custom_actor_id', '')
- actor_input = parameters.get('actorInput', '{}')
+ actor_input = parameters.get('actor_input', {})
if isinstance(actor_input, str):
try:
actor_input = json.loads(actor_input) if actor_input.strip() else {}
@@ -47,33 +51,33 @@ def _build_actor_input(parameters: Dict[str, Any]) -> Dict[str, Any]:
actor_input = {}
if actor_id == 'apify/instagram-scraper':
- urls = parameters.get('instagramUrls', '')
+ urls = parameters.get('instagram_urls', '')
if urls:
actor_input['directUrls'] = [u.strip() for u in urls.split(',') if u.strip()]
elif actor_id == 'clockworks/tiktok-scraper':
- profiles = parameters.get('tiktokProfiles', '')
- hashtags = parameters.get('tiktokHashtags', '')
+ profiles = parameters.get('tiktok_profiles', '')
+ hashtags = parameters.get('tiktok_hashtags', '')
if profiles:
actor_input['profiles'] = [p.strip() for p in profiles.split(',') if p.strip()]
if hashtags:
actor_input['hashtags'] = [h.strip() for h in hashtags.split(',') if h.strip()]
elif actor_id == 'apidojo/tweet-scraper':
- search_terms = parameters.get('twitterSearchTerms', '')
- handles = parameters.get('twitterHandles', '')
+ search_terms = parameters.get('twitter_search_terms', '')
+ handles = parameters.get('twitter_handles', '')
if search_terms:
actor_input['searchTerms'] = [t.strip() for t in search_terms.split(',') if t.strip()]
if handles:
actor_input['twitterHandles'] = [h.strip() for h in handles.split(',') if h.strip()]
elif actor_id == 'apify/google-search-scraper':
- query = parameters.get('googleSearchQuery', '')
- pages = parameters.get('googleSearchPages', 1)
+ query = parameters.get('google_search_query', '')
+ pages = parameters.get('google_search_pages', 1)
if query:
actor_input['searchQuery'] = query
actor_input['maxPagesPerQuery'] = pages
elif actor_id == 'apify/website-content-crawler':
- start_urls = parameters.get('crawlerStartUrls', '')
- max_depth = parameters.get('crawlerMaxDepth', 2)
- max_pages = parameters.get('crawlerMaxPages', 50)
+ start_urls = parameters.get('crawler_start_urls', '')
+ max_depth = parameters.get('crawler_max_depth', 2)
+ max_pages = parameters.get('crawler_max_pages', 50)
if start_urls:
actor_input['startUrls'] = [{'url': u.strip()} for u in start_urls.split(',') if u.strip()]
actor_input['maxCrawlDepth'] = max_depth
@@ -110,14 +114,109 @@ async def validate_apify_token(api_token: str) -> Dict[str, Any]:
return {"valid": False, "error": msg}
+_ACTOR_PRESETS = [
+ "apify/instagram-scraper",
+ "clockworks/tiktok-scraper",
+ "apidojo/tweet-scraper",
+ "apify/linkedin-scraper",
+ "apify/facebook-pages-scraper",
+ "streamers/youtube-scraper",
+ "apify/google-search-scraper",
+ "compass/crawler-google-places",
+ "apify/website-content-crawler",
+ "curious_coder/web-scraper",
+ "custom",
+]
+
+
class ApifyActorParams(BaseModel):
- actor_id: str = Field(default="", alias="actorId")
- actor_input: Any = Field(default_factory=dict, alias="actorInput")
- max_results: int = Field(default=100, alias="maxResults", ge=1, le=10000)
+ actor_id: Literal[
+ "apify/instagram-scraper",
+ "clockworks/tiktok-scraper",
+ "apidojo/tweet-scraper",
+ "apify/linkedin-scraper",
+ "apify/facebook-pages-scraper",
+ "streamers/youtube-scraper",
+ "apify/google-search-scraper",
+ "compass/crawler-google-places",
+ "apify/website-content-crawler",
+ "curious_coder/web-scraper",
+ "custom",
+ ] = Field(
+ default="apify/instagram-scraper",
+ description="Actor preset. Pick 'custom' to enter a specific actor ID.",
+ )
+ custom_actor_id: str = Field(
+ default="",
+ description="Custom actor ID (e.g. username/actor-name).",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["custom"]}}},
+ )
+ actor_input: Any = Field(
+ default_factory=dict,
+ description="Raw JSON input passed to the actor (merged with quick-input fields below).",
+ json_schema_extra={"rows": 6},
+ )
+
+ # Quick-input helpers per actor
+ instagram_urls: str = Field(
+ default="",
+ description="Comma-separated Instagram URLs.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apify/instagram-scraper"]}}},
+ )
+ tiktok_profiles: str = Field(
+ default="",
+ description="Comma-separated TikTok profile handles.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["clockworks/tiktok-scraper"]}}},
+ )
+ tiktok_hashtags: str = Field(
+ default="",
+ description="Comma-separated TikTok hashtags.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["clockworks/tiktok-scraper"]}}},
+ )
+ twitter_search_terms: str = Field(
+ default="",
+ description="Comma-separated search terms.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apidojo/tweet-scraper"]}}},
+ )
+ twitter_handles: str = Field(
+ default="",
+ description="Comma-separated Twitter handles.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apidojo/tweet-scraper"]}}},
+ )
+ google_search_query: str = Field(
+ default="",
+ description="Google search query.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apify/google-search-scraper"]}}},
+ )
+ google_search_pages: int = Field(
+ default=1, ge=1, le=100,
+ description="Max pages per query.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apify/google-search-scraper"]}}},
+ )
+ crawler_start_urls: str = Field(
+ default="",
+ description="Comma-separated start URLs.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apify/website-content-crawler"]}}},
+ )
+ crawler_max_depth: int = Field(
+ default=2, ge=0, le=20,
+ description="Max crawl depth.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apify/website-content-crawler"]}}},
+ )
+ crawler_max_pages: int = Field(
+ default=50, ge=1, le=10000,
+ description="Max pages to crawl.",
+ json_schema_extra={"displayOptions": {"show": {"actor_id": ["apify/website-content-crawler"]}}},
+ )
+
+ max_results: int = Field(default=100, ge=1, le=10000)
timeout: int = Field(default=300, ge=1, le=3600)
- memory: int = Field(default=1024, ge=128, le=8192)
+ memory: Literal[128, 256, 512, 1024, 2048, 4096, 8192] = Field(
+ default=1024,
+ description="Actor memory in MB.",
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class ApifyActorOutput(BaseModel):
@@ -163,17 +262,16 @@ class ApifyActorNode(ActionNode):
"Apify API token not configured. Please add your token in Credentials.",
)
- p = params.model_dump(by_alias=True)
- actor_id = p.get("actorId", "")
+ actor_id = params.actor_id
if actor_id == "custom":
- actor_id = p.get("customActorId", "")
+ actor_id = params.custom_actor_id
if not actor_id:
raise RuntimeError("Actor ID is required")
- actor_input = _build_actor_input(p)
- timeout_secs = int(p.get("timeout", 300))
- max_results = int(p.get("maxResults", 100))
- memory_mbytes = int(p.get("memory", 1024))
+ actor_input = _build_actor_input(params.model_dump())
+ timeout_secs = params.timeout
+ max_results = params.max_results
+ memory_mbytes = int(params.memory)
logger.info(
f"[Apify] Running actor {actor_id} "
diff --git a/server/nodes/scraper/crawlee_scraper.py b/server/nodes/scraper/crawlee_scraper.py
index e0bc574c..3091d006 100644
--- a/server/nodes/scraper/crawlee_scraper.py
+++ b/server/nodes/scraper/crawlee_scraper.py
@@ -24,7 +24,7 @@ _MAX_CONTENT_LENGTH = 100_000
async def _get_proxy_config(parameters: Dict[str, Any], url: str):
"""Bridge MachinaOs ProxyService to Crawlee ProxyConfiguration."""
- if not parameters.get('useProxy', False):
+ if not parameters.get('use_proxy', False):
return None
try:
from services.proxy import get_proxy_service
@@ -83,8 +83,8 @@ async def _run_beautifulsoup(url, pages, p, proxy_config, css_selector, extract_
proxy_configuration=proxy_config,
configure_logging=False,
)
- link_selector = p.get('linkSelector', '') or 'a[href]'
- url_pattern = p.get('urlPattern', '')
+ link_selector = p.get('link_selector', '') or 'a[href]'
+ url_pattern = p.get('url_pattern', '')
@crawler.router.default_handler
async def handler(ctx: BeautifulSoupCrawlingContext) -> None:
@@ -115,10 +115,10 @@ async def _run_playwright(url, pages, p, proxy_config, css_selector, extract_lin
from crawlee.crawlers import PlaywrightCrawler, PlaywrightCrawlingContext
from crawlee.storage_clients import MemoryStorageClient
- browser_type = p.get('browserType', 'chromium')
- wait_for_selector = p.get('waitForSelector', '')
- wait_timeout = p.get('waitTimeout', 30000)
- take_screenshot = p.get('screenshot', False) or p.get('takeScreenshot', False)
+ browser_type = p.get('browser_type', 'chromium')
+ wait_for_selector = p.get('wait_for_selector', '')
+ wait_timeout = p.get('wait_timeout', 30000)
+ take_screenshot = p.get('screenshot', False) or p.get('take_screenshot', False)
crawler = PlaywrightCrawler(
browser_type=browser_type, headless=True,
@@ -133,8 +133,8 @@ async def _run_playwright(url, pages, p, proxy_config, css_selector, extract_lin
proxy_configuration=proxy_config,
configure_logging=False,
)
- link_selector = p.get('linkSelector', '') or 'a[href]'
- url_pattern = p.get('urlPattern', '')
+ link_selector = p.get('link_selector', '') or 'a[href]'
+ url_pattern = p.get('url_pattern', '')
@crawler.router.default_handler
async def handler(ctx: PlaywrightCrawlingContext) -> None:
@@ -169,20 +169,99 @@ async def _run_playwright(url, pages, p, proxy_config, css_selector, extract_lin
class CrawleeScraperParams(BaseModel):
- url: str = Field(default="")
+ tool_name: str = Field(
+ default="web_scraper",
+ description="Name shown to the LLM when used as a tool.",
+ )
+ tool_description: str = Field(
+ default="Scrape a web page and extract text, HTML, or links. Supports single-page and multi-page crawling.",
+ description="Description shown to the LLM when used as a tool.",
+ json_schema_extra={"rows": 3},
+ )
+ url: str = Field(default="", description="Target URL.")
crawler_type: Literal["beautifulsoup", "playwright", "adaptive"] = Field(
- default="beautifulsoup", alias="crawlerType",
+ default="beautifulsoup",
+ description="beautifulsoup: fast static HTML. playwright: JS-rendered. adaptive: auto-detect.",
+ )
+ mode: Literal["single", "crawl"] = Field(
+ default="single",
+ description="single: scrape only the given URL. crawl: follow links.",
+ )
+ css_selector: str = Field(
+ default="",
+ description="Optional CSS selector to narrow extraction.",
+ )
+ extract_links: bool = Field(default=False, description="Include hrefs in output.")
+ output_format: Literal["text", "html", "markdown"] = Field(default="text")
+ max_pages: int = Field(default=10, ge=1, le=1000)
+ max_concurrency: int = Field(default=5, ge=1, le=50, description="Concurrent requests.")
+ timeout: int = Field(default=60, ge=1, le=3600, description="Per-page timeout in seconds.")
+
+ # Crawl-mode fields
+ link_selector: str = Field(
+ default="",
+ description="Selector for links to follow.",
+ json_schema_extra={"displayOptions": {"show": {"mode": ["crawl"]}}},
+ )
+ url_pattern: str = Field(
+ default="",
+ description="Glob pattern for URLs to include (e.g. https://example.com/*).",
+ json_schema_extra={"displayOptions": {"show": {"mode": ["crawl"]}}},
+ )
+ max_depth: int = Field(
+ default=2, ge=0, le=50,
+ description="Max link-following depth.",
+ json_schema_extra={"displayOptions": {"show": {"mode": ["crawl"]}}},
+ )
+
+ # Playwright-only fields
+ browser_type: Literal["chromium", "firefox", "webkit"] = Field(
+ default="chromium",
+ json_schema_extra={"displayOptions": {"show": {"crawler_type": ["playwright"]}}},
+ )
+ wait_for_selector: str = Field(
+ default="",
+ description="CSS selector to wait for before extracting (JS-rendered).",
+ json_schema_extra={"displayOptions": {"show": {"crawler_type": ["playwright"]}}},
+ )
+ wait_timeout: int = Field(
+ default=30000, ge=0, le=600000,
+ description="Wait-for-selector timeout in milliseconds.",
+ json_schema_extra={"displayOptions": {"show": {"crawler_type": ["playwright"]}}},
+ )
+ take_screenshot: bool = Field(
+ default=False,
+ description="Capture a base64 PNG screenshot per page.",
+ json_schema_extra={"displayOptions": {"show": {"crawler_type": ["playwright"]}}},
+ )
+ block_resources: bool = Field(
+ default=False,
+ description="Block images/fonts/media to speed up rendering.",
+ json_schema_extra={"displayOptions": {"show": {"crawler_type": ["playwright"]}}},
+ )
+
+ # Proxy
+ use_proxy: bool = Field(default=False)
+ proxy_provider: str = Field(
+ default="auto",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ proxy_country: str = Field(
+ default="",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ session_type: Literal["rotating", "sticky"] = Field(
+ default="rotating",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
)
- mode: Literal["single", "crawl"] = "single"
- 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)
- take_screenshot: bool = Field(default=False, alias="takeScreenshot")
- output_format: Literal["text", "html", "markdown"] = Field(
- default="text", alias="outputFormat",
+ sticky_duration: int = Field(
+ default=600, ge=1,
+ json_schema_extra={
+ "displayOptions": {"show": {"use_proxy": [True], "session_type": ["sticky"]}},
+ },
)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class CrawleeScraperOutput(BaseModel):
@@ -217,22 +296,22 @@ class CrawleeScraperNode(ActionNode):
@Operation("scrape")
async def scrape(self, ctx: NodeContext, params: CrawleeScraperParams) -> CrawleeScraperOutput:
- p = params.model_dump(by_alias=True)
- url = p.get('url', '').strip()
+ url = (params.url or "").strip()
if not url:
raise RuntimeError("URL is required")
- crawler_type = p.get('crawlerType', 'beautifulsoup')
- mode = p.get('mode', 'single')
- css_selector = p.get('cssSelector', '')
- extract_links = p.get('extractLinks', False)
- output_format = p.get('outputFormat', 'text')
- max_pages = p.get('maxPages', 10) if mode == 'crawl' else 1
- max_depth = p.get('maxDepth', 2) if mode == 'crawl' else 0
- max_concurrency = p.get('maxConcurrency', 5)
- timeout_secs = p.get('timeout', 60)
+ crawler_type = params.crawler_type
+ mode = params.mode
+ css_selector = params.css_selector
+ extract_links = params.extract_links
+ output_format = params.output_format
+ max_pages = params.max_pages if mode == 'crawl' else 1
+ max_depth = params.max_depth if mode == 'crawl' else 0
+ max_concurrency = params.max_concurrency
+ timeout_secs = params.timeout
pages: List[Dict[str, Any]] = []
+ p = params.model_dump()
proxy_config = await _get_proxy_config(p, url)
try:
diff --git a/server/nodes/search/brave_search.py b/server/nodes/search/brave_search.py
index 5be82573..253e1798 100644
--- a/server/nodes/search/brave_search.py
+++ b/server/nodes/search/brave_search.py
@@ -52,15 +52,24 @@ class BraveSearchOutput(BaseModel):
class BraveSearchParams(BaseModel):
+ tool_name: str = Field(
+ default="brave_search",
+ description="Override name shown to the LLM when used as a tool.",
+ )
+ tool_description: str = Field(
+ default="Search the web using the Brave Search API. Returns web results with titles, snippets, and URLs.",
+ description="Override description shown to the LLM when used as a tool.",
+ json_schema_extra={"rows": 3},
+ )
query: str = Field(..., description="Search query", min_length=1)
- max_results: int = Field(default=10, alias="maxResults", ge=1, le=20)
+ max_results: int = Field(default=10, ge=1, le=20)
country: str = Field(default="", description="ISO country code (e.g. US, GB)")
- search_lang: str = Field(default="en", alias="searchLang")
+ search_lang: str = Field(default="en")
safe_search: Literal["off", "moderate", "strict"] = Field(
- default="moderate", alias="safeSearch"
+ default="moderate"
)
- model_config = {"populate_by_name": True, "extra": "ignore"}
+ model_config = {"extra": "ignore"}
class BraveSearchNode(ActionNode):
diff --git a/server/nodes/search/perplexity_search.py b/server/nodes/search/perplexity_search.py
index 2a5d0ee8..9a1de5f3 100644
--- a/server/nodes/search/perplexity_search.py
+++ b/server/nodes/search/perplexity_search.py
@@ -48,15 +48,24 @@ class PerplexitySearchOutput(BaseModel):
class PerplexitySearchParams(BaseModel):
+ tool_name: str = Field(
+ default="perplexity_search",
+ description="Override name shown to the LLM when used as a tool.",
+ )
+ tool_description: str = Field(
+ default="AI-powered search using Perplexity Sonar. Returns a markdown-formatted answer with inline citation references and source URLs.",
+ description="Override description shown to the LLM when used as a tool.",
+ json_schema_extra={"rows": 3},
+ )
query: str = Field(..., min_length=1)
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",
+ default="all",
)
- return_images: bool = Field(default=False, alias="returnImages")
- return_related_questions: bool = Field(default=False, alias="returnRelatedQuestions")
+ return_images: bool = Field(default=False)
+ return_related_questions: bool = Field(default=False)
- model_config = {"populate_by_name": True, "extra": "ignore"}
+ model_config = {"extra": "ignore"}
class PerplexitySearchNode(ActionNode):
diff --git a/server/nodes/search/serper_search.py b/server/nodes/search/serper_search.py
index 459ed7a3..569c252e 100644
--- a/server/nodes/search/serper_search.py
+++ b/server/nodes/search/serper_search.py
@@ -42,15 +42,24 @@ class SerperSearchOutput(BaseModel):
class SerperSearchParams(BaseModel):
+ tool_name: str = Field(
+ default="serper_search",
+ description="Override name shown to the LLM when used as a tool.",
+ )
+ tool_description: str = Field(
+ default="Search the web using Google via Serper API. Supports web, news, images, and places search with knowledge graph.",
+ description="Override description shown to the LLM when used as a tool.",
+ json_schema_extra={"rows": 3},
+ )
query: str = Field(..., min_length=1)
search_type: Literal["search", "news", "images", "places"] = Field(
- default="search", alias="searchType",
+ default="search",
)
- max_results: int = Field(default=10, alias="maxResults", ge=1, le=100)
+ max_results: int = Field(default=10, ge=1, le=100)
country: str = Field(default="")
language: str = Field(default="en")
- model_config = {"populate_by_name": True, "extra": "ignore"}
+ model_config = {"extra": "ignore"}
_ENDPOINTS = {
diff --git a/server/nodes/skill/master_skill.py b/server/nodes/skill/master_skill.py
index a07e0f70..2a1555b9 100644
--- a/server/nodes/skill/master_skill.py
+++ b/server/nodes/skill/master_skill.py
@@ -16,12 +16,12 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class MasterSkillParams(BaseModel):
- skill_folder: str = Field(default="assistant", alias="skillFolder")
+ skill_folder: str = Field(default="assistant")
skills_config: Dict[str, Any] = Field(
- default_factory=dict, alias="skillsConfig",
+ default_factory=dict,
)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class MasterSkillOutput(BaseModel):
diff --git a/server/nodes/skill/simple_memory.py b/server/nodes/skill/simple_memory.py
index 319f0ed3..949e9435 100644
--- a/server/nodes/skill/simple_memory.py
+++ b/server/nodes/skill/simple_memory.py
@@ -20,24 +20,21 @@ logger = get_logger(__name__)
class SimpleMemoryParams(BaseModel):
- session_id: str = Field(default="default", alias="sessionId")
- window_size: int = Field(default=10, alias="windowSize", ge=1, le=100)
+ session_id: str = Field(default="default")
+ window_size: int = Field(default=10, ge=1, le=100)
memory_content: str = Field(
default="# Conversation History\n",
- alias="memoryContent",
json_schema_extra={"rows": 12},
)
- memory_type: Literal["buffer", "window"] = Field(
- default="buffer", alias="memoryType",
- )
- clear_on_run: bool = Field(default=False, alias="clearOnRun")
- long_term_enabled: bool = Field(default=False, alias="longTermEnabled")
+ memory_type: Literal["buffer", "window"] = Field(default="buffer")
+ clear_on_run: bool = Field(default=False)
+ long_term_enabled: bool = Field(default=False)
retrieval_count: int = Field(
- default=3, alias="retrievalCount", ge=1, le=20,
+ default=3, ge=1, le=20,
json_schema_extra={"displayOptions": {"show": {"long_term_enabled": [True]}}},
)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class SimpleMemoryOutput(BaseModel):
@@ -71,22 +68,16 @@ class SimpleMemoryNode(ActionNode):
async def read(self, ctx: NodeContext, params: SimpleMemoryParams) -> SimpleMemoryOutput:
"""Return the current message log for the session.
- ``memory_type`` (legacy alias-only field, defaults to ``buffer``)
- and ``clear_on_run`` are read straight off the raw payload
- because they're optional UI toggles, not part of the canonical
- Params surface.
+ All fields read via Pydantic-typed access on ``params`` — no dict
+ lookups needed now that aliases are gone.
"""
from services.memory_store import clear_session, get_messages
- payload = params.model_dump(by_alias=True)
- session_id = payload.get("sessionId", params.session_id)
- memory_type = payload.get("memoryType", "buffer")
- window_size = (
- int(payload.get("windowSize", params.window_size))
- if memory_type == "window" else None
- )
+ session_id = params.session_id
+ memory_type = params.memory_type
+ window_size = params.window_size if memory_type == "window" else None
- if payload.get("clearOnRun"):
+ if params.clear_on_run:
cleared = clear_session(session_id)
logger.info("[Memory] Cleared %d messages from session '%s'", cleared, session_id)
diff --git a/server/nodes/social/social_receive.py b/server/nodes/social/social_receive.py
index 44160be8..890489b4 100644
--- a/server/nodes/social/social_receive.py
+++ b/server/nodes/social/social_receive.py
@@ -10,9 +10,9 @@ delegates the per-platform unwrap to the existing handler.
from __future__ import annotations
-from typing import Any, Optional
+from typing import Any, Literal, Optional
-from pydantic import BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict, Field
from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
@@ -21,8 +21,65 @@ _SOCIAL_SIZE = {"width": 260, "height": 160}
class SocialReceiveParams(BaseModel):
- """Pure passthrough — no user-facing params; all data flows from
- upstream trigger nodes via connected_outputs."""
+ """9-field schema matching main-branch baseline. Normaliser for
+ messages from any upstream platform trigger; filters by channel /
+ content-type / sender before fanning out across four output handles.
+ Snake_case throughout, no aliases.
+ """
+
+ channel_filter: Literal[
+ "all", "whatsapp", "telegram", "discord", "slack", "signal",
+ "sms", "webchat", "email", "matrix", "teams",
+ ] = Field(
+ default="all",
+ description="Filter by source platform",
+ )
+ message_type_filter: Literal[
+ "all", "text", "image", "video", "audio", "document",
+ "sticker", "location", "contact", "poll", "reaction",
+ ] = Field(
+ default="all",
+ description="Filter by content type",
+ )
+ sender_filter: Literal[
+ "all", "any_contact", "contact", "group", "keywords",
+ ] = Field(
+ default="all",
+ description="Filter which messages pass through",
+ )
+ contact_phone: str = Field(
+ default="",
+ description="Contact phone number (no + prefix)",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": ["contact"]}},
+ },
+ )
+ group_id: str = Field(
+ default="",
+ description="Group identifier",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": ["group"]}},
+ },
+ )
+ keywords: str = Field(
+ default="",
+ description="Comma-separated keywords (case-insensitive)",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": ["keywords"]}},
+ },
+ )
+ ignore_own_messages: bool = Field(
+ default=True,
+ description="Exclude messages sent by the connected account",
+ )
+ ignore_bots: bool = Field(
+ default=False,
+ description="Exclude messages from other bots",
+ )
+ include_media_data: bool = Field(
+ default=False,
+ description="Include base64 media payload (memory-intensive)",
+ )
model_config = ConfigDict(extra="allow")
@@ -65,7 +122,7 @@ class SocialReceiveNode(ActionNode):
source_nodes = ctx.raw.get("source_nodes") or []
response = await handle_social_receive(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True), context=ctx.raw,
+ parameters=params.model_dump(), context=ctx.raw,
connected_outputs=outputs, source_nodes=source_nodes,
)
if response.get("success") is False:
diff --git a/server/nodes/social/social_send.py b/server/nodes/social/social_send.py
index a7913596..dd4573d7 100644
--- a/server/nodes/social/social_send.py
+++ b/server/nodes/social/social_send.py
@@ -7,9 +7,9 @@ message / media / contact / metadata as separate left-side handles.
from __future__ import annotations
-from typing import Any, Dict, Optional
+from typing import Any, Dict, Literal, Optional
-from pydantic import BaseModel, ConfigDict
+from pydantic import BaseModel, ConfigDict, Field
from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
@@ -18,9 +18,315 @@ _SOCIAL_SIZE = {"width": 260, "height": 160}
class SocialSendParams(BaseModel):
- platform: Optional[str] = None
- recipient: Optional[str] = None
- text: Optional[str] = None
+ """40-field schema matching main-branch baseline. Unified send across
+ 10 platforms × 11 message types × 5 recipient types. Heavy
+ ``displayOptions`` cascading.
+ """
+
+ # ===== CHANNEL / PLATFORM =====
+ channel: Literal[
+ "whatsapp", "telegram", "discord", "slack", "signal",
+ "sms", "webchat", "email", "matrix", "teams",
+ ] = Field(
+ default="whatsapp",
+ description="Target chat platform",
+ )
+
+ # ===== RECIPIENT =====
+ recipient_type: Literal["phone", "group", "channel", "user", "chat"] = Field(
+ default="phone",
+ description="Type of recipient",
+ )
+ phone: str = Field(
+ default="",
+ description="Recipient phone number (no + prefix)",
+ json_schema_extra={
+ "displayOptions": {"show": {"recipient_type": ["phone"]}},
+ },
+ )
+ group_id: str = Field(
+ default="",
+ description="Group identifier",
+ json_schema_extra={
+ "displayOptions": {"show": {"recipient_type": ["group"]}},
+ },
+ )
+ channel_id: str = Field(
+ default="",
+ description="Channel identifier",
+ json_schema_extra={
+ "displayOptions": {"show": {"recipient_type": ["channel"]}},
+ },
+ )
+ user_id: str = Field(
+ default="",
+ description="User identifier",
+ json_schema_extra={
+ "displayOptions": {"show": {"recipient_type": ["user"]}},
+ },
+ )
+ chat_id: str = Field(
+ default="",
+ description="Generic chat identifier",
+ json_schema_extra={
+ "displayOptions": {"show": {"recipient_type": ["chat"]}},
+ },
+ )
+ thread_id: str = Field(
+ default="",
+ description="Thread to reply in (optional)",
+ )
+
+ # ===== MESSAGE TYPE =====
+ message_type: Literal[
+ "text", "image", "video", "audio", "document",
+ "sticker", "location", "contact", "poll", "buttons", "list",
+ ] = Field(default="text")
+
+ # ===== TEXT =====
+ message: str = Field(
+ default="",
+ description="Text message content",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
+ )
+ format: Literal["plain", "markdown", "html"] = Field(
+ default="plain",
+ description="Text formatting",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
+ )
+
+ # ===== MEDIA (image / video / audio / document / sticker) =====
+ media_source: Literal["url", "base64", "file"] = Field(
+ default="url",
+ description="Source of media data",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": [
+ "image", "video", "audio", "document", "sticker",
+ ]}},
+ },
+ )
+ media_url: str = Field(
+ default="",
+ description="URL to download media from",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "message_type": ["image", "video", "audio", "document", "sticker"],
+ "media_source": ["url"],
+ }},
+ },
+ )
+ media_data: str = Field(
+ default="",
+ description="Base64-encoded media data",
+ json_schema_extra={
+ "rows": 3,
+ "displayOptions": {"show": {
+ "message_type": ["image", "video", "audio", "document", "sticker"],
+ "media_source": ["base64"],
+ }},
+ },
+ )
+ file_path: str = Field(
+ default="",
+ description="Server file path",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "message_type": ["image", "video", "audio", "document", "sticker"],
+ "media_source": ["file"],
+ }},
+ },
+ )
+ mime_type: str = Field(
+ default="",
+ description="MIME type (auto-detected if empty)",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": [
+ "image", "video", "audio", "document", "sticker",
+ ]}},
+ },
+ )
+ caption: str = Field(
+ default="",
+ description="Optional caption for media",
+ json_schema_extra={
+ "rows": 2,
+ "displayOptions": {"show": {"message_type": ["image", "video", "document"]}},
+ },
+ )
+ filename: str = Field(
+ default="",
+ description="Document filename",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["document"]}},
+ },
+ )
+
+ # ===== LOCATION =====
+ latitude: float = Field(
+ default=0.0,
+ description="Location latitude",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
+ )
+ longitude: float = Field(
+ default=0.0,
+ description="Location longitude",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
+ )
+ location_name: str = Field(
+ default="",
+ description="Display name for location",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
+ )
+ address: str = Field(
+ default="",
+ description="Address text",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
+ )
+
+ # ===== CONTACT =====
+ contact_name: str = Field(
+ default="",
+ description="Display name for contact",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
+ )
+ contact_phone: str = Field(
+ default="",
+ description="Contact phone number",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
+ )
+ vcard: str = Field(
+ default="",
+ description="vCard 3.0 format string (optional if phone provided)",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
+ )
+
+ # ===== POLL =====
+ poll_question: str = Field(
+ default="",
+ description="Poll question",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["poll"]}},
+ },
+ )
+ poll_options: str = Field(
+ default="",
+ description="Comma-separated poll options",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["poll"]}},
+ },
+ )
+ poll_allow_multiple: bool = Field(
+ default=False,
+ description="Allow multiple selections",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["poll"]}},
+ },
+ )
+
+ # ===== BUTTONS =====
+ button_text: str = Field(
+ default="",
+ description="Text displayed above buttons",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["buttons"]}},
+ },
+ )
+ buttons: str = Field(
+ default="[]",
+ description="JSON array: [{id, text}, ...]",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["buttons"]}},
+ },
+ )
+
+ # ===== LIST =====
+ list_title: str = Field(
+ default="",
+ description="Title for the list",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["list"]}},
+ },
+ )
+ list_button_text: str = Field(
+ default="View Options",
+ description="Text for the list button",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["list"]}},
+ },
+ )
+ list_sections: str = Field(
+ default="[]",
+ description="JSON array of sections with rows",
+ json_schema_extra={
+ "rows": 6,
+ "displayOptions": {"show": {"message_type": ["list"]}},
+ },
+ )
+
+ # ===== REPLY / QUOTE =====
+ reply_to_message: bool = Field(
+ default=False,
+ description="Quote an existing message",
+ )
+ reply_message_id: str = Field(
+ default="",
+ description="ID of message to reply to",
+ json_schema_extra={
+ "displayOptions": {"show": {"reply_to_message": [True]}},
+ },
+ )
+ reply_to_current: bool = Field(
+ default=False,
+ description="Reply to the message that triggered this workflow",
+ json_schema_extra={
+ "displayOptions": {"show": {"reply_to_message": [True]}},
+ },
+ )
+
+ # ===== SEND OPTIONS =====
+ audio_as_voice: bool = Field(
+ default=False,
+ description="Send audio as voice message",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["audio"]}},
+ },
+ )
+ disable_preview: bool = Field(
+ default=False,
+ description="Disable link preview in text messages",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
+ )
+ silent: bool = Field(
+ default=False,
+ description="Send without notification sound",
+ )
+ protect_content: bool = Field(
+ default=False,
+ description="Prevent forwarding/saving (if supported)",
+ )
model_config = ConfigDict(extra="allow")
@@ -60,7 +366,7 @@ class SocialSendNode(ActionNode):
from ._base import handle_social_send
response = await handle_social_send(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True), context=ctx.raw,
+ parameters=params.model_dump(), context=ctx.raw,
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/telegram/telegram_receive.py b/server/nodes/telegram/telegram_receive.py
index 352e860c..a839d871 100644
--- a/server/nodes/telegram/telegram_receive.py
+++ b/server/nodes/telegram/telegram_receive.py
@@ -18,29 +18,57 @@ from ._credentials import TelegramCredential
class TelegramReceiveParams(BaseModel):
+ """7-field schema. Snake_case field names throughout; JSON Schema
+ keys match field names exactly (no aliases).
+ """
+
content_type_filter: Literal[
"all", "text", "photo", "video", "audio", "voice", "document",
"sticker", "location", "contact", "poll",
- ] = Field(default="all", alias="contentTypeFilter")
+ ] = Field(
+ default="all",
+ description="Filter by message content type",
+ )
sender_filter: Literal[
"all", "self", "private", "group", "supergroup", "channel",
"specific_chat", "specific_user", "keywords",
- ] = Field(default="all", alias="senderFilter")
+ ] = Field(
+ default="all",
+ description="Filter which messages trigger the workflow",
+ )
chat_id: str = Field(
- default="", alias="chatId",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["specific_chat"]}}},
+ default="",
+ description="Only trigger for messages from this specific chat ID",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": ["specific_chat"]}},
+ },
)
from_user: str = Field(
- default="", alias="fromUser",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["specific_user"]}}},
+ default="",
+ description="Only trigger for messages from this specific user ID",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": ["specific_user"]}},
+ },
)
keywords: str = Field(
default="",
- json_schema_extra={"displayOptions": {"show": {"sender_filter": ["keywords"]}}},
+ description="Comma-separated keywords to trigger on (case-insensitive)",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": ["keywords"]}},
+ },
+ )
+ ignore_bots: bool = Field(
+ default=True,
+ description="Do not trigger on messages from other bots",
+ json_schema_extra={
+ "displayOptions": {"show": {"sender_filter": [
+ "all", "private", "group", "supergroup", "channel",
+ "specific_chat", "specific_user", "keywords",
+ ]}},
+ },
)
- ignore_bots: bool = Field(default=True, alias="ignoreBots")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class TelegramReceiveOutput(BaseModel):
@@ -90,7 +118,7 @@ class TelegramReceiveNode(TriggerNode):
# Delegate to legacy filter builder for full feature parity —
# 11.F ports the body and removes the legacy registry entry.
from services.event_waiter import build_telegram_filter
- return build_telegram_filter(params.model_dump(by_alias=True))
+ return build_telegram_filter(params.model_dump())
@Operation("wait")
async def wait(self, ctx: NodeContext, params: TelegramReceiveParams) -> TelegramReceiveOutput:
diff --git a/server/nodes/telegram/telegram_send.py b/server/nodes/telegram/telegram_send.py
index b22ff7d1..ab4d02d8 100644
--- a/server/nodes/telegram/telegram_send.py
+++ b/server/nodes/telegram/telegram_send.py
@@ -18,55 +18,118 @@ from ._credentials import TelegramCredential
class TelegramSendParams(BaseModel):
- recipient_type: Literal["self", "chat_id"] = Field(
- default="self", alias="recipientType",
+ """13-field schema matching main-branch baseline. All field names use
+ snake_case to match baseline directly (no camelCase aliases) — the
+ frontend stores params under these exact keys and ``displayOptions``
+ must reference them to stay consistent.
+ """
+
+ # ===== RECIPIENT =====
+ recipient_type: Literal["self", "user", "group"] = Field(
+ default="self",
+ description="Send to bot owner (self), specific user, or group",
)
chat_id: str = Field(
- default="", alias="chatId",
- json_schema_extra={"displayOptions": {"show": {"recipient_type": ["chat_id"]}}},
+ 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", alias="messageType",
+ default="text",
+ description="Type of message to send",
)
+
+ # ===== TEXT =====
text: str = Field(
default="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["text"]}}},
+ description="Text message content",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
)
+
+ # ===== MEDIA (photo / document) =====
media_url: str = Field(
- default="", alias="mediaUrl",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["photo", "document"]}}},
+ default="",
+ description="URL of the media file or file_id from previous message",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["photo", "document"]}},
+ },
)
caption: str = Field(
default="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["photo", "document"]}}},
+ description="Optional caption for media",
+ json_schema_extra={
+ "rows": 2,
+ "displayOptions": {"show": {"message_type": ["photo", "document"]}},
+ },
)
- latitude: Optional[float] = Field(
- default=None,
- json_schema_extra={"displayOptions": {"show": {"message_type": ["location"]}}},
+
+ # ===== LOCATION =====
+ latitude: float = Field(
+ default=0.0,
+ description="Location latitude (-90 to 90)",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
)
- longitude: Optional[float] = Field(
- default=None,
- 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"]}},
+ },
)
- phone: str = Field(
+
+ # ===== CONTACT =====
+ phone_number: str = Field(
default="",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
+ description="Contact phone number (with country code)",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
)
first_name: str = Field(
- default="", alias="firstName",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
+ default="",
+ description="Contact first name",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
)
last_name: str = Field(
- default="", alias="lastName",
- json_schema_extra={"displayOptions": {"show": {"message_type": ["contact"]}}},
+ 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={
+ "displayOptions": {"show": {"message_type": ["text", "photo", "document"]}},
+ },
+ )
+ silent: bool = Field(
+ default=False,
+ description="Send message without notification sound",
)
- parse_mode: Literal["Auto", "HTML", "Markdown", "MarkdownV2", "None"] = Field(
- default="Auto", alias="parseMode",
+ reply_to_message_id: int = Field(
+ default=0,
+ description="If > 0, sends the message as a reply to this message ID",
)
- silent: bool = False
- reply_to_message_id: Optional[int] = Field(default=None, alias="replyToMessageId")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class TelegramSendOutput(BaseModel):
@@ -136,7 +199,9 @@ class TelegramSendNode(ActionNode):
if not chat_id:
raise RuntimeError("chat_id is required")
- parse_mode = params.parse_mode if params.parse_mode != "None" else None
+ # Empty string = no parse mode (Python None); other values pass through
+ # so the TelegramService can handle "Auto" and the formal parse modes.
+ parse_mode = params.parse_mode or None
reply_to = int(params.reply_to_message_id) if params.reply_to_message_id else None
common = dict(
@@ -176,12 +241,12 @@ class TelegramSendNode(ActionNode):
**common,
)
elif mt == "contact":
- if not params.phone or not params.first_name:
+ if not params.phone_number or not params.first_name:
raise RuntimeError(
- "phone and first_name are required for contact message",
+ "phone_number and first_name are required for contact message",
)
result = await service.send_contact(
- phone_number=params.phone,
+ phone_number=params.phone_number,
first_name=params.first_name,
last_name=params.last_name or None,
**common,
diff --git a/server/nodes/text/file_handler.py b/server/nodes/text/file_handler.py
index 51667e8d..bc693872 100644
--- a/server/nodes/text/file_handler.py
+++ b/server/nodes/text/file_handler.py
@@ -11,11 +11,11 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class FileHandlerParams(BaseModel):
operation: Literal["read", "write", "append", "delete"] = "read"
- file_path: str = Field(..., alias="filePath")
+ file_path: str = Field(...)
content: str = Field(default="")
encoding: str = Field(default="utf-8")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class FileHandlerOutput(BaseModel):
@@ -51,7 +51,7 @@ class FileHandlerNode(ActionNode):
text_service = container.text_service()
response = await text_service.execute_file_handler(
- ctx.node_id, params.model_dump(by_alias=True),
+ ctx.node_id, params.model_dump(),
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/text/text_generator.py b/server/nodes/text/text_generator.py
index bc218603..e43b07d8 100644
--- a/server/nodes/text/text_generator.py
+++ b/server/nodes/text/text_generator.py
@@ -12,10 +12,10 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class TextGeneratorParams(BaseModel):
source: Literal["static", "ai", "file", "api"] = "static"
text: str = Field(default="", json_schema_extra={"rows": 4})
- file_path: str = Field(default="", alias="filePath")
- api_url: str = Field(default="", alias="apiUrl")
+ file_path: str = Field(default="")
+ api_url: str = Field(default="")
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class TextGeneratorOutput(BaseModel):
@@ -50,7 +50,7 @@ class TextGeneratorNode(ActionNode):
text_service = container.text_service()
response = await text_service.execute_text_generator(
- ctx.node_id, params.model_dump(by_alias=True),
+ ctx.node_id, params.model_dump(),
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/trigger/chat_trigger.py b/server/nodes/trigger/chat_trigger.py
index f78883d7..4fb8ffdc 100644
--- a/server/nodes/trigger/chat_trigger.py
+++ b/server/nodes/trigger/chat_trigger.py
@@ -21,10 +21,10 @@ from services.plugin import NodeContext, Operation, TaskQueue, TriggerNode
class ChatTriggerParams(BaseModel):
- session_id: str = Field(default="default", alias="sessionId")
+ session_id: str = Field(default="default")
placeholder: str = "Type a message..."
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ChatTriggerOutput(BaseModel):
diff --git a/server/nodes/trigger/task_trigger.py b/server/nodes/trigger/task_trigger.py
index 554c0c6a..5d531eb6 100644
--- a/server/nodes/trigger/task_trigger.py
+++ b/server/nodes/trigger/task_trigger.py
@@ -15,14 +15,14 @@ from services.plugin import NodeContext, Operation, TaskQueue, TriggerNode
class TaskTriggerParams(BaseModel):
- task_id: str = Field(default="", alias="taskId")
- agent_name: str = Field(default="", alias="agentName")
+ task_id: str = Field(default="")
+ agent_name: str = Field(default="")
status_filter: Literal["all", "completed", "error"] = Field(
- default="all", alias="statusFilter",
+ default="all",
)
- parent_node_id: str = Field(default="", alias="parentNodeId")
+ parent_node_id: str = Field(default="")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class TaskTriggerOutput(BaseModel):
diff --git a/server/nodes/trigger/webhook_trigger.py b/server/nodes/trigger/webhook_trigger.py
index 044265bf..b81472cf 100644
--- a/server/nodes/trigger/webhook_trigger.py
+++ b/server/nodes/trigger/webhook_trigger.py
@@ -31,15 +31,33 @@ class WebhookTriggerParams(BaseModel):
default="",
description="URL path fragment — becomes /webhook/{path}",
)
- method: Literal["GET", "POST", "PUT", "DELETE", "ALL"] = "POST"
+ method: Literal["GET", "POST", "PUT", "DELETE", "ALL"] = Field(
+ default="POST",
+ description="HTTP method to accept. ALL accepts any method.",
+ )
response_mode: Literal["immediate", "responseNode"] = Field(
- default="immediate", alias="responseMode",
+ default="immediate",
+ description="immediate: return 200 OK right away. responseNode: wait for a webhookResponse node downstream.",
+ )
+ authentication: Literal["none", "header"] = Field(
+ default="none",
+ description="none: no auth. header: require a matching header on inbound requests.",
+ )
+ header_name: str = Field(
+ default="X-API-Key",
+ description="Header name to check when authentication=header.",
+ json_schema_extra={"displayOptions": {"show": {"authentication": ["header"]}}},
+ )
+ header_value: str = Field(
+ default="",
+ description="Expected header value when authentication=header.",
+ json_schema_extra={
+ "widget": "password",
+ "displayOptions": {"show": {"authentication": ["header"]}},
+ },
)
- authentication: Literal["none", "header"] = "none"
- header_name: str = Field(default="X-API-Key", alias="headerName")
- header_value: str = Field(default="", alias="headerValue")
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class WebhookTriggerOutput(BaseModel):
@@ -48,9 +66,9 @@ class WebhookTriggerOutput(BaseModel):
headers: Optional[dict] = None
query: Optional[dict] = None
body: Optional[str] = None
- json_: Optional[dict] = Field(default=None, alias="json")
+ json_: Optional[dict] = Field(default=None)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class WebhookTriggerNode(TriggerNode):
diff --git a/server/nodes/twitter/twitter_receive.py b/server/nodes/twitter/twitter_receive.py
index a037f22f..de34b01b 100644
--- a/server/nodes/twitter/twitter_receive.py
+++ b/server/nodes/twitter/twitter_receive.py
@@ -13,15 +13,15 @@ from ._credentials import TwitterCredential
class TwitterReceiveParams(BaseModel):
trigger_type: Literal["mentions", "search", "timeline"] = Field(
- default="mentions", alias="triggerType",
+ default="mentions",
)
- search_query: str = Field(default="", alias="searchQuery")
- user_id: str = Field(default="", alias="userId")
- 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)
+ search_query: str = Field(default="")
+ user_id: str = Field(default="")
+ filter_retweets: bool = Field(default=True)
+ filter_replies: bool = Field(default=False)
+ poll_interval: int = Field(default=60, ge=15, le=3600)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class TwitterReceiveOutput(BaseModel):
diff --git a/server/nodes/twitter/twitter_search.py b/server/nodes/twitter/twitter_search.py
index aa6a5361..2f7a4693 100644
--- a/server/nodes/twitter/twitter_search.py
+++ b/server/nodes/twitter/twitter_search.py
@@ -3,7 +3,7 @@
from __future__ import annotations
import asyncio
-from typing import Optional
+from typing import Literal, Optional
from pydantic import BaseModel, ConfigDict, Field
@@ -18,10 +18,41 @@ from ._base import (
class TwitterSearchParams(BaseModel):
- query: str = Field(default="", min_length=0)
- max_results: int = Field(default=10, alias="maxResults", ge=10, le=100)
+ """7-field schema matching main-branch baseline. Snake_case throughout."""
+
+ query: str = Field(
+ default="",
+ description=(
+ "Twitter search query (operators: keywords, hashtags, @mentions, "
+ "from:user, -exclude, OR, lang:, has:*, is:*)"
+ ),
+ )
+ max_results: int = Field(
+ default=10, ge=10, le=100,
+ description="Number of results (X API minimum 10, max 100)",
+ )
+ sort_order: Literal["recency", "relevancy"] = Field(
+ default="recency",
+ description="Sort by recent or relevant",
+ )
+ start_time: str = Field(
+ default="",
+ description="ISO 8601 timestamp (optional); e.g. 2024-01-01T00:00:00Z",
+ )
+ end_time: str = Field(
+ default="",
+ description="ISO 8601 timestamp (optional)",
+ )
+ include_metrics: bool = Field(
+ default=True,
+ description="Include likes / retweets / replies / quote counts",
+ )
+ include_author: bool = Field(
+ default=True,
+ description="Include author profile (username, name, verified)",
+ )
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class TwitterSearchOutput(BaseModel):
diff --git a/server/nodes/twitter/twitter_send.py b/server/nodes/twitter/twitter_send.py
index 1dbf2e48..f587c1c4 100644
--- a/server/nodes/twitter/twitter_send.py
+++ b/server/nodes/twitter/twitter_send.py
@@ -17,12 +17,76 @@ from ._base import (
class TwitterSendParams(BaseModel):
- action: Literal["tweet", "reply", "retweet", "like", "unlike", "delete"] = "tweet"
- text: str = Field(default="")
- tweet_id: str = Field(default="", alias="tweetId")
- reply_to_id: str = Field(default="", alias="replyToId")
+ """8-field schema matching main-branch baseline. Snake_case throughout,
+ no aliases. ``reply`` action uses ``tweet_id`` as the target (unified
+ with other id-based actions) — baseline behaviour.
+ """
+ action: Literal[
+ "tweet", "reply", "retweet", "quote", "like", "unlike", "delete",
+ ] = Field(default="tweet", description="Action to perform")
+ text: str = Field(
+ default="",
+ description="Tweet text (max 280 chars)",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"action": ["tweet", "reply", "quote"]}},
+ },
+ )
+ tweet_id: str = Field(
+ default="",
+ description="Target tweet ID (for reply/retweet/quote/like/unlike/delete)",
+ json_schema_extra={
+ "displayOptions": {"show": {"action": [
+ "reply", "retweet", "quote", "like", "unlike", "delete",
+ ]}},
+ },
+ )
+ include_media: bool = Field(
+ default=False,
+ description="Attach images or videos",
+ json_schema_extra={
+ "displayOptions": {"show": {"action": ["tweet", "reply", "quote"]}},
+ },
+ )
+ media_urls: str = Field(
+ default="",
+ description="Comma-separated URLs; max 4 images or 1 video",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "action": ["tweet", "reply", "quote"],
+ "include_media": [True],
+ }},
+ },
+ )
+ include_poll: bool = Field(
+ default=False,
+ description="Create poll with tweet",
+ json_schema_extra={
+ "displayOptions": {"show": {"action": ["tweet"]}},
+ },
+ )
+ poll_options: str = Field(
+ default="",
+ description="Comma-separated options (2-4 items, 25 chars each)",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "action": ["tweet"],
+ "include_poll": [True],
+ }},
+ },
+ )
+ poll_duration: int = Field(
+ default=1440, ge=5, le=10080,
+ description="Poll duration in minutes (5 min - 7 days)",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "action": ["tweet"],
+ "include_poll": [True],
+ }},
+ },
+ )
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class TwitterSendOutput(BaseModel):
@@ -43,9 +107,9 @@ async def _do_send(client, action: str, p: dict, node_id: str, ctx_raw: dict) ->
if action == "reply":
text = p.get("text", "")
- reply_to = p.get("replyToId") or p.get("reply_to_id")
+ reply_to = p.get("tweet_id")
if not text or not reply_to:
- raise RuntimeError("Text and reply_to_id are required")
+ raise RuntimeError("Text and tweet_id are required for reply")
result = await asyncio.to_thread(
client.posts.create,
body={"text": text[:280], "reply": {"in_reply_to_tweet_id": reply_to}},
@@ -53,7 +117,19 @@ async def _do_send(client, action: str, p: dict, node_id: str, ctx_raw: dict) ->
await track_twitter_usage(node_id, "reply", 1, ctx_raw)
return TwitterSendOutput(action="reply_sent", data=format_response(result))
- tweet_id = p.get("tweetId") or p.get("tweet_id")
+ if action == "quote":
+ text = p.get("text", "")
+ quote_id = p.get("tweet_id")
+ if not text or not quote_id:
+ raise RuntimeError("Text and tweet_id are required for quote")
+ result = await asyncio.to_thread(
+ client.posts.create,
+ body={"text": text[:280], "quote_tweet_id": quote_id},
+ )
+ await track_twitter_usage(node_id, "quote", 1, ctx_raw)
+ return TwitterSendOutput(action="quoted", data=format_response(result))
+
+ tweet_id = p.get("tweet_id")
if not tweet_id:
raise RuntimeError("tweet_id is required")
@@ -114,6 +190,6 @@ class TwitterSendNode(ActionNode):
@Operation("send", cost={"service": "twitter", "action": "send", "count": 1})
async def send(self, ctx: NodeContext, params: TwitterSendParams) -> TwitterSendOutput:
- p = params.model_dump(by_alias=True)
+ p = params.model_dump()
action = p.get("action", "tweet")
return await call_with_retry(_do_send, action, p, ctx.node_id, ctx.raw)
diff --git a/server/nodes/twitter/twitter_user.py b/server/nodes/twitter/twitter_user.py
index 8641cfbc..ba03678e 100644
--- a/server/nodes/twitter/twitter_user.py
+++ b/server/nodes/twitter/twitter_user.py
@@ -15,12 +15,38 @@ from ._base import call_with_retry, format_user, get_my_user_id, track_twitter_u
class TwitterUserParams(BaseModel):
- operation: Literal["me", "by_username", "by_id", "followers", "following"] = "me"
- username: str = Field(default="")
- user_id: str = Field(default="", alias="userId")
- max_results: int = Field(default=100, alias="maxResults", ge=1, le=1000)
+ """Baseline-aligned schema with conditional fields per operation.
+ Snake_case throughout."""
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ operation: Literal["me", "by_username", "by_id", "followers", "following"] = Field(
+ default="me",
+ description="User-lookup operation",
+ )
+ username: str = Field(
+ default="",
+ description="Twitter username (without @ prefix)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["by_username"]}},
+ },
+ )
+ user_id: str = Field(
+ default="",
+ description="Twitter user ID (numeric)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": [
+ "by_id", "followers", "following",
+ ]}},
+ },
+ )
+ max_results: int = Field(
+ default=100, ge=1, le=1000,
+ description="Number of users to return (1-1000)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["followers", "following"]}},
+ },
+ )
+
+ model_config = ConfigDict(extra="ignore")
class TwitterUserOutput(BaseModel):
@@ -71,7 +97,7 @@ async def _do_lookup(client, op: str, p: dict, node_id: str, ctx_raw: dict) -> T
return TwitterUserOutput(operation="by_username", user=format_user(users[0]))
if op == "by_id":
- user_id = p.get("userId") or p.get("user_id")
+ user_id = p.get("user_id")
if not user_id:
raise RuntimeError("User ID is required")
result = await asyncio.to_thread(
@@ -85,8 +111,8 @@ async def _do_lookup(client, op: str, p: dict, node_id: str, ctx_raw: dict) -> T
return TwitterUserOutput(operation="by_id", user=format_user(users[0]))
if op in ("followers", "following"):
- user_id = p.get("userId") or p.get("user_id") or await get_my_user_id(client)
- max_results = max(1, min(int(p.get("maxResults", 100)), 1000))
+ user_id = p.get("user_id") or await get_my_user_id(client)
+ max_results = max(1, min(int(p.get("max_results", 100)), 1000))
fetch = _sync_followers if op == "followers" else _sync_following
raw = await asyncio.to_thread(fetch, client, user_id, max_results)
users = [format_user(u) for u in raw]
@@ -122,6 +148,6 @@ class TwitterUserNode(ActionNode):
@Operation("lookup", cost={"service": "twitter", "action": "user_lookup", "count": 1})
async def lookup(self, ctx: NodeContext, params: TwitterUserParams) -> TwitterUserOutput:
- p = params.model_dump(by_alias=True)
+ p = params.model_dump()
op = p.get("operation", "me")
return await call_with_retry(_do_lookup, op, p, ctx.node_id, ctx.raw)
diff --git a/server/nodes/utility/console.py b/server/nodes/utility/console.py
index 6fa55f3b..d44f6617 100644
--- a/server/nodes/utility/console.py
+++ b/server/nodes/utility/console.py
@@ -88,11 +88,9 @@ def _format_console_output(data: Any, format_type: str) -> str:
class ConsoleParams(BaseModel):
label: str = ""
- log_mode: Literal["all", "field", "expression"] = Field(
- default="all", alias="logMode",
- )
+ log_mode: Literal["all", "field", "expression"] = Field(default="all")
field_path: str = Field(
- default="", alias="fieldPath",
+ default="",
json_schema_extra={"displayOptions": {"show": {"log_mode": ["field"]}}},
)
expression: str = Field(
@@ -101,7 +99,7 @@ class ConsoleParams(BaseModel):
)
format: Literal["json", "json_compact", "text", "table"] = "json"
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class ConsoleOutput(BaseModel):
diff --git a/server/nodes/utility/http_request.py b/server/nodes/utility/http_request.py
index c9bb618f..0a997822 100644
--- a/server/nodes/utility/http_request.py
+++ b/server/nodes/utility/http_request.py
@@ -11,13 +11,50 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class HttpRequestParams(BaseModel):
method: Literal["GET", "POST", "PUT", "DELETE", "PATCH"] = "GET"
- url: str = Field(...)
- headers: Dict[str, str] = Field(default_factory=dict)
- body: Optional[Any] = None
- timeout: int = Field(default=30, ge=1, le=600)
- use_proxy: bool = Field(default=False, alias="useProxy")
+ url: str = Field(..., description="Target URL.")
+ headers: Dict[str, str] = Field(
+ default_factory=dict,
+ description="Request headers as JSON object.",
+ json_schema_extra={"rows": 3},
+ )
+ body: Optional[Any] = Field(
+ default=None,
+ description="Request body (JSON object or raw string). Ignored for GET/DELETE.",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"method": ["POST", "PUT", "PATCH"]}},
+ },
+ )
+ timeout: int = Field(default=30, ge=1, le=600, description="Timeout in seconds.")
+
+ use_proxy: bool = Field(
+ default=False,
+ description="Route through residential proxy provider.",
+ )
+ proxy_provider: str = Field(
+ default="auto",
+ description="Provider name ('auto' selects by health score).",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ proxy_country: str = Field(
+ default="",
+ description="ISO country code (e.g. US, GB) for geo-targeted IP.",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ session_type: Literal["rotating", "sticky"] = Field(
+ default="rotating",
+ description="Rotating changes IPs per request; sticky holds one IP.",
+ json_schema_extra={"displayOptions": {"show": {"use_proxy": [True]}}},
+ )
+ sticky_duration: int = Field(
+ default=600, ge=1,
+ description="Sticky session duration in seconds.",
+ json_schema_extra={
+ "displayOptions": {"show": {"use_proxy": [True], "session_type": ["sticky"]}},
+ },
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="ignore")
class HttpRequestOutput(BaseModel):
@@ -65,7 +102,7 @@ class HttpRequestNode(ActionNode):
raise RuntimeError("URL is required")
proxy_url = await _resolve_proxy_url(params.url, params.use_proxy,
- params.model_dump(by_alias=True))
+ params.model_dump())
log.info("[HTTP Request] Executing", node_id=ctx.node_id,
method=params.method, url=params.url, proxy=bool(proxy_url))
diff --git a/server/nodes/utility/process_manager.py b/server/nodes/utility/process_manager.py
index 22e244b0..1b562b8a 100644
--- a/server/nodes/utility/process_manager.py
+++ b/server/nodes/utility/process_manager.py
@@ -15,11 +15,11 @@ class ProcessManagerParams(BaseModel):
command: str = Field(default="")
cwd: str = Field(default="")
env: Dict[str, str] = Field(default_factory=dict)
- input_text: str = Field(default="", alias="inputText")
+ input_text: str = Field(default="")
stream: Literal["stdout", "stderr"] = "stdout"
tail: int = Field(default=100, ge=1, le=10000)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class ProcessManagerOutput(BaseModel):
diff --git a/server/nodes/utility/team_monitor.py b/server/nodes/utility/team_monitor.py
index 2815a4e2..17ce5438 100644
--- a/server/nodes/utility/team_monitor.py
+++ b/server/nodes/utility/team_monitor.py
@@ -10,11 +10,11 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class TeamMonitorParams(BaseModel):
- team_id: str = Field(default="", alias="teamId")
- auto_refresh: bool = Field(default=True, alias="autoRefresh")
- max_history_items: int = Field(default=50, alias="maxHistoryItems", ge=1)
+ team_id: str = Field(default="")
+ auto_refresh: bool = Field(default=True)
+ max_history_items: int = Field(default=50, ge=1)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class TeamMonitorOutput(BaseModel):
diff --git a/server/nodes/utility/webhook_response.py b/server/nodes/utility/webhook_response.py
index 73e2e93a..a1bde503 100644
--- a/server/nodes/utility/webhook_response.py
+++ b/server/nodes/utility/webhook_response.py
@@ -10,12 +10,12 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class WebhookResponseParams(BaseModel):
- status_code: int = Field(default=200, alias="statusCode", ge=100, le=599)
+ status_code: int = Field(default=200, ge=100, le=599)
body: Any = Field(default=None)
headers: Dict[str, str] = Field(default_factory=dict)
- content_type: str = Field(default="application/json", alias="contentType")
+ content_type: str = Field(default="application/json")
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class WebhookResponseOutput(BaseModel):
diff --git a/server/nodes/whatsapp/whatsapp_db.py b/server/nodes/whatsapp/whatsapp_db.py
index 4f54e9c0..907b64f1 100644
--- a/server/nodes/whatsapp/whatsapp_db.py
+++ b/server/nodes/whatsapp/whatsapp_db.py
@@ -15,6 +15,11 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class WhatsAppDbParams(BaseModel):
+ """32-field schema matching main-branch baseline. Operation selector
+ drives 18 conditional branches; each operation surfaces only its
+ relevant fields via ``displayOptions.show``.
+ """
+
operation: Literal[
"chat_history", "search_groups", "get_group_info",
"get_contact_info", "list_contacts", "check_contacts",
@@ -23,15 +28,281 @@ class WhatsAppDbParams(BaseModel):
"channel_create", "channel_mute", "channel_mark_viewed",
"newsletter_react", "newsletter_live_updates",
"contact_profile_pic",
- ] = "chat_history"
- chat_id: str = Field(default="", alias="chatId")
- group_id: str = Field(default="", alias="groupId")
- phone_number: str = Field(default="", alias="phoneNumber")
- limit: int = Field(default=20, ge=1, le=500)
- offset: int = Field(default=0, ge=0)
- include_media_data: bool = Field(default=False, alias="includeMediaData")
+ ] = Field(default="chat_history", description="Operation to perform")
+
+ # ===== CHAT HISTORY =====
+ chat_type: Literal["individual", "group"] = Field(
+ default="individual",
+ description="Individual or group chat",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["chat_history"]}},
+ },
+ )
+ phone: str = Field(
+ default="",
+ description="Contact phone number (no + prefix)",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "operation": ["chat_history"], "chat_type": ["individual"],
+ }},
+ },
+ )
+ group_id: str = Field(
+ default="",
+ description="Group JID (format: [email protected])",
+ json_schema_extra={
+ "component": "GroupIdSelector",
+ "displayOptions": {"show": {
+ "operation": ["chat_history", "get_group_info"],
+ "chat_type": ["group"],
+ }},
+ },
+ )
+ group_filter: Literal["all", "contact"] = Field(
+ default="all",
+ description="Filter messages in group",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "operation": ["chat_history"], "chat_type": ["group"],
+ }},
+ },
+ )
+ sender_phone: str = Field(
+ default="",
+ description="Filter to messages from specific group member",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "operation": ["chat_history"],
+ "chat_type": ["group"],
+ "group_filter": ["contact"],
+ }},
+ },
+ )
+ message_filter: Literal["all", "text_only"] = Field(
+ default="all",
+ description="Filter by message type",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["chat_history"]}},
+ },
+ )
+ limit: int = Field(
+ default=50, ge=1, le=500,
+ description="Maximum number of messages (1-500)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["chat_history"]}},
+ },
+ )
+ offset: int = Field(
+ default=0, ge=0,
+ description="Number of messages to skip",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["chat_history"]}},
+ },
+ )
+
+ # ===== MEDIA DOWNLOAD (chat_history + channel_messages) =====
+ include_media_data: bool = Field(
+ default=False,
+ description="Download base64 media data (may be slow for many messages)",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "operation": ["chat_history", "channel_messages"],
+ }},
+ },
+ )
+
+ # ===== SEARCH / LIST =====
+ query: str = Field(
+ default="",
+ description="Search query (leave empty for all)",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "operation": ["search_groups", "list_contacts"],
+ }},
+ },
+ )
+
+ # ===== GET GROUP INFO =====
+ group_id_for_info: str = Field(
+ default="",
+ description="Group JID to get info for",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["get_group_info"]}},
+ },
+ )
+
+ # ===== GET CONTACT INFO =====
+ contact_phone: str = Field(
+ default="",
+ description="Phone number to get contact info for",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["get_contact_info"]}},
+ },
+ )
+
+ # ===== CHECK CONTACTS =====
+ phones: str = Field(
+ default="",
+ description="Comma-separated phone numbers to check WhatsApp registration",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["check_contacts"]}},
+ },
+ )
+
+ # ===== CHANNELS (9 operations share channel_jid) =====
+ channel_jid: str = Field(
+ default="",
+ description="Newsletter JID or invite link",
+ json_schema_extra={
+ "component": "ChannelJidSelector",
+ "displayOptions": {"show": {"operation": [
+ "get_channel_info", "channel_messages", "channel_stats",
+ "channel_follow", "channel_unfollow", "channel_mute",
+ "channel_mark_viewed", "newsletter_react", "newsletter_live_updates",
+ ]}},
+ },
+ )
+ refresh: bool = Field(
+ default=False,
+ description="Bypass 24h cache and fetch fresh data",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": [
+ "list_channels", "get_channel_info", "channel_messages",
+ ]}},
+ },
+ )
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ # ===== CHANNEL MESSAGES / STATS =====
+ channel_count: int = Field(
+ default=10, ge=1, le=100,
+ description="Number of messages to retrieve (1-100)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": [
+ "channel_messages", "channel_stats",
+ ]}},
+ },
+ )
+ before_server_id: int = Field(
+ default=0, ge=0,
+ description="Pagination: get messages before this server ID (0 = latest)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_messages"]}},
+ },
+ )
+ message_offset: int = Field(
+ default=0, ge=0,
+ description="Skip this many messages",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_messages"]}},
+ },
+ )
+ since: str = Field(
+ default="",
+ description="Unix timestamp: only messages after this time",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_messages"]}},
+ },
+ )
+ until: str = Field(
+ default="",
+ description="Unix timestamp: only messages before this time",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_messages"]}},
+ },
+ )
+ media_type: Literal["all", "image", "video", "audio", "document", "sticker"] = Field(
+ default="all",
+ description="Filter messages by media type",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_messages"]}},
+ },
+ )
+ search: str = Field(
+ default="",
+ description="Search for messages containing this text",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_messages"]}},
+ },
+ )
+
+ # ===== CHANNEL CREATE =====
+ channel_name: str = Field(
+ default="",
+ description="Name for the new channel",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_create"]}},
+ },
+ )
+ channel_description: str = Field(
+ default="",
+ description="Optional description for the new channel",
+ json_schema_extra={
+ "rows": 3,
+ "displayOptions": {"show": {"operation": ["channel_create"]}},
+ },
+ )
+ picture: str = Field(
+ default="",
+ description="Optional base64-encoded profile picture",
+ json_schema_extra={
+ "rows": 3,
+ "displayOptions": {"show": {"operation": ["channel_create"]}},
+ },
+ )
+
+ # ===== CHANNEL MUTE =====
+ mute: bool = Field(
+ default=True,
+ description="True to mute, false to unmute",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["channel_mute"]}},
+ },
+ )
+
+ # ===== MARK VIEWED / LIVE UPDATES =====
+ server_ids: str = Field(
+ default="",
+ description="Comma-separated message server IDs",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": [
+ "channel_mark_viewed", "newsletter_live_updates",
+ ]}},
+ },
+ )
+
+ # ===== NEWSLETTER REACT =====
+ react_server_id: int = Field(
+ default=0, ge=0,
+ description="Server ID of the message to react to",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["newsletter_react"]}},
+ },
+ )
+ reaction: str = Field(
+ default="",
+ description="Reaction emoji (empty to remove)",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["newsletter_react"]}},
+ },
+ )
+
+ # ===== CONTACT PROFILE PICTURE =====
+ profile_pic_jid: str = Field(
+ default="",
+ description="Contact JID or phone number",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["contact_profile_pic"]}},
+ },
+ )
+ preview: bool = Field(
+ default=False,
+ description="Low-resolution preview instead of full picture",
+ json_schema_extra={
+ "displayOptions": {"show": {"operation": ["contact_profile_pic"]}},
+ },
+ )
+
+ model_config = ConfigDict(extra="allow")
class WhatsAppDbOutput(BaseModel):
@@ -72,7 +343,7 @@ class WhatsAppDbNode(ActionNode):
from ._base import handle_whatsapp_db
response = await handle_whatsapp_db(
node_id=ctx.node_id, node_type=self.type,
- parameters=params.model_dump(by_alias=True), context=ctx.raw,
+ parameters=params.model_dump(), context=ctx.raw,
)
if response.get("success"):
return response.get("result") or response
diff --git a/server/nodes/whatsapp/whatsapp_receive.py b/server/nodes/whatsapp/whatsapp_receive.py
index d28712e4..67b1f1c2 100644
--- a/server/nodes/whatsapp/whatsapp_receive.py
+++ b/server/nodes/whatsapp/whatsapp_receive.py
@@ -15,22 +15,65 @@ from services.plugin import NodeContext, Operation, TaskQueue, TriggerNode
class WhatsAppReceiveParams(BaseModel):
+ """Snake_case field names throughout; JSON Schema keys match field
+ names exactly (no aliases). ``displayOptions.show`` references are
+ guaranteed consistent with the driver field's JSON key.
+ """
+
message_type_filter: Literal[
"all", "text", "image", "video", "audio",
"document", "location", "contact",
- ] = Field(default="all", alias="messageTypeFilter")
- filter: Literal["all", "any_contact", "contact", "group", "channel", "keywords"] = "all"
- phone_number: str = Field(default="", alias="phoneNumber")
- group_id: str = Field(default="", alias="groupId")
- channel_jid: str = Field(default="", alias="channelJid")
- keywords: str = Field(default="")
- forwarded_filter: Literal["all", "only_forwarded", "ignore_forwarded"] = Field(
- default="all", alias="forwardedFilter",
+ ] = Field(default="all")
+ filter: Literal[
+ "all", "self", "any_contact", "contact", "group", "channel", "keywords",
+ ] = "all"
+ phone_number: str = Field(
+ default="",
+ description="Contact phone (digits only, no + prefix)",
+ json_schema_extra={"displayOptions": {"show": {"filter": ["contact"]}}},
+ )
+ group_id: str = Field(
+ default="",
+ description="WhatsApp group JID",
+ json_schema_extra={
+ "component": "GroupIdSelector",
+ "displayOptions": {"show": {"filter": ["group"]}},
+ },
+ )
+ sender_number: str = Field(
+ default="",
+ description="Optional: filter group messages to a specific member",
+ json_schema_extra={
+ "component": "SenderNumberSelector",
+ "dependsOn": "group_id",
+ "displayOptions": {"show": {"filter": ["group"]}},
+ },
+ )
+ channel_jid: str = Field(
+ default="",
+ description="Newsletter channel JID",
+ json_schema_extra={
+ "component": "ChannelJidSelector",
+ "displayOptions": {"show": {"filter": ["channel"]}},
+ },
+ )
+ keywords: str = Field(
+ default="",
+ description="Comma-separated keywords (case-insensitive)",
+ json_schema_extra={"displayOptions": {"show": {"filter": ["keywords"]}}},
+ )
+ forwarded_filter: Literal["all", "only_forwarded", "ignore_forwarded"] = Field(default="all")
+ ignore_own_messages: bool = Field(
+ default=True,
+ json_schema_extra={
+ "displayOptions": {"show": {"filter": [
+ "all", "any_contact", "contact", "group", "channel", "keywords",
+ ]}},
+ },
)
- ignore_own_messages: bool = Field(default=True, alias="ignoreOwnMessages")
- include_media_data: bool = Field(default=False, alias="includeMediaData")
+ include_media_data: bool = Field(default=False)
- model_config = ConfigDict(populate_by_name=True, extra="ignore")
+ model_config = ConfigDict(extra="ignore")
class WhatsAppReceiveOutput(BaseModel):
@@ -71,7 +114,7 @@ class WhatsAppReceiveNode(TriggerNode):
def build_filter(self, params: WhatsAppReceiveParams) -> Callable[[Dict[str, Any]], bool]:
from services.event_waiter import build_whatsapp_filter
- return build_whatsapp_filter(params.model_dump(by_alias=True)) # camelCase — matches filter builder
+ return build_whatsapp_filter(params.model_dump())
@Operation("wait")
async def wait(self, ctx: NodeContext, params: WhatsAppReceiveParams) -> WhatsAppReceiveOutput:
diff --git a/server/nodes/whatsapp/whatsapp_send.py b/server/nodes/whatsapp/whatsapp_send.py
index 5be78035..67d289aa 100644
--- a/server/nodes/whatsapp/whatsapp_send.py
+++ b/server/nodes/whatsapp/whatsapp_send.py
@@ -16,26 +16,217 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class WhatsAppSendParams(BaseModel):
+ """Full 24-field schema matching main-branch baseline. Heavy
+ ``displayOptions`` cascading keyed off ``recipient_type`` (4 branches),
+ ``message_type`` (8 branches), ``media_source`` (3 branches),
+ and ``is_reply`` (2 branches).
+ """
+
+ # ===== RECIPIENT =====
recipient_type: Literal["self", "phone", "group", "channel"] = Field(
- default="phone", alias="recipientType",
+ default="self",
+ description="Send to self (connected phone), individual, group, or channel",
+ )
+ phone: str = Field(
+ default="",
+ description="Recipient phone number (without + prefix)",
+ json_schema_extra={
+ "displayOptions": {"show": {"recipient_type": ["phone"]}},
+ },
+ )
+ group_id: str = Field(
+ default="",
+ description="Group JID (format: [email protected]). Use Load button to select.",
+ json_schema_extra={
+ "component": "GroupIdSelector",
+ "displayOptions": {"show": {"recipient_type": ["group"]}},
+ },
+ )
+ channel_jid: str = Field(
+ default="",
+ description=(
+ "Newsletter channel JID (format: 120363...@newsletter). "
+ "Admin/owner role required to send."
+ ),
+ json_schema_extra={
+ "component": "ChannelJidSelector",
+ "displayOptions": {"show": {"recipient_type": ["channel"]}},
+ },
)
- phone_number: str = Field(default="", alias="phoneNumber")
- group_id: str = Field(default="", alias="groupId")
- channel_jid: str = Field(default="", alias="channelJid")
+
+ # ===== MESSAGE TYPE =====
message_type: Literal[
"text", "image", "video", "audio", "document",
"sticker", "location", "contact",
- ] = Field(default="text", alias="messageType")
- text: str = Field(default="")
- media_url: str = Field(default="", alias="mediaUrl")
- caption: str = Field(default="")
- latitude: Optional[float] = None
- longitude: Optional[float] = None
- contact_name: str = Field(default="", alias="contactName")
- contact_phone: str = Field(default="", alias="contactPhone")
- format_markdown: bool = Field(default=True, alias="formatMarkdown")
-
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ ] = Field(
+ default="text",
+ description=(
+ "Type of message. Channels only support: text, image, video, audio, document."
+ ),
+ )
+
+ # ===== TEXT =====
+ message: str = Field(
+ default="",
+ description="Text message content",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
+ )
+ format_markdown: bool = Field(
+ default=True,
+ description=(
+ "Convert LLM markdown (bold, italic, code, lists) to WhatsApp-native formatting"
+ ),
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["text"]}},
+ },
+ )
+
+ # ===== MEDIA (image / video / audio / document / sticker) =====
+ media_source: Literal["base64", "file", "url"] = Field(
+ default="base64",
+ description="Source of media data",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": [
+ "image", "video", "audio", "document", "sticker",
+ ]}},
+ },
+ )
+ media_data: str = Field(
+ default="",
+ description="Base64-encoded media data",
+ json_schema_extra={
+ "rows": 3,
+ "displayOptions": {"show": {
+ "message_type": ["image", "video", "audio", "document", "sticker"],
+ "media_source": ["base64"],
+ }},
+ },
+ )
+ file_path: str = Field(
+ default="",
+ description="Server file path or uploaded filename",
+ json_schema_extra={
+ "widget": "file",
+ "accept": "*/*",
+ "displayOptions": {"show": {
+ "message_type": ["image", "video", "audio", "document", "sticker"],
+ "media_source": ["file"],
+ }},
+ },
+ )
+ media_url: str = Field(
+ default="",
+ description="HTTPS URL to download media from",
+ json_schema_extra={
+ "displayOptions": {"show": {
+ "message_type": ["image", "video", "audio", "document", "sticker"],
+ "media_source": ["url"],
+ }},
+ },
+ )
+ mime_type: str = Field(
+ default="",
+ description="MIME type (auto-detected if empty). e.g. image/jpeg, video/mp4",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": [
+ "image", "video", "audio", "document", "sticker",
+ ]}},
+ },
+ )
+ caption: str = Field(
+ default="",
+ description="Optional caption for media",
+ json_schema_extra={
+ "rows": 2,
+ "displayOptions": {"show": {"message_type": ["image", "video", "document"]}},
+ },
+ )
+ filename: str = Field(
+ default="",
+ description="Document filename (e.g. document.pdf)",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["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"]}},
+ },
+ )
+ location_name: str = Field(
+ default="",
+ description="Display name for location (e.g. 'San Francisco')",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
+ )
+ address: str = Field(
+ default="",
+ description="Address text (e.g. 'California, USA')",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["location"]}},
+ },
+ )
+
+ # ===== CONTACT =====
+ contact_name: str = Field(
+ default="",
+ description="Display name for contact",
+ json_schema_extra={
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
+ )
+ vcard: str = Field(
+ default="",
+ description="vCard 3.0 format string",
+ json_schema_extra={
+ "rows": 4,
+ "displayOptions": {"show": {"message_type": ["contact"]}},
+ },
+ )
+
+ # ===== REPLY / QUOTE =====
+ is_reply: bool = Field(
+ default=False,
+ description="Quote an existing message",
+ )
+ reply_message_id: str = Field(
+ default="",
+ description="ID of message to quote",
+ json_schema_extra={
+ "displayOptions": {"show": {"is_reply": [True]}},
+ },
+ )
+ reply_sender: str = Field(
+ default="",
+ description="Sender JID of quoted message",
+ json_schema_extra={
+ "displayOptions": {"show": {"is_reply": [True]}},
+ },
+ )
+ reply_content: str = Field(
+ default="",
+ description="Text preview of quoted message",
+ json_schema_extra={
+ "displayOptions": {"show": {"is_reply": [True]}},
+ },
+ )
+
+ model_config = ConfigDict(extra="allow")
class WhatsAppSendOutput(BaseModel):
diff --git a/server/nodes/workflow/start.py b/server/nodes/workflow/start.py
index 49415207..690a6a60 100644
--- a/server/nodes/workflow/start.py
+++ b/server/nodes/workflow/start.py
@@ -16,9 +16,9 @@ from services.plugin import ActionNode, NodeContext, Operation, TaskQueue
class StartParams(BaseModel):
- initial_data: Any = Field(default=None, alias="initialData")
+ initial_data: Any = Field(default=None)
- model_config = ConfigDict(populate_by_name=True, extra="allow")
+ model_config = ConfigDict(extra="allow")
class StartOutput(BaseModel):
diff --git a/server/tests/nodes/test_ai_agents.py b/server/tests/nodes/test_ai_agents.py
index e9eccd06..8f2cdf1b 100644
--- a/server/tests/nodes/test_ai_agents.py
+++ b/server/tests/nodes/test_ai_agents.py
@@ -439,7 +439,7 @@ class TestSimpleMemory:
async def test_happy_path_empty_session(self, harness, _reset_memory_store):
result = await harness.execute(
"simpleMemory",
- {"sessionId": "sess-a", "memoryType": "buffer"},
+ {"session_id": "sess-a", "memory_type": "buffer"},
)
harness.assert_envelope(result, success=True)
@@ -458,7 +458,7 @@ class TestSimpleMemory:
result = await harness.execute(
"simpleMemory",
- {"sessionId": "sess-b", "memoryType": "window", "windowSize": 2},
+ {"session_id": "sess-b", "memory_type": "window", "window_size": 2},
)
harness.assert_envelope(result, success=True)
@@ -477,7 +477,7 @@ class TestSimpleMemory:
result = await harness.execute(
"simpleMemory",
- {"sessionId": "sess-c", "clearOnRun": True},
+ {"session_id": "sess-c", "clear_on_run": True},
)
harness.assert_envelope(result, success=True)
diff --git a/server/tests/nodes/test_ai_chat_models.py b/server/tests/nodes/test_ai_chat_models.py
index a1784278..267774ec 100644
--- a/server/tests/nodes/test_ai_chat_models.py
+++ b/server/tests/nodes/test_ai_chat_models.py
@@ -116,9 +116,9 @@ class TestAllChatModelsHappyPath:
f"expected get_api_key({provider}, ...) for {node_type}, got {calls}"
)
- # Plugin dumps params with by_alias=True so snake_case api_key is emitted as apiKey
+ # Plugin Params use snake_case throughout; model_dump() preserves field names.
params = harness.ai_service.execute_chat.await_args.args[2]
- assert params.get("apiKey") == "test-api-key"
+ assert params.get("api_key") == "test-api-key"
@pytest.mark.parametrize("node_type,provider", ALL_PROVIDERS)
async def test_error_envelope_propagates(self, harness, node_type, provider):
@@ -158,18 +158,18 @@ class TestThinkingParamForwarding:
node_type,
{
"prompt": "hi",
- "thinkingEnabled": True,
- "thinkingBudget": 4096,
- "reasoningEffort": "high",
- "reasoningFormat": "parsed",
+ "thinking_enabled": True,
+ "thinking_budget": 4096,
+ "reasoning_effort": "high",
+ "reasoning_format": "parsed",
},
)
params = harness.ai_service.execute_chat.await_args.args[2]
- assert params["thinkingEnabled"] is True
- assert params["thinkingBudget"] == 4096
- assert params["reasoningEffort"] == "high"
- assert params["reasoningFormat"] == "parsed"
+ assert params["thinking_enabled"] is True
+ assert params["thinking_budget"] == 4096
+ assert params["reasoning_effort"] == "high"
+ assert params["reasoning_format"] == "parsed"
@pytest.mark.parametrize("node_type,provider", ALL_PROVIDERS)
async def test_system_message_forwarded(self, harness, node_type, provider):
@@ -177,12 +177,12 @@ class TestThinkingParamForwarding:
await harness.execute(
node_type,
- {"prompt": "hi", "systemMessage": "You are terse."},
+ {"prompt": "hi", "system_prompt": "You are terse."},
)
params = harness.ai_service.execute_chat.await_args.args[2]
- # Handler does not normalize - raw param key reaches execute_chat
- assert params["systemMessage"] == "You are terse."
+ # Plugin Params field is system_prompt; model_dump preserves the name.
+ assert params["system_prompt"] == "You are terse."
# ============================================================================
@@ -254,11 +254,11 @@ class TestKimiThinkingDefault:
await harness.execute(
"kimiChatModel",
- {"prompt": "hi", "thinkingEnabled": False},
+ {"prompt": "hi", "thinking_enabled": False},
)
params = harness.ai_service.execute_chat.await_args.args[2]
- assert params["thinkingEnabled"] is False
+ assert params["thinking_enabled"] is False
class TestGroqReasoningFormat:
@@ -273,13 +273,13 @@ class TestGroqReasoningFormat:
{
"prompt": "hi",
"model": "qwen/qwen3-32b",
- "thinkingEnabled": True,
- "reasoningFormat": "hidden",
+ "thinking_enabled": True,
+ "reasoning_format": "hidden",
},
)
params = harness.ai_service.execute_chat.await_args.args[2]
- assert params["reasoningFormat"] == "hidden"
+ assert params["reasoning_format"] == "hidden"
assert params["model"] == "qwen/qwen3-32b"
@@ -321,14 +321,14 @@ class TestMistralNoThinking:
{
"prompt": "hi",
"model": "mistral-large-latest",
- "thinkingEnabled": True, # User tries to enable
+ "thinking_enabled": True, # User tries to enable
},
)
harness.assert_envelope(result, success=True)
# Handler forwarded the user's flag
params = harness.ai_service.execute_chat.await_args.args[2]
- assert params["thinkingEnabled"] is True
+ assert params["thinking_enabled"] is True
# But envelope reflects Mistral's lack of support
assert result["result"]["thinking"] is None
assert result["result"]["thinking_enabled"] is False
diff --git a/server/tests/nodes/test_chat_utility.py b/server/tests/nodes/test_chat_utility.py
index 1673c046..30993ede 100644
--- a/server/tests/nodes/test_chat_utility.py
+++ b/server/tests/nodes/test_chat_utility.py
@@ -46,8 +46,8 @@ class TestChatSend:
{
"host": "chat.local",
"port": 9000,
- "sessionId": "s1",
- "apiKey": "tk",
+ "session_id": "s1",
+ "api_key": "tk",
"content": "hello there",
},
)
@@ -109,7 +109,7 @@ class TestChatHistory:
) as fetch:
result = await harness.execute(
"chatHistory",
- {"host": "chat.local", "port": 9000, "sessionId": "s1", "limit": 10},
+ {"host": "chat.local", "port": 9000, "session_id": "s1", "limit": 10},
)
harness.assert_envelope(result, success=True)
@@ -171,7 +171,7 @@ class TestConsole:
with patched_broadcaster() as broadcaster:
result = await harness.execute(
"console",
- {"label": "dbg", "logMode": "all", "format": "json"},
+ {"label": "dbg", "log_mode": "all", "format": "json"},
node_id="console-1",
nodes=nodes,
edges=edges,
@@ -218,7 +218,7 @@ class TestConsole:
with patched_broadcaster():
result = await harness.execute(
"console",
- {"logMode": "field", "fieldPath": "data.items[1].name", "format": "text"},
+ {"log_mode": "field", "field_path": "data.items[1].name", "format": "text"},
node_id="console-2",
nodes=nodes,
edges=edges,
@@ -232,7 +232,7 @@ class TestConsole:
with patched_broadcaster() as broadcaster:
result = await harness.execute(
"console",
- {"logMode": "all", "format": "json"},
+ {"log_mode": "all", "format": "json"},
)
harness.assert_envelope(result, success=True)
assert result["result"]["data"] == {}
@@ -277,7 +277,7 @@ class TestTeamMonitor:
):
result = await harness.execute(
"teamMonitor",
- {"maxHistoryItems": 2},
+ {"max_history_items": 2},
context=ctx,
)
diff --git a/server/tests/nodes/test_document.py b/server/tests/nodes/test_document.py
index e077d482..7ed2136a 100644
--- a/server/tests/nodes/test_document.py
+++ b/server/tests/nodes/test_document.py
@@ -52,7 +52,7 @@ class TestHttpScraper:
result = await harness.execute(
"httpScraper",
- {"url": "https://example.com/list", "linkSelector": 'a[href$=".pdf"]'},
+ {"url": "https://example.com/list", "link_selector": 'a[href$=".pdf"]'},
)
harness.assert_envelope(result, success=True)
@@ -84,10 +84,10 @@ class TestHttpScraper:
"httpScraper",
{
"url": "https://example.com/p{page}",
- "iterationMode": "page",
- "startPage": 1,
- "endPage": 2,
- "linkSelector": "a",
+ "iteration_mode": "page",
+ "start_page": 1,
+ "end_page": 2,
+ "link_selector": "a",
},
)
@@ -108,10 +108,10 @@ class TestHttpScraper:
"httpScraper",
{
"url": "https://example.com/?d={date}",
- "iterationMode": "date",
- "startDate": "2025-01-01",
- "endDate": "2025-01-03",
- "linkSelector": "a",
+ "iteration_mode": "date",
+ "start_date": "2025-01-01",
+ "end_date": "2025-01-03",
+ "link_selector": "a",
},
)
@@ -227,7 +227,7 @@ class TestDocumentParser:
result = await harness.execute(
"documentParser",
- {"files": [{"path": str(f)}], "parser": "beautifulsoup"},
+ {"file_path": str(f), "parser": "beautifulsoup"},
)
harness.assert_envelope(result, success=True)
@@ -277,7 +277,7 @@ class TestDocumentParser:
with patch.dict(sys.modules, {"pypdf": fake_pypdf}):
result = await harness.execute(
"documentParser",
- {"files": [{"path": str(f)}], "parser": "pypdf"},
+ {"file_path": str(f), "parser": "pypdf"},
)
harness.assert_envelope(result, success=True)
@@ -298,8 +298,8 @@ class TestTextChunker:
"textChunker",
{
"documents": [{"content": content, "source": "src1"}],
- "chunkSize": 500,
- "chunkOverlap": 50,
+ "chunk_size": 500,
+ "chunk_overlap": 50,
"strategy": "recursive",
},
)
@@ -327,8 +327,8 @@ class TestTextChunker:
{"content": "", "source": "empty"},
{"content": "short text", "source": "s2"},
],
- "chunkSize": 1024,
- "chunkOverlap": 100,
+ "chunk_size": 1024,
+ "chunk_overlap": 100,
},
)
harness.assert_envelope(result, success=True)
@@ -343,8 +343,8 @@ class TestTextChunker:
"textChunker",
{
"documents": [{"content": md, "source": "md1"}],
- "chunkSize": 200,
- "chunkOverlap": 20,
+ "chunk_size": 200,
+ "chunk_overlap": 20,
"strategy": "markdown",
},
)
@@ -427,7 +427,7 @@ class TestEmbeddingGenerator:
"chunks": [{"content": "only"}],
"provider": "openai",
"model": "text-embedding-3-small",
- "apiKey": "sk-test",
+ "api_key": "sk-test",
},
)
@@ -489,13 +489,13 @@ class TestVectorStore:
{
"operation": "store",
"backend": "chroma",
- "collectionName": "docs",
+ "collection_name": "docs",
"embeddings": [[0.1, 0.2], [0.3, 0.4]],
"chunks": [
{"content": "c1", "source": "s1", "chunk_index": 0},
{"content": "c2", "source": "s1", "chunk_index": 1},
],
- "persistDir": str(tmp_path),
+ "persist_dir": str(tmp_path),
},
)
@@ -520,7 +520,7 @@ class TestVectorStore:
"backend": "chroma",
"embeddings": [],
"chunks": [],
- "persistDir": str(tmp_path),
+ "persist_dir": str(tmp_path),
},
)
harness.assert_envelope(result, success=True)
@@ -536,10 +536,10 @@ class TestVectorStore:
{
"operation": "query",
"backend": "chroma",
- "collectionName": "docs",
- "queryEmbedding": [0.1, 0.2],
- "topK": 2,
- "persistDir": str(tmp_path),
+ "collection_name": "docs",
+ "query_embedding": [0.1, 0.2],
+ "top_k": 2,
+ "persist_dir": str(tmp_path),
},
)
@@ -560,7 +560,7 @@ class TestVectorStore:
"operation": "delete",
"backend": "chroma",
"ids": ["id-a", "id-b", "id-c"],
- "persistDir": str(tmp_path),
+ "persist_dir": str(tmp_path),
},
)
diff --git a/server/tests/nodes/test_http_proxy.py b/server/tests/nodes/test_http_proxy.py
index 012f9563..0517ca02 100644
--- a/server/tests/nodes/test_http_proxy.py
+++ b/server/tests/nodes/test_http_proxy.py
@@ -126,7 +126,7 @@ class TestHttpRequest:
with patch("services.proxy.service.get_proxy_service", return_value=proxy_svc):
result = await harness.execute(
"httpRequest",
- {"method": "GET", "url": self.URL, "useProxy": True, "proxyCountry": "US"},
+ {"method": "GET", "url": self.URL, "use_proxy": True, "proxy_country": "US"},
)
harness.assert_envelope(result, success=True)
@@ -135,7 +135,7 @@ class TestHttpRequest:
proxy_svc.get_proxy_url.assert_awaited_once()
call_args = proxy_svc.get_proxy_url.await_args
assert call_args.args[0] == self.URL
- assert call_args.args[1]["proxyCountry"] == "US"
+ assert call_args.args[1]["proxy_country"] == "US"
@respx.mock
async def test_use_proxy_swallows_proxy_error_and_proceeds(self, harness):
@@ -148,7 +148,7 @@ class TestHttpRequest:
with patch("services.proxy.service.get_proxy_service", return_value=proxy_svc):
result = await harness.execute(
"httpRequest",
- {"method": "GET", "url": self.URL, "useProxy": True},
+ {"method": "GET", "url": self.URL, "use_proxy": True},
)
harness.assert_envelope(result, success=True)
@@ -179,8 +179,8 @@ class TestProxyRequest:
{
"method": "GET",
"url": self.URL,
- "proxyProvider": "smart_proxy",
- "proxyCountry": "US",
+ "proxy_provider": "smart_proxy",
+ "proxy_country": "US",
},
)
@@ -264,9 +264,9 @@ class TestProxyRequest:
{
"method": "GET",
"url": self.URL,
- "proxyProvider": "p1",
- "maxRetries": 2,
- "proxyFailover": True,
+ "proxy_provider": "p1",
+ "max_retries": 2,
+ "proxy_failover": True,
},
)
diff --git a/server/tests/nodes/test_search.py b/server/tests/nodes/test_search.py
index f2f59660..d2a72319 100644
--- a/server/tests/nodes/test_search.py
+++ b/server/tests/nodes/test_search.py
@@ -55,7 +55,7 @@ class TestBraveSearch:
with patched_container(auth_api_keys={"brave_search": "tk_brave"}), patched_pricing():
result = await harness.execute(
"braveSearch",
- {"query": "hello world", "maxResults": 2, "country": "US"},
+ {"query": "hello world", "max_results": 2, "country": "US"},
)
harness.assert_envelope(result, success=True)
@@ -108,7 +108,7 @@ class TestBraveSearch:
respx.get(self.URL).mock(return_value=httpx.Response(200, json={"web": {"results": []}}))
with patched_container(auth_api_keys={"brave_search": "tk"}), patched_pricing():
- result = await harness.execute("braveSearch", {"query": "x", "maxResults": 500})
+ result = await harness.execute("braveSearch", {"query": "x", "max_results": 500})
# Post-refactor: Params tightens max_results with le=20 upper bound; 500 is rejected at validation.
harness.assert_envelope(result, success=False)
@@ -145,7 +145,7 @@ class TestSerperSearch:
with patched_container(auth_api_keys={"serper": "tk_serp"}), patched_pricing():
result = await harness.execute(
"serperSearch",
- {"query": "best pizza", "searchType": "search", "country": "us"},
+ {"query": "best pizza", "search_type": "search", "country": "us"},
)
harness.assert_envelope(result, success=True)
@@ -183,7 +183,7 @@ class TestSerperSearch:
)
with patched_container(auth_api_keys={"serper": "tk"}), patched_pricing():
- result = await harness.execute("serperSearch", {"query": "ai", "searchType": "news"})
+ result = await harness.execute("serperSearch", {"query": "ai", "search_type": "news"})
harness.assert_envelope(result, success=True)
assert result["result"]["search_type"] == "news"
@@ -201,7 +201,7 @@ class TestSerperSearch:
with patched_container(auth_api_keys={"serper": "tk"}), patched_pricing():
result = await harness.execute(
- "serperSearch", {"query": "x", "searchType": "nonsense"}
+ "serperSearch", {"query": "x", "search_type": "nonsense"}
)
harness.assert_envelope(result, success=False)
@@ -252,9 +252,9 @@ class TestPerplexitySearch:
{
"query": "what is rust",
"model": "sonar-pro",
- "searchRecencyFilter": "week",
- "returnImages": True,
- "returnRelatedQuestions": True,
+ "search_recency_filter": "week",
+ "return_images": True,
+ "return_related_questions": True,
},
)
diff --git a/server/tests/nodes/test_specialized_agents.py b/server/tests/nodes/test_specialized_agents.py
index 730ea0e4..a1d5d7c1 100644
--- a/server/tests/nodes/test_specialized_agents.py
+++ b/server/tests/nodes/test_specialized_agents.py
@@ -487,8 +487,8 @@ class TestClaudeCodeAgent:
{
"prompt": "write a hello world script",
"model": "claude-sonnet-4-6",
- "maxTurns": 5,
- "maxBudgetUsd": 2.0,
+ "max_turns": 5,
+ "max_budget_usd": 2.0,
},
)
@@ -517,7 +517,7 @@ class TestClaudeCodeAgent:
):
await harness.execute(
"claude_code_agent",
- {"prompt": "x", "maxBudgetUsd": 7.5},
+ {"prompt": "x", "max_budget_usd": 7.5},
)
call = service.execute.await_args
diff --git a/server/tests/nodes/test_telegram_social.py b/server/tests/nodes/test_telegram_social.py
index 3096a3b9..7150ed46 100644
--- a/server/tests/nodes/test_telegram_social.py
+++ b/server/tests/nodes/test_telegram_social.py
@@ -294,7 +294,7 @@ class TestTelegramReceive:
):
result = await harness.execute(
"telegramReceive",
- {"senderFilter": "all", "contentTypeFilter": "all"},
+ {"sender_filter": "all", "content_type_filter": "all"},
)
harness.assert_envelope(result, success=True)
@@ -312,7 +312,7 @@ class TestTelegramReceive:
):
result = await harness.execute(
"telegramReceive",
- {"senderFilter": "all"},
+ {"sender_filter": "all"},
)
harness.assert_envelope(result, success=False)
@@ -331,7 +331,7 @@ class TestTelegramReceive:
):
result = await harness.execute(
"telegramReceive",
- {"senderFilter": "all"},
+ {"sender_filter": "all"},
)
harness.assert_envelope(result, success=False)
@@ -354,9 +354,9 @@ class TestSocialSend:
"socialSend",
{
"channel": "whatsapp",
- "recipientType": "phone",
+ "recipient_type": "phone",
"phone": "+15551234567",
- "messageType": "text",
+ "message_type": "text",
"message": "hi there",
},
)
@@ -384,8 +384,8 @@ class TestSocialSend:
"socialSend",
{
"channel": "whatsapp",
- "recipientType": "phone",
- "messageType": "text",
+ "recipient_type": "phone",
+ "message_type": "text",
"message": "x",
},
)
@@ -403,15 +403,15 @@ class TestSocialSend:
"socialSend",
{
"channel": "discord",
- "recipientType": "user",
- "userId": "u1",
- "messageType": "text",
+ "recipient_type": "phone",
+ "phone": "+15551234567",
+ "message_type": "text",
"message": "hi",
},
)
harness.assert_envelope(result, success=False)
- assert "discord" in result["error"].lower() or "not yet implemented" in result["error"].lower()
+ assert "discord" in result["error"].lower() or "not yet implemented" in result["error"].lower() or "not supported" in result["error"].lower()
whatsapp_send.assert_not_awaited()
async def test_whatsapp_failure_becomes_error_envelope(self, harness):
@@ -424,9 +424,9 @@ class TestSocialSend:
"socialSend",
{
"channel": "whatsapp",
- "recipientType": "phone",
+ "recipient_type": "phone",
"phone": "+15551234567",
- "messageType": "text",
+ "message_type": "text",
"message": "x",
},
)
@@ -471,7 +471,7 @@ class TestSocialReceive:
result = await harness.execute(
"socialReceive",
- {"channelFilter": "all", "senderFilter": "all"},
+ {"channel_filter": "all", "sender_filter": "all"},
node_id="tgt_social",
nodes=nodes,
edges=edges,
@@ -536,8 +536,8 @@ class TestSocialReceive:
result = await harness.execute(
"socialReceive",
{
- "channelFilter": "all",
- "senderFilter": "keywords",
+ "channel_filter": "all",
+ "sender_filter": "keywords",
"keywords": "hello,hi",
},
node_id="tgt_social",
@@ -578,7 +578,7 @@ class TestSocialReceive:
result = await harness.execute(
"socialReceive",
- {"senderFilter": "all"}, # ignoreOwnMessages default true
+ {"sender_filter": "all"}, # ignoreOwnMessages default true
node_id="tgt_social",
nodes=nodes,
edges=edges,
diff --git a/server/tests/nodes/test_twitter.py b/server/tests/nodes/test_twitter.py
index b6351fc6..1bc4c036 100644
--- a/server/tests/nodes/test_twitter.py
+++ b/server/tests/nodes/test_twitter.py
@@ -148,7 +148,7 @@ class TestTwitterSend:
{
"action": "reply",
"text": "replying",
- "reply_to_id": "1234567890",
+ "tweet_id": "1234567890",
},
)
@@ -172,7 +172,7 @@ class TestTwitterSend:
)
harness.assert_envelope(result, success=False)
- assert "reply_to_id" in result["error"].lower()
+ assert "tweet_id" in result["error"].lower()
posts.create.assert_not_called()
async def test_tweet_empty_text_errors(self, harness):
@@ -190,14 +190,14 @@ class TestTwitterSend:
assert "text is required" in result["error"].lower()
async def test_unknown_action_errors(self, harness):
- # 'quote' is exposed in the frontend but not implemented in the handler.
+ # Post-refactor: action is a Literal; unknown values rejected by Pydantic.
stub_cls = _make_client_class()
with _patch_client(stub_cls), patched_container(
auth_oauth_tokens=_ok_tokens()
), patched_pricing():
result = await harness.execute(
- "twitterSend", {"action": "quote", "text": "x", "tweet_id": "1"}
+ "twitterSend", {"action": "mysterious", "text": "x", "tweet_id": "1"}
)
harness.assert_envelope(result, success=False)
diff --git a/server/tests/nodes/test_web_automation.py b/server/tests/nodes/test_web_automation.py
index c408f5bb..5240722a 100644
--- a/server/tests/nodes/test_web_automation.py
+++ b/server/tests/nodes/test_web_automation.py
@@ -109,10 +109,10 @@ class TestBrowser:
"browser",
{
"operation": "screenshot",
- "fullPage": True,
+ "full_page": True,
"annotate": True,
- "screenshotFormat": "jpeg",
- "screenshotQuality": 80,
+ "screenshot_format": "jpeg",
+ "screenshot_quality": 80,
},
)
@@ -212,7 +212,7 @@ class TestCrawleeScraper:
"crawleeScraper",
{
"url": "https://example.com",
- "crawlerType": "beautifulsoup",
+ "crawler_type": "beautifulsoup",
"mode": "single",
},
)
@@ -233,7 +233,7 @@ class TestCrawleeScraper:
async def test_missing_url_returns_validation_error(self, harness):
result = await harness.execute(
- "crawleeScraper", {"url": "", "crawlerType": "beautifulsoup"}
+ "crawleeScraper", {"url": "", "crawler_type": "beautifulsoup"}
)
harness.assert_envelope(result, success=False)
@@ -243,7 +243,7 @@ class TestCrawleeScraper:
# Handler does not attempt any import for unknown crawler types.
result = await harness.execute(
"crawleeScraper",
- {"url": "https://x.test", "crawlerType": "teleportron"},
+ {"url": "https://x.test", "crawler_type": "teleportron"},
)
harness.assert_envelope(result, success=False)
@@ -259,7 +259,7 @@ class TestCrawleeScraper:
):
result = await harness.execute(
"crawleeScraper",
- {"url": "https://x.test", "crawlerType": "beautifulsoup"},
+ {"url": "https://x.test", "crawler_type": "beautifulsoup"},
)
harness.assert_envelope(result, success=False)
@@ -280,7 +280,7 @@ class TestCrawleeScraper:
):
result = await harness.execute(
"crawleeScraper",
- {"url": "https://x.test", "crawlerType": "beautifulsoup"},
+ {"url": "https://x.test", "crawler_type": "beautifulsoup"},
)
harness.assert_envelope(result, success=False)
@@ -336,9 +336,9 @@ class TestApifyActor:
result = await harness.execute(
"apifyActor",
{
- "actorId": "apify/instagram-scraper",
- "instagramUrls": "https://instagram.com/a, https://instagram.com/b",
- "maxResults": 50,
+ "actor_id": "apify/instagram-scraper",
+ "instagram_urls": "https://instagram.com/a, https://instagram.com/b",
+ "max_results": 50,
},
)
@@ -382,7 +382,7 @@ class TestApifyActor:
with patched_container(auth_api_keys={}):
result = await harness.execute(
"apifyActor",
- {"actorId": "apify/instagram-scraper"},
+ {"actor_id": "apify/instagram-scraper"},
)
harness.assert_envelope(result, success=False)
@@ -394,10 +394,10 @@ class TestApifyActor:
with patched_container(auth_api_keys={"apify": "tk"}), patch(
"apify_client.ApifyClientAsync", return_value=fake_client
):
- result = await harness.execute("apifyActor", {"actorId": ""})
+ result = await harness.execute("apifyActor", {"actor_id": ""})
harness.assert_envelope(result, success=False)
- assert "actor id is required" in result["error"].lower()
+ assert "invalid parameters" in result["error"].lower()
async def test_failed_run_status_returns_error_envelope(self, harness):
run_info = {
@@ -412,7 +412,7 @@ class TestApifyActor:
"apify_client.ApifyClientAsync", return_value=fake_client
):
result = await harness.execute(
- "apifyActor", {"actorId": "apify/some-actor"}
+ "apifyActor", {"actor_id": "apify/instagram-scraper"}
)
harness.assert_envelope(result, success=False)
@@ -427,7 +427,7 @@ class TestApifyActor:
"apify_client.ApifyClientAsync", return_value=fake_client
):
result = await harness.execute(
- "apifyActor", {"actorId": "apify/some-actor"}
+ "apifyActor", {"actor_id": "apify/instagram-scraper"}
)
harness.assert_envelope(result, success=False)
@@ -450,7 +450,7 @@ class TestApifyActor:
result = await harness.execute(
"apifyActor",
{
- "actorId": "apify/some-actor",
+ "actor_id": "apify/instagram-scraper",
"actorInput": "{ this is not json",
},
)
diff --git a/server/tests/nodes/test_workflow_triggers.py b/server/tests/nodes/test_workflow_triggers.py
index 4a8cf9bf..34a3af02 100644
--- a/server/tests/nodes/test_workflow_triggers.py
+++ b/server/tests/nodes/test_workflow_triggers.py
@@ -89,7 +89,7 @@ def patched_trigger_waiter(
class TestStart:
async def test_happy_path_returns_parsed_initial_data(self, harness):
result = await harness.execute(
- "start", {"initialData": '{"message": "hi", "n": 7}'}
+ "start", {"initial_data": '{"message": "hi", "n": 7}'}
)
harness.assert_envelope(result, success=True)
payload = result["result"]
@@ -97,7 +97,7 @@ class TestStart:
async def test_invalid_json_silently_becomes_empty_dict(self, harness):
# Documented behaviour: invalid JSON -> {} with success=True.
- result = await harness.execute("start", {"initialData": "not json"})
+ result = await harness.execute("start", {"initial_data": "not json"})
harness.assert_envelope(result, success=True)
assert result["result"] == {}
@@ -203,21 +203,14 @@ class TestCronScheduler:
assert "will repeat" in payload["message"]
sleep_mock.assert_awaited_once()
- async def test_unknown_frequency_uses_default_wait_and_unknown_schedule(
- self, harness
- ):
- # Documented gotcha: unknown frequency -> 300s wait, "Unknown schedule".
- with patched_broadcaster(), patch(
- "asyncio.sleep", new=AsyncMock()
- ) as sleep_mock:
+ async def test_unknown_frequency_rejected(self, harness):
+ # Post-refactor: frequency is a Literal; unknown value rejected at Params level.
+ with patched_broadcaster():
result = await harness.execute(
"cronScheduler", {"frequency": "quantum"}
)
- harness.assert_envelope(result, success=True)
- payload = result["result"]
- assert payload["schedule"] == "Unknown schedule"
- assert payload["waited_seconds"] == 300
- sleep_mock.assert_awaited_once()
+ harness.assert_envelope(result, success=False)
+ assert "invalid parameters" in result["error"].lower()
# ============================================================================
@@ -494,6 +487,6 @@ class TestWebhookResponse:
with _patched_resolve_webhook_response():
result = await harness.execute(
"webhookResponse",
- {"statusCode": "abc", "responseBody": "x"},
+ {"status_code": "abc", "body": "x"},
)
harness.assert_envelope(result, success=False)