@agenticmail/enterprise 0.5.76 → 0.5.78

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

@@ -5,6 +5,7 @@
  * Requires agent to have Google OAuth configured with appropriate scopes.
  */
 
+export { createGmailTools } from './gmail.js';
 export { createGoogleCalendarTools } from './calendar.js';
 export { createGoogleDriveTools } from './drive.js';
 export { createGoogleSheetsTools } from './sheets.js';
@@ -13,6 +14,7 @@ export { createGoogleContactsTools } from './contacts.js';
 
 import type { AnyAgentTool, ToolCreationOptions } from '../../types.js';
 import type { TokenProvider } from '../oauth-token-provider.js';
+import { createGmailTools } from './gmail.js';
 import { createGoogleCalendarTools } from './calendar.js';
 import { createGoogleDriveTools } from './drive.js';
 import { createGoogleSheetsTools } from './sheets.js';
@@ -27,8 +29,13 @@ export interface GoogleToolsConfig {
  * Create all Google Workspace tools for an agent.
  * Returns ~30 tools covering Calendar, Drive, Sheets, Docs, and Contacts.
  */
+/**
+ * Create all Google Workspace tools for an agent.
+ * Returns ~40 tools covering Gmail, Calendar, Drive, Sheets, Docs, and Contacts.
+ */
 export function createAllGoogleTools(config: GoogleToolsConfig, options?: ToolCreationOptions): AnyAgentTool[] {
   return [
+    ...createGmailTools(config, options),
     ...createGoogleCalendarTools(config, options),
     ...createGoogleDriveTools(config, options),
     ...createGoogleSheetsTools(config, options),

package/src/dashboard/pages/agent-detail.js

@@ -3802,6 +3802,182 @@ var _tsToggleRow = { display: 'flex', alignItems: 'center', justifyContent: 'spa
 var _tsGrid = { display: 'grid', gridTemplateColumns: '1fr 1fr', gap: 16 };
 // --- EmailSection -------------------------------------------------------
 
+// ════════════════════════════════════════════════════════════
+// TOOLS SECTION — Toggle tool categories per agent
+// ════════════════════════════════════════════════════════════
+
+function ToolsSection(props) {
+  var agentId = props.agentId;
+  var _d = useApp(); var toast = _d.toast;
+  var _loading = useState(true); var loading = _loading[0]; var setLoading = _loading[1];
+  var _cats = useState([]); var cats = _cats[0]; var setCats = _cats[1];
+  var _stats = useState({}); var stats = _stats[0]; var setStats = _stats[1];
+  var _saving = useState(false); var saving = _saving[0]; var setSaving = _saving[1];
+  var _filter = useState('all'); var filter = _filter[0]; var setFilter = _filter[1];
+  var _expanded = useState(null); var expanded = _expanded[0]; var setExpanded = _expanded[1];
+
+  function load() {
+    setLoading(true);
+    engineCall('/bridge/agents/' + agentId + '/tools')
+      .then(function(d) {
+        setCats(d.categories || []);
+        setStats({ total: d.totalTools, enabled: d.enabledTools });
+        setLoading(false);
+      })
+      .catch(function() { setLoading(false); });
+  }
+
+  useEffect(function() { load(); }, [agentId]);
+
+  function toggle(catId, currentEnabled) {
+    setSaving(true);
+    var body = {};
+    body[catId] = !currentEnabled;
+    engineCall('/bridge/agents/' + agentId + '/tools', {
+      method: 'PUT',
+      body: JSON.stringify(body),
+    }).then(function() {
+      setCats(function(prev) {
+        return prev.map(function(c) {
+          return c.id === catId ? Object.assign({}, c, { enabled: !currentEnabled }) : c;
+        });
+      });
+      setStats(function(prev) {
+        var cat = cats.find(function(c) { return c.id === catId; });
+        var delta = currentEnabled ? -(cat?.toolCount || 0) : (cat?.toolCount || 0);
+        return Object.assign({}, prev, { enabled: (prev.enabled || 0) + delta });
+      });
+      toast((!currentEnabled ? 'Enabled' : 'Disabled') + ' tools', 'success');
+      setSaving(false);
+    }).catch(function(e) { toast(e.message, 'error'); setSaving(false); });
+  }
+
+  function toggleAll(enable) {
+    setSaving(true);
+    var body = {};
+    cats.forEach(function(c) { if (!c.alwaysOn) body[c.id] = enable; });
+    engineCall('/bridge/agents/' + agentId + '/tools', {
+      method: 'PUT',
+      body: JSON.stringify(body),
+    }).then(function() {
+      load();
+      toast(enable ? 'All tools enabled' : 'All optional tools disabled', 'success');
+      setSaving(false);
+    }).catch(function(e) { toast(e.message, 'error'); setSaving(false); });
+  }
+
+  if (loading) return h('div', { className: 'card', style: { padding: 40, textAlign: 'center' } }, 'Loading tools...');
+
+  var filtered = cats.filter(function(c) {
+    if (filter === 'enabled') return c.enabled;
+    if (filter === 'disabled') return !c.enabled;
+    if (filter === 'google') return c.requiresOAuth === 'google';
+    if (filter === 'enterprise') return c.id.startsWith('enterprise_');
+    return true;
+  });
+
+  var googleCats = cats.filter(function(c) { return c.requiresOAuth === 'google'; });
+  var googleAvailable = googleCats.some(function(c) { return c.isAvailable; });
+
+  return h('div', null,
+    // Stats bar
+    h('div', { style: { display: 'flex', gap: 16, marginBottom: 16, flexWrap: 'wrap', alignItems: 'center' } },
+      h('div', { className: 'card', style: { padding: '12px 16px', flex: '1 1 auto', minWidth: 150 } },
+        h('div', { style: { fontSize: 24, fontWeight: 700, color: 'var(--accent)' } }, stats.enabled || 0),
+        h('div', { style: { fontSize: 12, color: 'var(--text-muted)' } }, 'of ' + (stats.total || 0) + ' tools enabled')
+      ),
+      h('div', { style: { display: 'flex', gap: 8 } },
+        h('button', { className: 'btn btn-sm', disabled: saving, onClick: function() { toggleAll(true); } }, 'Enable All'),
+        h('button', { className: 'btn btn-sm btn-danger', disabled: saving, onClick: function() { toggleAll(false); } }, 'Disable Optional')
+      )
+    ),
+
+    // Google Workspace notice
+    !googleAvailable && googleCats.length > 0 && h('div', { style: { padding: '12px 16px', background: 'var(--warning-soft)', borderRadius: 'var(--radius)', marginBottom: 16, fontSize: 12 } },
+      h('strong', null, '\u26A0\uFE0F Google Workspace tools require OAuth'), ' — ',
+      'Connect a Google account in the ', h('strong', null, 'Email'), ' tab to unlock Gmail, Calendar, Drive, Sheets, Docs, and Contacts tools.'
+    ),
+
+    // Filter tabs
+    h('div', { className: 'tabs', style: { marginBottom: 16 } },
+      [
+        { id: 'all', label: 'All' },
+        { id: 'enabled', label: 'Enabled' },
+        { id: 'disabled', label: 'Disabled' },
+        { id: 'google', label: 'Google Workspace' },
+        { id: 'enterprise', label: 'Enterprise' },
+      ].map(function(f) {
+        return h('div', { key: f.id, className: 'tab' + (filter === f.id ? ' active' : ''), onClick: function() { setFilter(f.id); } }, f.label);
+      })
+    ),
+
+    // Tool category cards
+    h('div', { style: { display: 'grid', gap: 12 } },
+      filtered.map(function(cat) {
+        var isExpanded = expanded === cat.id;
+        return h('div', {
+          key: cat.id,
+          className: 'card',
+          style: { opacity: !cat.isAvailable && cat.requiresOAuth ? 0.6 : 1 }
+        },
+          h('div', {
+            style: { display: 'flex', alignItems: 'center', gap: 12, padding: '14px 16px', cursor: 'pointer' },
+            onClick: function() { setExpanded(isExpanded ? null : cat.id); }
+          },
+            // Icon
+            h('div', { style: { fontSize: 22, width: 36, textAlign: 'center', flexShrink: 0 } }, cat.icon),
+            // Info
+            h('div', { style: { flex: 1, minWidth: 0 } },
+              h('div', { style: { display: 'flex', alignItems: 'center', gap: 8, marginBottom: 2 } },
+                h('span', { style: { fontWeight: 600, fontSize: 14 } }, cat.name),
+                h('span', { className: 'badge', style: { fontSize: 10, padding: '1px 6px', background: 'var(--bg-tertiary)', color: 'var(--text-muted)' } }, cat.toolCount + ' tools'),
+                !cat.isAvailable && cat.requiresOAuth && h('span', { className: 'badge badge-warning', style: { fontSize: 10, padding: '1px 6px' } }, 'OAuth Required'),
+                cat.alwaysOn && h('span', { className: 'badge badge-info', style: { fontSize: 10, padding: '1px 6px' } }, 'Always On')
+              ),
+              h('div', { style: { fontSize: 12, color: 'var(--text-muted)' } }, cat.description)
+            ),
+            // Toggle
+            !cat.alwaysOn && h('div', {
+              onClick: function(e) { e.stopPropagation(); if (!saving && (cat.isAvailable || cat.enabled)) toggle(cat.id, cat.enabled); },
+              style: {
+                width: 44, height: 24, borderRadius: 12, position: 'relative', cursor: saving ? 'not-allowed' : 'pointer',
+                background: cat.enabled ? 'var(--accent)' : 'var(--border)', transition: 'background 0.2s', flexShrink: 0,
+              },
+            },
+              h('div', { style: {
+                width: 20, height: 20, borderRadius: 10, background: '#fff', position: 'absolute', top: 2,
+                left: cat.enabled ? 22 : 2, transition: 'left 0.2s',
+                boxShadow: '0 1px 3px rgba(0,0,0,0.2)',
+              } })
+            ),
+            cat.alwaysOn && h('div', { style: { width: 44, height: 24, flexShrink: 0 } }),
+            // Expand arrow
+            h('div', { style: { fontSize: 12, color: 'var(--text-muted)', marginLeft: 4 } }, isExpanded ? '\u25B2' : '\u25BC')
+          ),
+
+          // Expanded tool list
+          isExpanded && h('div', { style: { borderTop: '1px solid var(--border)', padding: '12px 16px', background: 'var(--bg-secondary)' } },
+            h('div', { style: { display: 'flex', flexWrap: 'wrap', gap: 6 } },
+              cat.tools.map(function(t) {
+                return h('span', {
+                  key: t,
+                  style: {
+                    display: 'inline-block', padding: '3px 10px', borderRadius: 4, fontSize: 11,
+                    fontFamily: 'var(--font-mono)', background: cat.enabled ? 'var(--accent-soft)' : 'var(--bg-tertiary)',
+                    color: cat.enabled ? 'var(--accent)' : 'var(--text-muted)', border: '1px solid ' + (cat.enabled ? 'var(--accent)' : 'var(--border)'),
+                  }
+                }, t);
+              })
+            )
+          )
+        );
+      })
+    ),
+
+    filtered.length === 0 && h('div', { style: { textAlign: 'center', padding: 40, color: 'var(--text-muted)' } }, 'No tools match this filter.')
+  );
+}
+
 function EmailSection(props) {
   var agentId = props.agentId;
   var engineAgent = props.engineAgent || {};
@@ -4588,8 +4764,8 @@ function AgentDetailPage(props) {
   var _agents = useState([]);
   var agents = _agents[0]; var setAgents = _agents[1];
 
-  var TABS = ['overview', 'personal', 'email', 'configuration', 'manager', 'skills', 'permissions', 'activity', 'communication', 'workforce', 'memory', 'guardrails', 'budget', 'tool-security', 'deployment'];
-  var TAB_LABELS = { 'tool-security': 'Tool Security', 'manager': 'Manager & Catch-Up', 'email': 'Email' };
+  var TABS = ['overview', 'personal', 'email', 'configuration', 'manager', 'tools', 'skills', 'permissions', 'activity', 'communication', 'workforce', 'memory', 'guardrails', 'budget', 'tool-security', 'deployment'];
+  var TAB_LABELS = { 'tool-security': 'Tool Security', 'manager': 'Manager & Catch-Up', 'email': 'Email', 'tools': 'Tools' };
 
   var load = function() {
     setLoading(true);
@@ -4713,6 +4889,7 @@ function AgentDetailPage(props) {
     tab === 'email' && h(EmailSection, { agentId: agentId, engineAgent: engineAgent, reload: load }),
     tab === 'configuration' && h(ConfigurationSection, { agentId: agentId, engineAgent: engineAgent, reload: load }),
     tab === 'manager' && h(ManagerCatchUpSection, { agentId: agentId, engineAgent: engineAgent, agents: agents, reload: load }),
+    tab === 'tools' && h(ToolsSection, { agentId: agentId, engineAgent: engineAgent, reload: load }),
     tab === 'skills' && h(SkillsSection, { agentId: agentId, engineAgent: engineAgent, reload: load }),
     tab === 'permissions' && h(PermissionsSection, { agentId: agentId, profile: profile, reload: load }),
     tab === 'activity' && h(ActivitySection, { agentId: agentId }),

package/src/engine/agent-routes.ts

@@ -777,5 +777,205 @@ export function createAgentRoutes(opts: {
     return c.json({ success: true });
   });
 
+  // ═══════════════════════════════════════════════════════════
+  // TOOL ACCESS CONFIGURATION
+  // ═══════════════════════════════════════════════════════════
+
+  /** Master tool catalog — all available tools grouped by category */
+  const TOOL_CATALOG = [
+    {
+      id: 'core', name: 'Core Tools', description: 'File operations, shell, search, and browser',
+      icon: '🔧', alwaysOn: true,
+      tools: ['read', 'write', 'edit', 'bash', 'glob', 'grep', 'web_fetch', 'web_search', 'browser', 'memory'],
+    },
+    {
+      id: 'agenticmail', name: 'AgenticMail', description: 'Email send/receive, inbox management, inter-agent messaging',
+      icon: '📧',
+      tools: ['agenticmail_inbox', 'agenticmail_read', 'agenticmail_send', 'agenticmail_reply', 'agenticmail_forward',
+              'agenticmail_search', 'agenticmail_labels', 'agenticmail_folders', 'agenticmail_drafts',
+              'agenticmail_move', 'agenticmail_delete', 'agenticmail_batch_read', 'agenticmail_batch_delete',
+              'agenticmail_contacts', 'agenticmail_templates', 'agenticmail_message_agent', 'agenticmail_call_agent',
+              'agenticmail_check_tasks', 'agenticmail_complete_task', 'agenticmail_identity'],
+    },
+    {
+      id: 'gmail', name: 'Gmail', description: 'Native Gmail API — search, send, reply, labels, drafts, threads, attachments',
+      icon: '✉️', requiresOAuth: 'google',
+      tools: ['gmail_search', 'gmail_read', 'gmail_thread', 'gmail_send', 'gmail_reply', 'gmail_forward',
+              'gmail_modify', 'gmail_trash', 'gmail_labels', 'gmail_drafts', 'gmail_attachment', 'gmail_profile', 'gmail_vacation'],
+    },
+    {
+      id: 'google_calendar', name: 'Google Calendar', description: 'Event management, scheduling, free/busy lookup',
+      icon: '📅', requiresOAuth: 'google',
+      tools: ['google_calendar_list', 'google_calendar_events', 'google_calendar_create_event',
+              'google_calendar_update_event', 'google_calendar_delete_event', 'google_calendar_freebusy'],
+    },
+    {
+      id: 'google_drive', name: 'Google Drive', description: 'File management, search, sharing, content export',
+      icon: '📁', requiresOAuth: 'google',
+      tools: ['google_drive_list', 'google_drive_get', 'google_drive_create', 'google_drive_delete',
+              'google_drive_share', 'google_drive_move'],
+    },
+    {
+      id: 'google_sheets', name: 'Google Sheets', description: 'Spreadsheet read/write, cell operations, formulas',
+      icon: '📊', requiresOAuth: 'google',
+      tools: ['google_sheets_get', 'google_sheets_read', 'google_sheets_write', 'google_sheets_append',
+              'google_sheets_clear', 'google_sheets_create', 'google_sheets_add_sheet'],
+    },
+    {
+      id: 'google_docs', name: 'Google Docs', description: 'Document read/write, text insert, find & replace',
+      icon: '📝', requiresOAuth: 'google',
+      tools: ['google_docs_read', 'google_docs_create', 'google_docs_write'],
+    },
+    {
+      id: 'google_contacts', name: 'Google Contacts', description: 'Contact search, directory lookup, CRUD',
+      icon: '👥', requiresOAuth: 'google',
+      tools: ['google_contacts_list', 'google_contacts_search', 'google_contacts_search_directory',
+              'google_contacts_create', 'google_contacts_update'],
+    },
+    {
+      id: 'enterprise_database', name: 'Database', description: 'SQL queries, schema inspection, data sampling',
+      icon: '🗄️',
+      tools: ['enterprise_sql_query', 'enterprise_sql_schema', 'enterprise_sql_explain',
+              'enterprise_sql_tables', 'enterprise_sql_sample', 'enterprise_sql_write'],
+    },
+    {
+      id: 'enterprise_spreadsheet', name: 'Spreadsheet', description: 'CSV/Excel read, write, filter, aggregate, transform, pivot',
+      icon: '📈',
+      tools: ['enterprise_csv_read', 'enterprise_csv_write', 'enterprise_csv_filter', 'enterprise_csv_aggregate',
+              'enterprise_csv_transform', 'enterprise_csv_merge', 'enterprise_csv_pivot', 'enterprise_csv_convert'],
+    },
+    {
+      id: 'enterprise_documents', name: 'Documents', description: 'PDF/DOCX generation, OCR, format conversion',
+      icon: '📄',
+      tools: ['enterprise_pdf_generate', 'enterprise_docx_generate', 'enterprise_ocr', 'enterprise_invoice_parse',
+              'enterprise_doc_convert', 'enterprise_doc_merge', 'enterprise_doc_extract', 'enterprise_doc_sign'],
+    },
+    {
+      id: 'enterprise_http', name: 'HTTP Client', description: 'HTTP requests, GraphQL, batch calls, downloads',
+      icon: '🌐',
+      tools: ['enterprise_http_request', 'enterprise_http_graphql', 'enterprise_http_batch', 'enterprise_http_download'],
+    },
+    {
+      id: 'enterprise_workflow', name: 'Workflow', description: 'Approval requests, status tracking, escalation',
+      icon: '🔄',
+      tools: ['enterprise_approval_request', 'enterprise_approval_status', 'enterprise_approval_pending',
+              'enterprise_approval_cancel', 'enterprise_approval_remind'],
+    },
+    {
+      id: 'enterprise_notifications', name: 'Notifications', description: 'Send alerts, broadcast, webhook, escalate',
+      icon: '🔔',
+      tools: ['enterprise_notify_send', 'enterprise_notify_broadcast', 'enterprise_notify_webhook',
+              'enterprise_notify_escalate', 'enterprise_notify_schedule'],
+    },
+    {
+      id: 'enterprise_finance', name: 'Finance', description: 'Budget queries, expenses, spending reports, forecasts',
+      icon: '💰',
+      tools: ['enterprise_budget_query', 'enterprise_expense_log', 'enterprise_spending_summary',
+              'enterprise_invoice_list', 'enterprise_budget_forecast'],
+    },
+    {
+      id: 'enterprise_security', name: 'Security Scanning', description: 'Secret scanning, PII detection, dependency audit',
+      icon: '🔒',
+      tools: ['enterprise_secret_scan', 'enterprise_pii_scan', 'enterprise_pii_redact',
+              'enterprise_dep_audit', 'enterprise_compliance_check', 'enterprise_hash'],
+    },
+    {
+      id: 'enterprise_code', name: 'Code Sandbox', description: 'Run JavaScript, Python, shell scripts, JSON transforms',
+      icon: '💻',
+      tools: ['enterprise_run_js', 'enterprise_run_python', 'enterprise_run_shell',
+              'enterprise_json_transform', 'enterprise_regex'],
+    },
+    {
+      id: 'enterprise_translation', name: 'Translation', description: 'Text and document translation, language detection',
+      icon: '🌍',
+      tools: ['enterprise_translate', 'enterprise_translate_doc', 'enterprise_translate_batch',
+              'enterprise_detect_language', 'enterprise_translate_glossary'],
+    },
+    {
+      id: 'enterprise_vision', name: 'Vision', description: 'Image analysis, OCR, UI analysis, chart extraction',
+      icon: '👁️',
+      tools: ['enterprise_image_describe', 'enterprise_image_ocr', 'enterprise_ui_analyze',
+              'enterprise_chart_extract', 'enterprise_image_compare'],
+    },
+    {
+      id: 'enterprise_knowledge', name: 'Knowledge Base', description: 'Internal knowledge search, spaces, updates',
+      icon: '📚',
+      tools: ['enterprise_kb_search', 'enterprise_kb_spaces', 'enterprise_kb_recent',
+              'enterprise_kb_article', 'enterprise_kb_contribute'],
+    },
+    {
+      id: 'enterprise_logs', name: 'Logs', description: 'Log search, aggregation, tail, error correlation',
+      icon: '📋',
+      tools: ['enterprise_log_search', 'enterprise_log_aggregate', 'enterprise_log_tail',
+              'enterprise_log_correlate', 'enterprise_log_errors'],
+    },
+    {
+      id: 'enterprise_diff', name: 'Diff', description: 'Text, JSON, and spreadsheet comparison',
+      icon: '↔️',
+      tools: ['enterprise_text_diff', 'enterprise_json_diff', 'enterprise_spreadsheet_diff', 'enterprise_diff_summary'],
+    },
+  ];
+
+  /**
+   * GET /bridge/agents/:id/tools — List available tool categories with enabled/disabled status
+   */
+  router.get('/bridge/agents/:id/tools', (c) => {
+    const agentId = c.req.param('id');
+    const managed = lifecycle.getAgent(agentId);
+    if (!managed) return c.json({ error: 'Agent not found' }, 404);
+
+    const toolConfig = managed.config?.toolAccess || {};
+    const emailConfig = managed.config?.emailConfig;
+    const hasGoogleOAuth = emailConfig?.oauthProvider === 'google' && emailConfig?.oauthAccessToken;
+    const hasMicrosoftOAuth = emailConfig?.oauthProvider === 'microsoft' && emailConfig?.oauthAccessToken;
+
+    const categories = TOOL_CATALOG.map(cat => {
+      const isAvailable = !cat.requiresOAuth
+        || (cat.requiresOAuth === 'google' && hasGoogleOAuth)
+        || (cat.requiresOAuth === 'microsoft' && hasMicrosoftOAuth);
+
+      // Default: core is always on, others on if available
+      const defaultEnabled = cat.alwaysOn || isAvailable;
+      const enabled = cat.alwaysOn ? true : (toolConfig[cat.id] !== undefined ? toolConfig[cat.id] : defaultEnabled);
+
+      return {
+        id: cat.id, name: cat.name, description: cat.description, icon: cat.icon,
+        toolCount: cat.tools.length, tools: cat.tools,
+        enabled, isAvailable, alwaysOn: cat.alwaysOn || false,
+        requiresOAuth: cat.requiresOAuth || null,
+      };
+    });
+
+    const totalTools = categories.reduce((s, c) => s + c.toolCount, 0);
+    const enabledTools = categories.filter(c => c.enabled).reduce((s, c) => s + c.toolCount, 0);
+
+    return c.json({ categories, totalTools, enabledTools });
+  });
+
+  /**
+   * PUT /bridge/agents/:id/tools — Update tool access configuration
+   * Body: { [categoryId]: boolean }
+   */
+  router.put('/bridge/agents/:id/tools', async (c) => {
+    const agentId = c.req.param('id');
+    const managed = lifecycle.getAgent(agentId);
+    if (!managed) return c.json({ error: 'Agent not found' }, 404);
+
+    const body = await c.req.json();
+    if (!managed.config) managed.config = {};
+    if (!managed.config.toolAccess) managed.config.toolAccess = {};
+
+    for (const [catId, enabled] of Object.entries(body)) {
+      // Don't allow disabling core tools
+      const cat = TOOL_CATALOG.find(c => c.id === catId);
+      if (cat?.alwaysOn) continue;
+      managed.config.toolAccess[catId] = !!enabled;
+    }
+
+    managed.updatedAt = new Date().toISOString();
+    await lifecycle.saveAgent(agentId);
+    return c.json({ success: true, toolAccess: managed.config.toolAccess });
+  });
+
   return router;
 }