chore: import upstream snapshot with attribution

apps/sim/tools/telegram/send_audio.ts

@@ -0,0 +1,183 @@
+import { ErrorExtractorId } from '@/tools/error-extractors'
+import type {
+  TelegramAudio,
+  TelegramSendAudioParams,
+  TelegramSendAudioResponse,
+} from '@/tools/telegram/types'
+import { convertMarkdownToHTML } from '@/tools/telegram/utils'
+import type { ToolConfig } from '@/tools/types'
+
+export const telegramSendAudioTool: ToolConfig<TelegramSendAudioParams, TelegramSendAudioResponse> =
+  {
+    id: 'telegram_send_audio',
+    name: 'Telegram Send Audio',
+    description: 'Send audio files to Telegram channels or users through the Telegram Bot API.',
+    version: '1.0.0',
+    errorExtractor: ErrorExtractorId.TELEGRAM_DESCRIPTION,
+
+    params: {
+      botToken: {
+        type: 'string',
+        required: true,
+        visibility: 'user-only',
+        description: 'Your Telegram Bot API Token',
+      },
+      chatId: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'Telegram chat ID (numeric, can be negative for groups)',
+      },
+      audio: {
+        type: 'string',
+        required: true,
+        visibility: 'user-or-llm',
+        description: 'Audio file to send. Pass a file_id or HTTP URL',
+      },
+      caption: {
+        type: 'string',
+        required: false,
+        visibility: 'user-or-llm',
+        description: 'Audio caption (optional)',
+      },
+    },
+
+    request: {
+      url: (params: TelegramSendAudioParams) =>
+        `https://api.telegram.org/bot${params.botToken}/sendAudio`,
+      method: 'POST',
+      headers: () => ({
+        'Content-Type': 'application/json',
+      }),
+      body: (params: TelegramSendAudioParams) => {
+        const body: Record<string, any> = {
+          chat_id: params.chatId,
+          audio: params.audio,
+        }
+
+        if (params.caption) {
+          body.caption = convertMarkdownToHTML(params.caption)
+          body.parse_mode = 'HTML'
+        }
+
+        return body
+      },
+    },
+
+    transformResponse: async (response: Response) => {
+      const data = await response.json()
+
+      if (!data.ok) {
+        const errorMessage = data.description || data.error || 'Failed to send audio'
+        throw new Error(errorMessage)
+      }
+
+      const result = data.result as TelegramAudio
+
+      return {
+        success: true,
+        output: {
+          message: 'Audio sent successfully',
+          data: result,
+        },
+      }
+    },
+
+    outputs: {
+      message: { type: 'string', description: 'Success or error message' },
+      data: {
+        type: 'object',
+        description: 'Telegram message data including voice/audio information',
+        properties: {
+          message_id: {
+            type: 'number',
+            description: 'Unique Telegram message identifier',
+          },
+          from: {
+            type: 'object',
+            description: 'Information about the sender',
+            properties: {
+              id: { type: 'number', description: 'Sender ID' },
+              is_bot: {
+                type: 'boolean',
+                description: 'Whether the chat is a bot or not',
+              },
+              first_name: {
+                type: 'string',
+                description: "Sender's first name (if available)",
+              },
+              username: {
+                type: 'string',
+                description: "Sender's username (if available)",
+              },
+            },
+          },
+          chat: {
+            type: 'object',
+            description: 'Information about the chat where the message was sent',
+            properties: {
+              id: { type: 'number', description: 'Chat ID' },
+              first_name: {
+                type: 'string',
+                description: 'Chat first name (if private chat)',
+              },
+              username: {
+                type: 'string',
+                description: 'Chat username (for private or channels)',
+              },
+              type: {
+                type: 'string',
+                description: 'Type of chat (private, group, supergroup, or channel)',
+              },
+            },
+          },
+          date: {
+            type: 'number',
+            description: 'Unix timestamp when the message was sent',
+          },
+          text: {
+            type: 'string',
+            description: 'Text content of the sent message (if applicable)',
+          },
+          audio: {
+            type: 'object',
+            description: 'Audio file details',
+            properties: {
+              duration: {
+                type: 'number',
+                description: 'Duration of the audio in seconds',
+              },
+              performer: {
+                type: 'string',
+                description: 'Performer of the audio',
+              },
+              title: {
+                type: 'string',
+                description: 'Title of the audio',
+              },
+              file_name: {
+                type: 'string',
+                description: 'Original filename of the audio',
+              },
+              mime_type: {
+                type: 'string',
+                description: 'MIME type of the audio file',
+              },
+              file_id: {
+                type: 'string',
+                description: 'Unique file identifier for this audio',
+              },
+              file_unique_id: {
+                type: 'string',
+                description: 'Unique identifier across different bots for this file',
+              },
+              file_size: {
+                type: 'number',
+                description: 'Size of the audio file in bytes',
+              },
+            },
+          },
+        },
+      },
+    },
+  }