feat: improve agent-friendliness with flag and subcommand aliases

- search: accept --query as alias for --q
- config set: accept positional args (mmx config set region global)
- vision describe: accept --file and --path as aliases for --image
- speech: register 'speech generate' as alias for 'speech synthesize'

All original flags and commands remain unchanged.

Author: RyanLee-Dev

src/commands/config/set.ts

@@ -30,8 +30,9 @@ export default defineCommand({
     'mmx config set --key base_url --value https://api-uw.minimax.io',
   ],
   async run(config: Config, flags: GlobalFlags) {
-    const key = flags.key as string | undefined;
-    const value = flags.value as string | undefined;
+    const positional = flags._positional as string[] | undefined;
+    const key = (flags.key as string | undefined) ?? positional?.[0];
+    const value = (flags.value as string | undefined) ?? positional?.[1];
 
     if (!key || value === undefined) {
       throw new CLIError(

src/commands/search/query.ts

@@ -30,7 +30,7 @@ export default defineCommand({
     'mmx search query --q "latest news" --output json',
   ],
   async run(config: Config, flags: GlobalFlags) {
-    const query = (flags.q ?? (flags._positional as string[]|undefined)?.[0]) as string | undefined;
+    const query = (flags.q ?? flags.query ?? (flags._positional as string[]|undefined)?.[0]) as string | undefined;
 
     if (!query) {
       throw new CLIError(

src/commands/vision/describe.ts

@@ -67,7 +67,7 @@ export default defineCommand({
     'mmx vision describe --file-id file-123456789 --prompt "Extract the text"',
   ],
   async run(config: Config, flags: GlobalFlags) {
-    let image = (flags.image ?? (flags._positional as string[]|undefined)?.[0]) as string | undefined;
+    let image = (flags.image ?? flags.file ?? flags.path ?? (flags._positional as string[]|undefined)?.[0]) as string | undefined;
     let fileId = flags.fileId as string | undefined;
     const prompt = (flags.prompt as string) || 'Describe the image.';
 

src/registry.ts

@@ -269,6 +269,7 @@ export const registry = new CommandRegistry({
   'auth logout':       authLogout,
   'text chat':         textChat,
   'speech synthesize': speechSynthesize,
+  'speech generate':   speechSynthesize,
   'speech voices':     speechVoices,
   'image generate':    imageGenerate,
   'video generate':    videoGenerate,