Skip to content

Self-improving AI Employees for everyone

feat(schema): Wave 6 Phase 3c - backend NodeSpec parity for agents + chat models

trohitg8a8a4134ce9a
diff --git a/server/models/node_metadata.py b/server/models/node_metadata.py
index 66ef54f0..a7fd42f5 100644
--- a/server/models/node_metadata.py
+++ b/server/models/node_metadata.py
@@ -197,6 +197,207 @@ NODE_METADATA: dict[str, NodeMetadata] = {
"description": "Unified send action for any social platform",
"version": 1,
},
+ # Phase 3c: Agents + chat models ----------------------------------------
+ "aiAgent": {
+ "displayName": "AI Agent",
+ "icon": "πŸ€–",
+ "group": ["agent"],
+ "description": "LangGraph agent with tool calling, memory, and iterative reasoning",
+ "version": 1,
+ },
+ "chatAgent": {
+ "displayName": "Zeenie",
+ "icon": "🧞",
+ "group": ["agent"],
+ "description": "Conversational AI agent with memory and skill support",
+ "version": 1,
+ },
+ "simpleMemory": {
+ "displayName": "Simple Memory",
+ "icon": "🧠",
+ "group": ["tool", "memory"],
+ "description": "Markdown-based conversation memory with optional vector long-term storage",
+ "version": 1,
+ },
+ # Specialized agents (16) -- shared SpecializedAgentParams Pydantic model
+ "android_agent": {
+ "displayName": "Android Control Agent",
+ "icon": "πŸ“±",
+ "group": ["agent", "ai"],
+ "description": "AI agent for Android device control",
+ "version": 1,
+ },
+ "coding_agent": {
+ "displayName": "Coding Agent",
+ "icon": "πŸ’»",
+ "group": ["agent", "ai"],
+ "description": "AI agent for code execution",
+ "version": 1,
+ },
+ "web_agent": {
+ "displayName": "Web Control Agent",
+ "icon": "🌐",
+ "group": ["agent", "ai"],
+ "description": "AI agent for web automation",
+ "version": 1,
+ },
+ "task_agent": {
+ "displayName": "Task Management Agent",
+ "icon": "πŸ“‹",
+ "group": ["agent", "ai"],
+ "description": "AI agent for task automation and scheduling",
+ "version": 1,
+ },
+ "social_agent": {
+ "displayName": "Social Media Agent",
+ "icon": "πŸ“±",
+ "group": ["agent", "ai"],
+ "description": "AI agent for social messaging",
+ "version": 1,
+ },
+ "travel_agent": {
+ "displayName": "Travel Agent",
+ "icon": "✈️",
+ "group": ["agent", "ai"],
+ "description": "AI agent for travel planning",
+ "version": 1,
+ },
+ "tool_agent": {
+ "displayName": "Tool Agent",
+ "icon": "πŸ”§",
+ "group": ["agent", "ai"],
+ "description": "AI agent for tool orchestration",
+ "version": 1,
+ },
+ "productivity_agent": {
+ "displayName": "Productivity Agent",
+ "icon": "⏰",
+ "group": ["agent", "ai"],
+ "description": "AI agent for productivity workflows",
+ "version": 1,
+ },
+ "payments_agent": {
+ "displayName": "Payments Agent",
+ "icon": "πŸ’³",
+ "group": ["agent", "ai"],
+ "description": "AI agent for payment processing",
+ "version": 1,
+ },
+ "consumer_agent": {
+ "displayName": "Consumer Agent",
+ "icon": "πŸ›’",
+ "group": ["agent", "ai"],
+ "description": "AI agent for consumer interactions",
+ "version": 1,
+ },
+ "autonomous_agent": {
+ "displayName": "Autonomous Agent",
+ "icon": "🎯",
+ "group": ["agent", "ai"],
+ "description": "Autonomous agent using Code Mode patterns and agentic loops",
+ "version": 1,
+ },
+ "orchestrator_agent": {
+ "displayName": "Orchestrator Agent",
+ "icon": "🎼",
+ "group": ["agent", "ai"],
+ "description": "Team-lead agent for coordinating multiple specialized agents",
+ "version": 1,
+ },
+ "ai_employee": {
+ "displayName": "AI Employee",
+ "icon": "πŸ‘₯",
+ "group": ["agent", "ai"],
+ "description": "Team-lead agent for intelligent task delegation",
+ "version": 1,
+ },
+ "rlm_agent": {
+ "displayName": "RLM Agent",
+ "icon": "🧠",
+ "group": ["agent", "ai"],
+ "description": "Recursive Language Model agent with REPL-based execution",
+ "version": 1,
+ },
+ "claude_code_agent": {
+ "displayName": "Claude Code Agent",
+ "icon": ">_",
+ "group": ["agent", "ai"],
+ "description": "Claude Code SDK as a specialized agent node",
+ "version": 1,
+ },
+ "deep_agent": {
+ "displayName": "Deep Agent",
+ "icon": "🧠",
+ "group": ["agent", "ai"],
+ "description": "LangChain DeepAgents with filesystem tools and sub-agent delegation",
+ "version": 1,
+ },
+ # Chat models (9) -- shared AIChatModelParams Pydantic model.
+ # Icons left blank so frontend can resolve provider SVG; group set to
+ # ['model'] so Dashboard routing keeps SquareNode mapping.
+ "openaiChatModel": {
+ "displayName": "OpenAI",
+ "icon": "",
+ "group": ["model"],
+ "description": "OpenAI GPT models with response format options",
+ "version": 1,
+ },
+ "anthropicChatModel": {
+ "displayName": "Anthropic Claude",
+ "icon": "",
+ "group": ["model"],
+ "description": "Claude models with extended thinking support",
+ "version": 1,
+ },
+ "geminiChatModel": {
+ "displayName": "Google Gemini",
+ "icon": "",
+ "group": ["model"],
+ "description": "Google Gemini models with multimodal and thinking support",
+ "version": 1,
+ },
+ "openrouterChatModel": {
+ "displayName": "OpenRouter",
+ "icon": "",
+ "group": ["model"],
+ "description": "OpenRouter unified API for 200+ models",
+ "version": 1,
+ },
+ "groqChatModel": {
+ "displayName": "Groq",
+ "icon": "",
+ "group": ["model"],
+ "description": "Groq ultra-fast inference (Llama, Qwen3, GPT-OSS)",
+ "version": 1,
+ },
+ "cerebrasChatModel": {
+ "displayName": "Cerebras",
+ "icon": "",
+ "group": ["model"],
+ "description": "Cerebras ultra-fast inference on custom AI hardware",
+ "version": 1,
+ },
+ "deepseekChatModel": {
+ "displayName": "DeepSeek",
+ "icon": "",
+ "group": ["model"],
+ "description": "DeepSeek V3 models (deepseek-chat, deepseek-reasoner)",
+ "version": 1,
+ },
+ "kimiChatModel": {
+ "displayName": "Kimi (Moonshot)",
+ "icon": "",
+ "group": ["model"],
+ "description": "Kimi K2 models with thinking support",
+ "version": 1,
+ },
+ "mistralChatModel": {
+ "displayName": "Mistral",
+ "icon": "",
+ "group": ["model"],
+ "description": "Mistral AI models (Large, Small, Codestral)",
+ "version": 1,
+ },
}
diff --git a/server/models/nodes.py b/server/models/nodes.py
index 07b17961..da9650fa 100644
--- a/server/models/nodes.py
+++ b/server/models/nodes.py
@@ -74,7 +74,10 @@ class ChatAgentParams(BaseNodeParams):
class SpecializedAgentParams(BaseNodeParams):
- """Parameters for all specialized agent nodes (same structure as AIAgentParams)."""
+ """Parameters for all specialized agent nodes. Mirrors the full
+ AI_AGENT_PROPERTIES surface from the frontend so the NodeSpec
+ parameter panel renders identically across all 16 specialized
+ agent types."""
type: Literal[
"android_agent", "coding_agent", "web_agent", "task_agent",
"social_agent", "travel_agent", "tool_agent", "productivity_agent",
@@ -83,10 +86,15 @@ class SpecializedAgentParams(BaseNodeParams):
"deep_agent",
]
prompt: str = ""
- provider: str = "openai"
+ provider: Literal["openai", "anthropic", "gemini", "openrouter", "groq", "cerebras", "deepseek", "kimi", "mistral"] = "openai"
model: str = ""
+ temperature: float = Field(default=0.7, ge=0.0, le=2.0)
+ max_tokens: Optional[int] = Field(default=1000, alias="maxTokens")
system_message: Optional[str] = Field(default="", alias="systemMessage")
api_key: Optional[str] = Field(default=None, alias="apiKey")
+ thinking_enabled: bool = Field(default=False, alias="thinkingEnabled")
+ thinking_budget: int = Field(default=2048, alias="thinkingBudget", ge=1024, le=16000)
+ reasoning_effort: Literal["minimal", "low", "medium", "high"] = Field(default="medium", alias="reasoningEffort")
class SimpleMemoryParams(BaseNodeParams):
diff --git a/server/tests/test_node_spec.py b/server/tests/test_node_spec.py
index d00c2fed..6d7d1fee 100644
--- a/server/tests/test_node_spec.py
+++ b/server/tests/test_node_spec.py
@@ -70,13 +70,12 @@ class TestNodeSpec:
assert spec["version"] == 1
def test_spec_fallback_metadata_when_unseeded(self):
- # AI chat models have input + output schemas but no metadata seeded
- # yet (Phase 3c will migrate them).
- spec = get_node_spec("openaiChatModel")
+ # gmaps_create has an input model but no metadata yet
+ # (Phase 3d target).
+ spec = get_node_spec("gmaps_create")
assert spec is not None
- assert spec["type"] == "openaiChatModel"
- # Falls back to type id until Phase 3c migration
- assert spec["displayName"] == "openaiChatModel"
+ assert spec["type"] == "gmaps_create"
+ assert spec["displayName"] == "gmaps_create" # falls back to id
assert spec["group"] == []
def test_spec_missing_entirely(self):
@@ -182,3 +181,49 @@ class TestPhase3bCoverage:
assert "whatsapp" in platform["enum"]
assert "telegram" in platform["enum"]
assert "discord" in platform["enum"]
+
+
+class TestPhase3cCoverage:
+ """Phase 3c backend parity: agents (3 base + 16 specialized) +
+ chat models (9). All Pydantic models existed before Phase 3c -
+ this sub-commit only adds NODE_METADATA entries."""
+
+ PHASE_3C_TYPES = [
+ # Base agents
+ "aiAgent", "chatAgent", "simpleMemory",
+ # Specialized agents (16)
+ "android_agent", "coding_agent", "web_agent", "task_agent",
+ "social_agent", "travel_agent", "tool_agent", "productivity_agent",
+ "payments_agent", "consumer_agent", "autonomous_agent",
+ "orchestrator_agent", "ai_employee", "rlm_agent",
+ "claude_code_agent", "deep_agent",
+ # Chat models (9)
+ "openaiChatModel", "anthropicChatModel", "geminiChatModel",
+ "openrouterChatModel", "groqChatModel", "cerebrasChatModel",
+ "deepseekChatModel", "kimiChatModel", "mistralChatModel",
+ ]
+
+ def test_all_have_metadata(self):
+ from models.node_metadata import get_node_metadata
+ missing = [t for t in self.PHASE_3C_TYPES if get_node_metadata(t) is None]
+ assert not missing, f"Phase 3c types missing metadata: {missing}"
+
+ def test_all_have_full_spec(self):
+ for t in self.PHASE_3C_TYPES:
+ spec = get_node_spec(t)
+ assert spec is not None, f"No spec for {t}"
+ assert spec["displayName"] != t, f"{t} fell back to id displayName"
+ assert spec["group"], f"{t} missing group"
+
+ def test_chat_models_are_grouped_as_model(self):
+ # Dashboard routes group=['model'] -> ModelNode (or SquareNode for AI types).
+ for t in ["openaiChatModel", "anthropicChatModel", "geminiChatModel"]:
+ assert "model" in get_node_spec(t)["group"]
+
+ def test_specialized_agents_share_pydantic_constraints(self):
+ # All 16 specialized agents share SpecializedAgentParams - constraints
+ # like temperature 0-2 should appear identically.
+ spec = get_node_spec("coding_agent")
+ temp = spec["inputs"]["properties"]["temperature"]
+ assert temp["minimum"] == 0.0
+ assert temp["maximum"] == 2.0