@wavespeed/cli 0.4.3 → 0.4.4

package/README.md

@@ -195,3 +195,8 @@ Stack: TypeScript, Commander, Inquirer, Chalk, Ora, the official `wavespeed` SDK
 ## License
 
 MIT — see [LICENSE](LICENSE).
+
+---
+
+**[WaveSpeed AI](https://wavespeed.ai/)** — AI image & video generation platform.
+Try it in the browser: **[Image generator](https://wavespeed.ai/image-generator)** · **[Video generator](https://wavespeed.ai/video-generator)**

package/dist/commands/run.js

@@ -3,7 +3,7 @@ import ora from 'ora';
 import path from 'node:path';
 import fs from 'node:fs';
 import { requireClient } from '../lib/client.js';
-import { parseInputs } from '../lib/inputs.js';
+import { parseInputs, withInputSyntaxHint } from '../lib/inputs.js';
 import { resolveLocalFiles } from '../lib/local-files.js';
 import { submitPrediction, waitForPrediction } from '../lib/api.js';
 import { uploadWithCache } from '../lib/upload-cache.js';
@@ -137,7 +137,7 @@ export function registerRun(program) {
             submitted = await submitPrediction(model, input, { sync: !!opts.sync });
         }
         catch (err) {
-            const message = err.message ?? String(err);
+            const message = withInputSyntaxHint(err.message ?? String(err), opts.input);
             spinner.fail(message);
             if (isJsonMode())
                 emitJsonError(message);

package/dist/lib/inputs.js

@@ -2,8 +2,9 @@
 // - bare strings stay strings
 // - "123" / "1.5" parsed as number
 // - "true" / "false" parsed as boolean
-// - "[a,b,c]" parsed as array of strings
-// - JSON values (starting with { or [) parsed as JSON
+// - values starting with { or [ are parsed as JSON, and stay strings if that
+//   fails — so an array has to be written as valid JSON: '["a","b"]'.
+//   A bare "[a,b,c]" is not JSON and reaches the API as a string.
 // - keys with dots like "size.width" become nested
 function coerce(raw) {
     if (raw === 'true')
@@ -50,3 +51,16 @@ function setPath(obj, dotted, value) {
     }
     cur[parts[parts.length - 1]] = value;
 }
+/**
+ * The API rejects a scalar sent to an array field. The message says what is
+ * wrong but not how to write it, and `-i key=value` gives no hint that an
+ * array needs JSON — so point at the fix rather than mutating the input.
+ */
+export function withInputSyntaxHint(message, pairs = []) {
+    const field = /field "([^"]+)" must be an array/.exec(message)?.[1];
+    if (!field)
+        return message;
+    const given = pairs.find((p) => p.slice(0, p.indexOf('=')).trim() === field);
+    const sample = given ? given.slice(given.indexOf('=') + 1) : 'value';
+    return `${message}\nWrite arrays as JSON: -i '${field}=["${sample}"]'`;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wavespeed/cli",
-  "version": "0.4.3",
-  "description": "WaveSpeed CLI \u2014 one command to run any WaveSpeed AI model from your terminal.",
+  "version": "0.4.4",
+  "description": "WaveSpeed CLI — one command to run any WaveSpeed AI model from your terminal.",
   "publishConfig": {
     "access": "public"
   },