chore: import upstream snapshot with attribution

apps/sim/tools/granola/get_note.ts

@@ -0,0 +1,170 @@
+import type { GranolaGetNoteParams, GranolaGetNoteResponse } from '@/tools/granola/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const getNoteTool: ToolConfig<GranolaGetNoteParams, GranolaGetNoteResponse> = {
+  id: 'granola_get_note',
+  name: 'Granola Get Note',
+  description:
+    'Retrieves a specific meeting note from Granola by ID, including summary, attendees, calendar event details, and optionally the transcript.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Granola API key',
+    },
+    noteId: {
+      type: 'string',
+      required: true,
+      visibility: 'user-or-llm',
+      description: 'The note ID (e.g., not_1d3tmYTlCICgjy)',
+    },
+    includeTranscript: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Whether to include the meeting transcript',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const url = new URL(`https://public-api.granola.ai/v1/notes/${params.noteId.trim()}`)
+      if (params.includeTranscript === 'true') url.searchParams.append('include', 'transcript')
+      return url.toString()
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const error = await response.text()
+      throw new Error(`Granola API error (${response.status}): ${error}`)
+    }
+
+    const data = await response.json()
+
+    return {
+      success: true,
+      output: {
+        id: data.id ?? '',
+        title: data.title ?? null,
+        ownerName: data.owner?.name ?? null,
+        ownerEmail: data.owner?.email ?? '',
+        createdAt: data.created_at ?? '',
+        updatedAt: data.updated_at ?? '',
+        webUrl: data.web_url ?? '',
+        summaryText: data.summary_text ?? '',
+        summaryMarkdown: data.summary_markdown ?? null,
+        attendees: (data.attendees ?? []).map((a: { name: string | null; email: string }) => ({
+          name: a.name ?? null,
+          email: a.email ?? '',
+        })),
+        folders: (data.folder_membership ?? []).map((f: { id: string; name: string }) => ({
+          id: f.id ?? '',
+          name: f.name ?? '',
+        })),
+        calendarEventTitle: data.calendar_event?.event_title ?? null,
+        calendarOrganiser: data.calendar_event?.organiser ?? null,
+        calendarEventId: data.calendar_event?.calendar_event_id ?? null,
+        scheduledStartTime: data.calendar_event?.scheduled_start_time ?? null,
+        scheduledEndTime: data.calendar_event?.scheduled_end_time ?? null,
+        invitees: (data.calendar_event?.invitees ?? []).map((i: { email: string }) => i.email),
+        transcript: data.transcript
+          ? data.transcript.map(
+              (t: {
+                speaker: { source: string; diarization_label?: string; name?: string }
+                text: string
+                start_time: string
+                end_time: string
+              }) => ({
+                speaker: t.speaker?.source ?? 'unknown',
+                speakerLabel: t.speaker?.diarization_label ?? null,
+                speakerName: t.speaker?.name ?? null,
+                text: t.text ?? '',
+                startTime: t.start_time ?? '',
+                endTime: t.end_time ?? '',
+              })
+            )
+          : null,
+      },
+    }
+  },
+
+  outputs: {
+    id: { type: 'string', description: 'Note ID' },
+    title: { type: 'string', description: 'Note title', optional: true },
+    ownerName: { type: 'string', description: 'Note owner name', optional: true },
+    ownerEmail: { type: 'string', description: 'Note owner email' },
+    createdAt: { type: 'string', description: 'Creation timestamp' },
+    updatedAt: { type: 'string', description: 'Last update timestamp' },
+    webUrl: { type: 'string', description: 'URL to view the note in Granola' },
+    summaryText: { type: 'string', description: 'Plain text summary of the meeting' },
+    summaryMarkdown: {
+      type: 'string',
+      description: 'Markdown-formatted summary of the meeting',
+      optional: true,
+    },
+    attendees: {
+      type: 'json',
+      description: 'Meeting attendees',
+      properties: {
+        name: { type: 'string', description: 'Attendee name' },
+        email: { type: 'string', description: 'Attendee email' },
+      },
+    },
+    folders: {
+      type: 'json',
+      description: 'Folders the note belongs to',
+      properties: {
+        id: { type: 'string', description: 'Folder ID' },
+        name: { type: 'string', description: 'Folder name' },
+      },
+    },
+    calendarEventTitle: {
+      type: 'string',
+      description: 'Calendar event title',
+      optional: true,
+    },
+    calendarOrganiser: {
+      type: 'string',
+      description: 'Calendar event organiser email',
+      optional: true,
+    },
+    calendarEventId: { type: 'string', description: 'Calendar event ID', optional: true },
+    scheduledStartTime: {
+      type: 'string',
+      description: 'Scheduled start time',
+      optional: true,
+    },
+    scheduledEndTime: { type: 'string', description: 'Scheduled end time', optional: true },
+    invitees: { type: 'json', description: 'Calendar event invitee emails' },
+    transcript: {
+      type: 'json',
+      description: 'Meeting transcript entries (only if requested)',
+      optional: true,
+      properties: {
+        speaker: { type: 'string', description: 'Speaker source (microphone or speaker)' },
+        speakerLabel: {
+          type: 'string',
+          description: 'Diarization label for the speaker (e.g., Speaker A)',
+          optional: true,
+        },
+        speakerName: {
+          type: 'string',
+          description: 'Resolved name of the identified speaker, when available',
+          optional: true,
+        },
+        text: { type: 'string', description: 'Transcript text' },
+        startTime: { type: 'string', description: 'Segment start time' },
+        endTime: { type: 'string', description: 'Segment end time' },
+      },
+    },
+  },
+}

apps/sim/tools/granola/index.ts

@@ -0,0 +1,7 @@
+import { getNoteTool } from '@/tools/granola/get_note'
+import { listFoldersTool } from '@/tools/granola/list_folders'
+import { listNotesTool } from '@/tools/granola/list_notes'
+
+export const granolaListNotesTool = listNotesTool
+export const granolaGetNoteTool = getNoteTool
+export const granolaListFoldersTool = listFoldersTool

apps/sim/tools/granola/list_folders.ts

@@ -0,0 +1,93 @@
+import type { GranolaListFoldersParams, GranolaListFoldersResponse } from '@/tools/granola/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listFoldersTool: ToolConfig<GranolaListFoldersParams, GranolaListFoldersResponse> = {
+  id: 'granola_list_folders',
+  name: 'Granola List Folders',
+  description: 'Lists folders from Granola, sorted alphabetically, with pagination.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Granola API key',
+    },
+    cursor: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Pagination cursor from a previous response',
+    },
+    pageSize: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Number of folders per page (1-30, default 10)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const url = new URL('https://public-api.granola.ai/v1/folders')
+      if (params.cursor) url.searchParams.append('cursor', params.cursor)
+      if (params.pageSize) url.searchParams.append('page_size', String(params.pageSize))
+      return url.toString()
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const error = await response.text()
+      throw new Error(`Granola API error (${response.status}): ${error}`)
+    }
+
+    const data = await response.json()
+
+    return {
+      success: true,
+      output: {
+        folders: (data.folders ?? []).map(
+          (folder: { id: string; name: string; parent_folder_id: string | null }) => ({
+            id: folder.id,
+            name: folder.name ?? '',
+            parentFolderId: folder.parent_folder_id ?? null,
+          })
+        ),
+        hasMore: data.hasMore ?? false,
+        cursor: data.cursor ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    folders: {
+      type: 'json',
+      description: 'List of folders',
+      properties: {
+        id: { type: 'string', description: 'Folder ID' },
+        name: { type: 'string', description: 'Folder name' },
+        parentFolderId: {
+          type: 'string',
+          description: 'Parent folder ID, or null for top-level folders',
+          optional: true,
+        },
+      },
+    },
+    hasMore: {
+      type: 'boolean',
+      description: 'Whether more folders are available',
+    },
+    cursor: {
+      type: 'string',
+      description: 'Pagination cursor for the next page',
+      optional: true,
+    },
+  },
+}

apps/sim/tools/granola/list_notes.ts

@@ -0,0 +1,129 @@
+import type { GranolaListNotesParams, GranolaListNotesResponse } from '@/tools/granola/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const listNotesTool: ToolConfig<GranolaListNotesParams, GranolaListNotesResponse> = {
+  id: 'granola_list_notes',
+  name: 'Granola List Notes',
+  description: 'Lists meeting notes from Granola with optional date filters and pagination.',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Granola API key',
+    },
+    createdBefore: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Return notes created before this date (ISO 8601)',
+    },
+    createdAfter: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Return notes created after this date (ISO 8601)',
+    },
+    updatedAfter: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Return notes updated after this date (ISO 8601)',
+    },
+    folderId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Return notes in this folder and its child folders (e.g., fol_4y6LduVdwSKC27)',
+    },
+    cursor: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Pagination cursor from a previous response',
+    },
+    pageSize: {
+      type: 'number',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Number of notes per page (1-30, default 10)',
+    },
+  },
+
+  request: {
+    url: (params) => {
+      const url = new URL('https://public-api.granola.ai/v1/notes')
+      if (params.createdBefore) url.searchParams.append('created_before', params.createdBefore)
+      if (params.createdAfter) url.searchParams.append('created_after', params.createdAfter)
+      if (params.updatedAfter) url.searchParams.append('updated_after', params.updatedAfter)
+      if (params.folderId) url.searchParams.append('folder_id', params.folderId.trim())
+      if (params.cursor) url.searchParams.append('cursor', params.cursor)
+      if (params.pageSize) url.searchParams.append('page_size', String(params.pageSize))
+      return url.toString()
+    },
+    method: 'GET',
+    headers: (params) => ({
+      Authorization: `Bearer ${params.apiKey}`,
+      'Content-Type': 'application/json',
+    }),
+  },
+
+  transformResponse: async (response: Response) => {
+    if (!response.ok) {
+      const error = await response.text()
+      throw new Error(`Granola API error (${response.status}): ${error}`)
+    }
+
+    const data = await response.json()
+
+    return {
+      success: true,
+      output: {
+        notes: (data.notes ?? []).map(
+          (note: {
+            id: string
+            title: string | null
+            owner: { name: string | null; email: string }
+            created_at: string
+            updated_at: string
+          }) => ({
+            id: note.id,
+            title: note.title ?? null,
+            ownerName: note.owner?.name ?? null,
+            ownerEmail: note.owner?.email ?? '',
+            createdAt: note.created_at ?? '',
+            updatedAt: note.updated_at ?? '',
+          })
+        ),
+        hasMore: data.hasMore ?? false,
+        cursor: data.cursor ?? null,
+      },
+    }
+  },
+
+  outputs: {
+    notes: {
+      type: 'json',
+      description: 'List of meeting notes',
+      properties: {
+        id: { type: 'string', description: 'Note ID' },
+        title: { type: 'string', description: 'Note title' },
+        ownerName: { type: 'string', description: 'Note owner name' },
+        ownerEmail: { type: 'string', description: 'Note owner email' },
+        createdAt: { type: 'string', description: 'Creation timestamp' },
+        updatedAt: { type: 'string', description: 'Last update timestamp' },
+      },
+    },
+    hasMore: {
+      type: 'boolean',
+      description: 'Whether more notes are available',
+    },
+    cursor: {
+      type: 'string',
+      description: 'Pagination cursor for the next page',
+      optional: true,
+    },
+  },
+}

apps/sim/tools/granola/types.ts

@@ -0,0 +1,82 @@
+import type { ToolResponse } from '@/tools/types'
+
+export interface GranolaListNotesParams {
+  apiKey: string
+  createdBefore?: string
+  createdAfter?: string
+  updatedAfter?: string
+  folderId?: string
+  cursor?: string
+  pageSize?: number
+}
+
+export interface GranolaGetNoteParams {
+  apiKey: string
+  noteId: string
+  includeTranscript?: string
+}
+
+export interface GranolaListFoldersParams {
+  apiKey: string
+  cursor?: string
+  pageSize?: number
+}
+
+export interface GranolaListNotesResponse extends ToolResponse {
+  output: {
+    notes: {
+      id: string
+      title: string | null
+      ownerName: string | null
+      ownerEmail: string
+      createdAt: string
+      updatedAt: string
+    }[]
+    hasMore: boolean
+    cursor: string | null
+  }
+}
+
+export interface GranolaListFoldersResponse extends ToolResponse {
+  output: {
+    folders: {
+      id: string
+      name: string
+      parentFolderId: string | null
+    }[]
+    hasMore: boolean
+    cursor: string | null
+  }
+}
+
+export interface GranolaGetNoteResponse extends ToolResponse {
+  output: {
+    id: string
+    title: string | null
+    ownerName: string | null
+    ownerEmail: string
+    createdAt: string
+    updatedAt: string
+    webUrl: string
+    summaryText: string
+    summaryMarkdown: string | null
+    attendees: { name: string | null; email: string }[]
+    folders: { id: string; name: string }[]
+    calendarEventTitle: string | null
+    calendarOrganiser: string | null
+    calendarEventId: string | null
+    scheduledStartTime: string | null
+    scheduledEndTime: string | null
+    invitees: string[]
+    transcript:
+      | {
+          speaker: string
+          speakerLabel: string | null
+          speakerName: string | null
+          text: string
+          startTime: string
+          endTime: string
+        }[]
+      | null
+  }
+}