@skrr-ai/cli 0.1.36 → 0.1.37

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

@@ -0,0 +1,59 @@
+"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");
+/**
+ * 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`.
+ */
+class AgentsCategoriesUpdate extends base_command_1.BaseCommand {
+    static description = 'Update a custom agent category';
+    static examples = [
+        '<%= config.bin %> agents categories update ops --label "Operations & on-call"',
+        '<%= config.bin %> agents categories update ops --no-active',
+    ];
+    static args = {
+        value: core_1.Args.string({ description: 'Category value', required: true, ignoreStdin: true }),
+    };
+    static flags = {
+        label: core_1.Flags.string({ description: 'New display name' }),
+        description: core_1.Flags.string({ description: 'New description' }),
+        order: core_1.Flags.integer({ description: 'New sort position' }),
+        active: core_1.Flags.boolean({
+            description: 'Whether the category is offered when choosing one',
+            allowNo: true,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { args, flags } = await this.parse(AgentsCategoriesUpdate);
+        const patch = {
+            ...(flags.label === undefined ? {} : { label: flags.label }),
+            ...(flags.description === undefined ? {} : { description: flags.description }),
+            ...(flags.order === undefined ? {} : { order: flags.order }),
+            ...(flags.active === undefined ? {} : { isActive: flags.active }),
+        };
+        if (Object.keys(patch).length === 0) {
+            this.error('Nothing to update. Pass at least one of --label, --description, --order, --active.', {
+                exit: 1,
+            });
+        }
+        let updated;
+        try {
+            updated = await data_provider_1.dataService.updateUserCategory(args.value, patch);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(updated, null, 2));
+            return;
+        }
+        this.log(`Updated category ${args.value}`);
+    }
+}
+exports.default = AgentsCategoriesUpdate;

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

@@ -104,6 +104,16 @@ export default class AgentsCreate extends BaseCommand {
         'hide-sequential-outputs': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'is-collaborative': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'recursion-limit': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        avatar: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'conversation-starter': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'todo-working-hours': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'reasoning-tool-escape': import("@oclif/core/lib/interfaces").OptionFlag<string[] | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'commitment-responsibility': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'commitment-responsibility-ceiling': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'max-turns': import("@oclif/core/lib/interfaces").OptionFlag<number | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'tool-resources': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'install-channel': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'auto-minor-updates': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/create.js

@@ -157,7 +157,10 @@ class AgentsCreate extends base_command_1.BaseCommand {
         instructions: core_1.Flags.string({
             description: 'Initial raw custom instructions (creates one inline block; use `agents instructions` to compose reusable blocks later)',
         }),
-        category: core_1.Flags.string({ description: 'Agent category' }),
+        category: core_1.Flags.string({
+            description: 'Agent category. `skrr agents categories` lists what this account accepts, and ' +
+                '`skrr agents categories create` adds one.',
+        }),
         target: core_1.Flags.string({
             description: 'Required execution target. Use a Harness id, Hosted Machine session, or Agent Worker. ' +
                 'Use hosted-machine, sbs_..., agent-worker, or a connected Harness id. ' +
@@ -192,7 +195,10 @@ class AgentsCreate extends base_command_1.BaseCommand {
         'network-agent-ids': core_1.Flags.string({ description: 'Network agent IDs JSON array' }),
         'network-include-public': core_1.Flags.boolean({ description: 'Include public agents in network' }),
         'character-3d-id': core_1.Flags.string({ description: '3D character ID' }),
-        'scene-background': core_1.Flags.string({ description: 'Scene background' }),
+        'scene-background': core_1.Flags.string({
+            description: 'Backdrop for the 3D view: default, preset:<id>, or image:<filepath>@<source>. ' +
+                'A bare string is refused — the stored field is a typed reference, not a name.',
+        }),
         'tone-mode': core_1.Flags.string({ description: 'Tone mode' }),
         'tone-id': core_1.Flags.string({ description: 'Tone ID' }),
         'tone-notes': core_1.Flags.string({ description: 'Per-agent tone notes' }),
@@ -209,6 +215,45 @@ class AgentsCreate extends base_command_1.BaseCommand {
         'hide-sequential-outputs': core_1.Flags.boolean({ description: 'Hide sequential outputs' }),
         'is-collaborative': core_1.Flags.boolean({ description: 'Enable collaboration' }),
         'recursion-limit': core_1.Flags.integer({ description: 'Agent recursion limit' }),
+        avatar: core_1.Flags.string({
+            description: "The agent's face, as a reference rather than a file: default, preset:<id> " +
+                '(`skrr agents avatar presets`), asset:<id> (`skrr agents avatar library`), or ' +
+                'image:<filepath>@<source>. To upload a new image use `skrr agents avatar upload`.',
+        }),
+        'conversation-starter': core_1.Flags.string({
+            description: 'Suggested opening prompt shown on the agent (repeatable; replaces the list)',
+            multiple: true,
+        }),
+        'todo-working-hours': core_1.Flags.string({
+            description: 'When this agent schedules its own work: HH:MM-HH:MM[@<IANA timezone>], e.g. ' +
+                '09:00-18:00@America/Los_Angeles',
+        }),
+        'reasoning-tool-escape': core_1.Flags.string({
+            description: 'Tool a reasoning-only turn may still use (repeatable; replaces the list). ' +
+                'These are ESCAPES, not a fenced tool surface.',
+            options: [...agent_config_1.REASONING_TOOL_ESCAPES],
+            multiple: true,
+        }),
+        'commitment-responsibility': core_1.Flags.string({
+            description: "Default work authority for this agent's commitments",
+            options: [...agent_config_1.COMMITMENT_RESPONSIBILITY_LEVELS],
+        }),
+        'commitment-responsibility-ceiling': core_1.Flags.string({
+            description: 'Ceiling a commitment may not exceed, whatever it asks for',
+            options: [...agent_config_1.COMMITMENT_RESPONSIBILITY_LEVELS],
+        }),
+        'max-turns': core_1.Flags.integer({ description: 'Maximum turns in one agent run (1-500)' }),
+        'tool-resources': core_1.Flags.string({
+            description: 'Tool resources JSON object (file_search / context / image_edit bindings)',
+        }),
+        'install-channel': core_1.Flags.string({
+            description: 'Release policy: which channel installs of this agent follow',
+            options: [...agent_config_1.RELEASE_INSTALL_CHANNELS],
+        }),
+        'auto-minor-updates': core_1.Flags.boolean({
+            description: 'Release policy: allow installs to take minor updates automatically',
+            allowNo: true,
+        }),
     };
     async run() {
         this.requireAuth();
@@ -275,7 +320,16 @@ class AgentsCreate extends base_command_1.BaseCommand {
             // server seeds the full portfolio exactly as it always has.
             relationshipLoops: flags['no-relationship-loops'] ? false : undefined,
         });
-        payload = (0, agent_config_1.mergeAgentConfigFlags)(payload, flags);
+        // `mergeAgentConfigFlags` parses the typed flags (avatar, scene background,
+        // working hours, every JSON flag). A parse failure is the caller's input, so
+        // it is reported as a CLI error with the accepted forms — not as an unhandled
+        // throw, and not as a 400 from the server naming a zod path.
+        try {
+            payload = (0, agent_config_1.mergeAgentConfigFlags)(payload, flags);
+        }
+        catch (err) {
+            this.error(err.message, { exit: 1 });
+        }
         // agentCreateSchema (packages/api/src/agents/validation.ts) requires
         // provider and model, and a nameless agent is unusable (see
         // agentCreateMissingFields). We validate client-side so users get a clearer

package/dist/commands/agents/ensure-default.d.ts

@@ -0,0 +1,27 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * The agent a harness gets when nobody has configured one.
+ *
+ * Wraps `POST /api/agents/default`, the path a `skrr code` session takes on an
+ * unconfigured account. It is IDEMPOTENT — it returns the existing default
+ * rather than minting a second one — which is what makes it safe in a
+ * first-run script where `agents create` would not be.
+ *
+ * Deliberately a separate command from `agents create`: this one asks the server
+ * to CHOOSE (provider, model, placement, name), and `create` is where the caller
+ * chooses. Collapsing them would make `create` sometimes-not-create.
+ *
+ * `lib/first-party-harness-agent.ts` calls the same endpoint through its own
+ * private helper and keeps doing so: that path takes an `AbortSignal` and treats
+ * an abort as distinct from a refusal, which `dataService.ensureDefaultAgent`
+ * cannot express. Two call sites, one endpoint, for a stated reason — not drift.
+ */
+export default class AgentsEnsureDefault extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        harness: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/ensure-default.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const auth_core_1 = require("@skrr-ai/auth-core");
+const data_provider_1 = require("@skrr-ai/data-provider");
+const base_command_1 = require("../../base-command");
+const web_url_1 = require("../../lib/web-url");
+/**
+ * The agent a harness gets when nobody has configured one.
+ *
+ * Wraps `POST /api/agents/default`, the path a `skrr code` session takes on an
+ * unconfigured account. It is IDEMPOTENT — it returns the existing default
+ * rather than minting a second one — which is what makes it safe in a
+ * first-run script where `agents create` would not be.
+ *
+ * Deliberately a separate command from `agents create`: this one asks the server
+ * to CHOOSE (provider, model, placement, name), and `create` is where the caller
+ * chooses. Collapsing them would make `create` sometimes-not-create.
+ *
+ * `lib/first-party-harness-agent.ts` calls the same endpoint through its own
+ * private helper and keeps doing so: that path takes an `AbortSignal` and treats
+ * an abort as distinct from a refusal, which `dataService.ensureDefaultAgent`
+ * cannot express. Two call sites, one endpoint, for a stated reason — not drift.
+ */
+class AgentsEnsureDefault extends base_command_1.BaseCommand {
+    static description = "Return this account's default agent for a harness, creating it if there isn't one";
+    static examples = [
+        '<%= config.bin %> agents ensure-default',
+        '<%= config.bin %> agents ensure-default --harness <harness-id> --json',
+    ];
+    static flags = {
+        harness: core_1.Flags.string({
+            // Only a harness with a managed-inference capability can own a default
+            // agent, and today exactly one does. Defaulted rather than required
+            // because the bare call is otherwise refused with a message that quotes
+            // the literal string "undefined" — accurate about the body, useless about
+            // the fix. Read from FIRST_PARTY_HARNESS, never written as a literal.
+            description: `Harness the default belongs to (default: ${auth_core_1.FIRST_PARTY_HARNESS.provider})`,
+            default: auth_core_1.FIRST_PARTY_HARNESS.provider,
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsEnsureDefault);
+        let result;
+        try {
+            result = await data_provider_1.dataService.ensureDefaultAgent({ harness: flags.harness });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        const agent = result.agent;
+        if (flags.json) {
+            this.log(JSON.stringify({ created: result.created, agent: (0, web_url_1.withAgentUrl)(this.cliConfig.baseURL, agent) }, null, 2));
+            return;
+        }
+        const agentId = String(agent.id ?? agent._id ?? '?');
+        this.log(result.created
+            ? `Created default agent ${agentId} — ${agent.name ?? '(no name)'}`
+            : `Default agent already exists: ${agentId} — ${agent.name ?? '(no name)'}`);
+        this.log(`URL: ${(0, web_url_1.withAgentUrl)(this.cliConfig.baseURL, agent).url ?? '-'}`);
+    }
+}
+exports.default = AgentsEnsureDefault;

package/dist/commands/agents/mute.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * Per-USER preference, not agent config: it changes your view of the agent and
+ * nobody else's. Idempotent over a toggle endpoint — see `lib/agent-pin-mute.ts`.
+ */
+export default class AgentsMute extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: 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/mute.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const agent_pin_mute_1 = require("../../lib/agent-pin-mute");
+/**
+ * Per-USER preference, not agent config: it changes your view of the agent and
+ * nobody else's. Idempotent over a toggle endpoint — see `lib/agent-pin-mute.ts`.
+ */
+class AgentsMute extends base_command_1.BaseCommand {
+    static description = "Silence an agent's notifications for you";
+    static examples = ['<%= config.bin %> agents mute <agent-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'Agent 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(AgentsMute);
+        let result;
+        try {
+            result = await (0, agent_pin_mute_1.setAgentFlag)(args.id, 'mute', true);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(this.agentJson(args.id, { mute: result.value, changed: result.changed }));
+            return;
+        }
+        this.log(result.changed
+            ? `Agent ${args.id}: mute is now ${result.value}`
+            : `Agent ${args.id}: mute was already ${result.value} — nothing to do`);
+    }
+}
+exports.default = AgentsMute;

package/dist/commands/agents/pin.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * Per-USER preference, not agent config: it changes your view of the agent and
+ * nobody else's. Idempotent over a toggle endpoint — see `lib/agent-pin-mute.ts`.
+ */
+export default class AgentsPin extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: 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/pin.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const core_1 = require("@oclif/core");
+const base_command_1 = require("../../base-command");
+const agent_pin_mute_1 = require("../../lib/agent-pin-mute");
+/**
+ * Per-USER preference, not agent config: it changes your view of the agent and
+ * nobody else's. Idempotent over a toggle endpoint — see `lib/agent-pin-mute.ts`.
+ */
+class AgentsPin extends base_command_1.BaseCommand {
+    static description = 'Pin an agent to the top of your list';
+    static examples = ['<%= config.bin %> agents pin <agent-id>'];
+    static args = {
+        id: core_1.Args.string({ description: 'Agent 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(AgentsPin);
+        let result;
+        try {
+            result = await (0, agent_pin_mute_1.setAgentFlag)(args.id, 'pin', true);
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(this.agentJson(args.id, { pin: result.value, changed: result.changed }));
+            return;
+        }
+        this.log(result.changed
+            ? `Agent ${args.id}: pin is now ${result.value}`
+            : `Agent ${args.id}: pin was already ${result.value} — nothing to do`);
+    }
+}
+exports.default = AgentsPin;

package/dist/commands/agents/tools/auth.d.ts

@@ -0,0 +1,19 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * Whether this account has credentials for one tool.
+ *
+ * Separate from the `AUTH` column in `agents tools` because that column reports
+ * what the catalog said in one batch read, and this asks the server about one
+ * tool now — which is the question worth asking after wiring up a key.
+ */
+export default class AgentsToolsAuth extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        toolId: 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/tools/auth.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");
+/**
+ * Whether this account has credentials for one tool.
+ *
+ * Separate from the `AUTH` column in `agents tools` because that column reports
+ * what the catalog said in one batch read, and this asks the server about one
+ * tool now — which is the question worth asking after wiring up a key.
+ */
+class AgentsToolsAuth extends base_command_1.BaseCommand {
+    static description = 'Check whether this account is authenticated for one tool';
+    static examples = ['<%= config.bin %> agents tools auth <plugin-key>'];
+    static args = {
+        toolId: core_1.Args.string({ description: 'Plugin key', 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(AgentsToolsAuth);
+        let result;
+        try {
+            result = await data_provider_1.dataService.getVerifyAgentToolAuth({ toolId: args.toolId });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        this.log(result.authenticated
+            ? `${args.toolId}: authenticated`
+            : `${args.toolId}: not authenticated${result.message ? ` — ${result.message}` : ''}`);
+    }
+}
+exports.default = AgentsToolsAuth;

package/dist/commands/agents/tools/calls.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * Tool calls recorded in one conversation.
+ *
+ * `conversationId` is REQUIRED by the endpoint, not optional with a default, so
+ * it is a required flag rather than something this command guesses — a
+ * conversation-less listing would silently be somebody else's transcript or
+ * nothing at all.
+ */
+export default class AgentsToolsCalls extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        conversation: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/agents/tools/calls.js

@@ -0,0 +1,54 @@
+"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");
+/**
+ * Tool calls recorded in one conversation.
+ *
+ * `conversationId` is REQUIRED by the endpoint, not optional with a default, so
+ * it is a required flag rather than something this command guesses — a
+ * conversation-less listing would silently be somebody else's transcript or
+ * nothing at all.
+ */
+class AgentsToolsCalls extends base_command_1.BaseCommand {
+    static description = 'List the tool calls recorded in one conversation';
+    static examples = [
+        '<%= config.bin %> agents tools calls --conversation <conversation-id>',
+    ];
+    static flags = {
+        conversation: core_1.Flags.string({ description: 'Conversation ID', required: true }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsToolsCalls);
+        let calls;
+        try {
+            calls = await data_provider_1.dataService.getToolCalls({ conversationId: flags.conversation });
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        if (flags.json) {
+            this.log(JSON.stringify(calls, null, 2));
+            return;
+        }
+        const rows = (calls ?? []);
+        if (rows.length === 0) {
+            this.log(`No tool calls recorded in conversation ${flags.conversation}.`);
+            return;
+        }
+        (0, format_1.renderTable)(rows.map((call) => ({
+            toolId: String(call.toolId ?? '-'),
+            messageId: String(call.messageId ?? '-'),
+            blockIndex: call.blockIndex === undefined ? '-' : String(call.blockIndex),
+        })), [
+            { key: 'toolId', header: 'TOOL', verbatim: true },
+            { key: 'messageId', header: 'MESSAGE', verbatim: true },
+            { key: 'blockIndex', header: 'BLOCK' },
+        ], (line) => this.log(line));
+    }
+}
+exports.default = AgentsToolsCalls;

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

@@ -0,0 +1,20 @@
+import { BaseCommand } from '../../../base-command';
+/**
+ * The tool catalog `--tools` is chosen from.
+ *
+ * `agents create --tools '["..."]'` has always taken an array of plugin keys the
+ * caller had no way to enumerate — the web fills the same field from a picker
+ * backed by this endpoint, so the flag was only usable by someone reading the
+ * server's source or copying another agent's array.
+ *
+ * PLUGIN KEY is the column that matters: it is the string the field stores.
+ */
+export default class AgentsToolsList extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        authenticated: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}

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

@@ -0,0 +1,77 @@
+"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 tool catalog `--tools` is chosen from.
+ *
+ * `agents create --tools '["..."]'` has always taken an array of plugin keys the
+ * caller had no way to enumerate — the web fills the same field from a picker
+ * backed by this endpoint, so the flag was only usable by someone reading the
+ * server's source or copying another agent's array.
+ *
+ * PLUGIN KEY is the column that matters: it is the string the field stores.
+ */
+class AgentsToolsList extends base_command_1.BaseCommand {
+    static description = 'List the tools `agents create/update --tools` accepts';
+    static examples = [
+        '<%= config.bin %> agents tools',
+        '<%= config.bin %> agents tools --authenticated',
+        '<%= config.bin %> agents tools --json',
+    ];
+    static flags = {
+        authenticated: core_1.Flags.boolean({
+            description: 'Only tools this account has already authenticated',
+        }),
+        json: core_1.Flags.boolean({ description: 'Output as JSON' }),
+    };
+    async run() {
+        this.requireAuth();
+        const { flags } = await this.parse(AgentsToolsList);
+        let tools;
+        try {
+            tools = await data_provider_1.dataService.getAvailableTools();
+        }
+        catch (err) {
+            this.handleApiError(err);
+        }
+        const rows = flags.authenticated
+            ? tools.filter((tool) => tool.authenticated === true)
+            : tools;
+        if (flags.json) {
+            this.log(JSON.stringify(rows, null, 2));
+            return;
+        }
+        if (rows.length === 0) {
+            this.log(flags.authenticated ? 'No authenticated tools.' : 'No tools available.');
+            return;
+        }
+        /**
+         * Three states, not two. `authConfig` present means the tool needs
+         * credentials; `authenticated` says whether this account has supplied them.
+         * A tool that needs nothing is neither — printing "no" for it would send
+         * someone to configure a key that does not exist.
+         */
+        const authState = (tool) => {
+            if (!tool.authConfig || tool.authConfig.length === 0)
+                return '-';
+            return tool.authenticated ? 'yes' : 'needed';
+        };
+        (0, format_1.renderTable)(rows.map((tool) => ({
+            pluginKey: tool.pluginKey,
+            name: tool.name,
+            auth: authState(tool),
+            description: String(tool.description ?? ''),
+        })), [
+            { key: 'pluginKey', header: 'PLUGIN KEY', verbatim: true },
+            { key: 'name', header: 'NAME', maxWidth: 28 },
+            { key: 'auth', header: 'AUTH' },
+            { key: 'description', header: 'DESCRIPTION', maxWidth: 52 },
+        ], (line) => this.log(line));
+        this.log('');
+        this.log('PLUGIN KEY is what --tools stores, e.g. --tools \'["web_search"]\'.');
+    }
+}
+exports.default = AgentsToolsList;

package/dist/commands/agents/unmute.d.ts

@@ -0,0 +1,16 @@
+import { BaseCommand } from '../../base-command';
+/**
+ * Per-USER preference, not agent config: it changes your view of the agent and
+ * nobody else's. Idempotent over a toggle endpoint — see `lib/agent-pin-mute.ts`.
+ */
+export default class AgentsUnmute extends BaseCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        id: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}