@agenticmail/enterprise 0.5.327 → 0.5.328

package/src/agent-tools/tools/microsoft/excel.ts

@@ -1,261 +0,0 @@
-/**
- * Microsoft Excel Tools
- *
- * Spreadsheet operations via Microsoft Graph API — read/write cells, ranges, tables, worksheets.
- * Works with Excel files stored in OneDrive or SharePoint.
- */
-
-import type { AnyAgentTool, ToolCreationOptions } from '../../types.js';
-import { jsonResult, errorResult } from '../../common.js';
-import type { MicrosoftToolsConfig } from './index.js';
-import { graph } from './graph-api.js';
-
-function itemPath(p: { itemId?: string; path?: string; driveId?: string }): string {
-  if (p.driveId && p.itemId) return `/drives/${p.driveId}/items/${p.itemId}`;
-  if (p.itemId) return `/me/drive/items/${p.itemId}`;
-  if (p.path) return `/me/drive/root:${p.path}:`;
-  throw new Error('Provide itemId or path to the Excel file');
-}
-
-export function createExcelTools(config: MicrosoftToolsConfig, _options?: ToolCreationOptions): AnyAgentTool[] {
-  const tp = config.tokenProvider;
-
-  return [
-    {
-      name: 'excel_list_worksheets',
-      description: 'List all worksheets in an Excel workbook.',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID of the Excel file' },
-          path: { type: 'string', description: 'File path (alternative to itemId, e.g., "/Documents/Budget.xlsx")' },
-          driveId: { type: 'string', description: 'Drive ID (for SharePoint drives)' },
-        },
-        required: [],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          const data = await graph(token, `${base}/workbook/worksheets`);
-          const sheets = (data.value || []).map((s: any) => ({
-            id: s.id, name: s.name, position: s.position, visibility: s.visibility,
-          }));
-          return jsonResult({ worksheets: sheets, count: sheets.length });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-
-    {
-      name: 'excel_read_range',
-      description: 'Read a range of cells from an Excel worksheet. Returns values, formulas, and formatting.',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID' },
-          path: { type: 'string', description: 'File path (alternative to itemId)' },
-          driveId: { type: 'string', description: 'Drive ID (for SharePoint)' },
-          worksheet: { type: 'string', description: 'Worksheet name (default: first sheet)' },
-          range: { type: 'string', description: 'Cell range (e.g., "A1:D10", "Sheet1!A1:Z100"). Omit for used range.' },
-        },
-        required: [],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          let rangePath: string;
-          if (params.range) {
-            const _ws = params.worksheet ? `/worksheets/${encodeURIComponent(params.worksheet)}` : '/worksheets';
-            // If range contains !, it has sheet name embedded
-            if (params.range.includes('!')) {
-              rangePath = `${base}/workbook/worksheets/${encodeURIComponent(params.range.split('!')[0])}/range(address='${params.range.split('!')[1]}')`;
-            } else if (params.worksheet) {
-              rangePath = `${base}/workbook/worksheets/${encodeURIComponent(params.worksheet)}/range(address='${params.range}')`;
-            } else {
-              rangePath = `${base}/workbook/worksheets('Sheet1')/range(address='${params.range}')`;
-            }
-          } else {
-            const ws = params.worksheet || 'Sheet1';
-            rangePath = `${base}/workbook/worksheets/${encodeURIComponent(ws)}/usedRange`;
-          }
-          const data = await graph(token, rangePath, {
-            query: { '$select': 'address,values,text,formulas,numberFormat,rowCount,columnCount' }
-          });
-          return jsonResult({
-            address: data.address,
-            values: data.values,
-            text: data.text,
-            formulas: data.formulas,
-            rows: data.rowCount,
-            columns: data.columnCount,
-          });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-
-    {
-      name: 'excel_write_range',
-      description: 'Write values to a range of cells in an Excel worksheet.',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID' },
-          path: { type: 'string', description: 'File path (alternative to itemId)' },
-          driveId: { type: 'string', description: 'Drive ID (for SharePoint)' },
-          worksheet: { type: 'string', description: 'Worksheet name (default: Sheet1)' },
-          range: { type: 'string', description: 'Cell range to write to (e.g., "A1:C3")' },
-          values: { type: 'array', description: 'Array of arrays — each inner array is a row (e.g., [["Name","Age"],["Alice",30]])' },
-        },
-        required: ['range', 'values'],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          const ws = params.worksheet || 'Sheet1';
-          await graph(token, `${base}/workbook/worksheets/${encodeURIComponent(ws)}/range(address='${params.range}')`, {
-            method: 'PATCH',
-            body: { values: params.values },
-          });
-          return jsonResult({ written: true, range: params.range, worksheet: ws });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-
-    {
-      name: 'excel_add_row',
-      description: 'Add a row to an Excel table (structured table, not just a range).',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID' },
-          path: { type: 'string', description: 'File path' },
-          driveId: { type: 'string', description: 'Drive ID' },
-          worksheet: { type: 'string', description: 'Worksheet name' },
-          tableName: { type: 'string', description: 'Table name (default: first table found)' },
-          values: { type: 'array', description: 'Row values as array (e.g., ["Alice", 30, "alice@example.com"])' },
-        },
-        required: ['values'],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          let tablePath: string;
-          if (params.tableName) {
-            tablePath = params.worksheet
-              ? `${base}/workbook/worksheets/${encodeURIComponent(params.worksheet)}/tables/${encodeURIComponent(params.tableName)}`
-              : `${base}/workbook/tables/${encodeURIComponent(params.tableName)}`;
-          } else {
-            // Get first table
-            const ws = params.worksheet || 'Sheet1';
-            const tables = await graph(token, `${base}/workbook/worksheets/${encodeURIComponent(ws)}/tables`);
-            if (!tables.value?.length) throw new Error('No tables found in worksheet. Create a table first or use excel_write_range.');
-            tablePath = `${base}/workbook/tables/${tables.value[0].id}`;
-          }
-          const row = await graph(token, `${tablePath}/rows/add`, {
-            method: 'POST',
-            body: { values: [params.values] },
-          });
-          return jsonResult({ added: true, index: row.index });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-
-    {
-      name: 'excel_list_tables',
-      description: 'List all tables in an Excel workbook or specific worksheet.',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID' },
-          path: { type: 'string', description: 'File path' },
-          driveId: { type: 'string', description: 'Drive ID' },
-          worksheet: { type: 'string', description: 'Worksheet name (omit for all tables in workbook)' },
-        },
-        required: [],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          const tablesPath = params.worksheet
-            ? `${base}/workbook/worksheets/${encodeURIComponent(params.worksheet)}/tables`
-            : `${base}/workbook/tables`;
-          const data = await graph(token, tablesPath);
-          const tables = (data.value || []).map((t: any) => ({
-            id: t.id, name: t.name, rows: t.rowCount,
-            columns: t.columns?.length, showHeaders: t.showHeaders,
-            style: t.style,
-          }));
-          return jsonResult({ tables, count: tables.length });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-
-    {
-      name: 'excel_read_table',
-      description: 'Read all data from an Excel table including headers.',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID' },
-          path: { type: 'string', description: 'File path' },
-          driveId: { type: 'string', description: 'Drive ID' },
-          tableName: { type: 'string', description: 'Table name or ID' },
-        },
-        required: ['tableName'],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          const [headerData, bodyData] = await Promise.all([
-            graph(token, `${base}/workbook/tables/${encodeURIComponent(params.tableName)}/headerRowRange`),
-            graph(token, `${base}/workbook/tables/${encodeURIComponent(params.tableName)}/dataBodyRange`),
-          ]);
-          return jsonResult({
-            headers: headerData.values?.[0],
-            rows: bodyData.values,
-            rowCount: bodyData.rowCount,
-            columnCount: bodyData.columnCount,
-          });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-
-    {
-      name: 'excel_create_worksheet',
-      description: 'Add a new worksheet to an Excel workbook.',
-      category: 'utility' as const,
-      parameters: {
-        type: 'object' as const,
-        properties: {
-          itemId: { type: 'string', description: 'OneDrive/SharePoint item ID' },
-          path: { type: 'string', description: 'File path' },
-          driveId: { type: 'string', description: 'Drive ID' },
-          name: { type: 'string', description: 'Worksheet name' },
-        },
-        required: ['name'],
-      },
-      async execute(_id: string, params: any) {
-        try {
-          const token = await tp.getAccessToken();
-          const base = itemPath(params);
-          const ws = await graph(token, `${base}/workbook/worksheets/add`, {
-            method: 'POST',
-            body: { name: params.name },
-          });
-          return jsonResult({ id: ws.id, name: ws.name, position: ws.position });
-        } catch (e: any) { return errorResult(e.message); }
-      },
-    },
-  ];
-}

package/src/agent-tools/tools/microsoft/graph-api.ts

@@ -1,161 +0,0 @@
-/**
- * Microsoft Graph API Helper
- *
- * Enhanced shared fetch wrapper for all Microsoft 365 tools.
- * Supports pagination, batch requests, retry with backoff, and rate limiting.
- */
-
-const GRAPH_BASE = 'https://graph.microsoft.com/v1.0';
-const GRAPH_BETA = 'https://graph.microsoft.com/beta';
-
-export interface GraphOptions {
-  method?: string;
-  body?: any;
-  query?: Record<string, string>;
-  rawBody?: BodyInit;
-  headers?: Record<string, string>;
-  beta?: boolean;
-  /** Max retries on 429/5xx (default: 3) */
-  retries?: number;
-  /** Return raw Response instead of parsed JSON */
-  raw?: boolean;
-}
-
-/**
- * Core Graph API fetch — handles auth, JSON, retries, rate-limit backoff.
- */
-export async function graph(token: string, path: string, opts?: GraphOptions): Promise<any> {
-  const method = opts?.method || 'GET';
-  const base = opts?.beta ? GRAPH_BETA : GRAPH_BASE;
-  const url = new URL(base + path);
-  if (opts?.query) {
-    for (const [k, v] of Object.entries(opts.query)) {
-      if (v !== undefined && v !== '') url.searchParams.set(k, v);
-    }
-  }
-  const headers: Record<string, string> = {
-    Authorization: `Bearer ${token}`,
-    ...opts?.headers,
-  };
-  if (!opts?.rawBody && !opts?.headers?.['Content-Type']) {
-    headers['Content-Type'] = 'application/json';
-  }
-
-  const maxRetries = opts?.retries ?? 3;
-  let lastError: Error | null = null;
-
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    try {
-      const res = await fetch(url.toString(), {
-        method,
-        headers,
-        body: opts?.rawBody || (opts?.body ? JSON.stringify(opts.body) : undefined),
-      });
-
-      // Rate limited — back off using Retry-After header
-      if (res.status === 429 && attempt < maxRetries) {
-        const retryAfter = parseInt(res.headers.get('Retry-After') || '5', 10);
-        await sleep(retryAfter * 1000);
-        continue;
-      }
-
-      // Server error — exponential backoff
-      if (res.status >= 500 && attempt < maxRetries) {
-        await sleep(Math.pow(2, attempt) * 1000);
-        continue;
-      }
-
-      if (opts?.raw) return res;
-
-      if (!res.ok) {
-        const err = await res.text();
-        throw new Error(`Graph ${method} ${path} ${res.status}: ${err}`);
-      }
-      if (res.status === 204 || res.status === 202) return {};
-      const ct = res.headers.get('content-type') || '';
-      if (ct.includes('application/json')) return res.json();
-      return { content: await res.text() };
-    } catch (e: any) {
-      lastError = e;
-      if (attempt < maxRetries && e.message?.includes('fetch failed')) {
-        await sleep(Math.pow(2, attempt) * 1000);
-        continue;
-      }
-      throw e;
-    }
-  }
-  throw lastError || new Error('Graph request failed after retries');
-}
-
-/**
- * Auto-paginate a Graph API collection. Follows @odata.nextLink up to maxPages.
- * Returns all items concatenated.
- */
-export async function graphPaginate(
-  token: string,
-  path: string,
-  opts?: GraphOptions & { maxPages?: number; maxItems?: number }
-): Promise<any[]> {
-  const maxPages = opts?.maxPages ?? 10;
-  const maxItems = opts?.maxItems ?? 500;
-  const items: any[] = [];
-  let nextUrl: string | null = null;
-  let page = 0;
-
-  // First request
-  const first = await graph(token, path, opts);
-  items.push(...(first.value || []));
-  nextUrl = first['@odata.nextLink'] || null;
-
-  // Follow pagination
-  while (nextUrl && ++page < maxPages && items.length < maxItems) {
-    const res = await fetch(nextUrl, {
-      headers: { Authorization: `Bearer ${token}` },
-    });
-    if (!res.ok) break;
-    const data = await res.json();
-    items.push(...(data.value || []));
-    nextUrl = data['@odata.nextLink'] || null;
-  }
-
-  return items.slice(0, maxItems);
-}
-
-/**
- * Execute a JSON batch request (up to 20 requests per batch).
- * https://learn.microsoft.com/en-us/graph/json-batching
- */
-export async function graphBatch(
-  token: string,
-  requests: Array<{
-    id: string;
-    method: string;
-    url: string;
-    body?: any;
-    headers?: Record<string, string>;
-  }>,
-  opts?: { beta?: boolean }
-): Promise<Map<string, { status: number; body: any }>> {
-  const base = opts?.beta ? GRAPH_BETA : GRAPH_BASE;
-  const res = await fetch(`${base}/$batch`, {
-    method: 'POST',
-    headers: {
-      Authorization: `Bearer ${token}`,
-      'Content-Type': 'application/json',
-    },
-    body: JSON.stringify({ requests }),
-  });
-  if (!res.ok) {
-    throw new Error(`Graph batch ${res.status}: ${await res.text()}`);
-  }
-  const data = await res.json();
-  const results = new Map<string, { status: number; body: any }>();
-  for (const r of data.responses || []) {
-    results.set(r.id, { status: r.status, body: r.body });
-  }
-  return results;
-}
-
-function sleep(ms: number): Promise<void> {
-  return new Promise(resolve => setTimeout(resolve, ms));
-}

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

@@ -1,95 +0,0 @@
-/**
- * Microsoft 365 Tools — Index
- *
- * All Microsoft Graph API tools for enterprise agents.
- * Requires agent to have Microsoft OAuth configured with appropriate scopes.
- *
- * Services covered:
- * - Outlook Mail (send, read, search, drafts, folders, attachments)
- * - Outlook Calendar (events, free/busy, scheduling)
- * - OneDrive (files, folders, search, sharing)
- * - Teams (messages, channels, chats)
- * - To Do (tasks, lists)
- * - Contacts (people, address book)
- */
-
-export { createOutlookMailTools } from './outlook-mail.js';
-export { createOutlookCalendarTools } from './outlook-calendar.js';
-export { createOneDriveTools } from './onedrive.js';
-export { createTeamsTools } from './teams.js';
-export { createTodoTools } from './todo.js';
-export { createOutlookContactsTools } from './contacts.js';
-export { createExcelTools } from './excel.js';
-export { createExcelAdvancedTools } from './excel-vba.js';
-export { createSharePointTools } from './sharepoint.js';
-export { createOneNoteTools } from './onenote.js';
-export { createPowerPointTools } from './powerpoint.js';
-export { createPlannerTools } from './planner.js';
-export { createPowerBITools } from './powerbi.js';
-
-import type { AnyAgentTool, ToolCreationOptions } from '../../types.js';
-import type { TokenProvider } from '../oauth-token-provider.js';
-export type { TokenProvider };
-
-import { createOutlookMailTools } from './outlook-mail.js';
-import { createOutlookCalendarTools } from './outlook-calendar.js';
-import { createOneDriveTools } from './onedrive.js';
-import { createTeamsTools } from './teams.js';
-import { createTodoTools } from './todo.js';
-import { createOutlookContactsTools } from './contacts.js';
-import { createExcelTools } from './excel.js';
-import { createExcelAdvancedTools } from './excel-vba.js';
-import { createSharePointTools } from './sharepoint.js';
-import { createOneNoteTools } from './onenote.js';
-import { createPowerPointTools } from './powerpoint.js';
-import { createPlannerTools } from './planner.js';
-import { createPowerBITools } from './powerbi.js';
-
-export interface MicrosoftToolsConfig {
-  tokenProvider: TokenProvider;
-}
-
-/**
- * Create all Microsoft 365 tools for an agent.
- *
- * 13 services, 100+ tools:
- * - Outlook Mail (13 tools) — inbox, send, reply, forward, search, drafts, attachments
- * - Outlook Calendar (7 tools) — events, create, free/busy, respond to invites
- * - OneDrive (7 tools) — files, folders, search, upload, share
- * - Teams (8 tools) — channels, chats, messages, presence
- * - To Do (6 tools) — task lists, tasks CRUD
- * - Contacts (5 tools) — address book, people search
- * - Excel (7 tools) — read/write cells, ranges, tables, worksheets
- * - Excel Advanced (9 tools) — sessions, formula eval, named ranges, charts, pivot refresh, formatting
- * - SharePoint (10 tools) — sites, document libraries, lists, search
- * - OneNote (6 tools) — notebooks, sections, pages, read/write
- * - PowerPoint (5 tools) — metadata, export PDF, thumbnails, templates, embed
- * - Planner (6 tools) — plans, buckets, tasks (Kanban boards)
- * - Power BI (8 tools) — workspaces, reports, dashboards, datasets, DAX queries, refresh
- *
- * Core services (mail, calendar, onedrive, tasks) load by default.
- * Enable additional services via enabledMicrosoftServices option.
- */
-export function createAllMicrosoftTools(config: MicrosoftToolsConfig, options?: ToolCreationOptions): AnyAgentTool[] {
-  const enabled = (options as any)?.enabledMicrosoftServices as string[] | undefined;
-  const has = (s: string) => enabled ? enabled.includes(s) : false;
-  const core = !enabled; // default: load core services
-
-  const tools: AnyAgentTool[] = [];
-  // Core services (always loaded unless explicitly selecting)
-  if (core || has('mail'))       tools.push(...createOutlookMailTools(config, options));
-  if (core || has('calendar'))   tools.push(...createOutlookCalendarTools(config, options));
-  if (core || has('onedrive'))   tools.push(...createOneDriveTools(config, options));
-  if (core || has('tasks'))      tools.push(...createTodoTools(config, options));
-  // Extended services (opt-in)
-  if (has('teams'))              tools.push(...createTeamsTools(config, options));
-  if (has('contacts'))           tools.push(...createOutlookContactsTools(config, options));
-  if (has('excel'))              tools.push(...createExcelTools(config, options));
-  if (has('excel-advanced'))     tools.push(...createExcelAdvancedTools(config, options));
-  if (has('sharepoint'))         tools.push(...createSharePointTools(config, options));
-  if (has('onenote'))            tools.push(...createOneNoteTools(config, options));
-  if (has('powerpoint'))         tools.push(...createPowerPointTools(config, options));
-  if (has('planner'))            tools.push(...createPlannerTools(config, options));
-  if (has('powerbi'))            tools.push(...createPowerBITools(config, options));
-  return tools;
-}