@skrr-ai/cli 0.1.36 → 0.1.38

package/dist/commands/agents/avatar/default/set.js

@@ -0,0 +1,120 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../../base-command");
+const agent_visual_refs_1 = require("../../../../lib/agent-visual-refs");
+/**
+ * Choose the policy. Wraps `PUT /api/agents/avatar-default`.
+ *
+ * ONE value, not three switches: `--mode` selects which of the shapes in
+ * `AgentAvatarDefaultPolicy` is being written, and the other flags supply that
+ * shape's payload. The union is the server's contract, so the command refuses a
+ * combination that cannot be one of its members rather than sending a
+ * half-formed object and letting zod name the problem.
+ */
+class AgentsAvatarDefaultSet extends base_command_1.BaseCommand {
+    static description = 'Set the default-avatar policy for agents you create from now on';
+    static examples = [
+        '<%= config.bin %> agents avatar default set --mode platform',
+        '<%= config.bin %> agents avatar default set --mode fixed --ref preset:kosmo',
+        '<%= config.bin %> agents avatar default set --mode random --scope category --category illustrations',
+        '<%= config.bin %> agents avatar default set --mode random --scope mine',
+        '<%= config.bin %> agents avatar default set --clear',
+    ];
+    static flags = {
+        mode: core_1.Flags.string({
+            description: 'platform = the shipped logo; fixed = one avatar; random = a different one each time',
+            options: ['platform', 'fixed', 'random'],
+            exclusive: ['clear'],
+        }),
+        clear: core_1.Flags.boolean({
+            description: 'Remove your policy entirely, so new agents follow whatever the workspace or the ' +
+                'platform ships. NOT the same as --mode platform, which pins the logo.',
+            exclusive: ['mode', 'ref', 'scope', 'category'],
+        }),
+        ref: core_1.Flags.string({
+            description: '--mode fixed: which avatar. default, preset:<id>, asset:<id>, or image:<filepath>@<source>',
+        }),
+        scope: core_1.Flags.string({
+            description: '--mode random: draw from the whole catalog, one category, or your own uploads',
+            options: ['all', 'category', 'mine'],
+        }),
+        category: core_1.Flags.string({
+            description: '--mode random --scope category: which category to draw from',
+            options: [...data_provider_1.AGENT_AVATAR_PRESET_CATEGORIES],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    buildPolicy(flags) {
+        if (flags.mode === 'platform')
+            return { mode: 'platform' };
+        if (flags.mode === 'fixed') {
+            if (!flags.ref) {
+                this.error('--mode fixed needs --ref to say which avatar. ' +
+                    'For example --ref preset:kosmo (`skrr agents avatar presets`) or ' +
+                    '--ref asset:<id> (`skrr agents avatar library`).', { exit: 1 });
+            }
+            return { mode: 'fixed', ref: (0, agent_visual_refs_1.parseAvatarRefFlag)(flags.ref) };
+        }
+        if (!flags.scope) {
+            this.error('--mode random needs --scope: all (the whole catalog), category (one category, ' +
+                'with --category), or mine (your own uploads).', { exit: 1 });
+        }
+        if (flags.scope === 'category') {
+            if (!flags.category) {
+                this.error('--scope category needs --category to say which one.', { exit: 1 });
+            }
+            return {
+                mode: 'random',
+                scope: 'category',
+                category: flags.category,
+            };
+        }
+        return { mode: 'random', scope: flags.scope };
+    }
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsAvatarDefaultSet);
+        // `--mode` was `required`, which made the cleared state — the one the write
+        // route goes out of its way to support — unreachable from here: every value
+        // of `--mode` WRITES a policy, so once this command had been run there was
+        // no way back to "no opinion" short of calling the API by hand.
+        if (!flags.clear && !flags.mode) {
+            this.error('Choose --mode platform|fixed|random to set a policy, or --clear to remove yours so ' +
+                'new agents follow whatever the workspace or the platform ships.', { exit: 1 });
+        }
+        let policy = null;
+        if (!flags.clear) {
+            try {
+                policy = this.buildPolicy(flags);
+            }
+            catch (err) {
+                this.error(err.message, { exit: 1 });
+            }
+        }
+        let response;
+        try {
+            response = await data_provider_1.dataService.setAgentAvatarDefault(policy);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        if (flags.clear) {
+            // Say what it FOLLOWS now, not just that something was removed — the
+            // value is the same one an explicit `--mode random --scope all` would
+            // print, and the difference between them is the whole point of clearing.
+            this.log(`Cleared. New agents follow the current default: ${(0, data_provider_1.describeAgentAvatarPolicy)(response.policy)}.`);
+            this.log('If that default changes later, this account follows it.');
+        }
+        else {
+            this.log(`Default avatar policy: ${(0, data_provider_1.describeAgentAvatarPolicy)(response.policy)}`);
+        }
+        this.log('Existing agents are unchanged. `skrr agents avatar default apply` changes those.');
+    }
+}
+exports.default = AgentsAvatarDefaultSet;

package/dist/commands/agents/avatar/library/delete.d.ts

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../../../base-command';
+/**
+ * Remove one image from the caller's reusable avatar library.
+ *
+ * The server refuses with 409 while any of the caller's agents still wears the
+ * image — deleting it out from under them would leave a broken face, so the
+ * conflict is the feature. Say what to do about it rather than surfacing the
+ * bare status.
+ */
+export default class AgentsAvatarLibraryDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        assetId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/avatar/library/delete.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../../base-command");
+/**
+ * Remove one image from the caller's reusable avatar library.
+ *
+ * The server refuses with 409 while any of the caller's agents still wears the
+ * image — deleting it out from under them would leave a broken face, so the
+ * conflict is the feature. Say what to do about it rather than surfacing the
+ * bare status.
+ */
+class AgentsAvatarLibraryDelete extends base_command_1.BaseCommand {
+    static description = 'Delete one image from your reusable avatar library';
+    static examples = ['<%= config.bin %> agents avatar library delete <asset-id>'];
+    static args = {
+        assetId: core_1.Args.string({ description: 'Asset ID', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsAvatarLibraryDelete);
+        let result;
+        try {
+            result = await data_provider_1.dataService.deleteAvatarLibraryAsset(args.assetId);
+        }
+        catch (err) {
+            const status = err?.status ??
+                err?.response?.status;
+            if (status === 409) {
+                this.error(`Asset ${args.assetId} is still in use by at least one of your agents. ` +
+                    'Point those agents at another avatar first — ' +
+                    '`skrr agents update <agent-id> --avatar preset:<id>` — then delete it.', { exit: 1 });
+            }
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        this.log(`Deleted avatar asset ${args.assetId}`);
+    }
+}
+exports.default = AgentsAvatarLibraryDelete;

package/dist/commands/agents/avatar/library/index.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../../../base-command';
+/**
+ * The caller's own uploaded avatar images, reusable across their agents.
+ *
+ * Wraps `GET /api/agents/avatar-library`. The ids listed here are what
+ * `--avatar asset:<id>` takes, so this is the other half of making that flag
+ * usable (`agents avatar presets` covers the built-ins).
+ */
+export default class AgentsAvatarLibrary extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/avatar/library/index.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../../base-command");
+const format_1 = require("../../../../lib/format");
+/**
+ * The caller's own uploaded avatar images, reusable across their agents.
+ *
+ * Wraps `GET /api/agents/avatar-library`. The ids listed here are what
+ * `--avatar asset:<id>` takes, so this is the other half of making that flag
+ * usable (`agents avatar presets` covers the built-ins).
+ */
+class AgentsAvatarLibrary extends base_command_1.BaseCommand {
+    static description = 'List your reusable avatar images (`--avatar asset:<id>` takes these ids)';
+    static examples = [
+        '<%= config.bin %> agents avatar library',
+        '<%= config.bin %> agents avatar library --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsAvatarLibrary);
+        let response;
+        try {
+            response = await data_provider_1.dataService.listAvatarLibrary();
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        const assets = response.assets ?? [];
+        if (flags.json) {
+            this.log(JSON.stringify(assets, null, 2));
+            return;
+        }
+        if (assets.length === 0) {
+            this.log('No avatar images in your library yet.');
+            this.log('Upload one with: skrr agents avatar upload <agent-id> --file <path>');
+            return;
+        }
+        (0, format_1.renderTable)(assets.map((asset) => ({
+            id: asset.id,
+            name: asset.name ?? '-',
+            created: asset.createdAt ? String(asset.createdAt).slice(0, 10) : '-',
+            lastUsed: asset.lastUsedAt ? String(asset.lastUsedAt).slice(0, 10) : '-',
+        })), [
+            { key: 'id', header: 'ID', verbatim: true },
+            { key: 'name', header: 'NAME', maxWidth: 32 },
+            { key: 'created', header: 'CREATED' },
+            { key: 'lastUsed', header: 'LAST USED' },
+        ], (line) => this.log(line));
+    }
+}
+exports.default = AgentsAvatarLibrary;

package/dist/commands/agents/avatar/presets.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * The built-in avatar catalog.
+ *
+ * No network call, deliberately: the registry is CODE (`AGENT_AVATAR_PRESETS`
+ * in `@skrr-ai/data-provider`), which the CLI already links against, and the
+ * server has no endpoint that serves it. That is also why this command has to
+ * exist — `--avatar preset:<id>` is unusable without a way to learn the ids,
+ * and the web chooser's answer to that question is a grid of images.
+ */
+export default class AgentsAvatarPresets extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/avatar/presets.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const format_1 = require("../../../lib/format");
+/**
+ * The built-in avatar catalog.
+ *
+ * No network call, deliberately: the registry is CODE (`AGENT_AVATAR_PRESETS`
+ * in `@skrr-ai/data-provider`), which the CLI already links against, and the
+ * server has no endpoint that serves it. That is also why this command has to
+ * exist — `--avatar preset:<id>` is unusable without a way to learn the ids,
+ * and the web chooser's answer to that question is a grid of images.
+ */
+class AgentsAvatarPresets extends base_command_1.BaseCommand {
+    static description = 'List the built-in avatar presets `--avatar preset:<id>` accepts';
+    static examples = [
+        '<%= config.bin %> agents avatar presets',
+        '<%= config.bin %> agents avatar presets --category illustrations',
+        '<%= config.bin %> agents avatar presets --json',
+    ];
+    static flags = {
+        category: core_1.Flags.string({
+            description: 'Only presets in this category',
+            options: [...data_provider_1.AGENT_AVATAR_PRESET_CATEGORIES],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        const { flags } = await this.parse(AgentsAvatarPresets);
+        const presets = flags.category
+            ? data_provider_1.AGENT_AVATAR_PRESETS.filter((preset) => preset.category === flags.category)
+            : data_provider_1.AGENT_AVATAR_PRESETS;
+        if (flags.json) {
+            this.log(JSON.stringify(presets, null, 2));
+            return;
+        }
+        if (presets.length === 0) {
+            this.log(`No presets in category ${flags.category}.`);
+            return;
+        }
+        (0, format_1.renderTable)(presets.map((preset) => ({
+            id: preset.id,
+            name: preset.name,
+            category: data_provider_1.AGENT_AVATAR_CATEGORY_LABELS[preset.category],
+        })), [
+            { key: 'id', header: 'ID', verbatim: true },
+            { key: 'name', header: 'NAME', maxWidth: 32 },
+            { key: 'category', header: 'CATEGORY' },
+        ], (line) => this.log(line));
+        this.log('');
+        this.log(`Use one with: skrr agents update <agent-id> --avatar preset:${presets[0].id}`);
+    }
+}
+exports.default = AgentsAvatarPresets;

package/dist/commands/agents/avatar/upload.js

@@ -5,6 +5,7 @@ const promises_1 = require("node:fs/promises");
 const node_path_1 = require("node:path");
 const data_provider_1 = require("@skrr-ai/data-provider");
 const base_command_1 = require("../../../base-command");
+const agent_visual_refs_1 = require("../../../lib/agent-visual-refs");
 class AgentsAvatarUpload extends base_command_1.BaseCommand {
     static description = 'Upload an agent avatar';
     static args = { agentId: core_1.Args.string({ required: true, ignoreStdin: true }) };
@@ -15,9 +16,14 @@ class AgentsAvatarUpload extends base_command_1.BaseCommand {
     async run() {
         this.requireAuth();
         const { args, flags } = await this.parse(AgentsAvatarUpload);
+        const type = (0, agent_visual_refs_1.imageUploadMimeType)(flags.file);
+        if (!type) {
+            this.error(`--file must be a .png, .jpg, .jpeg, .webp or .gif image (got ${(0, node_path_1.basename)(flags.file)}).`, { exit: 1 });
+        }
         const bytes = await (0, promises_1.readFile)(flags.file);
         const form = new FormData();
-        form.append('file', new Blob([bytes]), (0, node_path_1.basename)(flags.file));
+        // Typed, or the route refuses it as application/octet-stream (OSK-9841).
+        form.append('file', new Blob([new Uint8Array(bytes)], { type }), (0, node_path_1.basename)(flags.file));
         const result = await data_provider_1.dataService.uploadAgentAvatar({ agent_id: args.agentId, formData: form });
         this.log(flags.json
             ? this.agentJson(args.agentId, result)

package/dist/commands/agents/categories/create.d.ts

@@ -0,0 +1,14 @@
+import { BaseCommand } from '../../../base-command';
+/** Create one of the caller's own agent categories. Wraps `POST /api/agents/categories`. */
+export default class AgentsCategoriesCreate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        value: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        label: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        order: import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/categories/create.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+/** Create one of the caller's own agent categories. Wraps `POST /api/agents/categories`. */
+class AgentsCategoriesCreate extends base_command_1.BaseCommand {
+    static description = 'Create a custom agent category';
+    static examples = [
+        '<%= config.bin %> agents categories create --value ops --label "Operations"',
+        '<%= config.bin %> agents categories create --value ops --label "Operations" --description "Runbooks and on-call" --order 3',
+    ];
+    static flags = {
+        value: core_1.Flags.string({
+            description: 'Stable identifier — this is what `--category` takes',
+            required: true,
+        }),
+        label: core_1.Flags.string({ description: 'Display name', required: true }),
+        description: core_1.Flags.string({ description: 'What belongs in this category' }),
+        order: core_1.Flags.integer({ description: 'Sort position among your categories' }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsCategoriesCreate);
+        let created;
+        try {
+            created = await data_provider_1.dataService.createUserCategory({
+                value: flags.value,
+                label: flags.label,
+                ...(flags.description === undefined ? {} : { description: flags.description }),
+                ...(flags.order === undefined ? {} : { order: flags.order }),
+            });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(created, null, 2));
+            return;
+        }
+        this.log(`Created category ${flags.value} — ${flags.label}`);
+        this.log(`Use it with: skrr agents create --category ${flags.value} …`);
+    }
+}
+exports.default = AgentsCategoriesCreate;

package/dist/commands/agents/categories/delete.d.ts

@@ -0,0 +1,13 @@
+import { BaseCommand } from '../../../base-command';
+/** Delete one of the caller's own categories. Wraps `DELETE /api/agents/categories/:value`. */
+export default class AgentsCategoriesDelete extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        value: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/categories/delete.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+/** Delete one of the caller's own categories. Wraps `DELETE /api/agents/categories/:value`. */
+class AgentsCategoriesDelete extends base_command_1.BaseCommand {
+    static description = 'Delete a custom agent category';
+    static examples = ['<%= config.bin %> agents categories delete ops'];
+    static args = {
+        value: core_1.Args.string({ description: 'Category value', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsCategoriesDelete);
+        let result;
+        try {
+            result = await data_provider_1.dataService.deleteUserCategory(args.value);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        const outcome = result;
+        this.log(`Deleted category ${args.value}`);
+        // Say where its agents went, because the alternative a reader assumes is
+        // that they went with it — and until the server moved them, they did not go
+        // anywhere: they kept pointing at a category that no longer existed.
+        if (outcome.reassigned) {
+            const noun = outcome.reassigned === 1 ? 'agent' : 'agents';
+            this.log(`Moved ${outcome.reassigned} ${noun} to ${outcome.reassignedTo}.`);
+        }
+    }
+}
+exports.default = AgentsCategoriesDelete;

package/dist/commands/agents/categories/index.d.ts

@@ -0,0 +1,36 @@
+import { BaseCommand } from '../../../base-command';
+export declare function categoryDisplayLabel(row: {
+    value?: unknown;
+    label?: unknown;
+}): string;
+export declare function categoryDisplayDescription(row: {
+    description?: unknown;
+}): string;
+/**
+ * The vocabulary `--category` accepts.
+ *
+ * The plain command used to read the GLOBAL marketplace catalog, which answers a
+ * different question: it listed `promoted`, `general` and `all` — three rows —
+ * while this account's agents actually sat in twelve categories, including the
+ * custom one the sibling `create` command had just minted. Two of the three were
+ * not categories at all but marketplace browse filters the endpoint injects. And
+ * `--mine`, described as a view, returned MORE than the default, so a flag that
+ * reads like a filter was a superset. The command's own description — "the
+ * categories `--category` accepts" — was true of none of it.
+ *
+ * So the default is now that vocabulary: the global categories plus your own,
+ * without the browse filters. The marketplace view, with its counts and filters,
+ * is `--marketplace`, named for what it is. `--mine` still works, as the default
+ * it always should have been, so nothing that scripted it breaks.
+ */
+export default class AgentsCategoriesList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        mine: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'custom-only': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        marketplace: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/categories/index.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.categoryDisplayLabel = categoryDisplayLabel;
+exports.categoryDisplayDescription = categoryDisplayDescription;
+const core_1 = require("@oclif/core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../../base-command");
+const format_1 = require("../../../lib/format");
+/**
+ * Global default categories are seeded with LOCALIZATION KEYS as their label and
+ * description (`com_agents_category_general`), because the web translates them.
+ * The CLI has no translations and printed the keys: the category most agents are
+ * in read `com_agents_category_general` / `com_agents_category_general_description`,
+ * in text and `--json` alike.
+ *
+ * Copying the translations here would be a second source that drifts. A key
+ * label renders as the title-cased value instead — for `general`, the one global
+ * default left, that is exactly its English translation — and a key description
+ * renders as nothing rather than as a key. `--json` keeps the raw row; only the
+ * human rendering is touched.
+ */
+const LOCALIZATION_KEY = /^com_[a-z0-9_]+$/;
+function categoryDisplayLabel(row) {
+    const label = typeof row.label === 'string' ? row.label : '';
+    if (label && !LOCALIZATION_KEY.test(label))
+        return label;
+    const value = typeof row.value === 'string' ? row.value : '';
+    if (!value)
+        return label || '-';
+    return value
+        .split(/[-_\s]+/)
+        .filter(Boolean)
+        .map((word) => word[0].toUpperCase() + word.slice(1))
+        .join(' ');
+}
+function categoryDisplayDescription(row) {
+    const description = typeof row.description === 'string' ? row.description : '';
+    return LOCALIZATION_KEY.test(description) ? '' : description;
+}
+/**
+ * The vocabulary `--category` accepts.
+ *
+ * The plain command used to read the GLOBAL marketplace catalog, which answers a
+ * different question: it listed `promoted`, `general` and `all` — three rows —
+ * while this account's agents actually sat in twelve categories, including the
+ * custom one the sibling `create` command had just minted. Two of the three were
+ * not categories at all but marketplace browse filters the endpoint injects. And
+ * `--mine`, described as a view, returned MORE than the default, so a flag that
+ * reads like a filter was a superset. The command's own description — "the
+ * categories `--category` accepts" — was true of none of it.
+ *
+ * So the default is now that vocabulary: the global categories plus your own,
+ * without the browse filters. The marketplace view, with its counts and filters,
+ * is `--marketplace`, named for what it is. `--mine` still works, as the default
+ * it always should have been, so nothing that scripted it breaks.
+ */
+class AgentsCategoriesList extends base_command_1.BaseCommand {
+    static description = 'List the agent categories `--category` accepts';
+    static examples = [
+        '<%= config.bin %> agents categories',
+        '<%= config.bin %> agents categories --custom-only --json',
+        '<%= config.bin %> agents categories --marketplace',
+    ];
+    static flags = {
+        mine: core_1.Flags.boolean({
+            description: 'Deprecated: the default already lists your categories',
+            exclusive: ['custom-only', 'marketplace'],
+            hidden: true,
+        }),
+        'custom-only': core_1.Flags.boolean({
+            description: 'Only the custom categories you created',
+            exclusive: ['mine', 'marketplace'],
+        }),
+        marketplace: core_1.Flags.boolean({
+            description: 'The global marketplace catalog with agent counts, including its browse filters ' +
+                '(`promoted`, `all`) — not a list of values `--category` takes',
+            exclusive: ['mine', 'custom-only'],
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsCategoriesList);
+        let rows;
+        try {
+            if (flags['custom-only']) {
+                rows = (await data_provider_1.dataService.getUserCustomCategories());
+            }
+            else if (flags.marketplace) {
+                rows = (await data_provider_1.dataService.getAgentCategories());
+            }
+            else {
+                rows = (await data_provider_1.dataService.getUserAgentCategories()).filter((row) => !(0, data_provider_1.isAgentCategoryBrowseFilter)(row.value));
+            }
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        const items = rows ?? [];
+        if (flags.json) {
+            this.log(JSON.stringify(items, null, 2));
+            return;
+        }
+        if (items.length === 0) {
+            this.log(flags['custom-only']
+                ? 'You have no custom categories. Create one with: skrr agents categories create'
+                : 'No categories.');
+            return;
+        }
+        (0, format_1.renderTable)(items.map((row) => ({
+            value: String(row.value ?? '-'),
+            label: categoryDisplayLabel(row),
+            custom: row.custom ? 'yes' : 'no',
+            count: row.count === undefined
+                ? '-'
+                : String(row.count),
+            description: categoryDisplayDescription(row),
+        })), [
+            { key: 'value', header: 'VALUE', verbatim: true },
+            { key: 'label', header: 'LABEL', maxWidth: 28 },
+            { key: 'custom', header: 'CUSTOM' },
+            { key: 'count', header: 'AGENTS' },
+            { key: 'description', header: 'DESCRIPTION', maxWidth: 48 },
+        ], (line) => this.log(line));
+        this.log('');
+        if (flags.marketplace) {
+            this.log('Marketplace view. `promoted` and `all` are browse filters, not categories — ' +
+                'run without --marketplace for the values `--category` takes.');
+        }
+        else {
+            this.log('VALUE is what `skrr agents create --category <value>` takes.');
+        }
+    }
+}
+exports.default = AgentsCategoriesList;