Self-improving AI Employees for everyone
Python ai-agentsai-employeeai-employeesassistantautonomous-agentsco-employeescompanygrok-botinstinctloop-agentsmuseown-your-datapersonalself-hosted
feat: email nodes via Himalaya CLI (send, read, receive trigger)
trohitg4167b5757c3e
diff --git a/client/src/Dashboard.tsx b/client/src/Dashboard.tsxindex 6164f713..e9f9443a 100644--- a/client/src/Dashboard.tsx+++ b/client/src/Dashboard.tsx@@ -75,7 +75,7 @@ const createNodeTypes = (): Record<string, React.ComponentType<any>> => {const types: Record<string, React.ComponentType<any>> = {};// Trigger nodes (no input handles) - check by group or specific types- const TRIGGER_NODE_TYPES = ['start', 'cronScheduler', 'webhookTrigger', 'whatsappReceive', 'telegramReceive', 'twitterReceive', 'gmailReceive', 'chatTrigger', 'taskTrigger'];+ const TRIGGER_NODE_TYPES = ['start', 'cronScheduler', 'webhookTrigger', 'whatsappReceive', 'telegramReceive', 'twitterReceive', 'gmailReceive', 'emailReceive', 'chatTrigger', 'taskTrigger'];// Pre-register specialized agent nodes explicitly to ensure they're always available// This handles cases where nodeDefinitions iteration order might miss them@@ -103,6 +103,9 @@ const createNodeTypes = (): Record<string, React.ComponentType<any>> => {} else if (type === 'telegramSend') {// Telegram action node uses SquareNode (telegramReceive is a trigger)types[type] = SquareNode;+ } else if (type === 'emailSend' || type === 'emailRead') {+ // Email action nodes use SquareNode (emailReceive is a trigger)+ types[type] = SquareNode;} else if (type === 'twitterSend' || type === 'twitterSearch' || type === 'twitterUser') {// Twitter action nodes use SquareNode (twitterReceive is a trigger)types[type] = SquareNode;@@ -707,7 +710,7 @@ const DashboardContent: React.FC = () => {// Check if there's at least one trigger node (workflow entry points)// Trigger types: start, cronScheduler, webhookTrigger, whatsappReceive, telegramReceive, twitterReceive, gmailReceive, workflowTrigger, chatTrigger, taskTrigger- const triggerTypes = ['start', 'cronScheduler', 'webhookTrigger', 'whatsappReceive', 'telegramReceive', 'twitterReceive', 'gmailReceive', 'workflowTrigger', 'chatTrigger', 'taskTrigger'];+ const triggerTypes = ['start', 'cronScheduler', 'webhookTrigger', 'whatsappReceive', 'telegramReceive', 'twitterReceive', 'gmailReceive', 'emailReceive', 'workflowTrigger', 'chatTrigger', 'taskTrigger'];const hasTriggerNode = nodes.some(node => triggerTypes.includes(node.type || ''));if (!hasTriggerNode) {alert('No trigger node found in workflow.\n\nAdd a trigger node (Cron Scheduler, WhatsApp Receive, Webhook, Chat Trigger, etc.) to begin deployment.');diff --git a/client/src/assets/icons/email/index.ts b/client/src/assets/icons/email/index.tsnew file mode 100644index 00000000..60a7e11f--- /dev/null+++ b/client/src/assets/icons/email/index.ts@@ -0,0 +1,22 @@+// Email icons for Himalaya IMAP/SMTP nodes++import sendSvg from './send.svg?raw';+import readSvg from './read.svg?raw';+import receiveSvg from './receive.svg?raw';++const svgToDataUri = (svg: string): string => {+ const encoded = encodeURIComponent(svg)+ .replace(/'/g, '%27')+ .replace(/"/g, '%22');+ return `data:image/svg+xml,${encoded}`;+};++export const EMAIL_SEND_ICON = svgToDataUri(sendSvg);+export const EMAIL_READ_ICON = svgToDataUri(readSvg);+export const EMAIL_RECEIVE_ICON = svgToDataUri(receiveSvg);++export const EmailIcons = {+ send: sendSvg,+ read: readSvg,+ receive: receiveSvg,+};diff --git a/client/src/assets/icons/email/read.svg b/client/src/assets/icons/email/read.svgnew file mode 100644index 00000000..637099ad--- /dev/null+++ b/client/src/assets/icons/email/read.svg@@ -0,0 +1,6 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">+ <path fill="#268bd2" d="M20 6H4c-1.1 0-2 .9-2 2v10c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V8c0-1.1-.9-2-2-2z"/>+ <path fill="#1a6fb0" d="M2 8l10 6 10-6"/>+ <path fill="#fff" d="M4 10l8 5 8-5v2l-8 5-8-5z" opacity="0.9"/>+ <path fill="#8be9fd" d="M12 4L2 8h20z"/>+</svg>diff --git a/client/src/assets/icons/email/receive.svg b/client/src/assets/icons/email/receive.svgnew file mode 100644index 00000000..1c7cc524--- /dev/null+++ b/client/src/assets/icons/email/receive.svg@@ -0,0 +1,7 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">+ <path fill="#268bd2" d="M20 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2z"/>+ <path fill="#1a6fb0" d="M20 4H4c-1.1 0-2 .9-2 2l10 6 10-6c0-1.1-.9-2-2-2z"/>+ <path fill="#fff" d="M4 8l8 5 8-5v2l-8 5-8-5z" opacity="0.9"/>+ <circle fill="#ff5555" cx="19" cy="5" r="4"/>+ <circle fill="#fff" cx="19" cy="5" r="2"/>+</svg>diff --git a/client/src/assets/icons/email/send.svg b/client/src/assets/icons/email/send.svgnew file mode 100644index 00000000..3f48854b--- /dev/null+++ b/client/src/assets/icons/email/send.svg@@ -0,0 +1,7 @@+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24">+ <path fill="#268bd2" d="M20 4H4c-1.1 0-2 .9-2 2v12c0 1.1.9 2 2 2h16c1.1 0 2-.9 2-2V6c0-1.1-.9-2-2-2z"/>+ <path fill="#1a6fb0" d="M20 4H4c-1.1 0-2 .9-2 2l10 6 10-6c0-1.1-.9-2-2-2z"/>+ <path fill="#fff" d="M4 8l8 5 8-5v2l-8 5-8-5z" opacity="0.9"/>+ <path fill="#50fa7b" d="M16 14l2-2 2 2-2 2z"/>+ <path fill="#50fa7b" d="M19 13h3v2h-3z"/>+</svg>diff --git a/client/src/components/parameterPanel/InputSection.tsx b/client/src/components/parameterPanel/InputSection.tsxindex db19d0a5..f3bc00fa 100644--- a/client/src/components/parameterPanel/InputSection.tsx+++ b/client/src/components/parameterPanel/InputSection.tsx@@ -752,6 +752,26 @@ const InputSection: React.FC<InputSectionProps> = ({ nodeId, visible = true }) =matches: 'array',pattern: 'string',count: 'number'+ },+ // Email node schemas (Himalaya CLI)+ emailSend: {+ from: 'string',+ to: 'string',+ subject: 'string'+ },+ emailRead: {+ operation: 'string',+ folder: 'string',+ data: 'any'+ },+ emailReceive: {+ message_id: 'string',+ from: 'string',+ to: 'string',+ subject: 'string',+ date: 'string',+ body: 'string',+ folder: 'string'}};@@ -816,6 +836,9 @@ const InputSection: React.FC<InputSectionProps> = ({ nodeId, visible = true }) =// Filesystem & shell node detectionconst isFilesystemNode = ['fileRead', 'fileModify', 'shell', 'fsSearch'].includes(nodeType);+ // Email node detection (Himalaya CLI)+ const isEmailNode = ['emailSend', 'emailRead', 'emailReceive'].includes(nodeType);+// Select appropriate schemaif (isAndroidLocation) {outputSchema = sampleSchemas.androidLocation;@@ -848,6 +871,7 @@ const InputSection: React.FC<InputSectionProps> = ({ nodeId, visible = true }) =isBrowser ? sampleSchemas.browser :isCrawlee ? sampleSchemas.crawlee :isFilesystemNode ? (sampleSchemas[nodeType as keyof typeof sampleSchemas] || { data: 'any' }) :+ isEmailNode ? (sampleSchemas[nodeType as keyof typeof sampleSchemas] || { data: 'any' }) :{ data: 'any' };}diff --git a/client/src/nodeDefinitions.ts b/client/src/nodeDefinitions.tsindex 54d6cc79..b5d79bfc 100644--- a/client/src/nodeDefinitions.ts+++ b/client/src/nodeDefinitions.ts@@ -27,6 +27,8 @@ import { proxyNodes, PROXY_NODE_TYPES } from './nodeDefinitions/proxyNodes';import { crawleeNodes, CRAWLEE_NODE_TYPES } from './nodeDefinitions/crawleeNodes';import { browserNodes, BROWSER_NODE_TYPES } from './nodeDefinitions/browserNodes';import { filesystemNodes, FILESYSTEM_NODE_TYPES } from './nodeDefinitions/filesystemNodes';+import { emailNodes, EMAIL_NODE_TYPES } from './nodeDefinitions/emailNodes';+// ============================================================================// MAIN NODE REGISTRY - Combining all modular definitions@@ -57,7 +59,8 @@ export const nodeDefinitions: Record<string, INodeTypeDescription> = {...proxyNodes,...crawleeNodes,...browserNodes,- ...filesystemNodes+ ...filesystemNodes,+ ...emailNodes};// ============================================================================@@ -166,5 +169,9 @@ export const FILESYSTEM_NODES = [...FILESYSTEM_NODE_TYPES];+export const EMAIL_NODES = [+ ...EMAIL_NODE_TYPES+];+// Re-export types and utilities from modular files for external accessexport { createBaseChatModel } from './nodeDefinitions/aiModelNodes';diff --git a/client/src/nodeDefinitions/emailNodes.ts b/client/src/nodeDefinitions/emailNodes.tsnew file mode 100644index 00000000..b703c5e8--- /dev/null+++ b/client/src/nodeDefinitions/emailNodes.ts@@ -0,0 +1,120 @@+// Email Node Definitions - IMAP/SMTP integration via Himalaya CLI+import {+ INodeTypeDescription,+ NodeConnectionType+} from '../types/INodeProperties';+import { solarized } from '../styles/theme';+import { EMAIL_SEND_ICON, EMAIL_READ_ICON, EMAIL_RECEIVE_ICON } from '../assets/icons/email';++// ============================================================================+// SHARED OPTIONS+// ============================================================================++// Provider presets (mirrors server/config/email_providers.json)+const PROVIDER_OPTIONS = [+ { name: 'Gmail', value: 'gmail' },+ { name: 'Outlook / Office 365', value: 'outlook' },+ { name: 'Yahoo Mail', value: 'yahoo' },+ { name: 'iCloud Mail', value: 'icloud' },+ { name: 'ProtonMail (Bridge)', value: 'protonmail' },+ { name: 'Fastmail', value: 'fastmail' },+ { name: 'Custom / Self-hosted', value: 'custom' },+];++const PROVIDER_PROPERTY = {+ displayName: 'Provider', name: 'provider', type: 'options' as const,+ options: PROVIDER_OPTIONS, default: 'gmail', description: 'Email provider',+};++// ============================================================================+// EMAIL NODES+// ============================================================================++export const emailNodes: Record<string, INodeTypeDescription> = {++ emailSend: {+ displayName: 'Email Send',+ name: 'emailSend',+ icon: EMAIL_SEND_ICON,+ group: ['email', 'tool'],+ version: 1,+ subtitle: 'Send Email via SMTP',+ description: 'Send email via Himalaya SMTP. Supports Gmail, Outlook, Yahoo, iCloud, ProtonMail, Fastmail, or custom.',+ defaults: { name: 'Email Send', color: solarized.blue },+ inputs: [{ name: 'main', displayName: 'Input', type: 'main' as NodeConnectionType, description: 'Input data' }],+ outputs: [+ { name: 'main', displayName: 'Output', type: 'main' as NodeConnectionType, description: 'Send result' },+ { name: 'tool', displayName: 'Tool', type: 'main' as NodeConnectionType, description: 'Connect to AI Agent tool handle' },+ ],+ properties: [+ PROVIDER_PROPERTY,+ { displayName: 'To', name: 'to', type: 'string', default: '', required: true, placeholder: '[email protected]', description: 'Recipients (comma-separated)' },+ { displayName: 'Subject', name: 'subject', type: 'string', default: '', required: true, placeholder: 'Email subject' },+ { displayName: 'Body', name: 'body', type: 'string', default: '', required: true, typeOptions: { rows: 6 }, placeholder: 'Email body...' },+ { displayName: 'CC', name: 'cc', type: 'string', default: '', placeholder: '[email protected]' },+ { displayName: 'BCC', name: 'bcc', type: 'string', default: '', placeholder: '[email protected]' },+ { displayName: 'Body Type', name: 'body_type', type: 'options', options: [{ name: 'Plain Text', value: 'text' }, { name: 'HTML', value: 'html' }], default: 'text' },+ ],+ },++ emailRead: {+ displayName: 'Email Read',+ name: 'emailRead',+ icon: EMAIL_READ_ICON,+ group: ['email', 'tool'],+ version: 1,+ subtitle: 'Read & Manage via IMAP',+ description: 'List, search, read, move, delete, or flag emails via Himalaya IMAP.',+ defaults: { name: 'Email Read', color: solarized.blue },+ inputs: [{ name: 'main', displayName: 'Input', type: 'main' as NodeConnectionType, description: 'Input data' }],+ outputs: [+ { name: 'main', displayName: 'Output', type: 'main' as NodeConnectionType, description: 'Send result' },+ { name: 'tool', displayName: 'Tool', type: 'main' as NodeConnectionType, description: 'Connect to AI Agent tool handle' },+ ],+ properties: [+ PROVIDER_PROPERTY,+ {+ displayName: 'Operation', name: 'operation', type: 'options', required: true, default: 'list',+ options: [+ { name: 'List Envelopes', value: 'list' },+ { name: 'Search Emails', value: 'search' },+ { name: 'Read Message', value: 'read' },+ { name: 'List Folders', value: 'folders' },+ { name: 'Move Message', value: 'move' },+ { name: 'Delete Message', value: 'delete' },+ { name: 'Flag Message', value: 'flag' },+ ],+ },+ { displayName: 'Folder', name: 'folder', type: 'string', default: 'INBOX', displayOptions: { show: { operation: ['list', 'search', 'read', 'move', 'delete', 'flag'] } } },+ { displayName: 'Query', name: 'query', type: 'string', default: '', required: true, placeholder: 'from:john subject:meeting', displayOptions: { show: { operation: ['search'] } } },+ { displayName: 'Message ID', name: 'message_id', type: 'string', default: '', required: true, displayOptions: { show: { operation: ['read', 'move', 'delete', 'flag'] } } },+ { displayName: 'Target Folder', name: 'target_folder', type: 'string', default: '', required: true, placeholder: 'Archive', displayOptions: { show: { operation: ['move'] } } },+ { displayName: 'Flag', name: 'flag', type: 'options', default: 'Seen', options: [{ name: 'Seen', value: 'Seen' }, { name: 'Answered', value: 'Answered' }, { name: 'Flagged', value: 'Flagged' }, { name: 'Draft', value: 'Draft' }, { name: 'Deleted', value: 'Deleted' }], displayOptions: { show: { operation: ['flag'] } } },+ { displayName: 'Flag Action', name: 'flag_action', type: 'options', default: 'add', options: [{ name: 'Add', value: 'add' }, { name: 'Remove', value: 'remove' }], displayOptions: { show: { operation: ['flag'] } } },+ { displayName: 'Page', name: 'page', type: 'number', default: 1, typeOptions: { minValue: 1 }, displayOptions: { show: { operation: ['list'] } } },+ { displayName: 'Page Size', name: 'page_size', type: 'number', default: 20, typeOptions: { minValue: 1, maxValue: 100 }, displayOptions: { show: { operation: ['list'] } } },+ ],+ },++ emailReceive: {+ displayName: 'Email Receive',+ name: 'emailReceive',+ icon: EMAIL_RECEIVE_ICON,+ group: ['email', 'trigger'],+ version: 1,+ subtitle: 'On Email Received',+ description: 'Trigger workflow when new email arrives. Polls IMAP via Himalaya.',+ defaults: { name: 'Email Receive', color: solarized.blue },+ inputs: [],+ outputs: [{ name: 'main', displayName: 'Email', type: 'main' as NodeConnectionType, description: 'message_id, from, to, subject, date, body, folder' }],+ properties: [+ PROVIDER_PROPERTY,+ { displayName: 'Folder', name: 'folder', type: 'string', default: 'INBOX' },+ { displayName: 'Poll Interval (seconds)', name: 'poll_interval', type: 'number', default: 60, typeOptions: { minValue: 30, maxValue: 3600 } },+ { displayName: 'Filter Query', name: 'filter_query', type: 'string', default: '', placeholder: 'from:[email protected]' },+ { displayName: 'Mark as Read', name: 'mark_as_read', type: 'boolean', default: false },+ ],+ },+};++export const EMAIL_NODE_TYPES = ['emailSend', 'emailRead', 'emailReceive'];diff --git a/client/src/services/executionService.ts b/client/src/services/executionService.tsindex ab29afc2..d8a4bb7c 100644--- a/client/src/services/executionService.ts+++ b/client/src/services/executionService.ts@@ -12,6 +12,7 @@ import { SEARCH_NODE_TYPES } from '../nodeDefinitions/searchNodes';import { TELEGRAM_NODE_TYPES } from '../nodeDefinitions/telegramNodes';import { CRAWLEE_NODE_TYPES } from '../nodeDefinitions/crawleeNodes';import { BROWSER_NODE_TYPES } from '../nodeDefinitions/browserNodes';+import { EMAIL_NODE_TYPES } from '../nodeDefinitions/emailNodes';import { AI_CHAT_MODEL_TYPES } from '../nodeDefinitions/aiModelNodes';import { Node, Edge } from 'reactflow';import { INodeExecutionData } from '../types/INodeProperties';@@ -247,7 +248,9 @@ export class ExecutionService {'shell','fsSearch',// Todo planning- 'writeTodos'+ 'writeTodos',+ // Email (Himalaya CLI)+ ...EMAIL_NODE_TYPES,];return supportedTypes.includes(nodeType);diff --git a/server/config/email_providers.json b/server/config/email_providers.jsonindex 0788dd26..8df76a4f 100644--- a/server/config/email_providers.json+++ b/server/config/email_providers.json@@ -10,6 +10,22 @@"timeout_seconds": 60},+ "defaults": {+ "provider": "gmail",+ "folder": "INBOX",+ "body_type": "text",+ "page_size": 20,+ "flag": "Seen",+ "flag_action": "add"+ },++ "polling": {+ "interval": 60,+ "min_interval": 30,+ "max_interval": 3600,+ "baseline_page_size": 50+ },+"config_template": ["[accounts.{account}]","email = \"{email}\"",diff --git a/server/constants.py b/server/constants.pyindex e7d2a283..28e028ba 100644--- a/server/constants.py+++ b/server/constants.py@@ -234,6 +234,22 @@ SOCIAL_TOOL_TYPES: FrozenSet[str] = frozenset(['socialSend', # Can be used as AI Agent tool])+# =============================================================================+# EMAIL NODE TYPES (Himalaya CLI-based IMAP/SMTP)+# =============================================================================++EMAIL_TYPES: FrozenSet[str] = frozenset([+ 'emailSend',+ 'emailRead',+ 'emailReceive',+])++# Dual-purpose email nodes (workflow node + AI tool)+EMAIL_TOOL_TYPES: FrozenSet[str] = frozenset([+ 'emailSend',+ 'emailRead',+])+# =============================================================================# CHAT NODE TYPES# =============================================================================@@ -298,6 +314,7 @@ TRIGGER_TYPES: FrozenSet[str] = EVENT_TRIGGER_TYPESPOLLING_TRIGGER_TYPES: FrozenSet[str] = frozenset(['gmailReceive','twitterReceive',+ 'emailReceive',])# =============================================================================@@ -320,6 +337,7 @@ WORKFLOW_TRIGGER_TYPES: FrozenSet[str] = frozenset(['twitterReceive','gmailReceive','telegramReceive',+ 'emailReceive',])# =============================================================================diff --git a/server/services/ai.py b/server/services/ai.pyindex 035a2e4c..269637a0 100644--- a/server/services/ai.py+++ b/server/services/ai.py@@ -2498,6 +2498,9 @@ class AIService:'crawleeScraper': 'web_reader',# Browser automation (dual-purpose tool)'browser': 'browser',+ # Email (Himalaya CLI, dual-purpose tools)+ 'emailSend': 'email_send',+ 'emailRead': 'email_read',}DEFAULT_TOOL_DESCRIPTIONS = {'calculatorTool': 'Perform mathematical calculations. Operations: add, subtract, multiply, divide, power, sqrt, mod, abs',@@ -2574,6 +2577,9 @@ class AIService:'crawleeScraper': 'Read and extract content from web pages. Fetches page text, links, and data. Use beautifulsoup for static pages or playwright for JS-rendered pages. You MUST use this tool when the user asks to read, fetch, or get content from any URL.',# Browser automation (dual-purpose tool)'browser': 'Control a web browser interactively. Use snapshot to see the page (returns accessibility tree with @eN refs). Then click/type/fill with those refs. Workflow: navigate -> snapshot -> interact -> snapshot. Operations: navigate, click, type, fill, screenshot, snapshot, get_text, get_html, eval, wait, scroll, select, batch.',+ # Email (Himalaya CLI, dual-purpose tools)+ 'emailSend': 'Send email via SMTP. Specify to, subject, body. Optional: cc, bcc, body_type (text/html).',+ 'emailRead': 'Read and manage emails via IMAP. Operations: list (envelopes), search (query), read (message by ID), folders (list), move, delete, flag.',}try:@@ -3734,6 +3740,35 @@ class AIService:return ProxyConfigSchema+ # Email Send (dual-purpose: workflow node + AI tool)+ if node_type == 'emailSend':+ class EmailSendSchema(BaseModel):+ """Send an email via SMTP."""+ to: str = Field(description="Recipient email address(es), comma-separated")+ subject: str = Field(description="Email subject line")+ body: str = Field(description="Email body content")+ cc: Optional[str] = Field(default=None, description="CC recipients, comma-separated")+ bcc: Optional[str] = Field(default=None, description="BCC recipients, comma-separated")+ body_type: str = Field(default="text", description="Body format: text or html")++ return EmailSendSchema++ # Email Read (dual-purpose: workflow node + AI tool)+ if node_type == 'emailRead':+ class EmailReadSchema(BaseModel):+ """Read and manage emails via IMAP."""+ operation: str = Field(description="Operation: list, search, read, folders, move, delete, flag")+ folder: Optional[str] = Field(default=None, description="Mailbox folder")+ message_id: Optional[str] = Field(default=None, description="Message ID (for read/move/delete/flag)")+ query: Optional[str] = Field(default=None, description="Search query (for search)")+ target_folder: Optional[str] = Field(default=None, description="Destination folder (for move)")+ flag: Optional[str] = Field(default=None, description="Flag: Seen, Answered, Flagged, Draft, Deleted")+ flag_action: Optional[str] = Field(default=None, description="add or remove")+ page: Optional[int] = Field(default=None, description="Page number (for list)")+ page_size: Optional[int] = Field(default=None, description="Results per page (for list)")++ return EmailReadSchema+# Generic schema for other nodesclass GenericToolSchema(BaseModel):"""Generic schema for tool arguments."""diff --git a/server/services/deployment/manager.py b/server/services/deployment/manager.pyindex a5e1448c..b871d745 100644--- a/server/services/deployment/manager.py+++ b/server/services/deployment/manager.py@@ -685,6 +685,8 @@ class DeploymentManager:"""if node_type == 'gmailReceive':return self._create_gmail_poll_coroutine(node_id, params)+ elif node_type == 'emailReceive':+ return self._create_email_poll_coroutine(node_id, params)elif node_type == 'twitterReceive':logger.warning("Twitter polling trigger not yet implemented for deployment")return None@@ -771,6 +773,44 @@ class DeploymentManager:return poll+ def _create_email_poll_coroutine(self, node_id: str,+ params: Dict[str, Any]) -> Callable:+ """Create Himalaya email polling coroutine for deployment mode."""+ async def poll(queue: asyncio.Queue, is_running_fn: Callable):+ from services.email_service import get_email_service++ svc = get_email_service()+ creds = await svc.resolve_credentials(params)+ cfg = svc.resolve_poll_params(params)++ seen = await svc.poll_ids(creds, cfg["folder"])+ logger.info("Email poller starting",+ node_id=node_id, folder=cfg["folder"], seen=len(seen))++ while is_running_fn():+ await asyncio.sleep(cfg["interval"])+ if not is_running_fn():+ break+ try:+ for msg_id in await svc.poll_ids(creds, cfg["folder"]) - seen:+ seen.add(msg_id)+ email_data = await svc.fetch_detail(creds, msg_id, cfg["folder"])+ if cfg["mark_as_read"]:+ try:+ d = svc.defaults+ await svc.himalaya.flag_message(+ creds, msg_id, d.get("flag"), d.get("flag_action"), cfg["folder"])+ except Exception:+ pass+ await queue.put(email_data)+ except asyncio.CancelledError:+ break+ except Exception as e:+ logger.error("Email poll error",+ node_id=node_id, error=str(e))++ return poll+async def _load_settings(self):"""Load deployment settings from database."""try:diff --git a/server/services/email_service.py b/server/services/email_service.pynew file mode 100644index 00000000..cc17ae65--- /dev/null+++ b/server/services/email_service.py@@ -0,0 +1,168 @@+"""Email service - credential resolution + HimalayaService orchestration.++All defaults and constants loaded from config/email_providers.json.+"""++import json+from pathlib import Path+from typing import Any, Dict, Optional, Set++from core.logging import get_logger++logger = get_logger(__name__)++_CONFIG: Optional[Dict] = None+_CONFIG_PATH = Path(__file__).parent.parent / "config" / "email_providers.json"+++def _load_config() -> Dict:+ global _CONFIG+ if _CONFIG is None:+ with open(_CONFIG_PATH) as f:+ _CONFIG = json.load(f)+ return _CONFIG+++class EmailService:+ _instance: Optional["EmailService"] = None++ @classmethod+ def get_instance(cls) -> "EmailService":+ if cls._instance is None:+ cls._instance = cls()+ return cls._instance++ @property+ def config(self) -> Dict:+ return _load_config()++ @property+ def defaults(self) -> Dict:+ return self.config.get("defaults", {})++ @property+ def polling(self) -> Dict:+ return self.config.get("polling", {})++ @property+ def himalaya(self):+ from services.himalaya_service import get_himalaya_service+ return get_himalaya_service()++ def _provider_preset(self, name: str) -> Dict:+ return self.config.get("providers", {}).get(name, {})++ # -- credentials --++ async def resolve_credentials(self, params: Dict[str, Any]) -> Dict[str, Any]:+ """Merge stored creds + provider presets + param overrides."""+ from core.container import container+ auth = container.auth_service()++ provider = params.get("provider") or await auth.get_api_key("email_provider") or self.defaults.get("provider")+ preset = self._provider_preset(provider)++ email = params.get("email") or await auth.get_api_key("email_address") or ""+ password = params.get("password") or await auth.get_api_key("email_password") or ""++ if not email:+ raise ValueError("Email address not configured")+ if not password:+ raise ValueError("Email password not configured")++ # Every field: param override > provider preset (preset already has port/host/encryption)+ return {+ "email": email,+ "password": password,+ "display_name": params.get("display_name", ""),+ "imap_host": params.get("imap_host") or preset.get("imap_host", ""),+ "imap_port": params.get("imap_port") or preset.get("imap_port"),+ "imap_encryption": params.get("imap_encryption") or preset.get("imap_encryption"),+ "smtp_host": params.get("smtp_host") or preset.get("smtp_host", ""),+ "smtp_port": params.get("smtp_port") or preset.get("smtp_port"),+ "smtp_encryption": params.get("smtp_encryption") or preset.get("smtp_encryption"),+ }++ def resolve_poll_params(self, params: Dict[str, Any]) -> Dict[str, Any]:+ """Resolve polling parameters from node params + JSON polling config."""+ p = self.polling+ interval = params.get("poll_interval", p.get("interval"))+ interval = max(p.get("min_interval"), min(p.get("max_interval"), interval))+ return {+ "interval": interval,+ "folder": params.get("folder", self.defaults.get("folder")),+ "mark_as_read": params.get("mark_as_read", False),+ }++ # -- operations --++ async def send(self, params: Dict[str, Any]) -> Dict[str, Any]:+ creds = await self.resolve_credentials(params)+ d = self.defaults+ result = await self.himalaya.send_email(+ creds,+ to=params.get("to", ""),+ subject=params.get("subject", ""),+ body=params.get("body", ""),+ cc=params.get("cc", ""),+ bcc=params.get("bcc", ""),+ body_type=params.get("body_type", d.get("body_type")),+ )+ return {"from": creds["email"], **(result if isinstance(result, dict) else {})}++ async def read(self, params: Dict[str, Any]) -> Dict[str, Any]:+ creds = await self.resolve_credentials(params)+ d = self.defaults+ op = params.get("operation", "list")+ folder = params.get("folder", d.get("folder"))++ router = {+ "list": ("list_envelopes", {"folder": folder,+ "page": params.get("page", 1),+ "page_size": params.get("page_size", d.get("page_size"))}),+ "search": ("search_envelopes", {"query": params.get("query", ""), "folder": folder}),+ "read": ("read_message", {"message_id": params.get("message_id", ""), "folder": folder}),+ "folders": ("list_folders", {}),+ "move": ("move_message", {"message_id": params.get("message_id", ""),+ "target_folder": params.get("target_folder", ""), "folder": folder}),+ "delete": ("delete_message", {"message_id": params.get("message_id", ""), "folder": folder}),+ "flag": ("flag_message", {"message_id": params.get("message_id", ""),+ "flag": params.get("flag", d.get("flag")),+ "action": params.get("flag_action", d.get("flag_action")),+ "folder": folder}),+ }++ if op not in router:+ raise ValueError(f"Unknown operation: {op}")++ method_name, kwargs = router[op]+ data = await getattr(self.himalaya, method_name)(creds, **kwargs)++ result = {"operation": op, "folder": folder}+ if isinstance(data, dict):+ result.update(data)+ else:+ result["data"] = data+ return result++ # -- polling helpers --++ async def poll_ids(self, creds: dict, folder: str = None) -> Set[str]:+ if folder is None:+ folder = self.defaults.get("folder")+ page_size = self.polling.get("baseline_page_size")+ result = await self.himalaya.list_envelopes(creds, folder=folder, page_size=page_size)+ envs = result if isinstance(result, list) else result.get("data", [])+ return {str(e.get("id") or e.get("uid", "")) for e in envs if e.get("id") or e.get("uid")}++ async def fetch_detail(self, creds: dict, msg_id: str, folder: str = None) -> Dict:+ if folder is None:+ folder = self.defaults.get("folder")+ result = await self.himalaya.read_message(creds, msg_id, folder=folder)+ data = result if isinstance(result, dict) else {"raw": result}+ data.update(message_id=msg_id, folder=folder)+ return data+++def get_email_service() -> EmailService:+ return EmailService.get_instance()diff --git a/server/services/event_waiter.py b/server/services/event_waiter.pyindex c78930f6..cb464d47 100644--- a/server/services/event_waiter.py+++ b/server/services/event_waiter.py@@ -125,6 +125,11 @@ TRIGGER_REGISTRY: Dict[str, TriggerConfig] = {event_type='telegram_message_received',display_name='Telegram Message'),+ 'emailReceive': TriggerConfig(+ node_type='emailReceive',+ event_type='email_received',+ display_name='Email'+ ),# Future triggers - just add to registry:# 'mqttTrigger': TriggerConfig('mqttTrigger', 'mqtt_message', 'MQTT Message'),}@@ -546,6 +551,20 @@ def build_telegram_filter(params: Dict) -> Callable[[Dict], bool]:return matches+def build_email_filter(params: Dict) -> Callable[[Dict], bool]:+ """Build filter for email events (Himalaya IMAP polling)."""+ folder_filter = params.get('folder', 'INBOX')+ filter_query = params.get('filter_query', '')++ def matches(data: Dict) -> bool:+ if folder_filter and folder_filter != 'all':+ if data.get('folder', '') != folder_filter:+ return False+ return True++ return matches++# Registry of filter builders per trigger typeFILTER_BUILDERS: Dict[str, Callable[[Dict], Callable[[Dict], bool]]] = {'whatsappReceive': build_whatsapp_filter,@@ -555,6 +574,7 @@ FILTER_BUILDERS: Dict[str, Callable[[Dict], Callable[[Dict], bool]]] = {'twitterReceive': build_twitter_filter,'gmailReceive': build_gmail_filter,'telegramReceive': build_telegram_filter,+ 'emailReceive': build_email_filter,}diff --git a/server/services/handlers/__init__.py b/server/services/handlers/__init__.pyindex 1c37376e..9f769d0e 100644--- a/server/services/handlers/__init__.py+++ b/server/services/handlers/__init__.py@@ -111,6 +111,9 @@ from .search import (handle_perplexity_search,)+# Email handlers (Himalaya CLI)+from .email import handle_email_send, handle_email_read, handle_email_receive+# Crawlee web scraping handlerfrom .crawlee import handle_crawlee_scraper@@ -210,6 +213,10 @@ __all__ = ['handle_file_modify','handle_shell','handle_fs_search',+ 'handle_email_send',+ 'handle_email_read',+ 'handle_email_receive',# Tools'execute_tool','handle_task_manager',diff --git a/server/services/handlers/email.py b/server/services/handlers/email.pynew file mode 100644index 00000000..f44a17a4--- /dev/null+++ b/server/services/handlers/email.py@@ -0,0 +1,86 @@+"""Email node handlers - thin wrappers around EmailService."""++import asyncio+import time+from datetime import datetime+from typing import Any, Dict, Set++from core.logging import get_logger++logger = get_logger(__name__)+++def _ok(node_id, node_type, result, start):+ return {"success": True, "node_id": node_id, "node_type": node_type,+ "result": result, "execution_time": time.time() - start,+ "timestamp": datetime.now().isoformat()}+++def _err(node_id, node_type, error, start):+ return {"success": False, "node_id": node_id, "node_type": node_type,+ "error": str(error), "execution_time": time.time() - start,+ "timestamp": datetime.now().isoformat()}+++async def handle_email_send(node_id, node_type, parameters, context):+ from services.email_service import get_email_service+ t = time.time()+ try:+ return _ok(node_id, node_type, await get_email_service().send(parameters), t)+ except Exception as e:+ logger.error(f"[EmailSend] {e}")+ return _err(node_id, node_type, e, t)+++async def handle_email_read(node_id, node_type, parameters, context):+ from services.email_service import get_email_service+ t = time.time()+ try:+ return _ok(node_id, node_type, await get_email_service().read(parameters), t)+ except Exception as e:+ logger.error(f"[EmailRead] {e}")+ return _err(node_id, node_type, e, t)+++async def handle_email_receive(node_id, node_type, parameters, context):+ """Polling trigger - baseline + poll loop (gmailReceive pattern)."""+ from services.email_service import get_email_service+ from services.status_broadcaster import get_status_broadcaster+ t = time.time()+ try:+ svc = get_email_service()+ creds = await svc.resolve_credentials(parameters)+ poll = svc.resolve_poll_params(parameters)++ await get_status_broadcaster().update_node_status(node_id, "waiting", {+ "message": f"Waiting for email (every {poll['interval']}s)...",+ "event_type": "email_received",+ }, workflow_id=context.get("workflow_id"))++ seen: Set[str] = await svc.poll_ids(creds, poll["folder"])+ logger.info(f"[EmailReceive] Baseline: {len(seen)} emails in {poll['folder']}")++ while True:+ await asyncio.sleep(poll["interval"])+ new_ids = await svc.poll_ids(creds, poll["folder"]) - seen+ if not new_ids:+ continue++ msg_id = next(iter(new_ids))+ seen.update(new_ids)+ email_data = await svc.fetch_detail(creds, msg_id, poll["folder"])++ if poll["mark_as_read"]:+ d = svc.defaults+ await svc.himalaya.flag_message(+ creds, msg_id, d.get("flag"), d.get("flag_action"), poll["folder"])++ from services import event_waiter+ event_waiter.dispatch("email_received", email_data)+ return _ok(node_id, node_type, email_data, t)++ except asyncio.CancelledError:+ return _err(node_id, node_type, "Cancelled by user", t)+ except Exception as e:+ logger.error(f"[EmailReceive] {e}")+ return _err(node_id, node_type, e, t)diff --git a/server/services/handlers/tools.py b/server/services/handlers/tools.pyindex 3c2af1a0..64f2968b 100644--- a/server/services/handlers/tools.py+++ b/server/services/handlers/tools.py@@ -206,6 +206,10 @@ async def execute_tool(tool_name: str, tool_args: Dict[str, Any],return await _execute_crawlee_scraper(tool_args, config.get('parameters', {}))# Proxy nodes (dual-purpose: workflow node + AI tool)+ # Email nodes (dual-purpose: workflow node + AI tool)+ if node_type in ('emailSend', 'emailRead'):+ return await _execute_email_tool(node_type, tool_args, config.get('parameters', {}))+if node_type == 'proxyRequest':return await _execute_proxy_request(tool_args, config.get('parameters', {}), config)if node_type == 'proxyStatus':@@ -2505,3 +2509,14 @@ async def _execute_perplexity_search_tool(args: Dict[str, Any],parameters=parameters,context={})+++async def _execute_email_tool(node_type: str, args: Dict[str, Any],+ node_params: Dict[str, Any]) -> Dict[str, Any]:+ """Execute email send/read as AI tool via EmailService."""+ from services.email_service import get_email_service+ svc = get_email_service()+ params = {**node_params, **{k: v for k, v in args.items() if v is not None}}+ if node_type == 'emailSend':+ return await svc.send(params)+ return await svc.read(params)diff --git a/server/services/node_executor.py b/server/services/node_executor.pyindex ab738fd5..a07f71e7 100644--- a/server/services/node_executor.py+++ b/server/services/node_executor.py@@ -49,6 +49,7 @@ from services.handlers.browser import handle_browserfrom services.handlers.proxy import handle_proxy_request, handle_proxy_status, handle_proxy_configfrom services.handlers.filesystem import handle_file_read, handle_file_modify, handle_shell, handle_fs_searchfrom services.handlers.todo import handle_write_todos+from services.handlers.email import handle_email_send, handle_email_read, handle_email_receive# Consolidated Google Workspace handlers (6 services with operation dispatchers)from services.handlers.gmail import handle_google_gmail, handle_gmail_receivefrom services.handlers.calendar import handle_google_calendar@@ -158,6 +159,10 @@ class NodeExecutor:'whatsappDb': handle_whatsapp_db,# Telegram (telegramReceive routed via generic handle_trigger_node)'telegramSend': handle_telegram_send,+ # Email (Himalaya CLI)+ 'emailSend': handle_email_send,+ 'emailRead': handle_email_read,+ 'emailReceive': handle_email_receive,# Twitter/X'twitterSend': handle_twitter_send,'twitterSearch': handle_twitter_search,