chore: import upstream snapshot with attribution

apps/sim/tools/fathom/get_summary.ts

@@ -0,0 +1,74 @@
+import type { FathomGetSummaryParams, FathomGetSummaryResponse } from '@/tools/fathom/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const getSummaryTool: ToolConfig<FathomGetSummaryParams, FathomGetSummaryResponse> = {
+  id: 'fathom_get_summary',
+  name: 'Fathom Get Summary',
+  description: 'Get the call summary for a specific meeting recording.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Fathom API Key',
+    },
+    recordingId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The recording ID of the meeting',
+    },
+  },
+
+  request: {
+    url: (params) =>
+      `https://api.fathom.ai/external/v1/recordings/${encodeURIComponent(params.recordingId.trim())}/summary`,
+    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: {
+          template_name: null,
+          markdown_formatted: null,
+        },
+      }
+    }
+
+    const data = await response.json()
+    const summary = data.summary ?? data
+
+    return {
+      success: true,
+      output: {
+        template_name: summary.template_name ?? null,
+        markdown_formatted: summary.markdown_formatted ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    template_name: {
+      type: 'string',
+      description: 'Name of the summary template used',
+      optional: true,
+    },
+    markdown_formatted: {
+      type: 'string',
+      description: 'Markdown-formatted summary text',
+      optional: true,
+    },
+  },
+}

apps/sim/tools/fathom/get_transcript.ts

@@ -0,0 +1,95 @@
+import type { FathomGetTranscriptParams, FathomGetTranscriptResponse } from '@/tools/fathom/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const getTranscriptTool: ToolConfig<FathomGetTranscriptParams, FathomGetTranscriptResponse> =
+  {
+    id: 'fathom_get_transcript',
+    name: 'Fathom Get Transcript',
+    description: 'Get the full transcript for a specific meeting recording.',
+    version: '1.0.0',
+
+    params: {
+      apiKey: {
+        type: 'string',
+        required: true,
+        visibility: 'user-only',
+        description: 'Fathom API Key',
+      },
+      recordingId: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'The recording ID of the meeting',
+      },
+    },
+
+    request: {
+      url: (params) =>
+        `https://api.fathom.ai/external/v1/recordings/${encodeURIComponent(params.recordingId.trim())}/transcript`,
+      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: {
+            transcript: [],
+          },
+        }
+      }
+
+      const data = await response.json()
+      const transcript = (data.transcript ?? []).map(
+        (entry: { speaker?: Record<string, unknown>; text?: string; timestamp?: string }) => ({
+          speaker: {
+            display_name: entry.speaker?.display_name ?? '',
+            matched_calendar_invitee_email: entry.speaker?.matched_calendar_invitee_email ?? null,
+          },
+          text: entry.text ?? '',
+          timestamp: entry.timestamp ?? '',
+        })
+      )
+
+      return {
+        success: true,
+        output: {
+          transcript,
+        },
+      }
+    },
+
+    outputs: {
+      transcript: {
+        type: 'array',
+        description: 'Array of transcript entries with speaker, text, and timestamp',
+        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)' },
+          },
+        },
+      },
+    },
+  }

apps/sim/tools/fathom/index.ts

@@ -0,0 +1,15 @@
+import { getSummaryTool } from '@/tools/fathom/get_summary'
+import { getTranscriptTool } from '@/tools/fathom/get_transcript'
+import { listMeetingTypesTool } from '@/tools/fathom/list_meeting_types'
+import { listMeetingsTool } from '@/tools/fathom/list_meetings'
+import { listTeamMembersTool } from '@/tools/fathom/list_team_members'
+import { listTeamsTool } from '@/tools/fathom/list_teams'
+
+export const fathomGetSummaryTool = getSummaryTool
+export const fathomGetTranscriptTool = getTranscriptTool
+export const fathomListMeetingsTool = listMeetingsTool
+export const fathomListMeetingTypesTool = listMeetingTypesTool
+export const fathomListTeamMembersTool = listTeamMembersTool
+export const fathomListTeamsTool = listTeamsTool
+
+export * from './types'

apps/sim/tools/fathom/list_meeting_types.ts

@@ -0,0 +1,96 @@
+import type {
+  FathomListMeetingTypesParams,
+  FathomListMeetingTypesResponse,
+} from '@/tools/fathom/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listMeetingTypesTool: ToolConfig<
+  FathomListMeetingTypesParams,
+  FathomListMeetingTypesResponse
+> = {
+  id: 'fathom_list_meeting_types',
+  name: 'Fathom List Meeting Types',
+  description: 'List meeting types configured in your Fathom organization.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Fathom API Key',
+    },
+    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/meeting_types')
+      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: {
+          meetingTypes: [],
+          next_cursor: null,
+        },
+      }
+    }
+
+    const data = await response.json()
+    const meetingTypes = (data.items ?? []).map(
+      (meetingType: { name?: string; status?: string; created_at?: string }) => ({
+        name: meetingType.name ?? '',
+        status: meetingType.status ?? '',
+        created_at: meetingType.created_at ?? '',
+      })
+    )
+
+    return {
+      success: true,
+      output: {
+        meetingTypes,
+        next_cursor: data.next_cursor ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    meetingTypes: {
+      type: 'array',
+      description: 'List of meeting types',
+      items: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Meeting type name' },
+          status: { type: 'string', description: 'Meeting type status: active or inactive' },
+          created_at: { type: 'string', description: 'Date the meeting type was created' },
+        },
+      },
+    },
+    next_cursor: {
+      type: 'string',
+      description: 'Pagination cursor for next page',
+      optional: true,
+    },
+  },
+}

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,
+    },
+  },
+}

apps/sim/tools/fathom/list_team_members.ts

@@ -0,0 +1,103 @@
+import type {
+  FathomListTeamMembersParams,
+  FathomListTeamMembersResponse,
+} from '@/tools/fathom/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listTeamMembersTool: ToolConfig<
+  FathomListTeamMembersParams,
+  FathomListTeamMembersResponse
+> = {
+  id: 'fathom_list_team_members',
+  name: 'Fathom List Team Members',
+  description: 'List team members in your Fathom organization.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Fathom API Key',
+    },
+    teams: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Team name to filter by',
+    },
+    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/team_members')
+      if (params.teams) url.searchParams.append('team', params.teams)
+      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: {
+          members: [],
+          next_cursor: null,
+        },
+      }
+    }
+
+    const data = await response.json()
+    const members = (data.items ?? []).map(
+      (member: { name?: string; email?: string; created_at?: string }) => ({
+        name: member.name ?? '',
+        email: member.email ?? '',
+        created_at: member.created_at ?? '',
+      })
+    )
+
+    return {
+      success: true,
+      output: {
+        members,
+        next_cursor: data.next_cursor ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    members: {
+      type: 'array',
+      description: 'List of team members',
+      items: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Team member name' },
+          email: { type: 'string', description: 'Team member email' },
+          created_at: { type: 'string', description: 'Date the member was added' },
+        },
+      },
+    },
+    next_cursor: {
+      type: 'string',
+      description: 'Pagination cursor for next page',
+      optional: true,
+    },
+  },
+}

apps/sim/tools/fathom/list_teams.ts

@@ -0,0 +1,86 @@
+import type { FathomListTeamsParams, FathomListTeamsResponse } from '@/tools/fathom/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listTeamsTool: ToolConfig<FathomListTeamsParams, FathomListTeamsResponse> = {
+  id: 'fathom_list_teams',
+  name: 'Fathom List Teams',
+  description: 'List teams in your Fathom organization.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Fathom API Key',
+    },
+    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/teams')
+      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: {
+          teams: [],
+          next_cursor: null,
+        },
+      }
+    }
+
+    const data = await response.json()
+    const teams = (data.items ?? []).map((team: { name?: string; created_at?: string }) => ({
+      name: team.name ?? '',
+      created_at: team.created_at ?? '',
+    }))
+
+    return {
+      success: true,
+      output: {
+        teams,
+        next_cursor: data.next_cursor ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    teams: {
+      type: 'array',
+      description: 'List of teams',
+      items: {
+        type: 'object',
+        properties: {
+          name: { type: 'string', description: 'Team name' },
+          created_at: { type: 'string', description: 'Date the team was created' },
+        },
+      },
+    },
+    next_cursor: {
+      type: 'string',
+      description: 'Pagination cursor for next page',
+      optional: true,
+    },
+  },
+}

apps/sim/tools/fathom/types.ts

@@ -0,0 +1,157 @@
+import type { ToolResponse } from '@/tools/types'
+
+interface FathomBaseParams {
+  apiKey: string
+}
+
+export interface FathomListMeetingsParams extends FathomBaseParams {
+  includeSummary?: string
+  includeTranscript?: string
+  includeActionItems?: string
+  includeCrmMatches?: string
+  includeHighlights?: string
+  createdAfter?: string
+  createdBefore?: string
+  recordedBy?: string
+  teams?: string
+  meetingType?: string
+  calendarInviteesDomains?: string
+  calendarInviteesDomainsType?: string
+  cursor?: string
+}
+
+export interface FathomListMeetingsResponse extends ToolResponse {
+  output: {
+    meetings: Array<{
+      title: string
+      meeting_title: string | null
+      meeting_type: string | null
+      recording_id: number | null
+      url: string
+      meeting_url: string | null
+      share_url: string
+      created_at: string
+      scheduled_start_time: string | null
+      scheduled_end_time: string | null
+      recording_start_time: string | null
+      recording_end_time: string | null
+      transcript_language: string
+      calendar_invitees_domains_type: string | null
+      shared_with: string | null
+      recorded_by: { name: string; email: string; email_domain: string; team: string | null } | null
+      calendar_invitees: Array<{
+        name: string | null
+        email: string
+        email_domain: string | null
+        is_external: boolean
+        matched_speaker_display_name: string | null
+      }>
+      default_summary: { template_name: string | null; markdown_formatted: string | null } | null
+      transcript: Array<{
+        speaker: { display_name: string; matched_calendar_invitee_email: string | null }
+        text: string
+        timestamp: string
+      }> | null
+      action_items: Array<{
+        description: string
+        user_generated: boolean
+        completed: boolean
+        recording_timestamp: string
+        recording_playback_url: string
+        assignee: { name: string | null; email: string | null; team: string | null }
+      }> | null
+      highlights: Array<{
+        type: string
+        summary: string | null
+        text: string
+        start_time: number
+        end_time: number
+      }> | null
+      crm_matches: {
+        contacts: Array<{ name: string; email: string; record_url: string }>
+        companies: Array<{ name: string; record_url: string }>
+        deals: Array<{ name: string; amount: number; record_url: string }>
+        error: string | null
+      } | null
+    }>
+    next_cursor: string | null
+  }
+}
+
+export interface FathomGetSummaryParams extends FathomBaseParams {
+  recordingId: string
+}
+
+export interface FathomGetSummaryResponse extends ToolResponse {
+  output: {
+    template_name: string | null
+    markdown_formatted: string | null
+  }
+}
+
+export interface FathomGetTranscriptParams extends FathomBaseParams {
+  recordingId: string
+}
+
+export interface FathomGetTranscriptResponse extends ToolResponse {
+  output: {
+    transcript: Array<{
+      speaker: { display_name: string; matched_calendar_invitee_email: string | null }
+      text: string
+      timestamp: string
+    }>
+  }
+}
+
+export interface FathomListTeamMembersParams extends FathomBaseParams {
+  teams?: string
+  cursor?: string
+}
+
+export interface FathomListTeamMembersResponse extends ToolResponse {
+  output: {
+    members: Array<{
+      name: string
+      email: string
+      created_at: string
+    }>
+    next_cursor: string | null
+  }
+}
+
+export interface FathomListTeamsParams extends FathomBaseParams {
+  cursor?: string
+}
+
+export interface FathomListTeamsResponse extends ToolResponse {
+  output: {
+    teams: Array<{
+      name: string
+      created_at: string
+    }>
+    next_cursor: string | null
+  }
+}
+
+export interface FathomListMeetingTypesParams extends FathomBaseParams {
+  cursor?: string
+}
+
+export interface FathomListMeetingTypesResponse extends ToolResponse {
+  output: {
+    meetingTypes: Array<{
+      name: string
+      status: string
+      created_at: string
+    }>
+    next_cursor: string | null
+  }
+}
+
+export type FathomResponse =
+  | FathomListMeetingsResponse
+  | FathomGetSummaryResponse
+  | FathomGetTranscriptResponse
+  | FathomListTeamMembersResponse
+  | FathomListTeamsResponse
+  | FathomListMeetingTypesResponse