Skip to content

Self-improving AI Employees for everyone

feat: email nodes via Himalaya CLI (send, read, receive trigger)

trohitg4167b5757c3e
diff --git a/client/src/Dashboard.tsx b/client/src/Dashboard.tsx
index 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.ts
new file mode 100644
index 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.svg
new file mode 100644
index 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.svg
new file mode 100644
index 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.svg
new file mode 100644
index 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.tsx
index 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 detection
const isFilesystemNode = ['fileRead', 'fileModify', 'shell', 'fsSearch'].includes(nodeType);
+ // Email node detection (Himalaya CLI)
+ const isEmailNode = ['emailSend', 'emailRead', 'emailReceive'].includes(nodeType);
+
// Select appropriate schema
if (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.ts
index 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 access
export { createBaseChatModel } from './nodeDefinitions/aiModelNodes';
diff --git a/client/src/nodeDefinitions/emailNodes.ts b/client/src/nodeDefinitions/emailNodes.ts
new file mode 100644
index 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.ts
index 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.json
index 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.py
index 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_TYPES
POLLING_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.py
index 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 nodes
class GenericToolSchema(BaseModel):
"""Generic schema for tool arguments."""
diff --git a/server/services/deployment/manager.py b/server/services/deployment/manager.py
index 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.py
new file mode 100644
index 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.py
index 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 type
FILTER_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__.py
index 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 handler
from .crawlee import handle_crawlee_scraper
@@ -210,6 +213,10 @@ __all__ = [
'handle_file_modify',
'handle_shell',
'handle_fs_search',
+ # Email
+ '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.py
new file mode 100644
index 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.py
index 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.py
index 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_browser
from services.handlers.proxy import handle_proxy_request, handle_proxy_status, handle_proxy_config
from services.handlers.filesystem import handle_file_read, handle_file_modify, handle_shell, handle_fs_search
from 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_receive
from 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,