@skrr-ai/cli 0.1.36 → 0.1.37

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

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../../../base-command';
+/**
+ * What face a NEW agent gets when its creator does not pick one.
+ *
+ * Wraps `GET /api/agents/avatar-default`. The policy is read exactly ONCE, at
+ * creation, and the drawn reference is written onto the agent — so changing it
+ * is structurally incapable of re-skinning an agent that already exists. That
+ * property is worth stating here, because "default" in most products means a
+ * live fallback and this one does not.
+ */
+export default class AgentsAvatarDefaultShow 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/default/index.js

@@ -0,0 +1,44 @@
+"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");
+/**
+ * What face a NEW agent gets when its creator does not pick one.
+ *
+ * Wraps `GET /api/agents/avatar-default`. The policy is read exactly ONCE, at
+ * creation, and the drawn reference is written onto the agent — so changing it
+ * is structurally incapable of re-skinning an agent that already exists. That
+ * property is worth stating here, because "default" in most products means a
+ * live fallback and this one does not.
+ */
+class AgentsAvatarDefaultShow extends base_command_1.BaseCommand {
+    static description = 'Show the default-avatar policy new agents are drawn from';
+    static examples = [
+        '<%= config.bin %> agents avatar default',
+        '<%= config.bin %> agents avatar default --json',
+    ];
+    static flags = {
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsAvatarDefaultShow);
+        let response;
+        try {
+            response = await data_provider_1.dataService.getAgentAvatarDefault();
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(response, null, 2));
+            return;
+        }
+        this.log((0, data_provider_1.describeAgentAvatarPolicy)(response.policy));
+        this.log('');
+        this.log('Applies to agents created from now on. Existing agents keep the face they have —');
+        this.log('`skrr agents avatar default apply` is the one path that changes them.');
+    }
+}
+exports.default = AgentsAvatarDefaultShow;

package/dist/commands/agents/avatar/default/set.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '../../../../base-command';
+/**
+ * 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.
+ */
+export default class AgentsAvatarDefaultSet extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        mode: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        ref: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        scope: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        category: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    private buildPolicy;
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,95 @@
+"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',
+    ];
+    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'],
+            required: true,
+        }),
+        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);
+        let policy;
+        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;
+        }
+        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/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,33 @@
+"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;
+        }
+        this.log(`Deleted category ${args.value}`);
+    }
+}
+exports.default = AgentsCategoriesDelete;

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

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * The vocabulary `--category` accepts.
+ *
+ * Three reads, because they answer three different questions and the server
+ * keeps them apart: the GLOBAL catalog with marketplace counts, the caller's
+ * view (global + their own), and the caller's own rows alone. `--mine` is the
+ * one most people want, so the flags name the other two rather than making the
+ * common case the odd one out.
+ */
+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>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,82 @@
+"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 vocabulary `--category` accepts.
+ *
+ * Three reads, because they answer three different questions and the server
+ * keeps them apart: the GLOBAL catalog with marketplace counts, the caller's
+ * view (global + their own), and the caller's own rows alone. `--mine` is the
+ * one most people want, so the flags name the other two rather than making the
+ * common case the odd one out.
+ */
+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 --mine',
+        '<%= config.bin %> agents categories --custom-only --json',
+    ];
+    static flags = {
+        mine: core_1.Flags.boolean({
+            description: 'Your view: the global catalog plus your own custom categories',
+            exclusive: ['custom-only'],
+        }),
+        'custom-only': core_1.Flags.boolean({
+            description: 'Only the custom categories you created',
+            exclusive: ['mine'],
+        }),
+        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.mine) {
+                rows = (await data_provider_1.dataService.getUserAgentCategories());
+            }
+            else {
+                rows = (await data_provider_1.dataService.getAgentCategories());
+            }
+        }
+        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: String(row.label ?? '-'),
+            custom: row.custom ? 'yes' : 'no',
+            count: row.count === undefined
+                ? '-'
+                : String(row.count),
+            description: String(row.description ?? ''),
+        })), [
+            { 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('');
+        this.log('VALUE is what `skrr agents create --category <value>` takes.');
+    }
+}
+exports.default = AgentsCategoriesList;

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

@@ -0,0 +1,22 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * Edit one of the caller's own categories. Wraps `PATCH /api/agents/categories/:value`.
+ *
+ * `value` is the identity, not a field: agents point at it, so it is the ARG and
+ * cannot be changed here. Renaming means `--label`.
+ */
+export default class AgentsCategoriesUpdate extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        value: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        label: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, 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>;
+        active: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}