@wji.ai/cli 0.5.1 → 0.6.1

package/README.md

@@ -117,8 +117,12 @@ Run `wji <group> --help` for the full option list.
 
 ## Conventions
 
-- **`--json`** on any command prints the raw API response and nothing else, so
-  everything composes with `jq`.
+- **`--json`** on any command prints JSON and nothing else, so everything
+  composes with `jq`. List and get commands print the **`standard`** level by
+  default (ids, names, status, media urls, long text clipped to 200 chars,
+  `content` summarised with `truncated: true`). Add **`--detail full`** (or set
+  `WJI_DETAIL=full`) for the raw API response, `--detail brief` for id lists.
+  Human table output is never affected.
 - **`@file` and `-`** work anywhere a long text or JSON value is expected:
   `-p @prompt.txt`, `--content @node.json`, `-p -` to read stdin.
 - **`--set key=value`** sends arbitrary fields; dotted keys nest
@@ -244,6 +248,7 @@ Skill refs are `system:<key>` or `user:<skillId>` (a bare id is treated as `user
 | Generation submissions | image 30 / video 10 / audio 20 per minute, per user or key |
 | Generation queue | queued + running jobs: FREE 3 / VIP 10 / SVIP 25 → HTTP 429 |
 | Pagination | `--limit` ≤100; `-1` returns at most 500 except on opt-in endpoints |
+| Detail levels | `?detail=brief\|standard\|full` on workspace, fsnode, model and history reads; the API defaults to `full`, the CLI's `--json` to `standard` |
 | Batches | `asset status` is sent 100 ids at a time; `asset summary` ≤100 ids |
 | Skills | zip ≤5MB, ≤200 files, ≤2MB per `.md`, ≤20MB total, 50 per account |
 | Creation caps | 50 workspaces, 3 organizations per account |

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

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { WjiClient } from '../core/client.js';
 import { confirm, parseKeyValues, readValue } from '../core/prompt.js';
-import { color, detail, info, isJsonMode, printJson, relativeTime, render, success, table, truncate, warn } from '../core/output.js';
+import { clipText, color, detail, detailLevel, info, isJsonMode, printJson, relativeTime, render, success, table, truncate, warn } from '../core/output.js';
 import { pollHistory, reportHistory, resolveAssets } from './gen.js';
 import { loadMembers, memberLabel, resolveMember } from '../core/members.js';
 import { fetchModels } from './model.js';
@@ -315,6 +315,53 @@ export function describe(canvas, node) {
         outgoing: canvas.edges.filter((e) => e.fromNodeId === node.id).map((e) => e.toNodeId),
     };
 }
+/**
+ * The canvas commands always load the full canvas (edits and generation need
+ * every field), so --detail is applied here, to the JSON they print. Mirrors
+ * the backend's canvas_list_nodes levels.
+ */
+export function trimDescribed(row, level = detailLevel()) {
+    if (!level || level === 'full')
+        return row;
+    if (level === 'brief') {
+        return compactRow({
+            id: row.id,
+            kind: row.kind,
+            name: row.name,
+            tag: row.tag,
+            mode: row.mode,
+            status: row.status,
+            assetId: row.assetId,
+            position: row.position,
+            references: row.references.map((r) => ({ nodeId: r.nodeId, label: r.label })),
+            outgoing: row.outgoing,
+        });
+    }
+    const g = row.generate;
+    return compactRow({
+        ...row,
+        text: row.text === undefined ? undefined : clipText(row.text) ?? '',
+        error: typeof row.error === 'string' ? clipText(row.error) : row.error,
+        generate: g
+            ? compactRow({
+                prompt: clipText(g.prompt),
+                model: g.model,
+                ratio: g.ratio,
+                resolution: g.resolution,
+                duration: g.duration,
+                historyId: g.historyId,
+                pendingAssetId: g.pendingAssetId,
+            })
+            : undefined,
+    });
+}
+function compactRow(value) {
+    const out = {};
+    for (const key of Object.keys(value))
+        if (value[key] !== undefined)
+            out[key] = value[key];
+    return out;
+}
 // ── models ──────────────────────────────────────────────────────────────────
 /** An audio node is fed by either an `audio` or a `tts` model — the backend tags voice models `tts`. */
 const KIND_FEATURES = { audio: ['audio', 'tts'] };
@@ -1022,7 +1069,7 @@ export function canvasCommand(globals) {
                 .filter((id) => loaded.byId.has(id))
                 .map((id) => describe(loaded, loaded.byId.get(id)));
         }
-        const out = { ...res, state: { ...state, canvasName }, selected };
+        const out = { ...res, state: { ...state, canvasName }, selected: selected.map((n) => trimDescribed(n)) };
         render(out, () => {
             const seconds = Math.max(0, Math.round((new Date(state.expiresAt).getTime() - Date.now()) / 1000));
             detail([
@@ -1249,7 +1296,7 @@ export function canvasCommand(globals) {
             .filter((n) => !nameRe || nameRe.test(n.name))
             .map((n) => describe(cv, n))
             .filter((n) => (colors ? !!n.tag && colors.has(n.tag.color) : opts.untagged ? !n.tag : true));
-        render({ canvas: { id: cv.id, name: cv.name, workspaceId: cv.workspaceId }, nodes: rows }, () => {
+        render({ canvas: { id: cv.id, name: cv.name, workspaceId: cv.workspaceId }, nodes: rows.map((n) => trimDescribed(n)) }, () => {
             info(color.dim(`${cv.name} (${cv.id}) · ${rows.length} node(s) · ${cv.edges.length} edge(s)`));
             nodeTable(rows);
         });
@@ -1283,13 +1330,13 @@ export function canvasCommand(globals) {
     });
     canvas
         .command('get <nodeId>')
-        .description('One node in full, with its references')
+        .description('One node with its references (--detail full for the whole generate / text)')
         .option('-c, --canvas <id>', 'canvas id (defaults to the linked canvas)')
         .action(async (id, opts) => {
         const c = client();
         const cv = await loadCanvas(c, await resolveCanvasId(c, opts.canvas));
         const n = describe(cv, requireNode(cv, id));
-        render(n, () => printNode(n));
+        render(trimDescribed(n), () => printNode(n));
     });
     canvas
         .command('edges')

package/dist/commands/fsnode.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { WjiClient } from '../core/client.js';
 import { confirm, parseKeyValues, readJson, readValue } from '../core/prompt.js';
-import { color, detail, info, relativeTime, render, success, table, truncate } from '../core/output.js';
+import { color, detail, detailLevel, info, relativeTime, render, success, table, truncate } from '../core/output.js';
 import { printTree } from './workspace.js';
 /** Nested plain objects merge; arrays and scalars are replaced. */
 function deepMerge(base, patch) {
@@ -22,7 +22,10 @@ export function fsCommand(globals) {
         .action(async (key, opts) => {
         const client = new WjiClient(globals());
         const path = key ? `/fsnode/root/${key}` : '/fsnode/root';
-        const node = await client.get(path, opts.depth ? { depth: Number(opts.depth) } : undefined);
+        const node = await client.get(path, {
+            depth: opts.depth ? Number(opts.depth) : undefined,
+            detail: detailLevel(),
+        });
         render(node, (n) => (opts.depth ? printTree(n) : printNode(n)));
     });
     fs.command('ls <id>')
@@ -34,6 +37,7 @@ export function fsCommand(globals) {
         const result = await client.get(`/fsnode/list/${id}/children`, {
             limit: opts.limit ? Number(opts.limit) : undefined,
             scope: opts.scope,
+            detail: detailLevel(),
         });
         const rows = Array.isArray(result) ? result : result?.data || [];
         render(result, () => table(rows, [
@@ -50,15 +54,18 @@ export function fsCommand(globals) {
         .option('-d, --depth <n>', 'levels to expand')
         .action(async (id, opts) => {
         const client = new WjiClient(globals());
-        const node = await client.get(`/fsnode/list/${id}/tree`, opts.depth ? { depth: Number(opts.depth) } : undefined);
+        const node = await client.get(`/fsnode/list/${id}/tree`, {
+            depth: opts.depth ? Number(opts.depth) : undefined,
+            detail: detailLevel(),
+        });
         render(node, (n) => printTree(n));
     });
     fs.command('get <id>')
-        .description('Show one node (comma-separate ids for a batch)')
+        .description('Show one node (comma-separate ids for a batch; --detail full for the whole content)')
         .option('--scope <scope>', 'server-side scope filter')
         .action(async (id, opts) => {
         const client = new WjiClient(globals());
-        const node = await client.get(`/fsnode/list/${id}`, { scope: opts.scope });
+        const node = await client.get(`/fsnode/list/${id}`, { scope: opts.scope, detail: detailLevel() });
         render(node, (n) => (Array.isArray(n) ? n.forEach(printNode) : printNode(n)));
     });
     fs.command('path <id>')
@@ -232,7 +239,7 @@ export function datasetCommand(globals) {
         .description('List dataset nodes in a folder')
         .action(async (folderId) => {
         const client = new WjiClient(globals());
-        const result = await client.get(`/fsnode/list/${folderId}/children`);
+        const result = await client.get(`/fsnode/list/${folderId}/children`, { detail: detailLevel() });
         const rows = (Array.isArray(result) ? result : result?.data || []).filter((n) => n.mimetype === 'workspace/dataset' || n.type === 'file');
         render(rows, () => table(rows, [
             { header: 'id', value: (n) => n.id },

package/dist/commands/gen.js

@@ -1,7 +1,7 @@
 import { Command } from 'commander';
 import { WjiClient } from '../core/client.js';
 import { confirm, parseKeyValues, readJson, readValue } from '../core/prompt.js';
-import { color, detail, info, isJsonMode, printJson, render, success, table, truncate, warn } from '../core/output.js';
+import { color, detail, detailLevel, info, isJsonMode, printJson, render, success, table, truncate, warn } from '../core/output.js';
 const READY = 1;
 const CANCELLED = -1;
 /** `--ref abc123`, `--ref abc123:hero`, `--ref abc123:hero:0.6` */
@@ -254,6 +254,7 @@ export function historyCommand(globals) {
             bookmarked: opts.bookmarked ? true : undefined,
             page: Number(opts.page),
             limit: Number(opts.limit),
+            detail: detailLevel(),
         });
         render(result, (r) => {
             table(r.data || [], [
@@ -284,7 +285,7 @@ export function historyCommand(globals) {
             }));
         }
         else {
-            history = await client.get(`/ai/assets/history/list/${id}`);
+            history = await client.get(`/ai/assets/history/list/${id}`, { detail: detailLevel() });
             assets = await resolveAssets(client, history);
         }
         render({ ...history, images: assets }, () => reportHistory(history, assets));

package/dist/commands/model.js

@@ -1,6 +1,6 @@
 import { Command } from 'commander';
 import { WjiClient } from '../core/client.js';
-import { color, detail, info, render, table, truncate, warn } from '../core/output.js';
+import { color, detail, detailLevel, info, render, table, truncate, warn } from '../core/output.js';
 const FEATURES = [
     'text',
     'image',
@@ -24,6 +24,7 @@ export async function fetchModels(client, opts) {
     const features = opts.features?.length ? opts.features : FEATURES;
     const list = await client.get(`/ai/model/list/${features.join(',')}`, {
         workspaceId: client.workspace(opts.workspace),
+        detail: opts.detail,
     });
     return Array.isArray(list) ? list : list?.data || [];
 }
@@ -41,6 +42,7 @@ export function modelCommand(globals) {
         let rows = await fetchModels(client, {
             features: opts.feature,
             workspace: opts.workspace,
+            detail: detailLevel(),
         });
         if (!opts.all)
             rows = rows.filter((m) => m.enabled !== false && !m.hidden);
@@ -70,7 +72,7 @@ export function modelCommand(globals) {
         .option('-w, --workspace <id>', 'resolve pricing/access for a workspace')
         .action(async (name, opts) => {
         const client = new WjiClient(globals());
-        const rows = await fetchModels(client, { workspace: opts.workspace });
+        const rows = await fetchModels(client, { workspace: opts.workspace, detail: detailLevel() });
         // `name` is not unique across providers; `nickname` is, so prefer it.
         const matches = rows.filter((m) => m.nickname === name || m.name === name);
         if (!matches.length)

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, info, relativeTime, render, success, table, truncate } from '../core/output.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',
@@ -54,6 +55,7 @@ export function workspaceCommand(globals) {
             scope: opts.scope,
             page: Number(opts.page),
             limit: Number(opts.limit),
+            detail: detailLevel(),
         });
         const current = client.workspace();
         render(result, (r) => {
@@ -77,7 +79,9 @@ export function workspaceCommand(globals) {
         .description('Show a workspace (defaults to the selected one)')
         .action(async (id) => {
         const client = new WjiClient(globals());
-        const w = await client.get(`/workspace/list/${client.requireWorkspace(id)}`);
+        const w = await client.get(`/workspace/list/${client.requireWorkspace(id)}`, {
+            detail: detailLevel(),
+        });
         render(w, () => detail([
             ['id', w.id],
             ['name', w.name],
@@ -173,7 +177,7 @@ export function workspaceCommand(globals) {
         const path = opts.app
             ? `/workspace/list/${wsId}/fs/${opts.app}`
             : `/workspace/list/${wsId}/fs`;
-        const root = await client.get(path);
+        const root = await client.get(path, { detail: detailLevel() });
         render(root, (node) => printTree(node));
     });
     // ── apps ───────────────────────────────────────────────────────────────────
@@ -339,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')
@@ -381,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/core/output.js

@@ -17,6 +17,35 @@ export function setJsonMode(on) {
 export function isJsonMode() {
     return jsonMode;
 }
+const DETAIL_LEVELS = ['brief', 'standard', 'full'];
+/**
+ * Global --detail (or WJI_DETAIL). Unset means "standard when printing JSON,
+ * nothing (server default = full) for human output", so tables are unchanged.
+ */
+let detailMode;
+export function setDetailMode(raw) {
+    if (raw === undefined || raw === '') {
+        detailMode = undefined;
+        return;
+    }
+    const level = String(raw).toLowerCase();
+    if (!DETAIL_LEVELS.includes(level)) {
+        throw new Error(`--detail must be one of ${DETAIL_LEVELS.join(', ')} (got "${raw}")`);
+    }
+    detailMode = level;
+}
+export function detailLevel() {
+    if (detailMode)
+        return detailMode;
+    return jsonMode ? 'standard' : undefined;
+}
+/** Clip long text the way the server does at `standard` (200 chars + …). */
+export function clipText(value, max = 200) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const s = String(value);
+    return s.length <= max ? s : `${s.slice(0, max)}…`;
+}
 export function printJson(value) {
     process.stdout.write(JSON.stringify(value, null, 2) + '\n');
 }

package/dist/index.js

@@ -2,7 +2,7 @@
 import { createRequire } from 'node:module';
 import { Command } from 'commander';
 import { ApiError } from './core/client.js';
-import { color, setJsonMode } from './core/output.js';
+import { color, setDetailMode, setJsonMode } from './core/output.js';
 import { authCommand } from './commands/auth.js';
 import { configCommand } from './commands/config.js';
 import { orgCommand } from './commands/org.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')
@@ -34,7 +40,8 @@ program
     .option('--org <orgId>', 'organization context (X-Org-Id)')
     .option('--no-org', 'force personal context')
     .option('--locale <locale>', 'response language (cht, chs, en)')
-    .option('--json', 'print raw JSON instead of tables')
+    .option('--json', 'print JSON instead of tables (standard detail unless --detail is given)')
+    .option('--detail <level>', 'how much to return: brief | standard | full (default standard for --json; env WJI_DETAIL)')
     .configureHelp({ sortSubcommands: true });
 /**
  * Global flags live on the root command, but subcommand actions run before
@@ -51,10 +58,12 @@ const globals = () => {
         // commander turns `--no-org` into org === false
         personal: opts.org === false,
         locale: opts.locale,
+        detail: opts.detail,
     };
 };
 program.hook('preAction', () => {
     setJsonMode(!!program.opts().json);
+    setDetailMode(program.opts().detail ?? process.env.WJI_DETAIL);
 });
 program.addCommand(authCommand(globals));
 program.addCommand(configCommand(globals));

package/package.json

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

package/skill/ads/reference/models.md

@@ -24,6 +24,9 @@ strengths, not platform guarantees.
 | `marketing-studio-image` | auto · 1:1 · 3:2 · 2:3 · 4:3 · 3:4 · 16:9 · 9:16 · 21:9 | 1k · 2k · 4k | 8 | fair | tuned for a commercial "marketing" look; cheapest 4K |
 | `runninghub-midjourney-v7` | 1:1 · 4:3 · 3:2 · 16:9 · 3:4 · 2:3 · 9:16 | fixed; quality 1 / 2 / 4 | 5 image + 5 omni + 5 style, weighted | weak; do not rely on it for labels | mood boards, style frames; negative prompt |
 | `runninghub-midjourney-v8.1` / `v8.2` | same 7 | native 2K | 8.1: 5; 8.2: 2 (first = image ref, second = style ref) | weak | style exploration only; never the packshot |
+| `z-image-uncensored` / `z-image-pro-uncensored` | 1:1 · 2:3 · 3:2 · 3:4 · 4:3 · 9:16 · 16:9 | long edge ≤ 1536 (pro ≤ 2560) | none | fair | uncensored (無審核); only when the brief needs it |
+| `qwen-image-edit-uncensored` | follows the first reference | follows the first reference | 1–3 (first = image to edit) | fair | uncensored instruction edit |
+| `face-swap-uncensored` / `head-swap-uncensored` | follows the target | follows the target | exactly 2: target, then face / head | — | uncensored; swap a talent's face / head onto a shot |
 
 Bold ratios are the only sources of 4:5 and 2:3 on the platform. No image model outputs 1.91:1,
 6:7 or any banner strip.
@@ -40,6 +43,8 @@ Bold ratios are the only sources of 4:5 and 2:3 on the platform. No image model
 | `seedance-2.0` family | same six | 4–15 s, or auto | 480p · 720p · 1080p · 4k | ref variants: images + video + audio | `generate_audio` | the 4K option of the family |
 | `wan-3.0` / `-prime` | 16:9 · 4:3 · 1:1 · 3:4 · 9:16 | 2–30 s, or `autoDuration` | 480P · 720P · 1080P | first / last frame | `audio` on by default | optional "AI Generated" watermark; seed for repeatability |
 | `wan-3.0-ref` / `-prime-ref` | same five | 2–30 s, or auto | as above | 10 images + 5 videos + 5 audios (≤ 15 s total) | `audio` | |
+| `wan-3.0-*-uncensored` (+ `-pro`, `-prime`, `-prime-pro`; each with a `-ref-` twin) | adaptive + the five | 2–30 s, or auto | 480p–1080p; pro: 1080p · 2k · 4k | as `wan-3.0` / `wan-3.0-ref` | `audio` | uncensored (無審核); Ref twins billed on input video + output seconds |
+| `wan-2.7-i2v-uncensored` / `wan-2.2-i2v-uncensored` | follows the input image | 2.7: 2–15 s; 2.2: 5 or 8 s | 2.7: 720p · 1080p; 2.2: 480p · 720p | first frame (2.2 also last frame); 2.7: 1 driving audio | 2.7 `audio` | uncensored; 2.2 is the cheapest video here |
 | `veo-3.1` / `-fast` | 16:9 · 9:16 · auto | 4–8 s | 720p · 1080p · 4k | first / last frame | `generate_audio` | negative prompt available |
 | `veo-3.1-ref` | 16:9 · 9:16 | 8 s fixed | 720p · 1080p · 4k | 1–10 images | `generate_audio` | |
 | `kling-3` / `-pro` | 16:9 · 9:16 · 1:1 | 3–15 s | model default | 7 images, plus first / last frame | `generate_audio` (off by default) | pro = higher quality |

package/skill/short-drama/reference/canvas-recipes.md

@@ -4,6 +4,24 @@
 which row, and in what order the references are connected. Read them as written and substitute the
 tool calls from `operations-wji.md`; `--from A B C` is `fromNodeIds: ['A','B','C']` and the array
 order is the reference order. Everything about rows, `@imageN` order and prompts is identical.
+Build each row with **one `canvas_create_nodes` call**: its `nodes` array takes the fields of
+`canvas_create_node` (minus `canvas`), and `"$i"` in `fromNodeIds` or `nextTo` means item i of the
+same batch (0-based, must come earlier), so a headshot → sheet → voice chain is one call and a
+`characters` canvas of twelve characters is one or two calls instead of fifty. Items are created in
+order; if one fails the result says `failedAt` and the earlier nodes stay on the canvas — fix that
+item and resend from it with real ids (up to 60 nodes a call).
+
+```
+canvas_create_nodes { canvas: CV, nodes: [
+  { kind: "title", text: "C01 林小夏", position: {x: 0, y: 0} },                                        # $0
+  { kind: "image", name: "C01 headshot", position: {x: 400, y: 0},
+    generate: { model: "<image model>", ratio: "1:1", prompt: "<portrait prompt>" } },               # $1
+  { kind: "image", name: "C01 sheet", fromNodeIds: ["$1"],
+    generate: { model: "<image model>", ratio: "16:9", prompt: "@image1 is the face to match … " } }, # $2
+  { kind: "audio", name: "C01 voice", fromNodeIds: ["$1"],
+    generate: { model: "seed-audio-1.0", prompt: <voice prompt> } }                                  # $3
+] }                                                                   → created[0..3].id = T1 H1 S1 V1
+```
 
 Command sequences for the three canvas types. All ids are placeholders — take real ones from the
 command output (`wji --json canvas add … | jq -r .id`) and `bind` them at once. `SD` below is

package/skill/short-drama/reference/operations-cli.md

@@ -36,6 +36,7 @@ The `wji` skill governs auth, confirmations and spending. The calls this skill m
 | preflight | `wji auth whoami --json`, `wji profile wallet` |
 | workspace | `wji ws create "<title>" -r <ratio>` → `wji ws use <id>` |
 | datasets | `wji dataset new … --app <appId>`, `wji fs set <id> --merge` (never `--content`), `--add-images` (never `--images` on an existing node) |
+| reads | `wji fs get <id> --json` is the `standard` summary; `--detail full` whenever you need the whole `content` (`--merge` reads full for you) |
 | canvases | `wji canvas create <name>` · `wji canvas add <kind> -c <cv> …` · `wji canvas connect <a> <b>` · `wji canvas get <node>` · `wji canvas gen <node> [--yes --wait]` · `wji canvas rm` |
 | assets | `wji asset download <id> -o <dir>` — **look at what you generated** before building on it |
 | history | `wji history get <id> --wait` |

package/skill/short-drama/reference/operations-wji.md

@@ -43,9 +43,9 @@ write a whole document at a time rather than field by field.
 
 | Purpose | Tool |
 | --- | --- |
-| workspace | `workspace_search`, `workspace_get`, `workspace_create`, `workspace_add_app` |
+| workspace | `workspace_get { id }` for the workspace the chat is in, `workspace_create`, `workspace_add_app`; `workspace_search` **only with `limit`** (≤ 10) and a `keyword` — without them it returns every workspace the user can see. Both default to `detail: 'standard'`; `detail: 'full'` only when you need `settings` |
 | semantic folders | `resolve_dataset_folder { id, key: 'story' \| 'character' \| 'location' \| 'prop' \| 'shot' }` |
-| datasets | `fsnode_create_file { parent, name, dataset: true, datasetType, description, content, tags }`, `fsnode_update`, `fsnode_upsert_segment` |
+| datasets | `fsnode_create_file { parent, name, dataset: true, datasetType, description, content, tags }`, `fsnode_update`, `fsnode_upsert_segment`; `fsnode_get { id, detail: 'full' }` before replacing a `content` (the default `standard` read is a summary with `truncated: true`, and writing it back is rejected) |
 | assets | `asset_get`, `asset_check_status`, `asset_create_from_url` |
 | canvases | the `canvas_*` tools below |
 
@@ -59,16 +59,21 @@ substitute:
 | `canvas-recipes.md` shows | call |
 | --- | --- |
 | `wji canvas create <name>` | `canvas_create { workspace, name }` → canvas id |
-| `wji canvas add <kind> -c CV -n "<name>" --at x,y …` | `canvas_create_node { canvas, kind, name, position: {x, y}, … }` |
+| `wji canvas add <kind> -c CV -n "<name>" --at x,y …` | `canvas_create_node { canvas, kind, name, position: {x, y}, … }` — one node |
+| a whole row of `wji canvas add …` lines | `canvas_create_nodes { canvas, nodes: [ … ] }` — up to 60 nodes in one call, each item the fields of `canvas_create_node` without `canvas`; `"$i"` in `fromNodeIds` / `nextTo` is item i of the same batch (0-based, must come earlier). Built in order; on a failure the result has `failedAt` and the earlier nodes stay |
 | `--prompt-file /tmp/x.txt` / `-p "<prompt>"` | `generate: { prompt, model, ratio, resolution, duration }` on `canvas_create_node` |
 | `--asset <id>` (a display node) | `assetId` on `canvas_create_node` |
 | `--from A B C` | `fromNodeIds: ['A','B','C']` — **the array order is the reference order** |
 | `wji canvas connect <a> <b>` | `canvas_connect_nodes { canvas, fromId, toId }` |
-| `wji canvas get <node>` | `canvas_get_node { canvas, id }` — references, label, status, asset |
+| `wji canvas get <node>` | `canvas_get_node { canvas, id }` — references, label, status, asset; `detail: 'full'` for the whole `generate` / `text` before editing them |
 | `wji canvas gen <node>` (cost preview) | `canvas_generate { canvas, nodeIds, estimateOnly: true }` |
 | `wji canvas gen <node> --yes --wait` | `canvas_generate { canvas, nodeIds, wait: true }` |
 | `wji canvas rm` | `canvas_delete_nodes { canvas, ids }` |
 
+Build each row with **one** `canvas_create_nodes` call (title, headshot, sheet `fromNodeIds: ["$1"]`,
+voice `fromNodeIds: ["$1"]`), not four `canvas_create_node` calls — see the batch example at the top
+of `canvas-recipes.md`.
+
 Reference labels (`@image1`, `@audio1` …) are numbered per type in connection order, exactly as the
 canvas UI numbers them. After connecting, call `canvas_get_node` and check the labels match what the
 prompt names **before** generating — a mislabelled reference is a wasted generation.
@@ -77,6 +82,24 @@ prompt names **before** generating — a mislabelled reference is a wasted gener
 first, tell the user the cost, and only generate for real once they say yes. The `wji` skill's
 spending policy applies here in full.
 
+## Steps and context
+
+**A turn is capped at 40 steps, not 40 tool calls** (an Agent can set its own cap). One step is one
+model call; every tool call you emit in the same step runs together and counts once. So emit
+independent calls together — all the `short_drama_render` / `fsnode_create_file` of a stage in one
+step, the five `resolve_dataset_folder` calls in one step — and write a whole document per
+`short_drama_put` rather than field by field. When two steps are left you get a system note: stop
+calling tools, report what was written (with ids) and what is still open; the stream ends at the cap
+without letting you reply.
+
+**Tool results stay in the context for the rest of the turn.** Read what you need, once: `ai_list_models`
+once per project with `features: 'image'` (it is large); `fsnode_get` on the one dataset you need
+instead of `fsnode_children` on a folder of them; `short_drama_get { section }` for one branch rather
+than the whole project; never `workspace_search` without `limit`. Every list / get tool takes
+`detail: 'brief' | 'standard' | 'full'` and defaults to `standard` (text clipped to 200 chars, media
+as `{ id, url, status }`, `content` summarised); ask for `brief` when you only need ids and for `full`
+only when you need the complete `content` / `form` / `settings`.
+
 **In a canvas chat** (the chat panel beside an open canvas) the browser supplies its own `canvas_*`
 tools, which always act on the canvas the user is looking at and take no `canvas` argument. A short
 drama needs several canvases, so do that work in a workspace chat; in a canvas chat, say so.

package/skill/short-drama/reference/stage-storyboard.md

@@ -345,6 +345,12 @@ segment is rejected, retry, then trim — do not go hunting for a forbidden word
 To bisect anyway, use a scratch video node at `-d 2`, 480P: free when rejected, ~30 credits when it
 passes, and sample each fragment several times because one pass proves nothing.
 
+**Last resort: the uncensored twin.** `wan-3.0-ref-uncensored` (MuleRouter, no green-net) takes the
+same prompt and the same 10 images + 5 videos + 5 audios, at ~1.3× the price; note that it bills the
+reference-video seconds as well as the output. Switch a stuck segment to it only with the
+Producer's approval, and only after retry-then-trim has failed. `short-drama.mjs` does not know it
+as a mode, so set it as the node's model directly.
+
 ## Sheets mode — no storyboard images (the default)
 
 `params.references: sheets` drops stage 5's image generation entirely: the video node references

package/skill/wji/SKILL.md

@@ -9,6 +9,12 @@ description: Drive the WJI AI platform from the terminal with the `wji` CLI —
 `--json`, so prefer `--json` piped through `jq` when you need to read a value,
 and the human table output when you are showing the user a result.
 
+`--json` prints the **`standard`** detail level: ids, names, status, media urls,
+long text clipped to 200 chars and `content` reduced to a summary marked
+`truncated: true`. Add `--detail full` whenever you need the whole `content`,
+`form` or `settings` (always before a read-modify-write), and `--detail brief`
+when you only want ids. `WJI_DETAIL=full` sets it for a whole session.
+
 ## Before anything else
 
 ```bash
@@ -78,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
@@ -94,7 +103,7 @@ wji ws fs                                  # whole workspace tree
 wji ws fs --app <appId>                    # one app's tree
 wji fs tree <nodeId> --depth 2
 wji fs ls <folderId>
-wji fs get <nodeId> --json | jq .content
+wji fs get <nodeId> --json --detail full | jq .content      # --detail full: the summary is not the content
 
 wji fs mkdir <parentId> characters --nickname 角色
 wji dataset new <folderId> "Ada" -t character -d "a tired detective"
@@ -211,6 +220,25 @@ balanced default; **Seedance 2.0 Fast / MiniMax H3 Max** for drafts, tests and
 large batches. The ranking is a guide — quote the real number from
 `wji gen cost` / `wji canvas gen` before spending.
 
+**Uncensored (無審核) models.** Use these only when the user asks for
+uncensored output or a censored model refused the content. They carry the
+`uncensored` tag in `wji models list --json`, and their names end in
+`-uncensored`. The Wan 3.0 family has a Ref and a first/last-frame variant of
+each tier, like the censored Wan 3.0.
+
+| Job | Model (`name`) | Inputs |
+| --- | --- | --- |
+| Video, Ref | `wan-3.0-ref-uncensored`, `wan-3.0-prime-ref-uncensored` (480p–1080p); `wan-3.0-pro-ref-uncensored`, `wan-3.0-prime-pro-ref-uncensored` (1080p / 2k / 4k) | ≤ 10 images + ≤ 5 videos + ≤ 5 audios, freely mixed (video/audio ≤ 15 s total) |
+| Video, first/last frame | `wan-3.0-uncensored`, `wan-3.0-prime-uncensored`, `wan-3.0-pro-uncensored`, `wan-3.0-prime-pro-uncensored` | text only, or start and/or end image; 2–30 s |
+| Image → video | `wan-2.7-i2v-uncensored` (720p/1080p, 2–15 s; optional 1 driving audio for lip-sync via `--ref-audio`), `wan-2.2-i2v-uncensored` (cheapest; 480p/720p, 5 or 8 s, optional end frame) | start image |
+| Animate a character | `wan-animate-uncensored` (`--set mode=animate\|replace`) | exactly 1 image + 1 video; output is as long as the video |
+| Text → image | `z-image-uncensored` (long edge ≤ 1536), `z-image-pro-uncensored` (≤ 2560, `--set long_edge=`) | prompt + ratio |
+| Edit an image | `qwen-image-edit-uncensored` | 1–3 images: the **first** is the image to edit |
+| Face / head swap | `face-swap-uncensored`, `head-swap-uncensored` | exactly 2 images, **order matters**: 1st = target picture, 2nd = the face / head to put on it |
+| Video upscale | `flashvsr-uncensored` (`--set resolution=720p\|1080p\|2k\|4k`) | 1 MP4 ≤ 120 s; billed per input second |
+
+"Prime" variants are faster and cost more; "Pro" variants output 1080p–4K.
+
 ### Limits (per account)
 
 | Limit | Value | When exceeded |
@@ -248,7 +276,7 @@ headshot and sheet as image references and the voice as an audio reference to
 a Ref model.
 
 ```bash
-wji fs get <datasetId> --scope full --json | jq '{images: [.images[]? | {id, type}], icon, primaryAudio}'
+wji fs get <datasetId> --json --detail full | jq '{images: [.images[]? | {id, type}], icon, primaryAudio}'
 wji fs set <datasetId> --add-images <headshot> <sheet> <voice> --icon <headshot> --set primaryAudio=<voice>
 ```
 
@@ -294,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`.
@@ -468,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.
@@ -549,6 +583,9 @@ wji org list && wji org use <orgId>
 - **Lists are paginated.** `--limit` is capped at 100; `--limit -1` returns at
   most 500 on most endpoints. Page with `--page` instead of assuming you got
   everything.
+- **Lists are trimmed.** `--json` is the `standard` level; read `content`,
+  `form` or `settings` with `--detail full`, and never write back a `content`
+  that carries `truncated: true`.
 - **Report failures honestly.** A failed generation surfaces as a non-zero exit
   with the provider's message — pass it on rather than retrying silently.
 

package/skill/wji/reference/commands.md

@@ -10,7 +10,8 @@ Global flags (accepted before any subcommand):
 | `--org <orgId>` | organization context (`X-Org-Id`) |
 | `--no-org` | force personal context for this call |
 | `--locale <locale>` | response language: `cht`, `chs`, `en` |
-| `--json` | print the raw API response instead of tables |
+| `--json` | print JSON instead of tables (`standard` detail unless `--detail` is given) |
+| `--detail <level>` | `brief` / `standard` / `full` for list and get reads; `full` is the raw API response. Env `WJI_DETAIL` |
 
 Value conventions: `@file` reads a file, `-` reads stdin, `--set key=value`
 repeats and nests on dots, references are `assetId[:label[:weight]]`.
@@ -64,13 +65,15 @@ switch endpoint.
 
 | Command | API |
 | --- | --- |
-| `ws list [-k keyword] [-s all\|me\|shared\|favorite] [--page] [--limit]` | `GET /workspace/search` — `--limit` max 100, `-1` returns at most 500 |
-| `ws get [id]` | `GET /workspace/list/:id` |
+| `ws list [-k keyword] [-s all\|me\|shared\|favorite] [--page] [--limit]` | `GET /workspace/search` — `--limit` max 100, `-1` returns at most 500; sends `detail` |
+| `ws get [id]` | `GET /workspace/list/:id` — sends `detail` (`settings` and full members need `--detail full`) |
 | `ws use <id>` | stores the default workspace locally |
 | `ws create <name> [-d] [-r ratio] [-l lang] [-t type] [-a app...] [--no-apps]` | `POST /workspace/create` — without `-a` the workspace gets the default template `dataset datasetimagegeneration canvas`; `--no-apps` creates it empty (the API itself adds nothing) |
 | `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 |
@@ -96,10 +99,10 @@ Restriction from the backend: `Dataset`, `Draw`, `DatasetImageGeneration` and
 
 | Command | API |
 | --- | --- |
-| `fs root [key] [-d depth]` | `GET /fsnode/root[/:key]` — key defaults to your drive; pass a workspace id for its root |
-| `fs ls <id> [--limit] [--scope]` | `GET /fsnode/list/:id/children` |
-| `fs tree <id> [-d depth]` | `GET /fsnode/list/:id/tree` |
-| `fs get <id> [--scope]` | `GET /fsnode/list/:id` (comma-separated ids allowed) |
+| `fs root [key] [-d depth]` | `GET /fsnode/root[/:key]` — key defaults to your drive; pass a workspace id for its root; sends `detail` |
+| `fs ls <id> [--limit] [--scope]` | `GET /fsnode/list/:id/children` — sends `detail`; at `standard` each `content` is a summary |
+| `fs tree <id> [-d depth]` | `GET /fsnode/list/:id/tree` — sends `detail` |
+| `fs get <id> [--scope]` | `GET /fsnode/list/:id` (comma-separated ids allowed) — sends `detail`; `--detail full` for the whole `content` |
 | `fs path <id>` | `GET /fsnode/list/:id/path` |
 | `fs mkdir <parent> <name> [--nickname] [--content]` | `POST /fsnode/create` type=folder |
 | `fs touch <parent> <name> [--mimetype] [--asset] [--content]` | `POST /fsnode/create` type=file |
@@ -118,7 +121,7 @@ characters, nicknames at 200, and `fs batch` at 100 items per call.
 | Command | Notes |
 | --- | --- |
 | `dataset new <parent> <name> [-t type] [-d description] [--images] [--nickname]` | creates an fsnode with mimetype `workspace/dataset` |
-| `dataset list <folderId>` | dataset nodes in a folder |
+| `dataset list <folderId>` | dataset nodes in a folder (sends `detail`) |
 | `dataset get <key>` | `GET /dataset/list/:key` (vector-store record) |
 | `dataset rm <key> [-y]` | `DELETE /dataset/list/:key` |
 
@@ -150,6 +153,11 @@ Model parameters worth knowing (`--set`, see `wji models get`):
 `gpt-image-2.5-*` `background=transparent` returns a PNG with alpha;
 `bytedance-seedream-5-pro` `layer_decomposition=true` splits one reference
 image into separate PNG layer assets (exactly 1 reference, `size=1K|2K`).
+`face-swap-uncensored` / `head-swap-uncensored` take exactly 2 references in
+order (target picture, then the face / head); `qwen-image-edit-uncensored`
+edits the first reference; `z-image-*-uncensored` `long_edge=<px>`;
+`wan-animate-uncensored` `mode=animate|replace`; `flashvsr-uncensored`
+`resolution=720p|1080p|2k|4k`.
 
 Uploads of `.html`, `.xhtml`, `.svg`, `.js` and `.xml` are stored as
 `application/octet-stream` with `Content-Disposition: attachment`.
@@ -171,7 +179,7 @@ updates live.
 | `canvas copy [nodeIds...] --to <canvasIds...> [-c] [--selected] [--at x,y] [--same-position] [-y]` | the canvas's own copy-paste: new nodes (no position, `generate.historyId/pendingAssetId` dropped, finished asset shared via `file`), edges among them re-created oldest first so `@image1…` numbering holds, color tags kept and a missing label carried to the target. Edges from nodes outside the copy are left out. Default placement: right of what is already on the target |
 | `canvas nodes [-c] [-k kind] [-n regex] [--tag tags…\|--untagged]` | `GET /fsnode/list/:canvasId/children?limit=-1` + `POST /assets/check-status`. `-n` matches the node name as a case-insensitive regex (`/re/flags` to set flags yourself). `--tag` takes a label (`C01`, case-insensitive), a color (`red`) or a color id (`rose`); several values match any. Filters combine (AND) |
 | `canvas tags [-c] [-a]` | the canvas's color tags: color, label, node count (`-a` also unused, unlabelled colors) |
-| `canvas get <nodeId> [-c]` | same load; one node with references (`@image1 ← id`) and frame slots |
+| `canvas get <nodeId> [-c]` | same load; one node with references (`@image1 ← id`) and frame slots. Canvas commands always load the full canvas; `--detail` trims only the JSON they print (`standard` clips `text` / `generate.prompt` and drops `generate.values`) |
 | `canvas edges [-c] [--node]` | the `canvas/edge` children |
 | `canvas add <kind> [-c] [-n] [-t\|--text-file] [--plain] [--size w,h] [--asset] [--dataset] [-p\|--prompt-file] [-m] [-r] [--resolution] [-d] [--set] [--from ids…] [--at x,y]` | `POST /fsnode/create` (`canvas/node/<kind>`), then one `canvas/edge` per `--from`. Kinds: text, title, comment, image, video, audio, dataset. `add dataset --dataset <fsnodeId>` writes `content {datasetId, datasetName, datasetType, datasetParentName, description}` from the dataset node (must be `workspace/dataset`); it takes no `--from`. Text kinds are Markdown on the web; `--plain` turns every single line break into a Markdown hard break (`"  \n"`, fenced code untouched), and without it the CLI warns when a single break would be joined. `--size` writes `content.width/height` |
 | `canvas set <nodeId> [-c] [-n] [-t\|--text-file] [--plain] [--move x,y] [--size w,h] [-p] [-m] [-r] [--resolution] [-d] [--set]` | read → merge → `PATCH /fsnode/list/:id` with `contentPatch` of only the top-level keys that changed, so a concurrent browser edit of another key survives (falls back to a whole-content write on a backend without `contentPatch`) |
@@ -269,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
@@ -320,7 +332,7 @@ parameters are range-checked against the model's `min`/`max`.
 ## history
 
 `history list [-w] [--mode image|video|audio] [--fsnode] [--scope] [--scope-id] [--tags] [--bookmarked]` →
-`GET /ai/assets/history/search`
+`GET /ai/assets/history/search` (sends `detail`; `standard` clips `prompt` and summarises `form`)
 
 `history get <id> [--wait] [--timeout] [--interval]` ·
 `history bookmark <id> [--off]` · `history rm <id> [-y]` ·
@@ -329,12 +341,15 @@ parameters are range-checked against the model's `min`/`max`.
 ## models
 
 `models list [-f feature...] [-w] [-k keyword] [--all]` →
-`GET /ai/model/list/:features`
+`GET /ai/model/list/:features` (sends `detail`; at `standard` the `form` keeps
+only ratios, batch, reference caps and `other` options — `--detail full` for the
+whole schema)
 
 The endpoint matches with `features.some(...)`, so an empty feature list returns
 nothing; with no `-f` the CLI asks for every feature instead.
 
-The response is a curated view — no `id`, `rate`, `tags` or `protocol` — and it
+The response is a curated view — no `id`, `rate` or `protocol` (`tags` is
+included; uncensored models carry `uncensored`) — and it
 is de-duplicated by **`nickname`**, which is therefore the unique selector.
 `name` is not unique (`seedance-2.0` exists twice under different providers).
 Pass the `MODEL` column (the nickname) to `-m`.
@@ -352,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`
 
@@ -371,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.
 
@@ -467,6 +493,12 @@ Pass `null` to clear a nullable field. Password minimum is 6 characters.
   asset carrying `error` is also a failure.
 - Some GETs are cached per user for 10s, keyed on the full URL including the
   query string.
+- Workspace, fsnode, model and history reads accept `?detail=brief|standard|full`.
+  The API defaults to `full` (the website relies on it); the CLI sends the
+  `--detail` value, or `standard` under `--json`. `standard` clips long text to
+  200 chars, turns media into `{id, url, thumbnail, status, …}` and reduces an
+  fsnode `content` to a summary carrying `truncated: true`; never PATCH such a
+  summary back.
 - Paginated endpoints return `{ data, pagination: { total, page, limit, next,
   hasNext, hasPrev, totalPages } }`. An explicit `limit` is capped at **100**.
   `limit: -1` returns everything only on endpoints that opt in (`fs ls` does);