simstudioai--sim/apps/sim/tools/granola/get_note.ts

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