@wavespeed/cli 0.4.2 → 0.4.4

package/README.md

@@ -1,6 +1,9 @@
 <div align="center">
   <a href="https://wavespeed.ai" target="_blank">
-    <img src="https://raw.githubusercontent.com/WaveSpeedAI/waverless/main/docs/images/wavespeed-dark-logo.png" alt="WaveSpeedAI Logo" width="200"/>
+    <picture>
+      <source media="(prefers-color-scheme: dark)" srcset="assets/wavespeed-logo-dark.svg">
+      <img src="assets/wavespeed-logo-light.svg" alt="WaveSpeed" width="342" height="48"/>
+    </picture>
   </a>
 
   <h1>WaveSpeed CLI</h1>
@@ -74,14 +77,14 @@ wavespeed run ... -p "..." --json | jq '.outputs[0]'
 
 ```jsonc
 {
-  "defaultModel": "google/nano-banana-2/text-to-image",
+  "defaultModel": "bytedance/seedream-v5.0-pro",
   "outputDir": "wavespeed-output",
   "aliases": {
-    "hero":   { "model": "google/nano-banana-2/text-to-image",
+    "hero":   { "model": "bytedance/seedream-v5.0-pro",
                 "input": { "aspect_ratio": "16:9", "resolution": "2k" } },
-    "social": { "model": "google/nano-banana-2/text-to-image",
+    "social": { "model": "bytedance/seedream-v5.0-pro",
                 "input": { "aspect_ratio": "1:1",  "resolution": "1k" } },
-    "vid":    { "model": "bytedance/seedance-2.0/text-to-video",
+    "vid":    { "model": "bytedance/seedance-2.5/text-to-video",
                 "input": { "resolution": "720p", "duration": 5 } }
   }
 }
@@ -98,10 +101,12 @@ Resolution: positional with `/` is a model ID; otherwise looked up as an alias.
 
 | Use case | Model |
 |---|---|
-| Text → image | `google/nano-banana-2/text-to-image` |
-| Image edit | `google/nano-banana-2/edit` |
-| Text → video | `bytedance/seedance-2.0/text-to-video` |
-| Image → video | `bytedance/seedance-2.0/image-to-video` |
+| Text → image | `bytedance/seedream-v5.0-pro` |
+| Image edit | `bytedance/seedream-v5.0-pro/edit` |
+| Text → video | `bytedance/seedance-2.5/text-to-video` |
+| Image → video | `bytedance/seedance-2.5/image-to-video` |
+| Video edit | `bytedance/seedance-2.5/video-edit` |
+| Video extend | `bytedance/seedance-2.5/video-extend` |
 
 Browse alternatives with `wavespeed models <query>`.
 
@@ -115,6 +120,10 @@ wavespeed skill install        # writes .claude/skills/wavespeed/SKILL.md
 
 The skill teaches the agent the three-step pattern: `models` to find, `run <id> -h` to discover params, `run <id> -p "…" --json` to execute. Every command supports `--json` for clean piping.
 
+**OpenCode** loads the same file with no extra steps — `.claude/skills/` is on its skill search path.
+
+**DeepSeek Harness (dsh)**: the same skill is packaged for dsh's `.dsh/skills` layout at [WaveSpeedAI/wavespeed-dsh-skill](https://github.com/WaveSpeedAI/wavespeed-dsh-skill).
+
 ## Commands
 
 ```
@@ -186,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/cli.js

@@ -44,7 +44,7 @@ ${chalk.bold('Quick start:')}
   ${chalk.cyan('$ wavespeed models                                                # browse the catalog')}
   ${chalk.cyan('$ wavespeed run wavespeed-ai/z-image/turbo -h                    # see the model\'s flags')}
   ${chalk.cyan('$ wavespeed run wavespeed-ai/z-image/turbo -p "a cyberpunk skyline"   # ~5s')}
-  ${chalk.cyan('$ wavespeed run bytedance/seedance-2.0/text-to-video -p "drone shot over snowy peaks"')}
+  ${chalk.cyan('$ wavespeed run bytedance/seedance-2.5/text-to-video -p "drone shot over snowy peaks"')}
 
 ${chalk.bold('Use from any coding agent (Claude Code, Cursor, Codex):')}
   ${chalk.cyan('$ wavespeed skill install')}   ${chalk.gray('# drops a SKILL.md so the agent knows how to call wavespeed')}

package/dist/commands/aliases.js

@@ -23,7 +23,7 @@ export function registerAliases(program) {
             console.log(chalk.gray(JSON.stringify({
                 aliases: {
                     hero: {
-                        model: 'google/nano-banana-2/text-to-image',
+                        model: 'bytedance/seedream-v5.0-pro',
                         input: { aspect_ratio: '16:9', resolution: '2k' },
                     },
                 },

package/dist/commands/auth.js

@@ -5,6 +5,7 @@ import ora from 'ora';
 import clipboard from 'clipboardy';
 import { userConfig, getBaseUrl, getApiKey, loadProjectConfig, PROJECT_FILE } from '../lib/config.js';
 import { LINKS } from '../lib/links.js';
+import { clientAttributionHeaders } from '../lib/client-headers.js';
 const KEY_URL = 'https://wavespeed.ai/accesskey';
 function mask(key) {
     if (key.length < 12)
@@ -40,7 +41,7 @@ async function validateKey(apiKey, baseUrl) {
     let res = null;
     try {
         res = await fetch(`${baseUrl}/api/v3/balance`, {
-            headers: { Authorization: `Bearer ${apiKey}` },
+            headers: { Authorization: `Bearer ${apiKey}`, ...clientAttributionHeaders() },
         });
     }
     catch (err) {
@@ -108,7 +109,7 @@ async function loginFlow(opts) {
     console.log(chalk.bold('Try it:'));
     console.log('  ' + chalk.cyan('wavespeed models                       # browse the catalog'));
     console.log('  ' + chalk.cyan('wavespeed run wavespeed-ai/z-image/turbo -p "a cyberpunk skyline at golden hour"'));
-    console.log('  ' + chalk.cyan('wavespeed run bytedance/seedance-2.0/text-to-video -p "drone shot over snowy peaks"'));
+    console.log('  ' + chalk.cyan('wavespeed run bytedance/seedance-2.5/text-to-video -p "drone shot over snowy peaks"'));
     console.log();
 }
 export function registerAuth(program) {

package/dist/commands/init.js

@@ -3,7 +3,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { input, confirm } from '@inquirer/prompts';
 import { PROJECT_FILE } from '../lib/config.js';
-const STARTER_MODEL = 'google/nano-banana-2/text-to-image';
+const STARTER_MODEL = 'bytedance/seedream-v5.0-pro';
 export function registerInit(program) {
     program
         .command('init')

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/api.js

@@ -5,6 +5,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import os from 'node:os';
 import { getApiKey, getBaseUrl } from './config.js';
+import { clientAttributionHeaders } from './client-headers.js';
 const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
 function cachePath() {
     return path.join(os.homedir(), '.cache', 'wavespeed', 'models.json');
@@ -44,7 +45,7 @@ export async function fetchModels(opts = {}) {
     if (!apiKey)
         throw new Error('No API key configured. Run `wavespeed login`.');
     const res = await fetch(`${baseUrl}/api/v3/models`, {
-        headers: { Authorization: `Bearer ${apiKey}` },
+        headers: { Authorization: `Bearer ${apiKey}`, ...clientAttributionHeaders() },
     });
     if (!res.ok) {
         throw await httpError(res, 'GET', '/api/v3/models');
@@ -70,7 +71,7 @@ function authHeaders() {
     const apiKey = getApiKey();
     if (!apiKey)
         throw new Error('No API key configured. Run `wavespeed login`.');
-    return { Authorization: `Bearer ${apiKey}` };
+    return { Authorization: `Bearer ${apiKey}`, ...clientAttributionHeaders() };
 }
 // Non-2xx responses still carry the platform's error envelope, and for
 // permission failures that body is the whole point: it names the role that

package/dist/lib/client-headers.js

@@ -0,0 +1,40 @@
+// Channel-attribution headers (X-Client-Name / X-Client-Version / X-Client-OS)
+// for the CLI's direct REST calls, matching the convention wavespeed-desktop
+// uses. Calls that go through the `wavespeed` SDK get the same headers from
+// the SDK itself (via the clientName option in client.ts).
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import { fileURLToPath } from 'node:url';
+export const CLI_CLIENT_NAME = 'wavespeed-cli';
+// Read version from package.json at runtime so a bump in package.json is
+// reflected automatically (same approach as cli.ts).
+function cliVersion() {
+    try {
+        const here = path.dirname(fileURLToPath(import.meta.url));
+        // dist/lib/client-headers.js → ../../package.json
+        const pkgPath = path.resolve(here, '..', '..', 'package.json');
+        return JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version;
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+// Lowercase OS name: darwin / linux / windows (win32 is reported as windows).
+function operatingSystem() {
+    const platform = os.platform();
+    return platform === 'win32' ? 'windows' : platform;
+}
+// The WAVESPEED_CLIENT_NAME environment variable takes priority so wrapper
+// channels (dsh skill, Claude plugin, Gemini extension) can brand themselves
+// without code changes.
+export function resolveClientName() {
+    return process.env.WAVESPEED_CLIENT_NAME || CLI_CLIENT_NAME;
+}
+export function clientAttributionHeaders() {
+    return {
+        'X-Client-Name': resolveClientName(),
+        'X-Client-Version': cliVersion(),
+        'X-Client-OS': operatingSystem(),
+    };
+}

package/dist/lib/client.js

@@ -1,6 +1,7 @@
 import { Client } from 'wavespeed';
 import chalk from 'chalk';
 import { getApiKey, getBaseUrl } from './config.js';
+import { CLI_CLIENT_NAME } from './client-headers.js';
 export function requireClient() {
     const apiKey = getApiKey();
     if (!apiKey) {
@@ -9,11 +10,11 @@ export function requireClient() {
         console.error(chalk.gray('Or set ') + chalk.cyan('WAVESPEED_API_KEY') + chalk.gray(' in your environment.\n'));
         process.exit(1);
     }
-    return new Client(apiKey, { baseUrl: getBaseUrl() });
+    return new Client(apiKey, { baseUrl: getBaseUrl(), clientName: CLI_CLIENT_NAME });
 }
 export function maybeClient() {
     const apiKey = getApiKey();
     if (!apiKey)
         return null;
-    return new Client(apiKey, { baseUrl: getBaseUrl() });
+    return new Client(apiKey, { baseUrl: getBaseUrl(), clientName: CLI_CLIENT_NAME });
 }

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,6 +1,6 @@
 {
   "name": "@wavespeed/cli",
-  "version": "0.4.2",
+  "version": "0.4.4",
   "description": "WaveSpeed CLI — one command to run any WaveSpeed AI model from your terminal.",
   "publishConfig": {
     "access": "public"
@@ -56,7 +56,7 @@
     "conf": "^13.0.0",
     "open": "^10.1.0",
     "ora": "^8.1.0",
-    "wavespeed": "^0.2.6"
+    "wavespeed": "^0.3.0"
   },
   "devDependencies": {
     "@types/node": "^20.14.0",

package/skills/SKILL.md

@@ -11,14 +11,14 @@ You have access to the `wavespeed` CLI. Every generation flows through one verb.
 
 ```bash
 # 1. FIND a model — search the live catalog
-wavespeed models "nano banana"
+wavespeed models "seedream"
 wavespeed models --type image-to-video --popular
 
 # 2. INSPECT its inputs — dynamic schema, per model
-wavespeed run google/nano-banana-2/text-to-image -h
+wavespeed run bytedance/seedream-v5.0-pro -h
 
 # 3. RUN it — always pass --json so you can read the result
-wavespeed run google/nano-banana-2/text-to-image \
+wavespeed run bytedance/seedream-v5.0-pro \
   -p "a cyberpunk skyline at golden hour" \
   -i aspect_ratio="16:9" -i resolution="2k" --json
 ```
@@ -29,10 +29,12 @@ wavespeed run google/nano-banana-2/text-to-image \
 
 | Use case | Model |
 |---|---|
-| Text → image | `google/nano-banana-2/text-to-image` |
-| Image edit (instruction-driven) | `google/nano-banana-2/edit` — requires `images: [url, ...]` |
-| Text → video | `bytedance/seedance-2.0/text-to-video` |
-| Image → video | `bytedance/seedance-2.0/image-to-video` — requires `image: url` |
+| Text → image | `bytedance/seedream-v5.0-pro` |
+| Image edit (instruction-driven) | `bytedance/seedream-v5.0-pro/edit` — requires `images: [url, ...]` |
+| Text → video | `bytedance/seedance-2.5/text-to-video` |
+| Image → video | `bytedance/seedance-2.5/image-to-video` — requires `image: url` |
+| Video edit (instruction-driven) | `bytedance/seedance-2.5/video-edit` — requires `video: url` |
+| Video extend | `bytedance/seedance-2.5/video-extend` — requires `video: url` |
 
 These are good starting points. Browse alternatives with `wavespeed models <query>`.
 
@@ -40,12 +42,12 @@ These are good starting points. Browse alternatives with `wavespeed models <quer
 
 ```bash
 # Edit an existing image — @path uploads the file and passes its URL (one step)
-wavespeed run google/nano-banana-2/edit \
+wavespeed run bytedance/seedream-v5.0-pro/edit \
   -p "replace the background with a sunlit kitchen" \
   -i images='["@./input.jpg"]' --json
 
 # Image-to-video — same @ marker for single-URL fields
-wavespeed run bytedance/seedance-2.0/image-to-video \
+wavespeed run bytedance/seedance-2.5/image-to-video \
   -p "subtle parallax, gentle wind" \
   -i image=@./hero.jpg -i duration=5 --json