chore: import upstream snapshot with attribution

apps/sim/tools/fathom/list_meetings.ts

@@ -0,0 +1,413 @@
+import type { FathomListMeetingsParams, FathomListMeetingsResponse } from '@/tools/fathom/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listMeetingsTool: ToolConfig<FathomListMeetingsParams, FathomListMeetingsResponse> = {
+  id: 'fathom_list_meetings',
+  name: 'Fathom List Meetings',
+  description: 'List recent meetings recorded by the user or shared to their team.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Fathom API Key',
+    },
+    includeSummary: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include meeting summary (true/false)',
+    },
+    includeTranscript: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include meeting transcript (true/false)',
+    },
+    includeActionItems: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include action items (true/false)',
+    },
+    includeCrmMatches: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include linked CRM matches (true/false)',
+    },
+    includeHighlights: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Include meeting highlights (true/false)',
+    },
+    createdAfter: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter meetings created after this ISO 8601 timestamp',
+    },
+    createdBefore: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter meetings created before this ISO 8601 timestamp',
+    },
+    recordedBy: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by recorder email address',
+    },
+    teams: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by team name',
+    },
+    meetingType: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by meeting type name',
+    },
+    calendarInviteesDomains: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by calendar invitee company domain (exact match)',
+    },
+    calendarInviteesDomainsType: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Filter by invitee domain type: all, only_internal, or one_or_more_external',
+    },
+    cursor: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Pagination cursor from a previous response',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const url = new URL('https://api.fathom.ai/external/v1/meetings')
+      if (params.includeSummary === 'true') url.searchParams.append('include_summary', 'true')
+      if (params.includeTranscript === 'true') url.searchParams.append('include_transcript', 'true')
+      if (params.includeActionItems === 'true')
+        url.searchParams.append('include_action_items', 'true')
+      if (params.includeCrmMatches === 'true')
+        url.searchParams.append('include_crm_matches', 'true')
+      if (params.includeHighlights === 'true') url.searchParams.append('include_highlights', 'true')
+      if (params.createdAfter) url.searchParams.append('created_after', params.createdAfter)
+      if (params.createdBefore) url.searchParams.append('created_before', params.createdBefore)
+      if (params.recordedBy) url.searchParams.append('recorded_by[]', params.recordedBy)
+      if (params.teams) url.searchParams.append('teams[]', params.teams)
+      if (params.meetingType) url.searchParams.append('meeting_type', params.meetingType)
+      if (params.calendarInviteesDomains)
+        url.searchParams.append('calendar_invitees_domains[]', params.calendarInviteesDomains)
+      if (params.calendarInviteesDomainsType && params.calendarInviteesDomainsType !== 'all')
+        url.searchParams.append(
+          'calendar_invitees_domains_type',
+          params.calendarInviteesDomainsType
+        )
+      if (params.cursor) url.searchParams.append('cursor', params.cursor)
+      return url.toString()
+    },
+    method: 'GET',
+    headers: (params) => ({
+      'X-Api-Key': params.apiKey,
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}))
+      return {
+        success: false,
+        error:
+          (errorData as Record<string, string>).message ||
+          `Fathom API error: ${response.status} ${response.statusText}`,
+        output: {
+          meetings: [],
+          next_cursor: null,
+        },
+      }
+    }
+
+    const data = await response.json()
+
+    const meetings = (data.items ?? []).map(
+      (meeting: Record<string, unknown> & { recorded_by?: Record<string, unknown> }) => ({
+        title: meeting.title ?? '',
+        meeting_title: meeting.meeting_title ?? null,
+        meeting_type: meeting.meeting_type ?? null,
+        recording_id: meeting.recording_id ?? null,
+        url: meeting.url ?? '',
+        meeting_url: meeting.meeting_url ?? null,
+        share_url: meeting.share_url ?? '',
+        created_at: meeting.created_at ?? '',
+        scheduled_start_time: meeting.scheduled_start_time ?? null,
+        scheduled_end_time: meeting.scheduled_end_time ?? null,
+        recording_start_time: meeting.recording_start_time ?? null,
+        recording_end_time: meeting.recording_end_time ?? null,
+        transcript_language: meeting.transcript_language ?? '',
+        calendar_invitees_domains_type: meeting.calendar_invitees_domains_type ?? null,
+        shared_with: meeting.shared_with ?? null,
+        recorded_by: meeting.recorded_by
+          ? {
+              name: meeting.recorded_by.name ?? '',
+              email: meeting.recorded_by.email ?? '',
+              email_domain: meeting.recorded_by.email_domain ?? '',
+              team: meeting.recorded_by.team ?? null,
+            }
+          : null,
+        calendar_invitees: (meeting.calendar_invitees as Array<Record<string, unknown>>) ?? [],
+        default_summary: meeting.default_summary ?? null,
+        transcript: meeting.transcript ?? null,
+        action_items: meeting.action_items ?? null,
+        highlights: meeting.highlights ?? null,
+        crm_matches: meeting.crm_matches ?? null,
+      })
+    )
+
+    return {
+      success: true,
+      output: {
+        meetings,
+        next_cursor: data.next_cursor ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    meetings: {
+      type: 'array',
+      description: 'List of meetings',
+      items: {
+        type: 'object',
+        properties: {
+          title: { type: 'string', description: 'Meeting title' },
+          meeting_title: { type: 'string', description: 'Calendar event title', optional: true },
+          meeting_type: { type: 'string', description: 'Meeting type name', optional: true },
+          recording_id: { type: 'number', description: 'Unique recording ID', optional: true },
+          url: { type: 'string', description: 'URL to view the meeting' },
+          meeting_url: {
+            type: 'string',
+            description: 'URL of the underlying video call (Zoom, Meet, Teams, etc.)',
+            optional: true,
+          },
+          share_url: { type: 'string', description: 'Shareable URL' },
+          created_at: { type: 'string', description: 'Creation timestamp' },
+          scheduled_start_time: {
+            type: 'string',
+            description: 'Scheduled start time',
+            optional: true,
+          },
+          scheduled_end_time: {
+            type: 'string',
+            description: 'Scheduled end time',
+            optional: true,
+          },
+          recording_start_time: {
+            type: 'string',
+            description: 'Recording start time',
+            optional: true,
+          },
+          recording_end_time: {
+            type: 'string',
+            description: 'Recording end time',
+            optional: true,
+          },
+          transcript_language: { type: 'string', description: 'Transcript language' },
+          calendar_invitees_domains_type: {
+            type: 'string',
+            description: 'Invitee domain type: only_internal or one_or_more_external',
+            optional: true,
+          },
+          shared_with: {
+            type: 'string',
+            description: 'Sharing scope: no_teams, single_team, multiple_teams, or all_teams',
+            optional: true,
+          },
+          recorded_by: {
+            type: 'object',
+            description: 'Recorder details',
+            optional: true,
+            properties: {
+              name: { type: 'string', description: 'Name of the recorder' },
+              email: { type: 'string', description: 'Email of the recorder' },
+              email_domain: { type: 'string', description: 'Email domain of the recorder' },
+              team: { type: 'string', description: 'Recorder team name', optional: true },
+            },
+          },
+          calendar_invitees: {
+            type: 'array',
+            description: 'Calendar invitees for the meeting',
+            items: {
+              type: 'object',
+              properties: {
+                name: { type: 'string', description: 'Invitee name', optional: true },
+                email: { type: 'string', description: 'Invitee email', optional: true },
+                email_domain: {
+                  type: 'string',
+                  description: 'Invitee email domain',
+                  optional: true,
+                },
+                is_external: { type: 'boolean', description: 'Whether the invitee is external' },
+                matched_speaker_display_name: {
+                  type: 'string',
+                  description: 'Matched transcript speaker display name',
+                  optional: true,
+                },
+              },
+            },
+          },
+          default_summary: {
+            type: 'object',
+            description: 'Meeting summary',
+            optional: true,
+            properties: {
+              template_name: {
+                type: 'string',
+                description: 'Summary template name',
+                optional: true,
+              },
+              markdown_formatted: {
+                type: 'string',
+                description: 'Markdown-formatted summary',
+                optional: true,
+              },
+            },
+          },
+          transcript: {
+            type: 'array',
+            description: 'Transcript entries with speaker, text, and timestamp',
+            optional: true,
+            items: {
+              type: 'object',
+              properties: {
+                speaker: {
+                  type: 'object',
+                  description: 'Speaker information',
+                  properties: {
+                    display_name: { type: 'string', description: 'Speaker display name' },
+                    matched_calendar_invitee_email: {
+                      type: 'string',
+                      description: 'Matched calendar invitee email',
+                      optional: true,
+                    },
+                  },
+                },
+                text: { type: 'string', description: 'Transcript text' },
+                timestamp: { type: 'string', description: 'Timestamp (HH:MM:SS)' },
+              },
+            },
+          },
+          action_items: {
+            type: 'array',
+            description: 'Action items extracted from the meeting',
+            optional: true,
+            items: {
+              type: 'object',
+              properties: {
+                description: { type: 'string', description: 'Action item description' },
+                user_generated: {
+                  type: 'boolean',
+                  description: 'Whether the action item was user-generated',
+                },
+                completed: { type: 'boolean', description: 'Whether the action item is completed' },
+                recording_timestamp: {
+                  type: 'string',
+                  description: 'Timestamp in the recording (HH:MM:SS)',
+                },
+                recording_playback_url: {
+                  type: 'string',
+                  description: 'Playback URL for the action item moment',
+                },
+                assignee: {
+                  type: 'object',
+                  description: 'Assignee details',
+                  properties: {
+                    name: { type: 'string', description: 'Assignee name', optional: true },
+                    email: { type: 'string', description: 'Assignee email', optional: true },
+                    team: { type: 'string', description: 'Assignee team', optional: true },
+                  },
+                },
+              },
+            },
+          },
+          highlights: {
+            type: 'array',
+            description: 'Meeting highlights with type, summary, text, and start/end time',
+            optional: true,
+            items: {
+              type: 'object',
+              properties: {
+                type: { type: 'string', description: 'Highlight type' },
+                summary: { type: 'string', description: 'Highlight summary', optional: true },
+                text: { type: 'string', description: 'Highlight text' },
+                start_time: { type: 'number', description: 'Start time in seconds' },
+                end_time: { type: 'number', description: 'End time in seconds' },
+              },
+            },
+          },
+          crm_matches: {
+            type: 'object',
+            description: 'Matched CRM contacts, companies, and deals',
+            optional: true,
+            properties: {
+              contacts: {
+                type: 'array',
+                description: 'Matched CRM contacts',
+                items: {
+                  type: 'object',
+                  properties: {
+                    name: { type: 'string', description: 'Contact name' },
+                    email: { type: 'string', description: 'Contact email' },
+                    record_url: { type: 'string', description: 'CRM record URL' },
+                  },
+                },
+              },
+              companies: {
+                type: 'array',
+                description: 'Matched CRM companies',
+                items: {
+                  type: 'object',
+                  properties: {
+                    name: { type: 'string', description: 'Company name' },
+                    record_url: { type: 'string', description: 'CRM record URL' },
+                  },
+                },
+              },
+              deals: {
+                type: 'array',
+                description: 'Matched CRM deals',
+                items: {
+                  type: 'object',
+                  properties: {
+                    name: { type: 'string', description: 'Deal name' },
+                    amount: { type: 'number', description: 'Deal amount' },
+                    record_url: { type: 'string', description: 'CRM record URL' },
+                  },
+                },
+              },
+              error: { type: 'string', description: 'CRM match error, if any', optional: true },
+            },
+          },
+        },
+      },
+    },
+    next_cursor: {
+      type: 'string',
+      description: 'Pagination cursor for next page',
+      optional: true,
+    },
+  },
+}