feat(voice): автоконвертация WAV → OGG/Opus в telegram_send_voice

[konard]

Описание

Закрывает #483.

Инструмент telegram_send_voice теперь автоматически преобразует WAV‑файлы в OGG/Opus перед отправкой в Telegram. Раньше так делалось только в режиме TTS (через wavToOggOpus в Groq‑провайдере); ветка voicePath отправляла файл в Telegram «как есть», поэтому WAV-вход приходил как обычный документ, а не как голосовое сообщение, и возникала ошибка unsupported audio format.

Что изменилось

• src/agent/tools/telegram/media/send-voice.ts
  • После validateReadPath(voicePath) читается первые 12 байт и проверяется WAV‑сигнатура RIFF…WAVE.
  • При совпадении файл прогоняется через существующий wavToOggOpus (чисто JS Opus‑энкодер на WebAssembly, без зависимости от системного ffmpeg).
  • Результат пишется в tmpdir()/teleton-tts/<uuid>.ogg, путь подменяется и помечается для очистки в существующем finally‑блоке.
  • OGG/Opus, MP3 и прочие форматы по‑прежнему отправляются без изменений (обратная совместимость).
  • Обновлены description инструмента и voicePath (упомянут WAV и авто‑конверсия).

Покрытие тестами

src/agent/tools/telegram/media/__tests__/send-voice.test.ts:

1. Уже существующий тест: text → TTS → отправка как voice note (без регрессий).
2. Новый: WAV через voicePath транскодируется в OGG/Opus и попадает в GramJS как .ogg, временный файл удаляется после отправки.
3. Новый: OGG через voicePath отправляется без вызова wavToOggOpus (обратная совместимость).
4. Новый: при падении транскодинга возвращается явная ошибка Failed to convert WAV voice file to OGG/Opus: …, sendFile не вызывается.

Acceptance criteria

• telegram_send_voice принимает voicePath или text и автоматически возвращает валидное OGG/Opus голосовое сообщение.
• Дополнительные кодеки/аудиобиблиотеки не нужны — конверсия идёт через уже подключённый opusscript. Системный ffmpeg также не требуется.
• Существующая функциональность (текст, готовые медиа) не сломана: см. unchanged‑тест и явный тест на OGG‑файл.
• Тесты покрывают новый путь конверсии и проверяют, что итоговый файл — OGG.
• Если voicePath уже OGG/Opus — конверсия пропускается.

Локальные проверки

• npm run lint — без ошибок.
• npx tsc --noEmit — без ошибок (после npm run build:sdk).
• npm run format:check — все файлы соответствуют Prettier.
• npx vitest run — 210 файлов, 3522 тестов, все зелёные.

Воспроизведение бага и проверка фикса

До фикса:

await telegramSendVoiceExecutor(
  { chatId: "123", voicePath: "downloads/groq-output.wav" },
  ctx
);
// → Telegram отвергает WAV: "unsupported audio format"

После фикса WAV прозрачно перекодируется в OGG/Opus, и Telegram принимает его как voice note. См. тест auto-converts a WAV file passed via voicePath into OGG/Opus before sending.

Fixes #483

[konard]

Working session summary

Готово. Что сделано:

Реализация — src/agent/tools/telegram/media/send-voice.ts

• После валидации voicePath читаются первые байты, проверяется WAV‑сигнатура RIFF…WAVE.
• При совпадении файл прогоняется через уже существующий wavToOggOpus (чистый JS Opus‑энкодер, без зависимости от системного ffmpeg), результат пишется в tmpdir()/teleton-tts/<uuid>.ogg и подменяется как audioPath.
• Временный файл помечается в generatedFile, чтобы существующий finally его подчистил.
• OGG/Opus, MP3 и прочие форматы — без изменений (обратная совместимость).
• Обновлены description инструмента и параметра voicePath.

Тесты — src/agent/tools/telegram/media/__tests__/send-voice.test.ts

• Сохранён существующий тест на TTS.
• Добавлены три теста: WAV→OGG конвертация и cleanup; OGG проходит без перекодирования; явная ошибка при падении транскодера, sendFile не вызывается.

Проверки: npm run lint, npx tsc --noEmit, npm run format:check, npx vitest run (210 файлов / 3522 теста) — все зелёные.

PR xlabtg/teleton-agent#484 обновлён, переведён в ready: #484

---

This summary was automatically extracted from the AI working session output.

[konard]

🤖 Solution Draft Log

This log file contains the complete execution trace of the AI solution draft process.

💰 Cost: $3.145880

📊 Context and tokens usage:

• 98.1K / 1M (10%) input tokens, 19.2K / 128K (15%) output tokens

Total: (74 new + 94.1K cache writes + 4.2M cache reads) input tokens, 19.2K output tokens, $3.145880 cost

🤖 Models used:

• Tool: Anthropic Claude Code
• Requested: opus
• Model: Claude Opus 4.7 (claude-opus-4-7)

📎 Log file uploaded as Gist (1644KB)

• View complete solution draft log

---

Now working session is ended, feel free to review and add any feedback on the solution draft.

[konard]

✅ Ready to merge

This pull request is now ready to be merged:

• All CI checks have passed
• No merge conflicts
• No pending changes

---

Monitored by hive-mind with --auto-restart-until-mergeable flag