neoagent 3.1.0 → 3.1.1-beta.0

package/server/services/integrations/registry.js

@@ -11,6 +11,7 @@ const { createSpotifyProvider } = require('./spotify/provider');
 const { createSlackProvider } = require('./slack/provider');
 const { createWeatherProvider } = require('./weather/provider');
 const { createWhatsAppPersonalProvider } = require('./whatsapp');
+const { createNeoMailProvider } = require('./neomail/provider');
 
 function createIntegrationRegistry(options = {}) {
   const providers = [
@@ -23,6 +24,7 @@ function createIntegrationRegistry(options = {}) {
     createTrelloProvider(),
     createWeatherProvider(),
     createSpotifyProvider(),
+    createNeoMailProvider(),
     createHomeAssistantProvider(),
     createWhatsAppPersonalProvider(options),
   ];

package/server/services/tasks/adapters/index.js

@@ -5,11 +5,11 @@ module.exports = [
   require('./manual'),
   require('./webhook'),
   require('./gmail_message_received'),
+  require('./neomail_email_received'),
   require('./outlook_email_received'),
   require('./slack_message_received'),
   require('./teams_message_received'),
   require('./weather_event'),
-  require('./webhook'),
   require('./whatsapp_personal_message_received'),
   require('./android_notification_received'),
 ];

package/server/services/tasks/adapters/neomail_email_received.js

@@ -0,0 +1,46 @@
+'use strict';
+
+const {
+  ensureOwnedIntegrationConnection,
+  normalizeBoolean,
+  normalizeTrimmedText,
+} = require('../security');
+
+module.exports = {
+  type: 'neomail_email_received',
+  label: 'NeoMail Email Received',
+  providerKey: 'neomail',
+  appKey: 'mailbox',
+  async validateConfig(config = {}, context = {}) {
+    const connection = ensureOwnedIntegrationConnection(context.integrationManager, {
+      userId: context.userId,
+      agentId: context.agentId,
+      connectionId: config.connectionId || config.connection_id,
+      providerKey: 'neomail',
+      appKey: 'mailbox',
+    });
+    return {
+      connectionId: connection.id,
+      accountEmail: connection.account_email || null,
+      mailAccountId: normalizeTrimmedText(
+        config.mailAccountId || config.mail_account_id,
+        120,
+      ),
+      folder: normalizeTrimmedText(config.folder, 200),
+      query: normalizeTrimmedText(config.query, 500),
+      unreadOnly: normalizeBoolean(
+        config.unreadOnly ?? config.unread_only,
+        false,
+      ),
+    };
+  },
+  summarize(config = {}) {
+    const parts = ['NeoMail'];
+    if (config.accountEmail) parts.push(config.accountEmail);
+    if (config.mailAccountId) parts.push(`mailbox: ${config.mailAccountId}`);
+    if (config.folder) parts.push(`folder: ${config.folder}`);
+    if (config.query) parts.push(`query: ${config.query}`);
+    if (config.unreadOnly) parts.push('unread only');
+    return parts.join(' · ');
+  },
+};

package/server/services/tasks/integration_runtime.js

@@ -5,6 +5,7 @@ const { normalizeJsonObject } = require('./utils');
 
 const POLLED_TRIGGER_TYPES = Object.freeze([
   'gmail_message_received',
+  'neomail_email_received',
   'outlook_email_received',
   'slack_message_received',
   'teams_message_received',
@@ -13,10 +14,19 @@ const POLLED_TRIGGER_TYPES = Object.freeze([
 ]);
 
 function sortByTimestamp(left, right) {
-  return String(left.timestamp).localeCompare(String(right.timestamp));
+  const timeOrder = String(left.timestamp).localeCompare(String(right.timestamp));
+  if (timeOrder !== 0) return timeOrder;
+  return String(left.fingerprint).localeCompare(String(right.fingerprint));
 }
 
-async function fetchTriggerRows({ integrationManager, userId, agentId, triggerType, config }) {
+async function fetchTriggerRows({
+  integrationManager,
+  userId,
+  agentId,
+  triggerType,
+  config,
+  lastTriggeredAt,
+}) {
   if (!integrationManager) return [];
   const scopedAgentId = resolveAgentId(userId, agentId);
   const connectionArg = {
@@ -80,6 +90,53 @@ async function fetchTriggerRows({ integrationManager, userId, agentId, triggerTy
       .sort(sortByTimestamp);
   }
 
+  if (triggerType === 'neomail_email_received') {
+    const provider = integrationManager.getProvider('neomail');
+    if (!provider || typeof provider.fetchTriggerEvents !== 'function') {
+      return [];
+    }
+    const connectionId = Number(config.connectionId);
+    if (!Number.isInteger(connectionId) || connectionId <= 0) {
+      return [];
+    }
+    const connection = integrationManager.getConnectionById(
+      userId,
+      connectionId,
+      scopedAgentId,
+    );
+    if (
+      !connection ||
+      String(connection.provider_key || '').trim() !== 'neomail' ||
+      String(connection.app_key || '').trim() !== 'mailbox' ||
+      String(connection.status || '').trim() !== 'connected'
+    ) {
+      return [];
+    }
+    const result = await provider.fetchTriggerEvents({
+      connection,
+      config,
+      since: lastTriggeredAt,
+      limit: 100,
+    });
+    if (result?.credentials) {
+      const existingCredentials = integrationManager.parseCredentials(
+        connection.credentials_json,
+      );
+      const mergedCredentials = integrationManager.mergeUpdatedCredentials(
+        existingCredentials,
+        result.credentials,
+      );
+      integrationManager.persistSharedCredentials(
+        userId,
+        scopedAgentId,
+        'neomail',
+        connection.account_email,
+        mergedCredentials,
+      );
+    }
+    return Array.isArray(result?.rows) ? result.rows.slice().sort(sortByTimestamp) : [];
+  }
+
   if (triggerType === 'slack_message_received') {
     const result = await integrationManager.executeTool(userId, 'slack_get_conversation_history', {
       ...connectionArg,
@@ -262,13 +319,20 @@ async function pollIntegrationTask(runtime, task) {
     agentId: task.agent_id,
     triggerType: task.trigger_type,
     config,
+    lastTriggeredAt: task.last_triggered_at,
   });
   if (!rows.length) return;
 
   const existingFingerprint = String(task.last_trigger_fingerprint || '');
   const latestFingerprint = rows[rows.length - 1].fingerprint;
+  const latestTimestamp = rows[rows.length - 1].timestamp;
   if (!existingFingerprint) {
-    runtime.taskRepository.markTaskTriggerCheckpoint(task.id, latestFingerprint, task.user_id);
+    runtime.taskRepository.markTaskTriggerCheckpoint(
+      task.id,
+      latestFingerprint,
+      task.user_id,
+      latestTimestamp,
+    );
     return;
   }
 

package/server/services/tasks/runtime.js

@@ -332,7 +332,12 @@ class TaskRuntime {
       triggerPayload: triggerPayload.context || {},
     });
     if (!result?.error && !result?.skipped) {
-      this.taskRepository.markTaskTriggered(taskId, userId, fingerprint);
+      this.taskRepository.markTaskTriggered(
+        taskId,
+        userId,
+        fingerprint,
+        triggerPayload.timestamp,
+      );
     }
     return result;
   }

package/server/services/tasks/task_repository.js

@@ -3,6 +3,13 @@
 const db = require('../../db/database');
 
 class TaskRepository {
+  normalizeTriggerTimestamp(value) {
+    const text = String(value || '').trim();
+    if (!text) return new Date().toISOString();
+    const parsed = new Date(text);
+    return Number.isNaN(parsed.getTime()) ? new Date().toISOString() : parsed.toISOString();
+  }
+
   createTask(userId, normalizedTask) {
     const result = db.prepare(
       `INSERT INTO scheduled_tasks (
@@ -124,20 +131,20 @@ class TaskRepository {
     ).all(userId, agentId);
   }
 
-  markTaskTriggered(taskId, userId, fingerprint) {
+  markTaskTriggered(taskId, userId, fingerprint, triggeredAt = null) {
     db.prepare(
       `UPDATE scheduled_tasks
-       SET last_triggered_at = datetime('now'), last_trigger_fingerprint = ?
+       SET last_triggered_at = ?, last_trigger_fingerprint = ?
        WHERE id = ? AND user_id = ?`
-    ).run(fingerprint, taskId, userId);
+    ).run(this.normalizeTriggerTimestamp(triggeredAt), fingerprint, taskId, userId);
   }
 
-  markTaskTriggerCheckpoint(taskId, fingerprint, userId) {
+  markTaskTriggerCheckpoint(taskId, fingerprint, userId, triggeredAt = null) {
     db.prepare(
       `UPDATE scheduled_tasks
-       SET last_triggered_at = datetime('now'), last_trigger_fingerprint = ?
+       SET last_triggered_at = ?, last_trigger_fingerprint = ?
        WHERE id = ? AND user_id = ?`
-    ).run(fingerprint, taskId, userId);
+    ).run(this.normalizeTriggerTimestamp(triggeredAt), fingerprint, taskId, userId);
   }
 
   markTaskRun(taskId, userId) {