opc-agent 1.4.0 → 2.0.1

package/src/channels/email.ts

@@ -1,177 +1,351 @@
-import { BaseChannel } from './index';
-import type { Message } from '../core/types';
-
-/**
- * Email Channel — v0.8.0
- * IMAP polling for incoming emails, SMTP for sending replies.
- * Parses email threads as conversations.
- */
-
-export interface EmailChannelConfig {
-  imap: {
-    host: string;
-    port: number;
-    user: string;
-    password: string;
-    tls?: boolean;
-    /** Mailbox to monitor (default: INBOX) */
-    mailbox?: string;
-    /** Poll interval in ms (default: 30000) */
-    pollInterval?: number;
-  };
-  smtp: {
-    host: string;
-    port: number;
-    user: string;
-    password: string;
-    tls?: boolean;
-    from: string;
-  };
-  /** Filter: only process emails matching these patterns */
-  filters?: {
-    from?: string[];
-    subject?: string[];
-  };
-}
-
-export interface EmailMessage {
-  messageId: string;
-  from: string;
-  to: string[];
-  cc?: string[];
-  subject: string;
-  body: string;
-  html?: string;
-  date: Date;
-  inReplyTo?: string;
-  references?: string[];
-  threadId?: string;
-}
-
-export class EmailChannel extends BaseChannel {
-  type = 'email';
-  private config: EmailChannelConfig;
-  private pollTimer: ReturnType<typeof setInterval> | null = null;
-  private running = false;
-  private processedIds: Set<string> = new Set();
-
-  constructor(config: EmailChannelConfig) {
-    super();
-    this.config = config;
-  }
-
-  async start(): Promise<void> {
-    this.running = true;
-    const interval = this.config.imap.pollInterval ?? 30000;
-
-    // Initial poll
-    await this.poll();
-
-    // Set up recurring poll
-    this.pollTimer = setInterval(() => {
-      if (this.running) this.poll().catch(console.error);
-    }, interval);
-  }
-
-  async stop(): Promise<void> {
-    this.running = false;
-    if (this.pollTimer) {
-      clearInterval(this.pollTimer);
-      this.pollTimer = null;
-    }
-  }
-
-  /** Poll IMAP for new emails */
-  private async poll(): Promise<void> {
-    // In production, use a library like `imapflow` or `imap-simple`
-    // This is the integration point — actual IMAP connection logic goes here
-    const emails = await this.fetchEmails();
-
-    for (const email of emails) {
-      if (this.processedIds.has(email.messageId)) continue;
-      this.processedIds.add(email.messageId);
-
-      if (!this.matchesFilters(email)) continue;
-
-      const message = this.emailToMessage(email);
-      if (this.handler) {
-        const reply = await this.handler(message);
-        await this.sendReply(email, reply);
-      }
-    }
-  }
-
-  /** Convert email to Message format */
-  private emailToMessage(email: EmailMessage): Message {
-    return {
-      id: email.messageId,
-      role: 'user',
-      content: email.body,
-      timestamp: email.date.getTime(),
-      metadata: {
-        channel: 'email',
-        from: email.from,
-        to: email.to,
-        subject: email.subject,
-        threadId: email.threadId ?? email.messageId,
-        inReplyTo: email.inReplyTo,
-      },
-    };
-  }
-
-  /** Check if email matches configured filters */
-  private matchesFilters(email: EmailMessage): boolean {
-    if (!this.config.filters) return true;
-
-    if (this.config.filters.from?.length) {
-      const fromMatch = this.config.filters.from.some((f) =>
-        email.from.toLowerCase().includes(f.toLowerCase())
-      );
-      if (!fromMatch) return false;
-    }
-
-    if (this.config.filters.subject?.length) {
-      const subjectMatch = this.config.filters.subject.some((s) =>
-        email.subject.toLowerCase().includes(s.toLowerCase())
-      );
-      if (!subjectMatch) return false;
-    }
-
-    return true;
-  }
-
-  /** Fetch emails via IMAP — stub for actual implementation */
-  private async fetchEmails(): Promise<EmailMessage[]> {
-    // TODO: Implement with imapflow or similar library
-    // const { ImapFlow } = await import('imapflow');
-    // const client = new ImapFlow({ ...this.config.imap });
-    // await client.connect();
-    // ...
-    return [];
-  }
-
-  /** Send reply via SMTP — stub for actual implementation */
-  async sendReply(originalEmail: EmailMessage, reply: Message): Promise<void> {
-    // TODO: Implement with nodemailer or similar library
-    // const nodemailer = await import('nodemailer');
-    // const transport = nodemailer.createTransport({ ...this.config.smtp });
-    // await transport.sendMail({
-    //   from: this.config.smtp.from,
-    //   to: originalEmail.from,
-    //   subject: `Re: ${originalEmail.subject}`,
-    //   text: reply.content,
-    //   inReplyTo: originalEmail.messageId,
-    //   references: [originalEmail.messageId],
-    // });
-    void originalEmail;
-    void reply;
-  }
-
-  /** Send a standalone email */
-  async send(to: string, subject: string, body: string): Promise<void> {
-    void to;
-    void subject;
-    void body;
-    // TODO: Implement with nodemailer
-  }
-}
+import { BaseChannel } from './index';
+import type { Message } from '../core/types';
+import * as http from 'http';
+import * as net from 'net';
+import * as tls from 'tls';
+import * as crypto from 'crypto';
+
+/**
+ * Email Channel — v1.0.0
+ *
+ * Supports two modes:
+ * - webhook: Receives emails via HTTP POST (works with email forwarding services)
+ * - imap: TODO - Full IMAP polling (complex, requires raw socket IMAP protocol)
+ *
+ * Sends via SMTP with STARTTLS support using Node.js built-in tls module.
+ * No external dependencies (no nodemailer).
+ */
+
+export interface EmailChannelConfig {
+  /** Mode: 'webhook' (recommended) or 'imap' (TODO) */
+  mode?: 'webhook' | 'imap';
+  smtp?: {
+    host: string;
+    port: number;
+    user: string;
+    pass: string;
+    from?: string;
+  };
+  imap?: {
+    host: string;
+    port: number;
+    user: string;
+    password: string;
+    tls?: boolean;
+    mailbox?: string;
+    pollInterval?: number;
+  };
+  /** Webhook server port (default: 8082) */
+  webhookPort?: number;
+  /** Filter: only process emails from these addresses */
+  filters?: {
+    from?: string[];
+    subject?: string[];
+  };
+}
+
+export interface EmailMessage {
+  messageId: string;
+  from: string;
+  to: string[];
+  cc?: string[];
+  subject: string;
+  body: string;
+  html?: string;
+  date: Date;
+  inReplyTo?: string;
+  references?: string[];
+  threadId?: string;
+}
+
+export class EmailChannel extends BaseChannel {
+  type = 'email';
+  private config: EmailChannelConfig;
+  private server: http.Server | null = null;
+  private processedIds: Set<string> = new Set();
+
+  constructor(config: EmailChannelConfig) {
+    super();
+    this.config = config;
+  }
+
+  async start(): Promise<void> {
+    const mode = this.config.mode ?? 'webhook';
+    if (mode === 'webhook') {
+      await this.startWebhook();
+    } else {
+      console.warn('[EmailChannel] IMAP mode is not yet implemented. Use webhook mode.');
+    }
+  }
+
+  async stop(): Promise<void> {
+    return new Promise((resolve, reject) => {
+      if (!this.server) return resolve();
+      this.server.close((err) => (err ? reject(err) : resolve()));
+      this.server = null;
+    });
+  }
+
+  /** Start webhook HTTP server */
+  private async startWebhook(): Promise<void> {
+    const port = this.config.webhookPort ?? 8082;
+
+    this.server = http.createServer(async (req, res) => {
+      if (req.method === 'GET' && req.url === '/health') {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ status: 'ok', channel: 'email', mode: 'webhook' }));
+        return;
+      }
+
+      if (req.method === 'POST' && (req.url === '/email/incoming' || req.url === '/')) {
+        try {
+          const body = await this.readBody(req);
+          const parsed = JSON.parse(body);
+          const email = EmailChannel.parseWebhookPayload(parsed);
+
+          if (!email) {
+            res.writeHead(400, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: 'Invalid email payload' }));
+            return;
+          }
+
+          // Deduplicate
+          if (this.processedIds.has(email.messageId)) {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, duplicate: true }));
+            return;
+          }
+          this.processedIds.add(email.messageId);
+          if (this.processedIds.size > 5000) {
+            const arr = [...this.processedIds];
+            this.processedIds = new Set(arr.slice(-2500));
+          }
+
+          // Apply filters
+          if (!this.matchesFilters(email)) {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ ok: true, filtered: true }));
+            return;
+          }
+
+          res.writeHead(200, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ ok: true }));
+
+          // Process async
+          if (this.handler) {
+            const msg = this.emailToMessage(email);
+            try {
+              const reply = await this.handler(msg);
+              if (this.config.smtp) {
+                await this.sendEmail(
+                  email.from,
+                  `Re: ${email.subject}`,
+                  reply.content,
+                  email.messageId
+                );
+              }
+            } catch (err) {
+              console.error('[EmailChannel] Handler error:', err);
+            }
+          }
+        } catch (err) {
+          console.error('[EmailChannel] Webhook error:', err);
+          res.writeHead(500, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ error: 'Internal error' }));
+        }
+        return;
+      }
+
+      res.writeHead(404);
+      res.end('Not Found');
+    });
+
+    return new Promise((resolve) => {
+      this.server!.listen(port, () => {
+        console.log(`[EmailChannel] Webhook listening on port ${port}`);
+        resolve();
+      });
+    });
+  }
+
+  /** Parse webhook payload into EmailMessage */
+  static parseWebhookPayload(payload: any): EmailMessage | null {
+    // Support common email webhook formats (SendGrid, Mailgun, generic)
+    const from = payload.from ?? payload.sender ?? payload.envelope?.from;
+    const subject = payload.subject ?? '(no subject)';
+    const body = payload.body ?? payload.text ?? payload['body-plain'] ?? payload.content ?? '';
+    const to = payload.to ?? payload.recipient ?? payload.envelope?.to;
+
+    if (!from) return null;
+
+    return {
+      messageId: payload.messageId ?? payload['Message-Id'] ?? payload.id ?? `email-${Date.now()}-${crypto.randomBytes(4).toString('hex')}`,
+      from: typeof from === 'string' ? from : String(from),
+      to: Array.isArray(to) ? to : (typeof to === 'string' ? [to] : []),
+      cc: payload.cc ? (Array.isArray(payload.cc) ? payload.cc : [payload.cc]) : undefined,
+      subject,
+      body,
+      html: payload.html ?? payload['body-html'],
+      date: payload.date ? new Date(payload.date) : new Date(),
+      inReplyTo: payload.inReplyTo ?? payload['In-Reply-To'],
+      references: payload.references ? (Array.isArray(payload.references) ? payload.references : [payload.references]) : undefined,
+      threadId: payload.threadId,
+    };
+  }
+
+  /** Convert email to internal Message */
+  private emailToMessage(email: EmailMessage): Message {
+    return {
+      id: email.messageId,
+      role: 'user',
+      content: email.body,
+      timestamp: email.date.getTime(),
+      metadata: {
+        channel: 'email',
+        from: email.from,
+        to: email.to,
+        subject: email.subject,
+        threadId: email.threadId ?? email.messageId,
+        inReplyTo: email.inReplyTo,
+      },
+    };
+  }
+
+  /** Check if email matches configured filters */
+  matchesFilters(email: EmailMessage): boolean {
+    if (!this.config.filters) return true;
+
+    if (this.config.filters.from?.length) {
+      const fromMatch = this.config.filters.from.some((f) =>
+        email.from.toLowerCase().includes(f.toLowerCase())
+      );
+      if (!fromMatch) return false;
+    }
+
+    if (this.config.filters.subject?.length) {
+      const subjectMatch = this.config.filters.subject.some((s) =>
+        email.subject.toLowerCase().includes(s.toLowerCase())
+      );
+      if (!subjectMatch) return false;
+    }
+
+    return true;
+  }
+
+  /** Send email via SMTP with STARTTLS */
+  async sendEmail(to: string, subject: string, body: string, inReplyTo?: string): Promise<void> {
+    const smtp = this.config.smtp;
+    if (!smtp) throw new Error('[EmailChannel] SMTP not configured');
+
+    const from = smtp.from ?? smtp.user;
+    const messageId = `<${crypto.randomBytes(16).toString('hex')}@opc-agent>`;
+
+    let headers = `From: ${from}\r\n`;
+    headers += `To: ${to}\r\n`;
+    headers += `Subject: ${subject}\r\n`;
+    headers += `Message-ID: ${messageId}\r\n`;
+    headers += `Date: ${new Date().toUTCString()}\r\n`;
+    if (inReplyTo) {
+      headers += `In-Reply-To: ${inReplyTo}\r\n`;
+      headers += `References: ${inReplyTo}\r\n`;
+    }
+    headers += `MIME-Version: 1.0\r\n`;
+    headers += `Content-Type: text/plain; charset=UTF-8\r\n`;
+    headers += `\r\n`;
+    headers += body;
+
+    await this.smtpSend(smtp.host, smtp.port, smtp.user, smtp.pass, from, to, headers);
+  }
+
+  /** Raw SMTP send with STARTTLS */
+  private smtpSend(
+    host: string, port: number,
+    user: string, pass: string,
+    from: string, to: string,
+    message: string
+  ): Promise<void> {
+    return new Promise((resolve, reject) => {
+      let socket: net.Socket | tls.TLSSocket = net.createConnection(port, host);
+      let upgraded = false;
+      let step = 0;
+
+      const commands = [
+        `EHLO opc-agent\r\n`,
+        `STARTTLS\r\n`,
+        // After TLS upgrade:
+        `EHLO opc-agent\r\n`,
+        `AUTH LOGIN\r\n`,
+        `${Buffer.from(user).toString('base64')}\r\n`,
+        `${Buffer.from(pass).toString('base64')}\r\n`,
+        `MAIL FROM:<${from}>\r\n`,
+        `RCPT TO:<${to}>\r\n`,
+        `DATA\r\n`,
+        `${message}\r\n.\r\n`,
+        `QUIT\r\n`,
+      ];
+
+      const sendNext = () => {
+        if (step < commands.length) {
+          socket.write(commands[step]);
+          step++;
+        }
+      };
+
+      socket.on('data', (data: Buffer) => {
+        const response = data.toString();
+        const code = parseInt(response.substring(0, 3), 10);
+
+        if (code >= 400) {
+          socket.destroy();
+          reject(new Error(`SMTP error: ${response.trim()}`));
+          return;
+        }
+
+        // After STARTTLS response (220), upgrade to TLS
+        if (step === 2 && !upgraded && response.startsWith('220')) {
+          upgraded = true;
+          const tlsSocket = tls.connect({ socket, host, servername: host }, () => {
+            socket = tlsSocket;
+            sendNext(); // EHLO again after TLS
+          });
+          tlsSocket.on('data', (d: Buffer) => {
+            const resp = d.toString();
+            const c = parseInt(resp.substring(0, 3), 10);
+            if (c >= 400) {
+              tlsSocket.destroy();
+              reject(new Error(`SMTP error: ${resp.trim()}`));
+              return;
+            }
+            if (step === commands.length && resp.startsWith('221')) {
+              tlsSocket.destroy();
+              resolve();
+              return;
+            }
+            sendNext();
+          });
+          tlsSocket.on('error', reject);
+          return;
+        }
+
+        sendNext();
+      });
+
+      socket.on('error', reject);
+      socket.on('timeout', () => {
+        socket.destroy();
+        reject(new Error('SMTP connection timeout'));
+      });
+      socket.setTimeout(30000);
+    });
+  }
+
+  /** Read request body */
+  private readBody(req: http.IncomingMessage): Promise<string> {
+    return new Promise((resolve, reject) => {
+      const chunks: Buffer[] = [];
+      req.on('data', (chunk: Buffer) => chunks.push(chunk));
+      req.on('end', () => resolve(Buffer.concat(chunks).toString('utf-8')));
+      req.on('error', reject);
+    });
+  }
+}