@agenticmail/enterprise 0.5.49 → 0.5.51

package/src/agenticmail/providers/microsoft.ts

@@ -0,0 +1,260 @@
+/**
+ * Microsoft Graph Email Provider
+ *
+ * Implements IEmailProvider using Microsoft Graph API.
+ * Agent authenticates via org's Azure AD / Entra ID OAuth.
+ * Email address comes from the org directory.
+ */
+
+import type {
+  IEmailProvider, AgentEmailIdentity, EmailProvider,
+  EmailMessage, EmailEnvelope, EmailFolder,
+  SendEmailOptions, SearchCriteria,
+} from '../types.js';
+
+const GRAPH_BASE = 'https://graph.microsoft.com/v1.0';
+
+export class MicrosoftEmailProvider implements IEmailProvider {
+  readonly provider: EmailProvider = 'microsoft';
+  private identity: AgentEmailIdentity | null = null;
+
+  private get token(): string {
+    if (!this.identity) throw new Error('Not connected');
+    return this.identity.accessToken;
+  }
+
+  private async refreshIfNeeded(): Promise<void> {
+    if (this.identity?.refreshToken) {
+      this.identity.accessToken = await this.identity.refreshToken();
+    }
+  }
+
+  private async graphFetch(path: string, opts?: RequestInit): Promise<any> {
+    await this.refreshIfNeeded();
+    const res = await fetch(`${GRAPH_BASE}${path}`, {
+      ...opts,
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        'Content-Type': 'application/json',
+        ...opts?.headers,
+      },
+    });
+    if (!res.ok) {
+      const text = await res.text().catch(() => '');
+      throw new Error(`Graph API ${res.status}: ${text}`);
+    }
+    if (res.status === 204) return null;
+    return res.json();
+  }
+
+  // ─── Connection ─────────────────────────────────────
+
+  async connect(identity: AgentEmailIdentity): Promise<void> {
+    this.identity = identity;
+    // Validate token by fetching profile
+    await this.graphFetch('/me?$select=mail,displayName');
+  }
+
+  async disconnect(): Promise<void> {
+    this.identity = null;
+  }
+
+  // ─── List / Read ────────────────────────────────────
+
+  async listMessages(folder: string, opts?: { limit?: number; offset?: number }): Promise<EmailEnvelope[]> {
+    const folderId = this.resolveFolderId(folder);
+    const top = opts?.limit || 20;
+    const skip = opts?.offset || 0;
+    const data = await this.graphFetch(
+      `/me/mailFolders/${folderId}/messages?$top=${top}&$skip=${skip}&$select=id,subject,from,toRecipients,receivedDateTime,isRead,flag,hasAttachments,bodyPreview&$orderby=receivedDateTime desc`
+    );
+    return (data.value || []).map((m: any) => this.toEnvelope(m));
+  }
+
+  async readMessage(uid: string): Promise<EmailMessage> {
+    const data = await this.graphFetch(`/me/messages/${uid}?$select=id,subject,from,toRecipients,ccRecipients,bccRecipients,receivedDateTime,isRead,flag,hasAttachments,body,bodyPreview,replyTo,internetMessageId,internetMessageHeaders,conversationId`);
+    return this.toMessage(data);
+  }
+
+  async searchMessages(criteria: SearchCriteria): Promise<EmailEnvelope[]> {
+    const filters: string[] = [];
+    if (criteria.from) filters.push(`from/emailAddress/address eq '${criteria.from}'`);
+    if (criteria.subject) filters.push(`contains(subject, '${criteria.subject}')`);
+    if (criteria.since) filters.push(`receivedDateTime ge ${criteria.since}`);
+    if (criteria.before) filters.push(`receivedDateTime lt ${criteria.before}`);
+    if (criteria.seen !== undefined) filters.push(`isRead eq ${criteria.seen}`);
+
+    let path = '/me/messages?$top=50&$select=id,subject,from,toRecipients,receivedDateTime,isRead,flag,hasAttachments,bodyPreview&$orderby=receivedDateTime desc';
+    if (filters.length) path += '&$filter=' + encodeURIComponent(filters.join(' and '));
+    if (criteria.text) path = `/me/messages?$search="${encodeURIComponent(criteria.text)}"&$top=50&$select=id,subject,from,toRecipients,receivedDateTime,isRead,flag,hasAttachments,bodyPreview`;
+
+    const data = await this.graphFetch(path);
+    return (data.value || []).map((m: any) => this.toEnvelope(m));
+  }
+
+  async listFolders(): Promise<EmailFolder[]> {
+    const data = await this.graphFetch('/me/mailFolders?$select=id,displayName,unreadItemCount,totalItemCount');
+    return (data.value || []).map((f: any) => ({
+      name: f.displayName,
+      path: f.id,
+      unread: f.unreadItemCount || 0,
+      total: f.totalItemCount || 0,
+    }));
+  }
+
+  async createFolder(name: string): Promise<void> {
+    await this.graphFetch('/me/mailFolders', {
+      method: 'POST',
+      body: JSON.stringify({ displayName: name }),
+    });
+  }
+
+  // ─── Send ───────────────────────────────────────────
+
+  async send(options: SendEmailOptions): Promise<{ messageId: string }> {
+    const message = this.buildGraphMessage(options);
+    await this.graphFetch('/me/sendMail', {
+      method: 'POST',
+      body: JSON.stringify({ message, saveToSentItems: true }),
+    });
+    return { messageId: `graph-${Date.now()}` };
+  }
+
+  async reply(uid: string, body: string, replyAll = false): Promise<{ messageId: string }> {
+    const endpoint = replyAll ? 'replyAll' : 'reply';
+    await this.graphFetch(`/me/messages/${uid}/${endpoint}`, {
+      method: 'POST',
+      body: JSON.stringify({ comment: body }),
+    });
+    return { messageId: `graph-reply-${Date.now()}` };
+  }
+
+  async forward(uid: string, to: string, body?: string): Promise<{ messageId: string }> {
+    await this.graphFetch(`/me/messages/${uid}/forward`, {
+      method: 'POST',
+      body: JSON.stringify({
+        comment: body || '',
+        toRecipients: [{ emailAddress: { address: to } }],
+      }),
+    });
+    return { messageId: `graph-fwd-${Date.now()}` };
+  }
+
+  // ─── Organize ───────────────────────────────────────
+
+  async moveMessage(uid: string, toFolder: string): Promise<void> {
+    const folderId = this.resolveFolderId(toFolder);
+    await this.graphFetch(`/me/messages/${uid}/move`, {
+      method: 'POST',
+      body: JSON.stringify({ destinationId: folderId }),
+    });
+  }
+
+  async deleteMessage(uid: string): Promise<void> {
+    await this.graphFetch(`/me/messages/${uid}`, { method: 'DELETE' });
+  }
+
+  async markRead(uid: string): Promise<void> {
+    await this.graphFetch(`/me/messages/${uid}`, {
+      method: 'PATCH',
+      body: JSON.stringify({ isRead: true }),
+    });
+  }
+
+  async markUnread(uid: string): Promise<void> {
+    await this.graphFetch(`/me/messages/${uid}`, {
+      method: 'PATCH',
+      body: JSON.stringify({ isRead: false }),
+    });
+  }
+
+  async flagMessage(uid: string): Promise<void> {
+    await this.graphFetch(`/me/messages/${uid}`, {
+      method: 'PATCH',
+      body: JSON.stringify({ flag: { flagStatus: 'flagged' } }),
+    });
+  }
+
+  async unflagMessage(uid: string): Promise<void> {
+    await this.graphFetch(`/me/messages/${uid}`, {
+      method: 'PATCH',
+      body: JSON.stringify({ flag: { flagStatus: 'notFlagged' } }),
+    });
+  }
+
+  // ─── Batch ──────────────────────────────────────────
+
+  async batchMarkRead(uids: string[]): Promise<void> {
+    await Promise.all(uids.map(uid => this.markRead(uid)));
+  }
+
+  async batchMarkUnread(uids: string[]): Promise<void> {
+    await Promise.all(uids.map(uid => this.markUnread(uid)));
+  }
+
+  async batchMove(uids: string[], toFolder: string): Promise<void> {
+    await Promise.all(uids.map(uid => this.moveMessage(uid, toFolder)));
+  }
+
+  async batchDelete(uids: string[]): Promise<void> {
+    await Promise.all(uids.map(uid => this.deleteMessage(uid)));
+  }
+
+  // ─── Helpers ────────────────────────────────────────
+
+  private resolveFolderId(folder: string): string {
+    const map: Record<string, string> = {
+      INBOX: 'inbox', inbox: 'inbox',
+      Sent: 'sentItems', sent: 'sentItems', sentitems: 'sentItems',
+      Drafts: 'drafts', drafts: 'drafts',
+      Trash: 'deletedItems', trash: 'deletedItems', deleteditems: 'deletedItems',
+      Junk: 'junkemail', junk: 'junkemail', spam: 'junkemail',
+      Archive: 'archive', archive: 'archive',
+    };
+    return map[folder] || folder;
+  }
+
+  private buildGraphMessage(options: SendEmailOptions): any {
+    const msg: any = {
+      subject: options.subject,
+      body: { contentType: options.html ? 'HTML' : 'Text', content: options.html || options.body },
+      toRecipients: options.to.split(',').map(e => ({ emailAddress: { address: e.trim() } })),
+    };
+    if (options.cc) msg.ccRecipients = options.cc.split(',').map(e => ({ emailAddress: { address: e.trim() } }));
+    if (options.bcc) msg.bccRecipients = options.bcc.split(',').map(e => ({ emailAddress: { address: e.trim() } }));
+    if (options.inReplyTo) msg.internetMessageHeaders = [{ name: 'In-Reply-To', value: options.inReplyTo }];
+    return msg;
+  }
+
+  private toEnvelope(m: any): EmailEnvelope {
+    return {
+      uid: m.id,
+      from: { name: m.from?.emailAddress?.name, email: m.from?.emailAddress?.address || '' },
+      to: (m.toRecipients || []).map((r: any) => ({ name: r.emailAddress?.name, email: r.emailAddress?.address || '' })),
+      subject: m.subject || '',
+      date: m.receivedDateTime || '',
+      read: !!m.isRead,
+      flagged: m.flag?.flagStatus === 'flagged',
+      hasAttachments: !!m.hasAttachments,
+      preview: m.bodyPreview || '',
+    };
+  }
+
+  private toMessage(m: any): EmailMessage {
+    return {
+      uid: m.id,
+      from: { name: m.from?.emailAddress?.name, email: m.from?.emailAddress?.address || '' },
+      to: (m.toRecipients || []).map((r: any) => ({ name: r.emailAddress?.name, email: r.emailAddress?.address || '' })),
+      cc: (m.ccRecipients || []).map((r: any) => ({ name: r.emailAddress?.name, email: r.emailAddress?.address || '' })),
+      subject: m.subject || '',
+      body: m.body?.contentType === 'HTML' ? '' : (m.body?.content || ''),
+      html: m.body?.contentType === 'HTML' ? m.body?.content : undefined,
+      date: m.receivedDateTime || '',
+      read: !!m.isRead,
+      flagged: m.flag?.flagStatus === 'flagged',
+      folder: 'inbox',
+      messageId: m.internetMessageId,
+      attachments: [],
+    };
+  }
+}

package/src/agenticmail/types.ts

@@ -0,0 +1,171 @@
+/**
+ * AgenticMail Enterprise — Core Types
+ *
+ * These types define the email provider abstraction layer.
+ * In enterprise, agents get their email identity from the org's
+ * identity provider (Okta, Azure AD, Google Workspace).
+ * No separate AgenticMail server needed.
+ */
+
+// ─── Agent Email Identity ───────────────────────────────
+
+export interface AgentEmailIdentity {
+  /** Agent ID in the enterprise system */
+  agentId: string;
+  /** Agent display name */
+  name: string;
+  /** Agent email address (from org directory) */
+  email: string;
+  /** Org ID */
+  orgId: string;
+  /** OAuth access token for the email provider */
+  accessToken: string;
+  /** Token refresh callback */
+  refreshToken?: () => Promise<string>;
+  /** Provider type */
+  provider: EmailProvider;
+}
+
+export type EmailProvider = 'microsoft' | 'google' | 'imap';
+
+// ─── Email Types ────────────────────────────────────────
+
+export interface EmailMessage {
+  uid: string;
+  from: { name?: string; email: string };
+  to: { name?: string; email: string }[];
+  cc?: { name?: string; email: string }[];
+  bcc?: { name?: string; email: string }[];
+  subject: string;
+  body: string;
+  html?: string;
+  date: string;
+  read: boolean;
+  flagged: boolean;
+  folder: string;
+  replyTo?: string;
+  inReplyTo?: string;
+  references?: string[];
+  messageId?: string;
+  attachments?: EmailAttachment[];
+  headers?: Record<string, string>;
+}
+
+export interface EmailAttachment {
+  filename: string;
+  contentType: string;
+  size: number;
+  contentId?: string;
+}
+
+export interface EmailEnvelope {
+  uid: string;
+  from: { name?: string; email: string };
+  to: { name?: string; email: string }[];
+  subject: string;
+  date: string;
+  read: boolean;
+  flagged: boolean;
+  hasAttachments: boolean;
+  preview?: string;
+}
+
+export interface SendEmailOptions {
+  to: string;
+  cc?: string;
+  bcc?: string;
+  subject: string;
+  body: string;
+  html?: string;
+  replyTo?: string;
+  inReplyTo?: string;
+  references?: string[];
+  attachments?: { filename: string; content: string; contentType?: string; encoding?: string }[];
+}
+
+export interface SearchCriteria {
+  from?: string;
+  to?: string;
+  subject?: string;
+  text?: string;
+  since?: string;
+  before?: string;
+  seen?: boolean;
+}
+
+export interface EmailFolder {
+  name: string;
+  path: string;
+  unread: number;
+  total: number;
+}
+
+// ─── Email Provider Interface ───────────────────────────
+
+/**
+ * Abstract email provider that all backends must implement.
+ * Microsoft Graph, Gmail API, and generic IMAP all implement this.
+ */
+export interface IEmailProvider {
+  readonly provider: EmailProvider;
+
+  // ─── Connection ─────────────────────────────────────
+  connect(identity: AgentEmailIdentity): Promise<void>;
+  disconnect(): Promise<void>;
+
+  // ─── Inbox / Folders ────────────────────────────────
+  listMessages(folder: string, opts?: { limit?: number; offset?: number }): Promise<EmailEnvelope[]>;
+  readMessage(uid: string, folder?: string): Promise<EmailMessage>;
+  searchMessages(criteria: SearchCriteria): Promise<EmailEnvelope[]>;
+  listFolders(): Promise<EmailFolder[]>;
+  createFolder(name: string): Promise<void>;
+
+  // ─── Send ───────────────────────────────────────────
+  send(options: SendEmailOptions): Promise<{ messageId: string }>;
+  reply(uid: string, body: string, replyAll?: boolean): Promise<{ messageId: string }>;
+  forward(uid: string, to: string, body?: string): Promise<{ messageId: string }>;
+
+  // ─── Organize ───────────────────────────────────────
+  moveMessage(uid: string, toFolder: string, fromFolder?: string): Promise<void>;
+  deleteMessage(uid: string, folder?: string): Promise<void>;
+  markRead(uid: string, folder?: string): Promise<void>;
+  markUnread(uid: string, folder?: string): Promise<void>;
+  flagMessage(uid: string, folder?: string): Promise<void>;
+  unflagMessage(uid: string, folder?: string): Promise<void>;
+
+  // ─── Batch ──────────────────────────────────────────
+  batchMarkRead(uids: string[], folder?: string): Promise<void>;
+  batchMarkUnread(uids: string[], folder?: string): Promise<void>;
+  batchMove(uids: string[], toFolder: string, fromFolder?: string): Promise<void>;
+  batchDelete(uids: string[], folder?: string): Promise<void>;
+}
+
+// ─── Inter-Agent Communication ──────────────────────────
+
+export interface AgentMessage {
+  id: string;
+  from: string;        // agent ID
+  to: string;          // agent ID
+  subject: string;
+  body: string;
+  priority: 'normal' | 'high' | 'urgent';
+  createdAt: string;
+  read: boolean;
+}
+
+export interface AgentTask {
+  id: string;
+  assignee: string;    // agent ID
+  assigner: string;    // agent ID
+  title: string;
+  description?: string;
+  status: 'pending' | 'claimed' | 'completed' | 'cancelled';
+  priority: 'low' | 'normal' | 'high' | 'urgent';
+  result?: any;
+  createdAt: string;
+  updatedAt: string;
+}
+
+// ─── Storage ────────────────────────────────────────────
+// Storage in enterprise uses the engine's existing database
+// (already available via EngineDatabase). No separate storage needed.

package/src/agenticmail-core/index.ts

@@ -0,0 +1,36 @@
+/**
+ * AgenticMail Core — Self-contained copy for the enterprise package.
+ *
+ * Copied from @agenticmail/openclaw + @agenticmail/core so the enterprise
+ * package has zero runtime dependency on the main agenticmail packages.
+ *
+ * Source files:
+ *   tools.ts           ← packages/openclaw/src/tools.ts
+ *   pending-followup.ts ← packages/openclaw/src/pending-followup.ts
+ *   telemetry.ts       ← packages/core/src/telemetry.ts
+ */
+
+export {
+  registerTools,
+  registerAgentIdentity,
+  unregisterAgentIdentity,
+  setLastActivatedAgent,
+  clearLastActivatedAgent,
+  recordInboundAgentMessage,
+  type ToolContext,
+} from './tools.js';
+
+export {
+  scheduleFollowUp,
+  cancelFollowUp,
+  cancelAllFollowUps,
+  activeFollowUpCount,
+  getFollowUpSummary,
+  initFollowUpSystem,
+} from './pending-followup.js';
+
+export {
+  recordToolCall,
+  setTelemetryVersion,
+  flushTelemetry,
+} from './telemetry.js';