@wji.ai/cli 0.6.0 → 0.6.1

package/dist/commands/agent.js

@@ -15,6 +15,21 @@ function skillRefLabel(ref) {
         return String(ref);
     return ref.kind === 'system' ? `system:${ref.key}` : `user:${ref.id}`;
 }
+/** Backend DEFAULT_MAX_STEPS / MAX_STEPS_LIMIT (src/ai/_/constant.ts). */
+const DEFAULT_MAX_STEPS = 40;
+const MAX_STEPS_LIMIT = 200;
+/** `--max-steps`: an integer in range, or "default" to clear back to the site default. */
+function parseMaxSteps(value) {
+    if (value === undefined)
+        return undefined;
+    if (['default', 'none', 'null'].includes(value.trim().toLowerCase()))
+        return null;
+    const n = Number(value);
+    if (!Number.isInteger(n) || n < 1 || n > MAX_STEPS_LIMIT) {
+        throw new Error(`--max-steps must be an integer from 1 to ${MAX_STEPS_LIMIT} (or "default")`);
+    }
+    return n;
+}
 export function agentCommand(globals) {
     const agent = new Command('agent').description('Manage AI agents');
     agent
@@ -59,7 +74,7 @@ export function agentCommand(globals) {
     });
     agent
         .command('get <id>')
-        .description('Show an agent (instructions included when you own it)')
+        .description('Show an agent (private agents: creator only; instructions only when you own it)')
         .action(async (id) => {
         const client = new WjiClient(globals());
         const a = await client.get(`/ai/agent/list/${id}`);
@@ -72,6 +87,7 @@ export function agentCommand(globals) {
             ['category', a.category],
             ['tags', (a.tags || []).join(', ')],
             ['greeting', a.greeting],
+            ['maxSteps', a.maxSteps ?? color.dim(`default (${DEFAULT_MAX_STEPS})`)],
             ['creator', a.creator?.name || a.creator?.id || a.creator],
             ['organization', a.organization?.id || a.organization || 'personal'],
             ['skills', (a.skills || []).map(skillRefLabel).join(', ')],
@@ -80,7 +96,7 @@ export function agentCommand(globals) {
     });
     agent
         .command('create <name>')
-        .description('Create an agent')
+        .description('Create an agent (needs the agent-create permission on your account)')
         .requiredOption('-d, --description <text>', 'short description')
         .option('-i, --instructions <text>', 'system prompt (@file / - supported)')
         .option('-m, --model <name>', 'backing model')
@@ -89,7 +105,8 @@ export function agentCommand(globals) {
         .option('-t, --tag <tag...>', 'tags')
         .option('--greeting <text>', 'opening message')
         .option('--skill <ref...>', 'attach skills: system:<key> or user:<skillId>')
-        .option('--set <key=value...>', 'arbitrary field')
+        .option('--max-steps <n>', `model calls allowed per chat turn, 1-${MAX_STEPS_LIMIT} (default ${DEFAULT_MAX_STEPS})`)
+        .option('--set <key=value...>', 'arbitrary field (admin-only fields are dropped by the server)')
         .action(async (name, opts) => {
         const client = new WjiClient(globals());
         const created = await client.post('/ai/agent/create', {
@@ -102,13 +119,14 @@ export function agentCommand(globals) {
             tags: opts.tag,
             greeting: opts.greeting,
             skills: opts.skill?.length ? opts.skill.map(parseSkillRef) : undefined,
+            maxSteps: parseMaxSteps(opts.maxSteps),
             ...parseKeyValues(opts.set),
         });
         render(created, (a) => success(`Created agent ${a.name} (${a.id})`));
     });
     agent
         .command('update <id>')
-        .description('Update an agent')
+        .description('Update an agent (creator only)')
         .option('-n, --name <name>', 'new name')
         .option('-d, --description <text>', 'new description')
         .option('-i, --instructions <text>', 'new system prompt (@file / - supported)')
@@ -117,7 +135,8 @@ export function agentCommand(globals) {
         .option('-c, --category <name>', 'category')
         .option('-t, --tag <tag...>', 'replace tags')
         .option('--greeting <text>', 'opening message')
-        .option('--set <key=value...>', 'arbitrary field')
+        .option('--max-steps <n>', `model calls allowed per chat turn, 1-${MAX_STEPS_LIMIT}; "default" clears it`)
+        .option('--set <key=value...>', 'arbitrary field (admin-only fields are dropped by the server)')
         .action(async (id, opts) => {
         const client = new WjiClient(globals());
         const updated = await client.put(`/ai/agent/list/${id}`, {
@@ -129,6 +148,7 @@ export function agentCommand(globals) {
             category: opts.category,
             tags: opts.tag,
             greeting: opts.greeting,
+            maxSteps: parseMaxSteps(opts.maxSteps),
             ...parseKeyValues(opts.set),
         });
         render(updated, () => success(`Updated ${id}`));
@@ -147,7 +167,7 @@ export function agentCommand(globals) {
     });
     agent
         .command('files <id>')
-        .description('List files attached to an agent')
+        .description('List files attached to an agent (creator only)')
         .action(async (id) => {
         const client = new WjiClient(globals());
         const files = await client.get(`/ai/agent/list/${id}/files`);
@@ -236,7 +256,7 @@ export function agentCommand(globals) {
     });
     agent
         .command('versions <id>')
-        .description('List an agent\'s version history')
+        .description('List an agent\'s version history (creator only — snapshots hold instructions)')
         .action(async (id) => {
         const client = new WjiClient(globals());
         const versions = await client.get(`/ai/agent/list/${id}/versions`);
@@ -251,7 +271,7 @@ export function agentCommand(globals) {
     });
     agent
         .command('restore <id> <versionId>')
-        .description('Restore an agent to a previous version')
+        .description('Restore an agent to a previous version (creator only)')
         .action(async (id, versionId) => {
         const client = new WjiClient(globals());
         const result = await client.post(`/ai/agent/list/${id}/versions/${versionId}/restore`);

package/dist/commands/backreel.js

@@ -7,6 +7,10 @@ const POSTS = '/backreel/post';
 const KINDS = ['showcase', 'crowdfunding'];
 const PROJECT_STATUSES = ['planning', 'pre_production', 'in_production', 'post_production', 'completed'];
 const CREDIT_KINDS = ['creative', 'crew', 'cast'];
+/** Backend LOGLINE_MAX (src/backreel/post/descriptionHtml.ts). */
+const LOGLINE_MAX = 200;
+/** BackreelVerificationKind — what `creators --role` filters on. */
+const VERIFICATION_KINDS = ['investor', 'production_company', 'brand', 'distributor', 'sales_agent'];
 /** Credit fields the create / update DTO accepts; the rest of a read-back credit is dropped. */
 const CREDIT_FIELDS = ['kind', 'name', 'role', 'user', 'photo', 'avatarUrl', 'link', 'source', 'npcId', 'order'];
 export function backreelCommand(globals) {
@@ -87,6 +91,50 @@ export function backreelCommand(globals) {
         const result = await client.delete(`${POSTS}/list/${id}`);
         render(result, () => success(`Deleted "${post.title}"`));
     });
+    br.command('creators')
+        .description('Browse Backreel creators: editor picks, then ranked by recent likes / favorites')
+        .option('-k, --keyword <text>', 'match name or @handle')
+        .option('--role <kind>', `only creators verified as: ${VERIFICATION_KINDS.join(' | ')}`)
+        .option('--verified', 'only verified creators')
+        .option('--no-featured', 'skip the editor-picked creators')
+        .option('--page <n>', 'page number', '1')
+        .option('--limit <n>', 'page size (max 48)', '20')
+        .action(async (opts) => {
+        const client = new WjiClient(globals());
+        if (opts.role)
+            oneOf(opts.role, VERIFICATION_KINDS, '--role');
+        const result = await client.get('/backreel/creator/list', {
+            keyword: opts.keyword,
+            role: opts.role,
+            verifiedOnly: opts.verified ? 'true' : undefined,
+            withFeatured: opts.featured ? undefined : 'false',
+            page: Number(opts.page),
+            limit: Number(opts.limit),
+        });
+        render(result, (r) => {
+            const columns = [
+                { header: 'id', value: (c) => c.id },
+                { header: 'name', value: (c) => truncate(c.name, 24) },
+                { header: 'handle', value: (c) => (c.handle ? `@${c.handle}` : '') },
+                { header: 'reels', value: (c) => c.reelCount },
+                { header: 'followers', value: (c) => c.followerCount },
+                { header: 'likes', value: (c) => c.likeCount },
+                { header: 'verified', value: (c) => (c.verifiedKinds || []).join(', ') },
+            ];
+            if (r?.featured?.length) {
+                info(color.bold('Featured'));
+                table(r.featured, [...columns, { header: 'note', value: (c) => truncate(c.featuredNote, 30) }]);
+                process.stdout.write('\n');
+                info(color.bold('Hot'));
+            }
+            table(r?.data || [], columns);
+            const p = r?.pagination;
+            if (p) {
+                const more = p.page * p.limit < p.total ? ` · more: --page ${p.page + 1}` : '';
+                info(color.dim(`${p.total} ranked · page ${p.page}${more}`));
+            }
+        });
+    });
     // ── credits ────────────────────────────────────────────────────────────
     const credit = br.command('credit').aliases(['credits']).description('Cast and crew of a post (max 30)');
     credit
@@ -176,6 +224,7 @@ export function backreelCommand(globals) {
 function postOptions(cmd) {
     return cmd
         .option('--kind <kind>', KINDS.join(' | '))
+        .option('--logline <text>', `one-line hook, max ${LOGLINE_MAX} chars; public even when the description is locked ("" clears it)`)
         .option('--category <category>', 'category')
         .option('--project-status <status>', PROJECT_STATUSES.join(' | '))
         .option('--tags <tags>', 'comma-separated tags (replaces the list)')
@@ -189,6 +238,13 @@ async function postBody(opts) {
     const body = { ...((await readJson(opts.body)) || {}) };
     if (opts.kind)
         body.kind = oneOf(opts.kind, KINDS, '--kind');
+    if (opts.logline !== undefined) {
+        // Same normalisation the server applies: plain text, one line.
+        const logline = String(await readValue(opts.logline)).replace(/<[^>]*>/g, '').replace(/\s+/g, ' ').trim();
+        if (logline.length > LOGLINE_MAX)
+            throw new Error(`--logline is ${logline.length} chars; the limit is ${LOGLINE_MAX}`);
+        body.logline = logline;
+    }
     if (opts.category)
         body.category = opts.category;
     if (opts.projectStatus)
@@ -225,6 +281,7 @@ async function updateCredits(client, id, fn) {
         throw new Error('A post can have at most 30 credits');
     return client.put(`${POSTS}/list/${id}`, { credits: next });
 }
+const assetLabel = (a) => (a ? a.url || a.id || a : undefined);
 function oneOf(value, allowed, flag) {
     if (!allowed.includes(value))
         throw new Error(`${flag} must be one of ${allowed.join(', ')}`);
@@ -239,8 +296,11 @@ function printPost(p) {
         ['project', p.projectStatus],
         ['category', p.category],
         ['tags', (p.tags || []).join(', ')],
+        ['logline', p.logline],
         ['description', truncate(p.descriptionText || p.description, 120)],
-        ['cover', p.cover?.url || p.cover?.id || p.cover],
+        ['cover', assetLabel(p.cover)],
+        ['coverPortrait', assetLabel(p.coverPortrait)],
+        ['trailer', p.trailer ? `${assetLabel(p.trailer)}${p.trailerDurationSec ? ` (${p.trailerDurationSec}s)` : ''}` : undefined],
         ['creator', p.creator?.name],
         ['likes', p.likeCount],
         ['updated', relativeTime(p.updatedAt)],

package/dist/commands/workspace.js

@@ -1,9 +1,10 @@
 import { Command } from 'commander';
 import { WjiClient } from '../core/client.js';
-import { updateProfile } from '../core/config.js';
+import { getProfile, updateProfile } from '../core/config.js';
 import { confirm, parseKeyValues } from '../core/prompt.js';
 import { color, detail, detailLevel, info, relativeTime, render, success, table, truncate } from '../core/output.js';
 import { loadMembers, memberLabel, resolveMember } from '../core/members.js';
+import { fetchModels } from './model.js';
 /** App tokens accepted by `--app`; mirrors WorkspaceApplication on the backend. */
 const APPS = {
     dataset: 'Dataset',
@@ -342,6 +343,56 @@ export function workspaceCommand(globals) {
             await client.delete(`/workspace/list/${wsId}/member/${m.memberId}`);
         render({ removed: targets.map((m) => m.userId) }, () => success(`Removed ${names}`));
     });
+    ws.command('leave <id>')
+        .description('Leave a workspace you were invited to (owners cannot leave)')
+        .option('-y, --yes', 'skip confirmation')
+        .action(async (id, opts) => {
+        const g = globals();
+        const client = new WjiClient(g);
+        const w = await client.get(`/workspace/list/${id}/basic`).catch(() => ({ name: id }));
+        if (!(await confirm(`Leave workspace "${w.name}" (${id})? You need a new invite to come back.`, opts.yes))) {
+            return info('Aborted');
+        }
+        const result = await client.post(`/workspace/list/${id}/leave`);
+        // A left workspace 403s from now on, so stop pointing the profile at it.
+        if (getProfile(g.profile).profile.workspace === id)
+            updateProfile(g.profile, { workspace: undefined });
+        render(result, () => success(`Left ${w.name} (${id})`));
+    });
+    // ── default models ─────────────────────────────────────────────────────────
+    ws.command('defaults [id]')
+        .description('Show or set the workspace default models (pass "none" to clear one)')
+        .option('--chat <model>', 'default chat model for new conversations')
+        .option('--image <model>', 'default image model')
+        .option('--video <model>', 'default video model')
+        .option('--storyboard <model>', 'default storyboard model')
+        .option('--audio <model>', 'default audio model')
+        .option('--image-resolution <value>', 'default image resolution, e.g. 2K')
+        .option('--video-resolution <value>', 'default video resolution, e.g. 720p')
+        .action(async (id, opts) => {
+        const client = new WjiClient(globals());
+        const wsId = client.requireWorkspace(id);
+        // settings only comes back at full detail, and PUT replaces settings whole —
+        // read it fresh so prompts / defaultApp / improvePromptDefault survive.
+        const w = await client.getFresh(`/workspace/list/${wsId}`, { detail: 'full' });
+        const current = { ...(w.settings?.defaultModels || {}) };
+        const changes = DEFAULT_MODEL_KEYS.filter((key) => opts[key] !== undefined);
+        if (!changes.length) {
+            return render(current, () => detail(DEFAULT_MODEL_KEYS.map((key) => [key, current[key] ?? color.dim('—')])));
+        }
+        const next = { ...current };
+        const needsModels = changes.some((key) => !key.endsWith('Resolution') && !isNone(opts[key]));
+        const models = needsModels ? await fetchModels(client, { workspace: wsId }) : [];
+        for (const key of changes) {
+            const raw = String(opts[key]).trim();
+            next[key] = isNone(raw) ? null : key.endsWith('Resolution') ? raw : resolveDefaultModel(models, key, raw);
+        }
+        await client.put(`/workspace/list/${wsId}`, { settings: { ...(w.settings || {}), defaultModels: next } });
+        render(next, () => {
+            success('Default models updated');
+            detail(DEFAULT_MODEL_KEYS.map((key) => [key, next[key] ?? color.dim('—')]));
+        });
+    });
     // ── quota / stats ──────────────────────────────────────────────────────────
     ws.command('quota [id]')
         .description('Show credit quota usage')
@@ -384,6 +435,28 @@ export function workspaceCommand(globals) {
     });
     return ws;
 }
+const DEFAULT_MODEL_KEYS = [
+    'chat',
+    'image',
+    'video',
+    'storyboard',
+    'audio',
+    'imageResolution',
+    'videoResolution',
+];
+const isNone = (value) => ['none', 'null', ''].includes(String(value ?? '').trim().toLowerCase());
+/**
+ * The web stores the chat default as the model `name` (what conversations carry)
+ * and the media defaults as the `nickname` its pickers emit — the value `-m` takes.
+ * Accept either spelling and store what the web would.
+ */
+function resolveDefaultModel(models, key, value) {
+    const model = models.find((m) => m.nickname === value || m.name === value);
+    if (!model) {
+        throw new Error(`Unknown model "${value}" for --${key}. See \`wji models list\`.`);
+    }
+    return key === 'chat' ? model.name : model.nickname || model.name;
+}
 export function printTree(node, prefix = '', connector = '') {
     if (!node)
         return;

package/dist/index.js

@@ -23,6 +23,12 @@ import { backreelCommand } from './commands/backreel.js';
 // Read from package.json so `wji --version` cannot drift from the published
 // version — the skill compares the two to detect a stale install.
 const VERSION = createRequire(import.meta.url)('../package.json').version;
+// `wji … | head` closes the pipe early; that is the reader being done, not a crash.
+process.stdout.on('error', (err) => {
+    if (err.code === 'EPIPE')
+        process.exit(0);
+    throw err;
+});
 const program = new Command();
 program
     .name('wji')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wji.ai/cli",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Command line interface for the WJI AI platform",
   "license": "UNLICENSED",
   "author": "WJI AI",

package/skill/wji/SKILL.md

@@ -84,6 +84,9 @@ Most commands take `--workspace`, but setting a default is less error-prone:
 ```bash
 wji ws list
 wji ws use <workspaceId>
+wji ws defaults                       # default chat / image / video / audio models
+wji ws defaults --chat <model> --video <nickname>   # "none" clears one
+wji ws leave <workspaceId>            # leave a workspace you were invited to
 ```
 
 After that, `wji ws get`, `wji fs`, `wji gen` and `wji preset list` all default
@@ -319,8 +322,12 @@ wji agent skill-add <agentId> system:image user:<skillId>
 wji agent skills <agentId>
 wji agent versions <agentId>          # every edit auto-snapshots a version
 wji agent restore <agentId> <versionId>
+wji agent update <agentId> --max-steps 80   # model calls per chat turn (default 40, max 200)
 ```
 
+Versions, files, update and restore are creator-only — a 403 `無權操作此 Agent`
+on someone else's agent is expected.
+
 Skill refs are `system:<key>` or `user:<skillId>` (a bare id means `user:`).
 System keys currently include `image`, `document`, `workspace-dataset`,
 `canvas` and `seedance-25` — confirm with `wji skill system`.
@@ -493,6 +500,8 @@ wji backreel set <postId> --project-status in_production
 wji backreel credit add <postId> --kind creative --name "Wayne" --role 導演
 wji backreel credit add <postId> --npc @mika --role "飾 阿明" --job appearance
 wji backreel publish <postId>                  # unpublish takes it offline
+wji backreel set <postId> --logline "一句話賣點"   # always public, ≤200 chars
+wji backreel creators --role investor           # browse creators
 ```
 
 - Credits (max 30) are rewritten whole in order; `credit rm` goes by number.

package/skill/wji/reference/commands.md

@@ -72,6 +72,8 @@ switch endpoint.
 | `ws update [id] [-n] [-d] [-r] [-l] [--set]` | `PUT /workspace/list/:id` |
 | `ws rm <id> [-y]` | `DELETE /workspace/list/:id` (owner only) |
 | `ws favorite <id> [--off]` | `PUT /workspace/list/:id/favorite` |
+| `ws leave <id> [-y]` | `POST /workspace/list/:id/leave` — any member except the owner; coming back needs a new invite. Clears the profile default if it pointed there |
+| `ws defaults [id] [--chat] [--image] [--video] [--storyboard] [--audio] [--image-resolution] [--video-resolution]` | no flags: shows `settings.defaultModels`. With flags: reads the workspace at `detail=full`, merges, `PUT /workspace/list/:id {settings}` (settings is replaced whole, so never send a partial `settings` via `ws update --set`). `none` clears one. Chat is stored as the model **name** (what conversations carry), media as the **nickname**; either spelling is accepted. The chat default is used for new conversations in the workspace |
 | `ws fs [id] [-a appId]` | `GET /workspace/list/:id/fs[/:appid]` |
 | `ws app list\|add <app> [-n]\|rm <appId> [-y]` | `POST/DELETE /workspace/list/:id/apps` |
 | `ws member list [id] [-r role]` | members from `GET /workspace/list/:id` (there is no member-list endpoint): name, email, role, user id, membership id |
@@ -275,16 +277,20 @@ the CLI rejects both up front.
 | --- | --- |
 | `backreel list [--all] [-k] [--page] [--limit]` | `GET /backreel/post/search/my` (`--all`: `GET /backreel/post/search`) |
 | `backreel get <postId>` | `GET /backreel/post/list/:id` |
-| `backreel create <title> [--kind showcase\|crowdfunding] [--category] [--project-status] [--tags a,b] [-d text\|@file] [--cover assetId] [--cover-portrait] [--trailer] [--body json]` | `POST /backreel/post/create` (always a draft) |
+| `backreel create <title> [--kind showcase\|crowdfunding] [--logline] [--category] [--project-status] [--tags a,b] [-d text\|@file] [--cover assetId] [--cover-portrait] [--trailer] [--body json]` | `POST /backreel/post/create` (always a draft) |
 | `backreel set <postId> [--title] [same flags]` | `PUT /backreel/post/list/:id` with only the given fields |
 | `backreel publish\|unpublish <postId>` | `POST /backreel/post/list/:id/publish\|unpublish` (publish needs a cover, media or an episode) |
 | `backreel rm <postId> [-y]` | `DELETE /backreel/post/list/:id` |
+| `backreel creators [-k] [--role kind] [--verified] [--no-featured] [--page] [--limit ≤48]` | `GET /backreel/creator/list` — editor-picked `featured` plus a heat-ranked page (recent likes, favorites ×2); creators with no recent activity are not listed. `--role`: investor, production_company, brand, distributor, sales_agent |
 | `backreel credit list <postId>` | the post's `credits[]`, numbered |
 | `backreel credit add <postId> --role [--name] [--kind cast\|crew\|creative] [--npc] [--user] [--link] [--job <type>]` | read, append, `PUT {credits}`; `--job` then appends to the NPC's `jobs` (own NPCs only, checked first) |
 | `backreel credit rm <postId> <n...> [-y]` | read, drop, `PUT {credits}` |
 
 Project status: planning, pre_production, in_production, post_production,
-completed. `-d` plain text becomes `<p>` paragraphs; HTML passes through and
+completed. `--logline` is a one-line hook (≤200 chars, HTML stripped, `""`
+clears it) shown large on the post page and **always public**, even when the
+description is gated. The post detail no longer carries playable URLs for VOD
+episodes — playback is gated per episode on the web. `-d` plain text becomes `<p>` paragraphs; HTML passes through and
 is sanitized server-side. Admin routes (`/api/backreel/*`) reject `sk_` keys.
 
 ## gen
@@ -361,7 +367,7 @@ Features: `text`, `image`, `video`, `audio`, `tts`, `web`, `thinking`,
 ## agent
 
 `agent list` (public marketplace) · `agent mine` · `agent get <id>` ·
-`agent create <name> -d [-i instructions] [-m model] [--visibility] [-c] [-t] [--greeting]` ·
+`agent create <name> -d [-i instructions] [-m model] [--visibility] [-c] [-t] [--greeting] [--max-steps n]` ·
 `agent update <id> …` · `agent rm <id> [-y]` · `agent files <id>` ·
 `agent categories [--mine]` · `agent tags [--mine]` · `agent recommend`
 
@@ -380,6 +386,17 @@ takes `--skill <ref...>`.
 Visibility: `private`, `unlist`, `public`. Instructions are only returned to
 the agent's creator.
 
+Ownership (backend since Oct 2026): a private agent is readable only by its
+creator; `update`, `rm`, `files`, `versions` and `restore` are creator-only on
+every agent (403 `無權操作此 Agent` otherwise — not a bug). `agent create`
+needs the account's agent-create permission (without it: 400 `您沒有此功能的訪問權限`). `--set` cannot change `creator` or
+`organization`, and non-admins cannot set `key`, `isSystem`, `isHighligted`,
+`recommendTitle`, `weight` or `store` — the server drops them silently.
+
+`--max-steps n` caps model calls per chat turn (1–200; parallel tool calls in
+one step count once). Unset means the site default, 40. `update --max-steps
+default` clears it.
+
 Field caps: name ≤200, model ≤100, description and greeting ≤5,000,
 instructions ≤200,000 characters.