chore: import upstream snapshot with attribution

apps/sim/tools/fireflies/upload_audio.ts

@@ -0,0 +1,176 @@
+import type {
+  FirefliesUploadAudioParams,
+  FirefliesUploadAudioResponse,
+} from '@/tools/fireflies/types'
+import type { ToolConfig } from '@/tools/types'
+
+export const firefliesUploadAudioTool: ToolConfig<
+  FirefliesUploadAudioParams,
+  FirefliesUploadAudioResponse
+> = {
+  id: 'fireflies_upload_audio',
+  name: 'Fireflies Upload Audio',
+  description: 'Upload an audio file URL to Fireflies.ai for transcription',
+  version: '1.0.0',
+
+  params: {
+    apiKey: {
+      type: 'string',
+      required: true,
+      visibility: 'user-only',
+      description: 'Fireflies API key',
+    },
+    audioFile: {
+      type: 'file',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Audio/video file to upload for transcription',
+    },
+    audioUrl: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Public HTTPS URL of the audio/video file (MP3, MP4, WAV, M4A, OGG)',
+    },
+    title: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Title for the meeting/transcript',
+    },
+    webhook: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Webhook URL to notify when transcription is complete',
+    },
+    language: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Language code for transcription (e.g., "es" for Spanish, "de" for German)',
+    },
+    attendees: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description:
+        'Attendees in JSON format: [{"displayName": "Name", "email": "email@example.com"}]',
+    },
+    clientReferenceId: {
+      type: 'string',
+      required: false,
+      visibility: 'user-or-llm',
+      description: 'Custom reference ID for tracking',
+    },
+  },
+
+  request: {
+    url: 'https://api.fireflies.ai/graphql',
+    method: 'POST',
+    headers: (params) => {
+      if (!params.apiKey) {
+        throw new Error('Missing API key for Fireflies API request')
+      }
+      return {
+        'Content-Type': 'application/json',
+        Authorization: `Bearer ${params.apiKey}`,
+      }
+    },
+    body: (params) => {
+      let url: string | undefined
+
+      if (params.audioFile) {
+        url = params.audioFile.url || params.audioFile.path
+      }
+
+      if (!url && params.audioUrl) {
+        url = params.audioUrl
+      }
+
+      if (!url) {
+        throw new Error('Either an audio file or audio URL is required')
+      }
+
+      if (!url.startsWith('https://')) {
+        throw new Error('Audio URL must be a valid HTTPS URL')
+      }
+
+      const input: Record<string, unknown> = {
+        url,
+      }
+
+      if (params.title) input.title = params.title
+      if (params.webhook) input.webhook = params.webhook
+      if (params.language) input.custom_language = params.language
+      if (params.clientReferenceId) input.client_reference_id = params.clientReferenceId
+      if (params.attendees) {
+        try {
+          input.attendees = JSON.parse(params.attendees)
+        } catch {
+          throw new Error('Invalid attendees JSON format')
+        }
+      }
+
+      return {
+        query: `
+          mutation UploadAudio($input: AudioUploadInput) {
+            uploadAudio(input: $input) {
+              success
+              title
+              message
+            }
+          }
+        `,
+        variables: {
+          input,
+        },
+      }
+    },
+  },
+
+  transformResponse: async (response) => {
+    const data = await response.json()
+
+    if (data.errors) {
+      return {
+        success: false,
+        error: data.errors[0]?.message || 'Failed to upload audio',
+        output: {},
+      }
+    }
+
+    const result = data.data?.uploadAudio
+    if (!result) {
+      return {
+        success: false,
+        error: 'Upload failed',
+        output: {},
+      }
+    }
+
+    return {
+      success: result.success,
+      output: {
+        success: result.success,
+        title: result.title,
+        message: result.message,
+      },
+    }
+  },
+
+  outputs: {
+    success: {
+      type: 'boolean',
+      description: 'Whether the upload was successful',
+    },
+    title: {
+      type: 'string',
+      description: 'Title of the uploaded meeting',
+    },
+    message: {
+      type: 'string',
+      description: 'Status message from Fireflies',
+    },
+  },
+}