@agenticmail/enterprise 0.5.327 → 0.5.329

package/src/mcp/adapters/mixpanel.adapter.ts

@@ -1,324 +0,0 @@
-/**
- * MCP Skill Adapter — Mixpanel
- *
- * Maps Mixpanel API endpoints to MCP tool handlers.
- * API reference: https://developer.mixpanel.com/reference
- *
- * Auth uses Basic auth with the API secret as the username (password is empty).
- *
- * Tools:
- *   - mixpanel_query_events   Query event data with optional filters
- *   - mixpanel_get_funnels    Get funnel analysis data
- *   - mixpanel_get_retention  Get retention analysis data
- */
-
-import type {
-  SkillAdapter,
-  ToolHandler,
-  ToolResult,
-  ToolExecutionContext,
-  ResolvedCredentials,
-} from '../framework/types.js';
-
-// ─── Helpers ────────────────────────────────────────────
-
-function mixpanelError(err: unknown): ToolResult {
-  if (err instanceof Error) {
-    const data = (err as any).data;
-    if (data && typeof data === 'object') {
-      return {
-        content: `Mixpanel API error: ${data.error || data.message || err.message}`,
-        isError: true,
-      };
-    }
-    return { content: `Mixpanel API error: ${err.message}`, isError: true };
-  }
-  return { content: `Mixpanel API error: ${String(err)}`, isError: true };
-}
-
-/** Format a number with thousands separators. */
-function formatNumber(n: number | undefined): string {
-  if (n === undefined || n === null) return 'N/A';
-  return n.toLocaleString('en-US');
-}
-
-// ─── Tool: mixpanel_query_events ────────────────────────
-
-const mixpanelQueryEvents: ToolHandler = {
-  description:
-    'Query Mixpanel event data for a given date range. Returns event counts broken down by the specified event names.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      event: {
-        type: 'array',
-        items: { type: 'string' },
-        description: 'Array of event names to query (e.g. ["Sign Up", "Purchase"])',
-      },
-      from_date: {
-        type: 'string',
-        description: 'Start date in YYYY-MM-DD format',
-      },
-      to_date: {
-        type: 'string',
-        description: 'End date in YYYY-MM-DD format',
-      },
-      unit: {
-        type: 'string',
-        enum: ['hour', 'day', 'week', 'month'],
-        description: 'Time unit for grouping results (default: day)',
-      },
-    },
-    required: ['event', 'from_date', 'to_date'],
-    additionalProperties: false,
-  },
-
-  async execute(params, ctx): Promise<ToolResult> {
-    try {
-      const query: Record<string, string> = {
-        from_date: params.from_date,
-        to_date: params.to_date,
-        unit: params.unit ?? 'day',
-      };
-      // Mixpanel expects event as repeated query params or JSON-encoded
-      query.event = JSON.stringify(params.event);
-
-      const data = await ctx.apiExecutor.get('/segmentation', query);
-
-      const seriesData = data.data?.values ?? {};
-      const eventNames = Object.keys(seriesData);
-
-      if (eventNames.length === 0) {
-        return {
-          content: 'No event data returned for the specified query.',
-          metadata: { eventCount: 0 },
-        };
-      }
-
-      const lines = eventNames.map((name: string) => {
-        const dateValues = seriesData[name] ?? {};
-        const dates = Object.keys(dateValues).sort();
-        const total = (Object.values(dateValues) as number[]).reduce((sum: number, v) => sum + (Number(v) || 0), 0);
-        const lastDate = dates[dates.length - 1];
-        const lastValue = dateValues[lastDate] ?? 0;
-        return `${name}: total ${formatNumber(total)}, latest (${lastDate}): ${formatNumber(Number(lastValue))}`;
-      });
-
-      return {
-        content: `Event data from ${params.from_date} to ${params.to_date}:\n\n${lines.join('\n')}`,
-        metadata: {
-          eventNames,
-          fromDate: params.from_date,
-          toDate: params.to_date,
-        },
-      };
-    } catch (err) {
-      return mixpanelError(err);
-    }
-  },
-};
-
-// ─── Tool: mixpanel_get_funnels ─────────────────────────
-
-const mixpanelGetFunnels: ToolHandler = {
-  description:
-    'Get funnel analysis data from Mixpanel. Returns step-by-step conversion rates for a specified funnel.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      funnel_id: {
-        type: 'number',
-        description: 'The numeric ID of the funnel to retrieve',
-      },
-      from_date: {
-        type: 'string',
-        description: 'Start date in YYYY-MM-DD format',
-      },
-      to_date: {
-        type: 'string',
-        description: 'End date in YYYY-MM-DD format',
-      },
-      unit: {
-        type: 'string',
-        enum: ['day', 'week', 'month'],
-        description: 'Time unit for grouping (default: day)',
-      },
-    },
-    required: ['funnel_id', 'from_date', 'to_date'],
-    additionalProperties: false,
-  },
-
-  async execute(params, ctx): Promise<ToolResult> {
-    try {
-      const query: Record<string, string> = {
-        funnel_id: String(params.funnel_id),
-        from_date: params.from_date,
-        to_date: params.to_date,
-      };
-      if (params.unit) query.unit = params.unit;
-
-      const data = await ctx.apiExecutor.get('/funnels', query);
-
-      const _meta = data.meta ?? {};
-      const funnelData = data.data ?? {};
-      const dates = Object.keys(funnelData).sort();
-
-      if (dates.length === 0) {
-        return {
-          content: 'No funnel data returned for the specified parameters.',
-          metadata: { funnelId: params.funnel_id },
-        };
-      }
-
-      // Use the most recent date's steps for the summary
-      const latestDate = dates[dates.length - 1];
-      const steps: any[] = funnelData[latestDate]?.steps ?? [];
-
-      const stepLines = steps.map((step: any, i: number) => {
-        const count = formatNumber(step.count);
-        const rate = step.step_conv_ratio != null
-          ? (step.step_conv_ratio * 100).toFixed(1) + '%'
-          : 'N/A';
-        const overallRate = step.overall_conv_ratio != null
-          ? (step.overall_conv_ratio * 100).toFixed(1) + '%'
-          : 'N/A';
-        return `  Step ${i + 1}: ${step.event ?? 'unknown'} — ${count} users, step conversion: ${rate}, overall: ${overallRate}`;
-      });
-
-      return {
-        content: [
-          `Funnel ${params.funnel_id} (${params.from_date} to ${params.to_date})`,
-          `Data points: ${dates.length}`,
-          `Latest breakdown (${latestDate}):`,
-          ...stepLines,
-        ].join('\n'),
-        metadata: {
-          funnelId: params.funnel_id,
-          dateCount: dates.length,
-          stepCount: steps.length,
-        },
-      };
-    } catch (err) {
-      return mixpanelError(err);
-    }
-  },
-};
-
-// ─── Tool: mixpanel_get_retention ───────────────────────
-
-const mixpanelGetRetention: ToolHandler = {
-  description:
-    'Get retention analysis data from Mixpanel. Shows how many users return after their first event over a specified period.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      from_date: {
-        type: 'string',
-        description: 'Start date in YYYY-MM-DD format',
-      },
-      to_date: {
-        type: 'string',
-        description: 'End date in YYYY-MM-DD format',
-      },
-      born_event: {
-        type: 'string',
-        description: 'The initial event that defines the cohort (e.g. "Sign Up")',
-      },
-      event: {
-        type: 'string',
-        description: 'The return event to measure retention for (e.g. "App Open")',
-      },
-      retention_type: {
-        type: 'string',
-        enum: ['birth', 'compounded'],
-        description: 'Retention type: "birth" (default) or "compounded"',
-      },
-      unit: {
-        type: 'string',
-        enum: ['day', 'week', 'month'],
-        description: 'Time unit for retention periods (default: day)',
-      },
-    },
-    required: ['from_date', 'to_date'],
-    additionalProperties: false,
-  },
-
-  async execute(params, ctx): Promise<ToolResult> {
-    try {
-      const query: Record<string, string> = {
-        from_date: params.from_date,
-        to_date: params.to_date,
-      };
-      if (params.born_event) query.born_event = params.born_event;
-      if (params.event) query.event = params.event;
-      if (params.retention_type) query.retention_type = params.retention_type;
-      if (params.unit) query.unit = params.unit;
-
-      const data = await ctx.apiExecutor.get('/retention', query);
-
-      const results: any[] = data.results ?? [];
-      if (results.length === 0) {
-        return {
-          content: 'No retention data returned for the specified parameters.',
-          metadata: { cohortCount: 0 },
-        };
-      }
-
-      const lines = results.slice(0, 15).map((cohort: any) => {
-        const date = cohort.date ?? 'unknown';
-        const first = cohort.first ?? 0;
-        const counts: number[] = cohort.counts ?? [];
-        const retentionRates = counts.map((c: number) =>
-          first > 0 ? ((c / first) * 100).toFixed(1) + '%' : '0%',
-        );
-        return `${date}: ${formatNumber(first)} users — retention: ${retentionRates.join(', ')}`;
-      });
-
-      const truncNote = results.length > 15 ? `\n\n(Showing 15 of ${results.length} cohorts)` : '';
-
-      return {
-        content: `Retention data (${params.from_date} to ${params.to_date}):\n\n${lines.join('\n')}${truncNote}`,
-        metadata: {
-          cohortCount: results.length,
-          fromDate: params.from_date,
-          toDate: params.to_date,
-        },
-      };
-    } catch (err) {
-      return mixpanelError(err);
-    }
-  },
-};
-
-// ─── Adapter Export ─────────────────────────────────────
-
-export const mixpanelAdapter: SkillAdapter = {
-  skillId: 'mixpanel-analytics',
-  name: 'Mixpanel',
-  baseUrl: 'https://mixpanel.com/api/2.0',
-  auth: {
-    type: 'credentials',
-    fields: ['projectToken', 'apiSecret'],
-  },
-  tools: {
-    mixpanel_query_events: mixpanelQueryEvents,
-    mixpanel_get_funnels: mixpanelGetFunnels,
-    mixpanel_get_retention: mixpanelGetRetention,
-  },
-  rateLimits: {
-    requestsPerSecond: 5,
-    burstLimit: 15,
-  },
-
-  async initialize(credentials: ResolvedCredentials): Promise<void> {
-    const apiSecret = credentials.fields?.apiSecret;
-    if (!apiSecret) {
-      throw new Error('Mixpanel credentials require an apiSecret field');
-    }
-    // Mixpanel uses Basic auth with apiSecret as username and empty password
-    const encoded = Buffer.from(`${apiSecret}:`).toString('base64');
-    mixpanelAdapter.defaultHeaders = {
-      Authorization: `Basic ${encoded}`,
-    };
-  },
-};

package/src/mcp/adapters/monday.adapter.ts

@@ -1,308 +0,0 @@
-/**
- * MCP Skill Adapter — Monday.com
- *
- * Maps Monday.com GraphQL API to MCP tool handlers.
- * Monday uses a single POST /v2 endpoint for all operations — all requests
- * send a GraphQL query in the request body.
- *
- * Monday API docs: https://developer.monday.com/api-reference/reference
- */
-
-import type { SkillAdapter, ToolHandler, ToolResult, ToolExecutionContext } from '../framework/types.js';
-
-// ─── Helpers ────────────────────────────────────────────
-
-function mondayError(err: unknown): ToolResult {
-  if (err instanceof Error) {
-    const data = (err as any).data;
-    if (data && typeof data === 'object') {
-      const errors: any[] = data.errors || [];
-      if (errors.length > 0) {
-        const messages = errors.map((e: any) => e.message || String(e));
-        return { content: `Monday API error: ${messages.join('; ')}`, isError: true };
-      }
-      if (data.error_message) {
-        return { content: `Monday API error: ${data.error_message}`, isError: true };
-      }
-    }
-    return { content: `Monday API error: ${err.message}`, isError: true };
-  }
-  return { content: `Monday API error: ${String(err)}`, isError: true };
-}
-
-/**
- * Check GraphQL-level errors in the Monday response and throw if present.
- */
-function assertMondayOk(result: any): void {
-  if (result.errors && result.errors.length > 0) {
-    const messages = result.errors.map((e: any) => e.message || String(e));
-    const err = new Error(`Monday GraphQL error: ${messages.join('; ')}`);
-    throw err;
-  }
-}
-
-// ─── Tool: monday_list_boards ───────────────────────────
-
-const listBoards: ToolHandler = {
-  description:
-    'List boards from the Monday.com account. Returns board names, IDs, and item counts.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      limit: {
-        type: 'number',
-        description: 'Maximum number of boards to return (default 25)',
-      },
-      board_kind: {
-        type: 'string',
-        enum: ['public', 'private', 'share'],
-        description: 'Filter by board kind (optional)',
-      },
-    },
-  },
-
-  async execute(params: Record<string, any>, ctx: ToolExecutionContext): Promise<ToolResult> {
-    try {
-      const limit = params.limit ?? 25;
-      const kindFilter = params.board_kind ? `, board_kind: ${params.board_kind}` : '';
-
-      const query = `query {
-        boards(limit: ${limit}${kindFilter}) {
-          id
-          name
-          state
-          board_kind
-          items_count
-          workspace {
-            name
-          }
-        }
-      }`;
-
-      const result = await ctx.apiExecutor.post('', { query });
-      assertMondayOk(result);
-
-      const boards: any[] = result.data?.boards || [];
-
-      if (boards.length === 0) {
-        return { content: 'No boards found.' };
-      }
-
-      const lines = boards.map((b: any) => {
-        const workspace = b.workspace?.name ? ` [${b.workspace.name}]` : '';
-        const items = b.items_count != null ? ` -- ${b.items_count} items` : '';
-        return `${b.name} (${b.id}) ${b.board_kind}${workspace}${items}`;
-      });
-
-      return {
-        content: `Found ${boards.length} boards:\n${lines.join('\n')}`,
-        metadata: { count: boards.length },
-      };
-    } catch (err) {
-      return mondayError(err);
-    }
-  },
-};
-
-// ─── Tool: monday_list_items ────────────────────────────
-
-const listItems: ToolHandler = {
-  description:
-    'List items (rows) from a Monday.com board. Returns item names, IDs, and column values.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      board_id: {
-        type: 'string',
-        description: 'Board ID to list items from',
-      },
-      limit: {
-        type: 'number',
-        description: 'Maximum number of items to return (default 25)',
-      },
-      group_id: {
-        type: 'string',
-        description: 'Filter by group ID within the board (optional)',
-      },
-    },
-    required: ['board_id'],
-  },
-
-  async execute(params: Record<string, any>, ctx: ToolExecutionContext): Promise<ToolResult> {
-    try {
-      const limit = params.limit ?? 25;
-
-      let query: string;
-      if (params.group_id) {
-        query = `query {
-          boards(ids: [${params.board_id}]) {
-            groups(ids: ["${params.group_id}"]) {
-              title
-              items_page(limit: ${limit}) {
-                items {
-                  id
-                  name
-                  state
-                  group { title }
-                  column_values {
-                    id
-                    text
-                    type
-                  }
-                }
-              }
-            }
-          }
-        }`;
-      } else {
-        query = `query {
-          boards(ids: [${params.board_id}]) {
-            items_page(limit: ${limit}) {
-              items {
-                id
-                name
-                state
-                group { title }
-                column_values {
-                  id
-                  text
-                  type
-                }
-              }
-            }
-          }
-        }`;
-      }
-
-      const result = await ctx.apiExecutor.post('', { query });
-      assertMondayOk(result);
-
-      let items: any[];
-      if (params.group_id) {
-        const groups = result.data?.boards?.[0]?.groups || [];
-        items = groups.flatMap((g: any) => g.items_page?.items || []);
-      } else {
-        items = result.data?.boards?.[0]?.items_page?.items || [];
-      }
-
-      if (items.length === 0) {
-        return { content: `No items found on board ${params.board_id}.` };
-      }
-
-      const lines = items.map((item: any) => {
-        const group = item.group?.title ? ` [${item.group.title}]` : '';
-        const cols = (item.column_values || [])
-          .filter((c: any) => c.text)
-          .map((c: any) => `${c.id}: ${c.text}`)
-          .join(', ');
-        const colInfo = cols ? ` -- ${cols}` : '';
-        return `${item.name} (${item.id})${group}${colInfo}`;
-      });
-
-      return {
-        content: `Found ${items.length} items:\n${lines.join('\n')}`,
-        metadata: { count: items.length, board_id: params.board_id },
-      };
-    } catch (err) {
-      return mondayError(err);
-    }
-  },
-};
-
-// ─── Tool: monday_create_item ───────────────────────────
-
-const createItem: ToolHandler = {
-  description:
-    'Create a new item (row) on a Monday.com board. Optionally specify a group and column values as JSON.',
-  inputSchema: {
-    type: 'object',
-    properties: {
-      board_id: {
-        type: 'string',
-        description: 'Board ID to create the item on',
-      },
-      item_name: {
-        type: 'string',
-        description: 'Name of the new item',
-      },
-      group_id: {
-        type: 'string',
-        description: 'Group ID to place the item in (optional, uses default group if omitted)',
-      },
-      column_values: {
-        type: 'string',
-        description: 'JSON string of column values (e.g. \'{"status": {"label": "Working on it"}, "date4": {"date": "2024-01-15"}}\')',
-      },
-    },
-    required: ['board_id', 'item_name'],
-  },
-
-  async execute(params: Record<string, any>, ctx: ToolExecutionContext): Promise<ToolResult> {
-    try {
-      const groupArg = params.group_id ? `, group_id: "${params.group_id}"` : '';
-      const colArg = params.column_values
-        ? `, column_values: ${JSON.stringify(params.column_values)}`
-        : '';
-
-      const query = `mutation {
-        create_item(
-          board_id: ${params.board_id},
-          item_name: ${JSON.stringify(params.item_name)}${groupArg}${colArg}
-        ) {
-          id
-          name
-          board {
-            name
-          }
-          group {
-            title
-          }
-        }
-      }`;
-
-      const result = await ctx.apiExecutor.post('', { query });
-      assertMondayOk(result);
-
-      const item = result.data?.create_item;
-      if (!item) {
-        return { content: 'Item creation returned no data.', isError: true };
-      }
-
-      const boardName = item.board?.name ? ` on "${item.board.name}"` : '';
-      const groupName = item.group?.title ? ` in group "${item.group.title}"` : '';
-
-      return {
-        content: `Item created: "${item.name}" (ID: ${item.id})${boardName}${groupName}`,
-        metadata: {
-          id: item.id,
-          name: item.name,
-          board_id: params.board_id,
-        },
-      };
-    } catch (err) {
-      return mondayError(err);
-    }
-  },
-};
-
-// ─── Adapter Export ─────────────────────────────────────
-
-export const mondayAdapter: SkillAdapter = {
-  skillId: 'monday-boards',
-  name: 'Monday.com',
-  baseUrl: 'https://api.monday.com/v2',
-  auth: {
-    type: 'oauth2',
-    provider: 'monday',
-    headerPrefix: 'Bearer',
-  },
-  defaultHeaders: {
-    'Content-Type': 'application/json',
-  },
-  tools: {
-    monday_list_boards: listBoards,
-    monday_list_items: listItems,
-    monday_create_item: createItem,
-  },
-  rateLimits: { requestsPerSecond: 5, burstLimit: 15 },
-};