bluente-translate

---
name: translate
description: Translate files (PDF, DOCX, PPTX) to any language using the Bluente Translation API. Asks for API key, source files, target language, and output location.
---

Translate files using the Bluente Translation API.

## Step 1: Collect user inputs

Ask the user using AskUserQuestion. IMPORTANT: Every question MUST have at least 2 options (AskUserQuestion requires min 2 options per question). Use the user's "Other" free-text option for custom input.

Ask all 4 questions in a single AskUserQuestion call:

1. **API Key** — "What is your Bluente API key? (starts with sk-, get one at https://translate.bluente.com/settings/?type=apiKeys)"
   - Options: "I have my key ready" (description: "I'll type it in the Other field below"), "I need to get a key" (description: "Visit https://translate.bluente.com/settings/?type=apiKeys")
   - The user will type their actual key in the "Other" free-text field.

2. **Source path** — "What is the path to the file or folder you want to translate?"
   - Options: "Current directory" (description: "Use the current working directory"), "Enter path" (description: "I'll specify a custom path in the Other field")

3. **Target language** — "What language do you want to translate to?"
   - Options (pick 4, use the most common): "Arabic" , "French", "Spanish", "German"
   - The user can pick "Other" for any other language.

4. **Output path** — "Where should the translated files be saved?"
   - Options: "Same folder as source" (description: "Save next to the originals"), "Enter path" (description: "I'll specify a custom path in the Other field")

If the user selected "I have my key ready" but didn't type a key in "Other", ask them to provide the key in a follow-up message (don't use AskUserQuestion again for this — just ask in plain text).

## Step 2: Look up the correct language code

Use this known mapping of common language codes to avoid an extra API call:
- Arabic = `ara`, English = `en`, French = `fra`, Spanish = `