⚡ (fileUpload) New visibility option: "Public", "Private" or "Auto" (#1196)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->

## Summary by CodeRabbit

- **New Features**
- Introduced file visibility options for uploaded files, allowing users
to set files as public or private.
- Added a new API endpoint for retrieving temporary URLs for files,
enhancing file accessibility.
- Expanded file upload documentation to include information on file
visibility settings.
- Updated URL validation to support URLs with port numbers and
"http://localhost".
- **Enhancements**
- Improved media download functionality by replacing the `got` library
with a custom `downloadMedia` function.
- Enhanced bot flow continuation and session start logic to support a
wider range of reply types, including WhatsApp media messages.
- **Bug Fixes**
- Adjusted file path and URL construction in the `generateUploadUrl`
function to correctly reflect file visibility settings.

<!-- end of auto-generated comment: release notes by coderabbit.ai -->

packages/bot-engine/types.ts

@@ -18,6 +18,15 @@ export type ExecuteIntegrationResponse = {
   customEmbedBubble?: CustomEmbedBubble
 } & Pick<ContinueChatResponse, 'clientSideActions' | 'logs'>
 
+type WhatsAppMediaMessage = {
+  type: 'whatsapp media'
+  mediaId: string
+  workspaceId?: string
+  accessToken: string
+}
+
+export type Reply = string | WhatsAppMediaMessage | undefined
+
 export type ParsedReply =
   | { status: 'success'; reply: string }
   | { status: 'fail' }