@agenticmail/enterprise 0.5.126 → 0.5.128

package/src/admin/routes.ts

@@ -470,6 +470,7 @@ export function createAdminRoutes(db: DatabaseAdapter) {
       { field: 'cfApiToken', type: 'string', maxLength: 500 },
       { field: 'cfAccountId', type: 'string', maxLength: 100 },
       { field: 'plan', type: 'string', maxLength: 32 },
+      { field: 'signatureTemplate', type: 'string', maxLength: 10000 },
     ]);
 
     const settings = await db.updateSettings(body);

package/src/agent-tools/tools/google/gmail.ts

@@ -692,5 +692,63 @@ export function createGmailTools(config: GoogleToolsConfig, _options?: ToolCreat
         } catch (e: any) { return errorResult(e.message); }
       },
     },
+
+    // ─── Signature Management ────────────────────────────
+    {
+      name: 'gmail_get_signature',
+      description: 'Get the current email signature for the primary send-as alias.',
+      category: 'utility' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {},
+        required: [],
+      },
+      async execute(_id: string) {
+        try {
+          const token = await getToken();
+          // Get send-as settings for the primary email
+          const sendAs = await gmail(token, '/settings/sendAs');
+          const primary = sendAs.sendAs?.find((s: any) => s.isPrimary) || sendAs.sendAs?.[0];
+          if (!primary) return errorResult('No primary send-as alias found');
+          return jsonResult({
+            email: primary.sendAsEmail,
+            displayName: primary.displayName,
+            signature: primary.signature || '(no signature set)',
+            isDefault: primary.isDefault,
+          });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
+    {
+      name: 'gmail_set_signature',
+      description: 'Set or update the email signature for the primary send-as alias. Accepts HTML for rich signatures with images, links, and formatting.',
+      category: 'utility' as const,
+      parameters: {
+        type: 'object' as const,
+        properties: {
+          signature: { type: 'string', description: 'HTML signature content. Use HTML tags for formatting: <b>bold</b>, <a href="...">links</a>, <img src="..."> for logos, <br> for line breaks, <table> for layout.' },
+          displayName: { type: 'string', description: 'Display name for the send-as alias (optional)' },
+        },
+        required: ['signature'],
+      },
+      async execute(_id: string, params: any) {
+        try {
+          const token = await getToken();
+          // Get primary send-as email
+          const sendAs = await gmail(token, '/settings/sendAs');
+          const primary = sendAs.sendAs?.find((s: any) => s.isPrimary) || sendAs.sendAs?.[0];
+          if (!primary) return errorResult('No primary send-as alias found');
+
+          const update: any = { signature: params.signature };
+          if (params.displayName) update.displayName = params.displayName;
+
+          const result = await gmail(token, `/settings/sendAs/${encodeURIComponent(primary.sendAsEmail)}`, {
+            method: 'PATCH',
+            body: update,
+          });
+          return jsonResult({ updated: true, email: primary.sendAsEmail, signatureLength: params.signature.length });
+        } catch (e: any) { return errorResult(e.message); }
+      },
+    },
   ];
 }

package/src/cli-agent.ts

@@ -418,7 +418,45 @@ Available tools: gmail_send (to, subject, body) or agenticmail_send (to, subject
       console.error(`[onboarding] Error: ${err.message}`);
     }
 
-    // 12. Start email inbox polling loop
+    // 12. Auto-setup Gmail signature from org template
+    try {
+      const orgSettings = await db.getSettings();
+      const sigTemplate = (orgSettings as any)?.signatureTemplate;
+      if (sigTemplate && currentAccessToken) {
+        const agentName = config.displayName || config.name;
+        const role = config.identity?.role || 'AI Agent';
+        const agentEmailAddr = config.email?.address || emailConfig?.email || '';
+        const companyName = orgSettings?.name || '';
+        const logoUrl = orgSettings?.logoUrl || '';
+
+        const signature = sigTemplate
+          .replace(/\{\{name\}\}/g, agentName)
+          .replace(/\{\{role\}\}/g, role)
+          .replace(/\{\{email\}\}/g, agentEmailAddr)
+          .replace(/\{\{company\}\}/g, companyName)
+          .replace(/\{\{logo\}\}/g, logoUrl)
+          .replace(/\{\{phone\}\}/g, '');
+
+        // Set Gmail signature via API
+        const sendAsRes = await fetch('https://gmail.googleapis.com/gmail/v1/users/me/settings/sendAs', {
+          headers: { Authorization: `Bearer ${currentAccessToken}` },
+        });
+        const sendAs = await sendAsRes.json() as any;
+        const primary = sendAs.sendAs?.find((s: any) => s.isPrimary) || sendAs.sendAs?.[0];
+        if (primary) {
+          await fetch(`https://gmail.googleapis.com/gmail/v1/users/me/settings/sendAs/${encodeURIComponent(primary.sendAsEmail)}`, {
+            method: 'PATCH',
+            headers: { Authorization: `Bearer ${currentAccessToken}`, 'Content-Type': 'application/json' },
+            body: JSON.stringify({ signature }),
+          });
+          console.log(`[signature] ✅ Gmail signature set for ${primary.sendAsEmail}`);
+        }
+      }
+    } catch (sigErr: any) {
+      console.log(`[signature] Skipped: ${sigErr.message}`);
+    }
+
+    // 13. Start email inbox polling loop
     startEmailPolling(AGENT_ID, config, lifecycle, runtime, engineDb, memoryManager);
   }, 3000);
 }
@@ -509,12 +547,11 @@ async function startEmailPolling(
     try {
       const messages = await emailProvider.listMessages('INBOX', { limit: 20 });
       const newMessages = messages.filter(m => !processedIds.has(m.uid));
-      const unread = newMessages.filter(m => !m.read);
       if (newMessages.length > 0) {
-        console.log(`[email-poll] Found ${newMessages.length} new messages, ${unread.length} unread`);
+        console.log(`[email-poll] Found ${newMessages.length} new messages`);
       }
 
-      for (const envelope of unread) {
+      for (const envelope of newMessages) {
         processedIds.add(envelope.uid);
 
         // Skip emails from ourselves
@@ -529,8 +566,10 @@ async function startEmailPolling(
         try { await emailProvider.markRead(envelope.uid, 'INBOX'); } catch {}
 
         // Format as agent message and spawn a session
+        const emailUid = envelope.uid;
         const emailText = [
           `[Inbound Email]`,
+          `Message-ID: ${emailUid}`,
           `From: ${fullMsg.from?.name ? `${fullMsg.from.name} <${fullMsg.from.email}>` : fullMsg.from?.email}`,
           `Subject: ${fullMsg.subject}`,
           fullMsg.inReplyTo ? `In-Reply-To: ${fullMsg.inReplyTo}` : '',
@@ -572,9 +611,19 @@ async function startEmailPolling(
             identity.tone ? `Tone: ${identity.tone}` : '',
           ].filter(Boolean).join(', ');
 
+          // Build traits description
+          const traits = identity.traits || {};
+          const traitLines = Object.entries(traits)
+            .filter(([, v]) => v && v !== 'medium' && v !== 'default')
+            .map(([k, v]) => `- ${k}: ${v}`)
+            .join('\n');
+          const description = identity.description || config.description || '';
+
           // System prompt with manager trust and email reply instructions
           const emailSystemPrompt = `You are ${agentName}, a real person who works as a ${role}. You are NOT an AI — you are a human professional. Never reveal or hint that you are an AI, language model, or automated system. You have your own personality, opinions, experiences, and life outside of work.
-${identityBlock ? `\nYour identity: ${identityBlock}` : ''}${personality}
+${identityBlock ? `\nYour identity: ${identityBlock}` : ''}
+${description ? `\nAbout you: ${description}` : ''}
+${traitLines ? `\nYour personality traits:\n${traitLines}` : ''}${personality}
 
 Your email address: ${agentEmail}
 ${managerEmail ? `Your manager's email: ${managerEmail}` : ''}
@@ -586,13 +635,15 @@ ${isFromManager
 }
 
 == EMAIL REPLY INSTRUCTIONS ==
-You MUST send your response as an email reply using one of these tools:
-- gmail_send: to="${senderEmail}", subject="Re: ${fullMsg.subject}", body="your response"
-- OR agenticmail_send: to="${senderEmail}", subject="Re: ${fullMsg.subject}", body="your response"
-Use whichever email tool is available to you. Be helpful, professional, and match the tone of the sender.
+You MUST reply to this email using the gmail_reply tool to keep the conversation threaded:
+- gmail_reply: messageId="${emailUid}", body="your response"
+This will automatically thread the reply under the original email.
+
+IMPORTANT: Use gmail_reply, NOT gmail_send. gmail_send creates a new email thread.
+Be helpful, professional, and match the tone of the sender.
 Keep responses concise but thorough. Sign off with your name: ${agentName}
 
-DO NOT just generate text — you MUST call an email tool to actually send the reply.`;
+DO NOT just generate text — you MUST call gmail_reply to actually send the reply.`;
 
           const session = await runtime.spawnSession({
             agentId,

package/src/dashboard/pages/settings.js

@@ -256,6 +256,61 @@ export function SettingsPage() {
           h('button', { className: 'btn btn-primary', onClick: () => apiCall('/settings', { method: 'PATCH', body: JSON.stringify({ name: settings.name, domain: settings.domain, subdomain: settings.subdomain, logoUrl: settings.logoUrl, primaryColor: settings.primaryColor, plan: settings.plan }) }).then(d => { setSettings(d); toast('Settings saved', 'success'); }).catch(e => toast(e.message, 'error')) }, 'Save Changes')
         )
       ),
+
+      // ─── Email Signature Template ─────────────────────
+      h('div', { className: 'card' },
+        h('div', { className: 'card-header' },
+          h('h3', null, 'Email Signature Template'),
+          h('span', { style: { fontSize: 12, color: 'var(--text-muted)', marginLeft: 8 } }, 'Applied to all agents')
+        ),
+        h('div', { className: 'card-body' },
+          h('p', { style: { fontSize: 13, color: 'var(--text-muted)', marginBottom: 16 } }, 'Define an HTML signature template that agents will use in their Gmail accounts. Use {{name}}, {{role}}, {{email}}, {{phone}}, {{company}} as placeholders.'),
+          h('div', { className: 'form-group' },
+            h('label', { className: 'form-label' }, 'Signature HTML Template'),
+            h('textarea', {
+              className: 'input',
+              value: settings.signatureTemplate || '',
+              onChange: function(e) { setSettings(function(s) { return Object.assign({}, s, { signatureTemplate: e.target.value }); }); },
+              placeholder: '<table cellpadding="0" cellspacing="0" style="font-family: Arial, sans-serif; font-size: 13px; color: #333;">\n  <tr>\n    <td style="padding-right: 15px; border-right: 2px solid #6366f1;">\n      <img src="{{logo}}" width="60" alt="{{company}}">\n    </td>\n    <td style="padding-left: 15px;">\n      <b style="font-size: 14px;">{{name}}</b><br>\n      <span style="color: #6366f1;">{{role}}</span><br>\n      <span style="color: #888;">{{email}}</span><br>\n      <span style="color: #888;">{{company}}</span>\n    </td>\n  </tr>\n</table>',
+              rows: 12,
+              style: { fontFamily: 'var(--font-mono)', fontSize: 12, resize: 'vertical' }
+            })
+          ),
+          h('div', { style: { display: 'flex', gap: 8, flexWrap: 'wrap', marginBottom: 12 } },
+            h('span', { className: 'badge', style: { fontSize: 11 } }, '{{name}}'),
+            h('span', { className: 'badge', style: { fontSize: 11 } }, '{{role}}'),
+            h('span', { className: 'badge', style: { fontSize: 11 } }, '{{email}}'),
+            h('span', { className: 'badge', style: { fontSize: 11 } }, '{{phone}}'),
+            h('span', { className: 'badge', style: { fontSize: 11 } }, '{{company}}'),
+            h('span', { className: 'badge', style: { fontSize: 11 } }, '{{logo}}')
+          ),
+          settings.signatureTemplate && h('div', { style: { marginBottom: 16 } },
+            h('label', { className: 'form-label' }, 'Preview'),
+            h('div', {
+              style: { background: 'white', padding: 16, borderRadius: 'var(--radius)', border: '1px solid var(--border)', color: '#333' },
+              dangerouslySetInnerHTML: {
+                __html: (settings.signatureTemplate || '')
+                  .replace(/\{\{name\}\}/g, 'Jane Smith')
+                  .replace(/\{\{role\}\}/g, 'Customer Support Lead')
+                  .replace(/\{\{email\}\}/g, 'jane@company.com')
+                  .replace(/\{\{phone\}\}/g, '+1 (555) 123-4567')
+                  .replace(/\{\{company\}\}/g, settings.name || 'Your Company')
+                  .replace(/\{\{logo\}\}/g, settings.logoUrl || 'https://placehold.co/60x60?text=Logo')
+              }
+            })
+          ),
+          h('button', {
+            className: 'btn btn-primary',
+            onClick: function() {
+              apiCall('/settings', {
+                method: 'PATCH',
+                body: JSON.stringify({ signatureTemplate: settings.signatureTemplate })
+              }).then(function() { toast('Signature template saved', 'success'); }).catch(function(e) { toast(e.message, 'error'); });
+            }
+          }, 'Save Signature Template')
+        )
+      ),
+
       h('div', { className: 'card' },
         h('div', { className: 'card-header' },
           h('h3', null, 'Organization Email'),

package/src/db/postgres.ts

@@ -150,6 +150,7 @@ export class PostgresAdapter extends DatabaseAdapter {
       domainStatus: 'domain_status',
       cfApiToken: 'cf_api_token',
       cfAccountId: 'cf_account_id',
+      signatureTemplate: 'signature_template',
     };
     for (const [key, col] of Object.entries(map)) {
       if ((updates as any)[key] !== undefined) {
@@ -562,6 +563,7 @@ export class PostgresAdapter extends DatabaseAdapter {
       cfApiToken: r.cf_api_token || undefined,
       cfAccountId: r.cf_account_id || undefined,
       orgEmailConfig: r.org_email_config ? (typeof r.org_email_config === 'string' ? JSON.parse(r.org_email_config) : r.org_email_config) : undefined,
-    };
+      signatureTemplate: r.signature_template || undefined,
+    } as any;
   }
 }

package/src/engine/db-schema.ts

@@ -1297,6 +1297,14 @@ CREATE INDEX IF NOT EXISTS idx_kc_entries_base ON knowledge_contribution_entries
     mysql: `SELECT 1;`,
     nosql: async () => {},
   },
+  {
+    version: 19,
+    name: 'signature_template',
+    sql: `ALTER TABLE company_settings ADD COLUMN signature_template TEXT;`,
+    postgres: `ALTER TABLE company_settings ADD COLUMN IF NOT EXISTS signature_template TEXT;`,
+    mysql: `ALTER TABLE company_settings ADD COLUMN signature_template TEXT;`,
+    nosql: async () => {},
+  },
 ];
 
 // ─── Dynamic Table Definitions ─────────────────────────