feat(minimax tts): expose all voice/audio parameters on the tts subcommand

[hhdhh]

feat(minimax tts): expose all voice/audio parameters on the tts subcommand

Summary

The MiniMax TTS backend (cli_anything/minimax/utils/minimax_backend.py)
already supported a full set of voice and audio parameters, but the CLI
exposed only --text, --model, --voice, and --output. Every other
field was hardcoded, so users had to fork the harness to change speech
speed, volume, pitch, sample rate, bitrate, audio format, or channel
layout.

This change promotes all seven hardcoded parameters to first-class CLI
options on the tts subcommand, with click-level range and choice
validation, and adds a regression test module.

What changed

cli_anything/minimax/utils/minimax_backend.py

• tts_synthesize(...) gains 7 new parameters: speed, vol, pitch,
  sample_rate, bitrate, audio_format, channel.
• The hardcoded voice_setting and audio_setting blocks now read from
  the new parameters. Defaults match the previous hardcoded values, so
  the change is fully backward compatible at the API level.

cli_anything/minimax/minimax_cli.py

• The tts Click command gains 7 new options:
  • --speed (FloatRange 0.5..2.0, default 1.0)
  • --vol (FloatRange 0.0..10.0, default 1.0)
  • --pitch (IntRange -12..12, default 0)
  • --sample-rate (Choice: 8000/16000/22050/24000/32000/44100, default 32000)
  • --bitrate (Choice: 32000/64000/128000/256000, default 128000)
  • --format (Choice: mp3/pcm/flac, default mp3)
  • --channel (Choice: 1/2, default 1)
• The tts_synthesize(...) call is updated to forward the new options.

cli_anything/minimax/tests/test_tts_extended.py (new)

• 4 mock-based tests:
  • test_tts_default_voice_audio_settings — guards backward-compatible defaults
  • test_tts_custom_voice_setting — speed / vol / pitch propagation
  • test_tts_custom_audio_setting — sample_rate / bitrate / format / channel
  • test_tts_voice_id_propagates — regression guard for voice + speed combo

Verification

# Apply patches (from repo root)
patch -p0 < pr-minimax-tts/01-backend.patch
patch -p0 < pr-minimax-tts/02-cli.patch
cp pr-minimax-tts/03-tests-test_tts_extended.py \
   cli_anything/minimax/tests/test_tts_extended.py

# Run the new tests
cd minimax/agent-harness
PYTHONPATH=. python3 -m pytest cli_anything/minimax/tests/test_tts_extended.py -v
# 4 passed

# Inspect the new surface
PYTHONPATH=. python3 -m cli_anything.minimax.minimax_cli tts --help

Backward compatibility

• API call signature gains keyword-only-ish params with default values
  identical to the previous hardcoded values, so any existing caller of
  tts_synthesize(api_key, text, model, voice, output_path) keeps
  working unchanged.
• CLI behavior is unchanged when none of the new options are passed.

Related

• Skill surfaces this command under cli-anything-minimax tts —
  skills/cli-anything-minimax/SKILL.md should mention the new flags
  in a follow-up doc pass.

[chatgpt-codex-connector]

Codex usage limits have been reached for code reviews. Please check with the admins of this repo to increase the limits by adding credits.
Credits must be used to enable repository wide code reviews.

[hhdhh]

Pushed a follow-up commit (9f053c7) on the same branch that documents the new tts flags in minimax/agent-harness/cli_anything/minimax/README.md (TTS options table) and skills/cli-anything-minimax/SKILL.md (TTS options block). No code change, just doc sync. Tests still 4/4 in test_tts_extended.py.

[hhdhh]

Demo: new tts options in action

Below is the help output and a sample invocation exercising every new flag
from this PR. All 4 new tests in test_tts_extended.py pass.

cli-anything-minimax tts --help

Usage: python -m cli_anything.minimax.minimax_cli tts [OPTIONS]

  Synthesize text to speech using MiniMax TTS.

Options:
  -t, --text TEXT                 Text to synthesize  [required]
  --model TEXT                    TTS model ID  [default: speech-2.8-hd]
  --voice TEXT                    Voice ID. Available: English_Graceful_Lady,
                                  English_Insightful_Speaker,
                                  English_radiant_girl,
                                  English_Persuasive_Man, English_Lucky_Robot,
                                  English_expressive_narrator  [default:
                                  English_Graceful_Lady]
  -o, --output PATH               Output audio file path  [default:
                                  output.mp3]
  --speed FLOAT RANGE             Speech speed (0.5-2.0).  [default: 1.0;
                                  0.5<=x<=2.0]
  --vol FLOAT RANGE               Volume (0.0-10.0).  [default: 1.0;
                                  0.0<=x<=10.0]
  --pitch INTEGER RANGE           Pitch shift in semitones (-12..12).
                                  [default: 0; -12<=x<=12]
  --sample-rate [8000|16000|22050|24000|32000|44100]
                                  Audio sample rate.  [default: 32000]
  --bitrate [32000|64000|128000|256000]
                                  Audio bitrate.  [default: 128000]
  --format [mp3|pcm|flac]         Output audio format.  [default: mp3]
  --channel [1|2]                 1=mono, 2=stereo.  [default: 1]
  --help                          Show this message and exit.

Invocation with all 7 new flags

$ python -m cli_anything.minimax.minimax_cli tts \
    --text "hello from cli-anything-minimax with extended tts params" \
    --voice English_radiant_girl \
    --speed 1.2 --vol 2.0 --pitch 3 \
    --sample-rate 44100 --bitrate 256000 \
    --format flac --channel 2 \
    --output /tmp/demo.flac

✓ Audio saved to /tmp/demo.flac (17 bytes)
output_file: /tmp/demo.flac
size_bytes: 17
model: speech-2.8-hd
voice: English_radiant_girl

Validation behavior (clicks-level)

--speed 5 and --vol -1 are rejected before any HTTP call:

$ ... tts --text x --speed 5
Usage: python -m cli_anything.minimax.minimax_cli tts [OPTIONS]
Try 'python -m cli_anything.minimax.minimax_cli tts --help' for help.
Error: Invalid value for '--speed': 5 is not in the range 0.5<=x<=2.0.

$ ... tts --text x --format ogg
Error: Invalid value for '--format': 'ogg' is not one of 'mp3', 'pcm', 'flac'.

Doc sync

The doc commit 9f053c7 mirrors these flags into:

• minimax/agent-harness/README.md (new tts parameter table)
• skills/cli-anything-minimax/SKILL.md (extended options block)

so the skill surface stays in lockstep with the CLI.