@wji.ai/cli 0.7.0 → 0.8.0

package/dist/commands/agent.js

@@ -1,294 +0,0 @@
-import { Command } from 'commander';
-import { WjiClient } from '../core/client.js';
-import { confirm, parseKeyValues, readValue } from '../core/prompt.js';
-import { color, detail, info, relativeTime, render, success, table, truncate } from '../core/output.js';
-/** Parse a skill ref token: `system:<key>` or `user:<id>` (bare = user id). */
-function parseSkillRef(token) {
-    const [kindRaw, rest] = token.includes(':') ? token.split(/:(.+)/) : ['user', token];
-    const kind = kindRaw === 'system' ? 'system' : 'user';
-    if (!rest)
-        throw new Error(`Invalid skill ref "${token}" — use system:<key> or user:<id>`);
-    return kind === 'system' ? { kind, key: rest } : { kind, id: rest };
-}
-function skillRefLabel(ref) {
-    if (!ref?.kind)
-        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
-        .command('list', { isDefault: true })
-        .description('Browse the public agent marketplace')
-        .option('-n, --name <name>', 'exact agent name')
-        .option('-c, --category <name>', 'exact category')
-        .option('-t, --tag <tag>', 'agents carrying this tag')
-        .option('--include-unlisted', 'also show unlisted agents')
-        .option('--page <n>', 'page number', '1')
-        .option('--limit <n>', 'page size', '20')
-        .action(async (opts) => {
-        const client = new WjiClient(globals());
-        const result = await client.get('/ai/agent/search', {
-            name: opts.name,
-            category: opts.category,
-            tags: opts.tag,
-            includeUnlisted: opts.includeUnlisted ? 'true' : undefined,
-            page: Number(opts.page),
-            limit: Number(opts.limit),
-        });
-        render(result, (r) => printAgentTable(r));
-    });
-    agent
-        .command('mine')
-        .description('List agents you created')
-        .option('-n, --name <name>', 'exact agent name')
-        .option('-c, --category <name>', 'exact category')
-        .option('--visibility <v>', 'public | private | unlist')
-        .option('--page <n>', 'page number', '1')
-        .option('--limit <n>', 'page size', '20')
-        .action(async (opts) => {
-        const client = new WjiClient(globals());
-        const result = await client.get('/ai/agent/search/my', {
-            name: opts.name,
-            category: opts.category,
-            visibility: opts.visibility,
-            page: Number(opts.page),
-            limit: Number(opts.limit),
-        });
-        render(result, (r) => printAgentTable(r));
-    });
-    agent
-        .command('get <id>')
-        .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}`);
-        render(a, () => detail([
-            ['id', a.id],
-            ['name', a.name],
-            ['description', a.description],
-            ['model', a.model],
-            ['visibility', a.visibility],
-            ['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(', ')],
-            ['instructions', a.instructions],
-        ]));
-    });
-    agent
-        .command('create <name>')
-        .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')
-        .option('--visibility <v>', 'private | unlist | public', 'private')
-        .option('-c, --category <name>', 'category')
-        .option('-t, --tag <tag...>', 'tags')
-        .option('--greeting <text>', 'opening message')
-        .option('--skill <ref...>', 'attach skills: system:<key> or user:<skillId>')
-        .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', {
-            name,
-            description: opts.description,
-            instructions: opts.instructions ? await readValue(opts.instructions) : undefined,
-            model: opts.model,
-            visibility: opts.visibility,
-            category: opts.category,
-            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 (creator only)')
-        .option('-n, --name <name>', 'new name')
-        .option('-d, --description <text>', 'new description')
-        .option('-i, --instructions <text>', 'new system prompt (@file / - supported)')
-        .option('-m, --model <name>', 'new model')
-        .option('--visibility <v>', 'private | unlist | public')
-        .option('-c, --category <name>', 'category')
-        .option('-t, --tag <tag...>', 'replace tags')
-        .option('--greeting <text>', 'opening message')
-        .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}`, {
-            name: opts.name,
-            description: opts.description,
-            instructions: opts.instructions ? await readValue(opts.instructions) : undefined,
-            model: opts.model,
-            visibility: opts.visibility,
-            category: opts.category,
-            tags: opts.tag,
-            greeting: opts.greeting,
-            maxSteps: parseMaxSteps(opts.maxSteps),
-            ...parseKeyValues(opts.set),
-        });
-        render(updated, () => success(`Updated ${id}`));
-    });
-    agent
-        .command('rm <id>')
-        .description('Delete an agent')
-        .option('-y, --yes', 'skip confirmation')
-        .action(async (id, opts) => {
-        const client = new WjiClient(globals());
-        const a = await client.get(`/ai/agent/list/${id}`).catch(() => ({ name: id }));
-        if (!(await confirm(`Delete agent "${a.name}" (${id})?`, opts.yes)))
-            return info('Aborted');
-        const result = await client.delete(`/ai/agent/list/${id}`);
-        render(result, () => success(`Deleted ${id}`));
-    });
-    agent
-        .command('files <id>')
-        .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`);
-        render(files, (rows) => table(rows || [], [
-            { header: 'id', value: (f) => f.id },
-            { header: 'name', value: (f) => f.name },
-            { header: 'type', value: (f) => f.type },
-        ]));
-    });
-    agent
-        .command('categories')
-        .description('List agent categories')
-        .option('--mine', 'only categories used by your agents')
-        .action(async (opts) => {
-        const client = new WjiClient(globals());
-        const list = await client.get(opts.mine ? '/ai/agent/categories/my' : '/ai/agent/categories');
-        render(list, (rows) => rows.filter(Boolean).forEach((c) => process.stdout.write(c + '\n')));
-    });
-    agent
-        .command('tags')
-        .description('List agent tags')
-        .option('--mine', 'only tags used by your agents')
-        .action(async (opts) => {
-        const client = new WjiClient(globals());
-        const list = await client.get(opts.mine ? '/ai/agent/tags/my' : '/ai/agent/tags');
-        render(list, (rows) => rows.filter(Boolean).forEach((t) => process.stdout.write(t + '\n')));
-    });
-    agent
-        .command('recommend')
-        .description('Show recommended agents')
-        .action(async () => {
-        const client = new WjiClient(globals());
-        const rows = await client.get('/ai/agent/recommend');
-        render(rows, (list) => table(list || [], [
-            { header: 'id', value: (a) => a.id },
-            { header: 'name', value: (a) => a.name },
-            { header: 'title', value: (a) => truncate(a.recommendTitle, 40) },
-        ]));
-    });
-    agent
-        .command('skills <id>')
-        .description('Show the skills attached to an agent')
-        .action(async (id) => {
-        const client = new WjiClient(globals());
-        const a = await client.get(`/ai/agent/list/${id}`);
-        render(a.skills || [], (rows) => {
-            if (!rows.length)
-                return info(color.dim('(no skills attached)'));
-            table(rows, [
-                { header: 'kind', value: (r) => r.kind },
-                { header: 'ref', value: (r) => (r.kind === 'system' ? r.key : r.id) },
-                { header: 'name', value: (r) => r.name },
-            ]);
-        });
-    });
-    agent
-        .command('skill-add <id> <ref...>')
-        .description('Attach skills to an agent (refs: system:<key> or user:<skillId>)')
-        .action(async (id, refs) => {
-        const client = new WjiClient(globals());
-        const a = await client.get(`/ai/agent/list/${id}`);
-        const existing = (a.skills || []);
-        const seen = new Set(existing.map(skillRefLabel));
-        const added = [];
-        for (const token of refs) {
-            const ref = parseSkillRef(token);
-            if (seen.has(skillRefLabel(ref)))
-                continue;
-            existing.push(ref);
-            seen.add(skillRefLabel(ref));
-            added.push(skillRefLabel(ref));
-        }
-        const updated = await client.put(`/ai/agent/list/${id}`, { skills: existing });
-        render(updated, () => success(added.length ? `Attached ${added.join(', ')}` : 'No new skills to attach'));
-    });
-    agent
-        .command('skill-remove <id> <ref...>')
-        .description('Detach skills from an agent (refs: system:<key> or user:<skillId>)')
-        .action(async (id, refs) => {
-        const client = new WjiClient(globals());
-        const a = await client.get(`/ai/agent/list/${id}`);
-        const drop = new Set(refs.map((t) => skillRefLabel(parseSkillRef(t))));
-        const kept = (a.skills || []).filter((r) => !drop.has(skillRefLabel(r)));
-        const updated = await client.put(`/ai/agent/list/${id}`, { skills: kept });
-        render(updated, () => success(`Removed ${refs.length} skill ref(s)`));
-    });
-    agent
-        .command('versions <id>')
-        .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`);
-        render(versions, (rows) => table(rows || [], [
-            { header: 'versionId', value: (v) => v.id },
-            { header: 'v', value: (v) => v.version },
-            { header: 'name', value: (v) => truncate(v.snapshot?.name, 24) },
-            { header: 'model', value: (v) => v.snapshot?.model },
-            { header: 'comment', value: (v) => truncate(v.comment, 30) },
-            { header: 'when', value: (v) => relativeTime(v.createdAt) },
-        ]));
-    });
-    agent
-        .command('restore <id> <versionId>')
-        .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`);
-        render(result, () => success(`Restored ${id} to version ${versionId}`));
-    });
-    return agent;
-}
-function printAgentTable(result) {
-    const rows = result?.data || result || [];
-    table(rows, [
-        { header: 'id', value: (a) => a.id },
-        { header: 'name', value: (a) => truncate(a.name, 28) },
-        { header: 'model', value: (a) => a.model },
-        { header: 'visibility', value: (a) => a.visibility },
-        { header: 'category', value: (a) => a.category },
-        { header: 'updated', value: (a) => relativeTime(a.updatedAt) },
-    ]);
-    if (result?.pagination)
-        info(color.dim(`${result.pagination.total} total`));
-}

package/dist/commands/asset.js

@@ -1,241 +0,0 @@
-import { createWriteStream } from 'node:fs';
-import { stat } from 'node:fs/promises';
-import { basename, join } from 'node:path';
-import { Readable } from 'node:stream';
-import { pipeline } from 'node:stream/promises';
-import { Command } from 'commander';
-import { ASSET_BATCH_MAX_IDS, WjiClient, isObjectId } from '../core/client.js';
-import { confirm } from '../core/prompt.js';
-import { color, detail, info, isJsonMode, printJson, relativeTime, render, success, table, truncate, warn } from '../core/output.js';
-const STATE = { 0: 'pending', 1: 'ready', [-1]: 'cancelled' };
-/** The server rejects the whole batch if any id is malformed — fail fast and say which. */
-function assertAssetIds(ids) {
-    const bad = ids.filter((id) => !isObjectId(id));
-    if (bad.length)
-        throw new Error(`Not asset ids (expected 24-char ObjectIds): ${bad.join(', ')}`);
-}
-function humanSize(bytes) {
-    if (bytes == null)
-        return null;
-    const units = ['B', 'KB', 'MB', 'GB'];
-    let value = bytes;
-    let unit = 0;
-    while (value >= 1024 && unit < units.length - 1) {
-        value /= 1024;
-        unit++;
-    }
-    return `${value.toFixed(unit === 0 ? 0 : 1)}${units[unit]}`;
-}
-export function assetCommand(globals) {
-    const asset = new Command('asset').description('Upload and manage assets');
-    asset
-        .command('upload <file...>')
-        .description('Upload one or more local files')
-        .option('-w, --workspace <id>', 'attach to a workspace')
-        .option('--store <id>', 'vector store id')
-        .option('--vectorize', 'index the file for retrieval')
-        .option('--width <n>', 'source width hint')
-        .option('--height <n>', 'source height hint')
-        .option('--duration <n>', 'media duration hint in seconds')
-        .action(async (files, opts) => {
-        const client = new WjiClient(globals());
-        const workspace = client.workspace(opts.workspace);
-        const uploaded = [];
-        for (const file of files) {
-            const size = (await stat(file)).size;
-            info(color.dim(`Uploading ${basename(file)} (${humanSize(size)})…`));
-            const result = await client.upload('/assets/v2/upload', file, {
-                workspace,
-                store: opts.store,
-                vectorize: opts.vectorize ? 'true' : undefined,
-                width: opts.width,
-                height: opts.height,
-                duration: opts.duration,
-            });
-            uploaded.push(result);
-            if (!isJsonMode())
-                success(`${basename(file)} → ${result.id}`);
-        }
-        if (isJsonMode())
-            render(files.length === 1 ? uploaded[0] : uploaded, () => { });
-    });
-    asset
-        .command('import <url>')
-        .description('Import an asset from a URL')
-        .option('-w, --workspace <id>', 'attach to a workspace')
-        .option('-n, --name <name>', 'asset name')
-        .option('--type <type>', 'asset type override')
-        .option('--raw', 'use /assets/import-from-url instead of create-from-url')
-        .action(async (url, opts) => {
-        const client = new WjiClient(globals());
-        const created = opts.raw
-            ? await client.post('/assets/import-from-url', { url })
-            : await client.post('/assets/create-from-url', {
-                url,
-                workspace: client.workspace(opts.workspace),
-                name: opts.name,
-                type: opts.type,
-            });
-        render(created, (a) => success(`Imported ${a.id}`));
-    });
-    asset
-        .command('list')
-        .description('Search your assets')
-        .option('--store <id>', 'filter by vector store')
-        .option('--page <n>', 'page number', '1')
-        .option('--limit <n>', 'page size', '20')
-        .action(async (opts) => {
-        const client = new WjiClient(globals());
-        const result = await client.get('/assets/search', {
-            store: opts.store,
-            page: Number(opts.page),
-            limit: Number(opts.limit),
-        });
-        render(result, (r) => {
-            table(r.data || [], [
-                { header: 'id', value: (a) => a.id },
-                { header: 'type', value: (a) => a.type },
-                { header: 'name', value: (a) => truncate(a.name, 30) },
-                { header: 'size', value: (a) => humanSize(a.size) },
-                { header: 'state', value: (a) => STATE[a.status] ?? a.status },
-                { header: 'created', value: (a) => relativeTime(a.createdAt) },
-            ]);
-            info(color.dim(`${r.pagination?.total ?? 0} total`));
-        });
-    });
-    asset
-        .command('get <id>')
-        .description('Show one asset')
-        .action(async (id) => {
-        const client = new WjiClient(globals());
-        const a = await client.get(`/assets/list/${id}`);
-        render(a, () => printAsset(a));
-    });
-    asset
-        .command('status <ids...>')
-        .description(`Check processing state of several assets (sent ${ASSET_BATCH_MAX_IDS} per request)`)
-        .action(async (ids) => {
-        assertAssetIds(ids);
-        const unique = [...new Set(ids)];
-        const client = new WjiClient(globals());
-        const rows = await client.checkAssetStatus(unique);
-        render(rows, (list) => {
-            table(list || [], [
-                { header: 'id', value: (a) => a.id },
-                { header: 'state', value: (a) => STATE[a.status] ?? a.status },
-                { header: 'error', value: (a) => truncate(a.error?.message || a.error, 40) },
-                { header: 'url', value: (a) => truncate(a.url, 50) },
-            ]);
-            // The server silently drops ids you may not read instead of erroring.
-            const missing = unique.length - (list?.length ?? 0);
-            if (missing > 0) {
-                warn(`${missing} id(s) not returned: not found, or neither yours nor in a workspace you belong to`);
-            }
-        });
-    });
-    asset
-        .command('update <id>')
-        .description('Rename or retag an asset')
-        .option('-n, --name <name>', 'new name')
-        .option('--tags <tag...>', 'replace tags')
-        .action(async (id, opts) => {
-        const client = new WjiClient(globals());
-        const updated = await client.patch(`/assets/list/${id}`, {
-            name: opts.name,
-            tags: opts.tags,
-        });
-        render(updated, () => success(`Updated ${id}`));
-    });
-    asset
-        .command('rm <id>')
-        .description('Delete an asset')
-        .option('-y, --yes', 'skip confirmation')
-        .action(async (id, opts) => {
-        if (!(await confirm(`Delete asset ${id}?`, opts.yes)))
-            return info('Aborted');
-        const client = new WjiClient(globals());
-        const result = await client.delete(`/assets/list/${id}`);
-        render(result, () => success(`Deleted ${id}`));
-    });
-    asset
-        .command('download <ids...>')
-        .description('Download assets to disk (a directory keeps each asset name plus its file extension)')
-        .option('-o, --out <path>', 'output file (one id) or directory', '.')
-        .action(async (ids, opts) => {
-        const client = new WjiClient(globals());
-        const isDir = await stat(opts.out).then((s) => s.isDirectory()).catch(() => false);
-        if (ids.length > 1 && !isDir)
-            throw new Error('With several ids, --out must be an existing directory');
-        const saved = [];
-        for (const id of ids) {
-            const a = await client.get(`/assets/list/${id}`);
-            if (!a?.url)
-                throw new Error(`Asset ${id} has no URL yet (state: ${STATE[a?.status] ?? a?.status})`);
-            const res = await fetch(a.url);
-            if (!res.ok || !res.body)
-                throw new Error(`Download failed: ${res.status} ${res.statusText}`);
-            let target = opts.out;
-            if (isDir) {
-                // Asset names are titles ("boat"), not file names: keep the extension so
-                // image viewers and agents can open the file.
-                const base = String(a.name || id).replace(/[\\/]/g, '_');
-                target = join(opts.out, /\.[a-z0-9]{2,5}$/i.test(base) ? base : `${base}${extensionOf(a.url)}`);
-            }
-            await pipeline(Readable.fromWeb(res.body), createWriteStream(target));
-            saved.push({ id, path: target });
-            if (!isJsonMode())
-                success(`Saved ${target}`);
-        }
-        if (isJsonMode())
-            printJson(ids.length === 1 ? saved[0] : saved);
-    });
-    asset
-        .command('resolve <url>')
-        .description('Find an existing asset by its URL')
-        .option('-w, --workspace <id>', 'workspace scope')
-        .action(async (url, opts) => {
-        const client = new WjiClient(globals());
-        const a = await client.get('/assets/resolve-by-url', {
-            url,
-            workspace: client.workspace(opts.workspace),
-        });
-        render(a, (found) => (found ? printAsset(found) : info('No matching asset')));
-    });
-    asset
-        .command('summary <id...>')
-        .description(`Generate AI summaries for your own assets (at most ${ASSET_BATCH_MAX_IDS} per call)`)
-        .action(async (ids) => {
-        assertAssetIds(ids);
-        // Not batched automatically: every id is a separate vectorize + LLM job.
-        if (ids.length > ASSET_BATCH_MAX_IDS) {
-            throw new Error(`asset summary takes at most ${ASSET_BATCH_MAX_IDS} ids per call`);
-        }
-        const client = new WjiClient(globals());
-        const result = ids.length === 1
-            ? await client.post(`/assets/list/${ids[0]}/summary`)
-            : await client.post('/assets/summary/batch', { ids });
-        render(result, (r) => detail(Object.entries(r || {})));
-    });
-    return asset;
-}
-function extensionOf(url) {
-    const match = /\.([a-z0-9]{2,5})(?:\?|$)/i.exec(url);
-    return match ? `.${match[1]}` : '';
-}
-function printAsset(a) {
-    detail([
-        ['id', a.id],
-        ['name', a.name],
-        ['type', a.type],
-        ['mimetype', a.mimetype],
-        ['state', STATE[a.status] ?? a.status],
-        ['size', humanSize(a.size)],
-        ['aspectRatio', a.aspectRatio],
-        ['duration', a.duration],
-        ['url', a.url],
-        ['thumbnail', a.thumbnail],
-        ['tags', (a.tags || []).join(', ')],
-        ['error', a.error?.message || a.error],
-        ['createdAt', a.createdAt],
-    ]);
-}